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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (187) hide show
  1. package/.sdd/manifest.json +5 -4
  2. package/ai-docs/ARCHITECTURE.md +1 -1
  3. package/ai-docs/CONTRACTS.md +6 -2
  4. package/ai-docs/SECURITY.md +1 -1
  5. package/ai-docs/contact-center-spec.md +22 -4
  6. package/ai-docs/features/consult-transfer-list-policy/spec/feature-spec.md +362 -0
  7. package/dist/cc.js +440 -10
  8. package/dist/cc.js.map +1 -1
  9. package/dist/config.js +7 -0
  10. package/dist/config.js.map +1 -1
  11. package/dist/constants.js +10 -2
  12. package/dist/constants.js.map +1 -1
  13. package/dist/index.js.map +1 -1
  14. package/dist/metrics/behavioral-events.js +13 -0
  15. package/dist/metrics/behavioral-events.js.map +1 -1
  16. package/dist/metrics/constants.js +2 -0
  17. package/dist/metrics/constants.js.map +1 -1
  18. package/dist/services/AddressBook.js +18 -15
  19. package/dist/services/AddressBook.js.map +1 -1
  20. package/dist/services/AnswerCallOnWebexService.js +174 -0
  21. package/dist/services/AnswerCallOnWebexService.js.map +1 -0
  22. package/dist/services/EntryPoint.js +46 -68
  23. package/dist/services/EntryPoint.js.map +1 -1
  24. package/dist/services/Queue.js +27 -22
  25. package/dist/services/Queue.js.map +1 -1
  26. package/dist/services/WebexCrossClientService.js +171 -0
  27. package/dist/services/WebexCrossClientService.js.map +1 -0
  28. package/dist/services/WxAppTelephonyMercurySync.js +93 -0
  29. package/dist/services/WxAppTelephonyMercurySync.js.map +1 -0
  30. package/dist/services/config/Util.js +3 -0
  31. package/dist/services/config/Util.js.map +1 -1
  32. package/dist/services/config/constants.js +10 -6
  33. package/dist/services/config/constants.js.map +1 -1
  34. package/dist/services/config/types.js +4 -0
  35. package/dist/services/config/types.js.map +1 -1
  36. package/dist/services/core/Err.js.map +1 -1
  37. package/dist/services/core/WebexRequest.js +6 -2
  38. package/dist/services/core/WebexRequest.js.map +1 -1
  39. package/dist/services/core/aqm-reqs.js +28 -14
  40. package/dist/services/core/aqm-reqs.js.map +1 -1
  41. package/dist/services/core/types.js.map +1 -1
  42. package/dist/services/task/Task.js +73 -7
  43. package/dist/services/task/Task.js.map +1 -1
  44. package/dist/services/task/TaskFactory.js +8 -4
  45. package/dist/services/task/TaskFactory.js.map +1 -1
  46. package/dist/services/task/TaskManager.js +353 -21
  47. package/dist/services/task/TaskManager.js.map +1 -1
  48. package/dist/services/task/WebexCallingUtils.js +70 -0
  49. package/dist/services/task/WebexCallingUtils.js.map +1 -0
  50. package/dist/services/task/constants.js +4 -1
  51. package/dist/services/task/constants.js.map +1 -1
  52. package/dist/services/task/contact.js +29 -0
  53. package/dist/services/task/contact.js.map +1 -1
  54. package/dist/services/task/digital/Digital.js +3 -2
  55. package/dist/services/task/digital/Digital.js.map +1 -1
  56. package/dist/services/task/state-machine/TaskStateMachine.js +135 -37
  57. package/dist/services/task/state-machine/TaskStateMachine.js.map +1 -1
  58. package/dist/services/task/state-machine/actions.js +6 -1
  59. package/dist/services/task/state-machine/actions.js.map +1 -1
  60. package/dist/services/task/state-machine/guards.js +38 -11
  61. package/dist/services/task/state-machine/guards.js.map +1 -1
  62. package/dist/services/task/state-machine/types.js.map +1 -1
  63. package/dist/services/task/state-machine/uiControlsComputer.js +118 -18
  64. package/dist/services/task/state-machine/uiControlsComputer.js.map +1 -1
  65. package/dist/services/task/types.js +16 -1
  66. package/dist/services/task/types.js.map +1 -1
  67. package/dist/services/task/voice/Voice.js +350 -14
  68. package/dist/services/task/voice/Voice.js.map +1 -1
  69. package/dist/services/task/voice/WebRTC.js +4 -1
  70. package/dist/services/task/voice/WebRTC.js.map +1 -1
  71. package/dist/services/task/voice/wxAppVoiceMethods.js +201 -0
  72. package/dist/services/task/voice/wxAppVoiceMethods.js.map +1 -0
  73. package/dist/services/wxAppTelephonyUtils.js +19 -0
  74. package/dist/services/wxAppTelephonyUtils.js.map +1 -0
  75. package/dist/types/cc.d.ts +77 -4
  76. package/dist/types/config.d.ts +7 -0
  77. package/dist/types/constants.d.ts +8 -0
  78. package/dist/types/index.d.ts +3 -1
  79. package/dist/types/metrics/constants.d.ts +2 -0
  80. package/dist/types/services/AddressBook.d.ts +2 -1
  81. package/dist/types/services/AnswerCallOnWebexService.d.ts +37 -0
  82. package/dist/types/services/EntryPoint.d.ts +7 -5
  83. package/dist/types/services/Queue.d.ts +5 -3
  84. package/dist/types/services/WebexCrossClientService.d.ts +28 -0
  85. package/dist/types/services/WxAppTelephonyMercurySync.d.ts +28 -0
  86. package/dist/types/services/config/constants.d.ts +8 -5
  87. package/dist/types/services/config/types.d.ts +17 -4
  88. package/dist/types/services/core/Err.d.ts +2 -0
  89. package/dist/types/services/core/WebexRequest.d.ts +1 -0
  90. package/dist/types/services/core/types.d.ts +2 -0
  91. package/dist/types/services/task/Task.d.ts +20 -2
  92. package/dist/types/services/task/TaskFactory.d.ts +2 -1
  93. package/dist/types/services/task/WebexCallingUtils.d.ts +11 -0
  94. package/dist/types/services/task/constants.d.ts +3 -0
  95. package/dist/types/services/task/contact.d.ts +4 -0
  96. package/dist/types/services/task/digital/Digital.d.ts +2 -2
  97. package/dist/types/services/task/state-machine/TaskStateMachine.d.ts +260 -56
  98. package/dist/types/services/task/state-machine/guards.d.ts +6 -5
  99. package/dist/types/services/task/state-machine/types.d.ts +9 -1
  100. package/dist/types/services/task/types.d.ts +81 -4
  101. package/dist/types/services/task/voice/Voice.d.ts +48 -9
  102. package/dist/types/services/task/voice/WebRTC.d.ts +2 -2
  103. package/dist/types/services/task/voice/wxAppVoiceMethods.d.ts +52 -0
  104. package/dist/types/services/wxAppTelephonyUtils.d.ts +5 -0
  105. package/dist/types/types.d.ts +14 -8
  106. package/dist/types/utils/PageCache.d.ts +20 -3
  107. package/dist/types.js +7 -2
  108. package/dist/types.js.map +1 -1
  109. package/dist/utils/PageCache.js +19 -5
  110. package/dist/utils/PageCache.js.map +1 -1
  111. package/dist/webex.js +1 -1
  112. package/package.json +9 -9
  113. package/src/cc.ts +506 -9
  114. package/src/config.ts +7 -0
  115. package/src/constants.ts +8 -0
  116. package/src/index.ts +2 -0
  117. package/src/metrics/ai-docs/metrics-spec.md +9 -3
  118. package/src/metrics/behavioral-events.ts +14 -0
  119. package/src/metrics/constants.ts +2 -0
  120. package/src/services/AddressBook.ts +17 -6
  121. package/src/services/AnswerCallOnWebexService.ts +206 -0
  122. package/src/services/EntryPoint.ts +59 -60
  123. package/src/services/Queue.ts +29 -12
  124. package/src/services/WebexCrossClientService.ts +212 -0
  125. package/src/services/WxAppTelephonyMercurySync.ts +115 -0
  126. package/src/services/ai-docs/AGENTS.md +10 -10
  127. package/src/services/ai-docs/services-spec.md +6 -1
  128. package/src/services/config/Util.ts +3 -0
  129. package/src/services/config/ai-docs/AGENTS.md +1 -1
  130. package/src/services/config/ai-docs/ARCHITECTURE.md +2 -2
  131. package/src/services/config/ai-docs/config-spec.md +6 -0
  132. package/src/services/config/constants.ts +10 -6
  133. package/src/services/config/types.ts +16 -4
  134. package/src/services/core/Err.ts +1 -0
  135. package/src/services/core/WebexRequest.ts +3 -1
  136. package/src/services/core/ai-docs/core-spec.md +5 -1
  137. package/src/services/core/aqm-reqs.ts +30 -15
  138. package/src/services/core/types.ts +2 -0
  139. package/src/services/task/Task.ts +79 -8
  140. package/src/services/task/TaskFactory.ts +8 -3
  141. package/src/services/task/TaskManager.ts +522 -16
  142. package/src/services/task/WebexCallingUtils.ts +136 -0
  143. package/src/services/task/ai-docs/ARCHITECTURE.md +1 -0
  144. package/src/services/task/ai-docs/task-spec.md +152 -2
  145. package/src/services/task/constants.ts +3 -0
  146. package/src/services/task/contact.ts +30 -0
  147. package/src/services/task/digital/Digital.ts +4 -2
  148. package/src/services/task/state-machine/TaskStateMachine.ts +210 -63
  149. package/src/services/task/state-machine/actions.ts +5 -2
  150. package/src/services/task/state-machine/ai-docs/AGENTS.md +8 -4
  151. package/src/services/task/state-machine/ai-docs/ARCHITECTURE.md +17 -8
  152. package/src/services/task/state-machine/ai-docs/task-state-machine-spec.md +56 -24
  153. package/src/services/task/state-machine/guards.ts +64 -11
  154. package/src/services/task/state-machine/types.ts +16 -1
  155. package/src/services/task/state-machine/uiControlsComputer.ts +206 -32
  156. package/src/services/task/types.ts +114 -4
  157. package/src/services/task/voice/Voice.ts +462 -12
  158. package/src/services/task/voice/WebRTC.ts +5 -1
  159. package/src/services/task/voice/wxAppVoiceMethods.ts +307 -0
  160. package/src/services/wxAppTelephonyUtils.ts +14 -0
  161. package/src/types.ts +33 -9
  162. package/src/utils/AGENTS.md +21 -10
  163. package/src/utils/PageCache.ts +38 -5
  164. package/src/utils/ai-docs/utils-spec.md +21 -11
  165. package/test/unit/spec/cc.ts +1274 -0
  166. package/test/unit/spec/metrics/behavioral-events.ts +18 -0
  167. package/test/unit/spec/services/AddressBook.ts +37 -6
  168. package/test/unit/spec/services/AnswerCallOnWebexService.ts +223 -0
  169. package/test/unit/spec/services/EntryPoint.ts +87 -40
  170. package/test/unit/spec/services/Queue.ts +123 -12
  171. package/test/unit/spec/services/WebexCrossClientService.ts +261 -0
  172. package/test/unit/spec/services/WxAppTelephonyMercurySync.ts +113 -0
  173. package/test/unit/spec/services/config/Util.ts +85 -0
  174. package/test/unit/spec/services/core/WebexRequest.ts +3 -1
  175. package/test/unit/spec/services/core/aqm-reqs.ts +113 -1
  176. package/test/unit/spec/services/task/Task.ts +200 -0
  177. package/test/unit/spec/services/task/TaskFactory.ts +39 -2
  178. package/test/unit/spec/services/task/TaskManager.ts +1294 -1
  179. package/test/unit/spec/services/task/WebexCallingUtils.ts +153 -0
  180. package/test/unit/spec/services/task/contact.ts +33 -0
  181. package/test/unit/spec/services/task/state-machine/TaskStateMachine.ts +854 -72
  182. package/test/unit/spec/services/task/state-machine/guards.ts +210 -8
  183. package/test/unit/spec/services/task/state-machine/uiControlsComputer.ts +445 -7
  184. package/test/unit/spec/services/task/voice/Voice.ts +874 -0
  185. package/test/unit/spec/services/task/voice/wxAppVoiceMethods.ts +459 -0
  186. package/umd/contact-center.min.js +2 -2
  187. package/umd/contact-center.min.js.map +1 -1
