@webex/contact-center 3.12.0-next.9 → 3.12.0-task-refactor.1

package/src/services/task/state-machine/constants.ts

@@ -0,0 +1,150 @@
+/**
+ * Constants for the task state machine.
+ * These enums define the allowed states, events, and built-in action identifiers.
+ */
+
+// ============================================
+// Conference Constants
+// ============================================
+
+/**
+ * Maximum number of participants allowed in a multi-party conference.
+ * Max 7 counted agents + 1 customer.
+ */
+export const MAX_PARTICIPANTS_IN_MULTIPARTY_CONFERENCE = 7;
+
+// ============================================
+// Participant Type Constants
+// ============================================
+
+/** Participant types for conference filtering */
+export const PARTICIPANT_TYPE = {
+  CUSTOMER: 'Customer',
+  SUPERVISOR: 'Supervisor',
+  VVA: 'VVA',
+} as const;
+
+export type ParticipantType = (typeof PARTICIPANT_TYPE)[keyof typeof PARTICIPANT_TYPE];
+
+// ============================================
+// Media Type Constants
+// ============================================
+
+/** Media type for consult calls */
+export const MEDIA_TYPE_CONSULT = 'consult';
+
+/** Media type for main calls */
+export const MEDIA_TYPE_MAIN_CALL = 'mainCall';
+
+// ============================================
+// State Machine Enums
+// ============================================
+
+export enum TaskState {
+  IDLE = 'IDLE',
+  OFFERED = 'OFFERED',
+  CONNECTED = 'CONNECTED',
+
+  // Intermediate states for async operations
+  HOLD_INITIATING = 'HOLD_INITIATING',
+  HELD = 'HELD',
+  RESUME_INITIATING = 'RESUME_INITIATING',
+  CONSULT_INITIATING = 'CONSULT_INITIATING',
+  CONSULTING = 'CONSULTING',
+  CONF_INITIATING = 'CONF_INITIATING',
+
+  CONFERENCING = 'CONFERENCING',
+  WRAPPING_UP = 'WRAPPING_UP',
+  COMPLETED = 'COMPLETED',
+  TERMINATED = 'TERMINATED',
+
+  // NOT IMPLEMENTED: MPC (Multi-Party Conference) states
+  CONSULT_INITIATED = 'CONSULT_INITIATED',
+  CONSULT_COMPLETED = 'CONSULT_COMPLETED',
+  // NOT IMPLEMENTED: Post-call state (isWxccPostCallEnabled feature flag)
+  POST_CALL = 'POST_CALL',
+  // NOT IMPLEMENTED: Parked state
+  PARKED = 'PARKED',
+  // NOT IMPLEMENTED: Monitoring/Supervisory states
+  MONITORING = 'MONITORING',
+}
+
+export enum TaskEvent {
+  TASK_INCOMING = 'TASK_INCOMING',
+  TASK_OFFERED = 'TASK_OFFERED',
+
+  // Offer events
+  OFFER_CONSULT = 'OFFER_CONSULT',
+  HYDRATE = 'HYDRATE',
+
+  // Internal "data refresh" events
+  CONTACT_UPDATED = 'CONTACT_UPDATED',
+  CONTACT_OWNER_CHANGED = 'CONTACT_OWNER_CHANGED',
+
+  // Assignment events
+  ASSIGN = 'ASSIGN',
+
+  // Hold/Resume events
+  HOLD_SUCCESS = 'HOLD_SUCCESS',
+  HOLD_FAILED = 'HOLD_FAILED',
+  UNHOLD_SUCCESS = 'UNHOLD_SUCCESS',
+  UNHOLD_FAILED = 'UNHOLD_FAILED',
+  HOLD_INITIATED = 'HOLD_INITIATED',
+  UNHOLD_INITIATED = 'UNHOLD_INITIATED',
+
+  // Consult events
+  CONSULT = 'CONSULT',
+  CONSULT_SUCCESS = 'CONSULT_SUCCESS',
+  CONSULT_CREATED = 'CONSULT_CREATED',
+  CONSULTING_ACTIVE = 'CONSULTING_ACTIVE',
+  CONSULT_END = 'CONSULT_END',
+  CONSULT_FAILED = 'CONSULT_FAILED',
+
+  // Conference events
+  MERGE_TO_CONFERENCE = 'MERGE_TO_CONFERENCE',
+  CONFERENCE_START = 'CONFERENCE_START',
+  CONFERENCE_FAILED = 'CONFERENCE_FAILED',
+  CONFERENCE_END = 'CONFERENCE_END',
+  TRANSFER_CONFERENCE = 'TRANSFER_CONFERENCE',
+  TRANSFER_CONFERENCE_SUCCESS = 'TRANSFER_CONFERENCE_SUCCESS',
+  TRANSFER_CONFERENCE_FAILED = 'TRANSFER_CONFERENCE_FAILED',
+  PARTICIPANT_LEAVE = 'PARTICIPANT_LEAVE',
+  EXIT_CONFERENCE = 'EXIT_CONFERENCE',
+  EXIT_CONFERENCE_SUCCESS = 'EXIT_CONFERENCE_SUCCESS',
+  EXIT_CONFERENCE_FAILED = 'EXIT_CONFERENCE_FAILED',
+
+  // Recording events
+  RECORDING_STARTED = 'RECORDING_STARTED',
+  PAUSE_RECORDING = 'PAUSE_RECORDING',
+  RESUME_RECORDING = 'RESUME_RECORDING',
+
+  // Transfer events
+  TRANSFER_SUCCESS = 'TRANSFER_SUCCESS',
+  TRANSFER_FAILED = 'TRANSFER_FAILED',
+
+  // Wrapup events
+  WRAPUP_COMPLETE = 'WRAPUP_COMPLETE',
+
+  // End events
+  TASK_WRAPUP = 'TASK_WRAPUP',
+  RONA = 'RONA', // Ring On No Answer
+  CONTACT_ENDED = 'CONTACT_ENDED',
+
+  // Failure events
+  ASSIGN_FAILED = 'ASSIGN_FAILED',
+  INVITE_FAILED = 'INVITE_FAILED',
+  OUTBOUND_FAILED = 'OUTBOUND_FAILED',
+
+  // Switch events (toggle between consult and main call)
+  SWITCH_TO_MAIN_CALL = 'SWITCH_TO_MAIN_CALL',
+  SWITCH_TO_CONSULT = 'SWITCH_TO_CONSULT',
+
+  // Accept/Decline (WebRTC)
+  ACCEPT = 'ACCEPT',
+  DECLINE = 'DECLINE',
+  END = 'END',
+
+  // Queue events
+  CTQ_CANCEL = 'CTQ_CANCEL', // Cancel To Queue
+  CTQ_CANCEL_FAILED = 'CTQ_CANCEL_FAILED',
+}

