playkit-sdk 1.4.0-beta.2 → 1.4.0-beta.3

package/dist/playkit-sdk.d.ts

@@ -586,6 +586,13 @@ interface ChatConfig {
             name: string;
         };
     };
+    /** Reasoning effort for thinking-capable models */
+    thinking?: {
+        /** Whether thinking is enabled */
+        enabled?: boolean;
+        /** Reasoning effort level */
+        effort?: 'minimal' | 'low' | 'medium' | 'high' | 'max';
+    };
 }
 /**
  * Configuration for streaming text generation
@@ -593,6 +600,8 @@ interface ChatConfig {
 interface ChatStreamConfig extends ChatConfig {
     /** Callback for each chunk of text */
     onChunk: (chunk: string) => void;
+    /** Callback for each chunk of reasoning (thinking) text */
+    onReasoning?: (chunk: string) => void;
     /** Callback when generation is complete */
     onComplete?: (fullText: string) => void;
     /** Callback for errors during streaming */
@@ -620,6 +629,8 @@ interface ChatResult {
     created?: number;
     /** Tool calls made by the model */
     tool_calls?: ToolCall[];
+    /** Model's reasoning (thinking) content, present only when the model produced thinking */
+    reasoning?: string;
 }
 /**
  * Configuration for structured output generation
@@ -646,7 +657,9 @@ interface ChatCompletionResponse {
     model: string;
     choices: Array<{
         index: number;
-        message: Message;
+        message: Message & {
+            reasoning_content?: string;
+        };
         finish_reason: string;
     }>;
     usage?: {
@@ -659,7 +672,7 @@ interface ChatCompletionResponse {
  * Streaming chunk formats
  */
 interface StreamChunk {
-    type: 'text-delta' | 'done' | 'finish' | 'abort' | 'error';
+    type: 'text-delta' | 'reasoning-delta' | 'reasoning-start' | 'reasoning-end' | 'done' | 'finish' | 'abort' | 'error';
     id?: string;
     delta?: string;
     error?: string;
@@ -1741,6 +1754,7 @@ interface ChatWithToolsConfig extends ChatConfig {
  */
 interface ChatWithToolsStreamConfig extends ChatWithToolsConfig {
     onChunk: (chunk: string) => void;
+    onReasoning?: (chunk: string) => void;
     onComplete?: (result: ChatResult) => void;
     onError?: (error: Error) => void;
 }
@@ -3000,24 +3014,35 @@ declare class AuthFlowManager extends EventEmitter {
  * Server-Sent Events (SSE) stream parser
  * Handles parsing of streaming text responses
  */
+/**
+ * A parsed part of the stream — either generated text or reasoning (thinking) text.
+ */
+interface StreamPart {
+    kind: 'text' | 'reasoning';
+    delta: string;
+}
 declare class StreamParser {
     /**
      * Parse SSE stream using ReadableStream
+     * Yields typed parts so callers can separate text from reasoning.
      */
-    static parseStream(reader: ReadableStreamDefaultReader<Uint8Array>): AsyncGenerator<string, void, unknown>;
+    static parseStream(reader: ReadableStreamDefaultReader<Uint8Array>): AsyncGenerator<StreamPart, void, unknown>;
     /**
-     * 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.
      */
-    private static extractTextFromChunk;
+    private static extractPartFromChunk;
     /**
      * Collect all chunks from a stream
      */
     static collectFullText(reader: ReadableStreamDefaultReader<Uint8Array>): Promise<string>;
     /**
      * Stream with callbacks
+     * Text deltas go to onChunk; reasoning (thinking) deltas go to onReasoning.
      */
-    static streamWithCallbacks(reader: ReadableStreamDefaultReader<Uint8Array>, onChunk: (chunk: string) => void, onComplete?: (fullText: string) => void, onError?: (error: Error) => void): Promise<void>;
+    static streamWithCallbacks(reader: ReadableStreamDefaultReader<Uint8Array>, onChunk: (chunk: string) => void, onComplete?: (fullText: string) => void, onError?: (error: Error) => void, onReasoning?: (chunk: string) => void): Promise<void>;
 }
 
 /**

package/dist/playkit-sdk.esm.js

@@ -1,5 +1,5 @@
 /**
- * playkit-sdk v1.4.0-beta.2
+ * playkit-sdk v1.4.0-beta.3
  * PlayKit SDK for JavaScript
  * @license SEE LICENSE IN LICENSE
  */
@@ -826,7 +826,7 @@ class TokenStorage {
 }
 
 const SDK_TYPE = 'Javascript';
-const SDK_VERSION = '"1.4.0-beta.2"';
+const SDK_VERSION = '"1.4.0-beta.3"';
 function getSDKHeaders() {
     return {
         'X-SDK-Type': SDK_TYPE,
@@ -3926,6 +3926,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',
@@ -3983,6 +3986,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',
@@ -4047,6 +4053,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',
@@ -4105,6 +4114,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',
@@ -4652,6 +4664,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() {
@@ -4682,9 +4695,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) {
@@ -4701,7 +4714,7 @@ class StreamParser {
                             }
                             catch (error) {
                                 // If JSON parse fails, treat as plain text
-                                yield yield __await(data);
+                                yield yield __await({ kind: 'text', delta: data });
                             }
                         }
                     }
@@ -4713,22 +4726,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;
     }
@@ -4742,8 +4766,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 }; }
@@ -4757,8 +4783,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 {
@@ -4766,9 +4793,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 }; }
@@ -4869,6 +4902,7 @@ class ChatClient {
                 : undefined,
             id: response.id,
             created: response.created,
+            reasoning: choice.message.reasoning_content,
         };
     }
     /**
@@ -4877,7 +4911,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 =====
     /**
@@ -5035,6 +5069,7 @@ class ChatClient {
             id: response.id,
             created: response.created,
             tool_calls: choice.message.tool_calls,
+            reasoning: choice.message.reasoning_content,
         };
     }
     /**
@@ -5045,6 +5080,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;
@@ -5057,9 +5093,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);
+        });
     }
 }