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

package/dist/services/task/state-machine/constants.js

@@ -0,0 +1,139 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.TaskState = exports.TaskEvent = exports.PARTICIPANT_TYPE = exports.MEDIA_TYPE_MAIN_CALL = exports.MEDIA_TYPE_CONSULT = exports.MAX_PARTICIPANTS_IN_MULTIPARTY_CONFERENCE = void 0;
+/**
+ * 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.
+ */
+const MAX_PARTICIPANTS_IN_MULTIPARTY_CONFERENCE = exports.MAX_PARTICIPANTS_IN_MULTIPARTY_CONFERENCE = 7;
+
+// ============================================
+// Participant Type Constants
+// ============================================
+
+/** Participant types for conference filtering */
+const PARTICIPANT_TYPE = exports.PARTICIPANT_TYPE = {
+  CUSTOMER: 'Customer',
+  SUPERVISOR: 'Supervisor',
+  VVA: 'VVA'
+};
+// ============================================
+// Media Type Constants
+// ============================================
+
+/** Media type for consult calls */
+const MEDIA_TYPE_CONSULT = exports.MEDIA_TYPE_CONSULT = 'consult';
+
+/** Media type for main calls */
+const MEDIA_TYPE_MAIN_CALL = exports.MEDIA_TYPE_MAIN_CALL = 'mainCall';
+
+// ============================================
+// State Machine Enums
+// ============================================
+let TaskState = exports.TaskState = /*#__PURE__*/function (TaskState) {
+  TaskState["IDLE"] = "IDLE";
+  TaskState["OFFERED"] = "OFFERED";
+  TaskState["CONNECTED"] = "CONNECTED";
+  // Intermediate states for async operations
+  TaskState["HOLD_INITIATING"] = "HOLD_INITIATING";
+  TaskState["HELD"] = "HELD";
+  TaskState["RESUME_INITIATING"] = "RESUME_INITIATING";
+  TaskState["CONSULT_INITIATING"] = "CONSULT_INITIATING";
+  TaskState["CONSULTING"] = "CONSULTING";
+  TaskState["CONF_INITIATING"] = "CONF_INITIATING";
+  TaskState["CONFERENCING"] = "CONFERENCING";
+  TaskState["WRAPPING_UP"] = "WRAPPING_UP";
+  TaskState["COMPLETED"] = "COMPLETED";
+  TaskState["TERMINATED"] = "TERMINATED";
+  // NOT IMPLEMENTED: MPC (Multi-Party Conference) states
+  TaskState["CONSULT_INITIATED"] = "CONSULT_INITIATED";
+  TaskState["CONSULT_COMPLETED"] = "CONSULT_COMPLETED";
+  // NOT IMPLEMENTED: Post-call state (isWxccPostCallEnabled feature flag)
+  TaskState["POST_CALL"] = "POST_CALL";
+  // NOT IMPLEMENTED: Parked state
+  TaskState["PARKED"] = "PARKED";
+  // NOT IMPLEMENTED: Monitoring/Supervisory states
+  TaskState["MONITORING"] = "MONITORING";
+  return TaskState;
+}({});
+let TaskEvent = exports.TaskEvent = /*#__PURE__*/function (TaskEvent) {
+  TaskEvent["TASK_INCOMING"] = "TASK_INCOMING";
+  TaskEvent["TASK_OFFERED"] = "TASK_OFFERED";
+  // Offer events
+  TaskEvent["OFFER_CONSULT"] = "OFFER_CONSULT";
+  TaskEvent["HYDRATE"] = "HYDRATE";
+  // Internal "data refresh" events
+  TaskEvent["CONTACT_UPDATED"] = "CONTACT_UPDATED";
+  TaskEvent["CONTACT_OWNER_CHANGED"] = "CONTACT_OWNER_CHANGED";
+  // Assignment events
+  TaskEvent["ASSIGN"] = "ASSIGN";
+  // Hold/Resume events
+  TaskEvent["HOLD_SUCCESS"] = "HOLD_SUCCESS";
+  TaskEvent["HOLD_FAILED"] = "HOLD_FAILED";
+  TaskEvent["UNHOLD_SUCCESS"] = "UNHOLD_SUCCESS";
+  TaskEvent["UNHOLD_FAILED"] = "UNHOLD_FAILED";
+  TaskEvent["HOLD_INITIATED"] = "HOLD_INITIATED";
+  TaskEvent["UNHOLD_INITIATED"] = "UNHOLD_INITIATED";
+  // Consult events
+  TaskEvent["CONSULT"] = "CONSULT";
+  TaskEvent["CONSULT_SUCCESS"] = "CONSULT_SUCCESS";
+  TaskEvent["CONSULT_CREATED"] = "CONSULT_CREATED";
+  TaskEvent["CONSULTING_ACTIVE"] = "CONSULTING_ACTIVE";
+  TaskEvent["CONSULT_END"] = "CONSULT_END";
+  TaskEvent["CONSULT_FAILED"] = "CONSULT_FAILED";
+  // Conference events
+  TaskEvent["MERGE_TO_CONFERENCE"] = "MERGE_TO_CONFERENCE";
+  TaskEvent["CONFERENCE_START"] = "CONFERENCE_START";
+  TaskEvent["CONFERENCE_FAILED"] = "CONFERENCE_FAILED";
+  TaskEvent["CONFERENCE_END"] = "CONFERENCE_END";
+  TaskEvent["TRANSFER_CONFERENCE"] = "TRANSFER_CONFERENCE";
+  TaskEvent["TRANSFER_CONFERENCE_SUCCESS"] = "TRANSFER_CONFERENCE_SUCCESS";
+  TaskEvent["TRANSFER_CONFERENCE_FAILED"] = "TRANSFER_CONFERENCE_FAILED";
+  TaskEvent["PARTICIPANT_LEAVE"] = "PARTICIPANT_LEAVE";
+  TaskEvent["EXIT_CONFERENCE"] = "EXIT_CONFERENCE";
+  TaskEvent["EXIT_CONFERENCE_SUCCESS"] = "EXIT_CONFERENCE_SUCCESS";
+  TaskEvent["EXIT_CONFERENCE_FAILED"] = "EXIT_CONFERENCE_FAILED";
+  // Recording events
+  TaskEvent["RECORDING_STARTED"] = "RECORDING_STARTED";
+  TaskEvent["PAUSE_RECORDING"] = "PAUSE_RECORDING";
+  TaskEvent["RESUME_RECORDING"] = "RESUME_RECORDING";
+  // Transfer events
+  TaskEvent["TRANSFER_SUCCESS"] = "TRANSFER_SUCCESS";
+  TaskEvent["TRANSFER_FAILED"] = "TRANSFER_FAILED";
+  // Wrapup events
+  TaskEvent["WRAPUP_COMPLETE"] = "WRAPUP_COMPLETE";
+  // End events
+  TaskEvent["TASK_WRAPUP"] = "TASK_WRAPUP";
+  TaskEvent["RONA"] = "RONA";
+  // Ring On No Answer
+  TaskEvent["CONTACT_ENDED"] = "CONTACT_ENDED";
+  // Failure events
+  TaskEvent["ASSIGN_FAILED"] = "ASSIGN_FAILED";
+  TaskEvent["INVITE_FAILED"] = "INVITE_FAILED";
+  TaskEvent["OUTBOUND_FAILED"] = "OUTBOUND_FAILED";
+  // Switch events (toggle between consult and main call)
+  TaskEvent["SWITCH_TO_MAIN_CALL"] = "SWITCH_TO_MAIN_CALL";
+  TaskEvent["SWITCH_TO_CONSULT"] = "SWITCH_TO_CONSULT";
+  // Accept/Decline (WebRTC)
+  TaskEvent["ACCEPT"] = "ACCEPT";
+  TaskEvent["DECLINE"] = "DECLINE";
+  TaskEvent["END"] = "END";
+  // Queue events
+  TaskEvent["CTQ_CANCEL"] = "CTQ_CANCEL";
+  // Cancel To Queue
+  TaskEvent["CTQ_CANCEL_FAILED"] = "CTQ_CANCEL_FAILED";
+  return TaskEvent;
+}({});
+//# sourceMappingURL=constants.js.map

