@unboundcx/sdk 4.13.56 → 4.13.57

package/package.json

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