solver-sdk 1.8.1 → 1.9.0

package/docs/WEBSOCKET.md

@@ -1,64 +1,46 @@
-# Работа с WebSocket соединениями
+# Работа с WebSocket в Solver SDK
 
-В этом разделе описаны основные методы для работы с WebSocket соединениями.
+Эта документация описывает, как использовать WebSocket соединения через Solver SDK для работы в реальном времени.
 
-## Получение WebSocket клиента
+## Инициализация SDK
 
 ```javascript
 const { CodeSolverSDK } = require('solver-sdk');
 
+// Создаем экземпляр SDK с настройками
 const sdk = new CodeSolverSDK({
   baseURL: 'https://api.example.com',
-  apiKey: 'your-api-key',
-  websocket: {
-    reconnect: true,
-    reconnectAttempts: 5,
-    reconnectDelay: 3000,
-    rejectUnauthorized: true // false для самоподписанных сертификатов
-  }
+  apiKey: 'your-api-key'
 });
-
-// Получение WebSocket клиента
-const wsClient = sdk.getWebSocketClient();
-
-// Подключение к namespace рассуждений
-await wsClient.connectToReasoning();
-
-// Подключение к namespace индексации
-await wsClient.connectToIndexing();
-
-// Проверка статуса подключения
-const isConnected = wsClient.isConnected(WebSocketNamespace.REASONING);
-
-// Отключение от определенного namespace
-await wsClient.disconnect(WebSocketNamespace.REASONING);
-
-// Отключение от всех namespace
-await wsClient.disconnectAll();
 ```
 
-## Мониторинг индексации проектов
+## Работа с рассуждениями (Reasoning)
+
+### Создание рассуждения и получение результатов в реальном времени
 
 ```javascript
-// Подключение к WebSocket для проектов
-await sdk.projects.connectWebSocket();
+// Создание рассуждения
+const reasoning = await sdk.reasoning.createReasoning({
+  projectId: 'project-id',
+  query: 'Объясни этот проект'
+});
 
-// Отслеживание прогресса индексации
-sdk.projects.on('indexing_progress', (data) => {
-  console.log(`Прогресс индексации: ${data.progress}%`);
-  console.log(`Обработано файлов: ${data.processedFiles} из ${data.totalFiles}`);
+// Подключение к WebSocket
+await sdk.reasoning.connectWebSocket(reasoning.id);
+
+// Подписка на события
+sdk.reasoning.on('thinking', (data) => {
+  console.log('Мышление:', data.content);
 });
 
-// Завершение индексации
-sdk.projects.on('indexing_complete', (data) => {
-  console.log('Индексация завершена!', data.success ? 'Успешно' : 'С ошибками');
-  
+sdk.reasoning.on('complete', (data) => {
+  console.log('Результат:', data.content);
   // Отключение после завершения
-  sdk.projects.disconnectWebSocket();
+  sdk.reasoning.disconnectWebSocket();
 });
 
-// Остановка индексации
-await sdk.projects.stopIndexing(projectId);
+// Запуск рассуждения
+await sdk.reasoning.startReasoning(reasoning.id);
 ```
 
 ## Потоковый чат с мышлением AI