@@ -3,6 +3,7 @@ import {
3
3
  TaskContext,
4
4
  TaskEventPayload,
5
5
  } from '../../../../../../src/services/task/state-machine/types';
6
+ import {TaskEvent} from '../../../../../../src/services/task/state-machine/constants';
6
7
  import {TaskData, InteractionParticipant} from '../../../../../../src/services/task/types';
7
8
 
8
9
  describe('State Machine Guards', () => {
@@ -339,7 +340,9 @@ describe('State Machine Guards', () => {
339
340
  const ctx = createContext({transferConferenceRequested: false, consultInitiator: false});
340
341
  const taskData = createTaskData({consultingAgentId: 'agent-123'});
341
342
  expect(
342
- guards.isPassiveConferenceTransferObserver(createParams(ctx, createEventWithTaskData(taskData)))
343
+ guards.isPassiveConferenceTransferObserver(
344
+ createParams(ctx, createEventWithTaskData(taskData))
345
+ )
343
346
  ).toBe(false);
344
347
  });
345
348
 
@@ -361,7 +364,9 @@ describe('State Machine Guards', () => {
361
364
  },
362
365
  });
363
366
  expect(
364
- guards.isPassiveConferenceTransferObserver(createParams(ctx, createEventWithTaskData(taskData)))
367
+ guards.isPassiveConferenceTransferObserver(
368
+ createParams(ctx, createEventWithTaskData(taskData))
369
+ )
365
370
  ).toBe(false);
366
371
  });
