@webex/contact-center 3.12.0-llmrefactor.7 → 3.12.0-llmrefactor.9

package/dist/types/services/task/state-machine/TaskStateMachine.d.ts

@@ -199,13 +199,6 @@ export declare function getTaskStateMachineConfig(uiControlConfig: UIControlConf
                     }) => boolean;
                     actions: string[];
                 })[];
-                PARTICIPANT_LEAVE: ({
-                    guard: (params: any) => boolean;
-                    target: TaskState;
-                    actions: string[];
-                } | {
-                    actions: string[];
-                })[];
                 CONTACT_ENDED: ({
                     guard: ({ context, event }: import("./guards").GuardParams) => boolean;
                     target: TaskState;
@@ -246,13 +239,6 @@ export declare function getTaskStateMachineConfig(uiControlConfig: UIControlConf
                     target: TaskState;
                     actions: string[];
                 };
-                PARTICIPANT_LEAVE: ({
-                    guard: (params: any) => boolean;
-                    target: TaskState;
-                    actions: string[];
-                } | {
-                    actions: string[];
-                })[];
                 OUTBOUND_FAILED: ({
                     guard: ({ context, event }: import("./guards").GuardParams) => boolean;
                     target: TaskState;
@@ -549,13 +535,6 @@ export declare function getTaskStateMachineConfig(uiControlConfig: UIControlConf
                     target: TaskState;
                     actions: string[];
                 })[];
-                PARTICIPANT_LEAVE: ({
-                    guard: (params: any) => boolean;
-                    target: TaskState;
-                    actions: string[];
-                } | {
-                    actions: string[];
-                })[];
                 OUTBOUND_FAILED: ({
                     guard: ({ context, event }: import("./guards").GuardParams) => boolean;
                     target: TaskState;
@@ -897,13 +876,6 @@ export declare function createTaskStateMachine(uiControlConfig: UIControlConfig,
                     }) => boolean;
                     actions: string[];
                 })[];
-                PARTICIPANT_LEAVE: ({
-                    guard: (params: any) => boolean;
-                    target: TaskState;
-                    actions: string[];
-                } | {
-                    actions: string[];
-                })[];
                 CONTACT_ENDED: ({
                     guard: ({ context, event }: import("./guards").GuardParams) => boolean;
                     target: TaskState;
@@ -944,13 +916,6 @@ export declare function createTaskStateMachine(uiControlConfig: UIControlConfig,
                     target: TaskState;
                     actions: string[];
                 };
-                PARTICIPANT_LEAVE: ({
-                    guard: (params: any) => boolean;
-                    target: TaskState;
-                    actions: string[];
-                } | {
-                    actions: string[];
-                })[];
                 OUTBOUND_FAILED: ({
                     guard: ({ context, event }: import("./guards").GuardParams) => boolean;
                     target: TaskState;
@@ -1247,13 +1212,6 @@ export declare function createTaskStateMachine(uiControlConfig: UIControlConfig,
                     target: TaskState;
                     actions: string[];
                 })[];
-                PARTICIPANT_LEAVE: ({
-                    guard: (params: any) => boolean;
-                    target: TaskState;
-                    actions: string[];
-                } | {
-                    actions: string[];
-                })[];
                 OUTBOUND_FAILED: ({
                     guard: ({ context, event }: import("./guards").GuardParams) => boolean;
                     target: TaskState;

package/dist/types/services/task/state-machine/guards.d.ts

@@ -80,10 +80,10 @@ export declare const guards: {
     /**
      * True when an updated lifecycle event shows that this agent left the main interaction.
      *
-     * Explicit self-participant evidence is authoritative. Main-call membership is used only
-     * for the from-conference nested-consult race where CONSULT_END still represents the agent as
-     * active on the consult leg after removing them from the main leg. Partial or ordinary call
-     * snapshots are not treated as a departure.
+     * Returns true when the event names this agent, or when this agent is absent from the
+     * updated participants map. EP-DN payloads remove the leaving participant instead of
+     * setting hasLeft. Remaining in the map with hasLeft, or disappearing only from
+     * mainCall media, is not treated as departure.
      */
     didCurrentAgentLeaveMainInteraction: ({ context, event }: GuardParams) => boolean;
     /**

package/dist/types/services/task/voice/Voice.d.ts

@@ -12,7 +12,9 @@ export default class Voice extends Task implements IVoice {
     private wxAppAnswerPending;
     private wxAppAcceptInFlight;
     private wxAppMuteSyncInFlight?;
-    private wxAppMuteToggleInFlight?;
+    private wxAppMuteToggleTail;
+    private wxAppDtmfTail;
+    private lastLoggedWxAppAcceptReason?;
     constructor(contact: ReturnType<typeof routingContact>, data: TaskData, callOptions?: VoiceUIControlOptions, wrapupData?: WrapupData, agentId?: string);
     private getWxAppVoiceDependencies;
     /** @deprecated Use {@link Voice.getWxAppVoiceDependencies} */
@@ -22,6 +24,8 @@ export default class Voice extends Task implements IVoice {
     private setWxAppAnswerPending;
     private setWxAppAcceptInFlight;
     setEnableWxBetterTogether(enabled: boolean): void;
+    protected updateUiControls(forceEmit?: boolean): void;
+    private logWxAppOfferDecisionIfNeeded;
     applyWxAppMuteStateFromSync(incomingCallId: string, muted: boolean): void;
     getWxAppMuted(): boolean;
     private static delay;

package/dist/types/services/task/voice/wxAppVoiceMethods.d.ts

@@ -1,11 +1,13 @@
 import AnswerCallOnWebexService from '../../AnswerCallOnWebexService';
 import { TaskData, TaskToggleMuteOptions, TaskTransmitDtmfOptions } from '../types';
 import { TaskState } from '../state-machine';
+import MetricsManager from '../../../metrics/MetricsManager';
 import { WebexCallingDeviceDetails } from '../WebexCallingUtils';
 export type WxAppVoiceDependencies = {
     enableWxBetterTogether: boolean;
     answerCallOnWebexService?: AnswerCallOnWebexService;
     agentId?: string;
+    metricsManager: MetricsManager;
     getTaskData: () => TaskData;
     getTaskState: () => TaskState | undefined;
     getWxAppMuted: () => boolean;
@@ -47,6 +49,7 @@ export declare function runWxAppAccept(deps: WxAppVoiceDependencies, lifecycle:
 export declare function runWxAppReject(deps: WxAppVoiceDependencies, lifecycle: WxAppVoiceLifecycle, options?: {
     lineOwnerId?: string;
 }): Promise<void>;
+export declare function runWxAppOutdialDecline<T>(deps: WxAppVoiceDependencies, executeCancel: () => Promise<T>): Promise<T>;
 export declare function runWxAppToggleMute(deps: WxAppVoiceDependencies, lifecycle: WxAppVoiceLifecycle, options?: TaskToggleMuteOptions): Promise<void>;
 export declare function runWxAppTransmitDtmf(deps: WxAppVoiceDependencies, lifecycle: WxAppVoiceLifecycle, options: TaskTransmitDtmfOptions): Promise<void>;
 export declare function mapWxAppVoiceError(error: unknown, method: string, module: string): never;

package/dist/types/services/wxAppDiagnosticLogging.d.ts

@@ -0,0 +1,51 @@
+export declare const WXAPP_LOG_FEATURE = "wxApp";
+export declare const WXAPP_LOG_PREFIX = "[CC wxApp]";
+export type WxAppAcceptReason = 'wxApp_offer_ready' | 'wxApp_answer_pending' | 'wxApp_accept_in_flight' | 'extension_non_wxApp_offer' | 'browser_webrtc_offer' | 'outdial_auto_answer';
+export type WxAppSessionSkipReason = 'unsupported_browser_login' | 'flag_disabled' | 'mercury_subscribe_failed' | 'publish_failed';
+export type WxAppTelephonyAction = 'accept' | 'decline' | 'mute' | 'dtmf';
+export type WxAppTelephonyPhase = 'started' | 'success' | 'failed';
+/** Last 8 chars of callId for correlation without logging full id. */
+export declare function callIdSuffix(callId: string | null | undefined): string | undefined;
+export declare function logWxAppSessionReadiness(params: {
+    enableWxBetterTogether: boolean;
+    loginOption: string | undefined;
+    wxAppHooksApplied: boolean;
+    usersubPublished: boolean;
+    mercurySubscribed: boolean;
+    telephonyTaskType: 'Voice' | 'WebRTC' | 'unknown';
+    skipReason?: WxAppSessionSkipReason;
+}): void;
+export declare function deriveWxAppAcceptReason(params: {
+    isWxAppInboundOffer: boolean;
+    isWxAppOutdialOffer: boolean;
+    isWebrtc: boolean;
+    isOutdial: boolean;
+    wxAppAcceptInFlight: boolean;
+    wxAppAnswerPending: boolean;
+    enableWxBetterTogether: boolean;
+    hasDeviceCallId: boolean;
+}): WxAppAcceptReason;
+export declare function logWxAppOfferDecision(params: {
+    interactionId: string;
+    acceptVisible: boolean;
+    acceptEnabled: boolean;
+    acceptReason: WxAppAcceptReason;
+    wxAppParticipantDeviceType?: string;
+    hasDeviceCallId: boolean;
+}): void;
+export declare function logWxAppTelephonyAction(params: {
+    action: WxAppTelephonyAction;
+    phase: WxAppTelephonyPhase;
+    interactionId?: string;
+    trackingId?: string;
+    httpStatus?: number | string;
+    failureReason?: string;
+}): void;
+export declare function logWxAppValidationFailure(reason: string, interactionId?: string): void;
+export declare function logWxAppMercuryMuteSync(params: {
+    phase: 'received' | 'applied' | 'dropped';
+    muted?: boolean;
+    callIdSuffix?: string;
+    interactionId?: string;
+    dropReason?: string;
+}): void;

package/dist/webex.js

@@ -41,7 +41,7 @@ if (!global.Buffer) {
  */
 const Webex = _webexCore.default.extend({
   webex: true,
-  version: `3.12.0-llmrefactor.7`
+  version: `3.12.0-llmrefactor.9`
 });
 
 /**

package/package.json

@@ -46,13 +46,13 @@
   },
   "dependencies": {
     "@types/platform": "1.3.4",
-    "@webex/calling": "3.12.0-llmrefactor.4",
-    "@webex/internal-plugin-mercury": "3.12.0-llmrefactor.5",
-    "@webex/internal-plugin-metrics": "3.12.0-llmrefactor.3",
-    "@webex/internal-plugin-support": "3.12.0-llmrefactor.5",
-    "@webex/plugin-authorization": "3.12.0-llmrefactor.3",
-    "@webex/plugin-logger": "3.12.0-llmrefactor.3",
-    "@webex/webex-core": "3.12.0-llmrefactor.3",
+    "@webex/calling": "3.12.0-llmrefactor.6",
+    "@webex/internal-plugin-mercury": "3.12.0-llmrefactor.7",
+    "@webex/internal-plugin-metrics": "3.12.0-llmrefactor.5",
+    "@webex/internal-plugin-support": "3.12.0-llmrefactor.7",
+    "@webex/plugin-authorization": "3.12.0-llmrefactor.5",
+    "@webex/plugin-logger": "3.12.0-llmrefactor.5",
+    "@webex/webex-core": "3.12.0-llmrefactor.5",
     "jest-html-reporters": "3.0.11",
     "lodash": "^4.17.21",
     "uuid": "^3.3.2",
@@ -84,5 +84,5 @@
     "typedoc": "^0.25.0",
     "typescript": "5.4.5"
   },
-  "version": "3.12.0-llmrefactor.7"
+  "version": "3.12.0-llmrefactor.9"
 }

package/src/cc.ts

@@ -59,6 +59,7 @@ import WebCallingService from './services/WebCallingService';
 import AnswerCallOnWebexService from './services/AnswerCallOnWebexService';
 import WebexCrossClientService from './services/WebexCrossClientService';
 import WxAppTelephonyMercurySync from './services/WxAppTelephonyMercurySync';
+import {logWxAppSessionReadiness} from './services/wxAppDiagnosticLogging';
 import {
   ITask,
   TASK_EVENTS,
@@ -1015,14 +1016,15 @@ export default class ContactCenter extends WebexPlugin implements IContactCenter
         }
       }
 
+      const deviceId = this.getDeviceId(data.loginOption, data.dialNumber);
       const loginResponse = await this.services.agent.stationLogin({
         data: {
-          dialNumber:
-            data.loginOption === LoginOption.BROWSER ? this.agentConfig.agentId : data.dialNumber,
+          // BROWSER DN must be webrtc-{agentId} so VPOP/RTMS do not treat a bare UUID as PSTN.
+          dialNumber: data.loginOption === LoginOption.BROWSER ? deviceId : data.dialNumber,
           teamId: data.teamId,
           deviceType: data.loginOption,
           isExtension: data.loginOption === LoginOption.EXTENSION,
-          deviceId: this.getDeviceId(data.loginOption, data.dialNumber),
+          deviceId,
           roles: [AGENT],
           teamName: EMPTY_STRING,
           siteId: EMPTY_STRING,
@@ -1562,25 +1564,120 @@ export default class ContactCenter extends WebexPlugin implements IContactCenter
     }
   }
 
+  private getWxAppTelephonyTaskType(): 'Voice' | 'WebRTC' | 'unknown' {
+    const loginOption = this.getCurrentStationLoginOption();
+
+    if (loginOption === LoginOption.BROWSER) {
+      return 'WebRTC';
+    }
+
+    if (loginOption === LoginOption.EXTENSION || loginOption === LoginOption.AGENT_DN) {
+      return 'Voice';
+    }
+
+    return 'unknown';
+  }
+
   private async ensureWxAppPostStationLogin(): Promise<void> {
-    if (this.getCurrentStationLoginOption() === LoginOption.BROWSER) {
+    const loginOption = this.getCurrentStationLoginOption();
+    const flagEnabled = this.isWxBetterTogetherEnabled();
+    const telephonyTaskType = this.getWxAppTelephonyTaskType();
+
+    if (loginOption === LoginOption.BROWSER) {
+      if (flagEnabled) {
+        logWxAppSessionReadiness({
+          enableWxBetterTogether: true,
+          loginOption,
+          wxAppHooksApplied: false,
+          usersubPublished: false,
+          mercurySubscribed: false,
+          telephonyTaskType,
+          skipReason: 'unsupported_browser_login',
+        });
+
+        this.metricsManager.trackEvent(
+          METRIC_EVENT_NAMES.WXAPP_SESSION_SKIPPED,
+          {
+            loginOption,
+            enableWxBetterTogether: true,
+            skipReason: 'unsupported_browser_login',
+          },
+          ['operational', 'behavioral']
+        );
+      }
+
       return;
     }
 
     let publishedEnable = false;
+    let wxAppInitStage: 'mercury' | 'publish' = 'mercury';
 
     try {
-      if (this.isWxBetterTogetherEnabled()) {
+      if (flagEnabled) {
+        this.metricsManager.timeEvent([
+          METRIC_EVENT_NAMES.WXAPP_SESSION_INIT_SUCCESS,
+          METRIC_EVENT_NAMES.WXAPP_SESSION_INIT_FAILED,
+        ]);
+
         await this.ensureWxAppMercuryAndSubscribe();
+        wxAppInitStage = 'publish';
         await this.publishAnswerOnWebexCrossClientState(true);
         publishedEnable = true;
         this.taskManager.syncWxAppMuteFromCallDetailsForAllTasks();
+
+        const mercurySubscribed = this.wxAppTelephonyMercurySync.isSubscribed();
+        const usersubPublished = this.webexCrossClientService.isAnswerCallsStateActive();
+
+        logWxAppSessionReadiness({
+          enableWxBetterTogether: true,
+          loginOption,
+          wxAppHooksApplied: true,
+          usersubPublished,
+          mercurySubscribed,
+          telephonyTaskType,
+        });
+
+        const sessionInitReady = mercurySubscribed && usersubPublished;
+
+        if (sessionInitReady) {
+          this.metricsManager.trackEvent(
+            METRIC_EVENT_NAMES.WXAPP_SESSION_INIT_SUCCESS,
+            {loginOption, enableWxBetterTogether: true},
+            ['operational', 'behavioral']
+          );
+        } else {
+          this.metricsManager.trackEvent(
+            METRIC_EVENT_NAMES.WXAPP_SESSION_INIT_FAILED,
+            {
+              loginOption,
+              enableWxBetterTogether: true,
+              skipReason: !usersubPublished ? 'usersub_not_published' : 'mercury_not_subscribed',
+            },
+            ['operational', 'behavioral']
+          );
+        }
       } else {
         await this.ensureWxAppDeviceRegistered();
         await this.publishAnswerOnWebexCrossClientState(false, {force: true});
         this.webexCrossClientService.teardown();
         this.wxAppTelephonyMercurySync.unsubscribe();
         await this.releaseWxAppMercuryResources();
+
+        logWxAppSessionReadiness({
+          enableWxBetterTogether: false,
+          loginOption,
+          wxAppHooksApplied: true,
+          usersubPublished: false,
+          mercurySubscribed: false,
+          telephonyTaskType,
+          skipReason: 'flag_disabled',
+        });
+
+        this.metricsManager.trackEvent(
+          METRIC_EVENT_NAMES.WXAPP_SESSION_SKIPPED,
+          {loginOption, enableWxBetterTogether: false, skipReason: 'flag_disabled'},
+          ['operational', 'behavioral']
+        );
       }
     } catch (error) {
       LoggerProxy.error(`Failed to initialize wxApp post-station-login: ${error}`, {
@@ -1588,7 +1685,32 @@ export default class ContactCenter extends WebexPlugin implements IContactCenter
         method: METHODS.STATION_LOGIN,
       });
 
-      if (this.isWxBetterTogetherEnabled()) {
+      if (flagEnabled) {
+        const sessionInitFailureReason =
+          wxAppInitStage === 'mercury' ? 'mercury_subscribe_failed' : 'publish_failed';
+
+        this.metricsManager.trackEvent(
+          METRIC_EVENT_NAMES.WXAPP_SESSION_INIT_FAILED,
+          {
+            loginOption,
+            enableWxBetterTogether: true,
+            skipReason: sessionInitFailureReason,
+            error: error instanceof Error ? error.toString() : String(error),
+          },
+          ['operational', 'behavioral']
+        );
+
+        logWxAppSessionReadiness({
+          enableWxBetterTogether: true,
+          loginOption,
+          wxAppHooksApplied: false,
+          usersubPublished:
+            publishedEnable && this.webexCrossClientService.isAnswerCallsStateActive(),
+          mercurySubscribed: this.wxAppTelephonyMercurySync.isSubscribed(),
+          telephonyTaskType,
+          skipReason: sessionInitFailureReason,
+        });
+
         if (publishedEnable) {
           await this.revertWxAppCrossClientPublish();
         } else {
@@ -1829,6 +1951,12 @@ export default class ContactCenter extends WebexPlugin implements IContactCenter
         method: METHODS.SYNC_WXAPP_MUTE_FROM_MERCURY,
       });
 
+      this.metricsManager.trackEvent(
+        METRIC_EVENT_NAMES.WXAPP_MERCURY_SUBSCRIBE_FAILED,
+        {error: 'agentId unavailable'},
+        ['operational', 'behavioral']
+      );
+
       return;
     }
 
@@ -1842,6 +1970,11 @@ export default class ContactCenter extends WebexPlugin implements IContactCenter
         module: CC_FILE,
         method: METHODS.SYNC_WXAPP_MUTE_FROM_MERCURY,
       });
+      this.metricsManager.trackEvent(
+        METRIC_EVENT_NAMES.WXAPP_MERCURY_SUBSCRIBE_FAILED,
+        {error: error instanceof Error ? error.toString() : String(error)},
+        ['operational', 'behavioral']
+      );
       this.wxAppTelephonyMercurySync.unsubscribe();
       await this.releaseWxAppMercuryResources();
       throw error;
@@ -1862,10 +1995,25 @@ export default class ContactCenter extends WebexPlugin implements IContactCenter
 
     const userId = this.$webex.internal.device?.userId;
     if (!userId) {
+      if (enable && this.isWxBetterTogetherEnabled()) {
+        this.metricsManager.trackEvent(
+          METRIC_EVENT_NAMES.WXAPP_USERSUB_PUBLISH_FAILED,
+          {
+            enableWxBetterTogether: true,
+            skipReason: 'user_id_unavailable',
+            error: 'User ID is unavailable for cross-client publish',
+          },
+          ['operational', 'behavioral']
+        );
+      }
+
       return;
     }
 
-    await this.webexCrossClientService.setManageWebexCallingInWxcc(enable, {userId});
+    await this.webexCrossClientService.setManageWebexCallingInWxcc(enable, {
+      userId,
+      trackPublishMetrics: true,
+    });
 
     if (enable) {
       this.clearWxAppFalsePublishRetryTimer();

package/src/metrics/MetricsManager.ts

@@ -412,6 +412,22 @@ export default class MetricsManager {
     this.runningEvents[genericKey] = {startTime: Date.now(), keys: new Set(keyArray)};
   }
 
+  /**
+   * Clears a running timed event without emitting a metric.
+   * @param keys - A string or array of strings representing event keys (same as timeEvent).
+   * @public
+   */
+  public cancelTimedEvent(keys: string | string[]): void {
+    if (this.isMetricsDisabled()) {
+      return;
+    }
+    const keyArray = Array.isArray(keys) ? keys : [keys];
+    if (keyArray.length === 0) {
+      return;
+    }
+    delete this.runningEvents[keyArray[0]];
+  }
+
   /**
    * Sets the Webex SDK instance and marks the manager as ready when the SDK is ready.
    * @param webex - The Webex SDK instance.

package/src/metrics/ai-docs/metrics-spec.md

@@ -35,6 +35,8 @@ Metrics is one of nine confirmed Contact Center SDK modules. Own timing, taxonom
 
 - **Behavioral Taxonomy**: Structured `product.agent.target.verb` naming convention for behavioral events
 
+- **Webex Together behavioral naming**: Webex Together (wxApp) events use `*_webex_together` compound targets (e.g. `wxcc_sdk.user.task_accept_webex_together.complete`). Operational/business wire names remain `WXCC_SDK_WXAPP_*` unchanged.
+
 - **Payload Preparation**: Automatic cleanup of empty fields, space-to-underscore conversion, and `tabHidden` metadata
 
 - **AQM Response Helpers**: Static methods to extract common tracking fields from AQM responses
@@ -236,6 +238,14 @@ All event names are defined in `METRIC_EVENT_NAMES` (`constants.ts`). Events fol
 | `TASK_ACCEPT_CONSULT_SUCCESS` / `FAILED` | `'Task Accept Consult ...'` | Accept consult result |
 | `TASK_AUTO_ANSWER_SUCCESS` / `FAILED` | `'Task Auto Answer ...'` | Auto-answer result |
 | `TASK_OUTDIAL_SUCCESS` / `FAILED` | `'Task Outdial ...'` | Outdial result |
+| `WXAPP_TASK_MUTE_SUCCESS` / `FAILED` | `'WxApp Task Mute ...'` | Webex Together task mute/unmute toggle (`wxcc_sdk.user.task_mute_webex_together.complete\|fail`). Mute telephony is queued per task via tail promise chain (`Voice.wxAppMuteToggleTail`) so concurrent toggles do not overwrite the shared `timeEvent` timer or reorder requests. |
+| `WXAPP_TASK_DTMF_SUCCESS` / `FAILED` | `'WxApp Task Dtmf ...'` | Webex Together DTMF/keypad (`wxcc_sdk.user.task_dtmf_webex_together.complete\|fail`). DTMF telephony is queued per task via tail promise chain (`Voice.wxAppDtmfTail`) so concurrent keypad input does not overwrite the shared `timeEvent` timer or reorder digits. |
+| `WXAPP_TASK_ACCEPT_SUCCESS` / `FAILED` | `'WxApp Task Accept ...'` | Webex Together accept/answer (`wxcc_sdk.user.task_accept_webex_together.complete\|fail`) |
+| `WXAPP_TASK_DECLINE_SUCCESS` / `FAILED` | `'WxApp Task Decline ...'` | Webex Together reject/decline (`wxcc_sdk.user.task_reject_webex_together.complete\|fail`). Inbound offers: telephony `rejectCall` via `runWxAppReject`. wxApp outdial cancellations: CC `cancelTask` via `runWxAppOutdialDecline` (additive with `TASK_DECLINE_*`). Outdial failure payloads merge AQM `error.details` via `getCommonTrackingFieldForAQMResponseFailed` so wxApp metrics and diagnostic logs preserve `trackingId` / structured failure reason. |
+| `WXAPP_SESSION_INIT_SUCCESS` / `FAILED` | `'WxApp Session Init ...'` | Webex Together session orchestration (`wxcc_sdk.user.webex_together_session_init.complete\|fail`) |
+| `WXAPP_SESSION_SKIPPED` | `'WxApp Session Skipped'` | Webex Together session skipped (`wxcc_sdk.user.webex_together_session_init.ignore`) |
+| `WXAPP_USERSUB_PUBLISH_SUCCESS` / `FAILED` | `'WxApp Usersub Publish ...'` | Cross-client usersub publish (`wxcc_sdk.user.webex_together_usersub_publish.complete\|fail`). Preflight failures (missing `userId` or device URL before HTTP publish) emit `WXAPP_USERSUB_PUBLISH_FAILED` with `skipReason` (`user_id_unavailable` / `device_url_unavailable`) and no `timeEvent` timer. Stale-generation discards (teardown or concurrent disable while HTTP publish is in flight) call `cancelTimedEvent` without emitting success/fail only when the completing publish still owns the active timer (`usersubPublishMetricsId` guard — a newer overlapping publish must not have its timer cleared). |
+| `WXAPP_MERCURY_SUBSCRIBE_SUCCESS` / `FAILED` | `'WxApp Mercury Subscribe ...'` | Telephony Mercury mute-sync subscribe (`wxcc_sdk.user.webex_together_mercury_subscribe.complete\|fail`) |
 | `TASK_CONFERENCE_START_SUCCESS` / `FAILED` | `'Task Conference Start ...'` | Conference start result |
 | `TASK_CONFERENCE_END_SUCCESS` / `FAILED` | `'Task Conference End ...'` | Conference end result |
 | `TASK_CONFERENCE_TRANSFER_SUCCESS` / `FAILED` | `'Task Conference Transfer ...'` | Conference transfer result |
@@ -281,6 +291,13 @@ All event names are defined in `constants.ts` as `METRIC_EVENT_NAMES`. Events fo
 | Conference Participant Drop | `TASK_CONFERENCE_PARTICIPANT_DROP_SUCCESS` | `TASK_CONFERENCE_PARTICIPANT_DROP_FAILED` |
 | Switch Call            | `TASK_SWITCH_CALL_SUCCESS`             | `TASK_SWITCH_CALL_FAILED`              |
 | Outdial                | `TASK_OUTDIAL_SUCCESS`                 | `TASK_OUTDIAL_FAILED`                  |
+| WxApp Task Mute        | `WXAPP_TASK_MUTE_SUCCESS`              | `WXAPP_TASK_MUTE_FAILED`               |
+| WxApp Task DTMF        | `WXAPP_TASK_DTMF_SUCCESS`              | `WXAPP_TASK_DTMF_FAILED`               |
+| WxApp Task Accept      | `WXAPP_TASK_ACCEPT_SUCCESS`            | `WXAPP_TASK_ACCEPT_FAILED`             |
+| WxApp Task Decline     | `WXAPP_TASK_DECLINE_SUCCESS`           | `WXAPP_TASK_DECLINE_FAILED`            |
+| WxApp Session Init     | `WXAPP_SESSION_INIT_SUCCESS`           | `WXAPP_SESSION_INIT_FAILED`            |
+| WxApp Usersub Publish  | `WXAPP_USERSUB_PUBLISH_SUCCESS`        | `WXAPP_USERSUB_PUBLISH_FAILED`         |
+| WxApp Mercury Subscribe | `WXAPP_MERCURY_SUBSCRIBE_SUCCESS`     | `WXAPP_MERCURY_SUBSCRIBE_FAILED`       |
 | Upload Logs            | `UPLOAD_LOGS_SUCCESS`                  | `UPLOAD_LOGS_FAILED`                   |
 | WebSocket Deregister   | `WEBSOCKET_DEREGISTER_SUCCESS`         | `WEBSOCKET_DEREGISTER_FAIL`            |
 | Device Type Update     | `AGENT_DEVICE_TYPE_UPDATE_SUCCESS`     | `AGENT_DEVICE_TYPE_UPDATE_FAILED`      |
@@ -289,6 +306,22 @@ All event names are defined in `constants.ts` as `METRIC_EVENT_NAMES`. Events fo
 | Queue                  | `QUEUE_FETCH_SUCCESS`                  | `QUEUE_FETCH_FAILED`                   |
 | Outdial ANI Entries    | `OUTDIAL_ANI_EP_FETCH_SUCCESS`         | `OUTDIAL_ANI_EP_FETCH_FAILED`          |
 
+### Webex Together behavioral taxonomy
+
+Webex Together events (`WXAPP_*` constants) use `*_webex_together` compound targets. Assembled Amplitude names follow `wxcc_sdk.user.{target}.{verb}`:
+
+| Feature | Behavioral target | Success name | Failure name | Skip name |
+|---|---|---|---|---|
+| Task accept / answer | `task_accept_webex_together` | `wxcc_sdk.user.task_accept_webex_together.complete` | `wxcc_sdk.user.task_accept_webex_together.fail` | — |
+| Task reject / decline | `task_reject_webex_together` | `wxcc_sdk.user.task_reject_webex_together.complete` | `wxcc_sdk.user.task_reject_webex_together.fail` | — |
+| Task mute / unmute toggle | `task_mute_webex_together` | `wxcc_sdk.user.task_mute_webex_together.complete` | `wxcc_sdk.user.task_mute_webex_together.fail` | — |
+| Task DTMF / keypad | `task_dtmf_webex_together` | `wxcc_sdk.user.task_dtmf_webex_together.complete` | `wxcc_sdk.user.task_dtmf_webex_together.fail` | — |
+| Usersub publish | `webex_together_usersub_publish` | `wxcc_sdk.user.webex_together_usersub_publish.complete` | `wxcc_sdk.user.webex_together_usersub_publish.fail` | — |
+| Mercury subscribe | `webex_together_mercury_subscribe` | `wxcc_sdk.user.webex_together_mercury_subscribe.complete` | `wxcc_sdk.user.webex_together_mercury_subscribe.fail` | — |
+| Session init | `webex_together_session_init` | `wxcc_sdk.user.webex_together_session_init.complete` | `wxcc_sdk.user.webex_together_session_init.fail` | `wxcc_sdk.user.webex_together_session_init.ignore` |
+
+Operational and business wire names are unchanged (`WXCC_SDK_WXAPP_*`).
+
 Special events (no success/failure pair):
 
 - `AGENT_RONA` — has behavioral taxonomy (`service.agent_rona.set`)
@@ -299,11 +332,13 @@ Special events (no success/failure pair):
 
 - `WEBSOCKET_EVENT_RECEIVED` — **no** behavioral taxonomy (not in `eventTaxonomyMap`)
 
-Of the 82 defined metric names, 73 have behavioral taxonomy and 9 do not. Events **without** an `eventTaxonomyMap` entry are the six `AI_ASSISTANT_*` names plus `WEBSOCKET_DEREGISTER_SUCCESS`, `WEBSOCKET_DEREGISTER_FAIL`, and `WEBSOCKET_EVENT_RECEIVED`.
+- `WXAPP_SESSION_SKIPPED` — has behavioral taxonomy (`wxcc_sdk.user.webex_together_session_init.ignore`)
+
+Of the 107 defined metric names, 96 have behavioral taxonomy and 11 do not. Events **without** an `eventTaxonomyMap` entry are the eight `AI_ASSISTANT_*` names plus `WEBSOCKET_DEREGISTER_SUCCESS`, `WEBSOCKET_DEREGISTER_FAIL`, and `WEBSOCKET_EVENT_RECEIVED`.
 
 ### Complete METRIC_EVENT_NAMES catalog
 
-This table contains all 82 names from `src/metrics/constants.ts`; taxonomy presence is checked against `src/metrics/behavioral-events.ts`: 73 mapped and 9 unmapped.
+This table contains all 107 names from `src/metrics/constants.ts`; taxonomy presence is checked against `src/metrics/behavioral-events.ts`: 96 mapped and 11 unmapped.
 
 | Constant | Emitted name | Behavioral taxonomy? |
 |---|---|---|
@@ -362,6 +397,21 @@ This table contains all 82 names from `src/metrics/constants.ts`; taxonomy prese
 | `TASK_SWITCH_CALL_FAILED` | `Task Switch Call Failed` | yes |
 | `TASK_OUTDIAL_SUCCESS` | `Task Outdial Success` | yes |
 | `TASK_OUTDIAL_FAILED` | `Task Outdial Failed` | yes |
+| `WXAPP_TASK_MUTE_SUCCESS` | `WxApp Task Mute Success` | yes |
+| `WXAPP_TASK_MUTE_FAILED` | `WxApp Task Mute Failed` | yes |
+| `WXAPP_TASK_DTMF_SUCCESS` | `WxApp Task Dtmf Success` | yes |
+| `WXAPP_TASK_DTMF_FAILED` | `WxApp Task Dtmf Failed` | yes |
+| `WXAPP_TASK_ACCEPT_SUCCESS` | `WxApp Task Accept Success` | yes |
+| `WXAPP_TASK_ACCEPT_FAILED` | `WxApp Task Accept Failed` | yes |
+| `WXAPP_TASK_DECLINE_SUCCESS` | `WxApp Task Decline Success` | yes |
+| `WXAPP_TASK_DECLINE_FAILED` | `WxApp Task Decline Failed` | yes |
+| `WXAPP_SESSION_INIT_SUCCESS` | `WxApp Session Init Success` | yes |
+| `WXAPP_SESSION_INIT_FAILED` | `WxApp Session Init Failed` | yes |
+| `WXAPP_SESSION_SKIPPED` | `WxApp Session Skipped` | yes |
+| `WXAPP_USERSUB_PUBLISH_SUCCESS` | `WxApp Usersub Publish Success` | yes |
+| `WXAPP_USERSUB_PUBLISH_FAILED` | `WxApp Usersub Publish Failed` | yes |
+| `WXAPP_MERCURY_SUBSCRIBE_SUCCESS` | `WxApp Mercury Subscribe Success` | yes |
+| `WXAPP_MERCURY_SUBSCRIBE_FAILED` | `WxApp Mercury Subscribe Failed` | yes |
 | `UPLOAD_LOGS_SUCCESS` | `Upload Logs Success` | yes |
 | `UPLOAD_LOGS_FAILED` | `Upload Logs Failed` | yes |
 | `WEBSOCKET_DEREGISTER_SUCCESS` | `Websocket Deregister Success` | no |
@@ -385,12 +435,22 @@ This table contains all 82 names from `src/metrics/constants.ts`; taxonomy prese
 | `CAMPAIGN_PREVIEW_REMOVE_FAILED` | `Campaign Preview Remove Failed` | yes |
 | `AI_ASSISTANT_SEND_EVENT_SUCCESS` | `AI Assistant Send Event Success` | no |
 | `AI_ASSISTANT_SEND_EVENT_FAILED` | `AI Assistant Send Event Failed` | no |
-| `AI_ASSISTANT_GET_SUGGESTED_RESPONSE_SUCCESS` | `AI Assistant Get Suggested Response Success` | no |
-| `AI_ASSISTANT_GET_SUGGESTED_RESPONSE_FAILED` | `AI Assistant Get Suggested Response Failed` | no |
+| `AI_ASSISTANT_GET_REAL_TIME_ASSISTANCE_SUCCESS` | `AI Assistant Get Real Time Assistance Success` | no |
+| `AI_ASSISTANT_GET_REAL_TIME_ASSISTANCE_FAILED` | `AI Assistant Get Real Time Assistance Failed` | no |
+| `AI_ASSISTANT_SEND_REAL_TIME_ASSISTANCE_USER_ACTION_SUCCESS` | `AI Assistant Send Real Time Assistance User Action Success` | no |
+| `AI_ASSISTANT_SEND_REAL_TIME_ASSISTANCE_USER_ACTION_FAILED` | `AI Assistant Send Real Time Assistance User Action Failed` | no |
 | `AI_ASSISTANT_FETCH_HISTORIC_TRANSCRIPTS_SUCCESS` | `AI Assistant Fetch Historic Transcripts Success` | no |
 | `AI_ASSISTANT_FETCH_HISTORIC_TRANSCRIPTS_FAILED` | `AI Assistant Fetch Historic Transcripts Failed` | no |
+| `USER_PREFERENCE_GET_SUCCESS` | `User Preference Get Success` | yes |
+| `USER_PREFERENCE_GET_FAILED` | `User Preference Get Failed` | yes |
+| `USER_PREFERENCE_CREATE_SUCCESS` | `User Preference Create Success` | yes |
+| `USER_PREFERENCE_CREATE_FAILED` | `User Preference Create Failed` | yes |
+| `USER_PREFERENCE_UPDATE_SUCCESS` | `User Preference Update Success` | yes |
+| `USER_PREFERENCE_UPDATE_FAILED` | `User Preference Update Failed` | yes |
+| `USER_PREFERENCE_DELETE_SUCCESS` | `User Preference Delete Success` | yes |
+| `USER_PREFERENCE_DELETE_FAILED` | `User Preference Delete Failed` | yes |
 
-Defined names without an `eventTaxonomyMap` entry: `AI_ASSISTANT_FETCH_HISTORIC_TRANSCRIPTS_FAILED`, `AI_ASSISTANT_FETCH_HISTORIC_TRANSCRIPTS_SUCCESS`, `AI_ASSISTANT_GET_SUGGESTED_RESPONSE_FAILED`, `AI_ASSISTANT_GET_SUGGESTED_RESPONSE_SUCCESS`, `AI_ASSISTANT_SEND_EVENT_FAILED`, `AI_ASSISTANT_SEND_EVENT_SUCCESS`, `WEBSOCKET_DEREGISTER_FAIL`, `WEBSOCKET_DEREGISTER_SUCCESS`, `WEBSOCKET_EVENT_RECEIVED`.
+Defined names without an `eventTaxonomyMap` entry: `AI_ASSISTANT_FETCH_HISTORIC_TRANSCRIPTS_FAILED`, `AI_ASSISTANT_FETCH_HISTORIC_TRANSCRIPTS_SUCCESS`, `AI_ASSISTANT_GET_REAL_TIME_ASSISTANCE_FAILED`, `AI_ASSISTANT_GET_REAL_TIME_ASSISTANCE_SUCCESS`, `AI_ASSISTANT_SEND_EVENT_FAILED`, `AI_ASSISTANT_SEND_EVENT_SUCCESS`, `AI_ASSISTANT_SEND_REAL_TIME_ASSISTANCE_USER_ACTION_FAILED`, `AI_ASSISTANT_SEND_REAL_TIME_ASSISTANCE_USER_ACTION_SUCCESS`, `WEBSOCKET_DEREGISTER_FAIL`, `WEBSOCKET_DEREGISTER_SUCCESS`, `WEBSOCKET_EVENT_RECEIVED`.
 
 ## Requires (dependencies)
 - `webex.internal.newMetrics` submission APIs
@@ -438,8 +498,10 @@ Each behavioral event maps to a structured taxonomy in `behavioral-events.ts`:
 > **Note**: The following events do **not** have behavioral taxonomy mappings in `behavioral-events.ts`:
 > - `AI_ASSISTANT_SEND_EVENT_SUCCESS`
 > - `AI_ASSISTANT_SEND_EVENT_FAILED`
-> - `AI_ASSISTANT_GET_SUGGESTED_RESPONSE_SUCCESS`
-> - `AI_ASSISTANT_GET_SUGGESTED_RESPONSE_FAILED`
+> - `AI_ASSISTANT_GET_REAL_TIME_ASSISTANCE_SUCCESS`
+> - `AI_ASSISTANT_GET_REAL_TIME_ASSISTANCE_FAILED`
+> - `AI_ASSISTANT_SEND_REAL_TIME_ASSISTANCE_USER_ACTION_SUCCESS`
+> - `AI_ASSISTANT_SEND_REAL_TIME_ASSISTANCE_USER_ACTION_FAILED`
 > - `AI_ASSISTANT_FETCH_HISTORIC_TRANSCRIPTS_SUCCESS`
 > - `AI_ASSISTANT_FETCH_HISTORIC_TRANSCRIPTS_FAILED`
 > - `WEBSOCKET_DEREGISTER_SUCCESS`
@@ -769,7 +831,7 @@ stateDiagram-v2
 - **metricsDisabled**: When `true`, `timeEvent` and all `track*` methods return early, and `clearPendingEvents()` empties all queues.
 
 ## Pitfalls
-- `METRIC_EVENT_NAMES` and `eventTaxonomyMap` are different inventories: nine defined names intentionally have no behavioral taxonomy.
+- `METRIC_EVENT_NAMES` and `eventTaxonomyMap` are different inventories: eleven defined names intentionally have no behavioral taxonomy.
 - `setMetricsDisabled(true)` clears pending queues but does not create a delivery receipt; callers must not infer that previously submitted events were accepted.
 - Submission helpers hand events to `webex.internal.newMetrics` without a module-level retry/requeue policy, so telemetry must remain non-blocking and non-authoritative.
 
@@ -830,7 +892,7 @@ Use `test/unit/spec/metrics/MetricsManager.ts` for readiness queues, timing/trac
 | Behavior / Requirement | Existing test evidence | Gap |
 |---|---|---|
 | `METRICS-R-001` | `test/unit/spec/metrics/MetricsManager.ts` | Add a catalog parity assertion if constants change. |
-| `METRICS-R-002` | `test/unit/spec/metrics/behavioral-events.ts` | Keep explicit coverage for all nine unmapped names. |
+| `METRICS-R-002` | `test/unit/spec/metrics/behavioral-events.ts` | Keep explicit coverage for all eleven unmapped names. |
 | `METRICS-R-003` | `test/unit/spec/metrics/MetricsManager.ts` | None. |
 | `METRICS-R-004` | `test/unit/spec/metrics/MetricsManager.ts` | None. |
 | `METRICS-R-005` | `test/unit/spec/metrics/MetricsManager.ts` | Authentication ownership is verified indirectly through the host metrics client. |