@webex/contact-center 3.10.0-next.9 → 3.10.0-wxc-disconnect.1

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

@@ -444,29 +444,7 @@ export declare enum TASK_EVENTS {
      * });
      * ```
      */
-    TASK_PARTICIPANT_LEFT_FAILED = "task:participantLeftFailed",
-    /**
-     * Triggered when a contact is merged
-     * @example
-     * ```typescript
-     * task.on(TASK_EVENTS.TASK_MERGED, (task: ITask) => {
-     *   console.log('Contact merged:', task.data.interactionId);
-     *   // Handle contact merge
-     * });
-     * ```
-     */
-    TASK_MERGED = "task:merged",
-    /**
-     * Triggered when a participant enters post-call activity state
-     * @example
-     * ```typescript
-     * task.on(TASK_EVENTS.TASK_POST_CALL_ACTIVITY, (task: ITask) => {
-     *   console.log('Participant in post-call activity:', task.data.interactionId);
-     *   // Handle post-call activity
-     * });
-     * ```
-     */
-    TASK_POST_CALL_ACTIVITY = "task:postCallActivity"
+    TASK_PARTICIPANT_LEFT_FAILED = "task:participantLeftFailed"
 }
 /**
  * Represents a customer interaction within the contact center system
@@ -704,8 +682,6 @@ export type TaskData = {
     isConsulted?: boolean;
     /** Indicates if the task is in conference state */
     isConferencing: boolean;
-    /** Indicates if a conference is currently in progress (2+ active agents) */
-    isConferenceInProgress?: boolean;
     /** Identifier of agent who last updated the task */
     updatedBy?: string;
     /** Type of destination for transfer/consult */
@@ -728,8 +704,6 @@ export type TaskData = {
     isWebCallMute?: boolean;
     /** Identifier for reservation interaction */
     reservationInteractionId?: string;
-    /** Identifier for the reserved agent channel (used for campaign tasks) */
-    reservedAgentChannelId?: string;
     /** Indicates if wrap-up is required for this task */
     wrapUpRequired?: boolean;
 };
@@ -964,6 +938,18 @@ export type ConsultConferenceData = {
     /** Type of destination (e.g., 'agent', 'queue') */
     destinationType: string;
 };
+/**
+ * Legacy consultation conference data type matching Agent Desktop
+ * @public
+ */
+export type consultConferencePayloadData = {
+    /** Identifier of the agent initiating consult/conference */
+    agentId: string;
+    /** Type of destination (e.g., 'agent', 'queue') */
+    destinationType: string;
+    /** Identifier of the destination agent */
+    destAgentId: string;
+};
 /**
  * Parameters required for cancelling a consult to queue operation
  * @public
@@ -1076,15 +1062,15 @@ export interface ITask extends EventEmitter {
      */
     autoWrapup?: AutoWrapup;
     /**
-     * Cancels the auto-wrapup timer for the task.
-     * This method stops the auto-wrapup process if it is currently active.
+     * cancels the auto-wrapup timer for the task
+     * This method stops the auto-wrapup process if it is currently active
      * Note: This is supported only in single session mode. Not supported in multi-session mode.
      * @returns void
      */
     cancelAutoWrapupTimer(): void;
     /**
-     * Deregisters all web call event listeners.
-     * Used when cleaning up task resources.
+     * Deregisters all web call event listeners
+     * Used when cleaning up task resources
      * @ignore
      */
     unregisterWebCallListeners(): void;
@@ -1102,7 +1088,7 @@ export interface ITask extends EventEmitter {
      * @returns Promise<TaskResponse>
      * @example
      * ```typescript
-     * await task.accept();
+     * task.accept();
      * ```
      */
     accept(): Promise<TaskResponse>;
@@ -1111,54 +1097,44 @@ export interface ITask extends EventEmitter {
      * @returns Promise<TaskResponse>
      * @example
      * ```typescript
