playkit-sdk 1.4.0-beta.2 → 1.4.0

package/README.md

@@ -68,6 +68,33 @@ await chat.chatStream(
 );
 ```
 
+### Reasoning (Thinking)
+
+Reasoning-capable models can think before answering. Enable it with the
+`thinking` option (set the `effort` level) and read the model's reasoning
+separately from its answer.
+
+```typescript
+// Non-streaming: reasoning is returned on `result.reasoning`
+const result = await chat.textGeneration({
+  messages: [{ role: 'user', content: 'Solve: 17 * 24, show your work.' }],
+  thinking: { effort: 'high' },
+});
+
+console.log('Answer:', result.content);
+console.log('Reasoning:', result.reasoning);
+
+// Streaming: reasoning arrives via the `onReasoning` callback,
+// kept separate from the answer text in `onChunk`
+await chat.textGenerationStream({
+  messages: [{ role: 'user', content: 'Solve: 17 * 24, show your work.' }],
+  thinking: { effort: 'high' },
+  onReasoning: (chunk) => process.stdout.write(`[thinking] ${chunk}`),
+  onChunk: (chunk) => process.stdout.write(chunk),
+  onComplete: (fullText) => console.log('\nComplete:', fullText),
+});
+```
+
 ### Image Generation
 
 ```typescript
@@ -256,6 +283,11 @@ This SDK is proprietary software owned by Agentland Lab. Use of this SDK is subj
 
 ## Changelog
 
+### 1.4.0
+- Added text-to-speech (TTS) client
+- Added `thinking` reasoning-effort option on chat (`thinking: { effort: 'high' }`)
+- Surface model reasoning: `result.reasoning` (non-streaming) and the `onReasoning` callback (streaming)
+
 ### 1.0.0-beta.1
 - Initial public beta release
 - AI chat support (text generation)

package/dist/playkit-sdk.cjs.js

@@ -1,5 +1,5 @@
 /**
- * playkit-sdk v1.4.0-beta.2
+ * playkit-sdk v1.4.0
  * PlayKit SDK for JavaScript
  * @license SEE LICENSE IN LICENSE
  */
@@ -830,7 +830,7 @@ class TokenStorage {
 }
 
 const SDK_TYPE = 'Javascript';
