@unboundcx/sdk 4.13.61 → 4.13.63

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unboundcx/sdk",
-  "version": "4.13.61",
+  "version": "4.13.63",
   "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/knowledgeBase.js

@@ -173,6 +173,81 @@ export class KnowledgeBaseService {
     return result;
   }
 
+  /**
+   * List version snapshots for a KB article, newest first
+   *
+   * @param {Object} params
+   * @param {string} params.id - Article ID
+   * @returns {Promise<Object>} { results: [{ id, version, createdAt, createdBy, contentLength, preview }] }
+   */
+  async listArticleVersions({ id }) {
+    this.sdk.validateParams(
+      { id },
+      {
+        id: { type: 'string', required: true },
+      },
+    );
+
+    const result = await internalRequest(
+      this.sdk,
+      `/knowledgeBase/articles/${id}/versions`,
+      'GET',
+    );
+    return result;
+  }
+
+  /**
+   * Get one full version snapshot (with content) for a KB article
+   *
+   * @param {Object} params
+   * @param {string} params.id - Article ID
+   * @param {string} params.versionId - Version snapshot ID
+   * @returns {Promise<Object>} Full version row including content
+   */
+  async getArticleVersion({ id, versionId }) {
+    this.sdk.validateParams(
+      { id, versionId },
+      {
+        id: { type: 'string', required: true },
+        versionId: { type: 'string', required: true },
+      },
+    );
+
+    const result = await internalRequest(
+      this.sdk,
+      `/knowledgeBase/articles/${id}/versions/${versionId}`,
+      'GET',
+    );
+    return result;
+  }
+
+  /**
+   * Restore a KB article's content to a prior version snapshot.
+   * Snapshots the article's current content as a new version before
+   * overwriting it, then reprocesses if the article is published.
+   *
+   * @param {Object} params
+   * @param {string} params.id - Article ID
+   * @param {string} params.versionId - Version snapshot ID to restore
+   * @returns {Promise<Object>} Updated article record
+   */
+  async restoreArticleVersion({ id, versionId }) {
+    this.sdk.validateParams(
+      { id, versionId },
+      {
+        id: { type: 'string', required: true },
+        versionId: { type: 'string', required: true },
+      },
+    );
+
+    const result = await internalRequest(
+      this.sdk,
+      `/knowledgeBase/articles/${id}/versions/${versionId}/restore`,
+      'POST',
+    );
+    return result;
+  }
+
   /**
    * Get analytics for a knowledge base
    *

package/services/taskRouter/ParticipantService.js

@@ -211,28 +211,38 @@ export class ParticipantService {
   }
 
   /**
-   * Swap task ownership between the current owner and a joined helper.
+   * Swap task ownership between the current owner and a joined helper. When
+   * the helper has no access to the task's queue, this chains: it creates a
+   * new task in the helper's queue and makes them its owner. If `queueId` is
+   * omitted and the helper has access to more than one queue, the server
+   * responds 409 with `{ needsQueue: true, queues }` — retry with a chosen
+   * `queueId`.
    *
    * @param {Object} options - Options
    * @param {string} options.taskId - Task ID
    * @param {string} options.participantId - The helper participant taking/giving control
    * @param {string} options.action - 'give' | 'take'
-   * @returns {Promise<Object>} { taskId, workerId }
+   * @param {string} [options.queueId] - Target queue for a cross-queue control chain (only relevant when the helper lacks access to the task's own queue)
+   * @returns {Promise<Object>} { taskId, workerId } for a same-queue swap; { taskId, newTaskId, workerId } for a cross-queue chain
    *
    * @example
    * await sdk.taskRouter.participants.control({ taskId: 'task_123', participantId: 'tp_456', action: 'give' });
+   * @example
+   * await sdk.taskRouter.participants.control({ taskId: 'task_123', participantId: 'tp_456', action: 'take', queueId: 'queue_789' });
    */
-  async control({ taskId, participantId, action }) {
+  async control({ taskId, participantId, action, queueId }) {
     this.sdk.validateParams(
-      { taskId, participantId, action },
+      { taskId, participantId, action, queueId },
       {
         taskId: { type: 'string', required: true },
         participantId: { type: 'string', required: true },
         action: { type: 'string', required: true },
+        queueId: { type: 'string', required: false },
       },
     );
 
     const params = { body: { action } };
+    if (queueId !== undefined) params.body.queueId = queueId;
 
     return await internalRequest(
       this.sdk,