-     * await task.decline();
+     * task.decline();
      * ```
      */
     decline(): Promise<TaskResponse>;
     /**
-     * Places the current task on hold.
-     * @param mediaResourceId - Optional media resource ID to use for the hold operation. If not provided, uses the task's current mediaResourceId
+     * Places the current task on hold
      * @returns Promise<TaskResponse>
      * @example
      * ```typescript
-     * // Hold with default mediaResourceId
-     * await task.hold();
-     *
-     * // Hold with custom mediaResourceId
-     * await task.hold('custom-media-resource-id');
+     * task.hold();
      * ```
      */
-    hold(mediaResourceId?: string): Promise<TaskResponse>;
+    hold(): Promise<TaskResponse>;
     /**
-     * Resumes a task that was previously on hold.
-     * @param mediaResourceId - Optional media resource ID to use for the resume operation. If not provided, uses the task's current mediaResourceId from interaction media
+     * Resumes a task that was previously on hold
      * @returns Promise<TaskResponse>
      * @example
      * ```typescript
-     * // Resume with default mediaResourceId
-     * await task.resume();
-     *
-     * // Resume with custom mediaResourceId
-     * await task.resume('custom-media-resource-id');
+     * task.resume();
      * ```
      */
-    resume(mediaResourceId?: string): Promise<TaskResponse>;
+    resume(): Promise<TaskResponse>;
     /**
-     * Ends/terminates the current task.
+     * Ends/terminates the current task
      * @returns Promise<TaskResponse>
      * @example
      * ```typescript
-     * await task.end();
+     * task.end();
      * ```
      */
     end(): Promise<TaskResponse>;
     /**
-     * Initiates wrap-up process for the task with specified details.
+     * Initiates wrap-up process for the task with specified details
      * @param wrapupPayload - Wrap-up details including reason and auxiliary code
      * @returns Promise<TaskResponse>
      * @example
      * ```typescript
