@webex/contact-center 3.12.0 → 3.13.0-next.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.
- package/.sdd/manifest.json +887 -0
- package/AGENTS.md +94 -0
- package/ai-docs/ARCHITECTURE.md +168 -0
- package/ai-docs/CONTRACTS.md +64 -0
- package/ai-docs/GETTING_STARTED.md +168 -0
- package/ai-docs/GLOSSARY.md +43 -0
- package/ai-docs/README.md +138 -0
- package/ai-docs/REVIEW_CHECKLIST.md +41 -0
- package/ai-docs/RULES.md +444 -0
- package/ai-docs/SECURITY.md +52 -0
- package/ai-docs/SERVICE_STATE.md +52 -0
- package/ai-docs/SPEC_INDEX.md +65 -0
- package/ai-docs/adr/0001-spec-source-policy.md +55 -0
- package/ai-docs/adr/README.md +8 -0
- package/ai-docs/adr/_adr-template.md +31 -0
- package/ai-docs/contact-center-spec.md +388 -0
- 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/ai-docs/features/generated-spec-conformance-fidelity-remediation/spec/feature-spec.md +117 -0
- package/ai-docs/features/residual-warning-coverage-completion/spec/feature-spec.md +203 -0
- package/ai-docs/features/validator-code-fidelity-drift-fix/spec/feature-spec.md +315 -0
- package/ai-docs/patterns/event-driven-patterns.md +485 -0
- package/ai-docs/patterns/testing-patterns.md +480 -0
- package/ai-docs/patterns/typescript-patterns.md +365 -0
- package/ai-docs/templates/README.md +102 -0
- package/ai-docs/templates/documentation/create-agents-md.md +240 -0
- package/ai-docs/templates/documentation/create-architecture-md.md +295 -0
- package/ai-docs/templates/existing-service/bug-fix.md +254 -0
- package/ai-docs/templates/existing-service/feature-enhancement.md +450 -0
- package/ai-docs/templates/new-method/00-master.md +80 -0
- package/ai-docs/templates/new-method/01-requirements.md +232 -0
- package/ai-docs/templates/new-method/02-implementation.md +295 -0
- package/ai-docs/templates/new-method/03-tests.md +201 -0
- package/ai-docs/templates/new-method/04-validation.md +141 -0
- package/ai-docs/templates/new-service/00-master.md +109 -0
- package/ai-docs/templates/new-service/01-pre-questions.md +159 -0
- package/ai-docs/templates/new-service/02-code-generation.md +346 -0
- package/ai-docs/templates/new-service/03-integration.md +178 -0
- package/ai-docs/templates/new-service/04-test-generation.md +205 -0
- package/ai-docs/templates/new-service/05-validation.md +145 -0
- package/dist/cc.js +1102 -47
- package/dist/cc.js.map +1 -1
- package/dist/config.js +13 -0
- package/dist/config.js.map +1 -1
- package/dist/constants.js +46 -3
- package/dist/constants.js.map +1 -1
- package/dist/index.js +86 -17
- 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 +211 -0
- package/dist/metrics/behavioral-events.js.map +1 -1
- package/dist/metrics/constants.js +58 -4
- 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 +369 -14
- 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/UserPreference.js +427 -0
- package/dist/services/UserPreference.js.map +1 -0
- package/dist/services/WebCallingService.js +287 -37
- 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 +48 -48
- package/dist/services/config/Util.js.map +1 -1
- package/dist/services/config/constants.js +57 -79
- 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 +100 -40
- package/dist/services/config/types.js.map +1 -1
- package/dist/services/constants.js +19 -1
- package/dist/services/constants.js.map +1 -1
- package/dist/services/core/Err.js.map +1 -1
- package/dist/services/core/Utils.js +131 -32
- 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 +26 -6
- package/dist/services/core/websocket/WebSocketManager.js.map +1 -1
- package/dist/services/core/websocket/connection-service.js +3 -1
- package/dist/services/core/websocket/connection-service.js.map +1 -1
- package/dist/services/core/websocket/types.js.map +1 -1
- package/dist/services/index.js +6 -0
- package/dist/services/index.js.map +1 -1
- package/dist/services/task/Task.js +955 -0
- package/dist/services/task/Task.js.map +1 -0
- package/dist/services/task/TaskFactory.js +50 -0
- package/dist/services/task/TaskFactory.js.map +1 -0
- package/dist/services/task/TaskManager.js +1275 -504
- package/dist/services/task/TaskManager.js.map +1 -1
- package/dist/services/task/TaskUtils.js +221 -27
- 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 +22 -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/dialer.js +78 -0
- package/dist/services/task/dialer.js.map +1 -1
- package/dist/services/task/digital/Digital.js +78 -0
- package/dist/services/task/digital/Digital.js.map +1 -0
- package/dist/services/task/state-machine/TaskStateMachine.js +982 -0
- package/dist/services/task/state-machine/TaskStateMachine.js.map +1 -0
- package/dist/services/task/state-machine/actions.js +572 -0
- package/dist/services/task/state-machine/actions.js.map +1 -0
- package/dist/services/task/state-machine/constants.js +161 -0
- package/dist/services/task/state-machine/constants.js.map +1 -0
- package/dist/services/task/state-machine/guards.js +379 -0
- package/dist/services/task/state-machine/guards.js.map +1 -0
- package/dist/services/task/state-machine/index.js +53 -0
- package/dist/services/task/state-machine/index.js.map +1 -0
- package/dist/services/task/state-machine/types.js +54 -0
- package/dist/services/task/state-machine/types.js.map +1 -0
- package/dist/services/task/state-machine/uiControlsComputer.js +703 -0
- package/dist/services/task/state-machine/uiControlsComputer.js.map +1 -0
- package/dist/services/task/taskDataNormalizer.js +99 -0
- package/dist/services/task/taskDataNormalizer.js.map +1 -0
- package/dist/services/task/types.js +259 -5
- package/dist/services/task/types.js.map +1 -1
- package/dist/services/task/voice/Voice.js +1504 -0
- package/dist/services/task/voice/Voice.js.map +1 -0
- package/dist/services/task/voice/WebRTC.js +152 -0
- package/dist/services/task/voice/WebRTC.js.map +1 -0
- 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 +222 -10
- package/dist/types/config.d.ts +13 -0
- package/dist/types/constants.d.ts +40 -1
- package/dist/types/index.d.ts +58 -22
- package/dist/types/metrics/MetricsManager.d.ts +6 -0
- package/dist/types/metrics/constants.d.ts +52 -1
- 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 +67 -5
- package/dist/types/services/EntryPoint.d.ts +7 -5
- package/dist/types/services/Queue.d.ts +5 -3
- package/dist/types/services/UserPreference.d.ts +118 -0
- 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 +49 -76
- package/dist/types/services/config/index.d.ts +16 -64
- package/dist/types/services/config/types.d.ts +252 -114
- package/dist/types/services/constants.d.ts +16 -0
- package/dist/types/services/core/Err.d.ts +6 -0
- package/dist/types/services/core/Utils.d.ts +43 -13
- 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/core/websocket/WebSocketManager.d.ts +2 -0
- package/dist/types/services/core/websocket/types.d.ts +1 -1
- package/dist/types/services/index.d.ts +2 -0
- package/dist/types/services/task/Task.d.ts +186 -0
- package/dist/types/services/task/TaskFactory.d.ts +14 -0
- package/dist/types/services/task/TaskUtils.d.ts +54 -2
- package/dist/types/services/task/WebexCallingUtils.d.ts +11 -0
- package/dist/types/services/task/constants.d.ts +20 -0
- package/dist/types/services/task/contact.d.ts +4 -0
- package/dist/types/services/task/dialer.d.ts +30 -0
- package/dist/types/services/task/digital/Digital.d.ts +23 -0
- package/dist/types/services/task/state-machine/TaskStateMachine.d.ts +1442 -0
- package/dist/types/services/task/state-machine/actions.d.ts +10 -0
- package/dist/types/services/task/state-machine/constants.d.ts +107 -0
- package/dist/types/services/task/state-machine/guards.d.ts +103 -0
- package/dist/types/services/task/state-machine/index.d.ts +13 -0
- package/dist/types/services/task/state-machine/types.d.ts +277 -0
- package/dist/types/services/task/state-machine/uiControlsComputer.d.ts +9 -0
- package/dist/types/services/task/taskDataNormalizer.d.ts +10 -0
- package/dist/types/services/task/types.d.ts +790 -66
- package/dist/types/services/task/voice/Voice.d.ts +241 -0
- package/dist/types/services/task/voice/WebRTC.d.ts +54 -0
- 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 +258 -11
- package/dist/types/utils/PageCache.d.ts +20 -3
- package/dist/types/webex.d.ts +1 -0
- package/dist/types.js +204 -6
- 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 +22 -2
- package/dist/webex.js.map +1 -1
- package/package.json +16 -12
- package/src/cc.ts +1439 -105
- package/src/config.ts +13 -0
- package/src/constants.ts +53 -1
- package/src/index.ts +72 -16
- package/src/metrics/MetricsManager.ts +16 -0
- package/src/metrics/ai-docs/AGENTS.md +350 -0
- package/src/metrics/ai-docs/ARCHITECTURE.md +338 -0
- package/src/metrics/ai-docs/metrics-spec.md +971 -0
- package/src/metrics/behavioral-events.ts +218 -0
- package/src/metrics/constants.ts +63 -4
- package/src/services/AddressBook.ts +17 -6
- package/src/services/AnswerCallOnWebexService.ts +239 -0
- package/src/services/ApiAiAssistant.ts +494 -15
- package/src/services/EntryPoint.ts +59 -60
- package/src/services/Queue.ts +29 -12
- package/src/services/UserPreference.ts +509 -0
- package/src/services/WebCallingService.ts +362 -40
- package/src/services/WebexCrossClientService.ts +298 -0
- package/src/services/WxAppTelephonyMercurySync.ts +142 -0
- package/src/services/agent/ai-docs/AGENTS.md +240 -0
- package/src/services/agent/ai-docs/ARCHITECTURE.md +304 -0
- package/src/services/agent/ai-docs/agent-spec.md +505 -0
- package/src/services/ai-docs/AGENTS.md +386 -0
- package/src/services/ai-docs/services-spec.md +512 -0
- package/src/services/config/Util.ts +54 -84
- package/src/services/config/ai-docs/AGENTS.md +250 -0
- package/src/services/config/ai-docs/ARCHITECTURE.md +413 -0
- package/src/services/config/ai-docs/config-spec.md +669 -0
- package/src/services/config/constants.ts +64 -86
- package/src/services/config/index.ts +116 -277
- package/src/services/config/types.ts +238 -125
- package/src/services/constants.ts +18 -0
- package/src/services/core/Err.ts +3 -0
- package/src/services/core/Utils.ts +151 -37
- package/src/services/core/WebexRequest.ts +3 -1
- package/src/services/core/ai-docs/AGENTS.md +381 -0
- package/src/services/core/ai-docs/ARCHITECTURE.md +698 -0
- package/src/services/core/ai-docs/core-spec.md +797 -0
- 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 +37 -8
- package/src/services/core/websocket/connection-service.ts +5 -1
- package/src/services/core/websocket/types.ts +1 -1
- package/src/services/index.ts +4 -0
- package/src/services/task/Task.ts +1211 -0
- package/src/services/task/TaskFactory.ts +82 -0
- package/src/services/task/TaskManager.ts +1551 -584
- package/src/services/task/TaskUtils.ts +316 -25
- package/src/services/task/WebexCallingUtils.ts +136 -0
- package/src/services/task/ai-docs/AGENTS.md +457 -0
- package/src/services/task/ai-docs/ARCHITECTURE.md +595 -0
- package/src/services/task/ai-docs/task-spec.md +1501 -0
- package/src/services/task/constants.ts +21 -0
- package/src/services/task/contact.ts +30 -0
- package/src/services/task/dialer.ts +80 -0
- package/src/services/task/digital/Digital.ts +102 -0
- package/src/services/task/state-machine/TaskStateMachine.ts +1320 -0
- package/src/services/task/state-machine/actions.ts +741 -0
- package/src/services/task/state-machine/ai-docs/AGENTS.md +460 -0
- package/src/services/task/state-machine/ai-docs/ARCHITECTURE.md +1156 -0
- package/src/services/task/state-machine/ai-docs/task-state-machine-spec.md +2247 -0
- package/src/services/task/state-machine/constants.ts +172 -0
- package/src/services/task/state-machine/guards.ts +442 -0
- package/src/services/task/state-machine/index.ts +28 -0
- package/src/services/task/state-machine/types.ts +258 -0
- package/src/services/task/state-machine/uiControlsComputer.ts +1135 -0
- package/src/services/task/taskDataNormalizer.ts +137 -0
- package/src/services/task/types.ts +974 -70
- package/src/services/task/voice/Voice.ts +1878 -0
- package/src/services/task/voice/WebRTC.ts +194 -0
- 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 +323 -13
- package/src/utils/AGENTS.md +289 -0
- package/src/utils/PageCache.ts +38 -5
- package/src/utils/ai-docs/utils-spec.md +391 -0
- package/src/webex.js +10 -0
- package/test/unit/fixtures/aiSummaryTestUtils.ts +40 -0
- package/test/unit/spec/cc.ts +4046 -181
- package/test/unit/spec/index.ts +891 -0
- package/test/unit/spec/logger-proxy.ts +70 -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 +442 -23
- package/test/unit/spec/services/EntryPoint.ts +87 -40
- package/test/unit/spec/services/Queue.ts +123 -12
- package/test/unit/spec/services/UserPreference.ts +401 -0
- package/test/unit/spec/services/WebCallingService.ts +484 -49
- 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 +318 -548
- package/test/unit/spec/services/core/Utils.ts +447 -8
- 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 +132 -56
- package/test/unit/spec/services/core/websocket/connection-service.ts +3 -1
- package/test/unit/spec/services/task/AutoWrapup.ts +63 -0
- package/test/unit/spec/services/task/Task.ts +2723 -0
- package/test/unit/spec/services/task/TaskFactory.ts +116 -0
- package/test/unit/spec/services/task/TaskManager.ts +4800 -1586
- package/test/unit/spec/services/task/TaskUtils.ts +307 -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/dialer.ts +190 -0
- package/test/unit/spec/services/task/digital/Digital.ts +105 -0
- package/test/unit/spec/services/task/state-machine/TaskStateMachine.ts +4060 -0
- package/test/unit/spec/services/task/state-machine/guards.ts +839 -0
- package/test/unit/spec/services/task/state-machine/types.ts +18 -0
- package/test/unit/spec/services/task/state-machine/uiControlsComputer.ts +3101 -0
- package/test/unit/spec/services/task/taskTestUtils.ts +87 -0
- package/test/unit/spec/services/task/voice/Voice.ts +2355 -0
- package/test/unit/spec/services/task/voice/WebRTC.ts +235 -0
- 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
- package/dist/services/task/index.js +0 -1525
- package/dist/services/task/index.js.map +0 -1
- package/dist/types/services/task/index.d.ts +0 -650
- package/src/services/task/index.ts +0 -1801
- package/test/unit/spec/services/task/index.ts +0 -2184
|
@@ -3,25 +3,63 @@ import {ICall, LINE_EVENTS} from '@webex/calling';
|
|
|
3
3
|
import {WebSocketManager} from '../core/websocket/WebSocketManager';
|
|
4
4
|
import routingContact from './contact';
|
|
5
5
|
import WebCallingService from '../WebCallingService';
|
|
6
|
-
import {
|
|
6
|
+
import {
|
|
7
|
+
MEDIA_CHANNEL,
|
|
8
|
+
TASK_EVENTS,
|
|
9
|
+
TaskData,
|
|
10
|
+
TaskId,
|
|
11
|
+
ITask,
|
|
12
|
+
WebSocketPayload,
|
|
13
|
+
WebSocketMessage,
|
|
14
|
+
TaskEventActions,
|
|
15
|
+
EventContext,
|
|
16
|
+
AISummaryFeatureEnablement,
|
|
17
|
+
AISummary,
|
|
18
|
+
} from './types';
|
|
7
19
|
import {TASK_MANAGER_FILE} from '../../constants';
|
|
8
20
|
import {METHODS, TRANSCRIPT_EVENT_MAP} from './constants';
|
|
9
21
|
import {CC_EVENTS, CC_TASK_EVENTS, WrapupData} from '../config/types';
|
|
10
|
-
import {
|
|
22
|
+
import {ConfigFlags, LoginOption, AIAssistantEventType, AIAssistantEventName} from '../../types';
|
|
11
23
|
import LoggerProxy from '../../logger-proxy';
|
|
12
|
-
import Task from '.';
|
|
13
|
-
import MetricsManager from '../../metrics/MetricsManager';
|
|
14
|
-
import {METRIC_EVENT_NAMES} from '../../metrics/constants';
|
|
15
24
|
import {
|
|
16
|
-
checkParticipantNotInInteraction,
|
|
17
25
|
getIsConferenceInProgress,
|
|
26
|
+
isCampaignPreviewTask,
|
|
18
27
|
isCampaignPreviewReservation,
|
|
19
|
-
isParticipantInMainInteraction,
|
|
20
|
-
isPrimary,
|
|
21
28
|
isSecondaryEpDnAgent,
|
|
22
29
|
shouldAutoAnswerTask,
|
|
23
30
|
} from './TaskUtils';
|
|
24
|
-
import
|
|
31
|
+
import TaskFactory from './TaskFactory';
|
|
32
|
+
import AnswerCallOnWebexService from '../AnswerCallOnWebexService';
|
|
33
|
+
import {getWebexCallingDeviceDetailsForAgent} from './WebexCallingUtils';
|
|
34
|
+
import WebRTC from './voice/WebRTC';
|
|
35
|
+
import {TaskEvent, TaskState, type TaskEventPayload} from './state-machine';
|
|
36
|
+
import {MEDIA_TYPE_MAIN_CALL} from './state-machine/constants';
|
|
37
|
+
import {normalizeTaskData} from './taskDataNormalizer';
|
|
38
|
+
import {ApiAIAssistant} from '../ApiAiAssistant';
|
|
39
|
+
|
|
40
|
+
const CC_EVENT_SET = new Set<CC_EVENTS>(Object.values(CC_EVENTS) as CC_EVENTS[]);
|
|
41
|
+
|
|
42
|
+
const MAIN_INTERACTION_CORRELATED_EVENTS = new Set<CC_EVENTS>([
|
|
43
|
+
CC_EVENTS.AGENT_CONSULT_ENDED,
|
|
44
|
+
CC_EVENTS.PARTICIPANT_LEFT_CONFERENCE,
|
|
45
|
+
]);
|
|
46
|
+
|
|
47
|
+
const isCcEvent = (value: string): value is CC_EVENTS => CC_EVENT_SET.has(value as CC_EVENTS);
|
|
48
|
+
|
|
49
|
+
const WRAP_UP_STAMP_EVENTS = new Set<CC_EVENTS>([
|
|
50
|
+
CC_EVENTS.AGENT_WRAPUP,
|
|
51
|
+
CC_EVENTS.AGENT_CONSULT_CONFERENCE_ENDED,
|
|
52
|
+
CC_EVENTS.PARTICIPANT_LEFT_CONFERENCE,
|
|
53
|
+
CC_EVENTS.AGENT_CONFERENCE_TRANSFERRED,
|
|
54
|
+
]);
|
|
55
|
+
|
|
56
|
+
const PARTICIPANT_LEAVE_WRAP_STATES = new Set<TaskState>([
|
|
57
|
+
TaskState.HELD,
|
|
58
|
+
TaskState.RESUME_INITIATING,
|
|
59
|
+
TaskState.CONSULTING,
|
|
60
|
+
TaskState.CONSULT_INITIATING,
|
|
61
|
+
TaskState.CONFERENCING,
|
|
62
|
+
]);
|
|
25
63
|
|
|
26
64
|
/** @internal */
|
|
27
65
|
export default class TaskManager extends EventEmitter {
|
|
@@ -35,12 +73,21 @@ export default class TaskManager extends EventEmitter {
|
|
|
35
73
|
private taskCollection: Record<TaskId, ITask>;
|
|
36
74
|
private webCallingService: WebCallingService;
|
|
37
75
|
private webSocketManager: WebSocketManager;
|
|
38
|
-
private
|
|
39
|
-
|
|
76
|
+
private rtdWebSocketManager: WebSocketManager;
|
|
77
|
+
// eslint-disable-next-line no-use-before-define
|
|
78
|
+
private static taskManager: TaskManager;
|
|
79
|
+
private configFlags?: ConfigFlags;
|
|
40
80
|
private wrapupData: WrapupData;
|
|
41
81
|
private agentId: string;
|
|
82
|
+
private agentName: string;
|
|
42
83
|
private webRtcEnabled: boolean;
|
|
84
|
+
private answerCallOnWebexService?: AnswerCallOnWebexService;
|
|
43
85
|
private apiAIAssistant?: ApiAIAssistant;
|
|
86
|
+
private receivingSummaryBuffer = new Map<string, AISummary>();
|
|
87
|
+
|
|
88
|
+
// RTD feature frames can arrive before AQM creates the task.
|
|
89
|
+
private pendingFeatureEnablement = new Map<string, AISummaryFeatureEnablement>();
|
|
90
|
+
|
|
44
91
|
/**
|
|
45
92
|
* @param contact - Routing Contact layer. Talks to AQMReq layer to convert events to promises
|
|
46
93
|
* @param webCallingService - Webrtc Service Layer
|
|
@@ -50,27 +97,138 @@ export default class TaskManager extends EventEmitter {
|
|
|
50
97
|
apiAIAssistant: ApiAIAssistant,
|
|
51
98
|
contact: ReturnType<typeof routingContact>,
|
|
52
99
|
webCallingService: WebCallingService,
|
|
53
|
-
webSocketManager: WebSocketManager
|
|
100
|
+
webSocketManager: WebSocketManager,
|
|
101
|
+
rtdWebSocketManager: WebSocketManager
|
|
54
102
|
) {
|
|
55
103
|
super();
|
|
56
104
|
this.apiAIAssistant = apiAIAssistant;
|
|
57
105
|
this.contact = contact;
|
|
58
|
-
this.taskCollection = {};
|
|
59
106
|
this.webCallingService = webCallingService;
|
|
60
107
|
this.webSocketManager = webSocketManager;
|
|
61
|
-
this.
|
|
108
|
+
this.rtdWebSocketManager = rtdWebSocketManager;
|
|
109
|
+
this.taskCollection = {};
|
|
110
|
+
this.webRtcEnabled = false;
|
|
62
111
|
this.registerTaskListeners();
|
|
63
112
|
this.registerIncomingCallEvent();
|
|
64
113
|
}
|
|
65
114
|
|
|
115
|
+
public handleRealtimeWebsocketEvent(event: string) {
|
|
116
|
+
try {
|
|
117
|
+
const payload = JSON.parse(event);
|
|
118
|
+
|
|
119
|
+
switch (payload?.type) {
|
|
120
|
+
case CC_TASK_EVENTS.FEATURE_ENABLEMENT: {
|
|
121
|
+
const enablement: AISummaryFeatureEnablement = payload?.data?.data;
|
|
122
|
+
if (!enablement?.interactionId) return;
|
|
123
|
+
|
|
124
|
+
const task = this.taskCollection[enablement.interactionId];
|
|
125
|
+
if (task) {
|
|
126
|
+
this.pendingFeatureEnablement.delete(enablement.interactionId);
|
|
127
|
+
task.setFeatureEnablement?.(enablement);
|
|
128
|
+
task.emit(TASK_EVENTS.TASK_FEATURE_ENABLEMENT, enablement);
|
|
129
|
+
} else {
|
|
130
|
+
this.pendingFeatureEnablement.set(enablement.interactionId, enablement);
|
|
131
|
+
}
|
|
132
|
+
|
|
133
|
+
return;
|
|
134
|
+
}
|
|
135
|
+
case CC_TASK_EVENTS.POST_CALL_SUMMARY:
|
|
136
|
+
case CC_TASK_EVENTS.MID_CALL_SUMMARY: {
|
|
137
|
+
if (!payload?.data?.data?.conversationId) return;
|
|
138
|
+
|
|
139
|
+
this.apiAIAssistant?.resolveFromRtdEvent(
|
|
140
|
+
payload.type,
|
|
141
|
+
payload.data.data.conversationId,
|
|
142
|
+
payload.data.data
|
|
143
|
+
);
|
|
144
|
+
|
|
145
|
+
return;
|
|
146
|
+
}
|
|
147
|
+
case CC_TASK_EVENTS.MID_CALL_SUMMARY_RESPONSE_SUBSEQUENT_AGENT: {
|
|
148
|
+
if (!payload?.data?.data?.conversationId) return;
|
|
149
|
+
|
|
150
|
+
const summary: AISummary = payload.data.data;
|
|
151
|
+
const {conversationId} = summary;
|
|
152
|
+
const task = this.taskCollection[conversationId];
|
|
153
|
+
const taskState = task?.state?.value;
|
|
154
|
+
|
|
155
|
+
// Emit only once the task is answered; until then it waits for the answer event.
|
|
156
|
+
if (task && taskState !== TaskState.IDLE && taskState !== TaskState.OFFERED) {
|
|
157
|
+
this.receivingSummaryBuffer.delete(conversationId);
|
|
158
|
+
task.emit(TASK_EVENTS.TASK_MID_CALL_SUMMARY_RECEIVED, summary);
|
|
159
|
+
} else {
|
|
160
|
+
this.receivingSummaryBuffer.set(conversationId, summary);
|
|
161
|
+
}
|
|
162
|
+
|
|
163
|
+
return;
|
|
164
|
+
}
|
|
165
|
+
default:
|
|
166
|
+
break;
|
|
167
|
+
}
|
|
168
|
+
|
|
169
|
+
const interactionId = payload?.data?.data?.conversationId;
|
|
170
|
+
if (!interactionId) return;
|
|
171
|
+
|
|
172
|
+
const task = this.taskCollection[interactionId];
|
|
173
|
+
if (!task) {
|
|
174
|
+
LoggerProxy.info(`Realtime transcription task not found`, {
|
|
175
|
+
module: TASK_MANAGER_FILE,
|
|
176
|
+
method: METHODS.HANDLE_REAL_TIME_WEBSOCKET_EVENT,
|
|
177
|
+
interactionId,
|
|
178
|
+
});
|
|
179
|
+
|
|
180
|
+
return;
|
|
181
|
+
}
|
|
182
|
+
|
|
183
|
+
switch (payload.type) {
|
|
184
|
+
case CC_EVENTS.REAL_TIME_TRANSCRIPTION:
|
|
185
|
+
case CC_EVENTS.SUGGESTED_RESPONSE:
|
|
186
|
+
task.emit(payload.type, payload.data);
|
|
187
|
+
break;
|
|
188
|
+
default:
|
|
189
|
+
break;
|
|
190
|
+
}
|
|
191
|
+
} catch (error) {
|
|
192
|
+
LoggerProxy.error('Failed to parse RTD WebSocket message', {
|
|
193
|
+
module: TASK_MANAGER_FILE,
|
|
194
|
+
method: METHODS.HANDLE_REAL_TIME_WEBSOCKET_EVENT,
|
|
195
|
+
error,
|
|
196
|
+
});
|
|
197
|
+
}
|
|
198
|
+
}
|
|
199
|
+
|
|
200
|
+
/**
|
|
201
|
+
* Set config flags for task creation
|
|
202
|
+
*/
|
|
203
|
+
public setConfigFlags(configFlags: ConfigFlags) {
|
|
204
|
+
this.configFlags = configFlags;
|
|
205
|
+
}
|
|
206
|
+
|
|
207
|
+
public clearAISummaryState(): void {
|
|
208
|
+
this.apiAIAssistant?.clearAllRtdRequests();
|
|
209
|
+
Object.values(this.taskCollection).forEach((task) => task.clearFeatureEnablement?.());
|
|
210
|
+
this.receivingSummaryBuffer.clear();
|
|
211
|
+
this.pendingFeatureEnablement.clear();
|
|
212
|
+
}
|
|
213
|
+
|
|
214
|
+
/**
|
|
215
|
+
* Set wrapup configuration data
|
|
216
|
+
*/
|
|
66
217
|
public setWrapupData(wrapupData: WrapupData) {
|
|
67
218
|
this.wrapupData = wrapupData;
|
|
68
219
|
}
|
|
69
220
|
|
|
221
|
+
/**
|
|
222
|
+
* Set agent ID for task operations
|
|
223
|
+
*/
|
|
70
224
|
public setAgentId(agentId: string) {
|
|
71
225
|
this.agentId = agentId;
|
|
72
226
|
}
|
|
73
227
|
|
|
228
|
+
public setAgentName(agentName: string) {
|
|
229
|
+
this.agentName = agentName;
|
|
230
|
+
}
|
|
231
|
+
|
|
74
232
|
/**
|
|
75
233
|
* Gets the current agent ID
|
|
76
234
|
* @returns {string} The agent ID set for this task manager instance
|
|
@@ -84,6 +242,10 @@ export default class TaskManager extends EventEmitter {
|
|
|
84
242
|
this.webRtcEnabled = webRtcEnabled;
|
|
85
243
|
}
|
|
86
244
|
|
|
245
|
+
public setAnswerCallOnWebexService(answerCallOnWebexService: AnswerCallOnWebexService) {
|
|
246
|
+
this.answerCallOnWebexService = answerCallOnWebexService;
|
|
247
|
+
}
|
|
248
|
+
|
|
87
249
|
private handleIncomingWebCall = (call: ICall) => {
|
|
88
250
|
const currentTask = Object.values(this.taskCollection).find(
|
|
89
251
|
(task) =>
|
|
@@ -97,7 +259,15 @@ export default class TaskManager extends EventEmitter {
|
|
|
97
259
|
method: METHODS.HANDLE_INCOMING_WEB_CALL,
|
|
98
260
|
interactionId: currentTask.data.interactionId,
|
|
99
261
|
});
|
|
100
|
-
|
|
262
|
+
|
|
263
|
+
// Send TASK_INCOMING to state machine - it will emit on the task object
|
|
264
|
+
const eventPayload = TaskManager.mapEventToTaskStateMachineEvent(
|
|
265
|
+
CC_EVENTS.AGENT_CONTACT_RESERVED,
|
|
266
|
+
currentTask.data
|
|
267
|
+
);
|
|
268
|
+
if (eventPayload && currentTask) {
|
|
269
|
+
currentTask.sendStateMachineEvent(eventPayload);
|
|
270
|
+
}
|
|
101
271
|
}
|
|
102
272
|
this.call = call;
|
|
103
273
|
};
|
|
@@ -110,556 +280,1292 @@ export default class TaskManager extends EventEmitter {
|
|
|
110
280
|
this.webCallingService.off(LINE_EVENTS.INCOMING_CALL, this.handleIncomingWebCall);
|
|
111
281
|
}
|
|
112
282
|
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
LoggerProxy.log(`Got AGENT_CONTACT: Task already exists in collection`, {
|
|
134
|
-
module: TASK_MANAGER_FILE,
|
|
135
|
-
method: METHODS.REGISTER_TASK_LISTENERS,
|
|
136
|
-
interactionId: payload.data.interactionId,
|
|
137
|
-
});
|
|
138
|
-
break;
|
|
139
|
-
} else if (!this.taskCollection[payload.data.interactionId]) {
|
|
140
|
-
// Case2 : Task is not present in taskCollection
|
|
141
|
-
LoggerProxy.log(`Got AGENT_CONTACT : Creating new task in taskManager`, {
|
|
142
|
-
module: TASK_MANAGER_FILE,
|
|
143
|
-
method: METHODS.REGISTER_TASK_LISTENERS,
|
|
144
|
-
interactionId: payload.data.interactionId,
|
|
145
|
-
});
|
|
146
|
-
|
|
147
|
-
// Check if auto-answer should happen for this task
|
|
148
|
-
const shouldAutoAnswer = shouldAutoAnswerTask(
|
|
149
|
-
payload.data,
|
|
150
|
-
this.agentId,
|
|
151
|
-
this.webCallingService.loginOption,
|
|
152
|
-
this.webRtcEnabled
|
|
153
|
-
);
|
|
154
|
-
|
|
155
|
-
task = new Task(
|
|
156
|
-
this.contact,
|
|
157
|
-
this.webCallingService,
|
|
158
|
-
{
|
|
159
|
-
...payload.data,
|
|
160
|
-
wrapUpRequired:
|
|
161
|
-
payload.data.interaction?.participants?.[this.agentId]?.isWrapUp || false,
|
|
162
|
-
isConferenceInProgress: getIsConferenceInProgress(payload.data),
|
|
163
|
-
isAutoAnswering: shouldAutoAnswer, // Set flag before emitting
|
|
164
|
-
},
|
|
165
|
-
this.wrapupData,
|
|
166
|
-
this.agentId
|
|
167
|
-
);
|
|
168
|
-
this.taskCollection[payload.data.interactionId] = task;
|
|
169
|
-
// Condition 1: The state is=new i.e it is a incoming task
|
|
170
|
-
if (payload.data.interaction.state === 'new') {
|
|
171
|
-
LoggerProxy.log(
|
|
172
|
-
`Got AGENT_CONTACT for a task with state=new, sending TASK_INCOMING event`,
|
|
173
|
-
{
|
|
174
|
-
module: TASK_MANAGER_FILE,
|
|
175
|
-
method: METHODS.REGISTER_TASK_LISTENERS,
|
|
176
|
-
interactionId: payload.data.interactionId,
|
|
177
|
-
}
|
|
178
|
-
);
|
|
179
|
-
this.emit(TASK_EVENTS.TASK_INCOMING, task);
|
|
180
|
-
} else {
|
|
181
|
-
// Condition 2: The state is anything else i.e the task was connected
|
|
182
|
-
LoggerProxy.log(
|
|
183
|
-
`Got AGENT_CONTACT for a task with state=${payload.data.interaction.state}, sending TASK_HYDRATE event`,
|
|
184
|
-
{
|
|
185
|
-
module: TASK_MANAGER_FILE,
|
|
186
|
-
method: METHODS.REGISTER_TASK_LISTENERS,
|
|
187
|
-
interactionId: payload.data.interactionId,
|
|
188
|
-
}
|
|
189
|
-
);
|
|
190
|
-
this.emit(TASK_EVENTS.TASK_HYDRATE, task);
|
|
191
|
-
}
|
|
192
|
-
}
|
|
193
|
-
break;
|
|
194
|
-
|
|
195
|
-
case CC_EVENTS.AGENT_CONTACT_RESERVED: {
|
|
196
|
-
// Check if auto-answer should happen for this task
|
|
197
|
-
const shouldAutoAnswerReserved = shouldAutoAnswerTask(
|
|
198
|
-
payload.data,
|
|
199
|
-
this.agentId,
|
|
200
|
-
this.webCallingService.loginOption,
|
|
201
|
-
this.webRtcEnabled
|
|
202
|
-
);
|
|
283
|
+
/**
|
|
284
|
+
* True when this agent left on the current payload.
|
|
285
|
+
* A named other participantId is never self-leave (even if the participants
|
|
286
|
+
* map is partial). Missing-map fallback is EP-DN only: participantId absent
|
|
287
|
+
* and self omitted now, with previous-task evidence when a prior map exists.
|
|
288
|
+
*/
|
|
289
|
+
private static didSelfLeaveConference(
|
|
290
|
+
payload: WebSocketPayload,
|
|
291
|
+
agentId?: string,
|
|
292
|
+
task?: ITask
|
|
293
|
+
): boolean {
|
|
294
|
+
if (!agentId) {
|
|
295
|
+
return false;
|
|
296
|
+
}
|
|
297
|
+
if (payload.participantId === agentId) {
|
|
298
|
+
return true;
|
|
299
|
+
}
|
|
300
|
+
if (payload.participantId && payload.participantId !== agentId) {
|
|
301
|
+
return false;
|
|
302
|
+
}
|
|
203
303
|
|
|
204
|
-
|
|
205
|
-
|
|
206
|
-
|
|
207
|
-
|
|
208
|
-
...payload.data,
|
|
209
|
-
isConsulted: false,
|
|
210
|
-
isAutoAnswering: shouldAutoAnswerReserved, // Set flag before emitting
|
|
211
|
-
},
|
|
212
|
-
this.wrapupData,
|
|
213
|
-
this.agentId
|
|
214
|
-
);
|
|
215
|
-
this.taskCollection[payload.data.interactionId] = task;
|
|
216
|
-
if (
|
|
217
|
-
this.webCallingService.loginOption !== LoginOption.BROWSER ||
|
|
218
|
-
task.data.interaction.mediaType !== MEDIA_CHANNEL.TELEPHONY // for digital channels
|
|
219
|
-
) {
|
|
220
|
-
this.emit(TASK_EVENTS.TASK_INCOMING, task);
|
|
221
|
-
} else if (this.call) {
|
|
222
|
-
this.emit(TASK_EVENTS.TASK_INCOMING, task);
|
|
223
|
-
}
|
|
224
|
-
break;
|
|
225
|
-
}
|
|
226
|
-
case CC_EVENTS.AGENT_OFFER_CONTACT:
|
|
227
|
-
// We don't have to emit any event here since this will be result of promise.
|
|
228
|
-
task = this.updateTaskData(task, payload.data);
|
|
229
|
-
LoggerProxy.log(`Agent offer contact received for task`, {
|
|
230
|
-
module: TASK_MANAGER_FILE,
|
|
231
|
-
method: METHODS.REGISTER_TASK_LISTENERS,
|
|
232
|
-
interactionId: payload.data?.interactionId,
|
|
233
|
-
});
|
|
234
|
-
this.emit(TASK_EVENTS.TASK_OFFER_CONTACT, task);
|
|
235
|
-
|
|
236
|
-
// Handle auto-answer for offer contact
|
|
237
|
-
this.handleAutoAnswer(task);
|
|
238
|
-
break;
|
|
239
|
-
case CC_EVENTS.AGENT_OUTBOUND_FAILED:
|
|
240
|
-
if (task) {
|
|
241
|
-
task = this.updateTaskData(task, payload.data);
|
|
242
|
-
this.metricsManager.trackEvent(
|
|
243
|
-
METRIC_EVENT_NAMES.TASK_OUTDIAL_FAILED,
|
|
244
|
-
{
|
|
245
|
-
...MetricsManager.getCommonTrackingFieldForAQMResponse(payload.data),
|
|
246
|
-
taskId: payload.data.interactionId,
|
|
247
|
-
reason: payload.data.reasonCode || payload.data.reason,
|
|
248
|
-
},
|
|
249
|
-
['behavioral', 'operational']
|
|
250
|
-
);
|
|
251
|
-
LoggerProxy.log(`Agent outbound failed for task`, {
|
|
252
|
-
module: TASK_MANAGER_FILE,
|
|
253
|
-
method: METHODS.REGISTER_TASK_LISTENERS,
|
|
254
|
-
interactionId: payload.data.interactionId,
|
|
255
|
-
});
|
|
256
|
-
task.emit(TASK_EVENTS.TASK_OUTDIAL_FAILED, payload.data.reason ?? 'UNKNOWN_REASON');
|
|
257
|
-
}
|
|
258
|
-
break;
|
|
259
|
-
case CC_EVENTS.AGENT_CONTACT_ASSIGNED:
|
|
260
|
-
// When a campaign preview contact is accepted, the assigned event may arrive
|
|
261
|
-
// with a new interactionId while the task is stored under the original
|
|
262
|
-
// reservationInteractionId. Fall back to that key so the task is found.
|
|
263
|
-
if (!task && payload.data.reservationInteractionId) {
|
|
264
|
-
task = this.taskCollection[payload.data.reservationInteractionId];
|
|
265
|
-
if (task) {
|
|
266
|
-
// Re-key the task under the new interaction ID and remove the old entry
|
|
267
|
-
delete this.taskCollection[payload.data.reservationInteractionId];
|
|
268
|
-
this.taskCollection[payload.data.interactionId] = task;
|
|
269
|
-
}
|
|
270
|
-
}
|
|
271
|
-
if (task) {
|
|
272
|
-
task = this.updateTaskData(task, payload.data);
|
|
273
|
-
task.emit(TASK_EVENTS.TASK_ASSIGNED, task);
|
|
274
|
-
}
|
|
275
|
-
break;
|
|
276
|
-
case CC_EVENTS.AGENT_CONTACT_UNASSIGNED:
|
|
277
|
-
task = this.updateTaskData(task, {
|
|
278
|
-
...payload.data,
|
|
279
|
-
wrapUpRequired: true,
|
|
280
|
-
});
|
|
281
|
-
task.emit(TASK_EVENTS.TASK_END, task);
|
|
282
|
-
break;
|
|
283
|
-
case CC_EVENTS.AGENT_CONTACT_OFFER_RONA:
|
|
284
|
-
case CC_EVENTS.AGENT_CONTACT_ASSIGN_FAILED:
|
|
285
|
-
case CC_EVENTS.AGENT_INVITE_FAILED: {
|
|
286
|
-
LoggerProxy.warn(
|
|
287
|
-
`[DEBUG-CAMPAIGN-CLEAR] Task removal triggered by ${payload.data.type}, interactionId=${payload.data.interactionId}, taskType=${task?.data?.type}`,
|
|
288
|
-
{
|
|
289
|
-
module: TASK_MANAGER_FILE,
|
|
290
|
-
method: METHODS.REGISTER_TASK_LISTENERS,
|
|
291
|
-
interactionId: payload.data.interactionId,
|
|
292
|
-
}
|
|
293
|
-
);
|
|
294
|
-
task = this.updateTaskData(task, payload.data);
|
|
295
|
-
|
|
296
|
-
const eventTypeToMetricMap: Record<string, keyof typeof METRIC_EVENT_NAMES> = {
|
|
297
|
-
[CC_EVENTS.AGENT_CONTACT_ASSIGN_FAILED]: 'AGENT_CONTACT_ASSIGN_FAILED',
|
|
298
|
-
[CC_EVENTS.AGENT_INVITE_FAILED]: 'AGENT_INVITE_FAILED',
|
|
299
|
-
};
|
|
300
|
-
const metricEventName: keyof typeof METRIC_EVENT_NAMES =
|
|
301
|
-
eventTypeToMetricMap[payload.data.type] || 'AGENT_RONA';
|
|
302
|
-
|
|
303
|
-
this.metricsManager.trackEvent(
|
|
304
|
-
METRIC_EVENT_NAMES[metricEventName],
|
|
305
|
-
{
|
|
306
|
-
...MetricsManager.getCommonTrackingFieldForAQMResponse(payload.data),
|
|
307
|
-
taskId: payload.data.interactionId,
|
|
308
|
-
reason: payload.data.reason,
|
|
309
|
-
},
|
|
310
|
-
['behavioral', 'operational']
|
|
311
|
-
);
|
|
312
|
-
this.handleTaskCleanup(task);
|
|
313
|
-
task.emit(TASK_EVENTS.TASK_REJECT, payload.data.reason);
|
|
314
|
-
break;
|
|
315
|
-
}
|
|
316
|
-
case CC_EVENTS.CONTACT_ENDED:
|
|
317
|
-
// Update task data
|
|
318
|
-
if (task) {
|
|
319
|
-
LoggerProxy.warn(
|
|
320
|
-
`[DEBUG-CAMPAIGN-CLEAR] CONTACT_ENDED, interactionId=${payload.data.interactionId}, taskType=${task?.data?.type}, state=${task?.data?.interaction?.state}`,
|
|
321
|
-
{
|
|
322
|
-
module: TASK_MANAGER_FILE,
|
|
323
|
-
method: METHODS.REGISTER_TASK_LISTENERS,
|
|
324
|
-
interactionId: payload.data.interactionId,
|
|
325
|
-
}
|
|
326
|
-
);
|
|
327
|
-
task = this.updateTaskData(task, {
|
|
328
|
-
...payload.data,
|
|
329
|
-
wrapUpRequired: payload.data.agentsPendingWrapUp?.includes(this.agentId) || false,
|
|
330
|
-
});
|
|
331
|
-
|
|
332
|
-
// Handle cleanup based on whether task should be deleted
|
|
333
|
-
this.handleTaskCleanup(task);
|
|
334
|
-
|
|
335
|
-
task?.emit(TASK_EVENTS.TASK_END, task);
|
|
336
|
-
}
|
|
337
|
-
break;
|
|
338
|
-
case CC_EVENTS.CAMPAIGN_CONTACT_UPDATED:
|
|
339
|
-
// CampaignContactUpdated is a non-terminal event (intermediate update during accept).
|
|
340
|
-
// Only update the task data — do NOT remove the task or emit TASK_END.
|
|
341
|
-
// Task cleanup is handled by CONTACT_ENDED or other terminal events.
|
|
342
|
-
if (task) {
|
|
343
|
-
task = this.updateTaskData(task, payload.data);
|
|
344
|
-
}
|
|
345
|
-
break;
|
|
346
|
-
case CC_EVENTS.CONTACT_MERGED:
|
|
347
|
-
task = this.handleContactMerged(task, payload.data);
|
|
348
|
-
break;
|
|
349
|
-
case CC_EVENTS.AGENT_CONTACT_HELD:
|
|
350
|
-
// As soon as the main interaction is held, we need to emit TASK_HOLD
|
|
351
|
-
task = this.updateTaskData(task, payload.data);
|
|
352
|
-
task.emit(TASK_EVENTS.TASK_HOLD, task);
|
|
353
|
-
break;
|
|
354
|
-
case CC_EVENTS.AGENT_CONTACT_UNHELD:
|
|
355
|
-
// As soon as the main interaction is unheld, we need to emit TASK_RESUME
|
|
356
|
-
task = this.updateTaskData(task, payload.data);
|
|
357
|
-
task.emit(TASK_EVENTS.TASK_RESUME, task);
|
|
358
|
-
break;
|
|
359
|
-
case CC_EVENTS.AGENT_VTEAM_TRANSFERRED:
|
|
360
|
-
task = this.updateTaskData(task, {
|
|
361
|
-
...payload.data,
|
|
362
|
-
wrapUpRequired: true,
|
|
363
|
-
});
|
|
364
|
-
task.emit(TASK_EVENTS.TASK_END, task);
|
|
365
|
-
break;
|
|
366
|
-
case CC_EVENTS.AGENT_CTQ_CANCEL_FAILED:
|
|
367
|
-
task = this.updateTaskData(task, payload.data);
|
|
368
|
-
task.emit(TASK_EVENTS.TASK_CONSULT_QUEUE_FAILED, task);
|
|
369
|
-
break;
|
|
370
|
-
case CC_EVENTS.AGENT_CONSULT_CREATED:
|
|
371
|
-
// Received when self agent initiates a consult
|
|
372
|
-
task = this.updateTaskData(task, {
|
|
373
|
-
...payload.data,
|
|
374
|
-
isConsulted: false, // This ensures that the task consult status is always reset
|
|
375
|
-
});
|
|
376
|
-
task.emit(TASK_EVENTS.TASK_CONSULT_CREATED, task);
|
|
377
|
-
break;
|
|
378
|
-
case CC_EVENTS.AGENT_OFFER_CONSULT:
|
|
379
|
-
// Received when other agent sends us a consult offer
|
|
380
|
-
task = this.updateTaskData(task, {
|
|
381
|
-
...payload.data,
|
|
382
|
-
isConsulted: true, // This ensures that the task is marked as us being requested for a consult
|
|
383
|
-
});
|
|
384
|
-
task.emit(TASK_EVENTS.TASK_OFFER_CONSULT, task);
|
|
385
|
-
|
|
386
|
-
// Handle auto-answer for consult offer
|
|
387
|
-
this.handleAutoAnswer(task);
|
|
388
|
-
break;
|
|
389
|
-
case CC_EVENTS.AGENT_CONSULTING:
|
|
390
|
-
// Received when agent is in an active consult state
|
|
391
|
-
// TODO: Check if we can use backend consult state instead of isConsulted
|
|
392
|
-
task = this.updateTaskData(task, payload.data);
|
|
393
|
-
if (task.data.isConsulted) {
|
|
394
|
-
// Fire only if you are the agent who received the consult request
|
|
395
|
-
task.emit(TASK_EVENTS.TASK_CONSULT_ACCEPTED, task);
|
|
396
|
-
} else {
|
|
397
|
-
// Fire only if you are the agent who initiated the consult
|
|
398
|
-
task.emit(TASK_EVENTS.TASK_CONSULTING, task);
|
|
399
|
-
}
|
|
400
|
-
break;
|
|
401
|
-
case CC_EVENTS.AGENT_CONSULT_FAILED:
|
|
402
|
-
// This can only be received by the agent who initiated the consult.
|
|
403
|
-
// We need not emit any event here since this will be result of promise
|
|
404
|
-
task = this.updateTaskData(task, payload.data);
|
|
405
|
-
break;
|
|
406
|
-
case CC_EVENTS.AGENT_CONSULT_ENDED:
|
|
407
|
-
task = this.updateTaskData(task, payload.data);
|
|
408
|
-
if (task.data.isConsulted) {
|
|
409
|
-
// This will be the end state of the task as soon as we end the consult in case of
|
|
410
|
-
// us being offered a consult
|
|
411
|
-
this.removeTaskFromCollection(task);
|
|
412
|
-
}
|
|
413
|
-
task.emit(TASK_EVENTS.TASK_CONSULT_END, task);
|
|
414
|
-
break;
|
|
415
|
-
case CC_EVENTS.AGENT_CTQ_CANCELLED:
|
|
416
|
-
// This event is received when the consult using queue is cancelled using API
|
|
417
|
-
task = this.updateTaskData(task, payload.data);
|
|
418
|
-
task.emit(TASK_EVENTS.TASK_CONSULT_QUEUE_CANCELLED, task);
|
|
419
|
-
break;
|
|
420
|
-
case CC_EVENTS.AGENT_WRAPUP:
|
|
421
|
-
task = this.updateTaskData(task, {...payload.data, wrapUpRequired: true});
|
|
422
|
-
task.emit(TASK_EVENTS.TASK_END, task);
|
|
423
|
-
break;
|
|
424
|
-
case CC_EVENTS.AGENT_WRAPPEDUP:
|
|
425
|
-
task.cancelAutoWrapupTimer();
|
|
426
|
-
this.removeTaskFromCollection(task);
|
|
427
|
-
task.emit(TASK_EVENTS.TASK_WRAPPEDUP, task);
|
|
428
|
-
break;
|
|
429
|
-
case CC_EVENTS.CONTACT_RECORDING_PAUSED:
|
|
430
|
-
task = this.updateTaskData(task, payload.data);
|
|
431
|
-
task.emit(TASK_EVENTS.TASK_RECORDING_PAUSED, task);
|
|
432
|
-
break;
|
|
433
|
-
case CC_EVENTS.CONTACT_RECORDING_PAUSE_FAILED:
|
|
434
|
-
task = this.updateTaskData(task, payload.data);
|
|
435
|
-
task.emit(TASK_EVENTS.TASK_RECORDING_PAUSE_FAILED, task);
|
|
436
|
-
break;
|
|
437
|
-
case CC_EVENTS.CONTACT_RECORDING_RESUMED:
|
|
438
|
-
task = this.updateTaskData(task, payload.data);
|
|
439
|
-
task.emit(TASK_EVENTS.TASK_RECORDING_RESUMED, task);
|
|
440
|
-
break;
|
|
441
|
-
case CC_EVENTS.CONTACT_RECORDING_RESUME_FAILED:
|
|
442
|
-
task = this.updateTaskData(task, payload.data);
|
|
443
|
-
task.emit(TASK_EVENTS.TASK_RECORDING_RESUME_FAILED, task);
|
|
444
|
-
break;
|
|
445
|
-
case CC_EVENTS.AGENT_CONSULT_CONFERENCING:
|
|
446
|
-
// Conference is being established - update task state and emit establishing event
|
|
447
|
-
task = this.updateTaskData(task, payload.data);
|
|
448
|
-
task.emit(TASK_EVENTS.TASK_CONFERENCE_ESTABLISHING, task);
|
|
449
|
-
break;
|
|
450
|
-
case CC_EVENTS.AGENT_CONSULT_CONFERENCED:
|
|
451
|
-
// Conference started successfully - update task state and emit event
|
|
452
|
-
task = this.updateTaskData(task, payload.data);
|
|
453
|
-
task.emit(TASK_EVENTS.TASK_CONFERENCE_STARTED, task);
|
|
454
|
-
break;
|
|
455
|
-
case CC_EVENTS.AGENT_CONSULT_CONFERENCE_FAILED:
|
|
456
|
-
// Conference failed - update task state and emit failure event
|
|
457
|
-
task = this.updateTaskData(task, payload.data);
|
|
458
|
-
task.emit(TASK_EVENTS.TASK_CONFERENCE_FAILED, task);
|
|
459
|
-
break;
|
|
460
|
-
case CC_EVENTS.AGENT_CONSULT_CONFERENCE_ENDED:
|
|
461
|
-
// Conference ended - update task state and emit event
|
|
462
|
-
task = this.updateTaskData(task, payload.data);
|
|
463
|
-
if (
|
|
464
|
-
!task ||
|
|
465
|
-
isPrimary(task, this.agentId) ||
|
|
466
|
-
isParticipantInMainInteraction(task, this.agentId)
|
|
467
|
-
) {
|
|
468
|
-
LoggerProxy.log('Primary or main interaction participant leaving conference');
|
|
469
|
-
} else {
|
|
470
|
-
this.removeTaskFromCollection(task);
|
|
471
|
-
}
|
|
472
|
-
task.emit(TASK_EVENTS.TASK_CONFERENCE_ENDED, task);
|
|
473
|
-
break;
|
|
474
|
-
case CC_EVENTS.PARTICIPANT_JOINED_CONFERENCE: {
|
|
475
|
-
task = this.updateTaskData(task, {
|
|
476
|
-
...payload.data,
|
|
477
|
-
isConferenceInProgress: getIsConferenceInProgress(payload.data),
|
|
478
|
-
});
|
|
479
|
-
task.emit(TASK_EVENTS.TASK_PARTICIPANT_JOINED, task);
|
|
480
|
-
break;
|
|
481
|
-
}
|
|
482
|
-
case CC_EVENTS.PARTICIPANT_LEFT_CONFERENCE: {
|
|
483
|
-
// Conference ended - update task state and emit event
|
|
484
|
-
|
|
485
|
-
task = this.updateTaskData(task, {
|
|
486
|
-
...payload.data,
|
|
487
|
-
isConferenceInProgress: getIsConferenceInProgress(payload.data),
|
|
488
|
-
});
|
|
489
|
-
if (checkParticipantNotInInteraction(task, this.agentId)) {
|
|
490
|
-
if (
|
|
491
|
-
isParticipantInMainInteraction(task, this.agentId) ||
|
|
492
|
-
isPrimary(task, this.agentId)
|
|
493
|
-
) {
|
|
494
|
-
LoggerProxy.log('Primary or main interaction participant leaving conference');
|
|
495
|
-
} else {
|
|
496
|
-
this.removeTaskFromCollection(task);
|
|
497
|
-
}
|
|
498
|
-
}
|
|
499
|
-
task.emit(TASK_EVENTS.TASK_PARTICIPANT_LEFT, task);
|
|
500
|
-
break;
|
|
501
|
-
}
|
|
502
|
-
case CC_EVENTS.PARTICIPANT_LEFT_CONFERENCE_FAILED:
|
|
503
|
-
// Conference exit failed - update task state and emit failure event
|
|
504
|
-
task = this.updateTaskData(task, payload.data);
|
|
505
|
-
task.emit(TASK_EVENTS.TASK_PARTICIPANT_LEFT_FAILED, task);
|
|
506
|
-
break;
|
|
507
|
-
case CC_EVENTS.AGENT_CONSULT_CONFERENCE_END_FAILED:
|
|
508
|
-
// Conference end failed - update task state with error details and emit failure event
|
|
509
|
-
task = this.updateTaskData(task, payload.data);
|
|
510
|
-
task.emit(TASK_EVENTS.TASK_CONFERENCE_END_FAILED, task);
|
|
511
|
-
break;
|
|
512
|
-
case CC_EVENTS.AGENT_CONFERENCE_TRANSFERRED:
|
|
513
|
-
// Conference was transferred - update task state and emit transfer success event
|
|
514
|
-
// Note: Backend should provide hasLeft and wrapUpRequired status
|
|
515
|
-
task = this.updateTaskData(task, payload.data);
|
|
516
|
-
task.emit(TASK_EVENTS.TASK_CONFERENCE_TRANSFERRED, task);
|
|
517
|
-
break;
|
|
518
|
-
case CC_EVENTS.AGENT_CONFERENCE_TRANSFER_FAILED:
|
|
519
|
-
// Conference transfer failed - update task state with error details and emit failure event
|
|
520
|
-
task = this.updateTaskData(task, payload.data);
|
|
521
|
-
task.emit(TASK_EVENTS.TASK_CONFERENCE_TRANSFER_FAILED, task);
|
|
522
|
-
break;
|
|
523
|
-
case CC_EVENTS.PARTICIPANT_POST_CALL_ACTIVITY:
|
|
524
|
-
// Post-call activity for participant - update task state with activity details
|
|
525
|
-
task = this.updateTaskData(task, payload.data);
|
|
526
|
-
task.emit(TASK_EVENTS.TASK_POST_CALL_ACTIVITY, task);
|
|
527
|
-
break;
|
|
528
|
-
case CC_EVENTS.AGENT_OFFER_CAMPAIGN_RESERVATION: {
|
|
529
|
-
// Campaign preview contact offered to agent
|
|
530
|
-
// Create a task in the collection so subsequent events (e.g. AGENT_CONTACT_ASSIGNED
|
|
531
|
-
// after acceptPreviewContact) can find and update it.
|
|
532
|
-
// Emit TASK_CAMPAIGN_PREVIEW_RESERVATION instead of TASK_INCOMING so the call
|
|
533
|
-
// does not ring out to the customer before the agent explicitly accepts the preview contact.
|
|
534
|
-
LoggerProxy.log('Campaign preview reservation received', {
|
|
535
|
-
module: TASK_MANAGER_FILE,
|
|
536
|
-
method: METHODS.REGISTER_TASK_LISTENERS,
|
|
537
|
-
interactionId: payload.data.interactionId,
|
|
538
|
-
});
|
|
539
|
-
|
|
540
|
-
if (!this.taskCollection[payload.data.interactionId]) {
|
|
541
|
-
task = new Task(
|
|
542
|
-
this.contact,
|
|
543
|
-
this.webCallingService,
|
|
544
|
-
{
|
|
545
|
-
...payload.data,
|
|
546
|
-
wrapUpRequired: false,
|
|
547
|
-
isConferenceInProgress: false,
|
|
548
|
-
isAutoAnswering: false,
|
|
549
|
-
},
|
|
550
|
-
this.wrapupData,
|
|
551
|
-
this.agentId
|
|
552
|
-
);
|
|
553
|
-
this.taskCollection[payload.data.interactionId] = task;
|
|
554
|
-
} else {
|
|
555
|
-
task = this.updateTaskData(task, payload.data);
|
|
556
|
-
}
|
|
304
|
+
const participants = payload.interaction?.participants;
|
|
305
|
+
if (!participants || agentId in participants) {
|
|
306
|
+
return false;
|
|
307
|
+
}
|
|
557
308
|
|
|
558
|
-
|
|
559
|
-
|
|
560
|
-
|
|
309
|
+
const previousParticipants = task?.data?.interaction?.participants;
|
|
310
|
+
if (previousParticipants && !(agentId in previousParticipants)) {
|
|
311
|
+
return false;
|
|
312
|
+
}
|
|
313
|
+
|
|
314
|
+
return true;
|
|
315
|
+
}
|
|
316
|
+
|
|
317
|
+
/**
|
|
318
|
+
* Consulted non-owner: Voice exitConference / shouldWrapUpForThisAgent stays
|
|
319
|
+
* false unless an explicit wrap-up signal includes this agent.
|
|
320
|
+
*/
|
|
321
|
+
private static isConsultedNonOwner(
|
|
322
|
+
payload: WebSocketPayload,
|
|
323
|
+
agentId?: string,
|
|
324
|
+
task?: ITask
|
|
325
|
+
): boolean {
|
|
326
|
+
const isConsulted = payload.isConsulted ?? task?.data?.isConsulted;
|
|
327
|
+
if (isConsulted !== true) {
|
|
328
|
+
return false;
|
|
329
|
+
}
|
|
330
|
+
const owner = payload.interaction?.owner ?? task?.data?.interaction?.owner;
|
|
331
|
+
|
|
332
|
+
return Boolean(agentId && owner && owner !== agentId);
|
|
333
|
+
}
|
|
334
|
+
|
|
335
|
+
private static hasNonemptyPendingWrapUp(payload: WebSocketPayload): boolean {
|
|
336
|
+
return Array.isArray(payload.agentsPendingWrapUp) && payload.agentsPendingWrapUp.length > 0;
|
|
337
|
+
}
|
|
338
|
+
|
|
339
|
+
/**
|
|
340
|
+
* Transfer initiator fallback: widgets set transferConferenceRequested on the
|
|
341
|
+
* actor; desktop success payloads may include consultingAgentId. Only used
|
|
342
|
+
* when agentsPendingWrapUp is empty or absent.
|
|
343
|
+
*/
|
|
344
|
+
private static isSelfConferenceTransferInitiator(
|
|
345
|
+
payload: WebSocketPayload,
|
|
346
|
+
agentId?: string,
|
|
347
|
+
task?: ITask
|
|
348
|
+
): boolean {
|
|
349
|
+
const snapshotContext = task?.stateMachineService?.getSnapshot?.()?.context as
|
|
350
|
+
| {transferConferenceRequested?: boolean}
|
|
351
|
+
| undefined;
|
|
352
|
+
if (snapshotContext?.transferConferenceRequested === true) {
|
|
353
|
+
return true;
|
|
354
|
+
}
|
|
355
|
+
|
|
356
|
+
return Boolean(agentId && payload.consultingAgentId === agentId);
|
|
357
|
+
}
|
|
358
|
+
|
|
359
|
+
/**
|
|
360
|
+
* Explicit wrap-up signals only (no owner / isConsulted fallback).
|
|
361
|
+
* Used for events that remaining conference agents also receive.
|
|
362
|
+
* nonempty agentsPendingWrapUp is authoritative, then wrapUpRequired / isWrapUp.
|
|
363
|
+
*/
|
|
364
|
+
private static wrapUpRequiredFromExplicitSignals(
|
|
365
|
+
payload: WebSocketPayload,
|
|
366
|
+
agentId?: string
|
|
367
|
+
): boolean {
|
|
368
|
+
const pending = payload.agentsPendingWrapUp;
|
|
369
|
+
if (Array.isArray(pending) && pending.length > 0) {
|
|
370
|
+
return Boolean(agentId && pending.includes(agentId));
|
|
371
|
+
}
|
|
372
|
+
|
|
373
|
+
if (payload.wrapUpRequired === true) {
|
|
374
|
+
return true;
|
|
375
|
+
}
|
|
376
|
+
if (!agentId) {
|
|
377
|
+
return false;
|
|
378
|
+
}
|
|
379
|
+
|
|
380
|
+
return payload.interaction?.participants?.[agentId]?.isWrapUp === true;
|
|
381
|
+
}
|
|
382
|
+
|
|
383
|
+
/**
|
|
384
|
+
* Stamp wrapUpRequired once at ingress (prepareEventContext) so updateTaskData
|
|
385
|
+
* and the mapper see the same flag. Remaining agents stay false.
|
|
386
|
+
*/
|
|
387
|
+
private static stampWrapUpRequiredForEvent(
|
|
388
|
+
eventType: CC_EVENTS,
|
|
389
|
+
payload: WebSocketPayload,
|
|
390
|
+
agentId?: string,
|
|
391
|
+
task?: ITask
|
|
392
|
+
): WebSocketPayload {
|
|
393
|
+
if (!WRAP_UP_STAMP_EVENTS.has(eventType)) {
|
|
394
|
+
return payload;
|
|
395
|
+
}
|
|
396
|
+
|
|
397
|
+
if (eventType === CC_EVENTS.AGENT_WRAPUP) {
|
|
398
|
+
return {...payload, wrapUpRequired: true};
|
|
399
|
+
}
|
|
561
400
|
|
|
562
|
-
|
|
563
|
-
|
|
401
|
+
if (eventType === CC_EVENTS.AGENT_CONSULT_CONFERENCE_ENDED) {
|
|
402
|
+
return {
|
|
403
|
+
...payload,
|
|
404
|
+
wrapUpRequired: TaskManager.wrapUpRequiredFromExplicitSignals(payload, agentId),
|
|
405
|
+
};
|
|
406
|
+
}
|
|
407
|
+
|
|
408
|
+
if (eventType === CC_EVENTS.PARTICIPANT_LEFT_CONFERENCE) {
|
|
409
|
+
const actorState = task?.stateMachineService?.getSnapshot?.()?.value;
|
|
410
|
+
if (actorState && !PARTICIPANT_LEAVE_WRAP_STATES.has(actorState as TaskState)) {
|
|
411
|
+
return payload;
|
|
412
|
+
}
|
|
413
|
+
|
|
414
|
+
const left = TaskManager.didSelfLeaveConference(payload, agentId, task);
|
|
415
|
+
if (!left) {
|
|
416
|
+
return {
|
|
417
|
+
...payload,
|
|
418
|
+
wrapUpRequired: TaskManager.wrapUpRequiredFromExplicitSignals(payload, agentId),
|
|
419
|
+
};
|
|
420
|
+
}
|
|
421
|
+
if (TaskManager.hasNonemptyPendingWrapUp(payload)) {
|
|
422
|
+
return {
|
|
423
|
+
...payload,
|
|
424
|
+
wrapUpRequired: Boolean(agentId && payload.agentsPendingWrapUp?.includes(agentId)),
|
|
425
|
+
};
|
|
426
|
+
}
|
|
427
|
+
|
|
428
|
+
return {
|
|
429
|
+
...payload,
|
|
430
|
+
wrapUpRequired:
|
|
431
|
+
TaskManager.wrapUpRequiredFromExplicitSignals(payload, agentId) ||
|
|
432
|
+
!TaskManager.isConsultedNonOwner(payload, agentId, task),
|
|
433
|
+
};
|
|
434
|
+
}
|
|
435
|
+
|
|
436
|
+
// AGENT_CONFERENCE_TRANSFERRED — pending list wins; initiator only if empty/absent
|
|
437
|
+
if (TaskManager.hasNonemptyPendingWrapUp(payload)) {
|
|
438
|
+
return {
|
|
439
|
+
...payload,
|
|
440
|
+
wrapUpRequired: TaskManager.wrapUpRequiredFromExplicitSignals(payload, agentId),
|
|
441
|
+
};
|
|
442
|
+
}
|
|
443
|
+
|
|
444
|
+
return {
|
|
445
|
+
...payload,
|
|
446
|
+
wrapUpRequired:
|
|
447
|
+
TaskManager.wrapUpRequiredFromExplicitSignals(payload, agentId) ||
|
|
448
|
+
TaskManager.isSelfConferenceTransferInitiator(payload, agentId, task),
|
|
449
|
+
};
|
|
450
|
+
}
|
|
451
|
+
|
|
452
|
+
/**
|
|
453
|
+
* Map WebSocket CC_EVENTS to state machine TaskEvent
|
|
454
|
+
* @param ccEvent - The CC_EVENT type from WebSocket
|
|
455
|
+
* @param payload - The event payload
|
|
456
|
+
* @param agentId - Optional agent ID for state detection (needed for HYDRATE)
|
|
457
|
+
* @param task - Optional task instance for state-aware CONTACT_ENDED mapping
|
|
458
|
+
* @returns TaskEventPayload for state machine or null if no mapping
|
|
459
|
+
*/
|
|
460
|
+
private static mapEventToTaskStateMachineEvent(
|
|
461
|
+
ccEvent: CC_EVENTS,
|
|
462
|
+
payload: WebSocketPayload,
|
|
463
|
+
agentId?: string,
|
|
464
|
+
task?: ITask,
|
|
465
|
+
enableWxBetterTogether?: boolean
|
|
466
|
+
): TaskEventPayload | null {
|
|
467
|
+
const mediaResourceId =
|
|
468
|
+
payload.mediaResourceId ||
|
|
469
|
+
payload.interaction?.media?.[payload.interactionId]?.mediaResourceId;
|
|
470
|
+
|
|
471
|
+
switch (ccEvent) {
|
|
472
|
+
// CC -> TaskEvent mappings (see TaskStateMachine comment for quick reference)
|
|
473
|
+
case CC_EVENTS.AGENT_CONTACT_RESERVED: // AgentContactReserved -> TASK_INCOMING
|
|
474
|
+
if (isCampaignPreviewTask(payload)) {
|
|
475
|
+
return {
|
|
476
|
+
type: TaskEvent.TASK_INCOMING,
|
|
477
|
+
taskData: payload,
|
|
478
|
+
isCampaignReservationAccept: true,
|
|
479
|
+
};
|
|
564
480
|
}
|
|
565
|
-
if (task) {
|
|
566
|
-
const eventType = payload.type || payload.data.type;
|
|
567
|
-
const eventPayload = payload.data || payload.data.data;
|
|
568
481
|
|
|
569
|
-
|
|
482
|
+
return {type: TaskEvent.TASK_INCOMING, taskData: payload};
|
|
483
|
+
|
|
484
|
+
case CC_EVENTS.AGENT_OFFER_CAMPAIGN_RESERVATION: // -> TASK_INCOMING (campaign branch via guard)
|
|
485
|
+
return {
|
|
486
|
+
type: TaskEvent.TASK_INCOMING,
|
|
487
|
+
taskData: payload,
|
|
488
|
+
isCampaignReservationAccept: true,
|
|
489
|
+
};
|
|
490
|
+
|
|
491
|
+
case CC_EVENTS.AGENT_OFFER_CONTACT: // AgentOfferContact -> TASK_OFFERED
|
|
492
|
+
return {type: TaskEvent.TASK_OFFERED, taskData: payload};
|
|
493
|
+
|
|
494
|
+
case CC_EVENTS.AGENT_CONTACT: // AgentContact -> HYDRATE
|
|
495
|
+
// Include agentId for state detection (e.g., checking isWrapUp in participant data)
|
|
496
|
+
return {type: TaskEvent.HYDRATE, taskData: payload, agentId};
|
|
497
|
+
|
|
498
|
+
case CC_EVENTS.CONTACT_UPDATED:
|
|
499
|
+
if (
|
|
500
|
+
task &&
|
|
501
|
+
typeof payload.interaction?.owner === 'string' &&
|
|
502
|
+
payload.interaction.owner.trim().length > 0 &&
|
|
503
|
+
payload.interaction.owner !== task.data?.interaction?.owner
|
|
504
|
+
) {
|
|
505
|
+
return {type: TaskEvent.CONTACT_OWNER_CHANGED, taskData: payload};
|
|
570
506
|
}
|
|
571
507
|
|
|
572
|
-
|
|
573
|
-
|
|
574
|
-
|
|
575
|
-
|
|
508
|
+
return {type: TaskEvent.CONTACT_UPDATED, taskData: payload};
|
|
509
|
+
case CC_EVENTS.CONTACT_OWNER_CHANGED:
|
|
510
|
+
return {type: TaskEvent.CONTACT_OWNER_CHANGED, taskData: payload};
|
|
511
|
+
|
|
512
|
+
case CC_EVENTS.AGENT_OFFER_CONSULT: // AgentOfferConsult -> OFFER_CONSULT
|
|
513
|
+
return {
|
|
514
|
+
type: TaskEvent.OFFER_CONSULT,
|
|
515
|
+
taskData: {...payload, isConsulted: true},
|
|
516
|
+
};
|
|
517
|
+
|
|
518
|
+
case CC_EVENTS.AGENT_CONTACT_ASSIGNED: // AgentContactAssigned -> ASSIGN
|
|
519
|
+
return {type: TaskEvent.ASSIGN, taskData: payload};
|
|
520
|
+
|
|
521
|
+
case CC_EVENTS.AGENT_CONTACT_HELD:
|
|
522
|
+
return {
|
|
523
|
+
type: TaskEvent.HOLD_SUCCESS,
|
|
524
|
+
mediaResourceId: mediaResourceId || '',
|
|
525
|
+
taskData: payload,
|
|
526
|
+
};
|
|
527
|
+
|
|
528
|
+
case CC_EVENTS.AGENT_CONTACT_UNHELD:
|
|
529
|
+
return {
|
|
530
|
+
type: TaskEvent.UNHOLD_SUCCESS,
|
|
531
|
+
mediaResourceId: mediaResourceId || '',
|
|
532
|
+
taskData: payload,
|
|
533
|
+
};
|
|
534
|
+
|
|
535
|
+
case CC_EVENTS.AGENT_CONSULT_CREATED:
|
|
536
|
+
return {
|
|
537
|
+
type: TaskEvent.CONSULT_CREATED,
|
|
538
|
+
taskData: {...payload, isConsulted: false},
|
|
539
|
+
};
|
|
540
|
+
|
|
541
|
+
case CC_EVENTS.AGENT_CONSULTING: // AgentConsulting -> CONSULTING_ACTIVE
|
|
542
|
+
// use context to figure out if it's the initiator or receiver using consultInitiator from context
|
|
543
|
+
return {
|
|
544
|
+
type: TaskEvent.CONSULTING_ACTIVE,
|
|
545
|
+
consultDestinationAgentJoined: true,
|
|
546
|
+
taskData: payload,
|
|
547
|
+
};
|
|
548
|
+
|
|
549
|
+
case CC_EVENTS.AGENT_CONSULT_ENDED: // AgentConsultEnded -> CONSULT_END
|
|
550
|
+
return {type: TaskEvent.CONSULT_END, taskData: payload};
|
|
551
|
+
|
|
552
|
+
case CC_EVENTS.AGENT_CONSULT_FAILED:
|
|
553
|
+
case CC_EVENTS.AGENT_CTQ_FAILED:
|
|
554
|
+
return {type: TaskEvent.CONSULT_FAILED, reason: payload.reason, taskData: payload};
|
|
555
|
+
|
|
556
|
+
case CC_EVENTS.AGENT_CTQ_CANCELLED:
|
|
557
|
+
return {type: TaskEvent.CTQ_CANCEL, taskData: payload};
|
|
558
|
+
|
|
559
|
+
case CC_EVENTS.AGENT_CTQ_CANCEL_FAILED:
|
|
560
|
+
return {type: TaskEvent.CTQ_CANCEL_FAILED, taskData: payload};
|
|
561
|
+
|
|
562
|
+
case CC_EVENTS.AGENT_BLIND_TRANSFERRED: // AgentBlindTransferred -> TRANSFER_SUCCESS
|
|
563
|
+
case CC_EVENTS.AGENT_CONSULT_TRANSFERRED: // AgentConsultTransferred -> TRANSFER_SUCCESS
|
|
564
|
+
case CC_EVENTS.AGENT_VTEAM_TRANSFERRED: // AgentVTeamTransferred -> TRANSFER_SUCCESS
|
|
565
|
+
return {
|
|
566
|
+
type: TaskEvent.TRANSFER_SUCCESS,
|
|
567
|
+
taskData: payload,
|
|
568
|
+
};
|
|
569
|
+
|
|
570
|
+
case CC_EVENTS.AGENT_WRAPUP:
|
|
571
|
+
return {type: TaskEvent.TASK_WRAPUP, taskData: {...payload, wrapUpRequired: true}};
|
|
572
|
+
case CC_EVENTS.AGENT_CONTACT_UNASSIGNED:
|
|
573
|
+
return null; // Add WRAPUP if needed
|
|
576
574
|
|
|
577
|
-
|
|
578
|
-
|
|
575
|
+
case CC_EVENTS.AGENT_BLIND_TRANSFER_FAILED:
|
|
576
|
+
case CC_EVENTS.AGENT_VTEAM_TRANSFER_FAILED:
|
|
577
|
+
case CC_EVENTS.AGENT_CONSULT_TRANSFER_FAILED:
|
|
578
|
+
case CC_EVENTS.AGENT_CONFERENCE_TRANSFER_FAILED:
|
|
579
|
+
return {type: TaskEvent.TRANSFER_FAILED, taskData: payload};
|
|
580
|
+
|
|
581
|
+
case CC_EVENTS.CONTACT_ENDED: {
|
|
582
|
+
const wrapUpRequired = isCampaignPreviewTask(payload)
|
|
583
|
+
? false
|
|
584
|
+
: payload.agentsPendingWrapUp?.includes(agentId || '') || false;
|
|
585
|
+
|
|
586
|
+
// Post-accept wxApp outdial agent-end delivers ContactEnded instead of
|
|
587
|
+
// AgentOutboundFailed. Normalize to OUTBOUND_FAILED so state machine
|
|
588
|
+
// enters WRAPPING_UP and emits TASK_OUTDIAL_FAILED (AGENT_ENDS).
|
|
589
|
+
// Pre-accept cancelTask decline stays CONTACT_ENDED → TERMINATED (no wrapup).
|
|
590
|
+
if (
|
|
591
|
+
TaskManager.isAgentTerminatedOutdialWrapup(
|
|
592
|
+
payload,
|
|
593
|
+
wrapUpRequired,
|
|
594
|
+
task,
|
|
595
|
+
agentId,
|
|
596
|
+
enableWxBetterTogether
|
|
597
|
+
)
|
|
598
|
+
) {
|
|
599
|
+
return {
|
|
600
|
+
type: TaskEvent.OUTBOUND_FAILED,
|
|
601
|
+
reason: 'AGENT_ENDS',
|
|
602
|
+
taskData: {...payload, wrapUpRequired: true},
|
|
603
|
+
};
|
|
579
604
|
}
|
|
605
|
+
|
|
606
|
+
return {
|
|
607
|
+
type: TaskEvent.CONTACT_ENDED,
|
|
608
|
+
taskData: {
|
|
609
|
+
...payload,
|
|
610
|
+
wrapUpRequired,
|
|
611
|
+
},
|
|
612
|
+
};
|
|
580
613
|
}
|
|
581
|
-
|
|
614
|
+
|
|
615
|
+
case CC_EVENTS.AGENT_INVITE_FAILED:
|
|
616
|
+
return {type: TaskEvent.INVITE_FAILED, reason: payload.reason};
|
|
617
|
+
|
|
618
|
+
case CC_EVENTS.AGENT_CONTACT_ASSIGN_FAILED:
|
|
619
|
+
return {type: TaskEvent.ASSIGN_FAILED, reason: payload.reason};
|
|
620
|
+
|
|
621
|
+
case CC_EVENTS.AGENT_CONTACT_OFFER_RONA:
|
|
622
|
+
return {type: TaskEvent.RONA, taskData: payload, reason: payload.reason};
|
|
623
|
+
|
|
624
|
+
case CC_EVENTS.AGENT_OUTBOUND_FAILED: {
|
|
625
|
+
const isAgentTerminatedOutdial =
|
|
626
|
+
payload.interaction?.outboundType === 'OUTDIAL' &&
|
|
627
|
+
(payload.terminatingParty === 'Agent' || payload.reason === 'AGENT_ENDS');
|
|
628
|
+
|
|
629
|
+
const suppressOutdialFailedPopup =
|
|
630
|
+
isAgentTerminatedOutdial &&
|
|
631
|
+
!TaskManager.isWxAppManagedOutdialTask(agentId, payload, task, enableWxBetterTogether);
|
|
632
|
+
|
|
633
|
+
return {
|
|
634
|
+
type: TaskEvent.OUTBOUND_FAILED,
|
|
635
|
+
taskData: suppressOutdialFailedPopup
|
|
636
|
+
? {...payload, suppressOutdialFailedPopup: true}
|
|
637
|
+
: payload,
|
|
638
|
+
reason: payload.reason,
|
|
639
|
+
};
|
|
640
|
+
}
|
|
641
|
+
|
|
642
|
+
case CC_EVENTS.CAMPAIGN_PREVIEW_ACCEPT_FAILED:
|
|
643
|
+
return {type: TaskEvent.CAMPAIGN_PREVIEW_ACCEPT_FAILED, taskData: payload};
|
|
644
|
+
|
|
645
|
+
case CC_EVENTS.CAMPAIGN_PREVIEW_SKIP_FAILED:
|
|
646
|
+
return {type: TaskEvent.CAMPAIGN_PREVIEW_SKIP_FAILED, taskData: payload};
|
|
647
|
+
|
|
648
|
+
case CC_EVENTS.CAMPAIGN_PREVIEW_REMOVE_FAILED:
|
|
649
|
+
return {type: TaskEvent.CAMPAIGN_PREVIEW_REMOVE_FAILED, taskData: payload};
|
|
650
|
+
|
|
651
|
+
case CC_EVENTS.CONTACT_RECORDING_STARTED:
|
|
652
|
+
return {type: TaskEvent.RECORDING_STARTED, taskData: payload};
|
|
653
|
+
|
|
654
|
+
case CC_EVENTS.CONTACT_RECORDING_PAUSED:
|
|
655
|
+
return {type: TaskEvent.PAUSE_RECORDING, taskData: payload};
|
|
656
|
+
|
|
657
|
+
case CC_EVENTS.CONTACT_RECORDING_RESUMED:
|
|
658
|
+
return {type: TaskEvent.RESUME_RECORDING, taskData: payload};
|
|
659
|
+
|
|
660
|
+
case CC_EVENTS.AGENT_WRAPPEDUP:
|
|
661
|
+
return {type: TaskEvent.WRAPUP_COMPLETE, taskData: payload};
|
|
662
|
+
|
|
663
|
+
// Conference events - these trigger state machine transition to CONFERENCING
|
|
664
|
+
case CC_EVENTS.AGENT_CONSULT_CONFERENCED:
|
|
665
|
+
case CC_EVENTS.AGENT_CONSULT_CONFERENCING:
|
|
666
|
+
case CC_EVENTS.PARTICIPANT_JOINED_CONFERENCE:
|
|
667
|
+
return {type: TaskEvent.CONFERENCE_START, taskData: payload};
|
|
668
|
+
|
|
669
|
+
case CC_EVENTS.AGENT_CONSULT_CONFERENCE_FAILED:
|
|
670
|
+
return {type: TaskEvent.CONFERENCE_FAILED, reason: payload.reason, taskData: payload};
|
|
671
|
+
|
|
672
|
+
case CC_EVENTS.AGENT_CONSULT_CONFERENCE_ENDED:
|
|
673
|
+
return {type: TaskEvent.CONFERENCE_END, taskData: payload};
|
|
674
|
+
|
|
675
|
+
case CC_EVENTS.PARTICIPANT_LEFT_CONFERENCE:
|
|
676
|
+
return {
|
|
677
|
+
type: TaskEvent.PARTICIPANT_LEAVE,
|
|
678
|
+
taskData: payload,
|
|
679
|
+
participantId: payload?.participantId,
|
|
680
|
+
};
|
|
681
|
+
|
|
682
|
+
case CC_EVENTS.AGENT_CONFERENCE_TRANSFERRED:
|
|
683
|
+
return {type: TaskEvent.TRANSFER_CONFERENCE_SUCCESS, taskData: payload};
|
|
684
|
+
|
|
685
|
+
default:
|
|
686
|
+
// Not all events need state machine mapping
|
|
687
|
+
return null;
|
|
688
|
+
}
|
|
582
689
|
}
|
|
583
690
|
|
|
584
|
-
|
|
585
|
-
|
|
586
|
-
|
|
691
|
+
/**
|
|
692
|
+
* True when the current agent's task is a wxApp-managed outdial (thick-client telephony).
|
|
693
|
+
*/
|
|
694
|
+
private static isWxAppManagedOutdialTask(
|
|
695
|
+
agentId: string | undefined,
|
|
696
|
+
payload: WebSocketPayload,
|
|
697
|
+
task: ITask | undefined,
|
|
698
|
+
enableWxBetterTogether?: boolean
|
|
699
|
+
): boolean {
|
|
700
|
+
const wxAppEnabled =
|
|
701
|
+
(task as {uiControlConfig?: {enableWxBetterTogether?: boolean}})?.uiControlConfig
|
|
702
|
+
?.enableWxBetterTogether ??
|
|
703
|
+
enableWxBetterTogether ??
|
|
704
|
+
false;
|
|
705
|
+
|
|
706
|
+
if (!wxAppEnabled) {
|
|
707
|
+
return false;
|
|
587
708
|
}
|
|
588
709
|
|
|
589
|
-
|
|
590
|
-
|
|
591
|
-
|
|
592
|
-
|
|
593
|
-
|
|
710
|
+
const effectiveAgentId = agentId ?? task?.data?.agentId;
|
|
711
|
+
const participants = payload.interaction?.participants ?? task?.data?.interaction?.participants;
|
|
712
|
+
const details = getWebexCallingDeviceDetailsForAgent(effectiveAgentId, participants);
|
|
713
|
+
|
|
714
|
+
return details?.deviceType === 'wxApp';
|
|
715
|
+
}
|
|
716
|
+
|
|
717
|
+
/**
|
|
718
|
+
* True when ContactEnded represents an agent-terminated wxApp outdial that should
|
|
719
|
+
* enter wrapup with an outdial-failed popup (legacy AgentOutboundFailed parity).
|
|
720
|
+
*/
|
|
721
|
+
private static isAgentTerminatedOutdialWrapup(
|
|
722
|
+
payload: WebSocketPayload,
|
|
723
|
+
wrapUpRequired: boolean,
|
|
724
|
+
task?: ITask,
|
|
725
|
+
agentId?: string,
|
|
726
|
+
enableWxBetterTogether?: boolean
|
|
727
|
+
): boolean {
|
|
728
|
+
const isOutdial = payload.interaction?.outboundType === 'OUTDIAL';
|
|
729
|
+
const agentTerminated = payload.terminatingParty === 'Agent';
|
|
730
|
+
|
|
731
|
+
if (!isOutdial || !agentTerminated) {
|
|
732
|
+
return false;
|
|
733
|
+
}
|
|
734
|
+
|
|
735
|
+
if (!TaskManager.isWxAppManagedOutdialTask(agentId, payload, task, enableWxBetterTogether)) {
|
|
736
|
+
return false;
|
|
594
737
|
}
|
|
595
738
|
|
|
739
|
+
const wxAppAnswerPending =
|
|
740
|
+
(task as {uiControlConfig?: {wxAppAnswerPending?: boolean}})?.uiControlConfig
|
|
741
|
+
?.wxAppAnswerPending ?? false;
|
|
742
|
+
|
|
743
|
+
// Pre-accept decline: decline() clears wxAppAnswerPending; backend may still send state wrapUp.
|
|
744
|
+
if (!wxAppAnswerPending && !wrapUpRequired) {
|
|
745
|
+
return false;
|
|
746
|
+
}
|
|
747
|
+
|
|
748
|
+
const interactionWrapUp = payload.interaction?.state === 'wrapUp';
|
|
749
|
+
|
|
750
|
+
return wrapUpRequired || interactionWrapUp || wxAppAnswerPending;
|
|
751
|
+
}
|
|
752
|
+
|
|
753
|
+
/**
|
|
754
|
+
* Register WebSocket message listeners for task events
|
|
755
|
+
*
|
|
756
|
+
* Main entry point that orchestrates event processing through a clear pipeline:
|
|
757
|
+
* 1. Parse and validate incoming WebSocket messages
|
|
758
|
+
* 2. Prepare event context with task and state machine mappings
|
|
759
|
+
* 3. Handle task lifecycle (creation, updates, collection management)
|
|
760
|
+
* 4. Send events to state machine (task-level transitions/emissions)
|
|
761
|
+
* 5. Cleanup is triggered via task events emitted by the state machine
|
|
762
|
+
*
|
|
763
|
+
* This architecture separates concerns:
|
|
764
|
+
* - TaskManager: Manages task collection lifecycle and operational concerns
|
|
765
|
+
* - State Machine: Manages individual task state and event emissions
|
|
766
|
+
*/
|
|
767
|
+
private registerTaskListeners() {
|
|
768
|
+
this.webSocketManager.on('message', (event) => {
|
|
769
|
+
// Step 1: Parse and validate the message
|
|
770
|
+
const message = TaskManager.parseWebSocketMessage(event);
|
|
771
|
+
if (!message) return;
|
|
772
|
+
|
|
773
|
+
// Step 2: Prepare event context
|
|
774
|
+
const eventContext = this.prepareEventContext(message);
|
|
775
|
+
if (!eventContext) return;
|
|
776
|
+
|
|
777
|
+
const actions = this.handleTaskLifecycleEvent(eventContext);
|
|
778
|
+
|
|
779
|
+
const {task} = actions;
|
|
780
|
+
if (!task) return;
|
|
781
|
+
|
|
782
|
+
const {payload, stateMachineEvent} = eventContext;
|
|
783
|
+
|
|
784
|
+
// Always keep task.data updated (even for mapped events) so consumers relying
|
|
785
|
+
// on TaskManager-managed task instances see the latest payload.
|
|
786
|
+
if (payload) {
|
|
787
|
+
this.updateTaskData(task, payload);
|
|
788
|
+
}
|
|
789
|
+
|
|
790
|
+
// Send event to state machine - this will trigger all TASK_EVENTS emissions
|
|
791
|
+
// including TASK_INCOMING which is now handled via the state machine callbacks
|
|
792
|
+
if (stateMachineEvent) {
|
|
793
|
+
task.sendStateMachineEvent(stateMachineEvent);
|
|
794
|
+
}
|
|
795
|
+
|
|
796
|
+
// A receiving summary held while the task rang is emitted right after the answer
|
|
797
|
+
// event above (AgentContactAssigned / AgentConsulting) has been emitted.
|
|
798
|
+
const bufferedSummary = this.receivingSummaryBuffer.get(task.data.interactionId);
|
|
799
|
+
const taskState = task.state?.value;
|
|
800
|
+
if (bufferedSummary && taskState !== TaskState.IDLE && taskState !== TaskState.OFFERED) {
|
|
801
|
+
this.receivingSummaryBuffer.delete(task.data.interactionId);
|
|
802
|
+
task.emit(TASK_EVENTS.TASK_MID_CALL_SUMMARY_RECEIVED, bufferedSummary);
|
|
803
|
+
}
|
|
804
|
+
|
|
805
|
+
// Emit TASK_POST_CALL_ACTIVITY for ParticipantPostCallActivity events so
|
|
806
|
+
// consumers (Widgets) can detect the interaction state change to post_call.
|
|
807
|
+
if (eventContext.eventType === CC_EVENTS.PARTICIPANT_POST_CALL_ACTIVITY) {
|
|
808
|
+
task.emit(TASK_EVENTS.TASK_POST_CALL_ACTIVITY, task);
|
|
809
|
+
}
|
|
810
|
+
|
|
811
|
+
// Send transcript start/stop events for relevant CC events
|
|
812
|
+
this.requestRealTimeTranscripts(eventContext.eventType, payload.interactionId);
|
|
813
|
+
});
|
|
814
|
+
}
|
|
815
|
+
|
|
816
|
+
/**
|
|
817
|
+
* Parse and validate WebSocket message
|
|
818
|
+
* @returns Parsed message or null if invalid/keepalive
|
|
819
|
+
*/
|
|
820
|
+
private static parseWebSocketMessage(event: string): WebSocketMessage | null {
|
|
596
821
|
try {
|
|
597
|
-
const
|
|
598
|
-
|
|
822
|
+
const payload = JSON.parse(event) as WebSocketMessage;
|
|
823
|
+
|
|
824
|
+
// Filter out keepalive messages
|
|
825
|
+
if (payload?.keepalive === 'true' || payload?.keepalive === true) {
|
|
826
|
+
return null;
|
|
827
|
+
}
|
|
599
828
|
|
|
600
|
-
|
|
829
|
+
// Normalize task data if present
|
|
830
|
+
if (payload?.data?.interaction) {
|
|
831
|
+
payload.data = normalizeTaskData(payload.data);
|
|
832
|
+
}
|
|
833
|
+
|
|
834
|
+
return payload;
|
|
601
835
|
} catch (error) {
|
|
602
|
-
LoggerProxy.error(
|
|
836
|
+
LoggerProxy.error('Failed to parse WebSocket message', {
|
|
603
837
|
module: TASK_MANAGER_FILE,
|
|
604
|
-
method:
|
|
605
|
-
|
|
838
|
+
method: 'parseWebSocketMessage',
|
|
839
|
+
error,
|
|
606
840
|
});
|
|
607
841
|
|
|
608
|
-
return
|
|
842
|
+
return null;
|
|
609
843
|
}
|
|
610
844
|
}
|
|
611
845
|
|
|
612
846
|
/**
|
|
613
|
-
*
|
|
614
|
-
* @
|
|
615
|
-
* @param taskData - The task data from the event payload
|
|
616
|
-
* @returns Updated or newly created task
|
|
617
|
-
* @private
|
|
847
|
+
* Prepare context for event processing
|
|
848
|
+
* @returns Event context or null if event type is invalid
|
|
618
849
|
*/
|
|
619
|
-
private
|
|
620
|
-
|
|
621
|
-
|
|
622
|
-
|
|
850
|
+
private prepareEventContext(message: WebSocketMessage): EventContext | null {
|
|
851
|
+
const eventType = message.data?.type || message.type;
|
|
852
|
+
|
|
853
|
+
if (!eventType || !isCcEvent(eventType)) {
|
|
854
|
+
return null;
|
|
623
855
|
}
|
|
624
856
|
|
|
625
|
-
|
|
626
|
-
|
|
857
|
+
const interactionId = message.data.interactionId;
|
|
858
|
+
const reservationInteractionId = message.data.reservationInteractionId;
|
|
859
|
+
let task = this.taskCollection[interactionId];
|
|
860
|
+
let ownerChangeResolvedByRelatedInteraction = false;
|
|
861
|
+
|
|
862
|
+
// When a campaign preview contact is accepted, the assigned event may arrive
|
|
863
|
+
// with a new interactionId while the task is stored under the original
|
|
864
|
+
// reservationInteractionId. Fall back to that key so the task is found.
|
|
865
|
+
if (!task && reservationInteractionId) {
|
|
866
|
+
task = this.taskCollection[reservationInteractionId];
|
|
867
|
+
if (task) {
|
|
868
|
+
// Re-key the task under the new interaction ID and remove the old entry
|
|
869
|
+
delete this.taskCollection[reservationInteractionId];
|
|
870
|
+
this.taskCollection[interactionId] = task;
|
|
871
|
+
this.pendingFeatureEnablement.delete(reservationInteractionId);
|
|
872
|
+
}
|
|
873
|
+
}
|
|
874
|
+
|
|
875
|
+
if (!task && eventType === CC_EVENTS.CONTACT_OWNER_CHANGED) {
|
|
876
|
+
const incomingShowsCurrentAgentPromotion = Boolean(
|
|
877
|
+
this.agentId &&
|
|
878
|
+
message.data.interaction?.owner === this.agentId &&
|
|
879
|
+
TaskManager.isParticipantActiveOnMainInteraction(message.data, this.agentId)
|
|
880
|
+
);
|
|
881
|
+
|
|
882
|
+
task = this.findUniqueTaskByRelatedInteraction(
|
|
883
|
+
message.data,
|
|
884
|
+
(candidate) => {
|
|
885
|
+
const currentAgentId = this.agentId || candidate.data?.agentId;
|
|
886
|
+
|
|
887
|
+
return Boolean(
|
|
888
|
+
currentAgentId &&
|
|
889
|
+
(TaskManager.isParticipantActiveOnMainInteraction(candidate.data, currentAgentId) ||
|
|
890
|
+
incomingShowsCurrentAgentPromotion)
|
|
891
|
+
);
|
|
892
|
+
},
|
|
893
|
+
{includeCollectionKeys: true, includeMainCallMediaKeys: true}
|
|
894
|
+
);
|
|
895
|
+
ownerChangeResolvedByRelatedInteraction = Boolean(task);
|
|
896
|
+
}
|
|
897
|
+
|
|
898
|
+
let ownerChangeMainInteractionId: string | undefined;
|
|
899
|
+
if (task && eventType === CC_EVENTS.CONTACT_OWNER_CHANGED) {
|
|
900
|
+
const taskMainInteractionId = task.data?.interaction?.mainInteractionId;
|
|
901
|
+
const payloadMainInteractionId = message.data.interaction?.mainInteractionId;
|
|
902
|
+
const hasConflictingMainInteractionIds = Boolean(
|
|
903
|
+
taskMainInteractionId &&
|
|
904
|
+
payloadMainInteractionId &&
|
|
905
|
+
taskMainInteractionId !== payloadMainInteractionId
|
|
906
|
+
);
|
|
907
|
+
// A promoted child task can retain stale embedded IDs. Prefer the
|
|
908
|
+
// authoritative incoming main-call identity before local snapshot IDs.
|
|
909
|
+
const stableMainInteractionId =
|
|
910
|
+
payloadMainInteractionId ||
|
|
911
|
+
TaskManager.getMainCallMediaId(message.data.interaction) ||
|
|
912
|
+
TaskManager.getMainCallMediaId(task.data?.interaction) ||
|
|
913
|
+
taskMainInteractionId ||
|
|
914
|
+
message.data.interaction?.interactionId ||
|
|
915
|
+
task.data?.interaction?.interactionId ||
|
|
916
|
+
task.data?.interactionId;
|
|
917
|
+
const taskAtStableKey = stableMainInteractionId
|
|
918
|
+
? this.taskCollection[stableMainInteractionId]
|
|
919
|
+
: undefined;
|
|
920
|
+
|
|
921
|
+
if (
|
|
922
|
+
!stableMainInteractionId ||
|
|
923
|
+
hasConflictingMainInteractionIds ||
|
|
924
|
+
(taskAtStableKey && taskAtStableKey !== task)
|
|
925
|
+
) {
|
|
926
|
+
LoggerProxy.warn('Unable to safely correlate owner change to the main interaction task', {
|
|
927
|
+
module: TASK_MANAGER_FILE,
|
|
928
|
+
method: 'prepareEventContext',
|
|
929
|
+
interactionId:
|
|
930
|
+
payloadMainInteractionId || taskMainInteractionId || message.data.interactionId,
|
|
931
|
+
});
|
|
932
|
+
task = undefined;
|
|
933
|
+
} else if (ownerChangeResolvedByRelatedInteraction) {
|
|
934
|
+
ownerChangeMainInteractionId = stableMainInteractionId;
|
|
935
|
+
}
|
|
936
|
+
}
|
|
937
|
+
|
|
938
|
+
if (!task && MAIN_INTERACTION_CORRELATED_EVENTS.has(eventType)) {
|
|
939
|
+
task = this.findUniqueTaskByRelatedInteraction(message.data);
|
|
940
|
+
}
|
|
941
|
+
|
|
942
|
+
const wasConsultedTask = Boolean(task?.data?.isConsulted);
|
|
943
|
+
const computeWrapUpRequired = () => {
|
|
944
|
+
if (message.data.wrapUpRequired !== undefined) {
|
|
945
|
+
return message.data.wrapUpRequired;
|
|
946
|
+
}
|
|
947
|
+
if (message.data.isConsulted !== undefined) {
|
|
948
|
+
return !message.data.isConsulted;
|
|
949
|
+
}
|
|
950
|
+
|
|
951
|
+
return !wasConsultedTask;
|
|
952
|
+
};
|
|
953
|
+
|
|
954
|
+
let adjustedPayload: WebSocketPayload =
|
|
955
|
+
eventType === CC_EVENTS.AGENT_CONSULT_TRANSFERRED ||
|
|
956
|
+
eventType === CC_EVENTS.AGENT_BLIND_TRANSFERRED ||
|
|
957
|
+
eventType === CC_EVENTS.AGENT_VTEAM_TRANSFERRED
|
|
958
|
+
? {
|
|
959
|
+
...message.data,
|
|
960
|
+
wrapUpRequired: computeWrapUpRequired(),
|
|
961
|
+
}
|
|
962
|
+
: message.data;
|
|
963
|
+
|
|
964
|
+
if (task && ownerChangeMainInteractionId) {
|
|
965
|
+
adjustedPayload = {
|
|
966
|
+
...adjustedPayload,
|
|
967
|
+
interactionId: ownerChangeMainInteractionId,
|
|
968
|
+
};
|
|
969
|
+
}
|
|
970
|
+
|
|
971
|
+
if (task && eventType === CC_EVENTS.PARTICIPANT_LEFT_CONFERENCE) {
|
|
972
|
+
adjustedPayload = TaskManager.preserveConfirmedOwner(task, adjustedPayload);
|
|
973
|
+
}
|
|
974
|
+
|
|
975
|
+
if (WRAP_UP_STAMP_EVENTS.has(eventType)) {
|
|
976
|
+
adjustedPayload = TaskManager.stampWrapUpRequiredForEvent(
|
|
977
|
+
eventType,
|
|
978
|
+
adjustedPayload,
|
|
979
|
+
this.agentId,
|
|
980
|
+
task
|
|
981
|
+
);
|
|
982
|
+
}
|
|
983
|
+
|
|
984
|
+
const stateMachineEvent = TaskManager.mapEventToTaskStateMachineEvent(
|
|
985
|
+
eventType,
|
|
986
|
+
adjustedPayload,
|
|
987
|
+
this.agentId,
|
|
988
|
+
task,
|
|
989
|
+
this.configFlags?.enableWxBetterTogether
|
|
990
|
+
);
|
|
991
|
+
|
|
992
|
+
LoggerProxy.info(`Handling task event ${eventType}`, {
|
|
993
|
+
module: TASK_MANAGER_FILE,
|
|
994
|
+
method: 'prepareEventContext',
|
|
995
|
+
interactionId,
|
|
996
|
+
});
|
|
997
|
+
|
|
998
|
+
return {
|
|
999
|
+
eventType,
|
|
1000
|
+
payload: adjustedPayload,
|
|
1001
|
+
task,
|
|
1002
|
+
stateMachineEvent,
|
|
1003
|
+
};
|
|
1004
|
+
}
|
|
1005
|
+
|
|
1006
|
+
private static isParticipantActiveOnMainInteraction(
|
|
1007
|
+
taskData: TaskData | WebSocketPayload | undefined,
|
|
1008
|
+
participantId: string
|
|
1009
|
+
): boolean {
|
|
1010
|
+
const interaction = taskData?.interaction;
|
|
1011
|
+
const participant = interaction?.participants?.[participantId];
|
|
1012
|
+
if (!participant || participant.hasLeft === true) return false;
|
|
1013
|
+
|
|
1014
|
+
return Object.values(interaction?.media ?? {}).some(
|
|
1015
|
+
(media) =>
|
|
1016
|
+
media?.mType === MEDIA_TYPE_MAIN_CALL && media.participants?.includes(participantId)
|
|
1017
|
+
);
|
|
1018
|
+
}
|
|
1019
|
+
|
|
1020
|
+
private static getMainCallMediaId(
|
|
1021
|
+
interaction: TaskData['interaction'] | undefined
|
|
1022
|
+
): string | undefined {
|
|
1023
|
+
return Object.entries(interaction?.media ?? {}).find(
|
|
1024
|
+
([, media]) => media?.mType === MEDIA_TYPE_MAIN_CALL
|
|
1025
|
+
)?.[0];
|
|
1026
|
+
}
|
|
1027
|
+
|
|
1028
|
+
private static getStableMainInteractionId(payload: WebSocketPayload): string | undefined {
|
|
1029
|
+
return (
|
|
1030
|
+
payload.interaction?.mainInteractionId ||
|
|
1031
|
+
TaskManager.getMainCallMediaId(payload.interaction) ||
|
|
1032
|
+
payload.interaction?.interactionId ||
|
|
1033
|
+
payload.interactionId
|
|
1034
|
+
);
|
|
1035
|
+
}
|
|
1036
|
+
|
|
1037
|
+
private canRecoverTaskFromContactOwnerChanged(payload: WebSocketPayload): boolean {
|
|
1038
|
+
const interaction = payload.interaction;
|
|
1039
|
+
const stableInteractionId = TaskManager.getStableMainInteractionId(payload);
|
|
1040
|
+
|
|
1041
|
+
return Boolean(
|
|
1042
|
+
this.agentId &&
|
|
1043
|
+
stableInteractionId &&
|
|
1044
|
+
interaction?.mediaType === MEDIA_CHANNEL.TELEPHONY &&
|
|
1045
|
+
interaction.isTerminated !== true &&
|
|
1046
|
+
interaction.owner === this.agentId &&
|
|
1047
|
+
TaskManager.isParticipantActiveOnMainInteraction(payload, this.agentId)
|
|
1048
|
+
);
|
|
1049
|
+
}
|
|
1050
|
+
|
|
1051
|
+
/**
|
|
1052
|
+
* ParticipantLeftConference may arrive after an owner update while still carrying
|
|
1053
|
+
* the departed owner. Keep the confirmed owner only when the new roster proves that
|
|
1054
|
+
* owner is active on mainCall and identifies the incoming owner as departed.
|
|
1055
|
+
*/
|
|
1056
|
+
private static preserveConfirmedOwner(task: ITask, payload: WebSocketPayload): WebSocketPayload {
|
|
1057
|
+
const confirmedOwner = task.data?.interaction?.owner;
|
|
1058
|
+
const incomingOwner = payload.interaction?.owner;
|
|
1059
|
+
if (!confirmedOwner || !incomingOwner || confirmedOwner === incomingOwner) {
|
|
1060
|
+
return payload;
|
|
1061
|
+
}
|
|
1062
|
+
|
|
1063
|
+
const confirmedOwnerIsActive = TaskManager.isParticipantActiveOnMainInteraction(
|
|
1064
|
+
payload,
|
|
1065
|
+
confirmedOwner
|
|
1066
|
+
);
|
|
1067
|
+
const incomingOwnerIsExplicitlyDeparted =
|
|
1068
|
+
payload.participantId === incomingOwner ||
|
|
1069
|
+
payload.interaction?.participants?.[incomingOwner]?.hasLeft === true;
|
|
1070
|
+
|
|
1071
|
+
if (!confirmedOwnerIsActive || !incomingOwnerIsExplicitlyDeparted) {
|
|
1072
|
+
return payload;
|
|
1073
|
+
}
|
|
1074
|
+
|
|
1075
|
+
return {
|
|
1076
|
+
...payload,
|
|
1077
|
+
owner: confirmedOwner,
|
|
1078
|
+
interaction: {...payload.interaction, owner: confirmedOwner},
|
|
1079
|
+
};
|
|
1080
|
+
}
|
|
1081
|
+
|
|
1082
|
+
/**
|
|
1083
|
+
* Resolve lifecycle events that are emitted for the main interaction while the
|
|
1084
|
+
* local task can still be indexed by a child consult interaction. Exact task
|
|
1085
|
+
* keys are handled before this fallback. Multiple aliases of the same task are
|
|
1086
|
+
* treated as one candidate; genuinely ambiguous matches are intentionally ignored.
|
|
1087
|
+
*/
|
|
1088
|
+
private findUniqueTaskByRelatedInteraction(
|
|
1089
|
+
payload: WebSocketPayload,
|
|
1090
|
+
candidateFilter: (task: ITask) => boolean = () => true,
|
|
1091
|
+
options: {includeCollectionKeys?: boolean; includeMainCallMediaKeys?: boolean} = {}
|
|
1092
|
+
): ITask | undefined {
|
|
1093
|
+
const candidates = this.findRelatedTasks(payload, options).filter(candidateFilter);
|
|
1094
|
+
|
|
1095
|
+
if (candidates.length === 1) {
|
|
1096
|
+
return candidates[0];
|
|
1097
|
+
}
|
|
1098
|
+
|
|
1099
|
+
if (candidates.length > 1) {
|
|
1100
|
+
LoggerProxy.warn('Unable to correlate task event to a unique main interaction task', {
|
|
627
1101
|
module: TASK_MANAGER_FILE,
|
|
628
|
-
method:
|
|
629
|
-
interactionId:
|
|
1102
|
+
method: 'findUniqueTaskByRelatedInteraction',
|
|
1103
|
+
interactionId:
|
|
1104
|
+
payload.interaction?.mainInteractionId ||
|
|
1105
|
+
payload.interaction?.parentInteractionId ||
|
|
1106
|
+
payload.interaction?.callProcessingDetails?.parentInteractionId ||
|
|
1107
|
+
payload.interactionId,
|
|
630
1108
|
});
|
|
631
|
-
|
|
632
|
-
|
|
633
|
-
|
|
634
|
-
|
|
635
|
-
|
|
1109
|
+
}
|
|
1110
|
+
|
|
1111
|
+
return undefined;
|
|
1112
|
+
}
|
|
1113
|
+
|
|
1114
|
+
private findRelatedTasks(
|
|
1115
|
+
payload: WebSocketPayload,
|
|
1116
|
+
options: {includeCollectionKeys?: boolean; includeMainCallMediaKeys?: boolean} = {}
|
|
1117
|
+
): ITask[] {
|
|
1118
|
+
const {includeCollectionKeys = false, includeMainCallMediaKeys = false} = options;
|
|
1119
|
+
const payloadInteractionIds = new Set(
|
|
1120
|
+
[
|
|
1121
|
+
payload.interactionId,
|
|
1122
|
+
payload.interaction?.interactionId,
|
|
1123
|
+
payload.interaction?.mainInteractionId,
|
|
1124
|
+
payload.interaction?.parentInteractionId,
|
|
1125
|
+
payload.interaction?.callProcessingDetails?.parentInteractionId,
|
|
1126
|
+
...(includeMainCallMediaKeys ? [TaskManager.getMainCallMediaId(payload.interaction)] : []),
|
|
1127
|
+
].filter((relatedInteractionId): relatedInteractionId is string =>
|
|
1128
|
+
Boolean(relatedInteractionId)
|
|
1129
|
+
)
|
|
1130
|
+
);
|
|
1131
|
+
if (payloadInteractionIds.size === 0) return [];
|
|
1132
|
+
|
|
1133
|
+
return [
|
|
1134
|
+
...new Set(
|
|
1135
|
+
Object.entries(this.taskCollection)
|
|
1136
|
+
.filter(([taskId, candidate]) => {
|
|
1137
|
+
const taskInteraction = candidate?.data?.interaction;
|
|
1138
|
+
const candidateInteractionIds = [
|
|
1139
|
+
...(includeCollectionKeys ? [taskId] : []),
|
|
1140
|
+
candidate?.data?.interactionId,
|
|
1141
|
+
taskInteraction?.interactionId,
|
|
1142
|
+
taskInteraction?.mainInteractionId,
|
|
1143
|
+
taskInteraction?.parentInteractionId,
|
|
1144
|
+
taskInteraction?.callProcessingDetails?.parentInteractionId,
|
|
1145
|
+
...(includeMainCallMediaKeys
|
|
1146
|
+
? [TaskManager.getMainCallMediaId(taskInteraction)]
|
|
1147
|
+
: []),
|
|
1148
|
+
];
|
|
1149
|
+
|
|
1150
|
+
return candidateInteractionIds.some(
|
|
1151
|
+
(relatedInteractionId) =>
|
|
1152
|
+
Boolean(relatedInteractionId) && payloadInteractionIds.has(relatedInteractionId)
|
|
1153
|
+
);
|
|
1154
|
+
})
|
|
1155
|
+
.map(([, candidate]) => candidate)
|
|
1156
|
+
),
|
|
1157
|
+
];
|
|
1158
|
+
}
|
|
1159
|
+
|
|
1160
|
+
/**
|
|
1161
|
+
* Handle task lifecycle events and determine required actions
|
|
1162
|
+
*
|
|
1163
|
+
* Delegates to specific event handlers based on event type. Each handler
|
|
1164
|
+
* is responsible for TaskManager-level concerns:
|
|
1165
|
+
* - Task creation and collection management
|
|
1166
|
+
* - Metrics tracking
|
|
1167
|
+
* - Resource cleanup decisions
|
|
1168
|
+
*
|
|
1169
|
+
* Note: Task-level state transitions and event emissions are handled by
|
|
1170
|
+
* the task state machine via sendStateMachineEvent()
|
|
1171
|
+
*/
|
|
1172
|
+
private handleTaskLifecycleEvent(context: EventContext): TaskEventActions {
|
|
1173
|
+
const {eventType} = context;
|
|
1174
|
+
|
|
1175
|
+
switch (eventType) {
|
|
1176
|
+
case CC_EVENTS.AGENT_CONTACT_RESERVED:
|
|
1177
|
+
return this.handleContactReserved(context);
|
|
1178
|
+
|
|
1179
|
+
case CC_EVENTS.AGENT_CONTACT:
|
|
1180
|
+
return this.handleAgentContact(context);
|
|
1181
|
+
|
|
1182
|
+
case CC_EVENTS.CONTACT_MERGED:
|
|
1183
|
+
return this.handleContactMergedEvent(context);
|
|
1184
|
+
|
|
1185
|
+
case CC_EVENTS.CONTACT_OWNER_CHANGED:
|
|
1186
|
+
return this.handleContactOwnerChanged(context);
|
|
1187
|
+
|
|
1188
|
+
case CC_EVENTS.AGENT_OFFER_CAMPAIGN_RESERVATION:
|
|
1189
|
+
return this.handleCampaignPreviewReservation(context);
|
|
1190
|
+
|
|
1191
|
+
case CC_EVENTS.CAMPAIGN_CONTACT_UPDATED:
|
|
1192
|
+
return this.handleCampaignContactUpdated(context);
|
|
1193
|
+
|
|
1194
|
+
default:
|
|
1195
|
+
return {task: context.task};
|
|
1196
|
+
}
|
|
1197
|
+
}
|
|
1198
|
+
|
|
1199
|
+
/**
|
|
1200
|
+
* Recover the promoted agent's active voice task when local task state was lost.
|
|
1201
|
+
* Existing related tasks are never replaced: an unresolved or ambiguous relation
|
|
1202
|
+
* is safer to ignore than to create a duplicate task.
|
|
1203
|
+
*/
|
|
1204
|
+
private handleContactOwnerChanged(context: EventContext): TaskEventActions {
|
|
1205
|
+
if (context.task) {
|
|
1206
|
+
return {task: context.task};
|
|
1207
|
+
}
|
|
1208
|
+
|
|
1209
|
+
const {payload} = context;
|
|
1210
|
+
if (
|
|
1211
|
+
this.findRelatedTasks(payload, {
|
|
1212
|
+
includeCollectionKeys: true,
|
|
1213
|
+
includeMainCallMediaKeys: true,
|
|
1214
|
+
}).length > 0 ||
|
|
1215
|
+
!this.canRecoverTaskFromContactOwnerChanged(payload)
|
|
1216
|
+
) {
|
|
1217
|
+
return {};
|
|
1218
|
+
}
|
|
1219
|
+
|
|
1220
|
+
const stableInteractionId = TaskManager.getStableMainInteractionId(payload);
|
|
1221
|
+
if (!stableInteractionId || this.taskCollection[stableInteractionId]) {
|
|
1222
|
+
return {};
|
|
1223
|
+
}
|
|
1224
|
+
|
|
1225
|
+
const normalizedPayload: WebSocketPayload =
|
|
1226
|
+
payload.interactionId === stableInteractionId
|
|
1227
|
+
? payload
|
|
1228
|
+
: {...payload, interactionId: stableInteractionId};
|
|
1229
|
+
const taskData: TaskData = {
|
|
1230
|
+
...normalizedPayload,
|
|
1231
|
+
owner: normalizedPayload.interaction.owner,
|
|
1232
|
+
wrapUpRequired: normalizedPayload.interaction.participants?.[this.agentId]?.isWrapUp || false,
|
|
1233
|
+
isConferenceInProgress: getIsConferenceInProgress(normalizedPayload),
|
|
1234
|
+
isConsulted: false,
|
|
1235
|
+
isAutoAnswering: false,
|
|
1236
|
+
};
|
|
1237
|
+
const task = TaskFactory.createTask(
|
|
1238
|
+
this.contact,
|
|
1239
|
+
this.webCallingService,
|
|
1240
|
+
taskData,
|
|
1241
|
+
this.configFlags,
|
|
1242
|
+
this.wrapupData,
|
|
1243
|
+
this.agentId,
|
|
1244
|
+
this.agentName,
|
|
1245
|
+
this.answerCallOnWebexService,
|
|
1246
|
+
this.apiAIAssistant
|
|
1247
|
+
);
|
|
1248
|
+
|
|
1249
|
+
this.taskCollection[stableInteractionId] = task;
|
|
1250
|
+
|
|
1251
|
+
// Restore the actor before installing listeners so the internal hydrate does
|
|
1252
|
+
// not leak as a second public hydrate or as an incoming-task notification.
|
|
1253
|
+
task.sendStateMachineEvent({
|
|
1254
|
+
type: TaskEvent.HYDRATE,
|
|
1255
|
+
taskData,
|
|
1256
|
+
agentId: this.agentId,
|
|
1257
|
+
} as TaskEventPayload);
|
|
1258
|
+
|
|
1259
|
+
this.setupTaskListeners(task);
|
|
1260
|
+
context.payload = taskData;
|
|
1261
|
+
context.stateMachineEvent = {
|
|
1262
|
+
type: TaskEvent.CONTACT_OWNER_CHANGED,
|
|
1263
|
+
taskData,
|
|
1264
|
+
};
|
|
1265
|
+
|
|
1266
|
+
return {task};
|
|
1267
|
+
}
|
|
1268
|
+
|
|
1269
|
+
private handleCampaignContactUpdated(context: EventContext) {
|
|
1270
|
+
const {payload} = context;
|
|
1271
|
+
let {task} = context;
|
|
1272
|
+
// CampaignContactUpdated is a non-terminal event (e.g., next contact after skip/remove).
|
|
1273
|
+
// Update the task data and emit an event so consumers can react to the updated contact.
|
|
1274
|
+
// Do NOT remove the task or emit TASK_END — cleanup is handled by CONTACT_ENDED.
|
|
1275
|
+
if (task) {
|
|
1276
|
+
// Carry forward campaign preview fields from existing task data since the updated
|
|
1277
|
+
// contact payload may not include them, and reconcileData would delete them.
|
|
1278
|
+
const existingCpd = task.data?.interaction?.callProcessingDetails;
|
|
1279
|
+
const updatedData: TaskData = {...payload};
|
|
1280
|
+
|
|
1281
|
+
if (existingCpd) {
|
|
1282
|
+
const campaignFields = {
|
|
1283
|
+
...(existingCpd.campaignPreviewAutoAction && {
|
|
1284
|
+
campaignPreviewAutoAction: existingCpd.campaignPreviewAutoAction,
|
|
1285
|
+
}),
|
|
1286
|
+
...(existingCpd.campaignPreviewOfferTimeout && {
|
|
1287
|
+
campaignPreviewOfferTimeout: existingCpd.campaignPreviewOfferTimeout,
|
|
1288
|
+
}),
|
|
1289
|
+
...(existingCpd.campaignPreviewSkipDisabled && {
|
|
1290
|
+
campaignPreviewSkipDisabled: existingCpd.campaignPreviewSkipDisabled,
|
|
1291
|
+
}),
|
|
1292
|
+
...(existingCpd.campaignPreviewRemoveDisabled && {
|
|
1293
|
+
campaignPreviewRemoveDisabled: existingCpd.campaignPreviewRemoveDisabled,
|
|
1294
|
+
}),
|
|
1295
|
+
};
|
|
1296
|
+
|
|
1297
|
+
if (!updatedData.interaction) {
|
|
1298
|
+
updatedData.interaction = {} as typeof updatedData.interaction;
|
|
1299
|
+
}
|
|
1300
|
+
|
|
1301
|
+
updatedData.interaction = {
|
|
1302
|
+
...updatedData.interaction,
|
|
1303
|
+
callProcessingDetails: {
|
|
1304
|
+
...campaignFields,
|
|
1305
|
+
...(updatedData.interaction.callProcessingDetails || {}),
|
|
1306
|
+
} as typeof existingCpd,
|
|
1307
|
+
};
|
|
1308
|
+
}
|
|
1309
|
+
|
|
1310
|
+
LoggerProxy.log('Campaign contact updated - carrying forward preview fields', {
|
|
636
1311
|
module: TASK_MANAGER_FILE,
|
|
637
1312
|
method: METHODS.REGISTER_TASK_LISTENERS,
|
|
638
|
-
interactionId:
|
|
1313
|
+
interactionId: payload.interactionId,
|
|
1314
|
+
data: {
|
|
1315
|
+
hasCpd: !!updatedData.interaction?.callProcessingDetails,
|
|
1316
|
+
autoAction: updatedData.interaction?.callProcessingDetails?.campaignPreviewAutoAction,
|
|
1317
|
+
skipDisabled: updatedData.interaction?.callProcessingDetails?.campaignPreviewSkipDisabled,
|
|
1318
|
+
removeDisabled:
|
|
1319
|
+
updatedData.interaction?.callProcessingDetails?.campaignPreviewRemoveDisabled,
|
|
1320
|
+
},
|
|
639
1321
|
});
|
|
640
1322
|
|
|
641
|
-
task =
|
|
1323
|
+
task = this.updateTaskData(task, updatedData);
|
|
1324
|
+
task.emit(TASK_EVENTS.TASK_CAMPAIGN_CONTACT_UPDATED, task);
|
|
1325
|
+
}
|
|
1326
|
+
|
|
1327
|
+
return {task};
|
|
1328
|
+
}
|
|
1329
|
+
|
|
1330
|
+
/**
|
|
1331
|
+
* Creates or updates a task for campaign preview reservation.
|
|
1332
|
+
* TASK_CAMPAIGN_PREVIEW_RESERVATION is emitted by the state machine (campaign TASK_INCOMING branch).
|
|
1333
|
+
*/
|
|
1334
|
+
private handleCampaignPreviewReservation(context: EventContext): TaskEventActions {
|
|
1335
|
+
const {payload} = context;
|
|
1336
|
+
let {task} = context;
|
|
1337
|
+
|
|
1338
|
+
LoggerProxy.log('Campaign preview reservation received', {
|
|
1339
|
+
module: TASK_MANAGER_FILE,
|
|
1340
|
+
method: METHODS.REGISTER_TASK_LISTENERS,
|
|
1341
|
+
interactionId: payload.interactionId,
|
|
1342
|
+
});
|
|
1343
|
+
|
|
1344
|
+
if (!task) {
|
|
1345
|
+
task = TaskFactory.createTask(
|
|
642
1346
|
this.contact,
|
|
643
1347
|
this.webCallingService,
|
|
644
1348
|
{
|
|
645
|
-
...
|
|
646
|
-
wrapUpRequired:
|
|
647
|
-
isConferenceInProgress:
|
|
1349
|
+
...payload,
|
|
1350
|
+
wrapUpRequired: false,
|
|
1351
|
+
isConferenceInProgress: false,
|
|
1352
|
+
isAutoAnswering: false,
|
|
648
1353
|
},
|
|
1354
|
+
this.configFlags,
|
|
649
1355
|
this.wrapupData,
|
|
650
|
-
this.agentId
|
|
1356
|
+
this.agentId,
|
|
1357
|
+
this.agentName,
|
|
1358
|
+
this.answerCallOnWebexService,
|
|
1359
|
+
this.apiAIAssistant
|
|
651
1360
|
);
|
|
652
|
-
this.
|
|
1361
|
+
this.setupTaskListeners(task);
|
|
1362
|
+
this.taskCollection[payload.interactionId] = task;
|
|
1363
|
+
} else {
|
|
1364
|
+
task = this.updateTaskData(task, payload);
|
|
653
1365
|
}
|
|
654
1366
|
|
|
655
|
-
|
|
1367
|
+
return {task};
|
|
1368
|
+
}
|
|
1369
|
+
|
|
1370
|
+
/**
|
|
1371
|
+
* Handle AGENT_CONTACT_RESERVED event
|
|
1372
|
+
* Creates a new task; state machine event is sent during processing
|
|
1373
|
+
*/
|
|
1374
|
+
private handleContactReserved(context: EventContext): TaskEventActions {
|
|
1375
|
+
const {payload} = context;
|
|
1376
|
+
const isConsultedTask =
|
|
1377
|
+
payload.isConsulted === true || isSecondaryEpDnAgent(payload.interaction);
|
|
1378
|
+
const shouldAutoAnswer = shouldAutoAnswerTask(
|
|
1379
|
+
payload,
|
|
1380
|
+
this.agentId,
|
|
1381
|
+
this.webCallingService.loginOption,
|
|
1382
|
+
this.webRtcEnabled
|
|
1383
|
+
);
|
|
1384
|
+
|
|
1385
|
+
const taskData: TaskData = {
|
|
1386
|
+
...payload,
|
|
1387
|
+
isConsulted: isConsultedTask,
|
|
1388
|
+
isAutoAnswering: shouldAutoAnswer,
|
|
1389
|
+
};
|
|
1390
|
+
|
|
1391
|
+
const task = TaskFactory.createTask(
|
|
1392
|
+
this.contact,
|
|
1393
|
+
this.webCallingService,
|
|
1394
|
+
taskData,
|
|
1395
|
+
this.configFlags,
|
|
1396
|
+
this.wrapupData,
|
|
1397
|
+
this.agentId,
|
|
1398
|
+
this.agentName,
|
|
1399
|
+
this.answerCallOnWebexService,
|
|
1400
|
+
this.apiAIAssistant
|
|
1401
|
+
);
|
|
1402
|
+
|
|
1403
|
+
this.setupTaskListeners(task);
|
|
1404
|
+
this.taskCollection[payload.interactionId] = task;
|
|
1405
|
+
|
|
1406
|
+
return {task};
|
|
1407
|
+
}
|
|
1408
|
+
|
|
1409
|
+
/**
|
|
1410
|
+
* Handle AGENT_CONTACT event
|
|
1411
|
+
* Re-creates task if missing (multi-session scenario)
|
|
1412
|
+
*/
|
|
1413
|
+
private handleAgentContact(context: EventContext): TaskEventActions {
|
|
1414
|
+
let {task} = context;
|
|
1415
|
+
const {payload} = context;
|
|
1416
|
+
|
|
1417
|
+
if (!task) {
|
|
1418
|
+
const isConsultedTask =
|
|
1419
|
+
payload.isConsulted === true || isSecondaryEpDnAgent(payload.interaction);
|
|
1420
|
+
const shouldAutoAnswer = shouldAutoAnswerTask(
|
|
1421
|
+
payload,
|
|
1422
|
+
this.agentId,
|
|
1423
|
+
this.webCallingService.loginOption,
|
|
1424
|
+
this.webRtcEnabled
|
|
1425
|
+
);
|
|
1426
|
+
const taskData: TaskData = {
|
|
1427
|
+
...payload,
|
|
1428
|
+
isConsulted: isConsultedTask,
|
|
1429
|
+
wrapUpRequired: payload.interaction?.participants?.[this.agentId]?.isWrapUp || false,
|
|
1430
|
+
isConferenceInProgress: getIsConferenceInProgress(payload),
|
|
1431
|
+
isAutoAnswering: shouldAutoAnswer,
|
|
1432
|
+
};
|
|
1433
|
+
|
|
1434
|
+
task = TaskFactory.createTask(
|
|
1435
|
+
this.contact,
|
|
1436
|
+
this.webCallingService,
|
|
1437
|
+
taskData,
|
|
1438
|
+
this.configFlags,
|
|
1439
|
+
this.wrapupData,
|
|
1440
|
+
this.agentId,
|
|
1441
|
+
this.agentName,
|
|
1442
|
+
this.answerCallOnWebexService,
|
|
1443
|
+
this.apiAIAssistant
|
|
1444
|
+
);
|
|
1445
|
+
this.setupTaskListeners(task);
|
|
1446
|
+
this.taskCollection[payload.interactionId] = task;
|
|
1447
|
+
}
|
|
1448
|
+
|
|
1449
|
+
return {task};
|
|
1450
|
+
}
|
|
1451
|
+
|
|
1452
|
+
private updateTaskData(task: ITask, taskData: TaskData): ITask {
|
|
1453
|
+
if (!task) {
|
|
1454
|
+
throw new Error('Task not found for update');
|
|
1455
|
+
}
|
|
1456
|
+
|
|
1457
|
+
const snapshot = task.stateMachineService?.getSnapshot?.();
|
|
1458
|
+
const isConsultingFlow =
|
|
1459
|
+
snapshot?.value === 'CONSULTING' || taskData.interaction?.state === 'consulting';
|
|
1460
|
+
|
|
1461
|
+
const updateTaskData = isConsultingFlow
|
|
1462
|
+
? {
|
|
1463
|
+
...taskData,
|
|
1464
|
+
destAgentId: taskData.destAgentId ?? snapshot?.context?.consultDestinationAgentId ?? null,
|
|
1465
|
+
destinationType:
|
|
1466
|
+
taskData.destinationType ?? snapshot?.context?.consultDestinationType ?? null,
|
|
1467
|
+
}
|
|
1468
|
+
: taskData;
|
|
1469
|
+
|
|
1470
|
+
task.updateTaskData(updateTaskData);
|
|
1471
|
+
|
|
1472
|
+
// A main-interaction lifecycle event can re-key a child consult task. Remove
|
|
1473
|
+
// any aliases first so consumers never observe duplicate task entries.
|
|
1474
|
+
Object.entries(this.taskCollection).forEach(([taskId, candidate]) => {
|
|
1475
|
+
if (candidate === task && taskId !== taskData.interactionId) {
|
|
1476
|
+
delete this.taskCollection[taskId];
|
|
1477
|
+
}
|
|
1478
|
+
});
|
|
1479
|
+
this.taskCollection[taskData.interactionId] = task;
|
|
1480
|
+
const enablement = this.pendingFeatureEnablement.get(task.data.interactionId);
|
|
1481
|
+
if (enablement) {
|
|
1482
|
+
task.setFeatureEnablement?.(enablement);
|
|
1483
|
+
}
|
|
656
1484
|
|
|
657
1485
|
return task;
|
|
658
1486
|
}
|
|
659
1487
|
|
|
1488
|
+
/**
|
|
1489
|
+
* Setup listeners for task events that need to be bubbled up to TaskManager
|
|
1490
|
+
* This replaces the previous callback injection pattern
|
|
1491
|
+
*/
|
|
1492
|
+
private setupTaskListeners(task: ITask): void {
|
|
1493
|
+
// Apply flags before publication; retain the frame until consumers can attach listeners.
|
|
1494
|
+
const enablement = this.pendingFeatureEnablement.get(task.data.interactionId);
|
|
1495
|
+
if (enablement) {
|
|
1496
|
+
task.setFeatureEnablement?.(enablement);
|
|
1497
|
+
}
|
|
1498
|
+
|
|
1499
|
+
[
|
|
1500
|
+
TASK_EVENTS.TASK_INCOMING,
|
|
1501
|
+
TASK_EVENTS.TASK_CAMPAIGN_PREVIEW_RESERVATION,
|
|
1502
|
+
TASK_EVENTS.TASK_HYDRATE,
|
|
1503
|
+
TASK_EVENTS.TASK_ASSIGNED,
|
|
1504
|
+
].forEach((eventName) => {
|
|
1505
|
+
task.on(eventName, (t: ITask) => {
|
|
1506
|
+
if (
|
|
1507
|
+
eventName === TASK_EVENTS.TASK_INCOMING ||
|
|
1508
|
+
eventName === TASK_EVENTS.TASK_CAMPAIGN_PREVIEW_RESERVATION
|
|
1509
|
+
) {
|
|
1510
|
+
LoggerProxy.log(
|
|
1511
|
+
eventName === TASK_EVENTS.TASK_INCOMING
|
|
1512
|
+
? 'Task incoming event received'
|
|
1513
|
+
: 'Campaign preview reservation event received',
|
|
1514
|
+
{
|
|
1515
|
+
module: TASK_MANAGER_FILE,
|
|
1516
|
+
method: METHODS.REGISTER_TASK_LISTENERS,
|
|
1517
|
+
interactionId: t.data?.interactionId,
|
|
1518
|
+
}
|
|
1519
|
+
);
|
|
1520
|
+
}
|
|
1521
|
+
|
|
1522
|
+
// Assignment is already emitted on the task; the other events publish it to consumers.
|
|
1523
|
+
if (eventName !== TASK_EVENTS.TASK_ASSIGNED) {
|
|
1524
|
+
this.emit(eventName, t);
|
|
1525
|
+
}
|
|
1526
|
+
|
|
1527
|
+
const pendingEnablement = this.pendingFeatureEnablement.get(task.data.interactionId);
|
|
1528
|
+
if (pendingEnablement) {
|
|
1529
|
+
this.pendingFeatureEnablement.delete(task.data.interactionId);
|
|
1530
|
+
task.emit(TASK_EVENTS.TASK_FEATURE_ENABLEMENT, pendingEnablement);
|
|
1531
|
+
}
|
|
1532
|
+
});
|
|
1533
|
+
});
|
|
1534
|
+
|
|
1535
|
+
task.on(TASK_EVENTS.TASK_MULTI_LOGIN_HYDRATE, (t: ITask) => {
|
|
1536
|
+
this.emit(TASK_EVENTS.TASK_MULTI_LOGIN_HYDRATE, t);
|
|
1537
|
+
});
|
|
1538
|
+
|
|
1539
|
+
// Listen for internal cleanup signal emitted by the state machine
|
|
1540
|
+
task.on(TASK_EVENTS.TASK_CLEANUP, (t: ITask, options?: {removeFromCollection?: boolean}) => {
|
|
1541
|
+
this.handleTaskCleanup(t);
|
|
1542
|
+
if (options?.removeFromCollection) {
|
|
1543
|
+
const taskIsStillCollected = Object.values(this.taskCollection).some(
|
|
1544
|
+
(candidate) => candidate === t
|
|
1545
|
+
);
|
|
1546
|
+
if (taskIsStillCollected) {
|
|
1547
|
+
this.removeTaskFromCollection(t);
|
|
1548
|
+
}
|
|
1549
|
+
}
|
|
1550
|
+
});
|
|
1551
|
+
}
|
|
1552
|
+
|
|
660
1553
|
private removeTaskFromCollection(task: ITask) {
|
|
1554
|
+
task.clearFeatureEnablement?.();
|
|
1555
|
+
task.disposeWxAppOfferObservability?.();
|
|
1556
|
+
if (typeof task.cancelAutoWrapupTimer === 'function') {
|
|
1557
|
+
task.cancelAutoWrapupTimer();
|
|
1558
|
+
}
|
|
661
1559
|
if (task?.data?.interactionId) {
|
|
662
|
-
|
|
1560
|
+
this.pendingFeatureEnablement.delete(task.data.interactionId);
|
|
1561
|
+
// An offer that ends unanswered (RONA, declined, consult cancelled) is removed here,
|
|
1562
|
+
// so its held receiving summary is dropped instead of being emitted.
|
|
1563
|
+
this.receivingSummaryBuffer.delete(task.data.interactionId);
|
|
1564
|
+
Object.entries(this.taskCollection).forEach(([taskId, candidate]) => {
|
|
1565
|
+
if (candidate === task) {
|
|
1566
|
+
delete this.taskCollection[taskId];
|
|
1567
|
+
}
|
|
1568
|
+
});
|
|
663
1569
|
LoggerProxy.info(`Task removed from collection`, {
|
|
664
1570
|
module: TASK_MANAGER_FILE,
|
|
665
1571
|
method: METHODS.REMOVE_TASK_FROM_COLLECTION,
|
|
@@ -669,69 +1575,80 @@ export default class TaskManager extends EventEmitter {
|
|
|
669
1575
|
}
|
|
670
1576
|
|
|
671
1577
|
/**
|
|
672
|
-
* Handles
|
|
673
|
-
*
|
|
674
|
-
*
|
|
675
|
-
*
|
|
676
|
-
* 2. Agent-initiated WebRTC outdial calls
|
|
677
|
-
* 3. Agent-initiated digital outbound (Email/SMS) without previous transfers
|
|
678
|
-
*
|
|
679
|
-
* @param task - The task to auto-answer
|
|
1578
|
+
* Handles CONTACT_MERGED event logic
|
|
1579
|
+
* @param task - The task to process
|
|
1580
|
+
* @param taskData - The task data from the event payload
|
|
1581
|
+
* @returns Updated or newly created task
|
|
680
1582
|
* @private
|
|
681
1583
|
*/
|
|
682
|
-
private
|
|
683
|
-
|
|
684
|
-
|
|
685
|
-
}
|
|
1584
|
+
private handleContactMergedEvent(context: EventContext): TaskEventActions {
|
|
1585
|
+
const {payload} = context;
|
|
1586
|
+
let task = context.task;
|
|
686
1587
|
|
|
687
|
-
|
|
688
|
-
|
|
689
|
-
|
|
690
|
-
interactionId: task.data.interactionId,
|
|
691
|
-
});
|
|
1588
|
+
if (payload.childInteractionId && this.taskCollection[payload.childInteractionId]) {
|
|
1589
|
+
this.removeTaskFromCollection(this.taskCollection[payload.childInteractionId]);
|
|
1590
|
+
}
|
|
692
1591
|
|
|
693
|
-
|
|
694
|
-
|
|
695
|
-
LoggerProxy.info(`Task auto-answered successfully`, {
|
|
1592
|
+
if (task) {
|
|
1593
|
+
LoggerProxy.log(`Got CONTACT_MERGED: Task already exists in collection`, {
|
|
696
1594
|
module: TASK_MANAGER_FILE,
|
|
697
|
-
method:
|
|
698
|
-
interactionId:
|
|
1595
|
+
method: METHODS.REGISTER_TASK_LISTENERS,
|
|
1596
|
+
interactionId: payload.interactionId,
|
|
699
1597
|
});
|
|
700
|
-
|
|
701
|
-
|
|
702
|
-
|
|
703
|
-
|
|
704
|
-
|
|
705
|
-
taskId: task.data.interactionId,
|
|
706
|
-
mediaType: task.data.interaction.mediaType,
|
|
707
|
-
isAutoAnswered: true,
|
|
708
|
-
},
|
|
709
|
-
['behavioral', 'operational']
|
|
710
|
-
);
|
|
711
|
-
// Emit task:autoAnswered event for widgets/UI to react
|
|
712
|
-
task.emit(TASK_EVENTS.TASK_AUTO_ANSWERED, task);
|
|
713
|
-
} catch (error) {
|
|
714
|
-
// Reset isAutoAnswering flag on failure
|
|
715
|
-
task.updateTaskData({...task.data, isAutoAnswering: false});
|
|
716
|
-
LoggerProxy.error(`Failed to auto-answer task`, {
|
|
1598
|
+
// update the task data
|
|
1599
|
+
this.updateTaskData(task, payload);
|
|
1600
|
+
} else {
|
|
1601
|
+
// Case2 : Task is not present in taskCollection
|
|
1602
|
+
LoggerProxy.log(`Got CONTACT_MERGED : Creating new task in taskManager`, {
|
|
717
1603
|
module: TASK_MANAGER_FILE,
|
|
718
|
-
method:
|
|
719
|
-
interactionId:
|
|
720
|
-
error,
|
|
1604
|
+
method: METHODS.REGISTER_TASK_LISTENERS,
|
|
1605
|
+
interactionId: payload.interactionId,
|
|
721
1606
|
});
|
|
722
1607
|
|
|
723
|
-
|
|
724
|
-
|
|
725
|
-
|
|
726
|
-
|
|
727
|
-
|
|
728
|
-
|
|
729
|
-
|
|
730
|
-
|
|
731
|
-
|
|
732
|
-
|
|
1608
|
+
const taskData: TaskData = {
|
|
1609
|
+
...payload,
|
|
1610
|
+
wrapUpRequired: payload.interaction?.participants?.[this.agentId]?.isWrapUp || false,
|
|
1611
|
+
isConferenceInProgress: getIsConferenceInProgress(payload),
|
|
1612
|
+
isConsulted: false,
|
|
1613
|
+
};
|
|
1614
|
+
|
|
1615
|
+
task = TaskFactory.createTask(
|
|
1616
|
+
this.contact,
|
|
1617
|
+
this.webCallingService,
|
|
1618
|
+
taskData,
|
|
1619
|
+
this.configFlags,
|
|
1620
|
+
this.wrapupData,
|
|
1621
|
+
this.agentId,
|
|
1622
|
+
this.agentName,
|
|
1623
|
+
this.answerCallOnWebexService,
|
|
1624
|
+
this.apiAIAssistant
|
|
733
1625
|
);
|
|
1626
|
+
this.taskCollection[payload.interactionId] = task;
|
|
1627
|
+
|
|
1628
|
+
// Transition the new task out of IDLE immediately so UI controls are
|
|
1629
|
+
// computed before TASK_MERGED is emitted. This handles the race where
|
|
1630
|
+
// AgentContactAssigned arrives before ContactMerged and gets dropped.
|
|
1631
|
+
// Send HYDRATE before setupTaskListeners so the emitTaskHydrate action
|
|
1632
|
+
// doesn't bubble up to the Widget (avoids duplicate listener registration).
|
|
1633
|
+
task.sendStateMachineEvent({
|
|
1634
|
+
type: TaskEvent.HYDRATE,
|
|
1635
|
+
taskData,
|
|
1636
|
+
agentId: this.agentId,
|
|
1637
|
+
} as TaskEventPayload);
|
|
1638
|
+
|
|
1639
|
+
this.setupTaskListeners(task);
|
|
734
1640
|
}
|
|
1641
|
+
|
|
1642
|
+
if (task) {
|
|
1643
|
+
this.emit(TASK_EVENTS.TASK_MERGED, task);
|
|
1644
|
+
const enablement = this.pendingFeatureEnablement.get(task.data.interactionId);
|
|
1645
|
+
if (enablement) {
|
|
1646
|
+
this.pendingFeatureEnablement.delete(task.data.interactionId);
|
|
1647
|
+
task.emit(TASK_EVENTS.TASK_FEATURE_ENABLEMENT, enablement);
|
|
1648
|
+
}
|
|
1649
|
+
}
|
|
1650
|
+
|
|
1651
|
+
return {task};
|
|
735
1652
|
}
|
|
736
1653
|
|
|
737
1654
|
/**
|
|
@@ -743,7 +1660,8 @@ export default class TaskManager extends EventEmitter {
|
|
|
743
1660
|
// Clean up Desktop/WebRTC calling resources for browser-based telephony tasks
|
|
744
1661
|
if (
|
|
745
1662
|
this.webCallingService.loginOption === LoginOption.BROWSER &&
|
|
746
|
-
task.data.interaction.mediaType ===
|
|
1663
|
+
task.data.interaction.mediaType === MEDIA_CHANNEL.TELEPHONY &&
|
|
1664
|
+
task instanceof WebRTC
|
|
747
1665
|
) {
|
|
748
1666
|
task.unregisterWebCallListeners();
|
|
749
1667
|
this.webCallingService.cleanUpCall();
|
|
@@ -771,12 +1689,8 @@ export default class TaskManager extends EventEmitter {
|
|
|
771
1689
|
*/
|
|
772
1690
|
private requestRealTimeTranscripts(eventType: string, interactionId: string): void {
|
|
773
1691
|
const action = TRANSCRIPT_EVENT_MAP[eventType];
|
|
774
|
-
if (
|
|
775
|
-
|
|
776
|
-
!this.apiAIAssistant ||
|
|
777
|
-
this.apiAIAssistant.aiFeature?.realtimeTranscripts?.enable === false
|
|
778
|
-
)
|
|
779
|
-
return;
|
|
1692
|
+
if (!action || !this.apiAIAssistant) return;
|
|
1693
|
+
if (this.configFlags?.aiFeature?.realtimeTranscripts?.enable !== true) return;
|
|
780
1694
|
|
|
781
1695
|
this.apiAIAssistant
|
|
782
1696
|
.sendEvent(
|
|
@@ -784,12 +1698,12 @@ export default class TaskManager extends EventEmitter {
|
|
|
784
1698
|
interactionId,
|
|
785
1699
|
AIAssistantEventType.CUSTOM_EVENT,
|
|
786
1700
|
AIAssistantEventName.GET_TRANSCRIPTS,
|
|
787
|
-
action
|
|
1701
|
+
{action}
|
|
788
1702
|
)
|
|
789
1703
|
.catch((error) => {
|
|
790
1704
|
LoggerProxy.error(`Failed to send transcript ${action} event`, {
|
|
791
1705
|
module: TASK_MANAGER_FILE,
|
|
792
|
-
method:
|
|
1706
|
+
method: METHODS.REQUEST_REAL_TIME_TRANSCRIPTS,
|
|
793
1707
|
interactionId,
|
|
794
1708
|
error,
|
|
795
1709
|
});
|
|
@@ -800,28 +1714,81 @@ export default class TaskManager extends EventEmitter {
|
|
|
800
1714
|
return this.taskCollection[taskId];
|
|
801
1715
|
}
|
|
802
1716
|
|
|
1717
|
+
public getAllTasks(): Record<TaskId, ITask> {
|
|
1718
|
+
return {...this.taskCollection};
|
|
1719
|
+
}
|
|
1720
|
+
|
|
803
1721
|
/**
|
|
804
|
-
*
|
|
1722
|
+
* Propagate runtime enableWxBetterTogether changes to config flags and active tasks.
|
|
805
1723
|
*/
|
|
806
|
-
public
|
|
807
|
-
|
|
808
|
-
|
|
1724
|
+
public applyEnableWxBetterTogether(enabled: boolean): void {
|
|
1725
|
+
if (this.configFlags) {
|
|
1726
|
+
this.configFlags = {...this.configFlags, enableWxBetterTogether: enabled};
|
|
1727
|
+
}
|
|
1728
|
+
|
|
1729
|
+
Object.values(this.taskCollection).forEach((task) => {
|
|
1730
|
+
task.setEnableWxBetterTogether(enabled);
|
|
1731
|
+
if (enabled) {
|
|
1732
|
+
TaskManager.syncWxAppMuteFromCallDetailsForTask(task);
|
|
1733
|
+
}
|
|
1734
|
+
});
|
|
1735
|
+
}
|
|
1736
|
+
|
|
1737
|
+
/**
|
|
1738
|
+
* Propagate wxApp mute state from Mercury sync to active voice tasks.
|
|
1739
|
+
*/
|
|
1740
|
+
public applyWxAppMuteStateFromSync(callId: string, muted: boolean): void {
|
|
1741
|
+
Object.values(this.taskCollection).forEach((task) => {
|
|
1742
|
+
task.applyWxAppMuteStateFromSync(callId, muted);
|
|
1743
|
+
});
|
|
1744
|
+
}
|
|
1745
|
+
|
|
1746
|
+
/**
|
|
1747
|
+
* Re-seeds wxApp mute state from GET telephony/calls/{callId} for one task.
|
|
1748
|
+
*/
|
|
1749
|
+
public static syncWxAppMuteFromCallDetailsForTask(task: ITask): void {
|
|
1750
|
+
const sync = task.syncWxAppMuteFromCallDetails?.bind(task);
|
|
1751
|
+
if (typeof sync === 'function') {
|
|
1752
|
+
sync().catch(() => undefined);
|
|
1753
|
+
}
|
|
1754
|
+
}
|
|
1755
|
+
|
|
1756
|
+
/**
|
|
1757
|
+
* Re-seeds wxApp mute for all engaged voice tasks (reload / runtime enable backfill).
|
|
1758
|
+
*/
|
|
1759
|
+
public syncWxAppMuteFromCallDetailsForAllTasks(): void {
|
|
1760
|
+
Object.values(this.taskCollection).forEach((task) => {
|
|
1761
|
+
TaskManager.syncWxAppMuteFromCallDetailsForTask(task);
|
|
1762
|
+
});
|
|
1763
|
+
}
|
|
1764
|
+
|
|
1765
|
+
/**
|
|
1766
|
+
* Re-run OFFERED wxApp offer diagnostics for collected voice tasks.
|
|
1767
|
+
* Used after usersub publish so pre-publish offers can schedule mismatch grace.
|
|
1768
|
+
*/
|
|
1769
|
+
public refreshWxAppOfferObservabilityForAllTasks(): void {
|
|
1770
|
+
Object.values(this.taskCollection).forEach((task) => {
|
|
1771
|
+
task.refreshWxAppOfferObservability?.();
|
|
1772
|
+
});
|
|
1773
|
+
}
|
|
809
1774
|
|
|
810
1775
|
public static getTaskManager(
|
|
811
1776
|
apiAIAssistant: ApiAIAssistant,
|
|
812
1777
|
contact: ReturnType<typeof routingContact>,
|
|
813
1778
|
webCallingService: WebCallingService,
|
|
814
|
-
webSocketManager: WebSocketManager
|
|
1779
|
+
webSocketManager: WebSocketManager,
|
|
1780
|
+
rtdWebSocketManager?: WebSocketManager
|
|
815
1781
|
): TaskManager {
|
|
816
1782
|
if (!TaskManager.taskManager) {
|
|
817
1783
|
TaskManager.taskManager = new TaskManager(
|
|
818
1784
|
apiAIAssistant,
|
|
819
1785
|
contact,
|
|
820
1786
|
webCallingService,
|
|
821
|
-
webSocketManager
|
|
1787
|
+
webSocketManager,
|
|
1788
|
+
rtdWebSocketManager
|
|
822
1789
|
);
|
|
823
1790
|
}
|
|
824
1791
|
|
|
825
|
-
return
|
|
1792
|
+
return TaskManager.taskManager;
|
|
826
1793
|
}
|
|
827
1794
|
}
|