package/dist/services/task/state-machine/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["MAX_PARTICIPANTS_IN_MULTIPARTY_CONFERENCE","exports","PARTICIPANT_TYPE","CUSTOMER","SUPERVISOR","VVA","MEDIA_TYPE_CONSULT","MEDIA_TYPE_MAIN_CALL","TaskState","TaskEvent"],"sources":["constants.ts"],"sourcesContent":["/**\n * Constants for the task state machine.\n * These enums define the allowed states, events, and built-in action identifiers.\n */\n\n// ============================================\n// Conference Constants\n// ============================================\n\n/**\n * Maximum number of participants allowed in a multi-party conference.\n * Max 7 counted agents + 1 customer.\n */\nexport const MAX_PARTICIPANTS_IN_MULTIPARTY_CONFERENCE = 7;\n\n// ============================================\n// Participant Type Constants\n// ============================================\n\n/** Participant types for conference filtering */\nexport const PARTICIPANT_TYPE = {\n  CUSTOMER: 'Customer',\n  SUPERVISOR: 'Supervisor',\n  VVA: 'VVA',\n} as const;\n\nexport type ParticipantType = (typeof PARTICIPANT_TYPE)[keyof typeof PARTICIPANT_TYPE];\n\n// ============================================\n// Media Type Constants\n// ============================================\n\n/** Media type for consult calls */\nexport const MEDIA_TYPE_CONSULT = 'consult';\n\n/** Media type for main calls */\nexport const MEDIA_TYPE_MAIN_CALL = 'mainCall';\n\n// ============================================\n// State Machine Enums\n// ============================================\n\nexport enum TaskState {\n  IDLE = 'IDLE',\n  OFFERED = 'OFFERED',\n  CONNECTED = 'CONNECTED',\n\n  // Intermediate states for async operations\n  HOLD_INITIATING = 'HOLD_INITIATING',\n  HELD = 'HELD',\n  RESUME_INITIATING = 'RESUME_INITIATING',\n  CONSULT_INITIATING = 'CONSULT_INITIATING',\n  CONSULTING = 'CONSULTING',\n  CONF_INITIATING = 'CONF_INITIATING',\n\n  CONFERENCING = 'CONFERENCING',\n  WRAPPING_UP = 'WRAPPING_UP',\n  COMPLETED = 'COMPLETED',\n  TERMINATED = 'TERMINATED',\n\n  // NOT IMPLEMENTED: MPC (Multi-Party Conference) states\n  CONSULT_INITIATED = 'CONSULT_INITIATED',\n  CONSULT_COMPLETED = 'CONSULT_COMPLETED',\n  // NOT IMPLEMENTED: Post-call state (isWxccPostCallEnabled feature flag)\n  POST_CALL = 'POST_CALL',\n  // NOT IMPLEMENTED: Parked state\n  PARKED = 'PARKED',\n  // NOT IMPLEMENTED: Monitoring/Supervisory states\n  MONITORING = 'MONITORING',\n}\n\nexport enum TaskEvent {\n  TASK_INCOMING = 'TASK_INCOMING',\n  TASK_OFFERED = 'TASK_OFFERED',\n\n  // Offer events\n  OFFER_CONSULT = 'OFFER_CONSULT',\n  HYDRATE = 'HYDRATE',\n\n  // Internal \"data refresh\" events\n  CONTACT_UPDATED = 'CONTACT_UPDATED',\n  CONTACT_OWNER_CHANGED = 'CONTACT_OWNER_CHANGED',\n\n  // Assignment events\n  ASSIGN = 'ASSIGN',\n\n  // Hold/Resume events\n  HOLD_SUCCESS = 'HOLD_SUCCESS',\n  HOLD_FAILED = 'HOLD_FAILED',\n  UNHOLD_SUCCESS = 'UNHOLD_SUCCESS',\n  UNHOLD_FAILED = 'UNHOLD_FAILED',\n  HOLD_INITIATED = 'HOLD_INITIATED',\n  UNHOLD_INITIATED = 'UNHOLD_INITIATED',\n\n  // Consult events\n  CONSULT = 'CONSULT',\n  CONSULT_SUCCESS = 'CONSULT_SUCCESS',\n  CONSULT_CREATED = 'CONSULT_CREATED',\n  CONSULTING_ACTIVE = 'CONSULTING_ACTIVE',\n  CONSULT_END = 'CONSULT_END',\n  CONSULT_FAILED = 'CONSULT_FAILED',\n\n  // Conference events\n  MERGE_TO_CONFERENCE = 'MERGE_TO_CONFERENCE',\n  CONFERENCE_START = 'CONFERENCE_START',\n  CONFERENCE_FAILED = 'CONFERENCE_FAILED',\n  CONFERENCE_END = 'CONFERENCE_END',\n  TRANSFER_CONFERENCE = 'TRANSFER_CONFERENCE',\n  TRANSFER_CONFERENCE_SUCCESS = 'TRANSFER_CONFERENCE_SUCCESS',\n  TRANSFER_CONFERENCE_FAILED = 'TRANSFER_CONFERENCE_FAILED',\n  PARTICIPANT_LEAVE = 'PARTICIPANT_LEAVE',\n  EXIT_CONFERENCE = 'EXIT_CONFERENCE',\n  EXIT_CONFERENCE_SUCCESS = 'EXIT_CONFERENCE_SUCCESS',\n  EXIT_CONFERENCE_FAILED = 'EXIT_CONFERENCE_FAILED',\n\n  // Recording events\n  RECORDING_STARTED = 'RECORDING_STARTED',\n  PAUSE_RECORDING = 'PAUSE_RECORDING',\n  RESUME_RECORDING = 'RESUME_RECORDING',\n\n  // Transfer events\n  TRANSFER_SUCCESS = 'TRANSFER_SUCCESS',\n  TRANSFER_FAILED = 'TRANSFER_FAILED',\n\n  // Wrapup events\n  WRAPUP_COMPLETE = 'WRAPUP_COMPLETE',\n\n  // End events\n  TASK_WRAPUP = 'TASK_WRAPUP',\n  RONA = 'RONA', // Ring On No Answer\n  CONTACT_ENDED = 'CONTACT_ENDED',\n\n  // Failure events\n  ASSIGN_FAILED = 'ASSIGN_FAILED',\n  INVITE_FAILED = 'INVITE_FAILED',\n  OUTBOUND_FAILED = 'OUTBOUND_FAILED',\n\n  // Switch events (toggle between consult and main call)\n  SWITCH_TO_MAIN_CALL = 'SWITCH_TO_MAIN_CALL',\n  SWITCH_TO_CONSULT = 'SWITCH_TO_CONSULT',\n\n  // Accept/Decline (WebRTC)\n  ACCEPT = 'ACCEPT',\n  DECLINE = 'DECLINE',\n  END = 'END',\n\n  // Queue events\n  CTQ_CANCEL = 'CTQ_CANCEL', // Cancel To Queue\n  CTQ_CANCEL_FAILED = 'CTQ_CANCEL_FAILED',\n}\n"],"mappings":";;;;;;AAAA;AACA;AACA;AACA;;AAEA;AACA;AACA;;AAEA;AACA;AACA;AACA;AACO,MAAMA,yCAAyC,GAAAC,OAAA,CAAAD,yCAAA,GAAG,CAAC;;AAE1D;AACA;AACA;;AAEA;AACO,MAAME,gBAAgB,GAAAD,OAAA,CAAAC,gBAAA,GAAG;EAC9BC,QAAQ,EAAE,UAAU;EACpBC,UAAU,EAAE,YAAY;EACxBC,GAAG,EAAE;AACP,CAAU;AAIV;AACA;AACA;;AAEA;AACO,MAAMC,kBAAkB,GAAAL,OAAA,CAAAK,kBAAA,GAAG,SAAS;;AAE3C;AACO,MAAMC,oBAAoB,GAAAN,OAAA,CAAAM,oBAAA,GAAG,UAAU;;AAE9C;AACA;AACA;AAAA,IAEYC,SAAS,GAAAP,OAAA,CAAAO,SAAA,0BAATA,SAAS;EAATA,SAAS;EAATA,SAAS;EAATA,SAAS;EAKnB;EALUA,SAAS;EAATA,SAAS;EAATA,SAAS;EAATA,SAAS;EAATA,SAAS;EAATA,SAAS;EAATA,SAAS;EAATA,SAAS;EAATA,SAAS;EAATA,SAAS;EAkBnB;EAlBUA,SAAS;EAATA,SAAS;EAqBnB;EArBUA,SAAS;EAuBnB;EAvBUA,SAAS;EAyBnB;EAzBUA,SAAS;EAAA,OAATA,SAAS;AAAA;AAAA,IA6BTC,SAAS,GAAAR,OAAA,CAAAQ,SAAA,0BAATA,SAAS;EAATA,SAAS;EAATA,SAAS;EAInB;EAJUA,SAAS;EAATA,SAAS;EAQnB;EARUA,SAAS;EAATA,SAAS;EAYnB;EAZUA,SAAS;EAenB;EAfUA,SAAS;EAATA,SAAS;EAATA,SAAS;EAATA,SAAS;EAATA,SAAS;EAATA,SAAS;EAuBnB;EAvBUA,SAAS;EAATA,SAAS;EAATA,SAAS;EAATA,SAAS;EAATA,SAAS;EAATA,SAAS;EA+BnB;EA/BUA,SAAS;EAATA,SAAS;EAATA,SAAS;EAATA,SAAS;EAATA,SAAS;EAATA,SAAS;EAATA,SAAS;EAATA,SAAS;EAATA,SAAS;EAATA,SAAS;EAATA,SAAS;EA4CnB;EA5CUA,SAAS;EAATA,SAAS;EAATA,SAAS;EAiDnB;EAjDUA,SAAS;EAATA,SAAS;EAqDnB;EArDUA,SAAS;EAwDnB;EAxDUA,SAAS;EAATA,SAAS;EA0DJ;EA1DLA,SAAS;EA6DnB;EA7DUA,SAAS;EAATA,SAAS;EAATA,SAAS;EAkEnB;EAlEUA,SAAS;EAATA,SAAS;EAsEnB;EAtEUA,SAAS;EAATA,SAAS;EAATA,SAAS;EA2EnB;EA3EUA,SAAS;EA4EQ;EA5EjBA,SAAS;EAAA,OAATA,SAAS;AAAA","ignoreList":[]}