-     * await task.wrapup({
+     * task.wrapup({
      *   wrapUpReason: "Customer issue resolved",
      *   auxCodeId: "RESOLVED"
      * });
@@ -1166,100 +1142,24 @@ export interface ITask extends EventEmitter {
      */
     wrapup(wrapupPayload: WrapupPayLoad): Promise<TaskResponse>;
     /**
-     * Pauses the recording for current task.
+     * Pauses the recording for current task
      * @returns Promise<TaskResponse>
      * @example
      * ```typescript
-     * await task.pauseRecording();
+     * task.pauseRecording();
      * ```
      */
     pauseRecording(): Promise<TaskResponse>;
     /**
-     * Resumes a previously paused recording.
+     * Resumes a previously paused recording
      * @param resumeRecordingPayload - Parameters for resuming the recording
      * @returns Promise<TaskResponse>
      * @example
      * ```typescript
-     * await task.resumeRecording({
+     * task.resumeRecording({
      *   autoResumed: false
      * });
      * ```
      */
     resumeRecording(resumeRecordingPayload: ResumeRecordingPayload): Promise<TaskResponse>;
-    /**
-     * Initiates a consultation with another agent or queue.
-     * @param consultPayload - Consultation details including destination and type
-     * @returns Promise<TaskResponse>
-     * @example
-     * ```typescript
-     * await task.consult({ to: "agentId", destinationType: "agent" });
-     * ```
-     */
-    consult(consultPayload: ConsultPayload): Promise<TaskResponse>;
-    /**
-     * Ends an ongoing consultation.
-     * @param consultEndPayload - Details for ending the consultation
-     * @returns Promise<TaskResponse>
-     * @example
-     * ```typescript
-     * await task.endConsult({ isConsult: true, taskId: "taskId" });
-     * ```
-     */
-    endConsult(consultEndPayload: ConsultEndPayload): Promise<TaskResponse>;
-    /**
-     * Transfers the task to another agent or queue.
-     * @param transferPayload - Transfer details including destination and type
-     * @returns Promise<TaskResponse>
-     * @example
-     * ```typescript
-     * await task.transfer({ to: "queueId", destinationType: "queue" });
-     * ```
-     */
-    transfer(transferPayload: TransferPayLoad): Promise<TaskResponse>;
-    /**
-     * Transfers the task after consultation.
-     * @param consultTransferPayload - Details for consult transfer (optional)
-     * @returns Promise<TaskResponse>
-     * @example
-     * ```typescript
-     * await task.consultTransfer({ to: "agentId", destinationType: "agent" });
-     * ```
-     */
-    consultTransfer(consultTransferPayload?: ConsultTransferPayLoad): Promise<TaskResponse>;
-    /**
-     * Initiates a consult conference (merge consult call with main call).
-     * @returns Promise<TaskResponse>
-     * @example
-     * ```typescript
-     * await task.consultConference();
-     * ```
-     */
-    consultConference(): Promise<TaskResponse>;
-    /**
-     * Exits from an ongoing conference.
-     * @returns Promise<TaskResponse>
-     * @example
-     * ```typescript
-     * await task.exitConference();
-     * ```
-     */
-    exitConference(): Promise<TaskResponse>;
-    /**
-     * Transfers the conference to another participant.
-     * @returns Promise<TaskResponse>
-     * @example
-     * ```typescript
-     * await task.transferConference();
-     * ```
-     */
-    transferConference(): Promise<TaskResponse>;
-    /**
-     * Toggles mute/unmute for the local audio stream during a WebRTC task.
-     * @returns Promise<void>
-     * @example
-     * ```typescript
-     * await task.toggleMute();
-     * ```
-     */
-    toggleMute(): Promise<void>;
 }

package/dist/webex.js

@@ -29,7 +29,7 @@ if (!global.Buffer) {
  */
 const Webex = _webexCore.default.extend({
   webex: true,
-  version: `3.10.0-next.9`
+  version: `3.10.0-wxc-disconnect.1`
 });
 
 /**

package/package.json

@@ -45,13 +45,13 @@
   },
   "dependencies": {
     "@types/platform": "1.3.4",
-    "@webex/calling": "3.10.0-next.6",
-    "@webex/internal-plugin-mercury": "3.10.0-next.2",
-    "@webex/internal-plugin-metrics": "3.10.0-next.2",
-    "@webex/internal-plugin-support": "3.10.0-next.2",
-    "@webex/plugin-authorization": "3.10.0-next.2",
-    "@webex/plugin-logger": "3.10.0-next.2",
-    "@webex/webex-core": "3.10.0-next.2",
+    "@webex/calling": "3.10.0-wxc-disconnect.1",
+    "@webex/internal-plugin-mercury": "3.10.0-wxc-disconnect.1",
+    "@webex/internal-plugin-metrics": "3.10.0-wxc-disconnect.1",
+    "@webex/internal-plugin-support": "3.10.0-wxc-disconnect.1",
+    "@webex/plugin-authorization": "3.10.0-wxc-disconnect.1",
+    "@webex/plugin-logger": "3.10.0-wxc-disconnect.1",
+    "@webex/webex-core": "3.10.0-wxc-disconnect.1",
     "jest-html-reporters": "3.0.11",
     "lodash": "^4.17.21"
   },
@@ -65,7 +65,7 @@
     "@webex/eslint-config-legacy": "0.0.0",
     "@webex/jest-config-legacy": "0.0.0",
     "@webex/legacy-tools": "0.0.0",
-    "@webex/test-helper-mock-webex": "3.8.1-next.11",
+    "@webex/test-helper-mock-webex": "3.10.0-wxc-disconnect.1",
     "eslint": "^8.24.0",
     "eslint-config-airbnb-base": "15.0.0",
     "eslint-config-prettier": "8.3.0",
@@ -80,5 +80,5 @@
     "typedoc": "^0.25.0",
     "typescript": "4.9.5"
   },
-  "version": "3.10.0-next.9"
+  "version": "3.10.0-wxc-disconnect.1"
 }

package/src/cc.ts

@@ -396,16 +396,6 @@ export default class ContactCenter extends WebexPlugin implements IContactCenter
     this.trigger(TASK_EVENTS.TASK_HYDRATE, task);
   };
 
-  /**
-   * Handles task merged events when tasks are combined eg: EPDN merge/transfer
-   * @private
-   * @param {ITask} task The task object that has been merged
-   */
-  private handleTaskMerged = (task: ITask) => {
-    // @ts-ignore
-    this.trigger(TASK_EVENTS.TASK_MERGED, task);
-  };
-
   /**
    * Sets up event listeners for incoming tasks and task hydration
    * Subscribes to task events from the task manager
@@ -414,7 +404,6 @@ export default class ContactCenter extends WebexPlugin implements IContactCenter
   private incomingTaskListener() {
     this.taskManager.on(TASK_EVENTS.TASK_INCOMING, this.handleIncomingTask);
     this.taskManager.on(TASK_EVENTS.TASK_HYDRATE, this.handleTaskHydrate);
-    this.taskManager.on(TASK_EVENTS.TASK_MERGED, this.handleTaskMerged);
   }
 
   /**
@@ -795,7 +784,7 @@ export default class ContactCenter extends WebexPlugin implements IContactCenter
         throw error;
       }
 
-      const loginResponse = await this.services.agent.stationLogin({
+      const loginResponse = this.services.agent.stationLogin({
         data: {
           dialNumber:
             data.loginOption === LoginOption.BROWSER ? this.agentConfig.agentId : data.dialNumber,

package/src/index.ts

@@ -126,7 +126,6 @@ export type {
   AgentContact,
   /** Task interface */
   ITask,
-  Interaction,
   TaskData,
   /** Task response */
   TaskResponse,

package/src/services/config/types.ts

@@ -63,6 +63,8 @@ export const CC_TASK_EVENTS = {
   AGENT_CONFERENCE_TRANSFERRED: 'AgentConferenceTransferred',
   /** Event emitted when conference transfer fails */
   AGENT_CONFERENCE_TRANSFER_FAILED: 'AgentConferenceTransferFailed',
+  /** Event emitted when consulted participant is moving/being transferred */
+  CONSULTED_PARTICIPANT_MOVING: 'ConsultedParticipantMoving',
   /** Event emitted for post-call activity by participant */
   PARTICIPANT_POST_CALL_ACTIVITY: 'ParticipantPostCallActivity',
   /** Event emitted when contact is blind transferred */
@@ -89,8 +91,6 @@ export const CC_TASK_EVENTS = {
   CONTACT_RECORDING_RESUME_FAILED: 'ContactRecordingResumeFailed',
   /** Event emitted when contact ends */
   CONTACT_ENDED: 'ContactEnded',
-  /** Event emitted when contact is merged */
-  CONTACT_MERGED: 'ContactMerged',
   /** Event emitted when ending contact fails */
   AGENT_CONTACT_END_FAILED: 'AgentContactEndFailed',
   /** Event emitted when agent enters wrap-up state */

package/src/services/core/Utils.ts

@@ -6,10 +6,11 @@ import WebexRequest from './WebexRequest';
 import {
   TaskData,
   ConsultTransferPayLoad,
+  ConsultConferenceData,
+  consultConferencePayloadData,
   CONSULT_TRANSFER_DESTINATION_TYPE,
   Interaction,
 } from '../task/types';
-import {PARTICIPANT_TYPES, STATE_CONSULT} from './constants';
 
 /**
  * Extracts common error details from a Webex request payload.
@@ -217,118 +218,59 @@ export const createErrDetailsObject = (errObj: WebexRequestPayload) => {
 };
 
 /**
- * Gets the consulted agent ID from the media object by finding the agent
- * in the consult media participants (excluding the current agent).
+ * Derives the consult transfer destination type based on the provided task data.
  *
- * @param media - The media object from the interaction
- * @param agentId - The current agent's ID to exclude from the search
- * @returns The consulted agent ID, or empty string if none found
- */
-export const getConsultedAgentId = (media: Interaction['media'], agentId: string): string => {
-  let consultParticipants: string[] = [];
-  let consultedParticipantId = '';
-
-  Object.keys(media).forEach((key) => {
-    if (media[key].mType === STATE_CONSULT) {
-      consultParticipants = media[key].participants;
-    }
-  });
-
-  if (consultParticipants.includes(agentId)) {
-    const id = consultParticipants.find((participant) => participant !== agentId);
-    consultedParticipantId = id || consultedParticipantId;
-  }
-
-  return consultedParticipantId;
-};
-
-/**
- * Gets the destination agent ID for CBT (Capacity Based Team) scenarios.
- * CBT refers to teams created in Control Hub with capacity-based routing
- * (as opposed to agent-based routing). This handles cases where the consulted
- * participant is not directly in participants but can be found by matching
- * the dial number (dn).
+ * Logic parity with desktop behavior:
+ * - If agent action is dialing a number (DN/EPDN/ENTRYPOINT):
+ *   - ENTRYPOINT/EPDN map to ENTRYPOINT
+ *   - DN maps to DIALNUMBER
+ * - Otherwise defaults to AGENT
  *
- * @param interaction - The interaction object
- * @param consultingAgent - The consulting agent identifier
- * @returns The destination agent ID for CBT scenarios, or empty string if none found
+ * @param taskData - The task data used to infer the agent action and destination type
+ * @returns The normalized destination type to be used for consult transfer
  */
-export const getDestAgentIdForCBT = (interaction: Interaction, consultingAgent: string): string => {
-  const participants = interaction.participants;
-  let destAgentIdForCBT = '';
-
-  // Check if this is a CBT scenario (consultingAgent exists but not directly in participants)
-  if (consultingAgent && !participants[consultingAgent]) {
-    const foundEntry = Object.entries(participants).find(
-      ([, participant]: [string, Interaction['participants'][string]]) => {
-        return (
-          participant.pType.toLowerCase() === PARTICIPANT_TYPES.DN &&
-          participant.type === PARTICIPANT_TYPES.AGENT &&
-          participant.dn === consultingAgent
-        );
-      }
-    );
-
-    if (foundEntry) {
-      destAgentIdForCBT = foundEntry[0];
-    }
-  }
-
-  return destAgentIdForCBT;
-};
-
 /**
- * Calculates the destination agent ID for consult operations.
- *
- * @param interaction - The interaction object
- * @param agentId - The current agent's ID
- * @returns The destination agent ID
+ * Checks if a participant type represents a non-customer participant.
+ * Non-customer participants include agents, dial numbers, entry point dial numbers,
+ * and entry points.
  */
-export const calculateDestAgentId = (interaction: Interaction, agentId: string): string => {
-  const consultingAgent = getConsultedAgentId(interaction.media, agentId);
-
-  // Check if this is a CBT (Capacity Based Team) scenario
-  // If not CBT, the function will return empty string and we'll use the normal flow
-  const destAgentIdCBT = getDestAgentIdForCBT(interaction, consultingAgent);
-  if (destAgentIdCBT) {
-    return destAgentIdCBT;
-  }
-
-  return interaction.participants[consultingAgent]?.type === PARTICIPANT_TYPES.EP_DN
-    ? interaction.participants[consultingAgent]?.epId
-    : interaction.participants[consultingAgent]?.id;
+const isNonCustomerParticipant = (participantType: string): boolean => {
+  return (
+    participantType === 'Agent' ||
+    participantType === 'DN' ||
+    participantType === 'EpDn' ||
+    participantType === 'entryPoint'
+  );
 };
 
 /**
- * Calculates the destination agent ID for fetching destination type.
+ * Gets the destination agent ID from participants data by finding the first
+ * non-customer participant that is not the current agent and is not in wrap-up state.
  *
- * @param interaction - The interaction object
- * @param agentId - The current agent's ID
- * @returns The destination agent ID for determining destination type
+ * @param participants - The participants data from the interaction
+ * @param agentId - The current agent's ID to exclude from the search
+ * @returns The destination agent ID, or empty string if none found
  */
-export const calculateDestType = (interaction: Interaction, agentId: string): string => {
-  const consultingAgent = getConsultedAgentId(interaction.media, agentId);
-
-  // Check if this is a CBT (Capacity Based Team) scenario, otherwise use consultingAgent
-  const destAgentIdCBT = getDestAgentIdForCBT(interaction, consultingAgent);
-  const destinationaegntId = destAgentIdCBT || consultingAgent;
-  const destAgentType = destinationaegntId
-    ? interaction.participants[destinationaegntId]?.pType
-    : undefined;
-  if (destAgentType) {
-    if (destAgentType === 'DN') {
-      return CONSULT_TRANSFER_DESTINATION_TYPE.DIALNUMBER;
-    }
-    if (destAgentType === 'EP-DN') {
-      return CONSULT_TRANSFER_DESTINATION_TYPE.ENTRYPOINT;
-    }
-    // Keep the existing destinationType if it's something else (like "agent" or "Agent")
-    // Convert "Agent" to lowercase for consistency
-
-    return destAgentType.toLowerCase();
+export const getDestinationAgentId = (
+  participants: Interaction['participants'],
+  agentId: string
+): string => {
+  let id = '';
+
+  if (participants) {
+    Object.keys(participants).forEach((participant) => {
+      const participantData = participants[participant];
+      if (
+        isNonCustomerParticipant(participantData.type) &&
+        participantData.id !== agentId &&
+        !participantData.isWrapUp
+      ) {
+        id = participantData.id;
+      }
+    });
   }
 
-  return CONSULT_TRANSFER_DESTINATION_TYPE.AGENT;
+  return id;
 };
 
 export const deriveConsultTransferDestinationType = (
@@ -344,3 +286,45 @@ export const deriveConsultTransferDestinationType = (
 
   return CONSULT_TRANSFER_DESTINATION_TYPE.AGENT;
 };
+
+/**
+ * Builds consult conference parameter data using EXACT Agent Desktop logic.
+ * This matches the Agent Desktop's consultConference implementation exactly.
+ *
+ * @param dataPassed - Original consultation data from Agent Desktop format
+ * @param interactionIdPassed - The interaction ID for the task
+ * @returns Object with interactionId and ConsultConferenceData matching Agent Desktop format
+ * @public
+ */
+export const buildConsultConferenceParamData = (
+  dataPassed: consultConferencePayloadData,
+  interactionIdPassed: string
+): {interactionId: string; data: ConsultConferenceData} => {
+  const data: ConsultConferenceData = {
+    // Include agentId if present in input data
+    ...('agentId' in dataPassed && {agentId: dataPassed.agentId}),
+    // Handle destAgentId from consultation data
+    to: dataPassed.destAgentId,
+    destinationType: '',
+  };
+
+  // Agent Desktop destination type logic
+  if ('destinationType' in dataPassed) {
+    if (dataPassed.destinationType === 'DN') {
+      data.destinationType = CONSULT_TRANSFER_DESTINATION_TYPE.DIALNUMBER;
+    } else if (dataPassed.destinationType === 'EP_DN') {
+      data.destinationType = CONSULT_TRANSFER_DESTINATION_TYPE.ENTRYPOINT;
+    } else {
+      // Keep the existing destinationType if it's something else (like "agent" or "Agent")
+      // Convert "Agent" to lowercase for consistency
+      data.destinationType = dataPassed.destinationType.toLowerCase();
+    }
+  } else {
+    data.destinationType = CONSULT_TRANSFER_DESTINATION_TYPE.AGENT;
+  }
+
+  return {
+    interactionId: interactionIdPassed,
+    data,
+  };
+};

package/src/services/core/constants.ts

@@ -64,22 +64,6 @@ export const CONNECTIVITY_CHECK_INTERVAL = 5000;
  */
 export const CLOSE_SOCKET_TIMEOUT = 16000;
 
-/**
- * Constants for participant types, destination types, and interaction states
- * @ignore
- */
-export const PARTICIPANT_TYPES = {
-  /** Participant type for Entry Point Dial Number */
-  EP_DN: 'EpDn',
-  /** Participant type for dial number */
-  DN: 'dn',
-  /** Participant type for Agent */
-  AGENT: 'Agent',
-};
-
-/** Interaction state for consultation */
-export const STATE_CONSULT = 'consult';
-
 // Method names for core services
 export const METHODS = {
   // WebexRequest methods