solver-sdk 3.1.5 → 3.1.8

package/README.md

@@ -1,4 +1,4 @@
-# Code Solver SDK v3.1.3
+# Code Solver SDK v3.1.8
 
 > **JavaScript/TypeScript SDK для VS Code Extensions**  
 > Подключение к AI бэкенду для индексации, поиска и работы с кодом
@@ -12,6 +12,56 @@ JavaScript/TypeScript SDK для работы с Code Solver API. Предост
 - **📊 Project Indexing** - индексация и анализ проектов
 - **📝 Context API** - получение контекста для AI
 - **🛠️ Code Modification** - модификация кода через AI
+- **🔇 Настраиваемое логирование** - полный контроль над выводом в консоль
+
+## 🔄 Последние обновления v3.1.8
+
+### 🚨 КРИТИЧЕСКОЕ ИСПРАВЛЕНИЕ: onEvent callback данные
+- **Проблема решена**: onEvent callback теперь получает **оригинальные события Anthropic API**
+- **Исправлено**: `content_block_start` содержит полный `content_block` объект с правильными `id`, `name`, `input`
+- **Исправлено**: `input_json_delta` передается как `delta.type: 'input_json_delta'` вместо обычного text
+- **Убрано**: Лишние поля `projectId`, `timestamp` которые нарушали стандарт Anthropic
+- **Результат**: Полная совместимость с Anthropic API стандартом для tool_use событий
+
+### 🔧 Что было исправлено:
+```javascript
+// ❌ БЫЛО (v3.1.7): onEvent получал обработанные данные
+onEvent: (type, data) => {
+  // data содержал: { projectId, timestamp, content_block: null }
+}
+
+// ✅ СТАЛО (v3.1.8): onEvent получает оригинальные данные
+onEvent: (type, data) => {
+  // data содержит стандартные Anthropic события:
+  // content_block_start: { type, index, content_block: { type: 'tool_use', id, name, input } }
+  // content_block_delta: { type, index, delta: { type: 'input_json_delta', partial_json } }
+}
+```
+
+### v3.1.7 (предыдущие обновления)
+
+### 🚨 ИСПРАВЛЕНО: Избыточное логирование в консоли
+- **Проблема решена**: SDK больше не создает спам в Developer Console VS Code
+- **Новые уровни логирования**: `'silent' | 'error' | 'warn' | 'info' | 'debug'`
+- **Детальный контроль потоков**: Настройка логирования SSE событий, chunk'ов и callbacks
+- **Обратная совместимость**: Старые опции `debug: true/false/'verbose'` работают как раньше
+
+### v3.1.6 (предыдущие обновления)
+
+- **🔧 КРИТИЧЕСКОЕ ИСПРАВЛЕНИЕ**: Восстановлена передача `content_block_start` событий для `tool_use` блоков
+- **✅ Tool Continuation**: Исправлена поддержка tool continuation функциональности
+- **🛠️ Новые события**: Добавлена обработка `input_json_delta`, `signature_delta` для инструментов
+- **📊 Улучшенная обработка**: Корректная обработка всех типов content блоков (thinking, text, tool_use)
+- **🔒 Валидация**: Исправлена валидация `tool_choice` согласно документации Anthropic
+
+### v3.1.5 (предыдущие улучшения)
+- **✅ Исправлена критическая проблема `toJSON`** - решена ошибка сериализации в VS Code IPC
+- **🆕 Новые API методы**: `getIndexingStatus()`, `getProjectInfo()` для безопасной работы  
+- **🔧 Безопасная сериализация**: Все Date объекты автоматически преобразуются в ISO строки
+- **🧠 Thinking API**: Полная поддержка мышления Claude с real-time выводом
+- **📊 Real-time данные**: Приоритет live данных над статическими из БД
+
+> **Для разработчиков инструментов**: v3.1.6 восстанавливает корректную работу tool continuation!
 
 ## 📦 Установка
 
