@unboundcx/sdk 4.13.99 → 4.13.101

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unboundcx/sdk",
-  "version": "4.13.99",
+  "version": "4.13.101",
   "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

@@ -46,6 +46,42 @@ export class CCService {
     return result;
   }
 
+  /**
+   * Queue-level human headcount by status -- same-queue-help-ping-plan.md
+   * WP1. The AI bot calls this to decide "hand to a human now" (someone
+   * available) vs "take a message" (nobody, or only wrap-up).
+   *
+   * @param {Object} options - Options
+   * @param {string} options.queueId - Queue ID
+   * @param {string} [options.taskId] - Task ID (forward-compat; unused today)
+   * @returns {Promise<Object>} result
+   * @returns {number} result.available - Workers currently `available`
+   * @returns {Object} result.byStatus - `{ available, wrapUp }` counts
+   *
+   * @example
+   * const { available, byStatus } = await sdk.taskRouter.cc.getHumanAvailability({ queueId: 'queue_789' });
+   */
+  async getHumanAvailability({ queueId, taskId } = {}) {
+    this.sdk.validateParams(
+      { queueId, taskId },
+      {
+        queueId: { type: 'string', required: true },
+        taskId: { type: 'string', required: false },
+      },
+    );
+
+    const params = { query: {} };
+    if (taskId !== undefined) params.query.taskId = taskId;
+
+    const result = await internalRequest(
+      this.sdk,
+      `/taskRouter/queues/${queueId}/human-availability`,
+      'GET',
+      params,
+    );
+    return result;
+  }
+
   /**
    * Get a live Contact Center snapshot (KPIs, per-queue summaries, team roster
    * with active tasks) scoped to a set of queues.

package/services/taskRouter/TaskService.js

@@ -443,9 +443,11 @@ export class TaskService {
    * Release a task back to the queue for a human (same queue, same task
    * id) — the bot-task-lifecycle release contract. Stamps
    * botEligible:false (when humanOnly) plus named release-reason
-   * metadata, and for a voice task in 'callback' mode hands the customer
-   * off to the existing queue-wait callback contract (hangs up, task goes
-   * pending, human accept later auto-dials the customer back).
+   * metadata and keeps the customer's original place in line. Voice:
+   * 'live' keeps the call on hold music for the next human; 'callback'
+   * ends the call and the task's primary channel becomes whatever is still
+   * live (e.g. sms) — the human who accepts follows up like on any task.
+   * This is not the queue-wait callback feature (no auto-dial).
    *
    * @param {Object} options - Parameters
    * @param {string} options.taskId - The task ID to release (required)