@webex/contact-center 3.11.0 → 3.12.0-llmrefactor.2

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 (267) hide show
  1. package/.sdd/manifest.json +882 -0
  2. package/AGENTS.md +94 -0
  3. package/ai-docs/ARCHITECTURE.md +168 -0
  4. package/ai-docs/CONTRACTS.md +46 -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 +48 -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 +341 -0
  17. package/ai-docs/features/generated-spec-conformance-fidelity-remediation/spec/feature-spec.md +117 -0
  18. package/ai-docs/features/residual-warning-coverage-completion/spec/feature-spec.md +203 -0
  19. package/ai-docs/features/validator-code-fidelity-drift-fix/spec/feature-spec.md +315 -0
  20. package/ai-docs/patterns/event-driven-patterns.md +485 -0
  21. package/ai-docs/patterns/testing-patterns.md +480 -0
  22. package/ai-docs/patterns/typescript-patterns.md +365 -0
  23. package/ai-docs/templates/README.md +102 -0
  24. package/ai-docs/templates/documentation/create-agents-md.md +240 -0
  25. package/ai-docs/templates/documentation/create-architecture-md.md +295 -0
  26. package/ai-docs/templates/existing-service/bug-fix.md +254 -0
  27. package/ai-docs/templates/existing-service/feature-enhancement.md +450 -0
  28. package/ai-docs/templates/new-method/00-master.md +80 -0
  29. package/ai-docs/templates/new-method/01-requirements.md +232 -0
  30. package/ai-docs/templates/new-method/02-implementation.md +295 -0
  31. package/ai-docs/templates/new-method/03-tests.md +201 -0
  32. package/ai-docs/templates/new-method/04-validation.md +141 -0
  33. package/ai-docs/templates/new-service/00-master.md +109 -0
  34. package/ai-docs/templates/new-service/01-pre-questions.md +159 -0
  35. package/ai-docs/templates/new-service/02-code-generation.md +346 -0
  36. package/ai-docs/templates/new-service/03-integration.md +178 -0
  37. package/ai-docs/templates/new-service/04-test-generation.md +205 -0
  38. package/ai-docs/templates/new-service/05-validation.md +145 -0
  39. package/dist/cc.js +379 -50
  40. package/dist/cc.js.map +1 -1
  41. package/dist/config.js +6 -0
  42. package/dist/config.js.map +1 -1
  43. package/dist/constants.js +22 -2
  44. package/dist/constants.js.map +1 -1
  45. package/dist/index.js +27 -5
  46. package/dist/index.js.map +1 -1
  47. package/dist/metrics/behavioral-events.js +114 -0
  48. package/dist/metrics/behavioral-events.js.map +1 -1
  49. package/dist/metrics/constants.js +32 -3
  50. package/dist/metrics/constants.js.map +1 -1
  51. package/dist/services/ApiAiAssistant.js +318 -0
  52. package/dist/services/ApiAiAssistant.js.map +1 -0
  53. package/dist/services/UserPreference.js +427 -0
  54. package/dist/services/UserPreference.js.map +1 -0
  55. package/dist/services/agent/types.js.map +1 -1
  56. package/dist/services/config/Util.js +8 -4
  57. package/dist/services/config/Util.js.map +1 -1
  58. package/dist/services/config/constants.js +35 -2
  59. package/dist/services/config/constants.js.map +1 -1
  60. package/dist/services/config/index.js +41 -2
  61. package/dist/services/config/index.js.map +1 -1
  62. package/dist/services/config/types.js +66 -8
  63. package/dist/services/config/types.js.map +1 -1
  64. package/dist/services/constants.js +27 -1
  65. package/dist/services/constants.js.map +1 -1
  66. package/dist/services/core/Err.js.map +1 -1
  67. package/dist/services/core/Utils.js +122 -25
  68. package/dist/services/core/Utils.js.map +1 -1
  69. package/dist/services/core/aqm-reqs.js +92 -17
  70. package/dist/services/core/aqm-reqs.js.map +1 -1
  71. package/dist/services/core/websocket/WebSocketManager.js +22 -6
  72. package/dist/services/core/websocket/WebSocketManager.js.map +1 -1
  73. package/dist/services/core/websocket/connection-service.js +3 -1
  74. package/dist/services/core/websocket/connection-service.js.map +1 -1
  75. package/dist/services/core/websocket/types.js.map +1 -1
  76. package/dist/services/index.js +6 -0
  77. package/dist/services/index.js.map +1 -1
  78. package/dist/services/task/Task.js +688 -0
  79. package/dist/services/task/Task.js.map +1 -0
  80. package/dist/services/task/TaskFactory.js +45 -0
  81. package/dist/services/task/TaskFactory.js.map +1 -0
  82. package/dist/services/task/TaskManager.js +751 -457
  83. package/dist/services/task/TaskManager.js.map +1 -1
  84. package/dist/services/task/TaskUtils.js +220 -23
  85. package/dist/services/task/TaskUtils.js.map +1 -1
  86. package/dist/services/task/constants.js +23 -2
  87. package/dist/services/task/constants.js.map +1 -1
  88. package/dist/services/task/dialer.js +129 -0
  89. package/dist/services/task/dialer.js.map +1 -1
  90. package/dist/services/task/digital/Digital.js +77 -0
  91. package/dist/services/task/digital/Digital.js.map +1 -0
  92. package/dist/services/task/state-machine/TaskStateMachine.js +873 -0
  93. package/dist/services/task/state-machine/TaskStateMachine.js.map +1 -0
  94. package/dist/services/task/state-machine/actions.js +567 -0
  95. package/dist/services/task/state-machine/actions.js.map +1 -0
  96. package/dist/services/task/state-machine/constants.js +161 -0
  97. package/dist/services/task/state-machine/constants.js.map +1 -0
  98. package/dist/services/task/state-machine/guards.js +382 -0
  99. package/dist/services/task/state-machine/guards.js.map +1 -0
  100. package/dist/services/task/state-machine/index.js +53 -0
  101. package/dist/services/task/state-machine/index.js.map +1 -0
  102. package/dist/services/task/state-machine/types.js +54 -0
  103. package/dist/services/task/state-machine/types.js.map +1 -0
  104. package/dist/services/task/state-machine/uiControlsComputer.js +603 -0
  105. package/dist/services/task/state-machine/uiControlsComputer.js.map +1 -0
  106. package/dist/services/task/taskDataNormalizer.js +99 -0
  107. package/dist/services/task/taskDataNormalizer.js.map +1 -0
  108. package/dist/services/task/types.js +227 -4
  109. package/dist/services/task/types.js.map +1 -1
  110. package/dist/services/task/voice/Voice.js +1044 -0
  111. package/dist/services/task/voice/Voice.js.map +1 -0
  112. package/dist/services/task/voice/WebRTC.js +149 -0
  113. package/dist/services/task/voice/WebRTC.js.map +1 -0
  114. package/dist/types/cc.d.ts +894 -0
  115. package/dist/types/config.d.ts +72 -0
  116. package/dist/types/constants.d.ts +66 -0
  117. package/dist/types/index.d.ts +199 -0
  118. package/dist/types/logger-proxy.d.ts +71 -0
  119. package/dist/types/metrics/MetricsManager.d.ts +223 -0
  120. package/dist/types/metrics/behavioral-events.d.ts +29 -0
  121. package/dist/types/metrics/constants.d.ts +181 -0
  122. package/dist/types/services/AddressBook.d.ts +74 -0
  123. package/dist/types/services/ApiAiAssistant.d.ts +49 -0
  124. package/dist/types/services/EntryPoint.d.ts +67 -0
  125. package/dist/types/services/Queue.d.ts +76 -0
  126. package/dist/types/services/UserPreference.d.ts +118 -0
  127. package/dist/types/services/WebCallingService.d.ts +1 -0
  128. package/dist/types/services/agent/index.d.ts +46 -0
  129. package/dist/types/services/agent/types.d.ts +413 -0
  130. package/dist/types/services/config/Util.d.ts +20 -0
  131. package/dist/types/services/config/constants.d.ts +270 -0
  132. package/dist/types/services/config/index.d.ts +177 -0
  133. package/dist/types/services/config/types.d.ts +1368 -0
  134. package/dist/types/services/constants.d.ts +110 -0
  135. package/dist/types/services/core/Err.d.ts +125 -0
  136. package/dist/types/services/core/GlobalTypes.d.ts +58 -0
  137. package/dist/types/services/core/Utils.d.ts +121 -0
  138. package/dist/types/services/core/WebexRequest.d.ts +22 -0
  139. package/dist/types/services/core/aqm-reqs.d.ts +65 -0
  140. package/dist/types/services/core/constants.d.ts +99 -0
  141. package/dist/types/services/core/types.d.ts +47 -0
  142. package/dist/types/services/core/websocket/WebSocketManager.d.ts +36 -0
  143. package/dist/types/services/core/websocket/connection-service.d.ts +27 -0
  144. package/dist/types/services/core/websocket/keepalive.worker.d.ts +2 -0
  145. package/dist/types/services/core/websocket/types.d.ts +37 -0
  146. package/dist/types/services/index.d.ts +54 -0
  147. package/dist/types/services/task/AutoWrapup.d.ts +40 -0
  148. package/dist/types/services/task/Task.d.ts +157 -0
  149. package/dist/types/services/task/TaskFactory.d.ts +12 -0
  150. package/dist/types/services/task/TaskManager.d.ts +1 -0
  151. package/dist/types/services/task/TaskUtils.d.ts +138 -0
  152. package/dist/types/services/task/constants.d.ts +91 -0
  153. package/dist/types/services/task/contact.d.ts +69 -0
  154. package/dist/types/services/task/dialer.d.ts +73 -0
  155. package/dist/types/services/task/digital/Digital.d.ts +22 -0
  156. package/dist/types/services/task/state-machine/TaskStateMachine.d.ts +1194 -0
  157. package/dist/types/services/task/state-machine/actions.d.ts +10 -0
  158. package/dist/types/services/task/state-machine/constants.d.ts +107 -0
  159. package/dist/types/services/task/state-machine/guards.d.ts +102 -0
  160. package/dist/types/services/task/state-machine/index.d.ts +13 -0
  161. package/dist/types/services/task/state-machine/types.d.ts +269 -0
  162. package/dist/types/services/task/state-machine/uiControlsComputer.d.ts +9 -0
  163. package/dist/types/services/task/taskDataNormalizer.d.ts +10 -0
  164. package/dist/types/services/task/types.d.ts +1856 -0
  165. package/dist/types/services/task/voice/Voice.d.ts +184 -0
  166. package/dist/types/services/task/voice/WebRTC.d.ts +53 -0
  167. package/dist/types/types.d.ts +778 -0
  168. package/dist/types/utils/PageCache.d.ts +173 -0
  169. package/dist/types/webex-config.d.ts +53 -0
  170. package/dist/types/webex.d.ts +8 -0
  171. package/dist/types.js +130 -1
  172. package/dist/types.js.map +1 -1
  173. package/dist/webex.js +14 -2
  174. package/dist/webex.js.map +1 -1
  175. package/package.json +16 -12
  176. package/src/cc.ts +477 -51
  177. package/src/config.ts +6 -0
  178. package/src/constants.ts +21 -1
  179. package/src/index.ts +24 -5
  180. package/src/metrics/ai-docs/AGENTS.md +350 -0
  181. package/src/metrics/ai-docs/ARCHITECTURE.md +338 -0
  182. package/src/metrics/ai-docs/metrics-spec.md +854 -0
  183. package/src/metrics/behavioral-events.ts +120 -0
  184. package/src/metrics/constants.ts +37 -3
  185. package/src/services/ApiAiAssistant.ts +412 -0
  186. package/src/services/UserPreference.ts +509 -0
  187. package/src/services/agent/ai-docs/AGENTS.md +240 -0
  188. package/src/services/agent/ai-docs/ARCHITECTURE.md +304 -0
  189. package/src/services/agent/ai-docs/agent-spec.md +504 -0
  190. package/src/services/agent/types.ts +1 -1
  191. package/src/services/ai-docs/AGENTS.md +386 -0
  192. package/src/services/ai-docs/services-spec.md +492 -0
  193. package/src/services/config/Util.ts +10 -2
  194. package/src/services/config/ai-docs/AGENTS.md +255 -0
  195. package/src/services/config/ai-docs/ARCHITECTURE.md +426 -0
  196. package/src/services/config/ai-docs/config-spec.md +669 -0
  197. package/src/services/config/constants.ts +37 -1
  198. package/src/services/config/index.ts +45 -1
  199. package/src/services/config/types.ts +241 -11
  200. package/src/services/constants.ts +29 -0
  201. package/src/services/core/Err.ts +3 -0
  202. package/src/services/core/Utils.ts +143 -30
  203. package/src/services/core/ai-docs/AGENTS.md +381 -0
  204. package/src/services/core/ai-docs/ARCHITECTURE.md +698 -0
  205. package/src/services/core/ai-docs/core-spec.md +783 -0
  206. package/src/services/core/aqm-reqs.ts +100 -22
  207. package/src/services/core/websocket/WebSocketManager.ts +23 -6
  208. package/src/services/core/websocket/connection-service.ts +5 -1
  209. package/src/services/core/websocket/types.ts +1 -1
  210. package/src/services/index.ts +4 -0
  211. package/src/services/task/Task.ts +837 -0
  212. package/src/services/task/TaskFactory.ts +55 -0
  213. package/src/services/task/TaskManager.ts +793 -521
  214. package/src/services/task/TaskUtils.ts +314 -24
  215. package/src/services/task/ai-docs/AGENTS.md +457 -0
  216. package/src/services/task/ai-docs/ARCHITECTURE.md +594 -0
  217. package/src/services/task/ai-docs/task-spec.md +1319 -0
  218. package/src/services/task/constants.ts +23 -0
  219. package/src/services/task/dialer.ts +136 -1
  220. package/src/services/task/digital/Digital.ts +95 -0
  221. package/src/services/task/state-machine/TaskStateMachine.ts +1166 -0
  222. package/src/services/task/state-machine/actions.ts +738 -0
  223. package/src/services/task/state-machine/ai-docs/AGENTS.md +458 -0
  224. package/src/services/task/state-machine/ai-docs/ARCHITECTURE.md +1137 -0
  225. package/src/services/task/state-machine/ai-docs/task-state-machine-spec.md +2177 -0
  226. package/src/services/task/state-machine/constants.ts +172 -0
  227. package/src/services/task/state-machine/guards.ts +445 -0
  228. package/src/services/task/state-machine/index.ts +28 -0
  229. package/src/services/task/state-machine/types.ts +243 -0
  230. package/src/services/task/state-machine/uiControlsComputer.ts +961 -0
  231. package/src/services/task/taskDataNormalizer.ts +137 -0
  232. package/src/services/task/types.ts +734 -71
  233. package/src/services/task/voice/Voice.ts +1270 -0
  234. package/src/services/task/voice/WebRTC.ts +187 -0
  235. package/src/types.ts +205 -2
  236. package/src/utils/AGENTS.md +278 -0
  237. package/src/utils/ai-docs/utils-spec.md +381 -0
  238. package/src/webex.js +2 -0
  239. package/test/unit/spec/cc.ts +503 -43
  240. package/test/unit/spec/logger-proxy.ts +70 -0
  241. package/test/unit/spec/services/ApiAiAssistant.ts +273 -0
  242. package/test/unit/spec/services/UserPreference.ts +401 -0
  243. package/test/unit/spec/services/WebCallingService.ts +7 -1
  244. package/test/unit/spec/services/config/index.ts +85 -29
  245. package/test/unit/spec/services/core/Utils.ts +481 -2
  246. package/test/unit/spec/services/core/websocket/WebSocketManager.ts +137 -41
  247. package/test/unit/spec/services/core/websocket/connection-service.ts +3 -1
  248. package/test/unit/spec/services/task/AutoWrapup.ts +63 -0
  249. package/test/unit/spec/services/task/Task.ts +477 -0
  250. package/test/unit/spec/services/task/TaskFactory.ts +62 -0
  251. package/test/unit/spec/services/task/TaskManager.ts +1001 -1003
  252. package/test/unit/spec/services/task/TaskUtils.ts +235 -0
  253. package/test/unit/spec/services/task/dialer.ts +372 -96
  254. package/test/unit/spec/services/task/digital/Digital.ts +105 -0
  255. package/test/unit/spec/services/task/state-machine/TaskStateMachine.ts +2651 -0
  256. package/test/unit/spec/services/task/state-machine/guards.ts +637 -0
  257. package/test/unit/spec/services/task/state-machine/types.ts +18 -0
  258. package/test/unit/spec/services/task/state-machine/uiControlsComputer.ts +2663 -0
  259. package/test/unit/spec/services/task/taskTestUtils.ts +87 -0
  260. package/test/unit/spec/services/task/voice/Voice.ts +649 -0
  261. package/test/unit/spec/services/task/voice/WebRTC.ts +235 -0
  262. package/umd/contact-center.min.js +2 -2
  263. package/umd/contact-center.min.js.map +1 -1
  264. package/dist/services/task/index.js +0 -1525
  265. package/dist/services/task/index.js.map +0 -1
  266. package/src/services/task/index.ts +0 -1801
  267. package/test/unit/spec/services/task/index.ts +0 -2184