367
372
 
@@ -376,7 +381,9 @@ describe('State Machine Guards', () => {
376
381
  },
377
382
  });
378
383
  expect(
379
- guards.isPassiveConferenceTransferObserver(createParams(ctx, createEventWithTaskData(taskData)))
384
+ guards.isPassiveConferenceTransferObserver(
385
+ createParams(ctx, createEventWithTaskData(taskData))
386
+ )
380
387
  ).toBe(false);
381
388
  });
382
389
 
@@ -392,7 +399,9 @@ describe('State Machine Guards', () => {
392
399
  },
393
400
  });
394
401
  expect(
395
- guards.isPassiveConferenceTransferObserver(createParams(ctx, createEventWithTaskData(taskData)))
402
+ guards.isPassiveConferenceTransferObserver(
403
+ createParams(ctx, createEventWithTaskData(taskData))
404
+ )
396
405
  ).toBe(true);
397
406
  });
398
407
 
@@ -421,7 +430,9 @@ describe('State Machine Guards', () => {
421
430
  },
422
431
  });
423
432
  expect(
424
- guards.isPassiveConferenceTransferObserver(createParams(ctx, createEventWithTaskData(taskData)))
433
+ guards.isPassiveConferenceTransferObserver(
434
+ createParams(ctx, createEventWithTaskData(taskData))
435
+ )
425
436
  ).toBe(false);
