@unboundcx/sdk 4.13.45 → 4.13.48

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unboundcx/sdk",
-  "version": "4.13.45",
+  "version": "4.13.48",
   "description": "Official JavaScript SDK for the Unbound API - A comprehensive toolkit for integrating with Unbound's communication, AI, and data management services",
   "main": "index.js",
   "type": "module",

package/services/taskRouter/CCService.js

@@ -300,4 +300,29 @@ export class CCService {
     );
     return result;
   }
+
+  /**
+   * Recover a worker stuck out of routing (ghost Redis capacity, leftover
+   * lock, expired wrap-up). Self or manager. Does not force offline.
+   *
+   * @param {Object} options
+   * @param {string} options.workerId
+   * @returns {Promise<Object>}
+   */
+  async unlockWorker(options = {}) {
+    const { workerId } = options;
+
+    this.sdk.validateParams(
+      { workerId },
+      { workerId: { type: 'string', required: true } },
+    );
+
+    const result = await internalRequest(
+      this.sdk,
+      `/taskRouter/cc/workers/${workerId}/unlock`,
+      'POST',
+      {},
+    );
+    return result;
+  }
 }

package/services/taskRouter/TaskService.js

@@ -880,6 +880,65 @@ export class TaskService {
     );
   }
 
+  /**
+   * Mark a task's inbound messages as read for one channel (or all).
+   * Channel ids: sms | webchat | email | whatsApp | rcs | all.
+   * Clearing SMS also clears whatsApp/rcs until those get their own
+   * timeline threads (`channel` may also be the group name `sms`).
+   *
+   * @param {Object} options
+   * @param {string} options.taskId
+   * @param {string} [options.channel='all']
+   * @returns {Promise<{taskId:string, unreadByChannel:object, unreadTotal:number}>}
+   */
+  async markChannelRead(options = {}) {
+    const { taskId, channel } = options;
+
+    this.sdk.validateParams(
+      { taskId, channel },
+      {
+        taskId: { type: 'string', required: true },
+        channel: { type: 'string', required: false },
+      },
+    );
+
+    const params = { body: { taskId } };
+    if (channel !== undefined) params.body.channel = channel;
+
+    return await internalRequest(
+      this.sdk,
+      '/taskRouter/tasks/unread/read',
+      'PUT',
+      params,
+    );
+  }
+
+  /**
+   * Read a task's live channel mix -- whether it has an open text
+   * conversation, a live webchat session, or an active call, and whether
+   * it's currently eligible to be parked (`canPark`). Used to show/hide
+   * Park and webchat "End chat" without polling (task-park-webchat-endchat
+   * decisions, 2026-09-04).
+   *
+   * @param {Object} options
+   * @param {string} options.taskId
+   * @returns {Promise<{channelState:{hasOpenText:boolean, webchatLive:boolean, callLive:boolean, canPark:boolean}}>}
+   */
+  async channelState(options = {}) {
+    const { taskId } = options;
+
+    this.sdk.validateParams(
+      { taskId },
+      { taskId: { type: 'string', required: true } },
+    );
+
+    return await internalRequest(
+      this.sdk,
+      `/taskRouter/tasks/${taskId}/channelState`,
+      'GET',
+    );
+  }
+
   /**
    * Transfer a task to a different queue and/or worker. Passing queueId
    * moves the task back to 'pending' status for re-distribution.

package/services/webchat.js

@@ -243,6 +243,32 @@ export class WebchatConversationsService {
       'GET',
     );
   }
+
+  /**
+   * Agent-initiated "End chat" -- ends the webchat session only (same
+   * completeConversation() path as visitor end / idle timeout, reason
+   * 'agentEnded'). Only offered client-side when another channel (open
+   * text conversation or a live call) is still open on the task; the task
+   * itself keeps running (task-park-webchat-endchat-plan.md R2).
+   * @param {string} widgetId
+   * @param {string} engagementSessionId
+   * @returns {Promise<Object>}
+   */
+  async end(widgetId, engagementSessionId) {
+    this.sdk.validateParams(
+      { widgetId, engagementSessionId },
+      {
+        widgetId: { type: 'string', required: true },
+        engagementSessionId: { type: 'string', required: true },
+      },
+    );
+
+    return internalRequest(
+      this.sdk,
+      `/webchat/widgets/${widgetId}/conversations/${engagementSessionId}/end`,
+      'POST',
+    );
+  }
 }
 
 export class WebchatService {