@webex/contact-center 3.12.0-webex-services-ready.4 → 3.13.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (250) hide show
  1. package/.sdd/manifest.json +24 -13
  2. package/ai-docs/ARCHITECTURE.md +1 -1
  3. package/ai-docs/CONTRACTS.md +19 -3
  4. package/ai-docs/SECURITY.md +1 -1
  5. package/ai-docs/SERVICE_STATE.md +4 -0
  6. package/ai-docs/contact-center-spec.md +50 -6
  7. package/ai-docs/features/consult-transfer-list-policy/spec/feature-spec.md +362 -0
  8. package/ai-docs/features/contact-owner-change-refactor.md +78 -0
  9. package/dist/cc.js +757 -22
  10. package/dist/cc.js.map +1 -1
  11. package/dist/config.js +7 -0
  12. package/dist/config.js.map +1 -1
  13. package/dist/constants.js +23 -2
  14. package/dist/constants.js.map +1 -1
  15. package/dist/index.js +34 -12
  16. package/dist/index.js.map +1 -1
  17. package/dist/metrics/MetricsManager.js +16 -0
  18. package/dist/metrics/MetricsManager.js.map +1 -1
  19. package/dist/metrics/behavioral-events.js +110 -0
  20. package/dist/metrics/behavioral-events.js.map +1 -1
  21. package/dist/metrics/constants.js +33 -0
  22. package/dist/metrics/constants.js.map +1 -1
  23. package/dist/services/AddressBook.js +18 -15
  24. package/dist/services/AddressBook.js.map +1 -1
  25. package/dist/services/AnswerCallOnWebexService.js +202 -0
  26. package/dist/services/AnswerCallOnWebexService.js.map +1 -0
  27. package/dist/services/ApiAiAssistant.js +221 -11
  28. package/dist/services/ApiAiAssistant.js.map +1 -1
  29. package/dist/services/EntryPoint.js +46 -68
  30. package/dist/services/EntryPoint.js.map +1 -1
  31. package/dist/services/Queue.js +27 -22
  32. package/dist/services/Queue.js.map +1 -1
  33. package/dist/services/WebCallingService.js +10 -2
  34. package/dist/services/WebCallingService.js.map +1 -1
  35. package/dist/services/WebexCrossClientService.js +225 -0
  36. package/dist/services/WebexCrossClientService.js.map +1 -0
  37. package/dist/services/WxAppTelephonyMercurySync.js +111 -0
  38. package/dist/services/WxAppTelephonyMercurySync.js.map +1 -0
  39. package/dist/services/config/Util.js +46 -46
  40. package/dist/services/config/Util.js.map +1 -1
  41. package/dist/services/config/constants.js +34 -77
  42. package/dist/services/config/constants.js.map +1 -1
  43. package/dist/services/config/index.js +100 -226
  44. package/dist/services/config/index.js.map +1 -1
  45. package/dist/services/config/types.js +51 -18
  46. package/dist/services/config/types.js.map +1 -1
  47. package/dist/services/constants.js +11 -1
  48. package/dist/services/constants.js.map +1 -1
  49. package/dist/services/core/Err.js.map +1 -1
  50. package/dist/services/core/Utils.js +25 -1
  51. package/dist/services/core/Utils.js.map +1 -1
  52. package/dist/services/core/WebexRequest.js +6 -2
  53. package/dist/services/core/WebexRequest.js.map +1 -1
  54. package/dist/services/core/aqm-reqs.js +17 -11
  55. package/dist/services/core/aqm-reqs.js.map +1 -1
  56. package/dist/services/core/constants.js +9 -1
  57. package/dist/services/core/constants.js.map +1 -1
  58. package/dist/services/core/types.js.map +1 -1
  59. package/dist/services/core/websocket/WebSocketManager.js +17 -1
  60. package/dist/services/core/websocket/WebSocketManager.js.map +1 -1
  61. package/dist/services/task/Task.js +275 -8
  62. package/dist/services/task/Task.js.map +1 -1
  63. package/dist/services/task/TaskFactory.js +11 -6
  64. package/dist/services/task/TaskFactory.js.map +1 -1
  65. package/dist/services/task/TaskManager.js +590 -42
  66. package/dist/services/task/TaskManager.js.map +1 -1
  67. package/dist/services/task/TaskUtils.js +11 -1
  68. package/dist/services/task/TaskUtils.js.map +1 -1
  69. package/dist/services/task/WebexCallingUtils.js +70 -0
  70. package/dist/services/task/WebexCallingUtils.js.map +1 -0
  71. package/dist/services/task/constants.js +14 -2
  72. package/dist/services/task/constants.js.map +1 -1
  73. package/dist/services/task/contact.js +29 -0
  74. package/dist/services/task/contact.js.map +1 -1
  75. package/dist/services/task/digital/Digital.js +4 -3
  76. package/dist/services/task/digital/Digital.js.map +1 -1
  77. package/dist/services/task/state-machine/TaskStateMachine.js +162 -53
  78. package/dist/services/task/state-machine/TaskStateMachine.js.map +1 -1
  79. package/dist/services/task/state-machine/actions.js +6 -1
  80. package/dist/services/task/state-machine/actions.js.map +1 -1
  81. package/dist/services/task/state-machine/guards.js +7 -10
  82. package/dist/services/task/state-machine/guards.js.map +1 -1
  83. package/dist/services/task/state-machine/types.js.map +1 -1
  84. package/dist/services/task/state-machine/uiControlsComputer.js +118 -18
  85. package/dist/services/task/state-machine/uiControlsComputer.js.map +1 -1
  86. package/dist/services/task/types.js +47 -1
  87. package/dist/services/task/types.js.map +1 -1
  88. package/dist/services/task/voice/Voice.js +477 -17
  89. package/dist/services/task/voice/Voice.js.map +1 -1
  90. package/dist/services/task/voice/WebRTC.js +6 -3
  91. package/dist/services/task/voice/WebRTC.js.map +1 -1
  92. package/dist/services/task/voice/wxAppOfferObservability.js +145 -0
  93. package/dist/services/task/voice/wxAppOfferObservability.js.map +1 -0
  94. package/dist/services/task/voice/wxAppVoiceMethods.js +395 -0
  95. package/dist/services/task/voice/wxAppVoiceMethods.js.map +1 -0
  96. package/dist/services/wxAppDiagnosticLogging.js +159 -0
  97. package/dist/services/wxAppDiagnosticLogging.js.map +1 -0
  98. package/dist/services/wxAppTelephonyUtils.js +19 -0
  99. package/dist/services/wxAppTelephonyUtils.js.map +1 -0
  100. package/dist/types/cc.d.ts +102 -8
  101. package/dist/types/config.d.ts +7 -0
  102. package/dist/types/constants.d.ts +21 -0
  103. package/dist/types/index.d.ts +34 -15
  104. package/dist/types/metrics/MetricsManager.d.ts +6 -0
  105. package/dist/types/metrics/constants.d.ts +31 -0
  106. package/dist/types/services/AddressBook.d.ts +2 -1
  107. package/dist/types/services/AnswerCallOnWebexService.d.ts +38 -0
  108. package/dist/types/services/ApiAiAssistant.d.ts +48 -4
  109. package/dist/types/services/EntryPoint.d.ts +7 -5
  110. package/dist/types/services/Queue.d.ts +5 -3
  111. package/dist/types/services/WebexCrossClientService.d.ts +32 -0
  112. package/dist/types/services/WxAppTelephonyMercurySync.d.ts +28 -0
  113. package/dist/types/services/config/Util.d.ts +4 -8
  114. package/dist/types/services/config/constants.d.ts +28 -76
  115. package/dist/types/services/config/index.d.ts +16 -64
  116. package/dist/types/services/config/types.d.ts +146 -173
  117. package/dist/types/services/constants.d.ts +9 -0
  118. package/dist/types/services/core/Err.d.ts +2 -0
  119. package/dist/types/services/core/Utils.d.ts +10 -0
  120. package/dist/types/services/core/WebexRequest.d.ts +1 -0
  121. package/dist/types/services/core/constants.d.ts +7 -0
  122. package/dist/types/services/core/types.d.ts +2 -0
  123. package/dist/types/services/task/Task.d.ts +34 -5
  124. package/dist/types/services/task/TaskFactory.d.ts +4 -2
  125. package/dist/types/services/task/TaskUtils.d.ts +6 -0
  126. package/dist/types/services/task/WebexCallingUtils.d.ts +11 -0
  127. package/dist/types/services/task/constants.d.ts +12 -0
  128. package/dist/types/services/task/contact.d.ts +4 -0
  129. package/dist/types/services/task/digital/Digital.d.ts +4 -3
  130. package/dist/types/services/task/state-machine/TaskStateMachine.d.ts +304 -56
  131. package/dist/types/services/task/state-machine/guards.d.ts +6 -5
  132. package/dist/types/services/task/state-machine/types.d.ts +9 -1
  133. package/dist/types/services/task/types.d.ts +192 -5
  134. package/dist/types/services/task/voice/Voice.d.ts +68 -11
  135. package/dist/types/services/task/voice/WebRTC.d.ts +5 -4
  136. package/dist/types/services/task/voice/wxAppOfferObservability.d.ts +39 -0
  137. package/dist/types/services/task/voice/wxAppVoiceMethods.d.ts +68 -0
  138. package/dist/types/services/wxAppDiagnosticLogging.d.ts +63 -0
  139. package/dist/types/services/wxAppTelephonyUtils.d.ts +5 -0
  140. package/dist/types/types.d.ts +80 -13
  141. package/dist/types/utils/PageCache.d.ts +20 -3
  142. package/dist/types.js +54 -8
  143. package/dist/types.js.map +1 -1
  144. package/dist/utils/PageCache.js +19 -5
  145. package/dist/utils/PageCache.js.map +1 -1
  146. package/dist/webex.js +9 -1
  147. package/dist/webex.js.map +1 -1
  148. package/package.json +10 -9
  149. package/src/cc.ts +969 -38
  150. package/src/config.ts +7 -0
  151. package/src/constants.ts +24 -0
  152. package/src/index.ts +39 -10
  153. package/src/metrics/MetricsManager.ts +16 -0
  154. package/src/metrics/ai-docs/metrics-spec.md +138 -21
  155. package/src/metrics/behavioral-events.ts +112 -0
  156. package/src/metrics/constants.ts +36 -0
  157. package/src/services/AddressBook.ts +17 -6
  158. package/src/services/AnswerCallOnWebexService.ts +239 -0
  159. package/src/services/ApiAiAssistant.ts +297 -13
  160. package/src/services/EntryPoint.ts +59 -60
  161. package/src/services/Queue.ts +29 -12
  162. package/src/services/WebCallingService.ts +16 -2
  163. package/src/services/WebexCrossClientService.ts +298 -0
  164. package/src/services/WxAppTelephonyMercurySync.ts +142 -0
  165. package/src/services/agent/ai-docs/AGENTS.md +1 -1
  166. package/src/services/agent/ai-docs/agent-spec.md +1 -0
  167. package/src/services/ai-docs/AGENTS.md +10 -10
  168. package/src/services/ai-docs/services-spec.md +25 -5
  169. package/src/services/config/Util.ts +52 -82
  170. package/src/services/config/ai-docs/AGENTS.md +35 -40
  171. package/src/services/config/ai-docs/ARCHITECTURE.md +90 -103
  172. package/src/services/config/ai-docs/config-spec.md +132 -132
  173. package/src/services/config/constants.ts +39 -85
  174. package/src/services/config/index.ts +116 -277
  175. package/src/services/config/types.ts +140 -195
  176. package/src/services/constants.ts +10 -0
  177. package/src/services/core/Err.ts +1 -0
  178. package/src/services/core/Utils.ts +28 -0
  179. package/src/services/core/WebexRequest.ts +3 -1
  180. package/src/services/core/ai-docs/core-spec.md +25 -11
  181. package/src/services/core/aqm-reqs.ts +18 -12
  182. package/src/services/core/constants.ts +8 -0
  183. package/src/services/core/types.ts +33 -1
  184. package/src/services/core/websocket/WebSocketManager.ts +26 -2
  185. package/src/services/task/Task.ts +386 -12
  186. package/src/services/task/TaskFactory.ts +33 -6
  187. package/src/services/task/TaskManager.ts +857 -41
  188. package/src/services/task/TaskUtils.ts +13 -0
  189. package/src/services/task/WebexCallingUtils.ts +136 -0
  190. package/src/services/task/ai-docs/ARCHITECTURE.md +1 -0
  191. package/src/services/task/ai-docs/task-spec.md +190 -8
  192. package/src/services/task/constants.ts +13 -0
  193. package/src/services/task/contact.ts +30 -0
  194. package/src/services/task/digital/Digital.ts +11 -4
  195. package/src/services/task/state-machine/TaskStateMachine.ts +235 -81
  196. package/src/services/task/state-machine/actions.ts +5 -2
  197. package/src/services/task/state-machine/ai-docs/AGENTS.md +6 -4
  198. package/src/services/task/state-machine/ai-docs/ARCHITECTURE.md +35 -16
  199. package/src/services/task/state-machine/ai-docs/task-state-machine-spec.md +103 -33
  200. package/src/services/task/state-machine/guards.ts +7 -10
  201. package/src/services/task/state-machine/types.ts +16 -1
  202. package/src/services/task/state-machine/uiControlsComputer.ts +206 -32
  203. package/src/services/task/types.ts +269 -4
  204. package/src/services/task/voice/Voice.ts +625 -17
  205. package/src/services/task/voice/WebRTC.ts +11 -4
  206. package/src/services/task/voice/wxAppOfferObservability.ts +204 -0
  207. package/src/services/task/voice/wxAppVoiceMethods.ts +575 -0
  208. package/src/services/wxAppDiagnosticLogging.ts +286 -0
  209. package/src/services/wxAppTelephonyUtils.ts +14 -0
  210. package/src/types.ts +108 -13
  211. package/src/utils/AGENTS.md +21 -10
  212. package/src/utils/PageCache.ts +38 -5
  213. package/src/utils/ai-docs/utils-spec.md +21 -11
  214. package/src/webex.js +8 -0
  215. package/test/unit/fixtures/aiSummaryTestUtils.ts +40 -0
  216. package/test/unit/spec/cc.ts +3408 -152
  217. package/test/unit/spec/index.ts +885 -0
  218. package/test/unit/spec/metrics/MetricsManager.ts +25 -0
  219. package/test/unit/spec/metrics/behavioral-events.ts +60 -0
  220. package/test/unit/spec/services/AddressBook.ts +37 -6
  221. package/test/unit/spec/services/AnswerCallOnWebexService.ts +264 -0
  222. package/test/unit/spec/services/ApiAiAssistant.ts +269 -8
  223. package/test/unit/spec/services/EntryPoint.ts +87 -40
  224. package/test/unit/spec/services/Queue.ts +123 -12
  225. package/test/unit/spec/services/WebCallingService.ts +38 -0
  226. package/test/unit/spec/services/WebexCrossClientService.ts +509 -0
  227. package/test/unit/spec/services/WxAppTelephonyMercurySync.ts +136 -0
  228. package/test/unit/spec/services/config/Util.ts +501 -0
  229. package/test/unit/spec/services/config/index.ts +313 -543
  230. package/test/unit/spec/services/core/Utils.ts +22 -0
  231. package/test/unit/spec/services/core/WebexRequest.ts +8 -7
  232. package/test/unit/spec/services/core/aqm-reqs.ts +142 -1
  233. package/test/unit/spec/services/core/websocket/WebSocketManager.ts +64 -14
  234. package/test/unit/spec/services/task/Task.ts +2257 -11
  235. package/test/unit/spec/services/task/TaskFactory.ts +56 -2
  236. package/test/unit/spec/services/task/TaskManager.ts +5559 -1493
  237. package/test/unit/spec/services/task/TaskUtils.ts +72 -0
  238. package/test/unit/spec/services/task/WebexCallingUtils.ts +153 -0
  239. package/test/unit/spec/services/task/contact.ts +33 -0
  240. package/test/unit/spec/services/task/state-machine/TaskStateMachine.ts +1501 -92
  241. package/test/unit/spec/services/task/state-machine/guards.ts +210 -8
  242. package/test/unit/spec/services/task/state-machine/uiControlsComputer.ts +445 -7
  243. package/test/unit/spec/services/task/voice/Voice.ts +1710 -4
  244. package/test/unit/spec/services/task/voice/wxAppOfferObservability.ts +361 -0
  245. package/test/unit/spec/services/task/voice/wxAppVoiceMethods.ts +719 -0
  246. package/test/unit/spec/services/wxAppDiagnosticLogging.ts +179 -0
  247. package/test/unit/spec/wellnessSampleUtils.ts +288 -0
  248. package/typedoc.md +1 -1
  249. package/umd/contact-center.min.js +2 -2
  250. package/umd/contact-center.min.js.map +1 -1
