@webex/contact-center 3.12.0 → 3.13.0-next.10

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 (297) hide show
  1. package/.repo-context.json +704 -0
  2. package/.sdd/manifest.json +1613 -0
  3. package/AGENTS.md +969 -0
  4. package/dist/cc.js +1102 -47
  5. package/dist/cc.js.map +1 -1
  6. package/dist/config.js +13 -0
  7. package/dist/config.js.map +1 -1
  8. package/dist/constants.js +46 -3
  9. package/dist/constants.js.map +1 -1
  10. package/dist/index.js +86 -17
  11. package/dist/index.js.map +1 -1
  12. package/dist/metrics/MetricsManager.js +16 -0
  13. package/dist/metrics/MetricsManager.js.map +1 -1
  14. package/dist/metrics/behavioral-events.js +211 -0
  15. package/dist/metrics/behavioral-events.js.map +1 -1
  16. package/dist/metrics/constants.js +58 -4
  17. package/dist/metrics/constants.js.map +1 -1
  18. package/dist/services/AddressBook.js +18 -15
  19. package/dist/services/AddressBook.js.map +1 -1
  20. package/dist/services/AnswerCallOnWebexService.js +202 -0
  21. package/dist/services/AnswerCallOnWebexService.js.map +1 -0
  22. package/dist/services/ApiAiAssistant.js +369 -14
  23. package/dist/services/ApiAiAssistant.js.map +1 -1
  24. package/dist/services/EntryPoint.js +46 -68
  25. package/dist/services/EntryPoint.js.map +1 -1
  26. package/dist/services/Queue.js +27 -22
  27. package/dist/services/Queue.js.map +1 -1
  28. package/dist/services/UserPreference.js +427 -0
  29. package/dist/services/UserPreference.js.map +1 -0
  30. package/dist/services/WebCallingService.js +287 -37
  31. package/dist/services/WebCallingService.js.map +1 -1
  32. package/dist/services/WebexCrossClientService.js +225 -0
  33. package/dist/services/WebexCrossClientService.js.map +1 -0
  34. package/dist/services/WxAppTelephonyMercurySync.js +111 -0
  35. package/dist/services/WxAppTelephonyMercurySync.js.map +1 -0
  36. package/dist/services/config/Util.js +48 -48
  37. package/dist/services/config/Util.js.map +1 -1
  38. package/dist/services/config/constants.js +57 -79
  39. package/dist/services/config/constants.js.map +1 -1
  40. package/dist/services/config/index.js +100 -226
  41. package/dist/services/config/index.js.map +1 -1
  42. package/dist/services/config/types.js +100 -40
  43. package/dist/services/config/types.js.map +1 -1
  44. package/dist/services/constants.js +19 -1
  45. package/dist/services/constants.js.map +1 -1
  46. package/dist/services/core/Err.js.map +1 -1
  47. package/dist/services/core/Utils.js +131 -32
  48. package/dist/services/core/Utils.js.map +1 -1
  49. package/dist/services/core/WebexRequest.js +6 -2
  50. package/dist/services/core/WebexRequest.js.map +1 -1
  51. package/dist/services/core/aqm-reqs.js +17 -11
  52. package/dist/services/core/aqm-reqs.js.map +1 -1
  53. package/dist/services/core/constants.js +9 -1
  54. package/dist/services/core/constants.js.map +1 -1
  55. package/dist/services/core/types.js.map +1 -1
  56. package/dist/services/core/websocket/WebSocketManager.js +26 -6
  57. package/dist/services/core/websocket/WebSocketManager.js.map +1 -1
  58. package/dist/services/core/websocket/connection-service.js +3 -1
  59. package/dist/services/core/websocket/connection-service.js.map +1 -1
  60. package/dist/services/core/websocket/types.js.map +1 -1
  61. package/dist/services/index.js +6 -0
  62. package/dist/services/index.js.map +1 -1
  63. package/dist/services/task/Task.js +955 -0
  64. package/dist/services/task/Task.js.map +1 -0
  65. package/dist/services/task/TaskFactory.js +50 -0
  66. package/dist/services/task/TaskFactory.js.map +1 -0
  67. package/dist/services/task/TaskManager.js +1275 -504
  68. package/dist/services/task/TaskManager.js.map +1 -1
  69. package/dist/services/task/TaskUtils.js +221 -27
  70. package/dist/services/task/TaskUtils.js.map +1 -1
  71. package/dist/services/task/WebexCallingUtils.js +70 -0
  72. package/dist/services/task/WebexCallingUtils.js.map +1 -0
  73. package/dist/services/task/constants.js +22 -2
  74. package/dist/services/task/constants.js.map +1 -1
  75. package/dist/services/task/contact.js +29 -0
  76. package/dist/services/task/contact.js.map +1 -1
  77. package/dist/services/task/dialer.js +78 -0
  78. package/dist/services/task/dialer.js.map +1 -1
  79. package/dist/services/task/digital/Digital.js +78 -0
  80. package/dist/services/task/digital/Digital.js.map +1 -0
  81. package/dist/services/task/state-machine/TaskStateMachine.js +982 -0
  82. package/dist/services/task/state-machine/TaskStateMachine.js.map +1 -0
  83. package/dist/services/task/state-machine/actions.js +572 -0
  84. package/dist/services/task/state-machine/actions.js.map +1 -0
  85. package/dist/services/task/state-machine/constants.js +161 -0
  86. package/dist/services/task/state-machine/constants.js.map +1 -0
  87. package/dist/services/task/state-machine/guards.js +379 -0
  88. package/dist/services/task/state-machine/guards.js.map +1 -0
  89. package/dist/services/task/state-machine/index.js +53 -0
  90. package/dist/services/task/state-machine/index.js.map +1 -0
  91. package/dist/services/task/state-machine/types.js +54 -0
  92. package/dist/services/task/state-machine/types.js.map +1 -0
  93. package/dist/services/task/state-machine/uiControlsComputer.js +703 -0
  94. package/dist/services/task/state-machine/uiControlsComputer.js.map +1 -0
  95. package/dist/services/task/taskDataNormalizer.js +99 -0
  96. package/dist/services/task/taskDataNormalizer.js.map +1 -0
  97. package/dist/services/task/types.js +259 -5
  98. package/dist/services/task/types.js.map +1 -1
  99. package/dist/services/task/voice/Voice.js +1504 -0
  100. package/dist/services/task/voice/Voice.js.map +1 -0
  101. package/dist/services/task/voice/WebRTC.js +152 -0
  102. package/dist/services/task/voice/WebRTC.js.map +1 -0
  103. package/dist/services/task/voice/wxAppOfferObservability.js +145 -0
  104. package/dist/services/task/voice/wxAppOfferObservability.js.map +1 -0
  105. package/dist/services/task/voice/wxAppVoiceMethods.js +395 -0
  106. package/dist/services/task/voice/wxAppVoiceMethods.js.map +1 -0
  107. package/dist/services/wxAppDiagnosticLogging.js +159 -0
  108. package/dist/services/wxAppDiagnosticLogging.js.map +1 -0
  109. package/dist/services/wxAppTelephonyUtils.js +19 -0
  110. package/dist/services/wxAppTelephonyUtils.js.map +1 -0
  111. package/dist/types/cc.d.ts +222 -10
  112. package/dist/types/config.d.ts +13 -0
  113. package/dist/types/constants.d.ts +40 -1
  114. package/dist/types/index.d.ts +58 -22
  115. package/dist/types/metrics/MetricsManager.d.ts +6 -0
  116. package/dist/types/metrics/constants.d.ts +52 -1
  117. package/dist/types/services/AddressBook.d.ts +2 -1
  118. package/dist/types/services/AnswerCallOnWebexService.d.ts +38 -0
  119. package/dist/types/services/ApiAiAssistant.d.ts +67 -5
  120. package/dist/types/services/EntryPoint.d.ts +7 -5
  121. package/dist/types/services/Queue.d.ts +5 -3
  122. package/dist/types/services/UserPreference.d.ts +118 -0
  123. package/dist/types/services/WebexCrossClientService.d.ts +32 -0
  124. package/dist/types/services/WxAppTelephonyMercurySync.d.ts +28 -0
  125. package/dist/types/services/config/Util.d.ts +4 -8
  126. package/dist/types/services/config/constants.d.ts +49 -76
  127. package/dist/types/services/config/index.d.ts +16 -64
  128. package/dist/types/services/config/types.d.ts +252 -114
  129. package/dist/types/services/constants.d.ts +16 -0
  130. package/dist/types/services/core/Err.d.ts +6 -0
  131. package/dist/types/services/core/Utils.d.ts +43 -13
  132. package/dist/types/services/core/WebexRequest.d.ts +1 -0
  133. package/dist/types/services/core/constants.d.ts +7 -0
  134. package/dist/types/services/core/types.d.ts +2 -0
  135. package/dist/types/services/core/websocket/WebSocketManager.d.ts +2 -0
  136. package/dist/types/services/core/websocket/types.d.ts +1 -1
  137. package/dist/types/services/index.d.ts +2 -0
  138. package/dist/types/services/task/Task.d.ts +186 -0
  139. package/dist/types/services/task/TaskFactory.d.ts +14 -0
  140. package/dist/types/services/task/TaskUtils.d.ts +54 -2
  141. package/dist/types/services/task/WebexCallingUtils.d.ts +11 -0
  142. package/dist/types/services/task/constants.d.ts +20 -0
  143. package/dist/types/services/task/contact.d.ts +4 -0
  144. package/dist/types/services/task/dialer.d.ts +30 -0
  145. package/dist/types/services/task/digital/Digital.d.ts +23 -0
  146. package/dist/types/services/task/state-machine/TaskStateMachine.d.ts +1442 -0
  147. package/dist/types/services/task/state-machine/actions.d.ts +10 -0
  148. package/dist/types/services/task/state-machine/constants.d.ts +107 -0
  149. package/dist/types/services/task/state-machine/guards.d.ts +103 -0
  150. package/dist/types/services/task/state-machine/index.d.ts +13 -0
  151. package/dist/types/services/task/state-machine/types.d.ts +277 -0
  152. package/dist/types/services/task/state-machine/uiControlsComputer.d.ts +9 -0
  153. package/dist/types/services/task/taskDataNormalizer.d.ts +10 -0
  154. package/dist/types/services/task/types.d.ts +790 -66
  155. package/dist/types/services/task/voice/Voice.d.ts +241 -0
  156. package/dist/types/services/task/voice/WebRTC.d.ts +54 -0
  157. package/dist/types/services/task/voice/wxAppOfferObservability.d.ts +39 -0
  158. package/dist/types/services/task/voice/wxAppVoiceMethods.d.ts +68 -0
  159. package/dist/types/services/wxAppDiagnosticLogging.d.ts +63 -0
  160. package/dist/types/services/wxAppTelephonyUtils.d.ts +5 -0
  161. package/dist/types/types.d.ts +258 -11
  162. package/dist/types/utils/PageCache.d.ts +20 -3
  163. package/dist/types/webex.d.ts +1 -0
  164. package/dist/types.js +204 -6
  165. package/dist/types.js.map +1 -1
  166. package/dist/utils/PageCache.js +19 -5
  167. package/dist/utils/PageCache.js.map +1 -1
  168. package/dist/webex.js +22 -2
  169. package/dist/webex.js.map +1 -1
  170. package/docs/adr/0001-spec-source-policy.md +97 -0
  171. package/docs/adr/0002-consult-transfer-list-policy.md +345 -0
  172. package/docs/adr/0003-repo-standards-migration.md +104 -0
  173. package/docs/adr/index.md +35 -0
  174. package/docs/architecture.md +460 -0
  175. package/docs/getting-started.md +142 -0
  176. package/docs/index.md +53 -0
  177. package/docs/specs/README.md +98 -0
  178. package/package.json +17 -12
  179. package/schemas/repo-context.schema.json +796 -0
  180. package/src/cc.ts +1439 -105
  181. package/src/config.ts +13 -0
  182. package/src/constants.ts +53 -1
  183. package/src/docs/README.md +727 -0
  184. package/src/index.ts +72 -16
  185. package/src/metrics/MetricsManager.ts +16 -0
  186. package/src/metrics/behavioral-events.ts +218 -0
  187. package/src/metrics/constants.ts +63 -4
  188. package/src/metrics/docs/README.md +710 -0
  189. package/src/services/AddressBook.ts +17 -6
  190. package/src/services/AnswerCallOnWebexService.ts +239 -0
  191. package/src/services/ApiAiAssistant.ts +494 -15
  192. package/src/services/EntryPoint.ts +59 -60
  193. package/src/services/Queue.ts +29 -12
  194. package/src/services/UserPreference.ts +509 -0
  195. package/src/services/WebCallingService.ts +362 -40
  196. package/src/services/WebexCrossClientService.ts +298 -0
  197. package/src/services/WxAppTelephonyMercurySync.ts +142 -0
  198. package/src/services/agent/docs/README.md +673 -0
  199. package/src/services/config/Util.ts +54 -84
  200. package/src/services/config/constants.ts +64 -86
  201. package/src/services/config/docs/README.md +530 -0
  202. package/src/services/config/index.ts +116 -277
  203. package/src/services/config/types.ts +238 -125
  204. package/src/services/constants.ts +18 -0
  205. package/src/services/core/Err.ts +3 -0
  206. package/src/services/core/Utils.ts +151 -37
  207. package/src/services/core/WebexRequest.ts +3 -1
  208. package/src/services/core/aqm-reqs.ts +18 -12
  209. package/src/services/core/constants.ts +8 -0
  210. package/src/services/core/docs/README.md +993 -0
  211. package/src/services/core/types.ts +33 -1
  212. package/src/services/core/websocket/WebSocketManager.ts +37 -8
  213. package/src/services/core/websocket/connection-service.ts +5 -1
  214. package/src/services/core/websocket/types.ts +1 -1
  215. package/src/services/docs/README.md +765 -0
  216. package/src/services/index.ts +4 -0
  217. package/src/services/task/Task.ts +1211 -0
  218. package/src/services/task/TaskFactory.ts +82 -0
  219. package/src/services/task/TaskManager.ts +1551 -584
  220. package/src/services/task/TaskUtils.ts +316 -25
  221. package/src/services/task/WebexCallingUtils.ts +136 -0
  222. package/src/services/task/constants.ts +21 -0
  223. package/src/services/task/contact.ts +30 -0
  224. package/src/services/task/dialer.ts +80 -0
  225. package/src/services/task/digital/Digital.ts +102 -0
  226. package/src/services/task/docs/README.md +1569 -0
  227. package/src/services/task/state-machine/TaskStateMachine.ts +1320 -0
  228. package/src/services/task/state-machine/actions.ts +741 -0
  229. package/src/services/task/state-machine/constants.ts +172 -0
  230. package/src/services/task/state-machine/docs/README.md +1388 -0
  231. package/src/services/task/state-machine/guards.ts +442 -0
  232. package/src/services/task/state-machine/index.ts +28 -0
  233. package/src/services/task/state-machine/types.ts +258 -0
  234. package/src/services/task/state-machine/uiControlsComputer.ts +1135 -0
  235. package/src/services/task/taskDataNormalizer.ts +137 -0
  236. package/src/services/task/types.ts +974 -70
  237. package/src/services/task/voice/Voice.ts +1878 -0
  238. package/src/services/task/voice/WebRTC.ts +194 -0
  239. package/src/services/task/voice/wxAppOfferObservability.ts +204 -0
  240. package/src/services/task/voice/wxAppVoiceMethods.ts +575 -0
  241. package/src/services/wxAppDiagnosticLogging.ts +286 -0
  242. package/src/services/wxAppTelephonyUtils.ts +14 -0
  243. package/src/types.ts +323 -13
  244. package/src/utils/AGENTS.md +291 -0
  245. package/src/utils/PageCache.ts +38 -5
  246. package/src/utils/docs/README.md +413 -0
  247. package/src/webex.js +10 -0
  248. package/test/unit/fixtures/aiSummaryTestUtils.ts +40 -0
  249. package/test/unit/spec/cc.ts +4046 -181
  250. package/test/unit/spec/index.ts +891 -0
  251. package/test/unit/spec/logger-proxy.ts +70 -0
  252. package/test/unit/spec/metrics/MetricsManager.ts +25 -0
  253. package/test/unit/spec/metrics/behavioral-events.ts +60 -0
  254. package/test/unit/spec/services/AddressBook.ts +37 -6
  255. package/test/unit/spec/services/AnswerCallOnWebexService.ts +264 -0
  256. package/test/unit/spec/services/ApiAiAssistant.ts +442 -23
  257. package/test/unit/spec/services/EntryPoint.ts +87 -40
  258. package/test/unit/spec/services/Queue.ts +123 -12
  259. package/test/unit/spec/services/UserPreference.ts +401 -0
  260. package/test/unit/spec/services/WebCallingService.ts +484 -49
  261. package/test/unit/spec/services/WebexCrossClientService.ts +509 -0
  262. package/test/unit/spec/services/WxAppTelephonyMercurySync.ts +136 -0
  263. package/test/unit/spec/services/config/Util.ts +501 -0
  264. package/test/unit/spec/services/config/index.ts +318 -548
  265. package/test/unit/spec/services/core/Utils.ts +447 -8
  266. package/test/unit/spec/services/core/WebexRequest.ts +8 -7
  267. package/test/unit/spec/services/core/aqm-reqs.ts +142 -1
  268. package/test/unit/spec/services/core/websocket/WebSocketManager.ts +132 -56
  269. package/test/unit/spec/services/core/websocket/connection-service.ts +3 -1
  270. package/test/unit/spec/services/task/AutoWrapup.ts +63 -0
  271. package/test/unit/spec/services/task/Task.ts +2723 -0
  272. package/test/unit/spec/services/task/TaskFactory.ts +116 -0
  273. package/test/unit/spec/services/task/TaskManager.ts +4800 -1586
  274. package/test/unit/spec/services/task/TaskUtils.ts +307 -0
  275. package/test/unit/spec/services/task/WebexCallingUtils.ts +153 -0
  276. package/test/unit/spec/services/task/contact.ts +33 -0
  277. package/test/unit/spec/services/task/dialer.ts +190 -0
  278. package/test/unit/spec/services/task/digital/Digital.ts +105 -0
  279. package/test/unit/spec/services/task/state-machine/TaskStateMachine.ts +4060 -0
  280. package/test/unit/spec/services/task/state-machine/guards.ts +839 -0
  281. package/test/unit/spec/services/task/state-machine/types.ts +18 -0
  282. package/test/unit/spec/services/task/state-machine/uiControlsComputer.ts +3101 -0
  283. package/test/unit/spec/services/task/taskTestUtils.ts +87 -0
  284. package/test/unit/spec/services/task/voice/Voice.ts +2355 -0
  285. package/test/unit/spec/services/task/voice/WebRTC.ts +235 -0
  286. package/test/unit/spec/services/task/voice/wxAppOfferObservability.ts +361 -0
  287. package/test/unit/spec/services/task/voice/wxAppVoiceMethods.ts +719 -0
  288. package/test/unit/spec/services/wxAppDiagnosticLogging.ts +179 -0
  289. package/test/unit/spec/wellnessSampleUtils.ts +288 -0
  290. package/typedoc.md +1 -1
  291. package/umd/contact-center.min.js +2 -2
  292. package/umd/contact-center.min.js.map +1 -1
  293. package/dist/services/task/index.js +0 -1525
  294. package/dist/services/task/index.js.map +0 -1
  295. package/dist/types/services/task/index.d.ts +0 -650
  296. package/src/services/task/index.ts +0 -1801
  297. package/test/unit/spec/services/task/index.ts +0 -2184