-const SDK_VERSION = '"1.4.0-beta.2"';
+const SDK_VERSION = '"1.4.0"';
 function getSDKHeaders() {
     return {
         'X-SDK-Type': SDK_TYPE,
@@ -3930,6 +3930,9 @@ class ChatProvider {
             stop: chatConfig.stop || null,
             top_p: chatConfig.topP || null,
         };
+        if (chatConfig.thinking) {
+            requestBody.thinking = chatConfig.thinking;
+        }
         try {
             const response = await fetch(`${this.baseURL}${endpoint}`, {
                 method: 'POST',
@@ -3987,6 +3990,9 @@ class ChatProvider {
             stop: chatConfig.stop || null,
             top_p: chatConfig.topP || null,
         };
+        if (chatConfig.thinking) {
+            requestBody.thinking = chatConfig.thinking;
+        }
         try {
             const response = await fetch(`${this.baseURL}${endpoint}`, {
                 method: 'POST',
@@ -4051,6 +4057,9 @@ class ChatProvider {
         if (chatConfig.tool_choice) {
             requestBody.tool_choice = chatConfig.tool_choice;
         }
+        if (chatConfig.thinking) {
+            requestBody.thinking = chatConfig.thinking;
+        }
         try {
             const response = await fetch(`${this.baseURL}${endpoint}`, {
                 method: 'POST',
@@ -4109,6 +4118,9 @@ class ChatProvider {
         if (chatConfig.tool_choice) {
             requestBody.tool_choice = chatConfig.tool_choice;
         }
+        if (chatConfig.thinking) {
+            requestBody.thinking = chatConfig.thinking;
+        }
         try {
             const response = await fetch(`${this.baseURL}${endpoint}`, {
                 method: 'POST',
@@ -4656,6 +4668,7 @@ function createDecoder() {
 class StreamParser {
     /**
      * Parse SSE stream using ReadableStream
+     * Yields typed parts so callers can separate text from reasoning.
      */
     static parseStream(reader) {
         return __asyncGenerator(this, arguments, function* parseStream_1() {
@@ -4686,9 +4699,9 @@ class StreamParser {
                             const data = trimmed.substring(6); // Remove 'data: ' prefix
                             try {
                                 const parsed = JSON.parse(data);
-                                const text = this.extractTextFromChunk(parsed);
-                                if (text) {
-                                    yield yield __await(text);
+                                const part = this.extractPartFromChunk(parsed);
+                                if (part) {
+                                    yield yield __await(part);
                                 }
                                 // Stream termination events
                                 if (parsed.type === 'done' || parsed.type === 'finish' || parsed.finish_reason) {
@@ -4705,7 +4718,7 @@ class StreamParser {
                             }
                             catch (error) {
                                 // If JSON parse fails, treat as plain text
-                                yield yield __await(data);
+                                yield yield __await({ kind: 'text', delta: data });
                             }
                         }
                     }
@@ -4717,22 +4730,33 @@ class StreamParser {
         });
     }
     /**
-     * Extract text from a stream chunk
-     * Supports multiple formats (UI Message Stream and OpenAI)
+     * Extract a typed part (text or reasoning) from a stream chunk
+     * Supports multiple formats (UI Message Stream and OpenAI).
+     * Reasoning is detected before the generic text fallback so thinking
+     * deltas never leak into the text stream.
      */
-    static extractTextFromChunk(chunk) {
-        var _a, _b;
-        // UI Message Stream format: { type: "text-delta", delta: "..." }
+    static extractPartFromChunk(chunk) {
+        var _a, _b, _c, _d;
+        // UI Message Stream reasoning: { type: "reasoning-delta", delta: "..." }
+        if (chunk.type === 'reasoning-delta' && chunk.delta) {
+            return { kind: 'reasoning', delta: chunk.delta };
+        }
+        // UI Message Stream text: { type: "text-delta", delta: "..." }
         if (chunk.type === 'text-delta' && chunk.delta) {
-            return chunk.delta;
+            return { kind: 'text', delta: chunk.delta };
         }
-        // OpenAI format: { choices: [{ delta: { content: "..." } }] }
-        if (chunk.choices && ((_b = (_a = chunk.choices[0]) === null || _a === void 0 ? void 0 : _a.delta) === null || _b === void 0 ? void 0 : _b.content)) {
-            return chunk.choices[0].delta.content;
+        // OpenAI reasoning (defensive): { choices: [{ delta: { reasoning_content: "..." } }] }
+        if (chunk.choices && ((_b = (_a = chunk.choices[0]) === null || _a === void 0 ? void 0 : _a.delta) === null || _b === void 0 ? void 0 : _b.reasoning_content)) {
+            return { kind: 'reasoning', delta: chunk.choices[0].delta.reasoning_content };
         }
-        // Direct delta format
+        // OpenAI text: { choices: [{ delta: { content: "..." } }] }
+        if (chunk.choices && ((_d = (_c = chunk.choices[0]) === null || _c === void 0 ? void 0 : _c.delta) === null || _d === void 0 ? void 0 : _d.content)) {
+            return { kind: 'text', delta: chunk.choices[0].delta.content };
+        }
+        // Direct delta format (text)
         if (chunk.delta) {
-            return typeof chunk.delta === 'string' ? chunk.delta : chunk.delta.content || null;
+            const text = typeof chunk.delta === 'string' ? chunk.delta : chunk.delta.content || null;
+            return text ? { kind: 'text', delta: text } : null;
         }
         return null;
     }
@@ -4746,8 +4770,10 @@ class StreamParser {
             for (var _d = true, _e = __asyncValues(this.parseStream(reader)), _f; _f = await _e.next(), _a = _f.done, !_a; _d = true) {
                 _c = _f.value;
                 _d = false;
-                const chunk = _c;
-                fullText += chunk;
+                const part = _c;
+                if (part.kind === 'text') {
+                    fullText += part.delta;
+                }
             }
         }
         catch (e_1_1) { e_1 = { error: e_1_1 }; }
@@ -4761,8 +4787,9 @@ class StreamParser {
     }
     /**
      * Stream with callbacks
+     * Text deltas go to onChunk; reasoning (thinking) deltas go to onReasoning.
      */
-    static async streamWithCallbacks(reader, onChunk, onComplete, onError) {
+    static async streamWithCallbacks(reader, onChunk, onComplete, onError, onReasoning) {
         var _a, e_2, _b, _c;
         let fullText = '';
         try {
@@ -4770,9 +4797,15 @@ class StreamParser {
                 for (var _d = true, _e = __asyncValues(this.parseStream(reader)), _f; _f = await _e.next(), _a = _f.done, !_a; _d = true) {
                     _c = _f.value;
                     _d = false;
-                    const chunk = _c;
-                    fullText += chunk;
-                    onChunk(chunk);
+                    const part = _c;
+                    if (part.kind === 'reasoning') {
+                        if (onReasoning) {
+                            onReasoning(part.delta);
+                        }
+                        continue;
+                    }
+                    fullText += part.delta;
+                    onChunk(part.delta);
                 }
             }
             catch (e_2_1) { e_2 = { error: e_2_1 }; }
@@ -4873,6 +4906,7 @@ class ChatClient {
                 : undefined,
             id: response.id,
             created: response.created,
+            reasoning: choice.message.reasoning_content,
         };
     }
     /**
@@ -4881,7 +4915,7 @@ class ChatClient {
     async textGenerationStream(config) {
         const chatConfig = Object.assign(Object.assign({}, config), { model: config.model || this.model });
         const reader = await this.provider.chatCompletionStream(chatConfig);
-        await StreamParser.streamWithCallbacks(reader, config.onChunk, config.onComplete, config.onError);
+        await StreamParser.streamWithCallbacks(reader, config.onChunk, config.onComplete, config.onError, config.onReasoning);
     }
     // ===== Structured Output Generation =====
     /**
@@ -5039,6 +5073,7 @@ class ChatClient {
             id: response.id,
             created: response.created,
             tool_calls: choice.message.tool_calls,
+            reasoning: choice.message.reasoning_content,
         };
     }
     /**
@@ -5049,6 +5084,7 @@ class ChatClient {
         const chatConfig = Object.assign(Object.assign({}, config), { model: config.model || this.model });
         const reader = await this.provider.chatCompletionWithToolsStream(chatConfig);
         let fullContent = '';
+        let fullReasoning = '';
         let toolCalls = [];
         await StreamParser.streamWithCallbacks(reader, (chunk) => {
             fullContent += chunk;
@@ -5061,9 +5097,14 @@ class ChatClient {
                     model: chatConfig.model || this.model,
                     finishReason: toolCalls.length > 0 ? 'tool_calls' : 'stop',
                     tool_calls: toolCalls.length > 0 ? toolCalls : undefined,
+                    reasoning: fullReasoning || undefined,
                 });
             }
-        }, config.onError);
+        }, config.onError, (chunk) => {
+            var _a;
+            fullReasoning += chunk;
+            (_a = config.onReasoning) === null || _a === void 0 ? void 0 : _a.call(config, chunk);
+        });
     }
 }