# webex/webex-js-sdk architecture

> Architecture diagram of the GitHub repository webex/webex-js-sdk, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/webex/webex-js-sdk
- Repository: https://github.com/webex/webex-js-sdk

## Overview

The Webex JS SDK is a JavaScript monorepo of unified and modular client packages for integrating applications with Webex services. Its principal user workflow is application code consuming the unified SDK or selected modules to make platform API and realtime-media capabilities available; the README documents that consumption model but does not establish internal wiring among most packages. The graph therefore preserves major package capabilities and sampled domain stages without guessing connections. Some indexed core files are absent from the supplied tree, so their components are represented only where an exact enclosing package directory is supported.

Main entry points: [`packages/@webex/contact-center/src/services/task/TaskManager.ts`](https://github.com/webex/webex-js-sdk/blob/next/packages/%40webex/contact-center/src/services/task/TaskManager.ts) (Task lifecycle), [`packages/@webex/contact-center/src/services/core/websocket/WebSocketManager.ts`](https://github.com/webex/webex-js-sdk/blob/next/packages/%40webex/contact-center/src/services/core/websocket/WebSocketManager.ts) (Realtime connection), [`packages/calling/src/CallingClient/calling/callManager.ts`](https://github.com/webex/webex-js-sdk/blob/next/packages/calling/src/CallingClient/calling/callManager.ts) (Call orchestration), [`packages/@webex/plugin-meetings/src/multistream/remoteMediaManager.ts`](https://github.com/webex/webex-js-sdk/blob/next/packages/%40webex/plugin-meetings/src/multistream/remoteMediaManager.ts) (Remote media layout)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_sdk["SDK foundation"]
  node_unified["Unified Webex SDK"]
  node_core["SDK service catalog<br/>[services.js]"]
  node_common["Common utilities"]
  node_http["HTTP transport"]
end

subgraph group_calling["Calling"]
  node_callingclient["Calling client<br/>[CallingClient.ts]"]
  node_callmanager["Call orchestration<br/>[callManager.ts]"]
  node_contacts["Calling contacts<br/>[ContactsClient.ts]"]
end

subgraph group_contact["Contact center"]
  node_ccapi["Contact center API"]
  node_ccsocket["Realtime connection"]
  node_taskmanager["Task lifecycle<br/>[TaskManager.ts]"]
  node_cctypes["Contact center domain<br/>[types.ts]"]
  node_ccmetrics["Contact center metrics<br/>[MetricsManager.ts]"]
end

subgraph group_meetings["Meetings media"]
  node_mediarequests["Media requests"]
  node_mediamanager["Remote media layout"]
end

subgraph group_services["Platform capabilities"]
  node_devices["Device management<br/>[device-manager.js]"]
  node_conversation["Conversations"]
  node_encryption["Encryption"]
  node_presence["Presence"]
  node_calendar["Calendar"]
  node_metrics["Platform metrics"]
end

node_app(("Integrating application"))

node_app -->|"consumes"| node_unified
node_callmanager -.->|"uses SDK"| node_callingclient
node_ccsocket -->|"registers through"| node_ccapi
node_taskmanager -->|"uses connection"| node_ccsocket
node_taskmanager -->|"uses domain types"| node_cctypes
node_mediamanager -->|"coordinates"| node_mediarequests

click node_unified "https://github.com/webex/webex-js-sdk/tree/next/packages/webex"
click node_core "https://github.com/webex/webex-js-sdk/blob/next/packages/%40webex/webex-core/src/lib/services/services.js"
click node_common "https://github.com/webex/webex-js-sdk/tree/next/packages/%40webex/common/src"
click node_http "https://github.com/webex/webex-js-sdk/tree/next/packages/%40webex/http-core/src"
click node_callingclient "https://github.com/webex/webex-js-sdk/blob/next/packages/calling/src/CallingClient/CallingClient.ts"
click node_callmanager "https://github.com/webex/webex-js-sdk/blob/next/packages/calling/src/CallingClient/calling/callManager.ts"
click node_contacts "https://github.com/webex/webex-js-sdk/blob/next/packages/calling/src/Contacts/ContactsClient.ts"
click node_ccapi "https://github.com/webex/webex-js-sdk/tree/next/packages/%40webex/contact-center/src"
click node_ccsocket "https://github.com/webex/webex-js-sdk/blob/next/packages/%40webex/contact-center/src/services/core/websocket/WebSocketManager.ts"
click node_taskmanager "https://github.com/webex/webex-js-sdk/blob/next/packages/%40webex/contact-center/src/services/task/TaskManager.ts"
click node_cctypes "https://github.com/webex/webex-js-sdk/blob/next/packages/%40webex/contact-center/src/types.ts"
click node_ccmetrics "https://github.com/webex/webex-js-sdk/blob/next/packages/%40webex/contact-center/src/metrics/MetricsManager.ts"
click node_mediarequests "https://github.com/webex/webex-js-sdk/blob/next/packages/%40webex/plugin-meetings/src/multistream/mediaRequestManager.ts"
click node_mediamanager "https://github.com/webex/webex-js-sdk/blob/next/packages/%40webex/plugin-meetings/src/multistream/remoteMediaManager.ts"
click node_devices "https://github.com/webex/webex-js-sdk/blob/next/packages/%40webex/plugin-device-manager/src/device-manager.js"
click node_conversation "https://github.com/webex/webex-js-sdk/tree/next/packages/%40webex/internal-plugin-conversation/src"
click node_encryption "https://github.com/webex/webex-js-sdk/tree/next/packages/%40webex/internal-plugin-encryption/src"
click node_presence "https://github.com/webex/webex-js-sdk/tree/next/packages/%40webex/internal-plugin-presence/src"
click node_calendar "https://github.com/webex/webex-js-sdk/tree/next/packages/%40webex/internal-plugin-calendar/src"
click node_metrics "https://github.com/webex/webex-js-sdk/tree/next/packages/%40webex/internal-plugin-metrics/src"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_unified,node_core,node_common,node_http toneBlue
class node_callingclient,node_callmanager,node_contacts toneAmber
class node_ccapi,node_ccsocket,node_taskmanager,node_cctypes,node_ccmetrics toneMint
class node_mediarequests,node_mediamanager toneRose
class node_devices,node_conversation,node_encryption,node_presence,node_calendar,node_metrics,node_app toneIndigo
```

## Components

### SDK foundation

- [Unified Webex SDK](https://github.com/webex/webex-js-sdk/tree/next/packages/webex): `packages/webex`
- [SDK service catalog](https://github.com/webex/webex-js-sdk/blob/next/packages/%40webex/webex-core/src/lib/services/services.js): `packages/@webex/webex-core/src/lib/services/services.js`
- [Common utilities](https://github.com/webex/webex-js-sdk/tree/next/packages/%40webex/common/src): `packages/@webex/common/src`
- [HTTP transport](https://github.com/webex/webex-js-sdk/tree/next/packages/%40webex/http-core/src): `packages/@webex/http-core/src`

### Calling

- [Calling client](https://github.com/webex/webex-js-sdk/blob/next/packages/calling/src/CallingClient/CallingClient.ts): `packages/calling/src/CallingClient/CallingClient.ts`
- [Call orchestration](https://github.com/webex/webex-js-sdk/blob/next/packages/calling/src/CallingClient/calling/callManager.ts): `packages/calling/src/CallingClient/calling/callManager.ts`
- [Calling contacts](https://github.com/webex/webex-js-sdk/blob/next/packages/calling/src/Contacts/ContactsClient.ts): `packages/calling/src/Contacts/ContactsClient.ts`

### Contact center

- [Contact center API](https://github.com/webex/webex-js-sdk/tree/next/packages/%40webex/contact-center/src): `packages/@webex/contact-center/src`
- [Realtime connection](https://github.com/webex/webex-js-sdk/blob/next/packages/%40webex/contact-center/src/services/core/websocket/WebSocketManager.ts): `packages/@webex/contact-center/src/services/core/websocket/WebSocketManager.ts`
- [Task lifecycle](https://github.com/webex/webex-js-sdk/blob/next/packages/%40webex/contact-center/src/services/task/TaskManager.ts): `packages/@webex/contact-center/src/services/task/TaskManager.ts`
- [Contact center domain](https://github.com/webex/webex-js-sdk/blob/next/packages/%40webex/contact-center/src/types.ts): `packages/@webex/contact-center/src/types.ts`
- [Contact center metrics](https://github.com/webex/webex-js-sdk/blob/next/packages/%40webex/contact-center/src/metrics/MetricsManager.ts): `packages/@webex/contact-center/src/metrics/MetricsManager.ts`

### Meetings media

- [Media requests](https://github.com/webex/webex-js-sdk/blob/next/packages/%40webex/plugin-meetings/src/multistream/mediaRequestManager.ts): `packages/@webex/plugin-meetings/src/multistream/mediaRequestManager.ts`
- [Remote media layout](https://github.com/webex/webex-js-sdk/blob/next/packages/%40webex/plugin-meetings/src/multistream/remoteMediaManager.ts): `packages/@webex/plugin-meetings/src/multistream/remoteMediaManager.ts`

### Platform capabilities

- [Device management](https://github.com/webex/webex-js-sdk/blob/next/packages/%40webex/plugin-device-manager/src/device-manager.js): `packages/@webex/plugin-device-manager/src/device-manager.js`
- [Conversations](https://github.com/webex/webex-js-sdk/tree/next/packages/%40webex/internal-plugin-conversation/src): `packages/@webex/internal-plugin-conversation/src`
- [Encryption](https://github.com/webex/webex-js-sdk/tree/next/packages/%40webex/internal-plugin-encryption/src): `packages/@webex/internal-plugin-encryption/src`
- [Presence](https://github.com/webex/webex-js-sdk/tree/next/packages/%40webex/internal-plugin-presence/src): `packages/@webex/internal-plugin-presence/src`
- [Calendar](https://github.com/webex/webex-js-sdk/tree/next/packages/%40webex/internal-plugin-calendar/src): `packages/@webex/internal-plugin-calendar/src`
- [Platform metrics](https://github.com/webex/webex-js-sdk/tree/next/packages/%40webex/internal-plugin-metrics/src): `packages/@webex/internal-plugin-metrics/src`

### Other components

- **Integrating application**

## Connections

- Integrating application → Unified Webex SDK: consumes (evidence: `README.md`)
- Call orchestration → Calling client: uses SDK (evidence: `packages/calling/src/CallingClient/CallingClient.ts`)
- Realtime connection → Contact center API: registers through (evidence: `packages/@webex/contact-center/src/services/core/websocket/WebSocketManager.ts`)
- Task lifecycle → Realtime connection: uses connection (evidence: `packages/@webex/contact-center/src/services/task/TaskManager.ts`)
- Task lifecycle → Contact center domain: uses domain types (evidence: `packages/@webex/contact-center/src/services/task/TaskManager.ts`)
- Remote media layout → Media requests: coordinates (evidence: `packages/@webex/plugin-meetings/src/multistream/remoteMediaManager.ts`)