@@ -19,14 +69,81 @@ JavaScript/TypeScript SDK для работы с Code Solver API. Предост
 npm install solver-sdk
 ```
 
+## 🔇 Настройка логирования (v3.1.7+)
+
+SDK предлагает гибкую систему логирования для контроля вывода в консоль:
+
+### 📊 Уровни логирования
+```javascript
+const sdk = await CodeSolverSDK.create({
+  baseURL: 'http://localhost:3000',
+  
+  // Уровни логирования (от тихого к подробному):
+  debug: 'silent', // Полное отключение (даже ошибки)
+  debug: 'error',  // Только ошибки (рекомендуется для VS Code)  
+  debug: 'warn',   // Предупреждения и ошибки
+  debug: 'info',   // Базовая информация
+  debug: 'debug',  // Подробная отладка
+  
+  // Обратная совместимость:
+  debug: false,     // Отключено
+  debug: true,      // Базовое логирование
+  debug: 'verbose'  // Подробное (аналог 'debug')
+});
+```
+
+### 🎛️ Детальный контроль потоков
+```javascript
+const sdk = await CodeSolverSDK.create({
+  baseURL: 'http://localhost:3000',
+  debug: 'debug', // или любой уровень
+  
+  // Точная настройка логирования потоков:
+  streamLogging: {
+    sseEvents: false,     // SSE события (content_block_start/delta/stop)
+    streamChunks: false,  // Chunk'и потока (каждый кусок текста)
+    eventCallbacks: false,// onEvent callback'и
+    importantOnly: true   // Только важные события (start, stop, errors)
+  }
+});
+```
+
+### 🎯 Рекомендуемые настройки
+```javascript
+// 🔹 VS Code Extension (production):
+debug: 'error'
+
+// 🔹 Development:
+debug: 'info'
+
+// 🔹 Deep debugging:
+debug: 'debug',
+streamLogging: { sseEvents: true, streamChunks: true }
+
+// 🔹 Полная тишина:
+debug: 'silent'
+```
+
 ## 🚀 Быстрый старт
 
 ```javascript
 import { CodeSolverSDK } from 'solver-sdk';
 
-// Создание SDK
+// Создание SDK с чистой консолью (рекомендуется для VS Code)
 const sdk = await CodeSolverSDK.create({
-  baseURL: 'http://localhost:3000'
+  baseURL: 'http://localhost:3000',
+  debug: 'error' // Только ошибки, никакого спама
+});
+
+// Или с детальным логированием для отладки
+const debugSdk = await CodeSolverSDK.create({
+  baseURL: 'http://localhost:3000',
+  debug: 'debug',
+  streamLogging: {
+    sseEvents: true,     // Логировать SSE события
+    streamChunks: true,  // Логировать chunk'и потока
+    eventCallbacks: true // Логировать onEvent callbacks
+  }
 });
 
 // Создание и индексация проекта