package/dist/services/task/state-machine/guards.js

@@ -0,0 +1,256 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.shouldWrapUpForThisAgent = exports.isSelfConsultingAgent = exports.guards = exports.getTaskDataFromEvent = exports.getSelfAgentId = void 0;
+var _TaskUtils = require("../TaskUtils");
+var _constants = require("./constants");
+/**
+ * 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
+ */
+
+const getTaskDataFromEvent = event => event && typeof event === 'object' && 'taskData' in event ? event.taskData : undefined;
+exports.getTaskDataFromEvent = getTaskDataFromEvent;
+const getSelfAgentId = (context, taskData) => context.uiControlConfig?.agentId ?? context.taskData?.agentId ?? taskData?.agentId;
+exports.getSelfAgentId = getSelfAgentId;
+const isSelfConsultingAgent = (context, taskData) => {
+  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
+ */
+exports.isSelfConsultingAgent = isSelfConsultingAgent;
+const shouldWrapUpForThisAgent = (context, taskData) => {
+  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;
+};
+exports.shouldWrapUpForThisAgent = shouldWrapUpForThisAgent;
+const guards = exports.guards = {
+  // Hydrate Guards
+  isInteractionTerminated: ({
+    context,
+    event
+  }) => {
+    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
+  }) => {
+    const taskData = getTaskDataFromEvent(event);
+    return taskData?.interaction?.state === 'consulting';
+  },
+  isInteractionHeld: ({
+    event
+  }) => {
+    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
+  }) => {
+    const taskData = getTaskDataFromEvent(event);
+    return taskData?.interaction?.state === 'connected';
+  },
+  isConferencingByParticipants: ({
+    event
+  }) => {
+    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
+  }) => {
+    const taskData = getTaskDataFromEvent(event);
+    if (!taskData?.interaction) return false;
+    return (0, _TaskUtils.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
+  }) => {
+    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 = (0, _TaskUtils.getConferenceParticipantsCount)(taskData.interaction, mainCallId);
+    if (agentParticipantsCount >= 2) return false;
+    const customerInCall = (0, _TaskUtils.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
+  }) => {
+    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
+  }) => {
+    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
+  }) => {
+    const taskData = getTaskDataFromEvent(event);
+    if (!taskData) return false;
+    if (event?.type === _constants.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
+  }) => {
+    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
+  }) => {
+    const taskData = getTaskDataFromEvent(event);
+    const selfAgentId = getSelfAgentId(context, taskData);
+    if (!selfAgentId) return false;
+    const participantIdFromEvent = event && typeof event === 'object' && 'participantId' in event ? event.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
+  }) => {
+    const taskData = getTaskDataFromEvent(event);
+    if (!taskData) return false;
+    const mediaId = taskData.mediaResourceId;
+    if (!mediaId) return false;
+    return taskData.interaction?.media?.[mediaId]?.isHold === true;
+  }
+};
+//# sourceMappingURL=guards.js.map