package/src/services/task/state-machine/guards.ts

@@ -0,0 +1,295 @@
+/**
+ * Task State Machine Guards
+ *
+ * Guard functions that determine if a state transition is allowed.
+ * These functions validate the current context before allowing transitions.
+ *
+ * All guards are consolidated here for:
+ * - Single source of truth
+ * - Easy testing
+ * - Reusability across state machine transitions
+ *
+ * Guards are organized by category:
+ * 1. Helper Functions - Extract data from events/context
+ * 2. Hydrate Guards - For state restoration on page refresh
+ * 3. Conference Guards - Conference state checks
+ * 4. Customer Guards - Customer presence checks
+ * 5. Consult Guards - Consult flow checks
+ * 6. Wrapup Guards - End-of-call flow checks
+ * 7. Server State Guards - Check backend-reported state
+ * 8. Recording Guards - Recording state checks
+ */
+
+import {TaskContext, TaskEventPayload} from './types';
+import {TaskData} from '../types';
+import {
+  getIsCustomerInCall,
+  getConferenceParticipantsCount,
+  getIsConferenceInProgress,
+} from '../TaskUtils';
+import {TaskEvent} from './constants';
+
+export const getTaskDataFromEvent = (event?: TaskEventPayload): TaskData | undefined =>
+  event && typeof event === 'object' && 'taskData' in event
+    ? (event as {taskData?: TaskData}).taskData
+    : undefined;
+
+export const getSelfAgentId = (context: TaskContext, taskData?: TaskData): string | undefined =>
+  context.uiControlConfig?.agentId ?? context.taskData?.agentId ?? taskData?.agentId;
+
+export const isSelfConsultingAgent = (context: TaskContext, taskData?: TaskData): boolean => {
+  const selfAgentId = getSelfAgentId(context, taskData);
+  if (!selfAgentId) return false;
+
+  return taskData?.consultingAgentId === selfAgentId;
+};
+
+/**
+ * Determines if this agent should enter WRAPPING_UP state.
+ * Priority: agentsPendingWrapUp > wrapUpRequired / participant.isWrapUp > ownership > !isConsulted
+ */
+export const shouldWrapUpForThisAgent = (context: TaskContext, taskData: TaskData): boolean => {
+  const selfAgentId = getSelfAgentId(context, taskData);
+  if (!selfAgentId) return false;
+
+  const pending = taskData?.agentsPendingWrapUp;
+  if (Array.isArray(pending) && pending.length > 0) {
+    return pending.includes(selfAgentId);
+  }
+
+  const participantWrapUp = taskData?.interaction?.participants?.[selfAgentId]?.isWrapUp === true;
+  const wrapUpRequired = taskData?.wrapUpRequired === true;
+  if (wrapUpRequired || participantWrapUp) {
+    return true;
+  }
+
+  const owner = taskData?.interaction?.owner;
+  if (owner && owner === selfAgentId) {
+    return true;
+  }
+
+  if (taskData?.isConsulted === false) {
+    return true;
+  }
+
+  return false;
+};
+
+export interface GuardParams {
+  context: TaskContext;
+  event?: TaskEventPayload;
+}
+
+export type GuardFunction = (params: GuardParams) => boolean;
+
+export const guards = {
+  // Hydrate Guards
+  isInteractionTerminated: ({context, event}: GuardParams): boolean => {
+    const taskData = getTaskDataFromEvent(event);
+
+    if (taskData?.interaction?.isTerminated === true) return true;
+
+    const selfAgentId = getSelfAgentId(context, taskData);
+    if (selfAgentId && taskData?.interaction?.participants?.[selfAgentId]?.isWrapUp === true) {
+      return true;
+    }
+
+    return false;
+  },
+
+  isInteractionConsulting: ({event}: GuardParams): boolean => {
+    const taskData = getTaskDataFromEvent(event);
+
+    return taskData?.interaction?.state === 'consulting';
+  },
+
+  isInteractionHeld: ({event}: GuardParams): boolean => {
+    const taskData = getTaskDataFromEvent(event);
+
+    if (taskData?.interaction?.state === 'hold') return true;
+
+    const mainMediaId = taskData?.interaction?.mainInteractionId || taskData?.interactionId;
+    if (mainMediaId && taskData?.interaction?.media?.[mainMediaId]?.isHold === true) {
+      return true;
+    }
+
+    return false;
+  },
+
+  isInteractionConnected: ({event}: GuardParams): boolean => {
+    const taskData = getTaskDataFromEvent(event);
+
+    return taskData?.interaction?.state === 'connected';
+  },
+
+  isConferencingByParticipants: ({event}: GuardParams): boolean => {
+    const taskData = getTaskDataFromEvent(event);
+    if (!taskData) return false;
+    const mainCallId = taskData.interaction?.mainInteractionId || taskData.interactionId;
+    const media = taskData.interaction?.media?.[mainCallId];
+    const participants = taskData.interaction?.participants;
+    if (!media?.participants || !participants) return false;
+    let agentCount = 0;
+    for (const pId of media.participants) {
+      const p = participants[pId];
+      if (p && p.pType !== 'Customer' && p.pType !== 'Supervisor' && !p.hasLeft) {
+        agentCount += 1;
+      }
+    }
+
+    return agentCount >= 2;
+  },
+
+  // Conference Guards
+  conferenceInProgressFromEvent: ({event}: GuardParams): boolean => {
+    const taskData = getTaskDataFromEvent(event);
+    if (!taskData?.interaction) return false;
+
+    return getIsConferenceInProgress(taskData);
+  },
+
+  /**
+   * Conference downgrade check specifically for transitioning back to CONNECTED.
+   *
+   * Returns true only when:
+   * - conference has downgraded (fewer than 2 active agent participants in main call)
+   * - customer is still in the call
+   * - current agent is still in the main call
+   */
+  shouldDowngradeConferenceToConnected: ({context, event}: GuardParams): boolean => {
+    const eventTaskData = getTaskDataFromEvent(event);
+    const taskData = eventTaskData ?? context.taskData;
+    if (!taskData?.interaction) return false;
+
+    const selfAgentId = getSelfAgentId(context, taskData);
+    if (!selfAgentId) return false;
+
+    const mainCallId = taskData.interaction.mainInteractionId || taskData.interactionId;
+    if (!mainCallId) return false;
+
+    // Don't downgrade while backend still reports conference.
+    if (taskData.interaction.state === 'conference') return false;
+
+    const agentParticipantsCount = getConferenceParticipantsCount(taskData.interaction, mainCallId);
+    if (agentParticipantsCount >= 2) return false;
+
+    const customerInCall = getIsCustomerInCall(taskData.interaction, mainCallId);
+    if (!customerInCall) return false;
+
+    const selfInMainCall = Boolean(
+      taskData.interaction.media?.[mainCallId]?.participants?.includes(selfAgentId)
+    );
+
+    return selfInMainCall;
+  },
+
+  // Consult Guards
+  /**
+   * Check if this agent initiated the consult (using event data)
+   * Handles both consultingAgentId and fallback to context flag
+   */
+  didInitiateConsult: ({context, event}: GuardParams): boolean => {
+    const taskData = getTaskDataFromEvent(event);
+    if (taskData?.isConsulted === true) return false;
+
+    return taskData?.consultingAgentId
+      ? isSelfConsultingAgent(context, taskData)
+      : context.consultInitiator === true;
+  },
+
+  /**
+   * EP-DN / consulted consult legs can arrive as AGENT_CONTACT_ASSIGNED without a preceding
+   * AgentConsulting event. When that happens, we should enter CONSULTING (not CONNECTED).
+   */
+  isConsultingAssignment: ({event}: GuardParams): boolean => {
+    const taskData = getTaskDataFromEvent(event);
+    if (!taskData) return false;
+
+    const relationshipType = taskData.interaction?.callProcessingDetails?.relationshipType;
+
+    return (
+      taskData.isConsulted === true ||
+      relationshipType === 'consult' ||
+      taskData.interaction?.state === 'consulting'
+    );
+  },
+
+  // Wrapup Guards
+  shouldWrapUp: ({context, event}: GuardParams): boolean => {
+    const taskData = getTaskDataFromEvent(event);
+    if (!taskData) return false;
+
+    if (event?.type === TaskEvent.CONFERENCE_END) {
+      const selfAgentId = getSelfAgentId(context, taskData);
+      if (!selfAgentId) return false;
+
+      const pending = taskData?.agentsPendingWrapUp;
+      if (Array.isArray(pending) && pending.length > 0) {
+        return pending.includes(selfAgentId);
+      }
+
+      const participantWrapUp =
+        taskData?.interaction?.participants?.[selfAgentId]?.isWrapUp === true;
+      const wrapUpRequired = taskData?.wrapUpRequired === true;
+
+      return wrapUpRequired || participantWrapUp;
+    }
+
+    return shouldWrapUpForThisAgent(context, taskData);
+  },
+
+  /**
+   * Check if wrapUpRequired in payload OR is consult initiator
+   */
+  shouldWrapUpOrIsInitiator: ({context, event}: GuardParams): boolean => {
+    const taskData = getTaskDataFromEvent(event);
+
+    return Boolean(taskData?.wrapUpRequired || context.consultInitiator);
+  },
+
+  /**
+   * True if PARTICIPANT_LEAVE indicates that *this* agent left the conference.
+   *
+   * Important: PARTICIPANT_LEAVE is broadcast to all agents in the conference.
+   * Only the agent whose id matches the leaving participant should transition to
+   * TERMINATED / WRAPPING_UP based on wrapup rules.
+   */
+  didCurrentAgentLeaveConference: ({context, event}: GuardParams): boolean => {
+    const taskData = getTaskDataFromEvent(event);
+    const selfAgentId = getSelfAgentId(context, taskData);
+    if (!selfAgentId) return false;
+
+    const participantIdFromEvent =
+      event && typeof event === 'object' && 'participantId' in event
+        ? (event as {participantId?: string}).participantId
+        : undefined;
+    const participantId = participantIdFromEvent ?? taskData?.participantId;
+
+    if (Boolean(participantId) && participantId === selfAgentId) {
+      return true;
+    }
+
+    //    For EP-DN agents the backend removes the leaving participant entirely
+    //    from the participants map (rather than setting hasLeft). If this task
+    //    is in CONFERENCING (implied by the guard being evaluated here) but the
+    //    agent is absent from the updated participants, they have left.
+    const participants = taskData?.interaction?.participants;
+    if (participants && !(selfAgentId in participants)) {
+      return true;
+    }
+
+    return false;
+  },
+
+  // Server State Guards
+  isPrimaryMediaOnHold: ({event}: GuardParams): boolean => {
+    const taskData = getTaskDataFromEvent(event);
+    if (!taskData) return false;
+    const mediaId = taskData.mediaResourceId;
+    if (!mediaId) return false;
+
+    return taskData.interaction?.media?.[mediaId]?.isHold === true;
+  },
+};
+
+export type GuardName = keyof typeof guards;