@@ -53,64 +170,155 @@ const functions = await sdk.search.searchFunctions(project.id, {
 const response = await sdk.chat.chat([
   { role: 'user', content: 'Объясни этот код' }
 ], { projectId: project.id });
+
+// Потоковый чат с thinking (мышлением)
+for await (const chunk of sdk.chat.streamChat([
+  { role: 'user', content: 'Объясни рекурсию пошагово' }
+], { 
+  projectId: project.id,
+  thinking: {
+    type: 'enabled',
+    budget_tokens: 5000
+  },
+  onEvent: (type, data) => {
+    if (type === 'content_block_delta' && data.delta?.type === 'thinking_delta') {
+      console.log(`🧠 Думает: ${data.delta.thinking}`);
+    } else if (type === 'content_block_delta' && data.delta?.type === 'text_delta') {
+      console.log(`💬 Отвечает: ${data.delta.text}`);
+    }
+  }
+})) {
+  if (chunk.text) {
+    process.stdout.write(chunk.text);
+  }
+}
 ```
 
 ## 📋 API Методы
 
 ### 📁 Projects API
 ```javascript
-// Создание проекта
-await sdk.projects.createProject({
-  name: 'Project Name',
-  path: '/project/path',
-  description: 'Description'
-  });
+// Создание проекта (исправленная сигнатура)
+await sdk.projects.createProject(
+  'Project Name',           // name
+  '/project/path',          // path
+  { description: 'Desc' }   // data (опционально)
+);
   
 // Получение списка проектов  
 await sdk.projects.getProjects();
 
 // Получение информации о проекте
 await sdk.projects.getProject(projectId);
+
+// Получение готовых проектов
+await sdk.projects.getReadyProjects();
 ```
 
 ### 🔄 Projects & Indexing API
 ```javascript
 // Создание/поиск проекта и запуск индексации
 const project = await sdk.projects.findOrCreateProject('/path/to/project', 'Project Name');
-await sdk.projects.startIndexing(project.id);
+await sdk.projects.startIndexing(project.id, { force: false }); // options опционально
 
-// Получение статуса индексации
-const status = await sdk.projects.getProjectStatus(project.id);
+// Получение real-time статуса индексации
+const indexingStatus = await sdk.projects.getIndexingStatus(project.id);
+console.log('Статус:', indexingStatus.status, 'Прогресс:', indexingStatus.progress + '%');
+
+// Получение общей информации о проекте  
+const projectInfo = await sdk.projects.getProjectInfo(project.id);
 
 // Ожидание завершения индексации
 while (true) {
-  const status = await sdk.projects.getProjectStatus(project.id);
-  if (status.status === 'ready') break;
-  if (status.status === 'error') throw new Error('Ошибка индексации');
+  const status = await sdk.projects.getIndexingStatus(project.id);
+  console.log(`Прогресс: ${status.progress}%, Файлы: ${status.processedFiles}/${status.totalFiles}`);
+  
+  if (status.status === 'complete') break;
+  if (status.status === 'failed') throw new Error('Ошибка индексации: ' + status.error);
+  
   await new Promise(resolve => setTimeout(resolve, 2000));
 }
 ```
 
 ### 🔍 Search API
 ```javascript
-// Поиск кода
+// Поиск кода (гибкая сигнатура)
+// Способ 1: projectId отдельно
 await sdk.search.searchCode(projectId, {
   query: 'search query',
   limit: 20
 });
+
+// Способ 2: projectId в параметрах
+await sdk.search.searchCode({
+  projectId: projectId,
+  query: 'search query',
+  limit: 20
+});
+
+// Поиск функций (гибкая сигнатура)
+// Способ 1: projectId отдельно
+const functions = await sdk.search.searchFunctions(projectId, {
+  query: 'calculateSum',
+  limit: 10
+});
+
+// Способ 2: projectId в параметрах
+const functions = await sdk.search.searchFunctions({
+  projectId: projectId,
+  query: 'calculateSum',
+  limit: 10
+});
+
+// Статистика функций в проекте
+const stats = await sdk.search.getFunctionStats(projectId);
+console.log(`Всего функций: ${stats.stats.totalFunctions}`);
 ```
 
 ### 💬 Chat API
 ```javascript
-// Обычный чат (projectId ОБЯЗАТЕЛЕН!)
+// Обычный чат (projectId опционален в реализации, но рекомендуется)
 const response = await sdk.chat.chat([
   { role: 'user', content: 'Объясни этот код' }
-], { projectId: 'your-project-id' });
+], { projectId: 'your-project-id' }); // projectId опционален
 
 // Потоковый чат
 for await (const chunk of sdk.chat.streamChat(messages, { projectId: 'your-project-id' })) {
   console.log(chunk.text);
 }
+
+// 🧠 Chat с thinking (мышлением Claude)
+const response = await sdk.chat.chat([
+  { role: 'user', content: 'Объясни рекурсию подробно' }
+], { 
+  projectId: 'your-project-id',
+  thinking: {
+    type: 'enabled',
+    budget_tokens: 5000  // Бюджет для мышления
+  }
+});
+
+// 🧠 Потоковый чат с thinking и real-time выводом
+for await (const chunk of sdk.chat.streamChat([
+  { role: 'user', content: 'Проанализируй архитектуру проекта' }
+], {
+  projectId: 'your-project-id',
+  thinking: {
+    type: 'enabled',
+    budget_tokens: 8000
+  },
+  onEvent: (type, data) => {
+    if (type === 'content_block_delta' && data.delta?.type === 'thinking_delta') {
+      console.log(`🧠 Думает: ${data.delta.thinking}`);
+    } else if (type === 'content_block_delta' && data.delta?.type === 'text_delta') {
+      console.log(`💬 Отвечает: ${data.delta.text}`);
+    }
+  }
+})) {
+  if (chunk.text) {
+    process.stdout.write(chunk.text);
+  }
+}
 ```
 
 ## ⚙️ Конфигурация
@@ -124,12 +332,12 @@ const sdk = await CodeSolverSDK.create({
 });
 ```
 