426
437
  });
427
438
  });
@@ -434,7 +445,9 @@ describe('State Machine Guards', () => {
434
445
  consultingAgentId: 'agent-123',
435
446
  });
436
447
  expect(
437
- guards.isSelfConferenceTransferInitiator(createParams(ctx, createEventWithTaskData(taskData)))
448
+ guards.isSelfConferenceTransferInitiator(
449
+ createParams(ctx, createEventWithTaskData(taskData))
450
+ )
438
451
  ).toBe(true);
439
452
  });
440
453
 
@@ -463,7 +476,9 @@ describe('State Machine Guards', () => {
463
476
  },
464
477
  });
465
478
  expect(
466
- guards.isSelfConferenceTransferInitiator(createParams(ctx, createEventWithTaskData(taskData)))
479
+ guards.isSelfConferenceTransferInitiator(
480
+ createParams(ctx, createEventWithTaskData(taskData))
481
+ )
467
482
  ).toBe(false);
468
483
  });
469
484
 
@@ -479,7 +494,9 @@ describe('State Machine Guards', () => {
479
494
  },
480
495
  });
481
496
  expect(
482
- guards.isSelfConferenceTransferInitiator(createParams(ctx, createEventWithTaskData(taskData)))
497
+ guards.isSelfConferenceTransferInitiator(
498
+ createParams(ctx, createEventWithTaskData(taskData))
499
+ )
483
500
  ).toBe(false);
