@unboundcx/sdk 4.13.101 → 4.13.103

package/README.md

@@ -370,6 +370,9 @@ const response = await api.ai.generative.chat({
   model: 'gpt-4',
   temperature: 0.7,
   method: 'openai',
+  // optional, telemetry-only attribution — never affects the prompt,
+  // session, caching, or response (contracts §9):
+  // usageContext: { feature: 'sentiment', taskId, sipCallId, queueId, cdrId }
 });
 
 // Text-to-Speech
@@ -377,6 +380,8 @@ const audio = await api.ai.tts.create({
   text: 'Hello, this is a test message',
   voice: 'en-US-Standard-A',
   audioEncoding: 'MP3',
+  // optional, telemetry-only attribution — never affects caching/output:
+  // taskId, sipCallId, botId
 });
 
 // Speech-to-Text - File/Storage Transcription

package/package.json

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

@@ -25,6 +25,9 @@ export class TextToSpeechService {
    * @param {number} [params.volumeGainDb]
    * @param {string[]} [params.effectsProfileIds]
    * @param {boolean} [params.createAccessKey]
+   * @param {string} [params.taskId] Telemetry-only attribution; never affects caching/output.
+   * @param {string} [params.sipCallId] Telemetry-only attribution; never affects caching/output.
+   * @param {string} [params.botId] Telemetry-only attribution; never affects caching/output.
    * @returns {Promise<Object>} `{ id, storageId, url? }`
    */
   async create({
@@ -38,6 +41,9 @@ export class TextToSpeechService {
     volumeGainDb,
     effectsProfileIds,
     createAccessKey,
+    taskId,
+    sipCallId,
+    botId,
   }) {
     this.sdk.validateParams(
       {
@@ -51,6 +57,9 @@ export class TextToSpeechService {
         volumeGainDb,
         effectsProfileIds,
         createAccessKey,
+        taskId,
+        sipCallId,
+        botId,
       },
       {
         text: { type: 'string', required: true },
@@ -63,6 +72,9 @@ export class TextToSpeechService {
         volumeGainDb: { type: 'number', required: false },
         effectsProfileIds: { type: 'array', required: false },
         createAccessKey: { type: 'boolean', required: false },
+        taskId: { type: 'string', required: false },
+        sipCallId: { type: 'string', required: false },
+        botId: { type: 'string', required: false },
       },
     );
 
@@ -76,6 +88,9 @@ export class TextToSpeechService {
     if (volumeGainDb) ttsData.volumeGainDb = volumeGainDb;
     if (effectsProfileIds) ttsData.effectsProfileIds = effectsProfileIds;
     if (createAccessKey) ttsData.createAccessKey = createAccessKey;
+    if (taskId !== undefined) ttsData.taskId = taskId;
+    if (sipCallId !== undefined) ttsData.sipCallId = sipCallId;
+    if (botId !== undefined) ttsData.botId = botId;
 
     const params = {
       body: ttsData,
@@ -112,25 +127,34 @@ export class TextToSpeechService {
    * @param {string} params.text
    * @param {string} [params.voice]
    * @param {string} [params.languageCode]
+   * @param {string} [params.taskId] Telemetry-only attribution; never affects caching/output.
+   * @param {string} [params.sipCallId] Telemetry-only attribution; never affects caching/output.
+   * @param {string} [params.botId] Telemetry-only attribution; never affects caching/output.
    * @returns {Promise<{body: ReadableStream, headers: Headers, status: number}>}
    * @example
    * const result = await sdk.ai.tts.stream({ text: 'Hi there', voice: 'hannah' });
    * const nodeStream = Readable.fromWeb(result.body);
    * nodeStream.pipe(ffmpegProcess.stdin);
    */
-  async stream({ text, voice, languageCode }) {
+  async stream({ text, voice, languageCode, taskId, sipCallId, botId }) {
     this.sdk.validateParams(
-      { text, voice, languageCode },
+      { text, voice, languageCode, taskId, sipCallId, botId },
       {
         text: { type: 'string', required: true },
         voice: { type: 'string', required: false },
         languageCode: { type: 'string', required: false },
+        taskId: { type: 'string', required: false },
+        sipCallId: { type: 'string', required: false },
+        botId: { type: 'string', required: false },
       },
     );
 
     const ttsData = { text };
     if (voice) ttsData.voice = voice;
     if (languageCode) ttsData.languageCode = languageCode;
+    if (taskId !== undefined) ttsData.taskId = taskId;
+    if (sipCallId !== undefined) ttsData.sipCallId = sipCallId;
+    if (botId !== undefined) ttsData.botId = botId;
 
     const params = {
       body: ttsData,

package/services/ai.js

@@ -85,6 +85,7 @@ export class GenerativeService {
     meta,
     qualityCheck,
     isPublic,
+    usageContext,
   }) {
     this.sdk.validateParams(
       {
@@ -112,6 +113,7 @@ export class GenerativeService {
         meta,
         qualityCheck,
         isPublic,
+        usageContext,
       },
       {
         prompt: { type: 'string', required: false },
@@ -138,6 +140,9 @@ export class GenerativeService {
         meta: { type: 'object', required: false },
         qualityCheck: { type: 'boolean', required: false },
         isPublic: { type: 'boolean', required: false },
+        // Telemetry-only (contracts §9): { feature?, taskId?, sipCallId?,
+        // queueId?, cdrId? } -- never affects the prompt/session/cache/response.
+        usageContext: { type: 'object', required: false },
       },
     );
 
@@ -168,6 +173,9 @@ export class GenerativeService {
         meta,
         qualityCheck,
         isPublic,
+        // Only included when the caller actually passed one -- keeps the
+        // wire payload identical to today for every existing caller.
+        ...(usageContext !== undefined ? { usageContext } : {}),
       },
       // Return raw response for streaming to allow client-side stream handling
       returnRawResponse: stream === true,