-**⚠️ Важно**: Для Chat API **обязательно** нужен `projectId`:
+**⚠️ Важно**: Для Chat API `projectId` **рекомендуется**, но не обязателен в реализации:
 ```javascript
-// ❌ НЕ РАБОТАЕТ
+// ✅ РАБОТАЕТ (но без контекста проекта)
 const response = await sdk.chat.chat(messages);
 
-// ✅ ПРАВИЛЬНО  
+// ✅ РЕКОМЕНДУЕТСЯ (с контекстом проекта)
 const response = await sdk.chat.chat(messages, { projectId: 'your-project-id' });
 
 // 💡 Получить projectId можно так:
@@ -179,9 +387,9 @@ async function fullWorkflow() {
     // 3. Ждем завершения индексации
     console.log('Ожидание завершения индексации...');
     while (true) {
-      const status = await sdk.projects.getProjectStatus(project.id);
-      if (status.status === 'ready') break;
-      if (status.status === 'error') throw new Error('Ошибка индексации');
+      const status = await sdk.projects.getIndexingStatus(project.id);
+      if (status.status === 'complete') break;
+      if (status.status === 'failed') throw new Error('Ошибка индексации: ' + status.error);
       await new Promise(resolve => setTimeout(resolve, 2000));
     }
 
@@ -200,7 +408,7 @@ async function fullWorkflow() {
     ], { projectId: project.id });
     
     console.log('✅ Анализ завершен');
-    console.log('📊 Компоненты:', components.length);
+    console.log('📊 Компоненты:', components.results.length);
     console.log('🤖 AI анализ:', aiResponse.content);
 
   } catch (error) {
@@ -213,6 +421,19 @@ fullWorkflow();
 
 ## 🔧 Устранение неполадок
 
+### ✅ Исправлена проблема toJSON (v3.1.5)
+```javascript
+// ❌ СТАРАЯ ОШИБКА (до v3.1.5):
+// CodeExpectedError: Method not found: toJSON
+
+// ✅ РЕШЕНИЕ: Обновите SDK до v3.1.5+
+npm install solver-sdk@latest
+
+// ✅ Теперь все API возвращают JSON-совместимые объекты
+const status = await sdk.projects.getIndexingStatus(projectId);
+// Все Date объекты автоматически преобразуются в ISO строки
+```
+
 ### Проблемы с подключением
 ```javascript
 // Проверка здоровья API
@@ -229,43 +450,10 @@ const sdk = await CodeSolverSDK.create({
 });
 ```
 
-## 📝 Changelog v3.1.3
-
-### ✅ Добавлено
-- Поиск функций через `/search/functions` API
-- Методы `searchFunctions()` и `searchFunctionsGet()`
-- Статистика функций `getFunctionStats()`
-- Автоматический выбор модели и токенов на бэкенде
-- Упрощенные Chat API без параметров модели
-
-### ❌ Удалено
-- `AgentsApi` - больше не используется
-- `DependenciesApi` - работает внутренне
-- `simple-indexing-client.ts` - дублировал ProjectsApi
-- Все устаревшие методы и примеры
-- Ручной выбор модели и лимитов токенов клиентом
-- **Папка docs/** - удалена вся неактуальная документация
-
-### 🔄 Изменено
-- Обновлены все примеры кода на актуальный синтаксис
-- Упрощена документация в один файл
-- Исправлены пути API с префиксом `/api/v1`
-- Улучшена обработка ошибок индексации
-- Chat API упрощен - модель выбирается автоматически
-- Полная синхронизация документации с реальным кодом
-- **Один README.md** содержит всю необходимую информацию
-
 ## 📄 Лицензия
 
 MIT License
 
-**Q: Пустые результаты поиска**
-```javascript
-// Убедитесь что проект проиндексирован
-const readyProjects = await sdk.projects.getReadyProjects();
-console.log('Готовые проекты:', readyProjects);
-```
-
 ## 🔧 Индексация: полный workflow
 
 ```javascript
