@webex/contact-center 3.12.0-next.130 → 3.12.0-next.131

package/.sdd/manifest.json

@@ -96,7 +96,8 @@
       "canonical_spec": "src/metrics/ai-docs/metrics-spec.md",
       "contracts": {
         "provides": [
-          "MetricsManager timing, behavioral/operational/business event submission, taxonomy, queues, tracking-field helpers, and operational Agent Wellness Break action/notification/system-code event names"
+          "MetricsManager timing, behavioral/operational/business event submission, taxonomy, queues, tracking-field helpers, and operational Agent Wellness Break action/notification/system-code event names",
+          "WXAPP_OFFER_PARTICIPANT_FIELDS_MISSING operational/behavioral telemetry event (contract metrics.wxapp-offer-participant-fields-missing; emit site voice/wxAppOfferObservability.ts)"
         ],
         "requires": [
           "Webex internal metrics service; Webex ready lifecycle; LoggerProxy; browser document visibility"

package/ai-docs/CONTRACTS.md

@@ -30,6 +30,12 @@
 | `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` |
 | `wellness.notification.events` | Contact Center | `CC_AGENT_EVENTS.WELLNESS_BREAK` | consume validated wellness payloads from the primary data-notification socket, then publish normalized application events | Contact Center spec/types | exact current agent/org; notification session is diagnostic and is not compared with the active session; canonical optional `actionText` is normalized to public `actionText`; malformed/stale payloads are ignored | additive | `src/cc.ts`, `src/types.ts`, `src/services/config/types.ts` |
 
+### Telemetry / Metrics Events
+
+| Contract ID | Owner module | Event constant | Wire name | Payload schema link | Tags | Defined at |
+|---|---|---|---|---|---|---|
+| `metrics.wxapp-offer-participant-fields-missing` | Task / Metrics | `WXAPP_OFFER_PARTICIPANT_FIELDS_MISSING` | `WxApp Offer Participant Fields Missing` | `src/metrics/ai-docs/metrics-spec.md` | operational, behavioral | `src/metrics/constants.ts`, `src/services/task/voice/wxAppOfferObservability.ts` |
+
 ## Requires — what this repo depends on
 
 | Dependency | What is consumed | Schema / detail link | Availability assumption | Fallback on failure | Version floor |

package/dist/cc.js

@@ -827,7 +827,8 @@ class ContactCenter extends _webexCore.WebexPlugin {
           accessEntryPoint: this.agentConfig.accessEntryPoint,
           accessBuddyTeam: this.agentConfig.accessBuddyTeam
         },
-        enableWxBetterTogether: this.isWxBetterTogetherEnabled()
+        enableWxBetterTogether: this.isWxBetterTogetherEnabled(),
+        getWxAppUsersubPublished: () => this.webexCrossClientService.isAnswerCallsStateActive()
       };
       this.taskManager.setConfigFlags(configFlags);
       // TODO: Make profile a singleton to make it available throughout app/sdk so we dont need to inject info everywhere
@@ -1481,6 +1482,7 @@ class ContactCenter extends _webexCore.WebexPlugin {
         await this.publishAnswerOnWebexCrossClientState(true);
         publishedEnable = true;
         this.taskManager.syncWxAppMuteFromCallDetailsForAllTasks();
+        this.taskManager.refreshWxAppOfferObservabilityForAllTasks();
       } else {
         await this.publishAnswerOnWebexCrossClientState(false);
         this.wxAppTelephonyMercurySync.unsubscribe();
@@ -1543,6 +1545,7 @@ class ContactCenter extends _webexCore.WebexPlugin {
         await this.publishAnswerOnWebexCrossClientState(true);
         publishedEnable = true;
         this.taskManager.syncWxAppMuteFromCallDetailsForAllTasks();
+        this.taskManager.refreshWxAppOfferObservabilityForAllTasks();
         const mercurySubscribed = this.wxAppTelephonyMercurySync.isSubscribed();
         const usersubPublished = this.webexCrossClientService.isAnswerCallsStateActive();
         (0, _wxAppDiagnosticLogging.logWxAppSessionReadiness)({
@@ -1557,12 +1560,18 @@ class ContactCenter extends _webexCore.WebexPlugin {
         if (sessionInitReady) {
           this.metricsManager.trackEvent(_constants4.METRIC_EVENT_NAMES.WXAPP_SESSION_INIT_SUCCESS, {
             loginOption,
-            enableWxBetterTogether: true
+            enableWxBetterTogether: true,
+            usersubPublished,
+            mercurySubscribed,
+            telephonyTaskType
           }, ['operational', 'behavioral']);
         } else {
           this.metricsManager.trackEvent(_constants4.METRIC_EVENT_NAMES.WXAPP_SESSION_INIT_FAILED, {
             loginOption,
             enableWxBetterTogether: true,
+            usersubPublished,
+            mercurySubscribed,
+            telephonyTaskType,
             skipReason: !usersubPublished ? 'usersub_not_published' : 'mercury_not_subscribed'
           }, ['operational', 'behavioral']);
         }
@@ -1599,6 +1608,9 @@ class ContactCenter extends _webexCore.WebexPlugin {
         this.metricsManager.trackEvent(_constants4.METRIC_EVENT_NAMES.WXAPP_SESSION_INIT_FAILED, {
           loginOption,
           enableWxBetterTogether: true,
+          usersubPublished: this.webexCrossClientService.isAnswerCallsStateActive(),
+          mercurySubscribed: this.wxAppTelephonyMercurySync.isSubscribed(),
+          telephonyTaskType,
           skipReason: sessionInitFailureReason,
           error: error instanceof Error ? error.toString() : String(error)
         }, ['operational', 'behavioral']);
@@ -1606,7 +1618,7 @@ class ContactCenter extends _webexCore.WebexPlugin {
           enableWxBetterTogether: true,
           loginOption,
           wxAppHooksApplied: false,
-          usersubPublished: publishedEnable && this.webexCrossClientService.isAnswerCallsStateActive(),
+          usersubPublished: this.webexCrossClientService.isAnswerCallsStateActive(),
           mercurySubscribed: this.wxAppTelephonyMercurySync.isSubscribed(),
           telephonyTaskType,
           skipReason: sessionInitFailureReason
@@ -1812,7 +1824,8 @@ class ContactCenter extends _webexCore.WebexPlugin {
         method: _constants.METHODS.SYNC_WXAPP_MUTE_FROM_MERCURY
       });
       this.metricsManager.trackEvent(_constants4.METRIC_EVENT_NAMES.WXAPP_MERCURY_SUBSCRIBE_FAILED, {
-        error: 'agentId unavailable'
+        error: 'agentId unavailable',
+        mercurySubscribed: false
       }, ['operational', 'behavioral']);
       return;
     }
@@ -1827,7 +1840,8 @@ class ContactCenter extends _webexCore.WebexPlugin {
         method: _constants.METHODS.SYNC_WXAPP_MUTE_FROM_MERCURY
       });
       this.metricsManager.trackEvent(_constants4.METRIC_EVENT_NAMES.WXAPP_MERCURY_SUBSCRIBE_FAILED, {
-        error: error instanceof Error ? error.toString() : String(error)
+        error: error instanceof Error ? error.toString() : String(error),
+        mercurySubscribed: false
       }, ['operational', 'behavioral']);
       this.wxAppTelephonyMercurySync.unsubscribe();
       await this.releaseWxAppMercuryResources();
@@ -1846,6 +1860,7 @@ class ContactCenter extends _webexCore.WebexPlugin {
       if (enable && this.isWxBetterTogetherEnabled()) {
         this.metricsManager.trackEvent(_constants4.METRIC_EVENT_NAMES.WXAPP_USERSUB_PUBLISH_FAILED, {
           enableWxBetterTogether: true,
+          usersubPublished: this.webexCrossClientService.isAnswerCallsStateActive(),
           skipReason: 'user_id_unavailable',
           error: 'User ID is unavailable for cross-client publish'
         }, ['operational', 'behavioral']);