@@ -69,7 +51,7 @@ const handleEvent = (eventType, data) => {
   if (eventType === 'thinking_delta' && data.thinking) {
     console.log('Мышление:', data.thinking);
   } else if (eventType === 'text_delta' && data.text) {
-    process.stdout.write(data.text); // Вывод текста без переноса строки
+    process.stdout.write(data.text);
   } else if (eventType === 'message_stop') {
     console.log('\nОтвет завершен');
   }
@@ -86,106 +68,36 @@ const options = {
   temperature: 0.7
 };
 
+// Отправка с потоковым получением ответа
 const response = await sdk.chat.streamChatWithThinking(
   messages, 
   options,
   handleEvent
 );
-
-console.log(`Socket ID: ${response.socketId}`);
 ```
 
-## Работа с рассуждениями через WebSocket
+## Мониторинг индексации проектов
 
 ```javascript
-// Создание рассуждения
-const reasoning = await sdk.reasoning.createReasoning({
-  projectId: 'project-id',
-  query: 'Объясни этот проект'
-});
-
-// Подключение к WebSocket для рассуждений
-await sdk.reasoning.connectWebSocket(reasoning.id);
-
-// Подписка на события
-sdk.reasoning.on('thinking', (data) => {
-  console.log('Мышление:', data.content);
-});
-
-sdk.reasoning.on('complete', (data) => {
-  console.log('Результат:', data.content);
-  // Отключение после завершения
-  sdk.reasoning.disconnectWebSocket();
-});
-
-// Запуск рассуждения
-await sdk.reasoning.startReasoning(reasoning.id);
-```
-
-## Настройка параметров WebSocket
+// Подключение к WebSocket для проектов
+await sdk.projects.connectWebSocket();
 
-```javascript
-// Настройка параметров WebSocket при создании SDK
-const sdk = new CodeSolverSDK({
-  baseURL: 'https://api.example.com',
-  apiKey: 'your-api-key',
-  websocket: {
-    reconnect: true,                // Автоматическое переподключение
-    reconnectAttempts: 5,           // Максимальное количество попыток
-    reconnectDelay: 3000,           // Задержка между попытками (мс)
-    rejectUnauthorized: true,       // Проверка SSL-сертификатов
-    reconnectStrategy: 'exponential', // Стратегия задержки между попытками
-    enableAutoPing: true,           // Автоматический ping/pong
-    pingInterval: 25000,            // Интервал ping в мс
-    enableSessionPersistence: true  // Сохранение сессии
-  }
+// Отслеживание прогресса индексации
+sdk.projects.on('indexing_progress', (data) => {
+  console.log(`Прогресс индексации: ${data.progress}%`);
+  console.log(`Обработано файлов: ${data.processedFiles} из ${data.totalFiles}`);
 });
-```
-
-## Обработка ошибок в WebSocket
 
-```javascript
-try {
-  await sdk.projects.connectWebSocket();
+// Завершение индексации
+sdk.projects.on('indexing_complete', (data) => {
+  console.log('Индексация завершена!', data.success ? 'Успешно' : 'С ошибками');
   
-  // Подписка на события ошибок
-  sdk.projects.on('error', (error) => {
-    console.error('Ошибка WebSocket:', error.message);
-    if (error.type === 'connection_error') {
-      console.error('Проблема с подключением');
-    } else if (error.type === 'authentication_error') {
-      console.error('Ошибка аутентификации');
-    }
-  });
-} catch (error) {
-  console.error('Ошибка при подключении:', error.message);
-}
-```
-
-## Модули с поддержкой WebSocket
-
-### Чат и рассуждения
-
-```javascript
-// Подключение WebSocket для чата
-await sdk.chat.connectWebSocket();
-
-// Подписка на события
-sdk.chat.on('message_start', (data) => {
-  console.log('Начало сообщения:', data);
-});
-
-sdk.chat.on('content_block_delta', (data) => {
-  if (data.delta?.type === 'thinking_delta') {
-    console.log('Фрагмент мышления:', data.delta.thinking);
-  }
+  // Отключение после завершения
+  sdk.projects.disconnectWebSocket();
 });
-
-// Отключение 
-await sdk.chat.disconnectWebSocket();
 ```
 
-### Зависимости
+## Работа с зависимостями
 
 ```javascript
 // Подключение к пространству имен зависимостей
@@ -200,68 +112,6 @@ sdk.dependencies.on('dependency_update', (data) => {
 await sdk.dependencies.disconnectWebSocket();
 ```
 
-### Проекты и индексация
-
-```javascript
-// Подключение к пространству имен проектов
-await sdk.projects.connectWebSocket();
-
-// Подписка на события индексации
-sdk.projects.on('indexing_progress', (data) => {
-  console.log('Прогресс индексации:', data.progress);
-});
-
-// Отключение
-await sdk.projects.disconnectWebSocket();
-```
-
-## Поддерживаемые события
-
-Основные события, на которые можно подписаться:
-
-| Событие | Описание | Примечание |
-|---------|----------|------------|
-| `message_start` | Начало сообщения | { id, model, type } |
-| `content_block_start` | Начало блока контента | { content_block: { type }, index } |
-| `content_block_delta` | Дельта блока контента | См. документацию для типов дельт |
-| `content_block_stop` | Конец блока контента | { content_block: { type }, index } |
-| `message_stop` | Конец сообщения | { id, type, stop_reason } |
-| `error` | Ошибка | { message, code, ... } |
-
-## Потоковая передача мышления
-
-Самый простой способ получать мышление — использовать метод `streamChatWithThinking`:
-
-```javascript
-// Обработчик событий
-const handleEvent = (eventType, data) => {
-  if (eventType === 'content_block_delta' && data.delta?.type === 'thinking_delta') {
-    console.log('Мышление:', data.delta.thinking);
-  } else if (eventType === 'content_block_delta' && data.delta?.type === 'text_delta') {
-    console.log('Ответ:', data.delta.text);
-  } else if (eventType === 'message_stop') {
-    console.log('Завершение ответа');
-  }
-};
-
-// Отправка запроса с потоковым мышлением
-const messages = [
-  { role: 'user', content: 'Объясни квантовую механику' }
-];
-
-const options = {
-  model: 'claude-3-7-sonnet-20240229',
-  thinking: true,
-  temperature: 0.7
-};
-
-const response = await sdk.chat.streamChatWithThinking(
-  messages,
-  options,
-  handleEvent
-);
-```
-
 ## Обработка ошибок
 
 ```javascript
@@ -272,28 +122,18 @@ try {
     handleEvent
   );
 } catch (error) {
-  if (error.code === 'CONNECTION_ERROR') {
-    console.error('Ошибка подключения:', error.message);
-  } else {
-    console.error('Произошла ошибка:', error.message);
-  }
+  console.error('Произошла ошибка:', error.message);
 }
 ```
 
-## Настройка WebSocket
-
-```javascript
-// Настройка параметров WebSocket при создании SDK
-const sdk = new CodeSolverSDK({
-  baseURL: 'https://api.example.com',
-  apiKey: 'your-api-key',
-  websocket: {
-    reconnect: true,               // Автоматическое переподключение
-    reconnectAttempts: 5,           // Максимальное количество попыток
-    rejectUnauthorized: false       // Для самоподписанных сертификатов
-  }
-});
-```
-## Дополнительная информация
-
-Для детального описания всех возможностей WebSocket, смотрите [руководство по мышлению](./features/THINKING.md) и примеры в директории [examples/websocket](../examples/websocket).
+## Основные события
+
+| Событие | Описание |
+|---------|----------|
+| `message_start` | Начало сообщения |
+| `thinking_delta` | Обновление мышления AI |
+| `text_delta` | Часть текстового ответа |
+| `message_stop` | Конец сообщения |
+| `indexing_progress` | Прогресс индексации |
+| `indexing_complete` | Завершение индексации |
+| `error` | Уведомление об ошибке |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "solver-sdk",
-  "version": "1.8.1",
+  "version": "1.9.0",
   "description": "SDK для интеграции с Code Solver Backend API",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",