@@ -0,0 +1,202 @@
1
+ "use strict";
2
+
3
+ Object.defineProperty(exports, "__esModule", {
4
+ value: true
5
+ });
6
+ exports.default = void 0;
7
+ var _loggerProxy = _interopRequireDefault(require("../logger-proxy"));
8
+ var _constants = require("../constants");
9
+ var _types = require("../types");
10
+ var _Utils = require("./core/Utils");
11
+ var _wxAppTelephonyUtils = require("./wxAppTelephonyUtils");
12
+ function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
13
+ const ANSWER_CALL_ON_WEBEX_FILE = 'AnswerCallOnWebexService';
14
+ const extractWxAppTrackingId = source => {
15
+ const sourceObj = source;
16
+ return sourceObj?.details?.trackingId || sourceObj?.trackingId;
17
+ };
18
+ const extractWxAppHttpStatus = source => {
19
+ const obj = source;
20
+ return obj?.statusCode ?? obj?.status ?? obj?.details?.status;
21
+ };
22
+ const markWxAppTelephonyError = (error, source) => {
23
+ const marked = error;
24
+ marked.isWxAppTelephonyError = true;
25
+ const trackingId = extractWxAppTrackingId(source);
26
+ if (trackingId) {
27
+ marked.trackingId = trackingId;
28
+ }
29
+ const status = extractWxAppHttpStatus(source);
30
+ if (status !== undefined) {
31
+ marked.status = status;
32
+ }
33
+ return marked;
34
+ };
35
+ /**
36
+ * REST telephony client for wxApp thick-client answer (WXCC-6026).
37
+ * Separate from WebCallingService (WebRTC/Mobius).
38
+ */
39
+ class AnswerCallOnWebexService {
40
+ constructor(webex) {
41
+ this.webex = webex;
42
+ }
43
+ getTelephonyBaseUrl() {
44
+ const services = this.webex.internal.services;
45
+ const hydraUrl = services._serviceUrls?.hydra || services.get('hydra');
46
+ if (!hydraUrl) {
47
+ throw new Error('Telephony base URL is unavailable');
48
+ }
49
+ return `${hydraUrl.replace(/\/$/, '')}/telephony/calls`;
50
+ }
51
+ extractTrackingId(source) {
52
+ return extractWxAppTrackingId(source);
53
+ }
54
+ async telephonyRequest(resource, method, body, logMethod) {
55
+ try {
56
+ const uri = `${this.getTelephonyBaseUrl()}${resource}`;
57
+ _loggerProxy.default.log(`AnswerCallOnWebexService.${logMethod} request`, {
58
+ module: ANSWER_CALL_ON_WEBEX_FILE,
59
+ method: logMethod,
60
+ data: {
61
+ uri,
62
+ bodyKeys: Object.keys(body)
63
+ }
64
+ });
65
+ const response = await this.webex.request({
66
+ uri,
67
+ method,
68
+ body,
69
+ addAuthHeader: true
70
+ });
71
+ _loggerProxy.default.log(`AnswerCallOnWebexService.${logMethod} success`, {
72
+ module: ANSWER_CALL_ON_WEBEX_FILE,
73
+ method: logMethod,
74
+ data: {
75
+ statusCode: response.statusCode
76
+ }
77
+ });
78
+ return response;
79
+ } catch (error) {
80
+ const trackingId = this.extractTrackingId(error);
81
+ _loggerProxy.default.error(`AnswerCallOnWebexService.${logMethod} failed: ${error}`, {
82
+ module: ANSWER_CALL_ON_WEBEX_FILE,
83
+ method: logMethod,
84
+ data: {
85
+ trackingId,
86
+ status: extractWxAppHttpStatus(error)
87
+ }
88
+ });
89
+ const {
90
+ error: detailedError
91
+ } = (0, _Utils.getErrorDetails)(error, logMethod, _constants.CC_FILE);
92
+ throw markWxAppTelephonyError(detailedError, error);
93
+ }
94
+ }
95
+ answerCall(params) {
96
+ const {
97
+ callId,
98
+ endpointId,
99
+ lineOwnerId
100
+ } = params;
101
+ return this.telephonyRequest('/answer', _types.HTTP_METHODS.POST, {
102
+ callId,
103
+ endpointId,
104
+ ...(lineOwnerId ? {
105
+ lineOwnerId
106
+ } : {})
107
+ }, _constants.METHODS.ACCEPT);
108
+ }
109
+ rejectCall(params) {
110
+ const {
111
+ callId,
112
+ lineOwnerId
113
+ } = params;
114
+ return this.telephonyRequest('/reject', _types.HTTP_METHODS.POST, {
115
+ callId,
116
+ ...(lineOwnerId ? {
117
+ lineOwnerId
118
+ } : {})
119
+ }, _constants.METHODS.REJECT);
120
+ }
121
+ muteCall(params) {
122
+ const {
123
+ callId,
124
+ lineOwnerId
125
+ } = params;
126
+ return this.telephonyRequest('/mute', _types.HTTP_METHODS.POST, {
127
+ callId,
128
+ ...(lineOwnerId ? {
129
+ lineOwnerId
130
+ } : {})
131
+ }, _constants.METHODS.TOGGLE_MUTE);
132
+ }
133
+ unmuteCall(params) {
134
+ const {
135
+ callId,
136
+ lineOwnerId
137
+ } = params;
138
+ return this.telephonyRequest('/unmute', _types.HTTP_METHODS.POST, {
139
+ callId,
140
+ ...(lineOwnerId ? {
141
+ lineOwnerId
142
+ } : {})
143
+ }, _constants.METHODS.TOGGLE_MUTE);
144
+ }
145
+ transmitDtmf(params) {
146
+ const {
147
+ callId,
148
+ dtmf,
149
+ lineOwnerId
150
+ } = params;
151
+ return this.telephonyRequest('/transmitDtmf', _types.HTTP_METHODS.POST, {
152
+ callId,
153
+ dtmf,
154
+ ...(lineOwnerId ? {
155
+ lineOwnerId
156
+ } : {})
157
+ }, _constants.METHODS.TRANSMIT_DTMF);
158
+ }
159
+ async getCallDetails(params) {
160
+ const {
161
+ callId,
162
+ lineOwnerId
163
+ } = params;
164
+ const lineOwnerIdQuery = lineOwnerId ? `?lineOwnerId=${encodeURIComponent(lineOwnerId)}` : '';
165
+ const uri = `${this.getTelephonyBaseUrl()}/${callId}${lineOwnerIdQuery}`;
166
+ try {
167
+ _loggerProxy.default.log('AnswerCallOnWebexService.getCallDetails request', {
168
+ module: ANSWER_CALL_ON_WEBEX_FILE,
169
+ method: _constants.METHODS.GET_CALL_DETAILS_ON_WEBEX,
170
+ data: {
171
+ callIdSuffix: callId.length <= 8 ? callId : callId.slice(-8)
172
+ }
173
+ });
174
+ const response = await this.webex.request({
175
+ uri,
176
+ method: _types.HTTP_METHODS.GET,
177
+ addAuthHeader: true
178
+ });
179
+ return response.body ?? {};
180
+ } catch (error) {
181
+ if ((0, _wxAppTelephonyUtils.isWxAppCallNotFoundError)(error)) {
182
+ const err = error instanceof Error ? error : new Error(String(error?.message ?? error));
183
+ throw markWxAppTelephonyError(err, error);
184
+ }
185
+ const trackingId = this.extractTrackingId(error);
186
+ _loggerProxy.default.error(`AnswerCallOnWebexService.getCallDetails failed: ${error}`, {
187
+ module: ANSWER_CALL_ON_WEBEX_FILE,
188
+ method: _constants.METHODS.GET_CALL_DETAILS_ON_WEBEX,
189
+ data: {
190
+ trackingId,
191
+ status: extractWxAppHttpStatus(error)
192
+ }
193
+ });
194
+ const {
195
+ error: detailedError
196
+ } = (0, _Utils.getErrorDetails)(error, _constants.METHODS.GET_CALL_DETAILS_ON_WEBEX, _constants.CC_FILE);
197
+ throw markWxAppTelephonyError(detailedError, error);
198
+ }
199
+ }
200
+ }
201
+ exports.default = AnswerCallOnWebexService;
202
+ //# sourceMappingURL=AnswerCallOnWebexService.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"names":["_loggerProxy","_interopRequireDefault","require","_constants","_types","_Utils","_wxAppTelephonyUtils","e","__esModule","default","ANSWER_CALL_ON_WEBEX_FILE","extractWxAppTrackingId","source","sourceObj","details","trackingId","extractWxAppHttpStatus","obj","statusCode","status","markWxAppTelephonyError","error","marked","isWxAppTelephonyError","undefined","AnswerCallOnWebexService","constructor","webex","getTelephonyBaseUrl","services","internal","hydraUrl","_serviceUrls","hydra","get","Error","replace","extractTrackingId","telephonyRequest","resource","method","body","logMethod","uri","LoggerProxy","log","module","data","bodyKeys","Object","keys","response","request","addAuthHeader","detailedError","getErrorDetails","CC_FILE","answerCall","params","callId","endpointId","lineOwnerId","HTTP_METHODS","POST","METHODS","ACCEPT","rejectCall","REJECT","muteCall","TOGGLE_MUTE","unmuteCall","transmitDtmf","dtmf","TRANSMIT_DTMF","getCallDetails","lineOwnerIdQuery","encodeURIComponent","GET_CALL_DETAILS_ON_WEBEX","callIdSuffix","length","slice","GET","isWxAppCallNotFoundError","err","String","message","exports"],"sources":["AnswerCallOnWebexService.ts"],"sourcesContent":["import LoggerProxy from '../logger-proxy';\nimport {CC_FILE, METHODS} from '../constants';\nimport {HTTP_METHODS, IHttpResponse, WebexSDK} from '../types';\nimport {getErrorDetails} from './core/Utils';\nimport {isWxAppCallNotFoundError} from './wxAppTelephonyUtils';\n\nconst ANSWER_CALL_ON_WEBEX_FILE = 'AnswerCallOnWebexService';\n\nexport type WxAppTelephonyError = Error & {\n isWxAppTelephonyError: true;\n trackingId?: string;\n status?: number | string;\n};\n\nconst extractWxAppTrackingId = (source: unknown): string | undefined => {\n const sourceObj = source as {details?: {trackingId?: string}; trackingId?: string};\n\n return sourceObj?.details?.trackingId || sourceObj?.trackingId;\n};\n\nconst extractWxAppHttpStatus = (source: unknown): number | string | undefined => {\n const obj = source as {\n statusCode?: number;\n status?: number | string;\n details?: {status?: number | string};\n };\n\n return obj?.statusCode ?? obj?.status ?? obj?.details?.status;\n};\n\nconst markWxAppTelephonyError = (error: Error, source: unknown): WxAppTelephonyError => {\n const marked = error as WxAppTelephonyError;\n marked.isWxAppTelephonyError = true;\n const trackingId = extractWxAppTrackingId(source);\n if (trackingId) {\n marked.trackingId = trackingId;\n }\n const status = extractWxAppHttpStatus(source);\n if (status !== undefined) {\n marked.status = status;\n }\n\n return marked;\n};\n\nexport type AnswerCallParams = {\n callId: string;\n endpointId: string;\n lineOwnerId?: string;\n};\n\nexport type CallIdParams = {\n callId: string;\n lineOwnerId?: string;\n};\n\nexport type TransmitDtmfParams = CallIdParams & {\n dtmf: string;\n};\n\nexport type CallDetailsResponse = {\n muted?: boolean;\n};\n\n/**\n * REST telephony client for wxApp thick-client answer (WXCC-6026).\n * Separate from WebCallingService (WebRTC/Mobius).\n */\nexport default class AnswerCallOnWebexService {\n private webex: WebexSDK;\n\n constructor(webex: WebexSDK) {\n this.webex = webex;\n }\n\n private getTelephonyBaseUrl(): string {\n const services = this.webex.internal.services;\n const hydraUrl = services._serviceUrls?.hydra || services.get('hydra');\n\n if (!hydraUrl) {\n throw new Error('Telephony base URL is unavailable');\n }\n\n return `${hydraUrl.replace(/\\/$/, '')}/telephony/calls`;\n }\n\n private extractTrackingId(source: unknown): string | undefined {\n return extractWxAppTrackingId(source);\n }\n\n private async telephonyRequest(\n resource: string,\n method: HTTP_METHODS,\n body: Record<string, unknown>,\n logMethod: string\n ): Promise<IHttpResponse> {\n try {\n const uri = `${this.getTelephonyBaseUrl()}${resource}`;\n\n LoggerProxy.log(`AnswerCallOnWebexService.${logMethod} request`, {\n module: ANSWER_CALL_ON_WEBEX_FILE,\n method: logMethod,\n data: {uri, bodyKeys: Object.keys(body)},\n });\n\n const response = (await this.webex.request({\n uri,\n method,\n body,\n addAuthHeader: true,\n })) as IHttpResponse;\n\n LoggerProxy.log(`AnswerCallOnWebexService.${logMethod} success`, {\n module: ANSWER_CALL_ON_WEBEX_FILE,\n method: logMethod,\n data: {statusCode: response.statusCode},\n });\n\n return response;\n } catch (error) {\n const trackingId = this.extractTrackingId(error);\n LoggerProxy.error(`AnswerCallOnWebexService.${logMethod} failed: ${error}`, {\n module: ANSWER_CALL_ON_WEBEX_FILE,\n method: logMethod,\n data: {\n trackingId,\n status: extractWxAppHttpStatus(error),\n },\n });\n const {error: detailedError} = getErrorDetails(error, logMethod, CC_FILE);\n throw markWxAppTelephonyError(detailedError, error);\n }\n }\n\n public answerCall(params: AnswerCallParams): Promise<IHttpResponse> {\n const {callId, endpointId, lineOwnerId} = params;\n\n return this.telephonyRequest(\n '/answer',\n HTTP_METHODS.POST,\n {\n callId,\n endpointId,\n ...(lineOwnerId ? {lineOwnerId} : {}),\n },\n METHODS.ACCEPT\n );\n }\n\n public rejectCall(params: CallIdParams): Promise<IHttpResponse> {\n const {callId, lineOwnerId} = params;\n\n return this.telephonyRequest(\n '/reject',\n HTTP_METHODS.POST,\n {callId, ...(lineOwnerId ? {lineOwnerId} : {})},\n METHODS.REJECT\n );\n }\n\n public muteCall(params: CallIdParams): Promise<IHttpResponse> {\n const {callId, lineOwnerId} = params;\n\n return this.telephonyRequest(\n '/mute',\n HTTP_METHODS.POST,\n {callId, ...(lineOwnerId ? {lineOwnerId} : {})},\n METHODS.TOGGLE_MUTE\n );\n }\n\n public unmuteCall(params: CallIdParams): Promise<IHttpResponse> {\n const {callId, lineOwnerId} = params;\n\n return this.telephonyRequest(\n '/unmute',\n HTTP_METHODS.POST,\n {callId, ...(lineOwnerId ? {lineOwnerId} : {})},\n METHODS.TOGGLE_MUTE\n );\n }\n\n public transmitDtmf(params: TransmitDtmfParams): Promise<IHttpResponse> {\n const {callId, dtmf, lineOwnerId} = params;\n\n return this.telephonyRequest(\n '/transmitDtmf',\n HTTP_METHODS.POST,\n {callId, dtmf, ...(lineOwnerId ? {lineOwnerId} : {})},\n METHODS.TRANSMIT_DTMF\n );\n }\n\n public async getCallDetails(params: CallIdParams): Promise<CallDetailsResponse> {\n const {callId, lineOwnerId} = params;\n const lineOwnerIdQuery = lineOwnerId ? `?lineOwnerId=${encodeURIComponent(lineOwnerId)}` : '';\n const uri = `${this.getTelephonyBaseUrl()}/${callId}${lineOwnerIdQuery}`;\n\n try {\n LoggerProxy.log('AnswerCallOnWebexService.getCallDetails request', {\n module: ANSWER_CALL_ON_WEBEX_FILE,\n method: METHODS.GET_CALL_DETAILS_ON_WEBEX,\n data: {callIdSuffix: callId.length <= 8 ? callId : callId.slice(-8)},\n });\n\n const response = (await this.webex.request({\n uri,\n method: HTTP_METHODS.GET,\n addAuthHeader: true,\n })) as IHttpResponse;\n\n return (response.body ?? {}) as CallDetailsResponse;\n } catch (error) {\n if (isWxAppCallNotFoundError(error)) {\n const err =\n error instanceof Error\n ? error\n : new Error(String((error as {message?: string})?.message ?? error));\n throw markWxAppTelephonyError(err, error);\n }\n\n const trackingId = this.extractTrackingId(error);\n LoggerProxy.error(`AnswerCallOnWebexService.getCallDetails failed: ${error}`, {\n module: ANSWER_CALL_ON_WEBEX_FILE,\n method: METHODS.GET_CALL_DETAILS_ON_WEBEX,\n data: {\n trackingId,\n status: extractWxAppHttpStatus(error),\n },\n });\n const {error: detailedError} = getErrorDetails(\n error,\n METHODS.GET_CALL_DETAILS_ON_WEBEX,\n CC_FILE\n );\n throw markWxAppTelephonyError(detailedError, error);\n }\n }\n}\n"],"mappings":"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","ignoreList":[]}
@@ -18,8 +18,24 @@ function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e
18
18
  * @public
