@webex/contact-center 3.12.0-next.103 → 3.12.0-next.105

package/.sdd/manifest.json

@@ -51,7 +51,8 @@
       "canonical_spec": "ai-docs/contact-center-spec.md",
       "contracts": {
         "provides": [
-          "Published @webex/contact-center package; ContactCenter WebexPlugin; public SDK methods, events, types, Task, AddressBook, ApiAIAssistant, UserPreference, cc.userPreference, exported user-preference request/response types, and preview-campaign methods acceptPreviewContact/skipPreviewContact/removePreviewContact"
+          "Published @webex/contact-center package; ContactCenter WebexPlugin; public SDK methods, events, types, Task, AddressBook, ApiAIAssistant, UserPreference, cc.userPreference, exported user-preference request/response types, and preview-campaign methods acceptPreviewContact/skipPreviewContact/removePreviewContact",
+          "WXCC-6026 wxApp Better Together: enableWxBetterTogether init config, isWxBetterTogetherEnabled read API, unified task telephony (task.accept/decline/toggleMute/transmitDtmf), TASK_WXAPP_MUTE_STATE_UPDATED event, optional main.keypad uiControl, multi-login supported; runtime toggle deferred to Phase 2 (private)"
         ],
         "requires": [
           "Webex SDK host/plugin runtime; Contact Center REST and WebSocket services; internal Webex calling, metrics, support, authorization, logger, and mercury packages"

package/ai-docs/CONTRACTS.md

@@ -13,6 +13,7 @@
 | `contact-center.user-preference` | Services/Config | `UserPreference`, `cc.userPreference`, `UserPreferenceData`, request/response types | `getUserPreference(params?)`, `createUserPreference(data)`, `updateUserPreference(userId, data)`, `deleteUserPreference(userId)` | semver public | `src/services/ai-docs/services-spec.md` | `src/index.ts`, `src/cc.ts`, `src/services/UserPreference.ts`, `src/services/config/types.ts` |
 | `contact-center.preview-campaign` | Contact Center/Task | `acceptPreviewContact`, `skipPreviewContact`, `removePreviewContact` | `(payload: PreviewContactPayload) => Promise<TaskResponse>` | semver public | `ai-docs/contact-center-spec.md`, `src/services/task/ai-docs/task-spec.md` | `src/cc.ts`, `src/services/task/dialer.ts`, `src/services/task/types.ts` |
 | `contact-center.state-controls` | Task state machine | `getDefaultUIControls`, task state/control types | function is exported directly from `uiControlsComputer.ts` by package root | semver public | `src/services/task/state-machine/ai-docs/task-state-machine-spec.md` | `src/index.ts`, `src/services/task/state-machine/uiControlsComputer.ts` |
+| `contact-center.wxapp-answer` | Contact Center / Task | `enableWxBetterTogether`, `isWxBetterTogetherEnabled()`, `getWxAppMuted`, `syncWxAppMuteFromCallDetails`, unified task telephony (`ITask.accept`, `decline`, `toggleMute({ muted?, lineOwnerId? })`, `transmitDtmf({ dtmf, lineOwnerId? })`) | init flag ON → usersub `true` + Mercury on supported station login **and silent relogin**; init flag OFF → force usersub `false` on supported station login **and silent relogin** (clears stale suppression after refresh); **Phase 1 init-only** — change flag via re-init; multi-login supported; mute backfill via GET call details + `getWxAppMuted()` on hydrate/refresh; shared-line `lineOwnerId` defaults from participant; SDK `Voice` routes wxApp telephony when flag active | semver public | `src/services/task/ai-docs/task-spec.md`, `ai-docs/contact-center-spec.md`, `src/services/ai-docs/services-spec.md` | `src/cc.ts`, `src/services/task/voice/Voice.ts`, `src/services/task/voice/wxAppVoiceMethods.ts` |
 
 ### Events
 
@@ -20,6 +21,7 @@
 |---|---|---|---|---|---|---|---|
 | `agent.events` | Agent | `agent:*` | publish to application | agent spec/types | realtime; backend ordering/correlation | additive constants | `src/services/agent/types.ts` |
 | `task.events` | Task | `task:*` | publish to application/task | task spec/types | event-driven; state guarded | additive constants | `src/services/task/types.ts` |
+| `task.wxapp-mute.events` | Task | `task:wxapp-mute-state-updated` | publish to application/task | task spec/types | event-driven | additive | `src/services/task/types.ts`, `src/services/task/voice/Voice.ts` |
 | `cc.events` | Config/Core | backend CC_EVENTS | consume/map | config/core specs | remote WebSocket delivery; AQM correlation where configured | backend contract | `src/services/config/types.ts` |
 | `rtd.events` | Task | realtime transcription/suggestion | consume then publish per task | task spec | websocket best-effort according to remote service | additive payloads | `src/services/task/TaskManager.ts` |
 

package/ai-docs/contact-center-spec.md

@@ -99,6 +99,19 @@ Direct data/configuration and user-preference operations return authenticated RE
 
 Durable agent, task, and configuration records remain remote-system owned. The package owns only in-memory profile/task/listener/cache/connection state.
 
+### wxApp Better Together (WXCC-6026)
+
+Contract id: `contact-center.wxapp-answer` ([CONTRACTS.md](./CONTRACTS.md)). Task telephony routing, UI controls, and mute events are specified in [task-spec.md](../src/services/task/ai-docs/task-spec.md). Service collaborators: [services-spec.md](../src/services/ai-docs/services-spec.md).
+
+- **Init flag:** `webex.init({ cc: { enableWxBetterTogether: boolean } })` — default `false`. When `true`, ContactCenter enables wxApp telephony routing on tasks after supported station login. **Compatible with `allowMultiLogin: true`** (multiple SDK sessions may receive offers; wxApp telephony is routed per active task instance). **Phase 1 is init-only** — to change the flag after SDK init, re-init with updated config.
+- **Read API:** `cc.isWxBetterTogetherEnabled()` returns the current init flag value.
+- **Phase 2 (internal/private):** `setManageWebexCallingInWxcc(enabled)` remains as a private implementation for future runtime toggle; hosts must not call it in Phase 1.
+- **Post-login hooks:** `ensureWxAppPostStationLogin()` runs after successful `stationLogin()` and after `silentRelogin()` on socket reconnect. When the init flag is ON, it publishes usersub `true`, connects Mercury/device for mute sync, and backfills mute state on active tasks. Failures roll back wxApp config and release partial Mercury/device resources without failing station login. When OFF, it force-publishes usersub `false` (clears stale suppression after page refresh) and tears down wxApp Mercury resources.
+- **Teardown:** `deregister()`, station logout, and wxApp teardown paths call `teardownWxAppLocalState()` — publish usersub `false`, unsubscribe Mercury, release CC-owned device/Mercury connections, and reset **session runtime** state (usersub active flag, Mercury subscriptions, task-manager wxApp routing) so stale session flags do not apply on relogin. The host init flag (`enableWxBetterTogether`) is **not** cleared on station logout — it persists until `deregister()` or re-init per Phase 1 contract. Local cleanup runs even when usersub publish fails.
+- **Host telephony surface:** Hosts call unified `task.accept()`, `task.decline()`, `task.toggleMute({ muted? })`, and `task.transmitDtmf({ dtmf })`; SDK `Voice` routes wxApp legs internally when the flag is active. Shared-line `lineOwnerId` defaults from the wxApp agent participant when omitted.
+
+Evidence: `src/cc.ts`, `src/config.ts`, `src/services/WebexCrossClientService.ts`, `src/services/WxAppTelephonyMercurySync.ts`, `test/unit/spec/cc.ts`.
+
 ## Data Flow
 ```mermaid
 flowchart TD

package/dist/cc.js

@@ -19,6 +19,9 @@ var _Utils = require("./services/core/Utils");
 var _types3 = require("./services/config/types");
 var _TaskManager = _interopRequireDefault(require("./services/task/TaskManager"));
 var _WebCallingService = _interopRequireDefault(require("./services/WebCallingService"));
+var _AnswerCallOnWebexService = _interopRequireDefault(require("./services/AnswerCallOnWebexService"));
+var _WebexCrossClientService = _interopRequireDefault(require("./services/WebexCrossClientService"));
+var _WxAppTelephonyMercurySync = _interopRequireDefault(require("./services/WxAppTelephonyMercurySync"));
 var _types4 = require("./services/task/types");
 var _MetricsManager = _interopRequireDefault(require("./metrics/MetricsManager"));
 var _constants4 = require("./metrics/constants");
@@ -185,6 +188,29 @@ class ContactCenter extends _webexCore.WebexPlugin {
    * @private
    */
 
+  /**
+   * REST telephony for wxApp thick-client answer (WXCC-6026)
+   * @private
+   */
+
+  /**
+   * usersub cross-client state for Webex App toast suppression
+   * @private
+   */
+
+  /**
+   * Mercury telephony mute sync for wxApp thick-client answer
+   * @private
+   */
+
+  /** True when wxApp mute sync opened Mercury (Extension/DN-only profiles). */
+  wxAppMercuryConnectedByCc = false;
+
+  /** True when wxApp mute sync registered the Webex device. */
+  wxAppDeviceRegisteredByCc = false;
+  static WXAPP_FALSE_PUBLISH_RETRY_DELAY_MS = 30_000;
+  static WXAPP_FALSE_PUBLISH_MAX_RETRIES = 3;
+
   /**
    * Core service managers for Contact Center operations
    * Includes agent, connection, and configuration services
@@ -345,11 +371,15 @@ class ContactCenter extends _webexCore.WebexPlugin {
         connectionConfig: this.getConnectionConfig()
       });
       this.webCallingService = new _WebCallingService.default(this.$webex);
+      this.answerCallOnWebexService = new _AnswerCallOnWebexService.default(this.$webex);
+      this.webexCrossClientService = new _WebexCrossClientService.default(this.$webex);
+      this.wxAppTelephonyMercurySync = new _WxAppTelephonyMercurySync.default(this.$webex);
       this.apiAIAssistant = new _ApiAiAssistant.ApiAIAssistant(this.$webex);
       this.metricsManager = _MetricsManager.default.getInstance({
         webex: this.$webex
       });
       this.taskManager = _TaskManager.default.getTaskManager(this.apiAIAssistant, this.services.contact, this.webCallingService, this.services.webSocketManager, this.services.rtdWebSocketManager);
+      this.taskManager.setAnswerCallOnWebexService(this.answerCallOnWebexService);
       this.incomingTaskListener();
 
       // Initialize API instances
@@ -541,6 +571,11 @@ class ContactCenter extends _webexCore.WebexPlugin {
       this.services.webSocketManager.off('message', this.handleWebsocketMessage);
       this.services.rtdWebSocketManager.off('message', this.handleRTDWebsocketMessage);
       this.services.connectionService.off('connectionLost', this.handleConnectionLost);
+      const {
+        publishError: wxAppPublishError
+      } = await this.teardownWxAppLocalState({
+        clearInitFlag: true
+      });
       if (this.agentConfig.webRtcEnabled && this.agentConfig.loginVoiceOptions.includes(_types.LoginOption.BROWSER)) {
         if (this.$webex.internal.mercury.connected) {
           this.$webex.internal.mercury.off('online');
@@ -566,6 +601,9 @@ class ContactCenter extends _webexCore.WebexPlugin {
 
       // Clear any cached agent configuration
       this.agentConfig = null;
+      if (wxAppPublishError) {
+        throw wxAppPublishError;
+      }
       _loggerProxy.default.log('Deregistered successfully', {
         module: _constants.CC_FILE,
         method: _constants.METHODS.DEREGISTER
@@ -685,7 +723,8 @@ class ContactCenter extends _webexCore.WebexPlugin {
         isEndConsultEnabled: this.agentConfig.isEndConsultEnabled,
         webRtcEnabled: this.agentConfig.webRtcEnabled,
         autoWrapup: this.agentConfig.wrapUpData?.wrapUpProps?.autoWrapup ?? false,
-        aiFeature: this.agentConfig.aiFeature
+        aiFeature: this.agentConfig.aiFeature,
+        enableWxBetterTogether: this.isWxBetterTogetherEnabled()
       };
       this.taskManager.setConfigFlags(configFlags);
       // TODO: Make profile a singleton to make it available throughout app/sdk so we dont need to inject info everywhere
@@ -846,6 +885,13 @@ class ContactCenter extends _webexCore.WebexPlugin {
         notifsTrackingId: resp.trackingId
       };
       this.webCallingService.setLoginOption(data.loginOption);
+      if (this.agentConfig) {
+        this.agentConfig.deviceType = data.loginOption;
+        if (data.loginOption === _types.LoginOption.AGENT_DN || data.loginOption === _types.LoginOption.EXTENSION) {
+          this.agentConfig.defaultDn = data.dialNumber;
+          this.agentConfig.dn = data.dialNumber;
+        }
+      }
       this.metricsManager.trackEvent(_constants4.METRIC_EVENT_NAMES.STATION_LOGIN_SUCCESS, {
         ..._MetricsManager.default.getCommonTrackingFieldForAQMResponse(resp),
         loginType: data.loginOption,
@@ -858,6 +904,7 @@ class ContactCenter extends _webexCore.WebexPlugin {
         method: _constants.METHODS.STATION_LOGIN,
         trackingId: resp.trackingId
       });
+      await this.ensureWxAppPostStationLogin();
       return response;
     } catch (error) {
       const failure = error.details;
@@ -912,6 +959,7 @@ class ContactCenter extends _webexCore.WebexPlugin {
       if (this.webCallingService) {
         this.webCallingService.deregisterWebCallingLine();
       }
+      await this.teardownWxAppLocalState();
       _loggerProxy.default.log(`Agent station logout completed successfully`, {
         module: _constants.CC_FILE,
         method: _constants.METHODS.STATION_LOGOUT,
@@ -1170,6 +1218,372 @@ class ContactCenter extends _webexCore.WebexPlugin {
     }
   }
 
+  /**
+   * Whether wxApp thick-client answer is enabled for this SDK instance.
+   * @public
+   */
+  isWxBetterTogetherEnabled() {
+    return this.$config?.enableWxBetterTogether === true;
+  }
+
+  /**
+   * Current station login option (Extension, Dial Number, or Browser/Desktop).
+   * Prefer webCallingService — updated on every stationLogin before wxApp hooks run.
+   * @private
+   */
+  getCurrentStationLoginOption() {
+    return this.webCallingService?.loginOption ?? this.agentConfig?.deviceType;
+  }
+
+  /**
+   * wxApp thick-client answer is supported for Extension and Dial Number station login only —
+   * not Browser/Desktop (WebRTC) login.
+   * @private
+   */
+  assertWxAppStationLoginSupportedForEnable() {
+    const loginOption = this.getCurrentStationLoginOption();
+    if (loginOption !== _types.LoginOption.EXTENSION && loginOption !== _types.LoginOption.AGENT_DN) {
+      throw new Error('setManageWebexCallingInWxcc requires EXTENSION or AGENT_DN station login. Complete station login before enabling.');
+    }
+  }
+
+  /**
+   * Clears runtime wxApp config after logout/deregister so stale flags do not apply on relogin.
+   * @private
+   */
+  resetEnableWxBetterTogetherConfig() {
+    if (this.$config) {
+      this.$config.enableWxBetterTogether = false;
+    }
+    this.taskManager.applyEnableWxBetterTogether(false);
+  }
+
+  /**
+   * Runtime enable/disable for wxApp Better Together (toast suppression + Mercury mute sync).
+   *
+   * **Phase 1 (WXCC-6026 / MMT): NOT part of the public host contract.**
+   * Hosts must set `webexConfig.cc.enableWxBetterTogether` before `webex.init()` / `cc.register()`.
+   * To change the flag after the SDK is initialized, re-init the SDK with the updated config.
+   *
+   * **Supported public read API:** {@link isWxBetterTogetherEnabled}.
+   * **Supported telephony API:** unified `task.accept()`, `task.decline()`, `task.toggleMute()`,
+   * `task.transmitDtmf()` — SDK routes wxApp calls internally when the init flag is active.
+   *
+   * **Production lifecycle does not call this method.** Station login, silent relogin, logout,
+   * and deregister use {@link ensureWxAppPostStationLogin} and {@link teardownWxAppLocalState}
+   * (usersub publish + Mercury subscribe/unsubscribe based on the init flag).
+   *
+   * This setter remains as a **private implementation** for Phase 2 runtime toggle and unit tests.
+   * It updates `$config.enableWxBetterTogether`, TaskManager flags, cross-client usersub
+   * (`answer-calls-on-wxcc`), and Mercury mute sync; rolls back config on publish/connect failure.
+   *
+   * @param enabled - `true` to enable wxApp answer + usersub suppression; `false` to disable and tear down.
+   * @throws When enabling without login, on unsupported BROWSER station login, or when usersub/Mercury init fails.
+   * @internal
+   * @see enableWxBetterTogether (CCPluginConfig init flag)
+   * @see ensureWxAppPostStationLogin
+   * @see teardownWxAppLocalState
+   */
+  async setManageWebexCallingInWxcc(enabled) {
+    if (enabled && !this.$webex.internal.device?.userId) {
+      throw new Error('Cannot publish answer-calls-on-wxcc: user is not logged in');
+    }
+    if (enabled) {
+      this.assertWxAppStationLoginSupportedForEnable();
+    }
+    const previousEnabled = this.isWxBetterTogetherEnabled();
+    if (this.$config) {
+      this.$config.enableWxBetterTogether = enabled;
+    }
+    this.taskManager.applyEnableWxBetterTogether(enabled);
+    let publishedEnable = false;
+    try {
+      if (enabled) {
+        await this.ensureWxAppMercuryAndSubscribe();
+        await this.publishAnswerOnWebexCrossClientState(true);
+        publishedEnable = true;
+        this.taskManager.syncWxAppMuteFromCallDetailsForAllTasks();
+      } else {
+        await this.publishAnswerOnWebexCrossClientState(false);
+        this.wxAppTelephonyMercurySync.unsubscribe();
+        await this.releaseWxAppMercuryResources();
+      }
+    } catch (error) {
+      if (publishedEnable) {
+        await this.revertWxAppCrossClientPublish();
+      } else if (enabled) {
+        this.wxAppTelephonyMercurySync.unsubscribe();
+        await this.releaseWxAppMercuryResources();
+      }
+      if (this.$config) {
+        this.$config.enableWxBetterTogether = previousEnabled;
+      }
+      this.taskManager.applyEnableWxBetterTogether(previousEnabled);
+      throw error;
+    }
+  }
+  async ensureWxAppPostStationLogin() {
+    if (this.getCurrentStationLoginOption() === _types.LoginOption.BROWSER) {
+      return;
+    }
+    let publishedEnable = false;
+    try {
+      if (this.isWxBetterTogetherEnabled()) {
+        await this.ensureWxAppMercuryAndSubscribe();
+        await this.publishAnswerOnWebexCrossClientState(true);
+        publishedEnable = true;
+        this.taskManager.syncWxAppMuteFromCallDetailsForAllTasks();
+      } else {
+        await this.ensureWxAppDeviceRegistered();
+        await this.publishAnswerOnWebexCrossClientState(false, {
+          force: true
+        });
+        this.webexCrossClientService.teardown();
+        this.wxAppTelephonyMercurySync.unsubscribe();
+        await this.releaseWxAppMercuryResources();
+      }
+    } catch (error) {
+      _loggerProxy.default.error(`Failed to initialize wxApp post-station-login: ${error}`, {
+        module: _constants.CC_FILE,
+        method: _constants.METHODS.STATION_LOGIN
+      });
+      if (this.isWxBetterTogetherEnabled()) {
+        if (publishedEnable) {
+          await this.revertWxAppCrossClientPublish();
+        } else {
+          this.wxAppTelephonyMercurySync.unsubscribe();
+          await this.releaseWxAppMercuryResources();
+        }
+        this.resetEnableWxBetterTogetherConfig();
+      } else {
+        this.scheduleForcedFalsePublishRetry();
+      }
+    }
+  }
+  clearWxAppFalsePublishRetryTimer() {
+    if (this.wxAppFalsePublishRetryTimer) {
+      clearTimeout(this.wxAppFalsePublishRetryTimer);
+      this.wxAppFalsePublishRetryTimer = undefined;
+    }
+  }
+  scheduleForcedFalsePublishRetry(retryAttempt = 0) {
+    this.scheduleFalsePublishRetry(retryAttempt, {
+      requireDisabled: true
+    });
+  }
+
+  /**
+   * Retries compensating false publish after rollback failure, regardless of enabled flag.
+   * @private
+   */
+  scheduleCompensatingFalsePublishRetry(retryAttempt = 0) {
+    this.scheduleFalsePublishRetry(retryAttempt);
+  }
+  scheduleFalsePublishRetry(retryAttempt = 0, options = {}) {
+    if (retryAttempt >= ContactCenter.WXAPP_FALSE_PUBLISH_MAX_RETRIES) {
+      return;
+    }
+    if (options?.requireDisabled && this.isWxBetterTogetherEnabled()) {
+      return;
+    }
+    this.clearWxAppFalsePublishRetryTimer();
+    this.wxAppFalsePublishRetryTimer = setTimeout(async () => {
+      this.wxAppFalsePublishRetryTimer = undefined;
+      if (options?.requireDisabled && this.isWxBetterTogetherEnabled()) {
+        return;
+      }
+      if (!options?.requireDisabled && this.isWxBetterTogetherEnabled() && this.webexCrossClientService.isAnswerCallsStateActive()) {
+        return;
+      }
+      try {
+        await this.ensureWxAppDeviceRegistered();
+        await this.publishAnswerOnWebexCrossClientState(false, {
+          force: true
+        });
+        this.webexCrossClientService.teardown();
+        this.wxAppTelephonyMercurySync.unsubscribe();
+        await this.releaseWxAppMercuryResources();
+      } catch (retryError) {
+        _loggerProxy.default.error(`Failed to retry forced answer-calls-on-wxcc false publish: ${retryError}`, {
+          module: _constants.CC_FILE,
+          method: _constants.METHODS.SET_MANAGE_WEBEX_CALLING_IN_WXCC
+        });
+        this.scheduleFalsePublishRetry(retryAttempt + 1, options);
+      }
+    }, ContactCenter.WXAPP_FALSE_PUBLISH_RETRY_DELAY_MS);
+  }
+
+  /**
+   * Best-effort rollback when usersub true was published but wxApp setup did not complete.
+   * @private
+   */
+  async revertWxAppCrossClientPublish() {
+    try {
+      await this.publishAnswerOnWebexCrossClientState(false, {
+        force: true
+      });
+    } catch (error) {
+      _loggerProxy.default.error(`Failed to publish compensating answer-calls-on-wxcc false during wxApp rollback: ${error}`, {
+        module: _constants.CC_FILE,
+        method: _constants.METHODS.SET_MANAGE_WEBEX_CALLING_IN_WXCC
+      });
+      this.scheduleCompensatingFalsePublishRetry();
+    }
+    this.webexCrossClientService.teardown();
+    this.wxAppTelephonyMercurySync.unsubscribe();
+    await this.releaseWxAppMercuryResources();
+  }
+  async ensureWxAppDeviceRegistered() {
+    const device = this.$webex.internal.device;
+    if (device && !device.registered && device.register) {
+      await device.register();
+      this.wxAppDeviceRegisteredByCc = true;
+      _loggerProxy.default.log('WxApp: device registered for cross-client publish', {
+        module: _constants.CC_FILE,
+        method: _constants.METHODS.ENSURE_WXAPP_MERCURY_CONNECTED
+      });
+    }
+  }
+  async ensureWxAppMercuryConnected() {
+    const mercury = this.$webex.internal.mercury;
+    await this.ensureWxAppDeviceRegistered();
+    if (mercury && !mercury.connected) {
+      await mercury.connect();
+      this.wxAppMercuryConnectedByCc = true;
+      _loggerProxy.default.log('WxApp mute sync: mercury connected', {
+        module: _constants.CC_FILE,
+        method: _constants.METHODS.ENSURE_WXAPP_MERCURY_CONNECTED
+      });
+    }
+  }
+
+  /**
+   * Disconnects Mercury and unregisters the device when wxApp mute sync opened them.
+   * @private
+   */
+  async releaseWxAppMercuryResources() {
+    const mercury = this.$webex.internal.mercury;
+    const device = this.$webex.internal.device;
+    if (this.wxAppMercuryConnectedByCc && mercury?.connected) {
+      try {
+        await mercury.disconnect();
+        this.wxAppMercuryConnectedByCc = false;
+        _loggerProxy.default.log('WxApp mute sync: mercury disconnected', {
+          module: _constants.CC_FILE,
+          method: _constants.METHODS.ENSURE_WXAPP_MERCURY_CONNECTED
+        });
+      } catch (error) {
+        _loggerProxy.default.error(`Failed to disconnect wxApp Mercury: ${error}`, {
+          module: _constants.CC_FILE,
+          method: _constants.METHODS.ENSURE_WXAPP_MERCURY_CONNECTED
+        });
+      }
+    }
+    if (this.wxAppDeviceRegisteredByCc && device?.registered && device.unregister) {
+      try {
+        // @ts-ignore
+        await device.unregister();
+        this.wxAppDeviceRegisteredByCc = false;
+        _loggerProxy.default.log('WxApp mute sync: device unregistered', {
+          module: _constants.CC_FILE,
+          method: _constants.METHODS.ENSURE_WXAPP_MERCURY_CONNECTED
+        });
+      } catch (error) {
+        _loggerProxy.default.error(`Failed to unregister wxApp device: ${error}`, {
+          module: _constants.CC_FILE,
+          method: _constants.METHODS.ENSURE_WXAPP_MERCURY_CONNECTED
+        });
+      }
+    } else if (this.wxAppDeviceRegisteredByCc) {
+      this.wxAppDeviceRegisteredByCc = false;
+    }
+  }
+
+  /**
+   * Clears wxApp runtime state and feature-owned resources. Publish failures are logged;
+   * optional rethrow for deregister when callers need to surface usersub errors.
+   * @private
+   */
+  async teardownWxAppLocalState(options) {
+    this.clearWxAppFalsePublishRetryTimer();
+    let publishError;
+    try {
+      const shouldForceFalsePublish = this.isWxBetterTogetherEnabled() || this.webexCrossClientService.isAnswerCallsStateActive();
+      await this.publishAnswerOnWebexCrossClientState(false, {
+        force: shouldForceFalsePublish
+      });
+    } catch (error) {
+      publishError = error;
+      _loggerProxy.default.error(`Failed to publish answer-calls-on-wxcc false during wxApp teardown: ${error}`, {
+        module: _constants.CC_FILE,
+        method: _constants.METHODS.SET_MANAGE_WEBEX_CALLING_IN_WXCC
+      });
+    }
+    this.webexCrossClientService.teardown();
+    this.wxAppTelephonyMercurySync.unsubscribe();
+    await this.releaseWxAppMercuryResources();
+    if (options?.clearInitFlag) {
+      this.resetEnableWxBetterTogetherConfig();
+    }
+    if (publishError) {
+      this.scheduleCompensatingFalsePublishRetry();
+    }
+    if (options?.rethrowPublishError && publishError) {
+      throw publishError;
+    }
+    return {
+      publishError: publishError ?? undefined
+    };
+  }
+  async ensureWxAppMercuryAndSubscribe() {
+    if (!this.isWxBetterTogetherEnabled()) {
+      return;
+    }
+    if (this.getCurrentStationLoginOption() === _types.LoginOption.BROWSER) {
+      return;
+    }
+    const agentId = this.agentConfig?.agentId;
+    if (!agentId) {
+      _loggerProxy.default.error('Cannot subscribe wxApp mute sync: agentId unavailable', {
+        module: _constants.CC_FILE,
+        method: _constants.METHODS.SYNC_WXAPP_MUTE_FROM_MERCURY
+      });
+      return;
+    }
+    try {
+      await this.ensureWxAppMercuryConnected();
+      this.wxAppTelephonyMercurySync.subscribe(agentId, (callId, muted) => {
+        this.taskManager.applyWxAppMuteStateFromSync(callId, muted);
+      });
+    } catch (error) {
+      _loggerProxy.default.error(`Failed to ensure wxApp Mercury mute sync: ${error}`, {
+        module: _constants.CC_FILE,
+        method: _constants.METHODS.SYNC_WXAPP_MUTE_FROM_MERCURY
+      });
+      this.wxAppTelephonyMercurySync.unsubscribe();
+      await this.releaseWxAppMercuryResources();
+      throw error;
+    }
+  }
+  async publishAnswerOnWebexCrossClientState(enable, options) {
+    if (enable && !this.isWxBetterTogetherEnabled()) {
+      return;
+    }
+    if (!enable && !options?.force && !this.webexCrossClientService.isAnswerCallsStateActive()) {
+      return;
+    }
+    const userId = this.$webex.internal.device?.userId;
+    if (!userId) {
+      return;
+    }
+    await this.webexCrossClientService.setManageWebexCallingInWxcc(enable, {
+      userId
+    });
+    if (enable) {
+      this.clearWxAppFalsePublishRetryTimer();
+    }
+  }
+
   /**
    * Initializes event listeners for the Contact Center service
    * Sets up handlers for connection state changes and other core events
@@ -1268,6 +1682,7 @@ class ContactCenter extends _webexCore.WebexPlugin {
       }
       this.agentConfig.lastStateAuxCodeId = auxCodeId;
       this.agentConfig.isAgentLoggedIn = true;
+      await this.ensureWxAppPostStationLogin();
       _loggerProxy.default.log(`Silent relogin process completed successfully with login Option: ${reLoginResponse.data.deviceType} teamId: ${reLoginResponse.data.teamId}`, {
         module: _constants.CC_FILE,
         method: _constants.METHODS.SILENT_RELOGIN,