package/src/services/task/state-machine/index.ts

@@ -0,0 +1,28 @@
+/**
+ * Task State Machine
+ *
+ * Export all state machine components for easy importing
+ */
+
+// Main state machine
+export {createTaskStateMachine} from './TaskStateMachine';
+export type {TaskStateMachine} from './TaskStateMachine';
+
+// Types & enums
+export {TaskState, TaskEvent} from './constants';
+export {isEventOfType} from './types';
+export type {
+  TaskContext,
+  TaskEventPayload,
+  TaskStateMachineConfig,
+  UIControlConfig,
+  TaskActionsMap,
+  TaskActionArgs,
+} from './types';
+
+// Guards
+export {guards} from './guards';
+export type {GuardParams, GuardFunction} from './guards';
+
+// Actions
+export {actions, createInitialContext} from './actions';

package/src/services/task/state-machine/types.ts

@@ -0,0 +1,228 @@
+/**
+ * Task State Machine Types
+ *
+ * Type definitions for the XState-based task state machine.
+ * These types define states, events, context, and schemas for task lifecycle management.
+ */
+
+import type {AnyStateNodeConfig, ActionFunctionMap, EventObject, ActionArgs} from 'xstate';
+import {DestinationType, TaskChannelType, TaskData, TaskUIControls, VoiceVariant} from '../types';
+import {TaskEvent, TaskState} from './constants';
+
+/**
+ * Represents a participant in a conference call
+ */
+export interface ConferenceParticipant {
+  /** Unique identifier for the participant */
+  id: string;
+  /** Type of participant (agent, customer, or external party) */
+  type: 'AGENT' | 'CUSTOMER' | 'EXTERNAL';
+  /** Display name of the participant */
+  name?: string;
+  /** Timestamp when participant joined the conference */
+  joinedAt: Date;
+  /** Whether this participant initiated the conference */
+  isInitiator: boolean;
+  /** Whether this participant can be removed from the conference */
+  canBeRemoved: boolean;
+}
+
+/**
+ * UI Control configuration for the task
+ */
+export interface UIControlConfig {
+  /** Whether end call button is enabled (config option) */
+  isEndTaskEnabled: boolean;
+  /** Whether end consult button is enabled (config option) */
+  isEndConsultEnabled: boolean;
+  /** Channel type determines which controls are available */
+  channelType: TaskChannelType;
+  /** Optional voice channel variant to toggle WebRTC-specific controls */
+  voiceVariant?: VoiceVariant;
+  /** Whether recording controls should be shown for this task */
+  isRecordingEnabled: boolean;
+  /** Current agent ID for ownership checks (transfer conference) */
+  agentId?: string;
+}
+
+/**
+ * Task state machine context.
+ * Only stores data that cannot be derived from state machine state.
+ */
+export interface TaskContext {
+  taskData: TaskData | null;
+
+  // Consult tracking
+  consultInitiator: boolean;
+  exitingConference: boolean;
+  consultFromConference: boolean;
+  transferConferenceRequested: boolean;
+  consultDestinationType: DestinationType | null;
+  consultDestinationAgentId: string | null;
+  consultDestinationAgentJoined: boolean;
+  consultCallHeld: boolean;
+
+  // Recording
+  recordingControlsAvailable: boolean;
+  recordingInProgress: boolean;
+
+  // UI
+  uiControlConfig: UIControlConfig;
+  uiControls: TaskUIControls;
+}
+
+export type RecordingStateUpdate = Partial<
+  Pick<TaskContext, 'recordingControlsAvailable' | 'recordingInProgress'>
+>;
+
+/**
+ * Base event type - all events have a type property
+ */
+type BaseEvent<T extends TaskEvent> = {type: T};
+
+/**
+ * Event payload mapping - defines the payload for each event type
+ */
+interface TaskEventPayloadMap {
+  [TaskEvent.TASK_INCOMING]: BaseEvent<TaskEvent.TASK_INCOMING> & {taskData: TaskData};
+  [TaskEvent.TASK_OFFERED]: BaseEvent<TaskEvent.TASK_OFFERED> & {taskData: TaskData};
+  [TaskEvent.OFFER_CONSULT]: BaseEvent<TaskEvent.OFFER_CONSULT> & {taskData: TaskData};
+  [TaskEvent.HYDRATE]: BaseEvent<TaskEvent.HYDRATE> & {taskData: TaskData; agentId?: string};
+  [TaskEvent.CONTACT_UPDATED]: BaseEvent<TaskEvent.CONTACT_UPDATED> & {taskData: TaskData};
+  [TaskEvent.CONTACT_OWNER_CHANGED]: BaseEvent<TaskEvent.CONTACT_OWNER_CHANGED> & {
+    taskData: TaskData;
+  };
+  [TaskEvent.ASSIGN]: BaseEvent<TaskEvent.ASSIGN> & {taskData: TaskData};
+  [TaskEvent.HOLD_INITIATED]: BaseEvent<TaskEvent.HOLD_INITIATED> & {mediaResourceId: string};
+  [TaskEvent.HOLD_SUCCESS]: BaseEvent<TaskEvent.HOLD_SUCCESS> & {
+    mediaResourceId: string;
+    taskData?: TaskData;
+  };
+  [TaskEvent.HOLD_FAILED]: BaseEvent<TaskEvent.HOLD_FAILED> & {
+    reason?: string;
+    mediaResourceId: string;
+  };
+  [TaskEvent.UNHOLD_INITIATED]: BaseEvent<TaskEvent.UNHOLD_INITIATED> & {mediaResourceId: string};
+  [TaskEvent.UNHOLD_SUCCESS]: BaseEvent<TaskEvent.UNHOLD_SUCCESS> & {
+    mediaResourceId: string;
+    taskData?: TaskData;
+  };
+  [TaskEvent.UNHOLD_FAILED]: BaseEvent<TaskEvent.UNHOLD_FAILED> & {
+    reason?: string;
+    mediaResourceId: string;
+  };
+  [TaskEvent.CONSULT]: BaseEvent<TaskEvent.CONSULT> & {
+    destination: string;
+    destAgentId?: string;
+    destinationType: DestinationType;
+  };
+  [TaskEvent.CONSULT_SUCCESS]: BaseEvent<TaskEvent.CONSULT_SUCCESS> & {taskData?: TaskData};
+  [TaskEvent.CONSULT_CREATED]: BaseEvent<TaskEvent.CONSULT_CREATED> & {taskData: TaskData};
+  [TaskEvent.CONSULTING_ACTIVE]: BaseEvent<TaskEvent.CONSULTING_ACTIVE> & {
+    consultDestinationAgentJoined: boolean;
+    taskData?: TaskData;
+  };
+  [TaskEvent.CONSULT_END]: BaseEvent<TaskEvent.CONSULT_END> & {taskData?: TaskData};
+  [TaskEvent.CONSULT_FAILED]: BaseEvent<TaskEvent.CONSULT_FAILED> & {
+    reason?: string;
+    taskData?: TaskData;
+  };
+  [TaskEvent.MERGE_TO_CONFERENCE]: BaseEvent<TaskEvent.MERGE_TO_CONFERENCE>;
+  [TaskEvent.CONFERENCE_START]: BaseEvent<TaskEvent.CONFERENCE_START> & {
+    participants?: ConferenceParticipant[];
+    taskData?: TaskData;
+  };
+  [TaskEvent.CONFERENCE_FAILED]: BaseEvent<TaskEvent.CONFERENCE_FAILED> & {
+    reason?: string;
+    taskData?: TaskData;
+  };
+  [TaskEvent.CONFERENCE_END]: BaseEvent<TaskEvent.CONFERENCE_END> & {taskData: TaskData};
+  [TaskEvent.TRANSFER_CONFERENCE]: BaseEvent<TaskEvent.TRANSFER_CONFERENCE> & {agentId?: string};
+  [TaskEvent.PARTICIPANT_LEAVE]: BaseEvent<TaskEvent.PARTICIPANT_LEAVE> & {
+    participantId?: string;
+    taskData: TaskData;
+  };
+  [TaskEvent.EXIT_CONFERENCE]: BaseEvent<TaskEvent.EXIT_CONFERENCE> & {agentId?: string};
+  [TaskEvent.EXIT_CONFERENCE_SUCCESS]: BaseEvent<TaskEvent.EXIT_CONFERENCE_SUCCESS> & {
+    taskData: TaskData;
+  };
+  [TaskEvent.EXIT_CONFERENCE_FAILED]: BaseEvent<TaskEvent.EXIT_CONFERENCE_FAILED> & {
+    reason?: string;
+  };
+  [TaskEvent.TRANSFER_CONFERENCE_SUCCESS]: BaseEvent<TaskEvent.TRANSFER_CONFERENCE_SUCCESS> & {
+    taskData: TaskData;
+  };
+  [TaskEvent.TRANSFER_CONFERENCE_FAILED]: BaseEvent<TaskEvent.TRANSFER_CONFERENCE_FAILED> & {
+    reason?: string;
+  };
+  [TaskEvent.RECORDING_STARTED]: BaseEvent<TaskEvent.RECORDING_STARTED> & {taskData: TaskData};
+  [TaskEvent.PAUSE_RECORDING]: BaseEvent<TaskEvent.PAUSE_RECORDING> & {taskData: TaskData};
+  [TaskEvent.RESUME_RECORDING]: BaseEvent<TaskEvent.RESUME_RECORDING> & {taskData: TaskData};
+  [TaskEvent.TRANSFER_SUCCESS]: BaseEvent<TaskEvent.TRANSFER_SUCCESS> & {taskData?: TaskData};
+  [TaskEvent.TRANSFER_FAILED]: BaseEvent<TaskEvent.TRANSFER_FAILED> & {
+    reason?: string;
+    taskData?: TaskData;
+  };
+  [TaskEvent.WRAPUP_COMPLETE]: BaseEvent<TaskEvent.WRAPUP_COMPLETE> & {taskData?: TaskData};
+  [TaskEvent.TASK_WRAPUP]: BaseEvent<TaskEvent.TASK_WRAPUP> & {taskData?: TaskData};
+  [TaskEvent.RONA]: BaseEvent<TaskEvent.RONA> & {taskData?: TaskData; reason?: string};
+  [TaskEvent.CONTACT_ENDED]: BaseEvent<TaskEvent.CONTACT_ENDED> & {taskData: TaskData};
+  [TaskEvent.ASSIGN_FAILED]: BaseEvent<TaskEvent.ASSIGN_FAILED> & {reason?: string};
+  [TaskEvent.INVITE_FAILED]: BaseEvent<TaskEvent.INVITE_FAILED> & {reason?: string};
+  [TaskEvent.OUTBOUND_FAILED]: BaseEvent<TaskEvent.OUTBOUND_FAILED> & {
+    reason?: string;
+    taskData?: TaskData;
+  };
+  [TaskEvent.SWITCH_TO_MAIN_CALL]: BaseEvent<TaskEvent.SWITCH_TO_MAIN_CALL>;
+  [TaskEvent.SWITCH_TO_CONSULT]: BaseEvent<TaskEvent.SWITCH_TO_CONSULT>;
+  [TaskEvent.ACCEPT]: BaseEvent<TaskEvent.ACCEPT>;
+  [TaskEvent.DECLINE]: BaseEvent<TaskEvent.DECLINE>;
+  [TaskEvent.END]: BaseEvent<TaskEvent.END> & {taskData?: TaskData};
+  [TaskEvent.CTQ_CANCEL]: BaseEvent<TaskEvent.CTQ_CANCEL> & {taskData: TaskData};
+  [TaskEvent.CTQ_CANCEL_FAILED]: BaseEvent<TaskEvent.CTQ_CANCEL_FAILED> & {taskData: TaskData};
+}
+
+/**
+ * Union of all possible event payloads
+ */
+export type TaskEventPayload = TaskEventPayloadMap[TaskEvent];
+
+/**
+ * Type guard to check event type
+ */
+export function isEventOfType<T extends TaskEvent>(
+  event: TaskEventPayload | undefined,
+  type: T
+): event is TaskEventPayloadMap[T] {
+  return Boolean(event && event.type === type);
+}
+
+/**
+ * Recording control state for UI controls computer
+ */
+export interface RecordingControlState {
+  available: boolean;
+  inProgress: boolean;
+}
+
+/**
+ * State machine configuration type
+ */
+export interface TaskStateMachineConfig {
+  id: string;
+  initial: TaskState;
+  context: TaskContext;
+  states: Record<string, AnyStateNodeConfig>;
+}
+
+export type TaskActionsMap = ActionFunctionMap<
+  TaskContext,
+  TaskEventPayload,
+  never,
+  {type: string; params: undefined},
+  never,
+  never,
+  EventObject
+>;
+
+export type TaskActionArgs = ActionArgs<TaskContext, TaskEventPayload, TaskEventPayload>;