package/docs/index.md ADDED
@@ -0,0 +1,53 @@
1
+ ---
2
+ okf_version: '0.1'
3
+ ---
4
+ <!-- sdd-generated-metadata
5
+ doc_kind: standing-doc
6
+ generated_from: docs-index@0.3.0
7
+ generated_by: claude-code
8
+ approved_by: rarajes2@cisco.com
9
+ updated_at: 2026-11-17T03:03:58Z
10
+ validation_status: pass-with-warnings
11
+ -->
12
+
13
+ # @webex/contact-center documentation
14
+
15
+ Doc map for developers and agents working on the Contact Center SDK plugin (`webex.cc`). The package
16
+ overview, technologies, and runtime composition are in the [package architecture](architecture.md).
17
+
18
+ ## Start here
19
+
20
+ - [Getting started](getting-started.md)
21
+ - [Package architecture](architecture.md)
22
+
23
+ Start with the package [`AGENTS.md`](../AGENTS.md) for critical repository rules and the developer workflow, then use the [specification registry](specs/README.md) to classify the task by owning module and open its module specification.
24
+
25
+ This package is a library, so there is no service specification and no OpenAPI document.
26
+
27
+ ## Decisions
28
+
29
+ - [adr/](adr/index.md) — architectural decision records
30
+
31
+ ## Specifications and contracts
32
+
33
+ - [architecture.md](architecture.md) — canonical package architecture and the contract index
34
+ - [specs/README.md](specs/README.md) — manifest-backed module and contract registry
35
+ - `docs/README.md` inside each module directory — each manifest-routed module has one canonical
36
+ module specification beside its code, listed in the [Module registry](specs/README.md#module-registry);
37
+ the retained module-level `src/utils/AGENTS.md` guide is a reference-only migration source, as recorded in
38
+ [ADR-0003](adr/0003-repo-standards-migration.md)
39
+ - [adr/](adr/index.md) — concrete architectural decisions; blank ADR templates remain under the
40
+ monorepo root `.sdd/`
41
+
42
+ Exact contract details live in the native sources linked from the architecture contract index:
43
+ `package.json` for the published entry points, `src/index.ts` for the exports, and the TypeScript type
44
+ files named there for the events and payloads. To change behavior, follow the Working Method in
45
+ [`AGENTS.md`](../AGENTS.md); update the package `AGENTS.md` when task routing or critical rules change, and do not update the retained `src/utils/AGENTS.md` as an independent source of truth.
46
+
47
+ ## Related repository resources
48
+
49
+ - [`README.md`](../README.md) — npm package page
50
+ - [`typedoc.md`](../typedoc.md) — landing page of the generated API reference (`yarn workspace @webex/contact-center build:docs`)
51
+ - [`src/utils/AGENTS.md`](../src/utils/AGENTS.md) — retained Utils guide; reference-only
52
+ - The Contact Center sample app is in the workspace `docs/samples/contact-center` folder; the
53
+ end-to-end suite in the workspace `cc_playwright` folder drives it.
@@ -0,0 +1,98 @@
1
+ ---
2
+ type: Reference
3
+ title: Specification registry
4
+ description: Canonical specification registry and change-routing guide.
5
+ tags: [specifications, registry]
6
+ ---
7
+ <!-- sdd-generated-metadata
8
+ doc_kind: standing-doc
9
+ generated_from: spec-index@0.3.0
10
+ generated_by: claude-code
11
+ approved_by: rarajes2@cisco.com
12
+ updated_at: 2026-11-17T03:03:58Z
13
+ validation_status: pass-with-warnings
14
+ -->
15
+
16
+ # Specification registry
17
+
18
+ Use this page to find the canonical package architecture and every instantiated module specification
19
+ plus native contract for `@webex/contact-center`. Keep technical facts in one owning document and use
20
+ this page only for navigation, ownership, status, and change/test routing. This registry mirrors
21
+ `.sdd/manifest.json`, which stays authoritative.
22
+
23
+ Start with the [package architecture](../architecture.md). No service specification exists because
24
+ this package is a library: `package.json` has no start script or deployment descriptor
25
+ (`layout.artifact_decisions` in `.sdd/manifest.json`).
26
+
27
+ ## Document roles
28
+
29
+ | Document | Canonical ownership |
30
+ | -------- | ------------------- |
31
+ | [Package architecture](../architecture.md) | Package boundaries, resource inventory, interactions, dependency topology, cross-cutting architecture, the contract index, domain language, and the security architecture |
32
+ | [Getting started](../getting-started.md) | Prerequisites, install, build, and the test router with the manifest commands |
33
+ | Module specifications | Stable behavior and design at each manifest-routed `docs/README.md` beside the module code |
34
+ | [ADR](../adr/index.md) | A durable decision, its deciders, rationale, consequences, and supersession lineage |
35
+ | [Package agent instructions](../../AGENTS.md) | Agent rules, the development workflow, coding patterns, and the review checklist |
36
+
37
+ ## Instantiated specification registry
38
+
39
+ | Resource | Role | Canonical path | Owner | Status | Last verified |
40
+ | -------- | ---- | -------------- | ----- | ------ | ------------- |
41
+ | Package | Architecture | `docs/architecture.md` | @webex/web-sdk | Active | 2026-11-16 |
42
+ | Contact Center public plugin | Module | `src/docs/README.md` | @webex/web-sdk | Active | 2026-11-16 |
43
+ | Metrics | Module | `src/metrics/docs/README.md` | @webex/web-sdk | Active | 2026-11-16 |
44
+ | Services composition | Module | `src/services/docs/README.md` | @webex/web-sdk | Active | 2026-11-16 |
45
+ | Agent | Module | `src/services/agent/docs/README.md` | @webex/web-sdk | Active | 2026-11-16 |
46
+ | Config | Module | `src/services/config/docs/README.md` | @webex/web-sdk | Active | 2026-11-16 |
47
+ | Core | Module | `src/services/core/docs/README.md` | @webex/web-sdk | Active | 2026-11-16 |
48
+ | Task | Module | `src/services/task/docs/README.md` | @webex/web-sdk | Active | 2026-11-16 |
49
+ | Task state machine | Module | `src/services/task/state-machine/docs/README.md` | @webex/web-sdk | Active | 2026-11-16 |
50
+ | Utils | Module | `src/utils/docs/README.md` | @webex/web-sdk | Active | 2026-11-16 |
51
+ | Spec source policy | ADR | `docs/adr/0001-spec-source-policy.md` | @webex/web-sdk | Superseded | 2026-11-16 |
52
+ | Consult and transfer list policy | ADR | `docs/adr/0002-consult-transfer-list-policy.md` | @webex/web-sdk | Accepted | 2026-11-16 |
53
+ | Repo-standards migration | ADR | `docs/adr/0003-repo-standards-migration.md` | @webex/web-sdk | Accepted | 2026-11-16 |
54
+
55
+ ### Module registry
56
+
57
+ | Module | Responsibility | Manifest coverage state | Start here |
58
+ | --- | --- | --- | --- |
59
+ | `src/` | Own the published Webex Contact Center SDK plugin surface, registration lifecycle, public method delegation, and application-facing event routing. | Partial | `src/docs/README.md` |
60
+ | ↳ `src/metrics/` | Own timing, taxonomy, queuing, payload preparation, and submission for Contact Center behavioral, operational, and business telemetry. | Partial | `src/metrics/docs/README.md` |
61
+ | ↳ `src/services/` | Own composition and bootstrap order for backend request and realtime collaborators (the Services singleton), plus the direct REST data, user preference, AI assistant, and WebRTC service classes that ContactCenter constructs. | Partial | `src/services/docs/README.md` |
62
+ | ↳ ↳ `src/services/agent/` | Own agent login, logout, state-change, buddy-agent, and reload request contracts; ContactCenter uses reload for silent relogin and stationLogin for device updates. | Partial | `src/services/agent/docs/README.md` |
63
+ | ↳ ↳ `src/services/config/` | Own retrieval and aggregation of remote organization, agent, team, profile, auxiliary-code, dial-plan, and feature configuration. | Partial | `src/services/config/docs/README.md` |
64
+ | ↳ ↳ `src/services/core/` | Own authenticated HTTP, realtime WebSocket lifecycle, AQM request correlation, reconnect/keepalive behavior, and shared error normalization. | Partial | `src/services/core/docs/README.md` |
65
+ | ↳ ↳ `src/services/task/` | Own task creation, media-specific behavior, call-control operations, lifecycle orchestration, task events, and integration with the task state machine. | Partial | `src/services/task/docs/README.md` |
66
+ | ↳ ↳ ↳ `src/services/task/state-machine/` | Own deterministic task lifecycle states, transition guards/actions, typed internal events, and state-derived UI-control availability. | Partial | `src/services/task/state-machine/docs/README.md` |
67
+ | ↳ `src/utils/` | Own shared pagination contracts and the bounded in-memory page cache used by Contact Center data services. | Partial | `src/utils/docs/README.md` |
68
+
69
+ All nine modules remain `Partial` in `.sdd/manifest.json`; coverage review is pending. Independent
70
+ validation on 2026-11-17 passed with warnings (0 Blocking, 0 Important, 4 Minor). No coverage promotion was performed.
71
+
72
+ Three documentation-only correction records from July 2026 (a validator drift fix, a residual-warning
73
+ completion, and a conformance and fidelity remediation) are folded into the nine module specifications.
74
+
75
+ ## Change and verification routing
76
+
77
+ | Change affects | Load and update | Verification route |
78
+ | -------------- | --------------- | ------------------ |
79
+ | Package boundaries or cross-cutting architecture | `docs/architecture.md` and applicable ADRs | `yarn workspace @webex/contact-center build:src`, `yarn workspace @webex/contact-center test:unit`, and `yarn workspace @webex/contact-center test:style`, plus the affected module specs |
80
+ | A stable code, package, or component boundary | Its module spec from the Module registry | Module tests under `test/unit/spec`, plus affected contracts |
81
+ | A public API, event, or exported type | The owning module spec, the contract index in `docs/architecture.md`, `src/index.ts`, and `.sdd/manifest.json` `contract_catalog` | `yarn workspace @webex/contact-center build` for declarations, then `yarn workspace @webex/contact-center test:unit`; `test/unit/spec/index.ts` covers the root exports |
82
+ | Consult and transfer destination lists or controls | ADR-0002, the Contact Center, Services, Utils, Task, and Task state machine specs | `test/unit/spec/cc.ts`, `test/unit/spec/services/Queue.ts`, `test/unit/spec/services/EntryPoint.ts`, `test/unit/spec/services/AddressBook.ts`, `test/unit/spec/services/task/state-machine/uiControlsComputer.ts` |
83
+ | Task state or lifecycle transitions | The Task and Task state machine module specs | `test/unit/spec/services/task/state-machine/TaskStateMachine.ts`, `test/unit/spec/services/task/TaskManager.ts` |
84
+ | Transport, reconnect, or recovery | The Core module spec and the security architecture in `docs/architecture.md` | `test/unit/spec/services/core/aqm-reqs.ts`, `test/unit/spec/services/core/websocket/connection-service.ts`, `test/unit/spec/cc.ts` |
85
+ | A new feature or defect | The affected module specs, then the Working Method in `AGENTS.md` | The verification route of each affected row above |
86
+
87
+ ## Module and contract registration
88
+
89
+ Each module specification is generated at the exact `modules[].canonical_spec` path recorded in
90
+ `.sdd/manifest.json`. Register every module and submodule in the Module registry above in manifest
91
+ tree order; a new module needs a manifest entry, its module spec, and its contracts.
92
+
93
+ Contracts are registered in `.sdd/manifest.json` `contract_catalog` with a stable ID, publication
94
+ state, native source, and owning module, and indexed in the
95
+ [package architecture](../architecture.md#public-and-consumer-surfaces). The published surface is the
96
+ npm package (`contact-center-sdk`, native source `package.json`) and its event enums; the Contact
97
+ Center REST and WebSocket contracts are external and consumed, so the package has no OpenAPI document.
98
+ This page provides navigation and ownership rather than a copied contract.
package/package.json CHANGED
@@ -33,7 +33,8 @@
33
33
  },
34
34
  "scripts": {
35
35
  "build:src": "webex-legacy-tools build -dest \"./dist\" -src \"./src\" -js -ts -maps && yarn build",
36
- "build": " yarn workspace @webex/calling run build:src && yarn run -T tsc --declaration true --declarationDir ./dist/types",
36
+ "build": " yarn workspace @webex/calling run build:src && yarn exec tsc --declaration true --declarationDir ./dist/types",
37
+ "compile": "yarn workspaces foreach -tR --from @webex/contact-center run build:src",
37
38
  "fix:lint": "eslint 'src/**/*.ts' --fix",
38
39
  "build:docs": "typedoc --out ../../../docs/wxcc",
39
40
  "fix:prettier": "prettier \"src/**/*.ts\" --write",
@@ -41,19 +42,22 @@
41
42
  "test": "yarn test:style && yarn test:unit",
42
43
  "test:style": "eslint 'src/**/*.ts'",
43
44
  "test:unit": "webex-legacy-tools test --unit --runner jest",
45
+ "test:e2e": "yarn run -T playwright test --config=../../../playwright.config.ts",
44
46
  "deploy:npm": "yarn npm publish"
45
47
  },
46
48
  "dependencies": {
47
49
  "@types/platform": "1.3.4",
48
- "@webex/calling": "3.12.0",
49
- "@webex/internal-plugin-mercury": "3.12.0",
50
- "@webex/internal-plugin-metrics": "3.12.0",
51
- "@webex/internal-plugin-support": "3.12.0",
52
- "@webex/plugin-authorization": "3.12.0",
53
- "@webex/plugin-logger": "3.12.0",
54
- "@webex/webex-core": "3.12.0",
50
+ "@webex/calling": "3.13.0-next.6",
51
+ "@webex/internal-plugin-mercury": "3.13.0-next.5",
52
+ "@webex/internal-plugin-metrics": "3.13.0-next.5",
53
+ "@webex/internal-plugin-support": "3.13.0-next.9",
54
+ "@webex/plugin-authorization": "3.13.0-next.5",
55
+ "@webex/plugin-logger": "3.13.0-next.5",
56
+ "@webex/webex-core": "3.13.0-next.5",
55
57
  "jest-html-reporters": "3.0.11",
56
- "lodash": "^4.17.21"
58
+ "lodash": "^4.17.21",
59
+ "uuid": "^3.3.2",
60
+ "xstate": "5.24.0"
57
61
  },
58
62
  "devDependencies": {
59
63
  "@babel/core": "^7.22.11",
@@ -65,7 +69,8 @@
65
69
  "@webex/eslint-config-legacy": "0.0.0",
66
70
  "@webex/jest-config-legacy": "0.0.0",
67
71
  "@webex/legacy-tools": "0.0.0",
68
- "@webex/test-helper-mock-webex": "3.12.0",
72
+ "@webex/test-helper-mock-webex": "3.13.0-next.1",
73
+ "@xstate/inspect": "^0.8.0",
69
74
  "eslint": "^8.24.0",
70
75
  "eslint-config-airbnb-base": "15.0.0",
71
76
  "eslint-config-prettier": "8.3.0",
@@ -78,7 +83,7 @@
78
83
  "jest-junit": "13.0.0",
79
84
  "prettier": "2.5.1",
80
85
  "typedoc": "^0.25.0",
81
- "typescript": "4.9.5"
86
+ "typescript": "5.4.5"
82
87
  },
83
- "version": "3.12.0"
88
+ "version": "3.13.0-next.10"
84
89
  }