@unboundcx/sdk 4.13.55 → 4.13.57

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unboundcx/sdk",
-  "version": "4.13.55",
+  "version": "4.13.57",
   "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/OfferService.js

@@ -0,0 +1,71 @@
+import { internalRequest } from '../../base.js';
+
+/**
+ * Offer Service - accept/decline a direct offer (transfer/invite/help) routed to a user
+ */
+export class OfferService {
+  constructor(sdk) {
+    this.sdk = sdk;
+  }
+
+  /**
+   * Accept a pending direct offer.
+   * Creates/reuses the caller's worker session as needed and assigns the task to them.
+   *
+   * @param {Object} options - Options
+   * @param {string} options.offerId - Offer ID
+   * @returns {Promise<Object>} { taskId, workerId, isVoice }
+   *
+   * @example
+   * const result = await sdk.taskRouter.offer.accept({ offerId: 'offer_123' });
+   */
+  async accept({ offerId }) {
+    this.sdk.validateParams(
+      { offerId },
+      {
+        offerId: { type: 'string', required: true },
+      },
+    );
+
+    const params = {
+      body: { offerId },
+    };
+
+    const result = await internalRequest(this.sdk,
+      '/taskRouter/offers/accept',
+      'PUT',
+      params,
+    );
+    return result;
+  }
+
+  /**
+   * Decline a pending direct offer.
+   *
+   * @param {Object} options - Options
+   * @param {string} options.offerId - Offer ID
+   * @returns {Promise<Object>} { offerId }
+   *
+   * @example
+   * const result = await sdk.taskRouter.offer.decline({ offerId: 'offer_123' });
+   */
+  async decline({ offerId }) {
+    this.sdk.validateParams(
+      { offerId },
+      {
+        offerId: { type: 'string', required: true },
+      },
+    );
+
+    const params = {
+      body: { offerId },
+    };
+
+    const result = await internalRequest(this.sdk,
+      '/taskRouter/offers/decline',
+      'PUT',
+      params,
+    );
+    return result;
+  }
+}

package/services/taskRouter/TaskRouterService.js

@@ -2,6 +2,7 @@ import { WorkerService } from './WorkerService.js';
 import { TaskService } from './TaskService.js';
 import { MetricsService } from './MetricsService.js';
 import { CCService } from './CCService.js';
+import { OfferService } from './OfferService.js';
 
 export class TaskRouterService {
   constructor(sdk) {
@@ -10,5 +11,6 @@ export class TaskRouterService {
     this.task = new TaskService(sdk);
     this.metrics = new MetricsService(sdk);
     this.cc = new CCService(sdk);
+    this.offer = new OfferService(sdk);
   }
 }