@@ -12,11 +12,15 @@ 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 _WebRTC = _interopRequireDefault(require("./voice/WebRTC"));
18
+ var _stateMachine = require("./state-machine");
19
+ var _taskDataNormalizer = require("./taskDataNormalizer");
19
20
  function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
21
+ const CC_EVENT_SET = new Set(Object.values(_types2.CC_EVENTS));
22
+ const isCcEvent = value => CC_EVENT_SET.has(value);
23
+
20
24
  /** @internal */
21
25
  class TaskManager extends _events.default {
22
26
  /**
@@ -25,24 +29,71 @@ class TaskManager extends _events.default {
25
29
  * @private
26
30
  */
27
31
 
32
+ // eslint-disable-next-line no-use-before-define
33
+
28
34
  /**
29
35
  * @param contact - Routing Contact layer. Talks to AQMReq layer to convert events to promises
30
36
  * @param webCallingService - Webrtc Service Layer
31
37
  * @param webSocketManager - Websocket Manager to maintain websocket connection and keepalives
32
38
  */
33
- constructor(contact, webCallingService, webSocketManager) {
39
+ constructor(apiAIAssistant, contact, webCallingService, webSocketManager, rtdWebSocketManager) {
34
40
  super();
41
+ this.apiAIAssistant = apiAIAssistant;
35
42
  this.contact = contact;
36
- this.taskCollection = {};
37
43
  this.webCallingService = webCallingService;
38
44
  this.webSocketManager = webSocketManager;
39
- this.metricsManager = _MetricsManager.default.getInstance();
45
+ this.rtdWebSocketManager = rtdWebSocketManager;
46
+ this.taskCollection = {};
47
+ this.webRtcEnabled = false;
40
48
  this.registerTaskListeners();
41
49
  this.registerIncomingCallEvent();
42
50
  }
51
+ handleRealtimeWebsocketEvent(event) {
52
+ try {
53
+ const payload = JSON.parse(event);
54
+ const interactionId = payload?.data?.data?.conversationId;
55
+ if (!interactionId) return;
56
+ const task = this.taskCollection[interactionId];
57
+ if (!task) {
58
+ _loggerProxy.default.info(`Realtime transcription task not found`, {
59
+ module: _constants.TASK_MANAGER_FILE,
60
+ method: _constants2.METHODS.HANDLE_REAL_TIME_WEBSOCKET_EVENT,
61
+ interactionId
62
+ });
63
+ return;
64
+ }
65
+ switch (payload.type) {
66
+ case _types2.CC_EVENTS.REAL_TIME_TRANSCRIPTION:
67
+ case _types2.CC_EVENTS.SUGGESTED_RESPONSE:
68
+ task.emit(payload.type, payload.data);
69
+ break;
70
+ }
71
+ } catch (error) {
72
+ _loggerProxy.default.error('Failed to parse RTD WebSocket message', {
73
+ module: _constants.TASK_MANAGER_FILE,
74
+ method: _constants2.METHODS.HANDLE_REAL_TIME_WEBSOCKET_EVENT,
75
+ error
76
+ });
77
+ }
78
+ }
79
+
80
+ /**
81
+ * Set config flags for task creation
82
+ */
83
+ setConfigFlags(configFlags) {
84
+ this.configFlags = configFlags;
85
+ }
86
+
87
+ /**
88
+ * Set wrapup configuration data
89
+ */
43
90
  setWrapupData(wrapupData) {
44
91
  this.wrapupData = wrapupData;
45
92
  }
93
+
94
+ /**
95
+ * Set agent ID for task operations
96
+ */
46
97
  setAgentId(agentId) {
47
98
  this.agentId = agentId;
48
99
  }
@@ -59,7 +110,7 @@ class TaskManager extends _events.default {
59
110
  this.webRtcEnabled = webRtcEnabled;
60
111
  }
61
112
  handleIncomingWebCall = call => {
62
- const currentTask = Object.values(this.taskCollection).find(task => task.data.interaction.mediaType === 'telephony');
113
+ const currentTask = Object.values(this.taskCollection).find(task => task.data.interaction.mediaType === 'telephony' && !(0, _TaskUtils.isCampaignPreviewReservation)(task));
63
114
  if (currentTask) {
64
115
  this.webCallingService.mapCallToTask(call.getCallId(), currentTask.data.interactionId);
65
116
  _loggerProxy.default.log(`Call mapped to task`, {
@@ -67,7 +118,12 @@ class TaskManager extends _events.default {
67
118
  method: _constants2.METHODS.HANDLE_INCOMING_WEB_CALL,
68
119
  interactionId: currentTask.data.interactionId
69
120
  });
70
- this.emit(_types.TASK_EVENTS.TASK_INCOMING, currentTask);
121
+
122
+ // Send TASK_INCOMING to state machine - it will emit on the task object
123
+ const eventPayload = TaskManager.mapEventToTaskStateMachineEvent(_types2.CC_EVENTS.AGENT_CONTACT_RESERVED, currentTask.data);
124
+ if (eventPayload && currentTask) {
125
+ currentTask.sendStateMachineEvent(eventPayload);
126
+ }
71
127
  }
72
128
  this.call = call;
73
129
  };
@@ -77,407 +133,637 @@ class TaskManager extends _events.default {
77
133
  unregisterIncomingCallEvent() {
78
134
  this.webCallingService.off(_calling.LINE_EVENTS.INCOMING_CALL, this.handleIncomingWebCall);
79
135
  }
136
+
137
+ /**
138
+ * Map WebSocket CC_EVENTS to state machine TaskEvent
139
+ * @param ccEvent - The CC_EVENT type from WebSocket
140
+ * @param payload - The event payload
141
+ * @param agentId - Optional agent ID for state detection (needed for HYDRATE)
142
+ * @returns TaskEventPayload for state machine or null if no mapping
143
+ */
144
+ static mapEventToTaskStateMachineEvent(ccEvent, payload, agentId) {
145
+ const mediaResourceId = payload.mediaResourceId || payload.interaction?.media?.[payload.interactionId]?.mediaResourceId;
146
+ switch (ccEvent) {
147
+ // CC -> TaskEvent mappings (see TaskStateMachine comment for quick reference)
148
+ case _types2.CC_EVENTS.AGENT_CONTACT_RESERVED:
149
+ // AgentContactReserved -> TASK_INCOMING
150
+ if ((0, _TaskUtils.isCampaignPreviewTask)(payload)) {
151
+ return {
152
+ type: _stateMachine.TaskEvent.TASK_INCOMING,
153
+ taskData: payload,
154
+ isCampaignReservationAccept: true
155
+ };
156
+ }
157
+ return {
158
+ type: _stateMachine.TaskEvent.TASK_INCOMING,
159
+ taskData: payload
160
+ };
161
+ case _types2.CC_EVENTS.AGENT_OFFER_CAMPAIGN_RESERVATION:
162
+ // -> TASK_INCOMING (campaign branch via guard)
163
+ return {
164
+ type: _stateMachine.TaskEvent.TASK_INCOMING,
165
+ taskData: payload,
166
+ isCampaignReservationAccept: true
167
+ };
168
+ case _types2.CC_EVENTS.AGENT_OFFER_CONTACT:
169
+ // AgentOfferContact -> TASK_OFFERED
170
+ return {
171
+ type: _stateMachine.TaskEvent.TASK_OFFERED,
172
+ taskData: payload
173
+ };
174
+ case _types2.CC_EVENTS.AGENT_CONTACT:
175
+ // AgentContact -> HYDRATE
176
+ // Include agentId for state detection (e.g., checking isWrapUp in participant data)
177
+ return {
178
+ type: _stateMachine.TaskEvent.HYDRATE,
179
+ taskData: payload,
180
+ agentId
181
+ };
182
+ case _types2.CC_EVENTS.CONTACT_UPDATED:
183
+ return {
184
+ type: _stateMachine.TaskEvent.CONTACT_UPDATED,
185
+ taskData: payload
186
+ };
187
+ case _types2.CC_EVENTS.CONTACT_OWNER_CHANGED:
188
+ return {
189
+ type: _stateMachine.TaskEvent.CONTACT_OWNER_CHANGED,
190
+ taskData: payload
191
+ };
192
+ case _types2.CC_EVENTS.AGENT_OFFER_CONSULT:
193
+ // AgentOfferConsult -> OFFER_CONSULT
194
+ return {
195
+ type: _stateMachine.TaskEvent.OFFER_CONSULT,
196
+ taskData: {
197
+ ...payload,
198
+ isConsulted: true
199
+ }
200
+ };
201
+ case _types2.CC_EVENTS.AGENT_CONTACT_ASSIGNED:
202
+ // AgentContactAssigned -> ASSIGN
203
+ return {
204
+ type: _stateMachine.TaskEvent.ASSIGN,
205
+ taskData: payload
206
+ };
207
+ case _types2.CC_EVENTS.AGENT_CONTACT_HELD:
208
+ return {
209
+ type: _stateMachine.TaskEvent.HOLD_SUCCESS,
210
+ mediaResourceId: mediaResourceId || '',
211
+ taskData: payload
212
+ };
213
+ case _types2.CC_EVENTS.AGENT_CONTACT_UNHELD:
214
+ return {
215
+ type: _stateMachine.TaskEvent.UNHOLD_SUCCESS,
216
+ mediaResourceId: mediaResourceId || '',
217
+ taskData: payload
218
+ };
219
+ case _types2.CC_EVENTS.AGENT_CONSULT_CREATED:
220
+ return {
221
+ type: _stateMachine.TaskEvent.CONSULT_CREATED,
222
+ taskData: {
223
+ ...payload,
224
+ isConsulted: false
225
+ }
226
+ };
227
+ case _types2.CC_EVENTS.AGENT_CONSULTING:
228
+ // AgentConsulting -> CONSULTING_ACTIVE
229
+ // use context to figure out if it's the initiator or receiver using consultInitiator from context
230
+ return {
231
+ type: _stateMachine.TaskEvent.CONSULTING_ACTIVE,
232
+ consultDestinationAgentJoined: true,
233
+ taskData: payload
234
+ };
235
+ case _types2.CC_EVENTS.AGENT_CONSULT_ENDED:
236
+ // AgentConsultEnded -> CONSULT_END
237
+ return {
238
+ type: _stateMachine.TaskEvent.CONSULT_END,
239
+ taskData: payload
240
+ };
241
+ case _types2.CC_EVENTS.AGENT_CONSULT_FAILED:
242
+ case _types2.CC_EVENTS.AGENT_CTQ_FAILED:
243
+ return {
244
+ type: _stateMachine.TaskEvent.CONSULT_FAILED,
245
+ reason: payload.reason,
246
+ taskData: payload
247
+ };
248
+ case _types2.CC_EVENTS.AGENT_CTQ_CANCELLED:
249
+ return {
250
+ type: _stateMachine.TaskEvent.CTQ_CANCEL,
251
+ taskData: payload
252
+ };
253
+ case _types2.CC_EVENTS.AGENT_CTQ_CANCEL_FAILED:
254
+ return {
255
+ type: _stateMachine.TaskEvent.CTQ_CANCEL_FAILED,
256
+ taskData: payload
257
+ };
258
+ case _types2.CC_EVENTS.AGENT_BLIND_TRANSFERRED: // AgentBlindTransferred -> TRANSFER_SUCCESS
259
+ case _types2.CC_EVENTS.AGENT_CONSULT_TRANSFERRED: // AgentConsultTransferred -> TRANSFER_SUCCESS
260
+ case _types2.CC_EVENTS.AGENT_VTEAM_TRANSFERRED:
261
+ // AgentVTeamTransferred -> TRANSFER_SUCCESS
262
+ return {
263
+ type: _stateMachine.TaskEvent.TRANSFER_SUCCESS,
264
+ taskData: payload
265
+ };
266
+ case _types2.CC_EVENTS.AGENT_WRAPUP:
267
+ return {
268
+ type: _stateMachine.TaskEvent.TASK_WRAPUP,
269
+ taskData: {
270
+ ...payload,
271
+ wrapUpRequired: true
272
+ }
273
+ };
274
+ case _types2.CC_EVENTS.AGENT_CONTACT_UNASSIGNED:
275
+ return null;
276
+ // Add WRAPUP if needed
277
+
278
+ case _types2.CC_EVENTS.AGENT_BLIND_TRANSFER_FAILED:
279
+ case _types2.CC_EVENTS.AGENT_VTEAM_TRANSFER_FAILED:
280
+ case _types2.CC_EVENTS.AGENT_CONSULT_TRANSFER_FAILED:
281
+ case _types2.CC_EVENTS.AGENT_CONFERENCE_TRANSFER_FAILED:
282
+ return {
283
+ type: _stateMachine.TaskEvent.TRANSFER_FAILED,
284
+ taskData: payload
285
+ };
286
+ case _types2.CC_EVENTS.CONTACT_ENDED:
287
+ return {
288
+ type: _stateMachine.TaskEvent.CONTACT_ENDED,
289
+ taskData: {
290
+ ...payload,
291
+ wrapUpRequired: (0, _TaskUtils.isCampaignPreviewTask)(payload) ? false : payload.agentsPendingWrapUp?.includes(agentId || '') || false
292
+ }
293
+ };
294
+ case _types2.CC_EVENTS.AGENT_INVITE_FAILED:
295
+ return {
296
+ type: _stateMachine.TaskEvent.INVITE_FAILED,
297
+ reason: payload.reason
298
+ };
299
+ case _types2.CC_EVENTS.AGENT_CONTACT_ASSIGN_FAILED:
300
+ return {
301
+ type: _stateMachine.TaskEvent.ASSIGN_FAILED,
302
+ reason: payload.reason
303
+ };
304
+ case _types2.CC_EVENTS.AGENT_CONTACT_OFFER_RONA:
305
+ return {
306
+ type: _stateMachine.TaskEvent.RONA,
307
+ taskData: payload,
308
+ reason: payload.reason
309
+ };
310
+ case _types2.CC_EVENTS.AGENT_OUTBOUND_FAILED:
311
+ return {
312
+ type: _stateMachine.TaskEvent.OUTBOUND_FAILED,
313
+ taskData: payload,
314
+ reason: payload.reason
315
+ };
316
+ case _types2.CC_EVENTS.CAMPAIGN_PREVIEW_ACCEPT_FAILED:
317
+ return {
318
+ type: _stateMachine.TaskEvent.CAMPAIGN_PREVIEW_ACCEPT_FAILED,
319
+ taskData: payload
320
+ };
321
+ case _types2.CC_EVENTS.CAMPAIGN_PREVIEW_SKIP_FAILED:
322
+ return {
323
+ type: _stateMachine.TaskEvent.CAMPAIGN_PREVIEW_SKIP_FAILED,
324
+ taskData: payload
325
+ };
326
+ case _types2.CC_EVENTS.CAMPAIGN_PREVIEW_REMOVE_FAILED:
327
+ return {
328
+ type: _stateMachine.TaskEvent.CAMPAIGN_PREVIEW_REMOVE_FAILED,
329
+ taskData: payload
330
+ };
331
+ case _types2.CC_EVENTS.CONTACT_RECORDING_STARTED:
332
+ return {
333
+ type: _stateMachine.TaskEvent.RECORDING_STARTED,
334
+ taskData: payload
335
+ };
336
+ case _types2.CC_EVENTS.CONTACT_RECORDING_PAUSED:
337
+ return {
338
+ type: _stateMachine.TaskEvent.PAUSE_RECORDING,
339
+ taskData: payload
340
+ };
341
+ case _types2.CC_EVENTS.CONTACT_RECORDING_RESUMED:
342
+ return {
343
+ type: _stateMachine.TaskEvent.RESUME_RECORDING,
344
+ taskData: payload
345
+ };
346
+ case _types2.CC_EVENTS.AGENT_WRAPPEDUP:
347
+ return {
348
+ type: _stateMachine.TaskEvent.WRAPUP_COMPLETE,
349
+ taskData: payload
350
+ };
351
+
352
+ // Conference events - these trigger state machine transition to CONFERENCING
353
+ case _types2.CC_EVENTS.AGENT_CONSULT_CONFERENCED:
354
+ case _types2.CC_EVENTS.AGENT_CONSULT_CONFERENCING:
355
+ case _types2.CC_EVENTS.PARTICIPANT_JOINED_CONFERENCE:
356
+ return {
357
+ type: _stateMachine.TaskEvent.CONFERENCE_START,
358
+ taskData: payload
359
+ };
360
+ case _types2.CC_EVENTS.AGENT_CONSULT_CONFERENCE_FAILED:
361
+ return {
362
+ type: _stateMachine.TaskEvent.CONFERENCE_FAILED,
363
+ reason: payload.reason,
364
+ taskData: payload
365
+ };
366
+ case _types2.CC_EVENTS.AGENT_CONSULT_CONFERENCE_ENDED:
367
+ return {
368
+ type: _stateMachine.TaskEvent.CONFERENCE_END,
369
+ taskData: payload
370
+ };
371
+ case _types2.CC_EVENTS.PARTICIPANT_LEFT_CONFERENCE:
372
+ return {
373
+ type: _stateMachine.TaskEvent.PARTICIPANT_LEAVE,
374
+ taskData: payload,
375
+ participantId: payload?.participantId
376
+ };
377
+ case _types2.CC_EVENTS.AGENT_CONFERENCE_TRANSFERRED:
378
+ return {
379
+ type: _stateMachine.TaskEvent.TRANSFER_CONFERENCE_SUCCESS,
380
+ taskData: payload
381
+ };
382
+ default:
383
+ // Not all events need state machine mapping
384
+ return null;
385
+ }
386
+ }
387
+
388
+ /**
389
+ * Register WebSocket message listeners for task events
390
+ *
391
+ * Main entry point that orchestrates event processing through a clear pipeline:
392
+ * 1. Parse and validate incoming WebSocket messages
393
+ * 2. Prepare event context with task and state machine mappings
394
+ * 3. Handle task lifecycle (creation, updates, collection management)
395
+ * 4. Send events to state machine (task-level transitions/emissions)
396
+ * 5. Cleanup is triggered via task events emitted by the state machine
397
+ *
398
+ * This architecture separates concerns:
399
+ * - TaskManager: Manages task collection lifecycle and operational concerns
400
+ * - State Machine: Manages individual task state and event emissions
401
+ */
80
402
  registerTaskListeners() {
81
403
  this.webSocketManager.on('message', event => {
82
- const payload = JSON.parse(event);
83
- // Re-emit the task events to the task object
84
- let task;
85
- if (payload.data?.type) {
86
- if (Object.values(_types2.CC_TASK_EVENTS).includes(payload.data.type)) {
87
- task = this.taskCollection[payload.data.interactionId];
88
- }
89
- _loggerProxy.default.info(`Handling task event ${payload.data?.type}`, {
90
- module: _constants.TASK_MANAGER_FILE,
91
- method: _constants2.METHODS.REGISTER_TASK_LISTENERS,
92
- interactionId: payload.data?.interactionId
93
- });
94
- switch (payload.data.type) {
95
- case _types2.CC_EVENTS.AGENT_CONTACT:
96
- // Case1 : Task is already present in taskCollection
97
- if (this.taskCollection[payload.data.interactionId]) {
98
- _loggerProxy.default.log(`Got AGENT_CONTACT: Task already exists in collection`, {
99
- module: _constants.TASK_MANAGER_FILE,
100
- method: _constants2.METHODS.REGISTER_TASK_LISTENERS,
101
- interactionId: payload.data.interactionId
102
- });
103
- break;
104
- } else if (!this.taskCollection[payload.data.interactionId]) {
105
- // Case2 : Task is not present in taskCollection
106
- _loggerProxy.default.log(`Got AGENT_CONTACT : Creating new task in taskManager`, {
107
- module: _constants.TASK_MANAGER_FILE,
108
- method: _constants2.METHODS.REGISTER_TASK_LISTENERS,
109
- interactionId: payload.data.interactionId
110
- });
111
-
112
- // Check if auto-answer should happen for this task
113
- const shouldAutoAnswer = (0, _TaskUtils.shouldAutoAnswerTask)(payload.data, this.agentId, this.webCallingService.loginOption, this.webRtcEnabled);
114
- task = new _.default(this.contact, this.webCallingService, {
115
- ...payload.data,
116
- wrapUpRequired: payload.data.interaction?.participants?.[this.agentId]?.isWrapUp || false,
117
- isConferenceInProgress: (0, _TaskUtils.getIsConferenceInProgress)(payload.data),
118
- isAutoAnswering: shouldAutoAnswer // Set flag before emitting
119
- }, this.wrapupData, this.agentId);
120
- this.taskCollection[payload.data.interactionId] = task;
121
- // Condition 1: The state is=new i.e it is a incoming task
122
- if (payload.data.interaction.state === 'new') {
123
- _loggerProxy.default.log(`Got AGENT_CONTACT for a task with state=new, sending TASK_INCOMING event`, {
124
- module: _constants.TASK_MANAGER_FILE,
125
- method: _constants2.METHODS.REGISTER_TASK_LISTENERS,
126
- interactionId: payload.data.interactionId
127
- });
128
- this.emit(_types.TASK_EVENTS.TASK_INCOMING, task);
129
- } else {
130
- // Condition 2: The state is anything else i.e the task was connected
131
- _loggerProxy.default.log(`Got AGENT_CONTACT for a task with state=${payload.data.interaction.state}, sending TASK_HYDRATE event`, {
132
- module: _constants.TASK_MANAGER_FILE,
133
- method: _constants2.METHODS.REGISTER_TASK_LISTENERS,
134
- interactionId: payload.data.interactionId
135
- });
136
- this.emit(_types.TASK_EVENTS.TASK_HYDRATE, task);
137
- }
138
- }
139
- break;
140
- case _types2.CC_EVENTS.AGENT_CONTACT_RESERVED:
141
- {
142
- // Check if auto-answer should happen for this task
143
- const shouldAutoAnswerReserved = (0, _TaskUtils.shouldAutoAnswerTask)(payload.data, this.agentId, this.webCallingService.loginOption, this.webRtcEnabled);
144
- task = new _.default(this.contact, this.webCallingService, {
145
- ...payload.data,
146
- isConsulted: false,
147
- isAutoAnswering: shouldAutoAnswerReserved // Set flag before emitting
148
- }, this.wrapupData, this.agentId);
149
- this.taskCollection[payload.data.interactionId] = task;
150
- if (this.webCallingService.loginOption !== _types3.LoginOption.BROWSER || task.data.interaction.mediaType !== _types.MEDIA_CHANNEL.TELEPHONY // for digital channels
151
- ) {
152
- this.emit(_types.TASK_EVENTS.TASK_INCOMING, task);
153
- } else if (this.call) {
154
- this.emit(_types.TASK_EVENTS.TASK_INCOMING, task);
155
- }
156
- break;
157
- }
158
- case _types2.CC_EVENTS.AGENT_OFFER_CONTACT:
159
- // We don't have to emit any event here since this will be result of promise.
160
- task = this.updateTaskData(task, payload.data);
161
- _loggerProxy.default.log(`Agent offer contact received for task`, {
162
- module: _constants.TASK_MANAGER_FILE,
163
- method: _constants2.METHODS.REGISTER_TASK_LISTENERS,
164
- interactionId: payload.data?.interactionId
165
- });
166
- this.emit(_types.TASK_EVENTS.TASK_OFFER_CONTACT, task);
167
-
168
- // Handle auto-answer for offer contact
169
- this.handleAutoAnswer(task);
170
- break;
171
- case _types2.CC_EVENTS.AGENT_OUTBOUND_FAILED:
172
- if (task) {
173
- task = this.updateTaskData(task, payload.data);
174
- this.metricsManager.trackEvent(_constants3.METRIC_EVENT_NAMES.TASK_OUTDIAL_FAILED, {
175
- ..._MetricsManager.default.getCommonTrackingFieldForAQMResponse(payload.data),
176
- taskId: payload.data.interactionId,
177
- reason: payload.data.reasonCode || payload.data.reason
178
- }, ['behavioral', 'operational']);
179
- _loggerProxy.default.log(`Agent outbound failed for task`, {
180
- module: _constants.TASK_MANAGER_FILE,
181
- method: _constants2.METHODS.REGISTER_TASK_LISTENERS,
182
- interactionId: payload.data.interactionId
183
- });
184
- task.emit(_types.TASK_EVENTS.TASK_OUTDIAL_FAILED, payload.data.reason ?? 'UNKNOWN_REASON');
185
- }
186
- break;
187
- case _types2.CC_EVENTS.AGENT_CONTACT_ASSIGNED:
188
- task = this.updateTaskData(task, payload.data);
189
- task.emit(_types.TASK_EVENTS.TASK_ASSIGNED, task);
190
- break;
191
- case _types2.CC_EVENTS.AGENT_CONTACT_UNASSIGNED:
192
- task = this.updateTaskData(task, {
193
- ...payload.data,
194
- wrapUpRequired: true
195
- });
196
- task.emit(_types.TASK_EVENTS.TASK_END, task);
197
- break;
198
- case _types2.CC_EVENTS.AGENT_CONTACT_OFFER_RONA:
199
- case _types2.CC_EVENTS.AGENT_CONTACT_ASSIGN_FAILED:
200
- case _types2.CC_EVENTS.AGENT_INVITE_FAILED:
201
- {
202
- task = this.updateTaskData(task, payload.data);
203
- const eventTypeToMetricMap = {
204
- [_types2.CC_EVENTS.AGENT_CONTACT_ASSIGN_FAILED]: 'AGENT_CONTACT_ASSIGN_FAILED',
205
- [_types2.CC_EVENTS.AGENT_INVITE_FAILED]: 'AGENT_INVITE_FAILED'
206
- };
207
- const metricEventName = eventTypeToMetricMap[payload.data.type] || 'AGENT_RONA';
208
- this.metricsManager.trackEvent(_constants3.METRIC_EVENT_NAMES[metricEventName], {
209
- ..._MetricsManager.default.getCommonTrackingFieldForAQMResponse(payload.data),
210
- taskId: payload.data.interactionId,
211
- reason: payload.data.reason
212
- }, ['behavioral', 'operational']);
213
- this.handleTaskCleanup(task);
214
- task.emit(_types.TASK_EVENTS.TASK_REJECT, payload.data.reason);
215
- break;
216
- }
217
- case _types2.CC_EVENTS.CONTACT_ENDED:
218
- // Update task data
219
- if (task) {
220
- task = this.updateTaskData(task, {
221
- ...payload.data,
222
- wrapUpRequired: payload.data.interaction.state !== 'new' && !(0, _TaskUtils.isSecondaryEpDnAgent)(payload.data.interaction)
223
- });
224
-
225
- // Handle cleanup based on whether task should be deleted
226
- this.handleTaskCleanup(task);
227
- task?.emit(_types.TASK_EVENTS.TASK_END, task);
228
- }
229
- break;
230
- case _types2.CC_EVENTS.CONTACT_MERGED:
231
- task = this.handleContactMerged(task, payload.data);
232
- break;
233
- case _types2.CC_EVENTS.AGENT_CONTACT_HELD:
234
- // As soon as the main interaction is held, we need to emit TASK_HOLD
235
- task = this.updateTaskData(task, payload.data);
236
- task.emit(_types.TASK_EVENTS.TASK_HOLD, task);
237
- break;
238
- case _types2.CC_EVENTS.AGENT_CONTACT_UNHELD:
239
- // As soon as the main interaction is unheld, we need to emit TASK_RESUME
240
- task = this.updateTaskData(task, payload.data);
241
- task.emit(_types.TASK_EVENTS.TASK_RESUME, task);
242
- break;
243
- case _types2.CC_EVENTS.AGENT_VTEAM_TRANSFERRED:
244
- task = this.updateTaskData(task, {
245
- ...payload.data,
246
- wrapUpRequired: true
247
- });
248
- task.emit(_types.TASK_EVENTS.TASK_END, task);
249
- break;
250
- case _types2.CC_EVENTS.AGENT_CTQ_CANCEL_FAILED:
251
- task = this.updateTaskData(task, payload.data);
252
- task.emit(_types.TASK_EVENTS.TASK_CONSULT_QUEUE_FAILED, task);
253
- break;
254
- case _types2.CC_EVENTS.AGENT_CONSULT_CREATED:
255
- // Received when self agent initiates a consult
256
- task = this.updateTaskData(task, {
257
- ...payload.data,
258
- isConsulted: false // This ensures that the task consult status is always reset
259
- });
260
- task.emit(_types.TASK_EVENTS.TASK_CONSULT_CREATED, task);
261
- break;
262
- case _types2.CC_EVENTS.AGENT_OFFER_CONSULT:
263
- // Received when other agent sends us a consult offer
264
- task = this.updateTaskData(task, {
265
- ...payload.data,
266
- isConsulted: true // This ensures that the task is marked as us being requested for a consult
267
- });
268
- task.emit(_types.TASK_EVENTS.TASK_OFFER_CONSULT, task);
269
-
270
- // Handle auto-answer for consult offer
271
- this.handleAutoAnswer(task);
272
- break;
273
- case _types2.CC_EVENTS.AGENT_CONSULTING:
274
- // Received when agent is in an active consult state
275
- // TODO: Check if we can use backend consult state instead of isConsulted
276
- task = this.updateTaskData(task, payload.data);
277
- if (task.data.isConsulted) {
278
- // Fire only if you are the agent who received the consult request
279
- task.emit(_types.TASK_EVENTS.TASK_CONSULT_ACCEPTED, task);
280
- } else {
281
- // Fire only if you are the agent who initiated the consult
282
- task.emit(_types.TASK_EVENTS.TASK_CONSULTING, task);
283
- }
284
- break;
285
- case _types2.CC_EVENTS.AGENT_CONSULT_FAILED:
286
- // This can only be received by the agent who initiated the consult.
287
- // We need not emit any event here since this will be result of promise
288
- task = this.updateTaskData(task, payload.data);
289
- break;
290
- case _types2.CC_EVENTS.AGENT_CONSULT_ENDED:
291
- task = this.updateTaskData(task, payload.data);
292
- if (task.data.isConsulted) {
293
- // This will be the end state of the task as soon as we end the consult in case of
294
- // us being offered a consult
295
- this.removeTaskFromCollection(task);
296
- }
297
- task.emit(_types.TASK_EVENTS.TASK_CONSULT_END, task);
298
- break;
299
- case _types2.CC_EVENTS.AGENT_CTQ_CANCELLED:
300
- // This event is received when the consult using queue is cancelled using API
301
- task = this.updateTaskData(task, payload.data);
302
- task.emit(_types.TASK_EVENTS.TASK_CONSULT_QUEUE_CANCELLED, task);
303
- break;
304
- case _types2.CC_EVENTS.AGENT_WRAPUP:
305
- task = this.updateTaskData(task, {
306
- ...payload.data,
307
- wrapUpRequired: true
308
- });
309
- task.emit(_types.TASK_EVENTS.TASK_END, task);
310
- break;
311
- case _types2.CC_EVENTS.AGENT_WRAPPEDUP:
312
- task.cancelAutoWrapupTimer();
313
- this.removeTaskFromCollection(task);
314
- task.emit(_types.TASK_EVENTS.TASK_WRAPPEDUP, task);
315
- break;
316
- case _types2.CC_EVENTS.CONTACT_RECORDING_PAUSED:
317
- task = this.updateTaskData(task, payload.data);
318
- task.emit(_types.TASK_EVENTS.TASK_RECORDING_PAUSED, task);
319
- break;
320
- case _types2.CC_EVENTS.CONTACT_RECORDING_PAUSE_FAILED:
321
- task = this.updateTaskData(task, payload.data);
322
- task.emit(_types.TASK_EVENTS.TASK_RECORDING_PAUSE_FAILED, task);
323
- break;
324
- case _types2.CC_EVENTS.CONTACT_RECORDING_RESUMED:
325
- task = this.updateTaskData(task, payload.data);
326
- task.emit(_types.TASK_EVENTS.TASK_RECORDING_RESUMED, task);
327
- break;
328
- case _types2.CC_EVENTS.CONTACT_RECORDING_RESUME_FAILED:
329
- task = this.updateTaskData(task, payload.data);
330
- task.emit(_types.TASK_EVENTS.TASK_RECORDING_RESUME_FAILED, task);
331
- break;
332
- case _types2.CC_EVENTS.AGENT_CONSULT_CONFERENCING:
333
- // Conference is being established - update task state and emit establishing event
334
- task = this.updateTaskData(task, payload.data);
335
- task.emit(_types.TASK_EVENTS.TASK_CONFERENCE_ESTABLISHING, task);
336
- break;
337
- case _types2.CC_EVENTS.AGENT_CONSULT_CONFERENCED:
338
- // Conference started successfully - update task state and emit event
339
- task = this.updateTaskData(task, payload.data);
340
- task.emit(_types.TASK_EVENTS.TASK_CONFERENCE_STARTED, task);
341
- break;
342
- case _types2.CC_EVENTS.AGENT_CONSULT_CONFERENCE_FAILED:
343
- // Conference failed - update task state and emit failure event
344
- task = this.updateTaskData(task, payload.data);
345
- task.emit(_types.TASK_EVENTS.TASK_CONFERENCE_FAILED, task);
346
- break;
347
- case _types2.CC_EVENTS.AGENT_CONSULT_CONFERENCE_ENDED:
348
- // Conference ended - update task state and emit event
349
- task = this.updateTaskData(task, payload.data);
350
- if (!task || (0, _TaskUtils.isPrimary)(task, this.agentId) || (0, _TaskUtils.isParticipantInMainInteraction)(task, this.agentId)) {
351
- _loggerProxy.default.log('Primary or main interaction participant leaving conference');
352
- } else {
353
- this.removeTaskFromCollection(task);
354
- }
355
- task.emit(_types.TASK_EVENTS.TASK_CONFERENCE_ENDED, task);
356
- break;
357
- case _types2.CC_EVENTS.PARTICIPANT_JOINED_CONFERENCE:
358
- {
359
- task = this.updateTaskData(task, {
360
- ...payload.data,
361
- isConferenceInProgress: (0, _TaskUtils.getIsConferenceInProgress)(payload.data)
362
- });
363
- task.emit(_types.TASK_EVENTS.TASK_PARTICIPANT_JOINED, task);
364
- break;
365
- }
366
- case _types2.CC_EVENTS.PARTICIPANT_LEFT_CONFERENCE:
367
- {
368
- // Conference ended - update task state and emit event
369
-
370
- task = this.updateTaskData(task, {
371
- ...payload.data,
372
- isConferenceInProgress: (0, _TaskUtils.getIsConferenceInProgress)(payload.data)
373
- });
374
- if ((0, _TaskUtils.checkParticipantNotInInteraction)(task, this.agentId)) {
375
- if ((0, _TaskUtils.isParticipantInMainInteraction)(task, this.agentId) || (0, _TaskUtils.isPrimary)(task, this.agentId)) {
376
- _loggerProxy.default.log('Primary or main interaction participant leaving conference');
377
- } else {
378
- this.removeTaskFromCollection(task);
379
- }
380
- }
381
- task.emit(_types.TASK_EVENTS.TASK_PARTICIPANT_LEFT, task);
382
- break;
383
- }
384
- case _types2.CC_EVENTS.PARTICIPANT_LEFT_CONFERENCE_FAILED:
385
- // Conference exit failed - update task state and emit failure event
386
- task = this.updateTaskData(task, payload.data);
387
- task.emit(_types.TASK_EVENTS.TASK_PARTICIPANT_LEFT_FAILED, task);
388
- break;
389
- case _types2.CC_EVENTS.AGENT_CONSULT_CONFERENCE_END_FAILED:
390
- // Conference end failed - update task state with error details and emit failure event
391
- task = this.updateTaskData(task, payload.data);
392
- task.emit(_types.TASK_EVENTS.TASK_CONFERENCE_END_FAILED, task);
393
- break;
394
- case _types2.CC_EVENTS.AGENT_CONFERENCE_TRANSFERRED:
395
- // Conference was transferred - update task state and emit transfer success event
396
- // Note: Backend should provide hasLeft and wrapUpRequired status
397
- task = this.updateTaskData(task, payload.data);
398
- task.emit(_types.TASK_EVENTS.TASK_CONFERENCE_TRANSFERRED, task);
399
- break;
400
- case _types2.CC_EVENTS.AGENT_CONFERENCE_TRANSFER_FAILED:
401
- // Conference transfer failed - update task state with error details and emit failure event
402
- task = this.updateTaskData(task, payload.data);
403
- task.emit(_types.TASK_EVENTS.TASK_CONFERENCE_TRANSFER_FAILED, task);
404
- break;
405
- case _types2.CC_EVENTS.PARTICIPANT_POST_CALL_ACTIVITY:
406
- // Post-call activity for participant - update task state with activity details
407
- task = this.updateTaskData(task, payload.data);
408
- task.emit(_types.TASK_EVENTS.TASK_POST_CALL_ACTIVITY, task);
409
- break;
410
- default:
411
- break;
412
- }
413
- if (task) {
414
- task.emit(payload.data.type, payload.data);
415
- }
404
+ // Step 1: Parse and validate the message
405
+ const message = TaskManager.parseWebSocketMessage(event);
406
+ if (!message) return;
407
+
408
+ // Step 2: Prepare event context
409
+ const eventContext = this.prepareEventContext(message);
410
+ if (!eventContext) return;
411
+ const actions = this.handleTaskLifecycleEvent(eventContext);
412
+ const {
413
+ task
414
+ } = actions;
415
+ if (!task) return;
416
+ const {
417
+ payload,
418
+ stateMachineEvent
419
+ } = eventContext;
420
+
421
+ // Always keep task.data updated (even for mapped events) so consumers relying
422
+ // on TaskManager-managed task instances see the latest payload.
423
+ if (payload) {
424
+ this.updateTaskData(task, payload);
425
+ }
426
+
427
+ // Send event to state machine - this will trigger all TASK_EVENTS emissions
428
+ // including TASK_INCOMING which is now handled via the state machine callbacks
429
+ if (stateMachineEvent) {
430
+ task.sendStateMachineEvent(stateMachineEvent);
431
+ }
432
+
433
+ // Emit TASK_POST_CALL_ACTIVITY for ParticipantPostCallActivity events so
434
+ // consumers (Widgets) can detect the interaction state change to post_call.
435
+ if (eventContext.eventType === _types2.CC_EVENTS.PARTICIPANT_POST_CALL_ACTIVITY) {
436
+ task.emit(_types.TASK_EVENTS.TASK_POST_CALL_ACTIVITY, task);
416
437
  }
438
+
439
+ // Send transcript start/stop events for relevant CC events
440
+ this.requestRealTimeTranscripts(eventContext.eventType, payload.interactionId);
417
441
  });
418
442
  }
419
- updateTaskData(task, taskData) {
420
- if (!task) {
421
- return undefined;
422
- }
423
- if (!taskData?.interactionId) {
424
- _loggerProxy.default.warn('Received task update with missing interactionId', {
425
- module: _constants.TASK_MANAGER_FILE,
426
- method: _constants2.METHODS.UPDATE_TASK_DATA
427
- });
428
- }
443
+
444
+ /**
445
+ * Parse and validate WebSocket message
446
+ * @returns Parsed message or null if invalid/keepalive
447
+ */
448
+ static parseWebSocketMessage(event) {
429
449
  try {
430
- const currentTask = task.updateTaskData(taskData);
431
- this.taskCollection[taskData.interactionId] = currentTask;
432
- return currentTask;
450
+ const payload = JSON.parse(event);
451
+
452
+ // Filter out keepalive messages
453
+ if (payload?.keepalive === 'true' || payload?.keepalive === true) {
454
+ return null;
455
+ }
456
+
457
+ // Normalize task data if present
458
+ if (payload?.data?.interaction) {
459
+ payload.data = (0, _taskDataNormalizer.normalizeTaskData)(payload.data);
460
+ }
461
+ return payload;
433
462
  } catch (error) {
434
- _loggerProxy.default.error(`Failed to update task`, {
463
+ _loggerProxy.default.error('Failed to parse WebSocket message', {
435
464
  module: _constants.TASK_MANAGER_FILE,
436
- method: _constants2.METHODS.UPDATE_TASK_DATA,
437
- interactionId: taskData.interactionId
465
+ method: 'parseWebSocketMessage',
466
+ error
438
467
  });
439
- return task;
468
+ return null;
440
469
  }
441
470
  }
442
471
 
443
472
  /**
444
- * Handles CONTACT_MERGED event logic
445
- * @param task - The task to process
446
- * @param taskData - The task data from the event payload
447
- * @returns Updated or newly created task
448
- * @private
473
+ * Prepare context for event processing
474
+ * @returns Event context or null if event type is invalid
449
475
  */
450
- handleContactMerged(task, taskData) {
451
- if (taskData.childInteractionId) {
452
- // remove the child task from collection
453
- this.removeTaskFromCollection(this.taskCollection[taskData.childInteractionId]);
476
+ prepareEventContext(message) {
477
+ const eventType = message.data?.type || message.type;
478
+ if (!eventType || !isCcEvent(eventType)) {
479
+ return null;
454
480
  }
455
- if (this.taskCollection[taskData.interactionId]) {
456
- _loggerProxy.default.log(`Got CONTACT_MERGED: Task already exists in collection`, {
481
+ const interactionId = message.data.interactionId;
482
+ const reservationInteractionId = message.data.reservationInteractionId;
483
+ let task = this.taskCollection[interactionId];
484
+
485
+ // When a campaign preview contact is accepted, the assigned event may arrive
486
+ // with a new interactionId while the task is stored under the original
487
+ // reservationInteractionId. Fall back to that key so the task is found.
488
+ if (!task && reservationInteractionId) {
489
+ task = this.taskCollection[reservationInteractionId];
490
+ if (task) {
491
+ // Re-key the task under the new interaction ID and remove the old entry
492
+ delete this.taskCollection[reservationInteractionId];
493
+ this.taskCollection[interactionId] = task;
494
+ }
495
+ }
496
+ const wasConsultedTask = Boolean(task?.data?.isConsulted);
497
+ const computeWrapUpRequired = () => {
498
+ if (message.data.wrapUpRequired !== undefined) {
499
+ return message.data.wrapUpRequired;
500
+ }
501
+ if (message.data.isConsulted !== undefined) {
502
+ return !message.data.isConsulted;
503
+ }
504
+ return !wasConsultedTask;
505
+ };
506
+ const adjustedPayload = eventType === _types2.CC_EVENTS.AGENT_CONSULT_TRANSFERRED || eventType === _types2.CC_EVENTS.AGENT_BLIND_TRANSFERRED || eventType === _types2.CC_EVENTS.AGENT_VTEAM_TRANSFERRED ? {
507
+ ...message.data,
508
+ wrapUpRequired: computeWrapUpRequired()
509
+ } : message.data;
510
+ const stateMachineEvent = TaskManager.mapEventToTaskStateMachineEvent(eventType, adjustedPayload, this.agentId);
511
+ _loggerProxy.default.info(`Handling task event ${eventType}`, {
512
+ module: _constants.TASK_MANAGER_FILE,
513
+ method: 'prepareEventContext',
514
+ interactionId
515
+ });
516
+ return {
517
+ eventType,
518
+ payload: adjustedPayload,
519
+ task,
520
+ stateMachineEvent
521
+ };
522
+ }
523
+
524
+ /**
525
+ * Handle task lifecycle events and determine required actions
526
+ *
527
+ * Delegates to specific event handlers based on event type. Each handler
528
+ * is responsible for TaskManager-level concerns:
529
+ * - Task creation and collection management
530
+ * - Metrics tracking
531
+ * - Resource cleanup decisions
532
+ *
533
+ * Note: Task-level state transitions and event emissions are handled by
534
+ * the task state machine via sendStateMachineEvent()
535
+ */
536
+ handleTaskLifecycleEvent(context) {
537
+ const {
538
+ eventType
539
+ } = context;
540
+ switch (eventType) {
541
+ case _types2.CC_EVENTS.AGENT_CONTACT_RESERVED:
542
+ return this.handleContactReserved(context);
543
+ case _types2.CC_EVENTS.AGENT_CONTACT:
544
+ return this.handleAgentContact(context);
545
+ case _types2.CC_EVENTS.CONTACT_MERGED:
546
+ return this.handleContactMergedEvent(context);
547
+ case _types2.CC_EVENTS.AGENT_OFFER_CAMPAIGN_RESERVATION:
548
+ return this.handleCampaignPreviewReservation(context);
549
+ case _types2.CC_EVENTS.CAMPAIGN_CONTACT_UPDATED:
550
+ return this.handleCampaignContactUpdated(context);
551
+ default:
552
+ return {
553
+ task: context.task
554
+ };
555
+ }
556
+ }
557
+ handleCampaignContactUpdated(context) {
558
+ const {
559
+ payload
560
+ } = context;
561
+ let {
562
+ task
563
+ } = context;
564
+ // CampaignContactUpdated is a non-terminal event (e.g., next contact after skip/remove).
565
+ // Update the task data and emit an event so consumers can react to the updated contact.
566
+ // Do NOT remove the task or emit TASK_END — cleanup is handled by CONTACT_ENDED.
567
+ if (task) {
568
+ // Carry forward campaign preview fields from existing task data since the updated
569
+ // contact payload may not include them, and reconcileData would delete them.
570
+ const existingCpd = task.data?.interaction?.callProcessingDetails;
571
+ const updatedData = {
572
+ ...payload
573
+ };
574
+ if (existingCpd) {
575
+ const campaignFields = {
576
+ ...(existingCpd.campaignPreviewAutoAction && {
577
+ campaignPreviewAutoAction: existingCpd.campaignPreviewAutoAction
578
+ }),
579
+ ...(existingCpd.campaignPreviewOfferTimeout && {
580
+ campaignPreviewOfferTimeout: existingCpd.campaignPreviewOfferTimeout
581
+ }),
582
+ ...(existingCpd.campaignPreviewSkipDisabled && {
583
+ campaignPreviewSkipDisabled: existingCpd.campaignPreviewSkipDisabled
584
+ }),
585
+ ...(existingCpd.campaignPreviewRemoveDisabled && {
586
+ campaignPreviewRemoveDisabled: existingCpd.campaignPreviewRemoveDisabled
587
+ })
588
+ };
589
+ if (!updatedData.interaction) {
590
+ updatedData.interaction = {};
591
+ }
592
+ updatedData.interaction = {
593
+ ...updatedData.interaction,
594
+ callProcessingDetails: {
595
+ ...campaignFields,
596
+ ...(updatedData.interaction.callProcessingDetails || {})
597
+ }
598
+ };
599
+ }
600
+ _loggerProxy.default.log('Campaign contact updated - carrying forward preview fields', {
457
601
  module: _constants.TASK_MANAGER_FILE,
458
602
  method: _constants2.METHODS.REGISTER_TASK_LISTENERS,
459
- interactionId: taskData.interactionId
603
+ interactionId: payload.interactionId,
604
+ data: {
605
+ hasCpd: !!updatedData.interaction?.callProcessingDetails,
606
+ autoAction: updatedData.interaction?.callProcessingDetails?.campaignPreviewAutoAction,
607
+ skipDisabled: updatedData.interaction?.callProcessingDetails?.campaignPreviewSkipDisabled,
608
+ removeDisabled: updatedData.interaction?.callProcessingDetails?.campaignPreviewRemoveDisabled
609
+ }
460
610
  });
461
- // update the task data
462
- task = this.updateTaskData(task, taskData);
611
+ task = this.updateTaskData(task, updatedData);
612
+ task.emit(_types.TASK_EVENTS.TASK_CAMPAIGN_CONTACT_UPDATED, task);
613
+ }
614
+ return {
615
+ task
616
+ };
617
+ }
618
+
619
+ /**
620
+ * Creates or updates a task for campaign preview reservation.
621
+ * TASK_CAMPAIGN_PREVIEW_RESERVATION is emitted by the state machine (campaign TASK_INCOMING branch).
622
+ */
623
+ handleCampaignPreviewReservation(context) {
624
+ const {
625
+ payload
626
+ } = context;
627
+ let {
628
+ task
629
+ } = context;
630
+ _loggerProxy.default.log('Campaign preview reservation received', {
631
+ module: _constants.TASK_MANAGER_FILE,
632
+ method: _constants2.METHODS.REGISTER_TASK_LISTENERS,
633
+ interactionId: payload.interactionId
634
+ });
635
+ if (!task) {
636
+ task = _TaskFactory.default.createTask(this.contact, this.webCallingService, {
637
+ ...payload,
638
+ wrapUpRequired: false,
639
+ isConferenceInProgress: false,
640
+ isAutoAnswering: false
641
+ }, this.configFlags, this.wrapupData, this.agentId);
642
+ this.setupTaskListeners(task);
643
+ this.taskCollection[payload.interactionId] = task;
463
644
  } else {
464
- // Case2 : Task is not present in taskCollection
465
- _loggerProxy.default.log(`Got CONTACT_MERGED : Creating new task in taskManager`, {
645
+ task = this.updateTaskData(task, payload);
646
+ }
647
+ return {
648
+ task
649
+ };
650
+ }
651
+
652
+ /**
653
+ * Handle AGENT_CONTACT_RESERVED event
654
+ * Creates a new task; state machine event is sent during processing
655
+ */
656
+ handleContactReserved(context) {
657
+ const {
658
+ payload
659
+ } = context;
660
+ const isConsultedTask = payload.isConsulted === true || (0, _TaskUtils.isSecondaryEpDnAgent)(payload.interaction);
661
+ const shouldAutoAnswer = (0, _TaskUtils.shouldAutoAnswerTask)(payload, this.agentId, this.webCallingService.loginOption, this.webRtcEnabled);
662
+ const taskData = {
663
+ ...payload,
664
+ isConsulted: isConsultedTask,
665
+ isAutoAnswering: shouldAutoAnswer
666
+ };
667
+ const task = _TaskFactory.default.createTask(this.contact, this.webCallingService, taskData, this.configFlags, this.wrapupData, this.agentId);
668
+ this.setupTaskListeners(task);
669
+ this.taskCollection[payload.interactionId] = task;
670
+ return {
671
+ task
672
+ };
673
+ }
674
+
675
+ /**
676
+ * Handle AGENT_CONTACT event
677
+ * Re-creates task if missing (multi-session scenario)
678
+ */
679
+ handleAgentContact(context) {
680
+ let {
681
+ task
682
+ } = context;
683
+ const {
684
+ payload
685
+ } = context;
686
+ if (!task) {
687
+ const isConsultedTask = payload.isConsulted === true || (0, _TaskUtils.isSecondaryEpDnAgent)(payload.interaction);
688
+ const shouldAutoAnswer = (0, _TaskUtils.shouldAutoAnswerTask)(payload, this.agentId, this.webCallingService.loginOption, this.webRtcEnabled);
689
+ const taskData = {
690
+ ...payload,
691
+ isConsulted: isConsultedTask,
692
+ wrapUpRequired: payload.interaction?.participants?.[this.agentId]?.isWrapUp || false,
693
+ isConferenceInProgress: (0, _TaskUtils.getIsConferenceInProgress)(payload),
694
+ isAutoAnswering: shouldAutoAnswer
695
+ };
696
+ task = _TaskFactory.default.createTask(this.contact, this.webCallingService, taskData, this.configFlags, this.wrapupData, this.agentId);
697
+ this.setupTaskListeners(task);
698
+ this.taskCollection[payload.interactionId] = task;
699
+ }
700
+ return {
701
+ task
702
+ };
703
+ }
704
+ updateTaskData(task, taskData) {
705
+ if (!task) {
706
+ throw new Error('Task not found for update');
707
+ }
708
+ const snapshot = task.stateMachineService?.getSnapshot?.();
709
+ const isConsultingFlow = snapshot?.value === 'CONSULTING' || taskData.interaction?.state === 'consulting';
710
+ const updateTaskData = isConsultingFlow ? {
711
+ ...taskData,
712
+ destAgentId: taskData.destAgentId ?? snapshot?.context?.consultDestinationAgentId ?? null,
713
+ destinationType: taskData.destinationType ?? snapshot?.context?.consultDestinationType ?? null
714
+ } : taskData;
715
+ task.updateTaskData(updateTaskData);
716
+ this.taskCollection[taskData.interactionId] = task;
717
+ return task;
718
+ }
719
+
720
+ /**
721
+ * Setup listeners for task events that need to be bubbled up to TaskManager
722
+ * This replaces the previous callback injection pattern
723
+ */
724
+ setupTaskListeners(task) {
725
+ // Listen for TASK_INCOMING and re-emit so webex.cc can notify consumers
726
+ task.on(_types.TASK_EVENTS.TASK_INCOMING, t => {
727
+ _loggerProxy.default.log(`Task incoming event received`, {
466
728
  module: _constants.TASK_MANAGER_FILE,
467
729
  method: _constants2.METHODS.REGISTER_TASK_LISTENERS,
468
- interactionId: taskData.interactionId
730
+ interactionId: t.data?.interactionId
469
731
  });
470
- task = new _.default(this.contact, this.webCallingService, {
471
- ...taskData,
472
- wrapUpRequired: taskData.interaction?.participants?.[this.agentId]?.isWrapUp || false,
473
- isConferenceInProgress: (0, _TaskUtils.getIsConferenceInProgress)(taskData)
474
- }, this.wrapupData, this.agentId);
475
- this.taskCollection[taskData.interactionId] = task;
476
- }
477
- this.emit(_types.TASK_EVENTS.TASK_MERGED, task);
478
- return task;
732
+ this.emit(_types.TASK_EVENTS.TASK_INCOMING, t);
733
+ });
734
+ task.on(_types.TASK_EVENTS.TASK_CAMPAIGN_PREVIEW_RESERVATION, t => {
735
+ _loggerProxy.default.log(`Campaign preview reservation event received`, {
736
+ module: _constants.TASK_MANAGER_FILE,
737
+ method: _constants2.METHODS.REGISTER_TASK_LISTENERS,
738
+ interactionId: t.data?.interactionId
739
+ });
740
+ this.emit(_types.TASK_EVENTS.TASK_CAMPAIGN_PREVIEW_RESERVATION, t);
741
+ });
742
+
743
+ // Listen for TASK_HYDRATE on the task and re-emit on TaskManager
744
+ task.on(_types.TASK_EVENTS.TASK_HYDRATE, t => {
745
+ // Task data is already updated by the task itself before emitting
746
+ this.emit(_types.TASK_EVENTS.TASK_HYDRATE, t);
747
+ });
748
+ task.on(_types.TASK_EVENTS.TASK_MULTI_LOGIN_HYDRATE, t => {
749
+ this.emit(_types.TASK_EVENTS.TASK_MULTI_LOGIN_HYDRATE, t);
750
+ });
751
+
752
+ // Listen for internal cleanup signal emitted by the state machine
753
+ task.on(_types.TASK_EVENTS.TASK_CLEANUP, (t, options) => {
754
+ this.handleTaskCleanup(t);
755
+ if (options?.removeFromCollection) {
756
+ const interactionId = t?.data?.interactionId;
757
+ if (interactionId && this.taskCollection[interactionId]) {
758
+ this.removeTaskFromCollection(t);
759
+ }
760
+ }
761
+ });
479
762
  }
480
763
  removeTaskFromCollection(task) {
764
+ if (typeof task.cancelAutoWrapupTimer === 'function') {
765
+ task.cancelAutoWrapupTimer();
766
+ }
481
767
  if (task?.data?.interactionId) {
482
768
  delete this.taskCollection[task.data.interactionId];
483
769
  _loggerProxy.default.info(`Task removed from collection`, {
@@ -489,62 +775,62 @@ class TaskManager extends _events.default {
489
775
  }
490
776
 
491
777
  /**
492
- * Handles auto-answer logic for incoming tasks
493
- * Automatically accepts tasks when isAutoAnswering flag is set
494
- * The flag is set during task creation based on:
495
- * 1. WebRTC calls with auto-answer enabled in agent profile
496
- * 2. Agent-initiated WebRTC outdial calls
497
- * 3. Agent-initiated digital outbound (Email/SMS) without previous transfers
498
- *
499
- * @param task - The task to auto-answer
778
+ * Handles CONTACT_MERGED event logic
779
+ * @param task - The task to process
780
+ * @param taskData - The task data from the event payload
781
+ * @returns Updated or newly created task
500
782
  * @private
501
783
  */
502
- async handleAutoAnswer(task) {
503
- if (!task || !task.data || !task.data.isAutoAnswering) {
504
- return;
784
+ handleContactMergedEvent(context) {
785
+ const {
786
+ payload
787
+ } = context;
788
+ let task = context.task;
789
+ if (payload.childInteractionId && this.taskCollection[payload.childInteractionId]) {
790
+ this.removeTaskFromCollection(this.taskCollection[payload.childInteractionId]);
505
791
  }
506
- _loggerProxy.default.info(`Auto-answering task`, {
507
- module: _constants.TASK_MANAGER_FILE,
508
- method: 'handleAutoAnswer',
509
- interactionId: task.data.interactionId
510
- });
511
- try {
512
- await task.accept();
513
- _loggerProxy.default.info(`Task auto-answered successfully`, {
792
+ if (task) {
793
+ _loggerProxy.default.log(`Got CONTACT_MERGED: Task already exists in collection`, {
514
794
  module: _constants.TASK_MANAGER_FILE,
515
- method: 'handleAutoAnswer',
516
- interactionId: task.data.interactionId
517
- });
518
-
519
- // Track successful auto-answer
520
- this.metricsManager.trackEvent(_constants3.METRIC_EVENT_NAMES.TASK_AUTO_ANSWER_SUCCESS, {
521
- taskId: task.data.interactionId,
522
- mediaType: task.data.interaction.mediaType,
523
- isAutoAnswered: true
524
- }, ['behavioral', 'operational']);
525
- // Emit task:autoAnswered event for widgets/UI to react
526
- task.emit(_types.TASK_EVENTS.TASK_AUTO_ANSWERED, task);
527
- } catch (error) {
528
- // Reset isAutoAnswering flag on failure
529
- task.updateTaskData({
530
- ...task.data,
531
- isAutoAnswering: false
795
+ method: _constants2.METHODS.REGISTER_TASK_LISTENERS,
796
+ interactionId: payload.interactionId
532
797
  });
533
- _loggerProxy.default.error(`Failed to auto-answer task`, {
798
+ // update the task data
799
+ this.updateTaskData(task, payload);
800
+ } else {
801
+ // Case2 : Task is not present in taskCollection
802
+ _loggerProxy.default.log(`Got CONTACT_MERGED : Creating new task in taskManager`, {
534
803
  module: _constants.TASK_MANAGER_FILE,
535
- method: 'handleAutoAnswer',
536
- interactionId: task.data.interactionId,
537
- error
804
+ method: _constants2.METHODS.REGISTER_TASK_LISTENERS,
805
+ interactionId: payload.interactionId
538
806
  });
807
+ const taskData = {
808
+ ...payload,
809
+ wrapUpRequired: payload.interaction?.participants?.[this.agentId]?.isWrapUp || false,
810
+ isConferenceInProgress: (0, _TaskUtils.getIsConferenceInProgress)(payload),
811
+ isConsulted: false
812
+ };
813
+ task = _TaskFactory.default.createTask(this.contact, this.webCallingService, taskData, this.configFlags, this.wrapupData, this.agentId);
814
+ this.taskCollection[payload.interactionId] = task;
539
815
 
540
- // Track auto-answer failure
541
- this.metricsManager.trackEvent(_constants3.METRIC_EVENT_NAMES.TASK_AUTO_ANSWER_FAILED, {
542
- taskId: task.data.interactionId,
543
- mediaType: task.data.interaction.mediaType,
544
- error: error?.message || 'Unknown error',
545
- isAutoAnswered: false
546
- }, ['behavioral', 'operational']);
816
+ // Transition the new task out of IDLE immediately so UI controls are
817
+ // computed before TASK_MERGED is emitted. This handles the race where
818
+ // AgentContactAssigned arrives before ContactMerged and gets dropped.
819
+ // Send HYDRATE before setupTaskListeners so the emitTaskHydrate action
820
+ // doesn't bubble up to the Widget (avoids duplicate listener registration).
821
+ task.sendStateMachineEvent({
822
+ type: _stateMachine.TaskEvent.HYDRATE,
823
+ taskData,
824
+ agentId: this.agentId
825
+ });
826
+ this.setupTaskListeners(task);
827
+ }
828
+ if (task) {
829
+ this.emit(_types.TASK_EVENTS.TASK_MERGED, task);
547
830
  }
831
+ return {
832
+ task
833
+ };
548
834
  }
549
835
 
550
836
  /**
@@ -554,48 +840,56 @@ class TaskManager extends _events.default {
554
840
  */
555
841
  handleTaskCleanup(task) {
556
842
  // Clean up Desktop/WebRTC calling resources for browser-based telephony tasks
557
- if (this.webCallingService.loginOption === _types3.LoginOption.BROWSER && task.data.interaction.mediaType === 'telephony') {
843
+ if (this.webCallingService.loginOption === _types3.LoginOption.BROWSER && task.data.interaction.mediaType === _types.MEDIA_CHANNEL.TELEPHONY && task instanceof _WebRTC.default) {
558
844
  task.unregisterWebCallListeners();
559
845
  this.webCallingService.cleanUpCall();
560
846
  }
561
847
  const isOutdial = task.data.interaction.outboundType === 'OUTDIAL';
562
848
  const isNew = task.data.interaction.state === 'new';
563
- const needsWrapUp = task.data.agentsPendingWrapUp?.length > 0;
849
+ const needsWrapUp = task.data.agentsPendingWrapUp?.includes(this.agentId) ?? false;
564
850
 
565
851
  // For OUTDIAL: only remove if NOT terminated (user-declined, no wrap-up follows)
566
- // If terminated, keep task for wrap-up flow (CONTACT_ENDED → AGENT_WRAPUP)
567
852
  // For non-OUTDIAL: remove if state is 'new'
568
853
  // Always remove if secondary EpDn agent
569
- if (isNew && !(isOutdial && needsWrapUp) || (0, _TaskUtils.isSecondaryEpDnAgent)(task.data.interaction)) {
854
+ if (isNew && !(isOutdial && needsWrapUp) || (0, _TaskUtils.isSecondaryEpDnAgent)(task.data.interaction) || !needsWrapUp && isOutdial // For outdial tasks, needs wrap-up is false and state is "WRAPUP". We need to just remove the task.
855
+ ) {
570
856
  this.removeTaskFromCollection(task);
571
857
  }
572
858
  }
573
859
 
574
860
  /**
575
- * @param taskId - Unique identifier for each task
861
+ * Sends transcript start/stop event based on the CC event type.
862
+ * Fire-and-forget; errors are logged but do not interrupt event processing.
576
863
  */
577
- getTask = taskId => {
864
+ requestRealTimeTranscripts(eventType, interactionId) {
865
+ const action = _constants2.TRANSCRIPT_EVENT_MAP[eventType];
866
+ if (!action || !this.apiAIAssistant) return;
867
+ if (this.configFlags?.aiFeature?.realtimeTranscripts?.enable !== true) return;
868
+ this.apiAIAssistant.sendEvent(this.agentId, interactionId, _types3.AIAssistantEventType.CUSTOM_EVENT, _types3.AIAssistantEventName.GET_TRANSCRIPTS, {
869
+ action
870
+ }).catch(error => {
871
+ _loggerProxy.default.error(`Failed to send transcript ${action} event`, {
872
+ module: _constants.TASK_MANAGER_FILE,
873
+ method: _constants2.METHODS.REQUEST_REAL_TIME_TRANSCRIPTS,
874
+ interactionId,
875
+ error
876
+ });
877
+ });
878
+ }
879
+ getTask(taskId) {
578
880
  return this.taskCollection[taskId];
579
- };
580
-
581
- /**
582
- * @param taskId - Unique identifier for each task
583
- */
584
- getAllTasks = () => {
585
- return this.taskCollection;
586
- };
587
-
588
- /**
589
- * @param contact - Routing Contact layer. Talks to AQMReq layer to convert events to promises
590
- * @param webCallingService - Webrtc Service Layer
591
- * @param webSocketManager - Websocket Manager to maintain websocket connection and keepalives
592
- */
593
- static getTaskManager = (contact, webCallingService, webSocketManager) => {
594
- if (!this.taskManager) {
595
- this.taskManager = new TaskManager(contact, webCallingService, webSocketManager);
881
+ }
882
+ getAllTasks() {
883
+ return {
884
+ ...this.taskCollection
885
+ };
886
+ }
887
+ static getTaskManager(apiAIAssistant, contact, webCallingService, webSocketManager, rtdWebSocketManager) {
888
+ if (!TaskManager.taskManager) {
889
+ TaskManager.taskManager = new TaskManager(apiAIAssistant, contact, webCallingService, webSocketManager, rtdWebSocketManager);
596
890
  }
597
- return this.taskManager;
598
- };
891
+ return TaskManager.taskManager;
892
+ }
599
893
  }
600
894
  exports.default = TaskManager;
601
895
  //# sourceMappingURL=TaskManager.js.map