@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.
Files changed (337) hide show
  1. package/.sdd/manifest.json +887 -0
  2. package/AGENTS.md +94 -0
  3. package/ai-docs/ARCHITECTURE.md +168 -0
  4. package/ai-docs/CONTRACTS.md +64 -0
  5. package/ai-docs/GETTING_STARTED.md +168 -0
  6. package/ai-docs/GLOSSARY.md +43 -0
  7. package/ai-docs/README.md +138 -0
  8. package/ai-docs/REVIEW_CHECKLIST.md +41 -0
  9. package/ai-docs/RULES.md +444 -0
  10. package/ai-docs/SECURITY.md +52 -0
  11. package/ai-docs/SERVICE_STATE.md +52 -0
  12. package/ai-docs/SPEC_INDEX.md +65 -0
  13. package/ai-docs/adr/0001-spec-source-policy.md +55 -0
  14. package/ai-docs/adr/README.md +8 -0
  15. package/ai-docs/adr/_adr-template.md +31 -0
  16. package/ai-docs/contact-center-spec.md +388 -0
  17. package/ai-docs/features/consult-transfer-list-policy/spec/feature-spec.md +362 -0
  18. package/ai-docs/features/contact-owner-change-refactor.md +78 -0
  19. package/ai-docs/features/generated-spec-conformance-fidelity-remediation/spec/feature-spec.md +117 -0
  20. package/ai-docs/features/residual-warning-coverage-completion/spec/feature-spec.md +203 -0
  21. package/ai-docs/features/validator-code-fidelity-drift-fix/spec/feature-spec.md +315 -0
  22. package/ai-docs/patterns/event-driven-patterns.md +485 -0
  23. package/ai-docs/patterns/testing-patterns.md +480 -0
  24. package/ai-docs/patterns/typescript-patterns.md +365 -0
  25. package/ai-docs/templates/README.md +102 -0
  26. package/ai-docs/templates/documentation/create-agents-md.md +240 -0
  27. package/ai-docs/templates/documentation/create-architecture-md.md +295 -0
  28. package/ai-docs/templates/existing-service/bug-fix.md +254 -0
  29. package/ai-docs/templates/existing-service/feature-enhancement.md +450 -0
  30. package/ai-docs/templates/new-method/00-master.md +80 -0
  31. package/ai-docs/templates/new-method/01-requirements.md +232 -0
  32. package/ai-docs/templates/new-method/02-implementation.md +295 -0
  33. package/ai-docs/templates/new-method/03-tests.md +201 -0
  34. package/ai-docs/templates/new-method/04-validation.md +141 -0
  35. package/ai-docs/templates/new-service/00-master.md +109 -0
  36. package/ai-docs/templates/new-service/01-pre-questions.md +159 -0
  37. package/ai-docs/templates/new-service/02-code-generation.md +346 -0
  38. package/ai-docs/templates/new-service/03-integration.md +178 -0
  39. package/ai-docs/templates/new-service/04-test-generation.md +205 -0
  40. package/ai-docs/templates/new-service/05-validation.md +145 -0
  41. package/dist/cc.js +1102 -47
  42. package/dist/cc.js.map +1 -1
  43. package/dist/config.js +13 -0
  44. package/dist/config.js.map +1 -1
  45. package/dist/constants.js +46 -3
  46. package/dist/constants.js.map +1 -1
  47. package/dist/index.js +86 -17
  48. package/dist/index.js.map +1 -1
  49. package/dist/metrics/MetricsManager.js +16 -0
  50. package/dist/metrics/MetricsManager.js.map +1 -1
  51. package/dist/metrics/behavioral-events.js +211 -0
  52. package/dist/metrics/behavioral-events.js.map +1 -1
  53. package/dist/metrics/constants.js +58 -4
  54. package/dist/metrics/constants.js.map +1 -1
  55. package/dist/services/AddressBook.js +18 -15
  56. package/dist/services/AddressBook.js.map +1 -1
  57. package/dist/services/AnswerCallOnWebexService.js +202 -0
  58. package/dist/services/AnswerCallOnWebexService.js.map +1 -0
  59. package/dist/services/ApiAiAssistant.js +369 -14
  60. package/dist/services/ApiAiAssistant.js.map +1 -1
  61. package/dist/services/EntryPoint.js +46 -68
  62. package/dist/services/EntryPoint.js.map +1 -1
  63. package/dist/services/Queue.js +27 -22
  64. package/dist/services/Queue.js.map +1 -1
  65. package/dist/services/UserPreference.js +427 -0
  66. package/dist/services/UserPreference.js.map +1 -0
  67. package/dist/services/WebCallingService.js +287 -37
  68. package/dist/services/WebCallingService.js.map +1 -1
  69. package/dist/services/WebexCrossClientService.js +225 -0
  70. package/dist/services/WebexCrossClientService.js.map +1 -0
  71. package/dist/services/WxAppTelephonyMercurySync.js +111 -0
  72. package/dist/services/WxAppTelephonyMercurySync.js.map +1 -0
  73. package/dist/services/config/Util.js +48 -48
  74. package/dist/services/config/Util.js.map +1 -1
  75. package/dist/services/config/constants.js +57 -79
  76. package/dist/services/config/constants.js.map +1 -1
  77. package/dist/services/config/index.js +100 -226
  78. package/dist/services/config/index.js.map +1 -1
  79. package/dist/services/config/types.js +100 -40
  80. package/dist/services/config/types.js.map +1 -1
  81. package/dist/services/constants.js +19 -1
  82. package/dist/services/constants.js.map +1 -1
  83. package/dist/services/core/Err.js.map +1 -1
  84. package/dist/services/core/Utils.js +131 -32
  85. package/dist/services/core/Utils.js.map +1 -1
  86. package/dist/services/core/WebexRequest.js +6 -2
  87. package/dist/services/core/WebexRequest.js.map +1 -1
  88. package/dist/services/core/aqm-reqs.js +17 -11
  89. package/dist/services/core/aqm-reqs.js.map +1 -1
  90. package/dist/services/core/constants.js +9 -1
  91. package/dist/services/core/constants.js.map +1 -1
  92. package/dist/services/core/types.js.map +1 -1
  93. package/dist/services/core/websocket/WebSocketManager.js +26 -6
  94. package/dist/services/core/websocket/WebSocketManager.js.map +1 -1
  95. package/dist/services/core/websocket/connection-service.js +3 -1
  96. package/dist/services/core/websocket/connection-service.js.map +1 -1
  97. package/dist/services/core/websocket/types.js.map +1 -1
  98. package/dist/services/index.js +6 -0
  99. package/dist/services/index.js.map +1 -1
  100. package/dist/services/task/Task.js +955 -0
  101. package/dist/services/task/Task.js.map +1 -0
  102. package/dist/services/task/TaskFactory.js +50 -0
  103. package/dist/services/task/TaskFactory.js.map +1 -0
  104. package/dist/services/task/TaskManager.js +1275 -504
  105. package/dist/services/task/TaskManager.js.map +1 -1
  106. package/dist/services/task/TaskUtils.js +221 -27
  107. package/dist/services/task/TaskUtils.js.map +1 -1
  108. package/dist/services/task/WebexCallingUtils.js +70 -0
  109. package/dist/services/task/WebexCallingUtils.js.map +1 -0
  110. package/dist/services/task/constants.js +22 -2
  111. package/dist/services/task/constants.js.map +1 -1
  112. package/dist/services/task/contact.js +29 -0
  113. package/dist/services/task/contact.js.map +1 -1
  114. package/dist/services/task/dialer.js +78 -0
  115. package/dist/services/task/dialer.js.map +1 -1
  116. package/dist/services/task/digital/Digital.js +78 -0
  117. package/dist/services/task/digital/Digital.js.map +1 -0
  118. package/dist/services/task/state-machine/TaskStateMachine.js +982 -0
  119. package/dist/services/task/state-machine/TaskStateMachine.js.map +1 -0
  120. package/dist/services/task/state-machine/actions.js +572 -0
  121. package/dist/services/task/state-machine/actions.js.map +1 -0
  122. package/dist/services/task/state-machine/constants.js +161 -0
  123. package/dist/services/task/state-machine/constants.js.map +1 -0
  124. package/dist/services/task/state-machine/guards.js +379 -0
  125. package/dist/services/task/state-machine/guards.js.map +1 -0
  126. package/dist/services/task/state-machine/index.js +53 -0
  127. package/dist/services/task/state-machine/index.js.map +1 -0
  128. package/dist/services/task/state-machine/types.js +54 -0
  129. package/dist/services/task/state-machine/types.js.map +1 -0
  130. package/dist/services/task/state-machine/uiControlsComputer.js +703 -0
  131. package/dist/services/task/state-machine/uiControlsComputer.js.map +1 -0
  132. package/dist/services/task/taskDataNormalizer.js +99 -0
  133. package/dist/services/task/taskDataNormalizer.js.map +1 -0
  134. package/dist/services/task/types.js +259 -5
  135. package/dist/services/task/types.js.map +1 -1
  136. package/dist/services/task/voice/Voice.js +1504 -0
  137. package/dist/services/task/voice/Voice.js.map +1 -0
  138. package/dist/services/task/voice/WebRTC.js +152 -0
  139. package/dist/services/task/voice/WebRTC.js.map +1 -0
  140. package/dist/services/task/voice/wxAppOfferObservability.js +145 -0
  141. package/dist/services/task/voice/wxAppOfferObservability.js.map +1 -0
  142. package/dist/services/task/voice/wxAppVoiceMethods.js +395 -0
  143. package/dist/services/task/voice/wxAppVoiceMethods.js.map +1 -0
  144. package/dist/services/wxAppDiagnosticLogging.js +159 -0
  145. package/dist/services/wxAppDiagnosticLogging.js.map +1 -0
  146. package/dist/services/wxAppTelephonyUtils.js +19 -0
  147. package/dist/services/wxAppTelephonyUtils.js.map +1 -0
  148. package/dist/types/cc.d.ts +222 -10
  149. package/dist/types/config.d.ts +13 -0
  150. package/dist/types/constants.d.ts +40 -1
  151. package/dist/types/index.d.ts +58 -22
  152. package/dist/types/metrics/MetricsManager.d.ts +6 -0
  153. package/dist/types/metrics/constants.d.ts +52 -1
  154. package/dist/types/services/AddressBook.d.ts +2 -1
  155. package/dist/types/services/AnswerCallOnWebexService.d.ts +38 -0
  156. package/dist/types/services/ApiAiAssistant.d.ts +67 -5
  157. package/dist/types/services/EntryPoint.d.ts +7 -5
  158. package/dist/types/services/Queue.d.ts +5 -3
  159. package/dist/types/services/UserPreference.d.ts +118 -0
  160. package/dist/types/services/WebexCrossClientService.d.ts +32 -0
  161. package/dist/types/services/WxAppTelephonyMercurySync.d.ts +28 -0
  162. package/dist/types/services/config/Util.d.ts +4 -8
  163. package/dist/types/services/config/constants.d.ts +49 -76
  164. package/dist/types/services/config/index.d.ts +16 -64
  165. package/dist/types/services/config/types.d.ts +252 -114
  166. package/dist/types/services/constants.d.ts +16 -0
  167. package/dist/types/services/core/Err.d.ts +6 -0
  168. package/dist/types/services/core/Utils.d.ts +43 -13
  169. package/dist/types/services/core/WebexRequest.d.ts +1 -0
  170. package/dist/types/services/core/constants.d.ts +7 -0
  171. package/dist/types/services/core/types.d.ts +2 -0
  172. package/dist/types/services/core/websocket/WebSocketManager.d.ts +2 -0
  173. package/dist/types/services/core/websocket/types.d.ts +1 -1
  174. package/dist/types/services/index.d.ts +2 -0
  175. package/dist/types/services/task/Task.d.ts +186 -0
  176. package/dist/types/services/task/TaskFactory.d.ts +14 -0
  177. package/dist/types/services/task/TaskUtils.d.ts +54 -2
  178. package/dist/types/services/task/WebexCallingUtils.d.ts +11 -0
  179. package/dist/types/services/task/constants.d.ts +20 -0
  180. package/dist/types/services/task/contact.d.ts +4 -0
  181. package/dist/types/services/task/dialer.d.ts +30 -0
  182. package/dist/types/services/task/digital/Digital.d.ts +23 -0
  183. package/dist/types/services/task/state-machine/TaskStateMachine.d.ts +1442 -0
  184. package/dist/types/services/task/state-machine/actions.d.ts +10 -0
  185. package/dist/types/services/task/state-machine/constants.d.ts +107 -0
  186. package/dist/types/services/task/state-machine/guards.d.ts +103 -0
  187. package/dist/types/services/task/state-machine/index.d.ts +13 -0
  188. package/dist/types/services/task/state-machine/types.d.ts +277 -0
  189. package/dist/types/services/task/state-machine/uiControlsComputer.d.ts +9 -0
  190. package/dist/types/services/task/taskDataNormalizer.d.ts +10 -0
  191. package/dist/types/services/task/types.d.ts +790 -66
  192. package/dist/types/services/task/voice/Voice.d.ts +241 -0
  193. package/dist/types/services/task/voice/WebRTC.d.ts +54 -0
  194. package/dist/types/services/task/voice/wxAppOfferObservability.d.ts +39 -0
  195. package/dist/types/services/task/voice/wxAppVoiceMethods.d.ts +68 -0
  196. package/dist/types/services/wxAppDiagnosticLogging.d.ts +63 -0
  197. package/dist/types/services/wxAppTelephonyUtils.d.ts +5 -0
  198. package/dist/types/types.d.ts +258 -11
  199. package/dist/types/utils/PageCache.d.ts +20 -3
  200. package/dist/types/webex.d.ts +1 -0
  201. package/dist/types.js +204 -6
  202. package/dist/types.js.map +1 -1
  203. package/dist/utils/PageCache.js +19 -5
  204. package/dist/utils/PageCache.js.map +1 -1
  205. package/dist/webex.js +22 -2
  206. package/dist/webex.js.map +1 -1
  207. package/package.json +16 -12
  208. package/src/cc.ts +1439 -105
  209. package/src/config.ts +13 -0
  210. package/src/constants.ts +53 -1
  211. package/src/index.ts +72 -16
  212. package/src/metrics/MetricsManager.ts +16 -0
  213. package/src/metrics/ai-docs/AGENTS.md +350 -0
  214. package/src/metrics/ai-docs/ARCHITECTURE.md +338 -0
  215. package/src/metrics/ai-docs/metrics-spec.md +971 -0
  216. package/src/metrics/behavioral-events.ts +218 -0
  217. package/src/metrics/constants.ts +63 -4
  218. package/src/services/AddressBook.ts +17 -6
  219. package/src/services/AnswerCallOnWebexService.ts +239 -0
  220. package/src/services/ApiAiAssistant.ts +494 -15
  221. package/src/services/EntryPoint.ts +59 -60
  222. package/src/services/Queue.ts +29 -12
  223. package/src/services/UserPreference.ts +509 -0
  224. package/src/services/WebCallingService.ts +362 -40
  225. package/src/services/WebexCrossClientService.ts +298 -0
  226. package/src/services/WxAppTelephonyMercurySync.ts +142 -0
  227. package/src/services/agent/ai-docs/AGENTS.md +240 -0
  228. package/src/services/agent/ai-docs/ARCHITECTURE.md +304 -0
  229. package/src/services/agent/ai-docs/agent-spec.md +505 -0
  230. package/src/services/ai-docs/AGENTS.md +386 -0
  231. package/src/services/ai-docs/services-spec.md +512 -0
  232. package/src/services/config/Util.ts +54 -84
  233. package/src/services/config/ai-docs/AGENTS.md +250 -0
  234. package/src/services/config/ai-docs/ARCHITECTURE.md +413 -0
  235. package/src/services/config/ai-docs/config-spec.md +669 -0
  236. package/src/services/config/constants.ts +64 -86
  237. package/src/services/config/index.ts +116 -277
  238. package/src/services/config/types.ts +238 -125
  239. package/src/services/constants.ts +18 -0
  240. package/src/services/core/Err.ts +3 -0
  241. package/src/services/core/Utils.ts +151 -37
  242. package/src/services/core/WebexRequest.ts +3 -1
  243. package/src/services/core/ai-docs/AGENTS.md +381 -0
  244. package/src/services/core/ai-docs/ARCHITECTURE.md +698 -0
  245. package/src/services/core/ai-docs/core-spec.md +797 -0
  246. package/src/services/core/aqm-reqs.ts +18 -12
  247. package/src/services/core/constants.ts +8 -0
  248. package/src/services/core/types.ts +33 -1
  249. package/src/services/core/websocket/WebSocketManager.ts +37 -8
  250. package/src/services/core/websocket/connection-service.ts +5 -1
  251. package/src/services/core/websocket/types.ts +1 -1
  252. package/src/services/index.ts +4 -0
  253. package/src/services/task/Task.ts +1211 -0
  254. package/src/services/task/TaskFactory.ts +82 -0
  255. package/src/services/task/TaskManager.ts +1551 -584
  256. package/src/services/task/TaskUtils.ts +316 -25
  257. package/src/services/task/WebexCallingUtils.ts +136 -0
  258. package/src/services/task/ai-docs/AGENTS.md +457 -0
  259. package/src/services/task/ai-docs/ARCHITECTURE.md +595 -0
  260. package/src/services/task/ai-docs/task-spec.md +1501 -0
  261. package/src/services/task/constants.ts +21 -0
  262. package/src/services/task/contact.ts +30 -0
  263. package/src/services/task/dialer.ts +80 -0
  264. package/src/services/task/digital/Digital.ts +102 -0
  265. package/src/services/task/state-machine/TaskStateMachine.ts +1320 -0
  266. package/src/services/task/state-machine/actions.ts +741 -0
  267. package/src/services/task/state-machine/ai-docs/AGENTS.md +460 -0
  268. package/src/services/task/state-machine/ai-docs/ARCHITECTURE.md +1156 -0
  269. package/src/services/task/state-machine/ai-docs/task-state-machine-spec.md +2247 -0
  270. package/src/services/task/state-machine/constants.ts +172 -0
  271. package/src/services/task/state-machine/guards.ts +442 -0
  272. package/src/services/task/state-machine/index.ts +28 -0
  273. package/src/services/task/state-machine/types.ts +258 -0
  274. package/src/services/task/state-machine/uiControlsComputer.ts +1135 -0
  275. package/src/services/task/taskDataNormalizer.ts +137 -0
  276. package/src/services/task/types.ts +974 -70
  277. package/src/services/task/voice/Voice.ts +1878 -0
  278. package/src/services/task/voice/WebRTC.ts +194 -0
  279. package/src/services/task/voice/wxAppOfferObservability.ts +204 -0
  280. package/src/services/task/voice/wxAppVoiceMethods.ts +575 -0
  281. package/src/services/wxAppDiagnosticLogging.ts +286 -0
  282. package/src/services/wxAppTelephonyUtils.ts +14 -0
  283. package/src/types.ts +323 -13
  284. package/src/utils/AGENTS.md +289 -0
  285. package/src/utils/PageCache.ts +38 -5
  286. package/src/utils/ai-docs/utils-spec.md +391 -0
  287. package/src/webex.js +10 -0
  288. package/test/unit/fixtures/aiSummaryTestUtils.ts +40 -0
  289. package/test/unit/spec/cc.ts +4046 -181
  290. package/test/unit/spec/index.ts +891 -0
  291. package/test/unit/spec/logger-proxy.ts +70 -0
  292. package/test/unit/spec/metrics/MetricsManager.ts +25 -0
  293. package/test/unit/spec/metrics/behavioral-events.ts +60 -0
  294. package/test/unit/spec/services/AddressBook.ts +37 -6
  295. package/test/unit/spec/services/AnswerCallOnWebexService.ts +264 -0
  296. package/test/unit/spec/services/ApiAiAssistant.ts +442 -23
  297. package/test/unit/spec/services/EntryPoint.ts +87 -40
  298. package/test/unit/spec/services/Queue.ts +123 -12
  299. package/test/unit/spec/services/UserPreference.ts +401 -0
  300. package/test/unit/spec/services/WebCallingService.ts +484 -49
  301. package/test/unit/spec/services/WebexCrossClientService.ts +509 -0
  302. package/test/unit/spec/services/WxAppTelephonyMercurySync.ts +136 -0
  303. package/test/unit/spec/services/config/Util.ts +501 -0
  304. package/test/unit/spec/services/config/index.ts +318 -548
  305. package/test/unit/spec/services/core/Utils.ts +447 -8
  306. package/test/unit/spec/services/core/WebexRequest.ts +8 -7
  307. package/test/unit/spec/services/core/aqm-reqs.ts +142 -1
  308. package/test/unit/spec/services/core/websocket/WebSocketManager.ts +132 -56
  309. package/test/unit/spec/services/core/websocket/connection-service.ts +3 -1
  310. package/test/unit/spec/services/task/AutoWrapup.ts +63 -0
  311. package/test/unit/spec/services/task/Task.ts +2723 -0
  312. package/test/unit/spec/services/task/TaskFactory.ts +116 -0
  313. package/test/unit/spec/services/task/TaskManager.ts +4800 -1586
  314. package/test/unit/spec/services/task/TaskUtils.ts +307 -0
  315. package/test/unit/spec/services/task/WebexCallingUtils.ts +153 -0
  316. package/test/unit/spec/services/task/contact.ts +33 -0
  317. package/test/unit/spec/services/task/dialer.ts +190 -0
  318. package/test/unit/spec/services/task/digital/Digital.ts +105 -0
  319. package/test/unit/spec/services/task/state-machine/TaskStateMachine.ts +4060 -0
  320. package/test/unit/spec/services/task/state-machine/guards.ts +839 -0
  321. package/test/unit/spec/services/task/state-machine/types.ts +18 -0
  322. package/test/unit/spec/services/task/state-machine/uiControlsComputer.ts +3101 -0
  323. package/test/unit/spec/services/task/taskTestUtils.ts +87 -0
  324. package/test/unit/spec/services/task/voice/Voice.ts +2355 -0
  325. package/test/unit/spec/services/task/voice/WebRTC.ts +235 -0
  326. package/test/unit/spec/services/task/voice/wxAppOfferObservability.ts +361 -0
  327. package/test/unit/spec/services/task/voice/wxAppVoiceMethods.ts +719 -0
  328. package/test/unit/spec/services/wxAppDiagnosticLogging.ts +179 -0
  329. package/test/unit/spec/wellnessSampleUtils.ts +288 -0
  330. package/typedoc.md +1 -1
  331. package/umd/contact-center.min.js +2 -2
  332. package/umd/contact-center.min.js.map +1 -1
  333. package/dist/services/task/index.js +0 -1525
  334. package/dist/services/task/index.js.map +0 -1
  335. package/dist/types/services/task/index.d.ts +0 -650
  336. package/src/services/task/index.ts +0 -1801
  337. package/test/unit/spec/services/task/index.ts +0 -2184