@@ -282,12 +470,12 @@ async function indexProject(projectPath, projectName) {
   
   // 3. Мониторинг прогресса
   while (true) {
-    const status = await sdk.projects.getProjectStatus(project.id);
+    const status = await sdk.projects.getIndexingStatus(project.id);
     
-    if (status.status === 'ready') {
+    if (status.status === 'complete') {
       console.log('✅ Индексация завершена!');
       break;
-    } else if (status.status === 'error') {
+    } else if (status.status === 'failed') {
       console.log('❌ Ошибка:', status.error);
       break;
     }
@@ -327,8 +515,8 @@ export async function activate(context: vscode.ExtensionContext) {
       await sdk.projects.startIndexing(project.id);
       
       while (true) {
-        const status = await sdk.projects.getProjectStatus(project.id);
-        if (status.status === 'ready') break;
+        const status = await sdk.projects.getIndexingStatus(project.id);
+        if (status.status === 'complete') break;
         progress.report({ message: `${status.progress || 0}%` });
         await new Promise(resolve => setTimeout(resolve, 2000));
       }
@@ -385,7 +573,7 @@ export async function activate(context: vscode.ExtensionContext) {
       { "command": "extension.searchFunctions", "title": "🔍 Поиск функций" }
     ]
   },
-  "dependencies": { "solver-sdk": "^3.1.3" }
+  "dependencies": { "solver-sdk": "^3.1.5" }
 }
 ```
 

package/dist/cjs/api/chat-api/index.js

@@ -30,9 +30,53 @@ class ChatApi {
     /**
      * Создает новый экземпляр API для работы с чатом
      * @param {IHttpClient} httpClient HTTP клиент
+     * @param {ChatApiOptions} options Опции логирования (опционально)
      */
-    constructor(httpClient) {
+    constructor(httpClient, options = {}) {
         this.httpClient = httpClient;
+        /** Logger для ChatApi с настраиваемыми уровнями */
+        this.logger = {
+            streamEvent: (message, data) => {
+                const debugLevel = this.options.debug;
+                const streamLogging = this.options.streamLogging;
+                if (debugLevel === 'silent')
+                    return;
+                if (streamLogging?.sseEvents || (debugLevel === 'verbose' || debugLevel === 'debug')) {
+                    console.log(`🔍 [SDK] SSE Event: ${message}`, data);
+                }
+            },
+            streamChunk: (message, data) => {
+                const debugLevel = this.options.debug;
+                const streamLogging = this.options.streamLogging;
+                if (debugLevel === 'silent')
+                    return;
+                if (streamLogging?.streamChunks || (debugLevel === 'verbose' || debugLevel === 'debug')) {
+                    console.log(`🔍 [CHAT-API] Получен chunk: ${message}`, data);
+                }
+            },
+            eventCallback: (message, data) => {
+                const debugLevel = this.options.debug;
+                const streamLogging = this.options.streamLogging;
+                if (debugLevel === 'silent')
+                    return;
+                if (streamLogging?.eventCallbacks || (debugLevel === 'verbose' || debugLevel === 'debug')) {
+                    console.log(`📞 [CHAT-API] Вызываем onEvent: ${message}`, data);
+                }
+            },
+            info: (message) => {
+                const debugLevel = this.options.debug;
+                if (debugLevel && debugLevel !== 'silent' && debugLevel !== 'error' && debugLevel !== 'warn') {
+                    console.log(`🔧 [SDK] ${message}`);
+                }
+            },
+            error: (message) => {
+                const debugLevel = this.options.debug;
+                if (debugLevel !== 'silent') {
+                    console.error(`❌ [SDK] ${message}`);
+                }
+            }
+        };
+        this.options = options;
     }
     /**
      * Отправляет сообщение в чат и получает ответ от модели
@@ -183,18 +227,16 @@ class ChatApi {
         // Валидация параметров
         this.validateChatOptions(options);
         try {
-            // Формируем эндпоинт для стриминга
-            const endpoint = '/api/v1/chat/stream';
             // Создаем параметры запроса
             const params = this.buildRequestParams(messages, {
                 ...options,
                 stream: true
             });
-            // Генерируем socketId если нужен для thinking
-            if (options?.thinking && !options?.socketId) {
-                options.socketId = generateId(10);
-                params.socketId = options.socketId;
-            }
+            // ✅ УПРОЩЕНО: Всегда используем /stream с автоматическим выполнением инструментов
+            const endpoint = '/api/v1/chat/stream';
+            this.logger.info(`Используем эндпоинт: ${endpoint} (всегда с auto-execution)`);
+            // ИСПРАВЛЕНИЕ: socketId больше не используется для HTTP SSE
+            // В HTTP потоках thinking работает напрямую без WebSocket socketId
             // ИСПРАВЛЕНИЕ: Используем postStream вместо общего request метода
             const response = await this.httpClient.postStream(endpoint, params);
             // ИСПРАВЛЕНИЕ: Простой подход - обрабатываем как текст с Node.js stream
@@ -225,6 +267,21 @@ class ChatApi {
                     const lines = buffer.split('\n');
                     buffer = lines.pop() || ''; // Сохраняем неполную строку
                     for (const line of lines) {
+                        // 📝 ОТЛАДКА: Логируем все SSE события через новый логгер
+                        if (line.startsWith('data: ') && line.slice(6).trim() !== '[DONE]') {
+                            try {
+                                const eventData = JSON.parse(line.slice(6).trim());
+                                this.logger.streamEvent(eventData.type, {
+                                    type: eventData.type,
+                                    delta: eventData.delta,
+                                    content_block: eventData.content_block,
+                                    index: eventData.index
+                                });
+                            }
+                            catch (e) {
+                                this.logger.streamEvent(`Raw SSE line: ${line}`);
+                            }
+                        }
                         // ✅ КРИТИЧЕСКОЕ ИСПРАВЛЕНИЕ: Используем processStreamChunk
                         const result = (0, stream_utils_1.processStreamChunk)(line, isInThinkingBlock, thinkingContent, textContent, thinkingSignature, options?.onToken);
                         // Обновляем состояние
@@ -234,6 +291,12 @@ class ChatApi {
                         thinkingSignature = result.thinkingSignature;
                         // Если есть чанк для отправки
                         if (result.chunk) {
+                            this.logger.streamChunk('', {
+                                type: result.chunk.type,
+                                isThinking: result.chunk.isThinking,
+                                text: typeof result.chunk.text === 'string' ? result.chunk.text.substring(0, 30) : result.chunk.text,
+                                hasOnEvent: !!options?.onEvent
+                            });
                             // НОВОЕ: Обработка VS Code команд
                             if (result.chunk.type === 'vscode_command' && options?.onVSCodeCommand) {
                                 try {
@@ -257,9 +320,29 @@ class ChatApi {
                                 continue;
                             }
                             yield result.chunk;
-                            // Вызываем onEvent callback если передан
-                            if (options && options.onEvent) {
-                                options.onEvent(result.chunk.type, result.chunk);
+                            // 🔧 КРИТИЧЕСКОЕ ИСПРАВЛЕНИЕ: Передаем оригинальные данные события в onEvent
+                            if (options && options.onEvent && line.startsWith('data: ') && line.slice(6).trim() !== '[DONE]') {
+                                try {
+                                    const originalEventData = JSON.parse(line.slice(6).trim());
+                                    this.logger.eventCallback('Передаем оригинальные данные события', {
+                                        eventType: originalEventData.type,
+                                        hasContentBlock: !!originalEventData.content_block,
+                                        hasDelta: !!originalEventData.delta
+                                    });
+                                    // ✅ ИСПРАВЛЕНО: передаем оригинальные данные вместо обработанного chunk
+                                    options.onEvent(originalEventData.type, {
+                                        data: originalEventData
+                                    });
+                                }
+                                catch (e) {
+                                    // Fallback: если не удалось распарсить, используем обработанный chunk
+                                    this.logger.eventCallback('Fallback к chunk данным', {
+                                        eventType: result.chunk.type,
+                                        isThinking: result.chunk.isThinking,
+                                        hasText: !!result.chunk.text
+                                    });
+                                    options.onEvent(result.chunk.type, result.chunk);
+                                }
                             }
                         }
                         // Проверяем завершение
@@ -303,11 +386,20 @@ class ChatApi {
     validateChatOptions(options) {
         if (!options)
             return;
-        // Валидация thinking + tools
+        // ✅ ИСПРАВЛЕНИЕ: Валидация thinking + tools согласно документации Anthropic
         if (options.thinking && options.tools && options.tool_choice) {
             const choice = options.tool_choice;
-            if (typeof choice === 'object' && choice.type !== 'auto' && choice.type !== 'none') {
-                throw new Error('При использовании thinking с инструментами поддерживаются только tool_choice: { type: "auto" } или { type: "none" }');
+            if (typeof choice === 'object' && choice.type === 'any') {
+                // ✅ Только { type: "any" } поддерживается с thinking
+            }
+            else if (typeof choice === 'object' && choice.type === 'none') {
+                // ✅ { type: "none" } также поддерживается
+            }
+            else if (typeof choice === 'object' && choice.type === 'auto') {
+                // ✅ { type: "auto" } тоже поддерживается  
+            }
+            else {
+                throw new Error('При использовании thinking с инструментами поддерживаются только tool_choice: { type: "any" }, { type: "auto" } или { type: "none" }. НЕ поддерживаются: { type: "tool", name: "..." }');
             }
         }
         // Валидация temperature с thinking