@unboundcx/sdk 4.13.56 → 4.13.58

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unboundcx/sdk",
-  "version": "4.13.56",
+  "version": "4.13.58",
   "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/ai/assist.js

@@ -14,7 +14,12 @@ export class AssistService {
    * @param {Object} options - Evaluate options
    * @param {string} options.taskId - Task ID
    * @param {Array} options.utterances - Utterances to evaluate
-   * @returns {Promise<Object>} Evaluation result
+   * @returns {Promise<Object>} Evaluation result. Beyond the existing fields, now includes:
+   *   @returns {string} result.coach - Agent-only guidance (may draw on internal + public KB, cards, playbook)
+   *   @returns {Array<{sourceId:string,title:string,visibility:'internal'|'public',knowledgeBaseId:string}>} result.citations
+   *   @returns {'ok'|'legacy'|'blocked:citation'|'blocked:overlap'|'blocked:dontSay'} result.guardResult
+   *   @returns {'legacy'|'split'} result.visibilityMode
+   *   @returns {string} result.reply - Insertable customer-facing text; empty when guardResult is blocked:*
    *
    * @example
    * const result = await sdk.ai.assist.evaluate({
@@ -44,7 +49,8 @@ export class AssistService {
    *
    * @param {Object} options - Options
    * @param {string} options.taskId - Task ID
-   * @returns {Promise<Object>} Last evaluation
+   * @returns {Promise<Object>} Last evaluation. Same shape as evaluate()'s result, including
+   *   coach, citations, guardResult, visibilityMode, reply (see evaluate() for field docs).
    *
    * @example
    * const last = await sdk.ai.assist.getLast({
@@ -63,6 +69,41 @@ export class AssistService {
     return result;
   }
 
+  /**
+   * List persisted AI Assist suggestions (assistSuggestions table), optionally scoped to a queue.
+   *
+   * @param {Object} [options] - Options
+   * @param {string} [options.queueId] - Filter by queue
+   * @param {number} [options.limit] - Max rows to return
+   * @returns {Promise<Object>} List of suggestion rows
+   *
+   * @example
+   * const { suggestions } = await sdk.ai.assist.listSuggestions({ queueId: 'queue_123', limit: 50 });
+   */
+  async listSuggestions({ queueId, limit } = {}) {
+    const result = await internalRequest(this.sdk, '/ai/assist/suggestions', 'GET', {
+      query: { queueId, limit },
+    });
+    return result;
+  }
+
+  /**
+   * Get aggregate stats for AI Assist suggestions (counts by guardResult, top blocked citations).
+   *
+   * @param {Object} [options] - Options
+   * @param {string} [options.queueId] - Filter by queue
+   * @returns {Promise<Object>} Stats { byGuardResult, topBlockedCitations, ... }
+   *
+   * @example
+   * const stats = await sdk.ai.assist.suggestionStats({ queueId: 'queue_123' });
+   */
+  async suggestionStats({ queueId } = {}) {
+    const result = await internalRequest(this.sdk, '/ai/assist/suggestions/stats', 'GET', {
+      query: { queueId },
+    });
+    return result;
+  }
+
   async listQueueKnowledgeBases({ queueId }) {
     this.sdk.validateParams(
       { queueId },

package/services/knowledgeBase.js

@@ -17,9 +17,11 @@ export class KnowledgeBaseService {
    * @param {string} [params.filters.sourceType] - Filter by source type (article, document, source)
    * @param {Array} [params.filters.tags] - Filter by tags
    * @param {boolean} [params.rerank] - Whether to apply LLM reranking (default: true)
+   * @param {'all'|'public'} [params.visibility] - Result visibility scope: 'all' (default) or 'public' only.
+   *   Each result's source now also includes isPublic, knowledgeBaseId, knowledgeBaseName.
    * @returns {Promise<Object>} Search results with source attribution
    */
-  async search({ query, knowledgeBaseId, limit, filters, rerank }) {
+  async search({ query, knowledgeBaseId, limit, filters, rerank, visibility }) {
     this.sdk.validateParams(
       { query },
       {
@@ -28,7 +30,7 @@ export class KnowledgeBaseService {
     );
 
     const params = {
-      body: { query, knowledgeBaseId, limit, filters, rerank },
+      body: { query, knowledgeBaseId, limit, filters, rerank, visibility },
     };
 
     const result = await internalRequest(this.sdk, 

package/services/taskRouter/WorkerService.js

@@ -385,11 +385,60 @@ export class WorkerService {
       params.body.userId = userId;
     }
 
-    const result = await internalRequest(this.sdk, 
+    const result = await internalRequest(this.sdk,
       '/taskRouter/worker/queueLogout',
       'PUT',
       params,
     );
     return result;
   }
+
+  /**
+   * Search for workers within a queue's scope
+   * Finds workers a caller can act on (transfer/invite/DM) for a given queue, with optional
+   * name/email/extension text search and skill-match flagging.
+   *
+   * @param {Object} options - Parameters
+   * @param {string} options.queueId - The queue ID to scope the search to (required)
+   * @param {string} [options.q] - Free-text filter matching name, email, or extension
+   * @param {string[]} [options.skills] - Skill IDs to flag matches for (joined as a comma-separated list)
+   * @param {number} [options.limit] - Max rows to return (default 50, max 200)
+   * @returns {Promise<Object>} Object containing the matching worker rows
+   * @returns {Array<Object>} result.rows - Worker rows with status/capacity/skills info
+   * @returns {number} result.total - Total matching rows
+   *
+   * @example
+   * const { rows, total } = await sdk.taskRouter.worker.search({ queueId: 'queue123', q: 'sam' });
+   * console.log(rows.length, total);
+   */
+  async search(options = {}) {
+    const { queueId, q, skills, limit } = options;
+
+    this.sdk.validateParams(
+      { queueId, q, skills, limit },
+      {
+        queueId: { type: 'string', required: true },
+        q: { type: 'string', required: false },
+        skills: { type: 'array', required: false },
+        limit: { type: 'number', required: false },
+      },
+    );
+
+    const query = { queueId };
+
+    if (q) {
+      query.q = q;
+    }
+
+    if (skills && skills.length) {
+      query.skills = skills.join(',');
+    }
+
+    if (limit) {
+      query.limit = limit;
+    }
+
+    const result = await internalRequest(this.sdk, '/taskRouter/workers/search', 'GET', { query });
+    return result;
+  }
 }