484
501
  });
485
502
  });
@@ -587,6 +604,191 @@ describe('State Machine Guards', () => {
587
604
  });
588
605
  });
589
606
 
607
+ describe('didCurrentAgentLeaveMainInteraction', () => {
608
+ const activeTaskData = createTaskData({
609
+ interaction: {
610
+ ...createTaskData().interaction,
611
+ participants: {
612
+ 'agent-123': createParticipant('agent-123', 'Agent'),
613
+ 'agent-456': createParticipant('agent-456', 'Agent'),
614
+ },
615
+ media: {
616
+ 'non-interaction-main-key': {
617
+ mediaResourceId: INTERACTION_ID,
618
+ mediaType: 'telephony',
619
+ mediaMgr: 'media-mgr',
620
+ participants: ['agent-123', 'agent-456'],
621
+ mType: 'mainCall',
622
+ isHold: false,
623
+ holdTimestamp: null,
624
+ },
625
+ },
626
+ },
627
+ });
628
+
629
+ it('returns true when the lifecycle event explicitly names the current agent', () => {
630
+ const context = createContext({taskData: activeTaskData});
631
+ const event = {
632
+ ...createEventWithTaskData(activeTaskData),
633
+ participantId: 'agent-123',
634
+ } as TaskEventPayload;
635
+
636
+ expect(guards.didCurrentAgentLeaveMainInteraction(createParams(context, event))).toBe(true);
637
+ });
638
+
639
+ it('returns true when the current participant is marked as departed', () => {
640
+ const context = createContext({taskData: activeTaskData});
641
+ const updatedTaskData = createTaskData({
642
+ interaction: {
643
+ ...activeTaskData.interaction,
644
+ participants: {
645
+ ...activeTaskData.interaction.participants,
646
+ 'agent-123': createParticipant('agent-123', 'Agent', true),
647
+ },
648
+ },
649
+ });
650
+
651
+ expect(
652
+ guards.didCurrentAgentLeaveMainInteraction(
653
+ createParams(context, createEventWithTaskData(updatedTaskData))
654
+ )
655
+ ).toBe(true);
656
+ });
657
+
658
+ it('uses mainCall membership for nested CONSULT_END cleanup', () => {
659
+ const context = createContext({taskData: activeTaskData, consultFromConference: true});
660
+ const updatedTaskData = createTaskData({
661
+ interaction: {
662
+ ...activeTaskData.interaction,
663
+ participants: activeTaskData.interaction.participants,
664
+ media: {
665
+ 'another-arbitrary-key': {
666
+ mediaResourceId: INTERACTION_ID,
667
+ mediaType: 'telephony',
668
+ mediaMgr: 'media-mgr',
669
+ participants: ['agent-456'],
670
+ mType: 'mainCall',
671
+ isHold: false,
672
+ holdTimestamp: null,
673
+ },
674
+ 'consult-media-key': {
675
+ mediaResourceId: 'consult-media-id',
676
+ mediaType: 'telephony',
677
+ mediaMgr: 'media-mgr',
678
+ participants: ['agent-123', 'agent-789'],
679
+ mType: 'consult',
680
+ isHold: false,
681
+ holdTimestamp: null,
682
+ },
683
+ },
684
+ },
685
+ });
686
+ const event = {
687
+ type: TaskEvent.CONSULT_END,
688
+ taskData: updatedTaskData,
689
+ } as TaskEventPayload;
690
+
691
+ expect(
692
+ guards.didCurrentAgentLeaveMainInteraction(createParams(context, event))
693
+ ).toBe(true);
694
+ });
695
+
696
+ it('does not infer self departure when another participant leaves and the map omits self', () => {
697
+ const context = createContext({taskData: activeTaskData});
698
+ const partialTaskData = createTaskData({
699
+ interaction: {
700
+ ...activeTaskData.interaction,
701
+ participants: {'agent-456': createParticipant('agent-456', 'Agent')},
702
+ media: {
703
+ 'partial-main-key': {
704
+ mediaResourceId: INTERACTION_ID,
705
+ mediaType: 'telephony',
706
+ mediaMgr: 'media-mgr',
707
+ participants: ['agent-456'],
708
+ mType: 'mainCall',
709
+ isHold: false,
710
+ holdTimestamp: null,
711
+ },
712
+ },
713
+ },
714
+ });
715
+ const event = {
716
+ type: TaskEvent.PARTICIPANT_LEAVE,
717
+ participantId: 'agent-456',
718
+ taskData: partialTaskData,
719
+ } as TaskEventPayload;
720
+
721
+ expect(guards.didCurrentAgentLeaveMainInteraction(createParams(context, event))).toBe(false);
722
+ });
723
+
724
+ it.each(['connected', 'held'])(
725
+ 'does not infer departure from a partial CONSULT_END snapshot while %s',
726
+ (state) => {
727
+ const previousTaskData = createTaskData({
728
+ ...activeTaskData,
729
+ interaction: {...activeTaskData.interaction, state},
730
+ });
731
+ const context = createContext({taskData: previousTaskData});
732
+ const partialTaskData = createTaskData({
733
+ interaction: {
734
+ ...previousTaskData.interaction,
735
+ participants: previousTaskData.interaction.participants,
736
+ media: {
737
+ 'partial-main-key': {
738
+ mediaResourceId: INTERACTION_ID,
739
+ mediaType: 'telephony',
740
+ mediaMgr: 'media-mgr',
741
+ participants: ['agent-456'],
742
+ mType: 'mainCall',
743
+ isHold: state === 'held',
744
+ holdTimestamp: state === 'held' ? Date.now() : null,
745
+ },
746
+ },
747
+ },
748
+ });
749
+ const event = {type: TaskEvent.CONSULT_END, taskData: partialTaskData} as TaskEventPayload;
750
+
751
+ expect(guards.didCurrentAgentLeaveMainInteraction(createParams(context, event))).toBe(
752
+ false
753
+ );
754
+ }
755
+ );
756
+
757
+ it('returns true when an active current participant disappears from the updated map', () => {
758
+ const context = createContext({taskData: activeTaskData});
759
+ const updatedTaskData = createTaskData({
760
+ interaction: {
761
+ ...activeTaskData.interaction,
762
+ participants: {'agent-456': createParticipant('agent-456', 'Agent')},
763
+ media: activeTaskData.interaction.media,
764
+ },
765
+ });
766
+
767
+ expect(
768
+ guards.didCurrentAgentLeaveMainInteraction(
769
+ createParams(context, createEventWithTaskData(updatedTaskData))
770
+ )
771
+ ).toBe(true);
772
+ });
773
+
774
+ it('does not infer departure from missing partial interaction membership', () => {
775
+ const context = createContext({taskData: activeTaskData});
776
+ const partialTaskData = createTaskData({
777
+ interaction: {
778
+ interactionId: INTERACTION_ID,
779
+ mainInteractionId: INTERACTION_ID,
780
+ state: 'conference',
781
+ } as TaskData['interaction'],
782
+ });
783
+
784
+ expect(
785
+ guards.didCurrentAgentLeaveMainInteraction(
786
+ createParams(context, createEventWithTaskData(partialTaskData))
787
+ )
788
+ ).toBe(false);
789
+ });
790
+ });
791
+
590
792
  describe('Server State Guards', () => {
591
793
  it('isPrimaryMediaOnHold returns true when media isHold is true', () => {
592
794
  const ctx = createContext();