package/dist/services/task/state-machine/guards.js.map

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

package/dist/services/task/state-machine/index.js

@@ -0,0 +1,53 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "TaskEvent", {
+  enumerable: true,
+  get: function () {
+    return _constants.TaskEvent;
+  }
+});
+Object.defineProperty(exports, "TaskState", {
+  enumerable: true,
+  get: function () {
+    return _constants.TaskState;
+  }
+});
+Object.defineProperty(exports, "actions", {
+  enumerable: true,
+  get: function () {
+    return _actions.actions;
+  }
+});
+Object.defineProperty(exports, "createInitialContext", {
+  enumerable: true,
+  get: function () {
+    return _actions.createInitialContext;
+  }
+});
+Object.defineProperty(exports, "createTaskStateMachine", {
+  enumerable: true,
+  get: function () {
+    return _TaskStateMachine.createTaskStateMachine;
+  }
+});
+Object.defineProperty(exports, "guards", {
+  enumerable: true,
+  get: function () {
+    return _guards.guards;
+  }
+});
+Object.defineProperty(exports, "isEventOfType", {
+  enumerable: true,
+  get: function () {
+    return _types.isEventOfType;
+  }
+});
+var _TaskStateMachine = require("./TaskStateMachine");
+var _constants = require("./constants");
+var _types = require("./types");
+var _guards = require("./guards");
+var _actions = require("./actions");
+//# sourceMappingURL=index.js.map