19
19
  */
20
20
  class ApiAIAssistant {
21
- constructor(webex) {
21
+ /** @internal Current AI flags from the agent configuration. */
22
+
23
+ pendingRtdRequests = new Map();
24
+ createWellnessError(reason) {
25
+ const error = new Error(reason);
26
+ error.details = {
27
+ type: 'SDK_VALIDATION_ERROR',
28
+ orgId: this.webex.credentials.getOrgId(),
29
+ trackingId: '',
30
+ data: {
31
+ reason
32
+ }
33
+ };
34
+ return error;
35
+ }
36
+ constructor(webex, wellnessContextProvider) {
22
37
  this.webex = webex;
38
+ this.wellnessContextProvider = wellnessContextProvider;
23
39
  this.metricsManager = _MetricsManager.default.getInstance({
24
40
  webex
25
41
  });
@@ -27,12 +43,126 @@ class ApiAIAssistant {
27
43
  setAIFeatureFlags(aiFeature) {
28
44
  this.aiFeature = aiFeature;
29
45
  }
46
+
47
+ /**
48
+ * Validates a caller-supplied identifier (agentId/interactionId) before it is used to
49
+ * construct a request. Accepts a non-empty alphanumeric identifier that may contain
50
+ * hyphens or underscores.
51
+ * @param value - the identifier to validate
52
+ * @returns {boolean} true when the identifier is a non-empty, well-formed string
53
+ * @private
54
+ */
55
+ isValidTranscriptIdentifier(value) {
56
+ return typeof value === 'string' && /^[A-Za-z0-9_-]{1,128}$/.test(value);
57
+ }
58
+ async sendWellnessBreakAction(action, method) {
59
+ this.metricsManager.timeEvent([_constants.METRIC_EVENT_NAMES.AI_ASSISTANT_WELLNESS_ACTION_ACCEPTED, _constants.METRIC_EVENT_NAMES.AI_ASSISTANT_WELLNESS_ACTION_FAILED]);
60
+ try {
61
+ const context = this.wellnessContextProvider?.();
62
+ const agentId = context?.agentId?.trim();
63
+ const agentSessionId = context?.agentSessionId?.trim();
64
+ const orgId = this.webex.credentials.getOrgId()?.trim();
65
+ if (context?.isWellnessBreakEnabled !== true) {
66
+ throw this.createWellnessError('WELLNESS_BREAK_NOT_ENABLED');
67
+ }
68
+ if (!orgId) {
69
+ throw this.createWellnessError('WELLNESS_BREAK_ORG_ID_REQUIRED');
70
+ }
71
+ if (!agentId) {
72
+ throw this.createWellnessError('WELLNESS_BREAK_AGENT_ID_REQUIRED');
73
+ }
74
+ if (!agentSessionId) {
75
+ throw this.createWellnessError('WELLNESS_BREAK_AGENT_SESSION_REQUIRED');
76
+ }
77
+ const baseUrl = this.getBaseUrl();
78
+ const response = await this.webex.request({
79
+ uri: `${baseUrl}${_constants3.AI_ASSISTANT_API_URLS.EVENT}`,
80
+ method: _types.HTTP_METHODS.POST,
81
+ addAuthHeader: true,
82
+ body: {
83
+ agentId,
84
+ orgId,
85
+ eventType: _types.AIAssistantEventType.CUSTOM_EVENT,
86
+ eventName: _types.AIAssistantEventName.WELLNESS_BREAK_ACTION,
87
+ eventDetails: {
88
+ data: {
89
+ action,
90
+ agentSessionId,
91
+ actionTimeStamp: Date.now()
92
+ }
93
+ }
94
+ }
95
+ });
96
+ if (response.statusCode !== 202) {
97
+ throw this.createWellnessError(`WELLNESS_BREAK_ACTION_UNEXPECTED_STATUS_${response.statusCode}`);
98
+ }
99
+ this.metricsManager.trackEvent(_constants.METRIC_EVENT_NAMES.AI_ASSISTANT_WELLNESS_ACTION_ACCEPTED, {
100
+ action
101
+ }, ['operational']);
102
+ _loggerProxy.default.log('Wellness action accepted by AI Assistant', {
103
+ module: _constants2.CC_FILE,
104
+ method,
105
+ data: {
106
+ action
107
+ }
108
+ });
109
+ } catch (error) {
110
+ this.metricsManager.trackEvent(_constants.METRIC_EVENT_NAMES.AI_ASSISTANT_WELLNESS_ACTION_FAILED, {
111
+ action,
112
+ error: error instanceof Error ? error.message : String(error)
113
+ }, ['operational']);
114
+ const {
115
+ error: detailedError
116
+ } = (0, _Utils.getErrorDetails)(error, method, _constants2.CC_FILE);
117
+ throw detailedError;
118
+ }
119
+ }
120
+
121
+ /**
122
+ * Requests an Agent Wellness Break.
123
+ * The promise resolves when the HTTP request is accepted with status 202; the later
124
+ * approval or denial is delivered independently through a wellness notification.
125
+ * @returns A promise that resolves with no value after HTTP acceptance
126
+ * @throws Structured Contact Center error when disabled, stale, invalid, or delivery fails
127
+ * @example
128
+ * await webex.cc.apiAIAssistant.requestWellnessBreak();
129
+ * @public
130
+ */
131
+ async requestWellnessBreak() {
132
+ return this.sendWellnessBreakAction(_types.WELLNESS_BREAK_USER_ACTIONS.REQUESTED, _constants2.METHODS.REQUEST_WELLNESS_BREAK);
133
+ }
134
+
135
+ /**
136
+ * Responds to a backend-provided Agent Wellness Break offer.
137
+ * The promise resolves when the HTTP request is accepted with status 202 and does not
138
+ * wait for a WebSocket completion event.
139
+ * @param params - ACCEPTED, REJECTED, or NO_RESPONSE
140
+ * @returns A promise that resolves with no value after HTTP acceptance
141
+ * @throws Structured Contact Center error when disabled, stale, invalid, or delivery fails
142
+ * @example
143
+ * await webex.cc.apiAIAssistant.respondToWellnessBreak({
144
+ * action: WELLNESS_BREAK_USER_ACTIONS.ACCEPTED,
145
+ * });
146
+ * @public
147
+ */
148
+ async respondToWellnessBreak(params) {
149
+ const {
150
+ action
151
+ } = params;
152
+ if (![_types.WELLNESS_BREAK_USER_ACTIONS.ACCEPTED, _types.WELLNESS_BREAK_USER_ACTIONS.REJECTED, _types.WELLNESS_BREAK_USER_ACTIONS.NO_RESPONSE].includes(action)) {
153
+ const {
154
+ error
155
+ } = (0, _Utils.getErrorDetails)(this.createWellnessError('WELLNESS_BREAK_ACTION_INVALID'), _constants2.METHODS.RESPOND_TO_WELLNESS_BREAK, _constants2.CC_FILE);
156
+ throw error;
157
+ }
158
+ return this.sendWellnessBreakAction(action, _constants2.METHODS.RESPOND_TO_WELLNESS_BREAK);
159
+ }
30
160
  getBaseUrl() {
31
161
  const wccApiGatewayUrl = this.webex.internal.services.get(_constants3.WCC_API_GATEWAY) || '';
32
162
  if (!wccApiGatewayUrl) {
33
163
  const {
34
164
  error: detailedError
35
- } = (0, _Utils.getErrorDetails)(new Error('AI_ASSISTANT_BASE_URL_NOT_AVAILABLE'), _constants2.METHODS.GET_BASE_URL, _constants2.CC_FILE);
165
+ } = (0, _Utils.getErrorDetails)(new Error(_constants2.AI_SUMMARY_ERROR_CODES.AI_ASSISTANT_BASE_URL_NOT_AVAILABLE), _constants2.METHODS.GET_BASE_URL, _constants2.CC_FILE);
36
166
  throw detailedError;
37
167
  }
38
168
  let hostname = '';
@@ -45,11 +175,78 @@ class ApiAIAssistant {
45
175
  if (!resolvedEnv) {
46
176
  const {
47
177
  error: detailedError
48
- } = (0, _Utils.getErrorDetails)(new Error('AI_ASSISTANT_BASE_URL_NOT_AVAILABLE'), _constants2.METHODS.GET_BASE_URL, _constants2.CC_FILE);
178
+ } = (0, _Utils.getErrorDetails)(new Error(_constants2.AI_SUMMARY_ERROR_CODES.AI_ASSISTANT_BASE_URL_NOT_AVAILABLE), _constants2.METHODS.GET_BASE_URL, _constants2.CC_FILE);
49
179
  throw detailedError;
50
180
  }
51
181
  return _constants3.AI_ASSISTANT_BASE_URL_TEMPLATE.replace('%s', resolvedEnv);
52
182
  }
183
+ static getRtdRequestKey(rtdEventType, correlationId) {
184
+ return JSON.stringify([rtdEventType, correlationId]);
185
+ }
186
+ removeRtdRequest(rtdEventType, correlationId, settle) {
187
+ const key = ApiAIAssistant.getRtdRequestKey(rtdEventType, correlationId);
188
+ const request = this.pendingRtdRequests.get(key);
189
+ if (!request) {
190
+ return undefined;
191
+ }
192
+ if (request.timeoutId) {
193
+ clearTimeout(request.timeoutId);
194
+ }
195
+ settle?.(request);
196
+ this.pendingRtdRequests.delete(key);
197
+ return request;
198
+ }
199
+
200
+ /** Sends an AI event and waits for its matching RTD response. @internal */
201
+ async requestAndWaitForRtd(options) {
202
+ const key = ApiAIAssistant.getRtdRequestKey(options.rtdEventType, options.correlationId);
203
+ let resolveResult = () => undefined;
204
+ let rejectResult = () => undefined;
205
+ const result = new Promise((resolve, reject) => {
206
+ resolveResult = resolve;
207
+ rejectResult = reject;
208
+ });
209
+ const previousRequest = this.pendingRtdRequests.get(key);
210
+ if (previousRequest?.timeoutId) {
211
+ clearTimeout(previousRequest.timeoutId);
212
+ }
213
+ const request = {
214
+ correlationId: options.correlationId,
215
+ rtdEventType: options.rtdEventType,
216
+ resolve: resolveResult,
217
+ reject: rejectResult
218
+ };
219
+ request.timeoutId = setTimeout(() => {
220
+ this.removeRtdRequest(options.rtdEventType, options.correlationId, currentRequest => {
221
+ currentRequest.reject(options.createTimeoutError());
222
+ });
223
+ }, options.timeoutMs);
224
+ this.pendingRtdRequests.set(key, request);
225
+ const publishTimestamp = options.publishTimestamp ?? Date.now();
226
+ const acknowledgement = Promise.resolve().then(() => this.sendEvent(options.agentId, options.interactionId, options.eventType, options.eventName, options.eventMetaData, undefined, undefined, publishTimestamp, options.timeout)).catch(error => {
227
+ this.removeRtdRequest(options.rtdEventType, options.correlationId);
228
+ throw error;
229
+ });
230
+ const [payload] = await Promise.all([result, acknowledgement]);
231
+ return payload;
232
+ }
233
+
234
+ /** Resolves a pending request from a parsed RTD event. @internal */
235
+ resolveFromRtdEvent(rtdEventType, correlationId, payload) {
236
+ const request = this.removeRtdRequest(rtdEventType, correlationId, currentRequest => {
237
+ currentRequest.resolve(payload);
238
+ });
239
+ return request ? 'resolved' : 'not-found';
240
+ }
241
+
242
+ /** Clears pending RTD requests when the RTD lifecycle ends. @internal */
243
+ clearAllRtdRequests() {
244
+ Array.from(this.pendingRtdRequests.values()).forEach(request => {
245
+ this.removeRtdRequest(request.rtdEventType, request.correlationId, currentRequest => {
246
+ currentRequest.reject(new Error('RTD request cleared'));
247
+ });
248
+ });
249
+ }
53
250
 
54
251
  /**
55
252
  * Sends an event to the AI Assistant service.
@@ -61,7 +258,7 @@ class ApiAIAssistant {
61
258
  * @param languageCode - language code within eventDetails.data
62
259
  * @param trackingId - tracking identifier within eventDetails.data
63
260
  */
64
- async sendEvent(agentId, interactionId, eventType, eventName, eventMetaData, languageCode, trackingId) {
261
+ async sendEvent(agentId, interactionId, eventType, eventName, eventMetaData, languageCode, trackingId, publishTimestamp, timeout) {
65
262
  _loggerProxy.default.info('Sending event', {
66
263
  module: _constants2.CC_FILE,
67
264
  method: _constants2.METHODS.SEND_EVENT,
@@ -76,23 +273,30 @@ class ApiAIAssistant {
76
273
  try {
77
274
  const baseUrl = this.getBaseUrl();
78
275
  const orgId = this.webex.credentials.getOrgId();
276
+ const data = {
277
+ ...eventMetaData,
278
+ interactionId,
279
+ actionTimeStamp: String(Date.now()),
280
+ languageCode,
281
+ trackingId
282
+ };
79
283
  const response = await this.webex.request({
80
284
  uri: `${baseUrl}${_constants3.AI_ASSISTANT_API_URLS.EVENT}`,
81
285
  method: _types.HTTP_METHODS.POST,
82
286
  addAuthHeader: true,
287
+ ...(timeout !== undefined ? {
288
+ timeout
289
+ } : {}),
83
290
  body: {
84
291
  agentId,
85
292
  orgId,
86
293
  eventType,
87
294
  eventName,
295
+ ...(publishTimestamp !== undefined ? {
296
+ publishTimestamp
297
+ } : {}),
88
298
  eventDetails: {
89
- data: {
90
- ...eventMetaData,
91
- interactionId,
92
- actionTimeStamp: String(Date.now()),
93
- languageCode,
94
- trackingId
95
- }
299
+ data
96
300
  }
97
301
  }
98
302
  });
@@ -279,6 +483,12 @@ class ApiAIAssistant {
279
483
  } = (0, _Utils.getErrorDetails)(new Error('REAL_TIME_TRANSCRIPTION_NOT_ENABLED'), _constants2.METHODS.FETCH_HISTORIC_TRANSCRIPTS, _constants2.CC_FILE);
280
484
  throw detailedError;
281
485
  }
486
+ if (!this.isValidTranscriptIdentifier(agentId) || !this.isValidTranscriptIdentifier(interactionId)) {
487
+ const {
488
+ error: detailedError
489
+ } = (0, _Utils.getErrorDetails)(new Error('INVALID_AGENT_ID_OR_INTERACTION_ID'), _constants2.METHODS.FETCH_HISTORIC_TRANSCRIPTS, _constants2.CC_FILE);
490
+ throw detailedError;
491
+ }
282
492
  try {
283
493
  const baseUrl = this.getBaseUrl();
284
494
  const orgId = this.webex.credentials.getOrgId();