@@ -0,0 +1,891 @@
1
+ import path from 'path';
2
+ import ts from 'typescript';
3
+
4
+ const CONTACT_CENTER_ROOT = path.resolve(__dirname, '../../..');
5
+ const SRC_ROOT = path.join(CONTACT_CENTER_ROOT, 'src');
6
+ const INDEX_PATH = path.join(SRC_ROOT, 'index.ts');
7
+ const TYPES_PATH = path.join(SRC_ROOT, 'types.ts');
8
+ const CONFIG_TYPES_PATH = path.join(SRC_ROOT, 'services/config/types.ts');
9
+
10
+ const EXPECTED_ROOT_EXPORTS = Object.freeze([
11
+ 'AGENT_EVENTS',
12
+ 'AISummaryAction',
13
+ 'AISummary',
14
+ 'AISummaryFeedback',
15
+ 'AISummaryResponse',
16
+ 'AISummarySections',
17
+ 'AISummaryState',
18
+ 'AI_SUMMARY_ERROR_CODES',
19
+ 'AddressBook',
20
+ 'AddressBookEntriesResponse',
21
+ 'AddressBookEntry',
22
+ 'AddressBookEntrySearchParams',
23
+ 'AgentContact',
24
+ 'AgentEvents',
25
+ 'AgentLogin',
26
+ 'AgentProfile',
27
+ 'AgentProfileUpdate',
28
+ 'AgentResponse',
29
+ 'AgentState',
30
+ 'ApiAIAssistant',
31
+ 'AuxCode',
32
+ 'AuxCodeType',
33
+ 'BuddyAgents',
34
+ 'BuddyAgentsResponse',
35
+ 'BuddyAgentsSuccess',
36
+ 'BuddyDetails',
37
+ 'CCPluginConfig',
38
+ 'CC_AGENT_EVENTS',
39
+ 'CC_TASK_EVENTS',
40
+ 'CC_EVENTS',
41
+ 'ConsultEndPayload',
42
+ 'ConsultPayload',
43
+ 'ConsultTransferPayLoad',
44
+ 'ContactCenter',
45
+ 'ContactCenterEvents',
46
+ 'ContactServiceQueue',
47
+ 'ContactServiceQueueSearchParams',
48
+ 'ContactServiceQueuesResponse',
49
+ 'CreateUserPreferenceRequest',
50
+ 'DeviceType',
51
+ 'DeviceTypeUpdateSuccess',
52
+ 'DialPlan',
53
+ 'DialPlanEntity',
54
+ 'DialerPayload',
55
+ 'DropConferenceParticipantPayload',
56
+ 'Entity',
57
+ 'EntryPointListResponse',
58
+ 'EntryPointRecord',
59
+ 'EntryPointSearchParams',
60
+ 'AISummaryFeatureEnablement',
61
+ 'GenericError',
62
+ 'GetUserPreferenceParams',
63
+ 'IContactCenter',
64
+ 'IDLE_CODE',
65
+ 'IEventEmitter',
66
+ 'ITask',
67
+ 'Interaction',
68
+ 'InteractionUIControls',
69
+ 'ListAuxCodesResponse',
70
+ 'ListTeamsResponse',
71
+ 'LoginOption',
72
+ 'Logout',
73
+ 'LogoutSuccess',
74
+ 'MicrosoftConfig',
75
+ 'MultimediaProfileResponse',
76
+ 'OrgDesktopLoginResponse',
77
+ 'OrgInfo',
78
+ 'OrgSettings',
79
+ 'OrgUrlMappings',
80
+ 'Profile',
81
+ 'ReloginSuccess',
82
+ 'RespondToWellnessBreakParams',
83
+ 'ResumeRecordingPayload',
84
+ 'SetStateResponse',
85
+ 'SiteInfo',
86
+ 'StateChange',
87
+ 'StateChangeSuccess',
88
+ 'StationLoginResponse',
89
+ 'StationLoginSuccess',
90
+ 'StationLoginSuccessResponse',
91
+ 'StationLogoutResponse',
92
+ 'SubscribeRequest',
93
+ 'TASK_EVENTS',
94
+ 'Task',
95
+ 'TaskData',
96
+ 'TaskEvents',
97
+ 'TaskResponse',
98
+ 'TaskUIControlState',
99
+ 'TaskUIControls',
100
+ 'TaskUILeg',
101
+ 'TeamList',
102
+ 'TenantData',
103
+ 'TransferPayLoad',
104
+ 'UpdateDeviceTypeResponse',
105
+ 'UpdateUserPreferenceRequest',
106
+ 'UploadLogsResponse',
107
+ 'UserDesktopLoginResponse',
108
+ 'UserPreference',
109
+ 'UserPreferenceData',
110
+ 'UserStationLogin',
111
+ 'VOICE_CONNECTION_ERROR',
112
+ 'VOICE_CONNECTION_EVENTS',
113
+ 'VOICE_CONNECTION_STATUS',
114
+ 'VoiceConnectionState',
115
+ 'VoiceLineStatus',
116
+ 'VoiceMobiusSocketStatus',
117
+ 'WELLNESS_BREAK_NOTIFICATION_ACTIONS',
118
+ 'WELLNESS_BREAK_USER_ACTIONS',
119
+ 'WRAP_UP_CODE',
120
+ 'WebSocketEvent',
121
+ 'WebexConfig',
122
+ 'WebexSDK',
123
+ 'WellnessBreakEvent',
124
+ 'WellnessBreakNotificationAction',
125
+ 'WellnessBreakUserAction',
126
+ 'WrapUpReason',
127
+ 'WrapupData',
128
+ 'WrapupPayLoad',
129
+ 'default',
130
+ 'getDefaultUIControls',
131
+ 'routingAgent',
132
+ ]);
133
+
134
+ const INTERNAL_ROOT_EXPORTS = Object.freeze([
135
+ 'AIAssistantEventName',
136
+ 'AISummaryTimeoutCodeByInboundType',
137
+ 'AI_SUMMARY_DURATION_MS',
138
+ 'AI_SUMMARY_REQUEST_CANCELLED',
139
+ 'AI_ASSISTANT_CLIENT_TYPE',
140
+ ]);
141
+
142
+ const EXPECTED_AI_SUMMARY_ERROR_CODES = Object.freeze([
143
+ ['POST_CALL_SUMMARY_DISABLED', 'POST_CALL_SUMMARY_DISABLED'],
144
+ ['MID_CALL_SUMMARY_DISABLED', 'MID_CALL_SUMMARY_DISABLED'],
145
+ ['AI_ASSISTANT_BASE_URL_NOT_AVAILABLE', 'AI_ASSISTANT_BASE_URL_NOT_AVAILABLE'],
146
+ ['POST_CALL_SUMMARY_TIMEOUT', 'POST_CALL_SUMMARY_TIMEOUT'],
147
+ ['MID_CALL_SUMMARY_TIMEOUT', 'MID_CALL_SUMMARY_TIMEOUT'],
148
+ ]);
149
+
150
+ const EXPECTED_AI_SUMMARY_WIRE_LITERALS = Object.freeze({
151
+ AIAssistantEventName: Object.freeze({
152
+ GET_POST_CALL_SUMMARY: 'GET_POST_CALL_SUMMARY',
153
+ GET_MID_CALL_CONSULT_SUMMARY: 'GET_MID_CALL_CONSULT_SUMMARY',
154
+ GET_MID_CALL_TRANSFER_SUMMARY: 'GET_MID_CALL_TRANSFER_SUMMARY',
155
+ POST_CALL_SUMMARY_RESPONSE: 'POST_CALL_SUMMARY_RESPONSE',
156
+ MID_CALL_CONSULT_SUMMARY_RESPONSE: 'MID_CALL_CONSULT_SUMMARY_RESPONSE',
157
+ MID_CALL_TRANSFER_SUMMARY_RESPONSE: 'MID_CALL_TRANSFER_SUMMARY_RESPONSE',
158
+ }),
159
+ CC_TASK_EVENTS: Object.freeze({
160
+ REAL_TIME_TRANSCRIPTION: 'REAL_TIME_TRANSCRIPTION',
161
+ SUGGESTED_RESPONSE: 'SUGGESTED_RESPONSE',
162
+ SUGGESTED_RESPONSE_ACKNOWLEDGE: 'SUGGESTED_RESPONSE_ACKNOWLEDGE',
163
+ POST_CALL_SUMMARY: 'POST_CALL_SUMMARY',
164
+ MID_CALL_SUMMARY: 'MID_CALL_SUMMARY',
165
+ FEATURE_ENABLEMENT: 'FEATURE_ENABLEMENT',
166
+ MID_CALL_SUMMARY_RESPONSE_SUBSEQUENT_AGENT: 'MID_CALL_SUMMARY_RESPONSE_SUBSEQUENT_AGENT',
167
+ }),
168
+ });
169
+
170
+ const MISSING_EXPORT_DIAGNOSTIC_CODES = Object.freeze([2305, 2614, 2724]);
171
+
172
+ const VALID_PUBLIC_CONTRACT_FIXTURE = `
173
+ import {
174
+ AI_SUMMARY_ERROR_CODES,
175
+ CC_TASK_EVENTS,
176
+ TASK_EVENTS,
177
+ } from '../../../src';
178
+ import type {
179
+ AISummaryAction,
180
+ AISummaryFeedback,
181
+ AISummaryResponse,
182
+ AISummaryFeatureEnablement,
183
+ ITask,
184
+ } from '../../../src';
185
+
186
+ const action: AISummaryAction = 'CONSULT';
187
+ const transferAction: AISummaryAction = 'TRANSFER';
188
+ const feedback: AISummaryFeedback = 'thumbs_down';
189
+ const postCallEnabledTrue: AISummaryFeatureEnablement = {
190
+ interactionId: 'post-call-true',
191
+ postCallEnabled: true,
192
+ };
193
+ const postCallEnabledFalse: AISummaryFeatureEnablement = {
194
+ interactionId: 'post-call-false',
195
+ postCallEnabled: false,
196
+ };
197
+ const postCallEnabledOmitted: AISummaryFeatureEnablement = {
198
+ interactionId: 'post-call-omitted',
199
+ midCallEnabled: true,
200
+ };
201
+ const midCallEnabledTrue: AISummaryFeatureEnablement = {
202
+ interactionId: 'mid-call-true',
203
+ midCallEnabled: true,
204
+ };
205
+ const midCallEnabledFalse: AISummaryFeatureEnablement = {
206
+ interactionId: 'mid-call-false',
207
+ midCallEnabled: false,
208
+ };
209
+ const midCallEnabledOmitted: AISummaryFeatureEnablement = {
210
+ interactionId: 'mid-call-omitted',
211
+ postCallEnabled: true,
212
+ };
213
+
214
+ const structuredPostCall: AISummaryResponse = {
215
+ summary: {
216
+ initialContactReason: 'billing',
217
+ additionalContactReasons: 'renewal',
218
+ additionalContext: 'caller asked for an email',
219
+ keyActionsTaken: 'verified account',
220
+ nextSteps: 'send receipt',
221
+ },
222
+ feedback,
223
+ state: 'DEFAULT',
224
+ wrapUpCode: 'resolved',
225
+ numberOfTimesViewed: 1,
226
+ numberOfTimesEdited: 0,
227
+ numberOfTimesCopied: 0,
228
+ };
229
+ const textPostCall: AISummaryResponse = {
230
+ summary: 'plain post call summary',
231
+ feedback: 'thumbs_up',
232
+ state: 'IGNORED',
233
+ wrapUpCode: 'ignored',
234
+ numberOfTimesViewed: 2,
235
+ numberOfTimesEdited: 1,
236
+ numberOfTimesCopied: 1,
237
+ };
238
+ const noPostCallSummary: AISummaryResponse = {
239
+ summary: '',
240
+ feedback: 'none',
241
+ state: 'NOT_RECEIVED',
242
+ wrapUpCode: 'not-received',
243
+ numberOfTimesViewed: 0,
244
+ numberOfTimesEdited: 0,
245
+ numberOfTimesCopied: 0,
246
+ };
247
+
248
+ const structuredMidCall: AISummaryResponse = {
249
+ summaryReceived: true,
250
+ summary: {
251
+ reasonForTransferOrConsult: 'expert needed',
252
+ additionalContext: 'customer has prior ticket',
253
+ keyActionsTaken: 'authenticated caller',
254
+ },
255
+ feedback: 'none',
256
+ state: 'EXCLUDED',
257
+ numberOfTimesViewed: 1,
258
+ numberOfTimesEdited: 0,
259
+ numberOfTimesCopied: 0,
260
+ };
261
+ const textMidCall: AISummaryResponse = {
262
+ summaryReceived: true,
263
+ summary: 'plain mid call summary',
264
+ feedback: 'thumbs_up',
265
+ state: 'MID_CALL_CANCELLED',
266
+ numberOfTimesViewed: 0,
267
+ numberOfTimesEdited: 0,
268
+ numberOfTimesCopied: 0,
269
+ };
270
+ const unavailableMidCall: AISummaryResponse = {
271
+ summaryReceived: false,
272
+ summary: '',
273
+ feedback: 'thumbs_down',
274
+ state: 'NOT_RECEIVED',
275
+ numberOfTimesViewed: 0,
276
+ numberOfTimesEdited: 0,
277
+ numberOfTimesCopied: 0,
278
+ };
279
+ const cancelledMidCall: AISummaryResponse = {
280
+ summaryReceived: false,
281
+ summary: '',
282
+ feedback: 'none',
283
+ state: 'MID_CALL_CANCELLED',
284
+ numberOfTimesViewed: 0,
285
+ numberOfTimesEdited: 0,
286
+ numberOfTimesCopied: 0,
287
+ };
288
+
289
+ const taskSummaryMethods: Pick<
290
+ ITask,
291
+ | 'requestPostCallSummary'
292
+ | 'sendPostCallSummaryResponse'
293
+ | 'requestMidCallSummary'
294
+ | 'sendMidCallSummaryResponse'
295
+ > = {
296
+ requestPostCallSummary: async () => ({conversationId: 'conversation-1'}),
297
+ sendPostCallSummaryResponse: async (payload) => {
298
+ const responseState = payload.state;
299
+ void responseState;
300
+ },
301
+ requestMidCallSummary: async (requestedAction) => {
302
+ const selectedAction: AISummaryAction = requestedAction;
303
+ void selectedAction;
304
+ return {conversationId: 'conversation-1'};
305
+ },
306
+ sendMidCallSummaryResponse: async (payload, requestedAction) => {
307
+ const selectedAction: AISummaryAction = requestedAction;
308
+ const responseState = payload.state;
309
+ void selectedAction;
310
+ void responseState;
311
+ },
312
+ };
313
+
314
+ const inboundPost = CC_TASK_EVENTS.POST_CALL_SUMMARY;
315
+ const receivingEvent = TASK_EVENTS.TASK_MID_CALL_SUMMARY_RECEIVED;
316
+ const disabledCode = AI_SUMMARY_ERROR_CODES.POST_CALL_SUMMARY_DISABLED;
317
+ void action;
318
+ void transferAction;
319
+ void postCallEnabledTrue;
320
+ void postCallEnabledFalse;
321
+ void postCallEnabledOmitted;
322
+ void midCallEnabledTrue;
323
+ void midCallEnabledFalse;
324
+ void midCallEnabledOmitted;
325
+ void structuredPostCall;
326
+ void textPostCall;
327
+ void noPostCallSummary;
328
+ void structuredMidCall;
329
+ void textMidCall;
330
+ void unavailableMidCall;
331
+ void cancelledMidCall;
332
+ void taskSummaryMethods;
333
+ void inboundPost;
334
+ void receivingEvent;
335
+ void disabledCode;
336
+ `;
337
+
338
+ const createInternalRootImportFixture = () => `
339
+ import {
340
+ ${INTERNAL_ROOT_EXPORTS.map((name) => ` ${name},`).join('\n')}
341
+ } from '../../../src';
342
+
343
+ void [
344
+ ${INTERNAL_ROOT_EXPORTS.map((name) => ` ${name},`).join('\n')}
345
+ ];
346
+ `;
347
+
348
+ const INVALID_PUBLIC_CONTRACT_FIXTURE = `
349
+ import {
350
+ type AISummaryAction,
351
+ type AISummaryResponse,
352
+ type AISummaryFeatureEnablement,
353
+ } from '../../../src';
354
+
355
+ let invalidAction: AISummaryAction;
356
+ // @ts-expect-error invalid summary action type must not widen
357
+ invalidAction = 'WRAP_UP';
358
+ void invalidAction;
359
+
360
+ // @ts-expect-error postCallEnabled must stay boolean; string values must not satisfy the public flag contract
361
+ const invalidPostCallEnabledString: AISummaryFeatureEnablement = {interactionId: 'interaction-1', postCallEnabled: 'true'};
362
+ void invalidPostCallEnabledString;
363
+
364
+ // @ts-expect-error postCallEnabled must stay boolean; number values must not satisfy the public flag contract
365
+ const invalidPostCallEnabledNumber: AISummaryFeatureEnablement = {interactionId: 'interaction-2', postCallEnabled: 1};
366
+ void invalidPostCallEnabledNumber;
367
+
368
+ // @ts-expect-error midCallEnabled must stay boolean; string values must not satisfy the public flag contract
369
+ const invalidMidCallEnabledString: AISummaryFeatureEnablement = {interactionId: 'interaction-3', midCallEnabled: 'false'};
370
+ void invalidMidCallEnabledString;
371
+
372
+ // @ts-expect-error midCallEnabled must stay boolean; number values must not satisfy the public flag contract
373
+ const invalidMidCallEnabledNumber: AISummaryFeatureEnablement = {interactionId: 'interaction-4', midCallEnabled: 0};
374
+ void invalidMidCallEnabledNumber;
375
+
376
+ // @ts-expect-error invalid summary feedback must not be accepted
377
+ const invalidFeedback: AISummaryResponse = {summary: 'x', feedback: 'ok', state: 'DEFAULT', wrapUpCode: 'wrap', numberOfTimesViewed: 1, numberOfTimesEdited: 0, numberOfTimesCopied: 0};
378
+ void invalidFeedback;
379
+
380
+ // @ts-expect-error summaryReceived must stay boolean when supplied
381
+ const invalidDiscriminator: AISummaryResponse = {summaryReceived: 'true', summary: 'x', feedback: 'none', state: 'DEFAULT', numberOfTimesViewed: 1, numberOfTimesEdited: 0, numberOfTimesCopied: 0};
382
+ void invalidDiscriminator;
383
+
384
+ // @ts-expect-error unknown summary states must not be accepted
385
+ const invalidSummaryState: AISummaryResponse = {summaryReceived: true, summary: 'x', feedback: 'none', state: 'POST_CALL_ONLY', numberOfTimesViewed: 1, numberOfTimesEdited: 0, numberOfTimesCopied: 0};
386
+ void invalidSummaryState;
387
+
388
+ // @ts-expect-error actionTimeStamp is transport metadata generated by the SDK
389
+ const invalidActionTimestamp: AISummaryResponse = {summary: 'x', feedback: 'none', state: 'DEFAULT', numberOfTimesViewed: 1, numberOfTimesEdited: 0, numberOfTimesCopied: 0, actionTimeStamp: 100};
390
+ void invalidActionTimestamp;
391
+
392
+ // @ts-expect-error publishTimestamp is transport metadata generated by the SDK
393
+ const invalidPublishTimestamp: AISummaryResponse = {summary: 'x', feedback: 'none', state: 'DEFAULT', numberOfTimesViewed: 1, numberOfTimesEdited: 0, numberOfTimesCopied: 0, publishTimestamp: 100};
394
+ void invalidPublishTimestamp;
395
+ `;
396
+
397
+ const LEGACY_TASK_CALL_CONTROL_CONTRACT_FIXTURE = `
398
+ import type {
399
+ ITask,
400
+ TaskResponse,
401
+ } from '../../../src';
402
+
403
+ type IsExact<Actual, Expected> =
404
+ (<Value>() => Value extends Actual ? 1 : 2) extends
405
+ (<Value>() => Value extends Expected ? 1 : 2)
406
+ ? (<Value>() => Value extends Expected ? 1 : 2) extends
407
+ (<Value>() => Value extends Actual ? 1 : 2)
408
+ ? true
409
+ : false
410
+ : false;
411
+ type AssertExact<Actual extends true> = Actual;
412
+
413
+ type ExpectedWrapupParameters = [
414
+ wrapupPayload: {
415
+ wrapUpReason: string;
416
+ auxCodeId: string;
417
+ },
418
+ ];
419
+ type ExpectedConsultParameters = [
420
+ consultPayload: {
421
+ to: string | undefined;
422
+ destinationType: string;
423
+ holdParticipants?: boolean;
424
+ },
425
+ ];
426
+ type ExpectedTransferParameters = [
427
+ transferPayload: {
428
+ to: string;
429
+ destinationType: string;
430
+ },
431
+ options?: {
432
+ [key: string]: unknown;
433
+ },
434
+ ];
435
+
436
+ type WrapupParametersAreRetained = AssertExact<
437
+ IsExact<Parameters<ITask['wrapup']>, ExpectedWrapupParameters>
438
+ >;
439
+ type WrapupReturnIsRetained = AssertExact<
440
+ IsExact<ReturnType<ITask['wrapup']>, Promise<TaskResponse>>
441
+ >;
442
+ type ConsultParametersAreRetained = AssertExact<
443
+ IsExact<Parameters<ITask['consult']>, ExpectedConsultParameters>
444
+ >;
445
+ type ConsultReturnIsRetained = AssertExact<
446
+ IsExact<ReturnType<ITask['consult']>, Promise<TaskResponse>>
447
+ >;
448
+ type TransferParametersAreRetained = AssertExact<
449
+ IsExact<Parameters<ITask['transfer']>, ExpectedTransferParameters>
450
+ >;
451
+ type TransferReturnIsRetained = AssertExact<
452
+ IsExact<ReturnType<ITask['transfer']>, Promise<TaskResponse>>
453
+ >;
454
+
455
+ declare const task: ITask;
456
+
457
+ const wrapupResult: Promise<TaskResponse> = task.wrapup({
458
+ wrapUpReason: 'Customer issue resolved',
459
+ auxCodeId: 'RESOLVED',
460
+ });
461
+ const consultResult: Promise<TaskResponse> = task.consult({
462
+ to: 'agent-1',
463
+ destinationType: 'agent',
464
+ });
465
+ const consultWithOptionalHoldResult: Promise<TaskResponse> = task.consult({
466
+ to: undefined,
467
+ destinationType: 'queue',
468
+ holdParticipants: true,
469
+ });
470
+ const transferResult: Promise<TaskResponse> = task.transfer({
471
+ to: 'queue-1',
472
+ destinationType: 'queue',
473
+ });
474
+ const transferWithOptionsResult: Promise<TaskResponse> = task.transfer(
475
+ {
476
+ to: 'agent-2',
477
+ destinationType: 'agent',
478
+ },
479
+ {trackingId: 'transfer-1'}
480
+ );
481
+
482
+ // @ts-expect-error wrapup must keep requiring its retained payload tuple
483
+ task.wrapup();
484
+ // @ts-expect-error wrapup payload must keep auxCodeId as a required field
485
+ task.wrapup({wrapUpReason: 'Customer issue resolved'});
486
+ // @ts-expect-error wrapup payload must not accept AI summary response fields threaded into the call control API
487
+ task.wrapup({wrapUpReason: 'Customer issue resolved', auxCodeId: 'RESOLVED', actionTimeStamp: 100});
488
+ // @ts-expect-error wrapup payload must not accept post-call summary state as a control argument
489
+ task.wrapup({wrapUpReason: 'Customer issue resolved', auxCodeId: 'RESOLVED', state: 'DEFAULT'});
490
+
491
+ // @ts-expect-error consult must keep requiring its retained payload tuple
492
+ task.consult();
493
+ // @ts-expect-error consult payload must keep destinationType as a string
494
+ task.consult({to: 'agent-1', destinationType: 1});
495
+ // @ts-expect-error consult payload must not accept mid-call summary action fields threaded into the payload
496
+ task.consult({to: 'agent-1', destinationType: 'agent', actionType: 'CONSULT'});
497
+ // @ts-expect-error consult must not accept a feature action as a second argument
498
+ task.consult({to: 'agent-1', destinationType: 'agent'}, 'CONSULT');
499
+
500
+ // @ts-expect-error transfer must keep requiring its retained payload tuple
501
+ task.transfer();
502
+ // @ts-expect-error transfer payload must keep to as a required string field
503
+ task.transfer({destinationType: 'queue'});
504
+ // @ts-expect-error transfer payload must keep destinationType as a string
505
+ task.transfer({to: 'queue-1', destinationType: 1});
506
+ // @ts-expect-error transfer payload must not accept mid-call summary action fields threaded into the payload
507
+ task.transfer({to: 'agent-2', destinationType: 'agent', actionType: 'TRANSFER'});
508
+ // @ts-expect-error transfer options must not be replaced by a feature action argument
509
+ task.transfer({to: 'agent-2', destinationType: 'agent'}, 'TRANSFER');
510
+ // @ts-expect-error transfer must not accept a third feature action argument
511
+ task.transfer({to: 'agent-2', destinationType: 'agent'}, {trackingId: 'transfer-2'}, 'TRANSFER');
512
+
513
+ void wrapupResult;
514
+ void consultResult;
515
+ void consultWithOptionalHoldResult;
516
+ void transferResult;
517
+ void transferWithOptionsResult;
518
+ `;
519
+
520
+ const createProgram = (virtualSources: Record<string, string> = {}) => {
521
+ const configPath = path.join(CONTACT_CENTER_ROOT, 'tsconfig.json');
522
+ const configFile = ts.readConfigFile(configPath, ts.sys.readFile);
523
+ const parsed = ts.parseJsonConfigFileContent(
524
+ configFile.config,
525
+ ts.sys,
526
+ CONTACT_CENTER_ROOT,
527
+ {emitDeclarationOnly: false, noEmit: true},
528
+ configPath
529
+ );
530
+ const virtualFileNames = Object.keys(virtualSources);
531
+ const host = ts.createCompilerHost(parsed.options, true);
532
+ const originalGetSourceFile = host.getSourceFile.bind(host);
533
+ const originalFileExists = host.fileExists.bind(host);
534
+ const originalReadFile = host.readFile.bind(host);
535
+
536
+ host.getSourceFile = (fileName, languageVersion, onError, shouldCreateNewSourceFile) => {
537
+ const normalizedFileName = path.normalize(fileName);
538
+ if (Object.prototype.hasOwnProperty.call(virtualSources, normalizedFileName)) {
539
+ return ts.createSourceFile(
540
+ normalizedFileName,
541
+ virtualSources[normalizedFileName],
542
+ languageVersion,
543
+ true
544
+ );
545
+ }
546
+
547
+ return originalGetSourceFile(
548
+ fileName,
549
+ languageVersion,
550
+ onError,
551
+ shouldCreateNewSourceFile
552
+ );
553
+ };
554
+
555
+ host.fileExists = (fileName) => {
556
+ const normalizedFileName = path.normalize(fileName);
557
+ return Object.prototype.hasOwnProperty.call(virtualSources, normalizedFileName)
558
+ ? true
559
+ : originalFileExists(fileName);
560
+ };
561
+
562
+ host.readFile = (fileName) => {
563
+ const normalizedFileName = path.normalize(fileName);
564
+ return Object.prototype.hasOwnProperty.call(virtualSources, normalizedFileName)
565
+ ? virtualSources[normalizedFileName]
566
+ : originalReadFile(fileName);
567
+ };
568
+
569
+ return ts.createProgram([...parsed.fileNames, ...virtualFileNames], parsed.options, host);
570
+ };
571
+
572
+ const getRootModuleSymbol = (program: ts.Program) => {
573
+ const checker = program.getTypeChecker();
574
+ const indexSource = program.getSourceFile(INDEX_PATH);
575
+ if (!indexSource) {
576
+ throw new Error(`Missing source file ${INDEX_PATH}`);
577
+ }
578
+ const moduleSymbol = checker.getSymbolAtLocation(indexSource);
579
+ if (!moduleSymbol) {
580
+ throw new Error('Unable to resolve contact-center root module symbol');
581
+ }
582
+
583
+ return moduleSymbol;
584
+ };
585
+
586
+ const getRootExportNames = (program: ts.Program) => {
587
+ const checker = program.getTypeChecker();
588
+
589
+ return checker
590
+ .getExportsOfModule(getRootModuleSymbol(program))
591
+ .map((symbol) => symbol.getName())
592
+ .sort();
593
+ };
594
+
595
+ const getRootExportSymbol = (program: ts.Program, exportName: string) => {
596
+ return getModuleExportSymbol(program, INDEX_PATH, exportName);
597
+ };
598
+
599
+ const getModuleExportSymbol = (
600
+ program: ts.Program,
601
+ modulePath: string,
602
+ exportName: string
603
+ ) => {
604
+ const checker = program.getTypeChecker();
605
+ const sourceFile = program.getSourceFile(modulePath);
606
+ if (!sourceFile) {
607
+ throw new Error(`Missing source file ${modulePath}`);
608
+ }
609
+
610
+ const moduleSymbol = checker.getSymbolAtLocation(sourceFile);
611
+ if (!moduleSymbol) {
612
+ throw new Error(`Unable to resolve module symbol ${modulePath}`);
613
+ }
614
+
615
+ const exportSymbol = checker
616
+ .getExportsOfModule(moduleSymbol)
617
+ .find((symbol) => symbol.getName() === exportName);
618
+
619
+ if (!exportSymbol) {
620
+ throw new Error(`Missing root export ${exportName}`);
621
+ }
622
+
623
+ return resolveSymbol(checker, exportSymbol);
624
+ };
625
+
626
+ const getDiagnosticsForFiles = (program: ts.Program, fileNames: string[]) =>
627
+ ts.getPreEmitDiagnostics(program).filter((diagnostic) => {
628
+ const fileName = diagnostic.file?.fileName;
629
+
630
+ return !!fileName && fileNames.includes(fileName);
631
+ });
632
+
633
+ const getMissingExportNameFromDiagnostic = (diagnostic: ts.Diagnostic) => {
634
+ const message = ts.flattenDiagnosticMessageText(diagnostic.messageText, '\n');
635
+ const match = message.match(/has no exported member(?: named)? '([^']+)'/);
636
+
637
+ if (!match) {
638
+ throw new Error(`Unexpected TS${diagnostic.code} diagnostic: ${message}`);
639
+ }
640
+
641
+ return match[1];
642
+ };
643
+
644
+ const getCanonicalMissingExportDiagnosticCode = (diagnostic: ts.Diagnostic) => {
645
+ if (
646
+ MISSING_EXPORT_DIAGNOSTIC_CODES.includes(diagnostic.code) &&
647
+ getMissingExportNameFromDiagnostic(diagnostic)
648
+ ) {
649
+ return 2305;
650
+ }
651
+
652
+ return diagnostic.code;
653
+ };
654
+
655
+ const getObjectLiteralInitializer = (symbol: ts.Symbol | undefined, symbolName: string) => {
656
+ const declaration = symbol?.valueDeclaration ?? symbol?.declarations?.[0];
657
+
658
+ if (!declaration || !ts.isVariableDeclaration(declaration)) {
659
+ throw new Error(`Root export ${symbolName} does not resolve to a variable declaration`);
660
+ }
661
+
662
+ let initializer = declaration.initializer;
663
+ if (!initializer) {
664
+ throw new Error(`Root export ${symbolName} is missing an initializer`);
665
+ }
666
+
667
+ while (ts.isAsExpression(initializer)) {
668
+ initializer = initializer.expression;
669
+ }
670
+
671
+ if (!ts.isObjectLiteralExpression(initializer)) {
672
+ throw new Error(`Root export ${symbolName} does not resolve to an object literal`);
673
+ }
674
+
675
+ return initializer;
676
+ };
677
+
678
+ const getStringLiteralObjectEntries = (objectLiteral: ts.ObjectLiteralExpression) =>
679
+ objectLiteral.properties.map((property) => {
680
+ if (
681
+ !ts.isPropertyAssignment(property) ||
682
+ !ts.isIdentifier(property.name) ||
683
+ !ts.isStringLiteral(property.initializer)
684
+ ) {
685
+ throw new Error('Expected string-literal object property assignment');
686
+ }
687
+
688
+ return [property.name.text, property.initializer.text];
689
+ });
690
+
691
+ const getNamedStringLiteralObjectEntries = (
692
+ objectLiteral: ts.ObjectLiteralExpression,
693
+ propertyNames: string[],
694
+ symbolName: string
695
+ ) =>
696
+ propertyNames.map((propertyName) => {
697
+ const property = objectLiteral.properties.find(
698
+ (candidate): candidate is ts.PropertyAssignment =>
699
+ ts.isPropertyAssignment(candidate) &&
700
+ ts.isIdentifier(candidate.name) &&
701
+ candidate.name.text === propertyName
702
+ );
703
+
704
+ if (!property) {
705
+ throw new Error(`Missing ${symbolName}.${propertyName}`);
706
+ }
707
+
708
+ if (!ts.isStringLiteral(property.initializer)) {
709
+ throw new Error(`Expected ${symbolName}.${propertyName} to be a string literal`);
710
+ }
711
+
712
+ return [propertyName, property.initializer.text];
713
+ });
714
+
715
+ const getObjectLiteralVariableInitializer = (
716
+ sourceFile: ts.SourceFile,
717
+ variableName: string
718
+ ) => {
719
+ let objectLiteral: ts.ObjectLiteralExpression | undefined;
720
+
721
+ const visit = (node: ts.Node) => {
722
+ if (
723
+ ts.isVariableDeclaration(node) &&
724
+ ts.isIdentifier(node.name) &&
725
+ node.name.text === variableName &&
726
+ node.initializer
727
+ ) {
728
+ const initializer = ts.isAsExpression(node.initializer)
729
+ ? node.initializer.expression
730
+ : node.initializer;
731
+
732
+ if (!ts.isObjectLiteralExpression(initializer)) {
733
+ throw new Error(`${variableName} does not resolve to an object literal`);
734
+ }
735
+
736
+ objectLiteral = initializer;
737
+ return;
738
+ }
739
+
740
+ ts.forEachChild(node, visit);
741
+ };
742
+
743
+ visit(sourceFile);
744
+
745
+ if (!objectLiteral) {
746
+ throw new Error(`Missing ${variableName} object literal`);
747
+ }
748
+
749
+ return objectLiteral;
750
+ };
751
+
752
+ const getObjectLiteralPropertyAssignment = (
753
+ objectLiteral: ts.ObjectLiteralExpression,
754
+ propertyName: string,
755
+ symbolName: string
756
+ ) => {
757
+ const property = objectLiteral.properties.find(
758
+ (candidate): candidate is ts.PropertyAssignment =>
759
+ ts.isPropertyAssignment(candidate) &&
760
+ ts.isIdentifier(candidate.name) &&
761
+ candidate.name.text === propertyName
762
+ );
763
+
764
+ if (!property) {
765
+ throw new Error(`Missing ${symbolName}.${propertyName}`);
766
+ }
767
+
768
+ return property;
769
+ };
770
+
771
+ const entriesToObject = (entries: string[][]) =>
772
+ entries.reduce<Record<string, string>>((accumulator, [name, value]) => {
773
+ accumulator[name] = value;
774
+
775
+ return accumulator;
776
+ }, {});
777
+
778
+ const resolveSymbol = (checker: ts.TypeChecker, symbol: ts.Symbol | undefined) => {
779
+ if (!symbol) return undefined;
780
+
781
+ return symbol.flags & ts.SymbolFlags.Alias ? checker.getAliasedSymbol(symbol) : symbol;
782
+ };
783
+
784
+ describe('contact-center root public contract', () => {
785
+ it('preserves the literal root barrel export list and omits package internals', () => {
786
+ const program = createProgram();
787
+ const exportNames = getRootExportNames(program);
788
+
789
+ expect(exportNames).toEqual([...EXPECTED_ROOT_EXPORTS].sort());
790
+ INTERNAL_ROOT_EXPORTS.forEach((name) => {
791
+ expect(exportNames).not.toContain(name);
792
+ });
793
+ });
794
+
795
+ it('rejects root imports of package internals with TS2305 diagnostics', () => {
796
+ const internalFixture = path.join(
797
+ CONTACT_CENTER_ROOT,
798
+ 'test/unit/spec/__root_internals.ts'
799
+ );
800
+ const program = createProgram({
801
+ [internalFixture]: createInternalRootImportFixture(),
802
+ });
803
+ const diagnostics = getDiagnosticsForFiles(program, [internalFixture]);
804
+
805
+ expect(diagnostics.map(getCanonicalMissingExportDiagnosticCode)).toEqual(
806
+ INTERNAL_ROOT_EXPORTS.map(() => 2305)
807
+ );
808
+ expect(diagnostics.map(getMissingExportNameFromDiagnostic).sort()).toEqual(
809
+ [...INTERNAL_ROOT_EXPORTS].sort()
810
+ );
811
+ });
812
+
813
+ it('re-exports the exact AI summary error code object from the root symbol', () => {
814
+ const program = createProgram();
815
+ const errorCodeEntries = getStringLiteralObjectEntries(
816
+ getObjectLiteralInitializer(
817
+ getRootExportSymbol(program, 'AI_SUMMARY_ERROR_CODES'),
818
+ 'AI_SUMMARY_ERROR_CODES'
819
+ )
820
+ );
821
+
822
+ expect(errorCodeEntries).toEqual(EXPECTED_AI_SUMMARY_ERROR_CODES);
823
+ });
824
+
825
+ it('pins AI summary wire event literals to the backend contract', () => {
826
+ const program = createProgram();
827
+ const aiAssistantEventNameLiterals = entriesToObject(
828
+ getNamedStringLiteralObjectEntries(
829
+ getObjectLiteralInitializer(
830
+ getModuleExportSymbol(program, TYPES_PATH, 'AIAssistantEventName'),
831
+ 'AIAssistantEventName'
832
+ ),
833
+ Object.keys(EXPECTED_AI_SUMMARY_WIRE_LITERALS.AIAssistantEventName),
834
+ 'AIAssistantEventName'
835
+ )
836
+ );
837
+ const ccAISummaryEventLiterals = entriesToObject(
838
+ getNamedStringLiteralObjectEntries(
839
+ getObjectLiteralInitializer(
840
+ getRootExportSymbol(program, 'CC_TASK_EVENTS'),
841
+ 'CC_TASK_EVENTS'
842
+ ),
843
+ Object.keys(EXPECTED_AI_SUMMARY_WIRE_LITERALS.CC_TASK_EVENTS),
844
+ 'CC_TASK_EVENTS'
845
+ )
846
+ );
847
+
848
+ expect({
849
+ AIAssistantEventName: aiAssistantEventNameLiterals,
850
+ CC_TASK_EVENTS: ccAISummaryEventLiterals,
851
+ }).toEqual(EXPECTED_AI_SUMMARY_WIRE_LITERALS);
852
+ });
853
+
854
+ it('type-checks public AI summary assignments and keeps invalid branches narrow', () => {
855
+ const validFixture = path.join(CONTACT_CENTER_ROOT, 'test/unit/spec/__ai_summary_valid.ts');
856
+ const invalidFixture = path.join(
857
+ CONTACT_CENTER_ROOT,
858
+ 'test/unit/spec/__ai_summary_invalid.ts'
859
+ );
860
+ const program = createProgram({
861
+ [validFixture]: VALID_PUBLIC_CONTRACT_FIXTURE,
862
+ [invalidFixture]: INVALID_PUBLIC_CONTRACT_FIXTURE,
863
+ });
864
+ const fixtureDiagnostics = getDiagnosticsForFiles(program, [validFixture, invalidFixture]);
865
+
866
+ expect(
867
+ fixtureDiagnostics.map((diagnostic) => ({
868
+ code: diagnostic.code,
869
+ message: ts.flattenDiagnosticMessageText(diagnostic.messageText, '\n'),
870
+ }))
871
+ ).toEqual([]);
872
+ });
873
+
874
+ it('pins retained ITask wrapup, consult, and transfer signatures', () => {
875
+ const legacyTaskContractFixture = path.join(
876
+ CONTACT_CENTER_ROOT,
877
+ 'test/unit/spec/__legacy_task_call_control_contract.ts'
878
+ );
879
+ const program = createProgram({
880
+ [legacyTaskContractFixture]: LEGACY_TASK_CALL_CONTROL_CONTRACT_FIXTURE,
881
+ });
882
+ const fixtureDiagnostics = getDiagnosticsForFiles(program, [legacyTaskContractFixture]);
883
+
884
+ expect(
885
+ fixtureDiagnostics.map((diagnostic) => ({
886
+ code: diagnostic.code,
887
+ message: ts.flattenDiagnosticMessageText(diagnostic.messageText, '\n'),
888
+ }))
889
+ ).toEqual([]);
890
+ });
891
+ });