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