package/dist/services/task/state-machine/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_TaskStateMachine","require","_constants","_types","_guards","_actions"],"sources":["index.ts"],"sourcesContent":["/**\n * Task State Machine\n *\n * Export all state machine components for easy importing\n */\n\n// Main state machine\nexport {createTaskStateMachine} from './TaskStateMachine';\nexport type {TaskStateMachine} from './TaskStateMachine';\n\n// Types & enums\nexport {TaskState, TaskEvent} from './constants';\nexport {isEventOfType} from './types';\nexport type {\n  TaskContext,\n  TaskEventPayload,\n  TaskStateMachineConfig,\n  UIControlConfig,\n  TaskActionsMap,\n  TaskActionArgs,\n} from './types';\n\n// Guards\nexport {guards} from './guards';\nexport type {GuardParams, GuardFunction} from './guards';\n\n// Actions\nexport {actions, createInitialContext} from './actions';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAOA,IAAAA,iBAAA,GAAAC,OAAA;AAIA,IAAAC,UAAA,GAAAD,OAAA;AACA,IAAAE,MAAA,GAAAF,OAAA;AAWA,IAAAG,OAAA,GAAAH,OAAA;AAIA,IAAAI,QAAA,GAAAJ,OAAA","ignoreList":[]}

package/dist/services/task/state-machine/types.js

@@ -0,0 +1,54 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.isEventOfType = isEventOfType;
+var _constants = require("./constants");
+/**
+ * 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.
+ */
+
+/**
+ * Represents a participant in a conference call
+ */
+
+/**
+ * UI Control configuration for the task
+ */
+
+/**
+ * Task state machine context.
+ * Only stores data that cannot be derived from state machine state.
+ */
+
+/**
+ * Base event type - all events have a type property
+ */
+
+/**
+ * Event payload mapping - defines the payload for each event type
+ */
+
+/**
+ * Union of all possible event payloads
+ */
+
+/**
+ * Type guard to check event type
+ */
+function isEventOfType(event, type) {
+  return Boolean(event && event.type === type);
+}
+
+/**
+ * Recording control state for UI controls computer
+ */
+
+/**
+ * State machine configuration type
+ */
+//# sourceMappingURL=types.js.map

package/dist/services/task/state-machine/types.js.map

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