solver-sdk 1.7.5 → 1.7.6

package/docs/INTEGRATION_EXAMPLES.md

@@ -0,0 +1,342 @@
+# Примеры интеграции с VS Code/Cursor
+
+В этом документе приведены примеры использования SDK с VS Code или Cursor расширениями.
+
+## Содержание
+- [Инициализация SDK](#инициализация-sdk)
+- [Работа с проектами](#работа-с-проектами)
+- [Отслеживание прогресса индексации](#отслеживание-прогресса-индексации)
+- [Потоковый чат с мышлением](#потоковый-чат-с-мышлением)
+- [Поиск в коде](#поиск-в-коде)
+
+## Инициализация SDK
+
+Пример инициализации SDK в расширении VS Code/Cursor:
+
+```typescript
+import * as vscode from 'vscode';
+import { CodeSolverSDK } from 'solver-sdk';
+
+// Инициализация SDK
+const sdk = new CodeSolverSDK({
+  baseURL: 'https://api.example.com',
+  apiKey: 'your-api-key',
+  websocket: {
+    reconnect: true,
+    reconnectAttempts: 5,
+    reconnectDelay: 3000,
+    rejectUnauthorized: false // для самоподписанных сертификатов
+  }
+});
+
+// Проверка доступности API
+async function checkConnection() {
+  try {
+    const isHealthy = await sdk.checkHealth();
+    if (isHealthy) {
+      vscode.window.showInformationMessage('API доступен');
+    } else {
+      vscode.window.showErrorMessage('API недоступен');
+    }
+  } catch (error) {
+    vscode.window.showErrorMessage(`Ошибка соединения: ${error.message}`);
+  }
+}
+```
+
+## Работа с проектами
+
+Пример автоматической работы с проектом при открытии рабочей области:
+
+```typescript
+import * as path from 'path';
+
+// Получение проекта по пути рабочей области
+async function handleWorkspace() {
+  try {
+    // Получаем путь к текущей рабочей области
+    const workspaceFolders = vscode.workspace.workspaceFolders;
+    if (!workspaceFolders || workspaceFolders.length === 0) {
+      vscode.window.showWarningMessage('Откройте папку проекта');
+      return;
+    }
+    
+    const workspacePath = workspaceFolders[0].uri.fsPath;
+    const projectName = path.basename(workspacePath);
+    
+    // Получаем проект или создаем новый 
+    const project = await sdk.projects.getOrCreateProject(
+      workspacePath,
+      projectName
+    );
+    
+    if (project) {
+      vscode.window.showInformationMessage(`Проект "${projectName}" идентифицирован (ID: ${project.id})`);
+      return project;
+    }
+  } catch (error) {
+    vscode.window.showErrorMessage(`Ошибка: ${error.message}`);
+  }
+  
+  return null;
+}
+```
+
+## Отслеживание прогресса индексации
+
+Пример отслеживания прогресса индексации:
+
+```typescript
+// Запуск индексации проекта
+async function indexProject(projectId, projectName) {
+  try {
+    // Запускаем индексацию
+    await sdk.projects.indexProject(projectId);
+    
+    // Показываем прогресс
+    vscode.window.withProgress({
+      location: vscode.ProgressLocation.Notification,
+      title: `Индексация проекта "${projectName}"`,
+      cancellable: true
+    }, async (progress, token) => {
+      // Подключаемся к WebSocket для индексации
+      await sdk.projects.connectWebSocket();
+      
+      return new Promise((resolve) => {
+        // Отслеживаем прогресс
+        sdk.projects.on('indexing_progress', (data) => {
+          progress.report({ 
+            message: `${data.progress}% (${data.processedFiles}/${data.totalFiles} файлов)`,
+            increment: data.progress
+          });
+        });
+        
+        // Отслеживаем завершение
+        sdk.projects.on('indexing_complete', (data) => {
+          if (data.success) {
+            vscode.window.showInformationMessage('Индексация успешно завершена!');
+          } else {
+            vscode.window.showWarningMessage(`Индексация завершена с ошибками: ${data.errorMessage || 'неизвестная ошибка'}`);
+          }
+          sdk.projects.disconnectWebSocket();
+          resolve();
+        });
+        
+        // Обработка отмены
+        token.onCancellationRequested(() => {
+          sdk.projects.stopIndexing(projectId)
+            .then(() => {
+              vscode.window.showInformationMessage('Индексация отменена');
+              sdk.projects.disconnectWebSocket();
+              resolve();
+            });
+        });
+      });
+    });
+  } catch (error) {
+    vscode.window.showErrorMessage(`Ошибка индексации: ${error.message}`);
+  }
+}
+```
+
+## Потоковый чат с мышлением
+
+Пример использования потокового чата с мышлением:
+
+```typescript
+// Регистрация команды чата с мышлением
+context.subscriptions.push(
+  vscode.commands.registerCommand('solver.chatWithThinking', async () => {
+    try {
+      // Запрашиваем ввод от пользователя
+      const question = await vscode.window.showInputBox({
+        prompt: 'Введите вопрос'
+      });
+      
+      if (!question) return;
+      
+      // Создаем и показываем панель для результата
+      const panel = vscode.window.createWebviewPanel(
+        'chatWithThinking',
+        'Ответ с мышлением',
+        vscode.ViewColumn.Beside,
+        { enableScripts: true }
+      );
+      
+      // Начальный HTML для панели
+      panel.webview.html = `
+        <!DOCTYPE html>
+        <html>
+        <head>
+          <style>
+            body { font-family: var(--vscode-font-family); padding: 10px; }
+            .thinking { color: #666; font-style: italic; white-space: pre-wrap; }
+            .answer { white-space: pre-wrap; }
+          </style>
+        </head>
+        <body>
+          <h3>Вопрос: ${question}</h3>
+          <div class="thinking" id="thinking"></div>
+          <h4>Ответ:</h4>
+          <div class="answer" id="answer"></div>
+        </body>
+        </html>
+      `;
+      
+      // Сообщения для чата
+      const messages = [
+        { role: 'user', content: question }
+      ];
+      
+      // Опции для чата
+      const options = {
+        model: 'claude-3-7-sonnet-20240229',
+        thinking: true,
+        temperature: 0.7
+      };
+      
+      // Обработчик событий чата
+      const handleEvent = (eventType, data) => {
+        if (eventType === 'thinking_delta' && data.thinking) {
+          // Обновляем содержимое мышления
+          panel.webview.postMessage({
+            command: 'appendThinking',
+            content: data.thinking
+          });
+        } else if (eventType === 'text_delta' && data.text) {
+          // Обновляем содержимое ответа
+          panel.webview.postMessage({
+            command: 'appendAnswer',
+            content: data.text
+          });
+        }
+      };
+      
+      // Отправляем запрос с мышлением
+      await sdk.chat.streamChatWithThinking(
+        messages, 
+        options,
+        handleEvent
+      );
+      
+      // Настраиваем обработку сообщений в WebView
+      panel.webview.onDidReceiveMessage(message => {
+        const thinkingElement = document.getElementById('thinking');
+        const answerElement = document.getElementById('answer');
+        
+        if (message.command === 'appendThinking') {
+          thinkingElement.textContent += message.content;
+        } else if (message.command === 'appendAnswer') {
+          answerElement.textContent += message.content;
+        }
+      });
+      
+    } catch (error) {
+      vscode.window.showErrorMessage(`Ошибка чата: ${error.message}`);
+    }
+  })
+);
+```
+
+## Поиск в коде
+
+Пример семантического поиска в проекте:
+
+```typescript
+// Поиск в проекте
+async function searchInProject(projectId, query) {
+  try {
+    // Показываем индикатор прогресса
+    return vscode.window.withProgress({
+      location: vscode.ProgressLocation.Notification,
+      title: 'Поиск в проекте...',
+      cancellable: false
+    }, async (progress) => {
+      // Выполняем поиск
+      const results = await sdk.search.semanticSearch(projectId, {
+        query: query,
+        limit: 10,
+        includeContent: true
+      });
+      
+      if (results.results.length === 0) {
+        vscode.window.showInformationMessage('Результаты не найдены');
+        return;
+      }
+      
+      // Отображаем результаты
+      const panel = vscode.window.createWebviewPanel(
+        'searchResults',
+        'Результаты поиска',
+        vscode.ViewColumn.Beside,
+        { enableScripts: true }
+      );
+      
+      // Формируем HTML для отображения результатов
+      panel.webview.html = `
+        <!DOCTYPE html>
+        <html>
+        <head>
+          <style>
+            body { font-family: var(--vscode-font-family); padding: 10px; }
+            .result { margin-bottom: 15px; padding: 10px; border: 1px solid #ccc; }
+            .path { cursor: pointer; color: var(--vscode-textLink-foreground); }
+            .snippet { background: var(--vscode-editor-inactiveSelectionBackground); padding: 10px; margin-top: 5px; white-space: pre-wrap; }
+          </style>
+        </head>
+        <body>
+          <h3>Результаты для: ${query}</h3>
+          ${results.results.map((result, index) => `
+            <div class="result">
+              <div class="path" data-path="${result.filePath}" data-start="${result.startLine}" data-end="${result.endLine}">
+                ${result.filePath}:${result.startLine}-${result.endLine}
+              </div>
+              <div class="snippet">${result.snippet || result.content || ''}</div>
+            </div>
+          `).join('')}
+          
+          <script>
+            // Добавляем обработчик для открытия файлов
+            document.querySelectorAll('.path').forEach(elem => {
+              elem.addEventListener('click', () => {
+                const vscode = acquireVsCodeApi();
+                vscode.postMessage({
+                  command: 'openFile',
+                  filePath: elem.dataset.path,
+                  startLine: parseInt(elem.dataset.start),
+                  endLine: parseInt(elem.dataset.end)
+                });
+              });
+            });
+          </script>
+        </body>
+        </html>
+      `;
+      
+      // Обработка сообщений от WebView
+      panel.webview.onDidReceiveMessage(
+        message => {
+          if (message.command === 'openFile') {
+            const uri = vscode.Uri.file(message.filePath);
+            vscode.workspace.openTextDocument(uri).then(doc => {
+              vscode.window.showTextDocument(doc).then(editor => {
+                const range = new vscode.Range(
+                  new vscode.Position(message.startLine - 1, 0),
+                  new vscode.Position(message.endLine - 1, 0)
+                );
+                editor.revealRange(range);
+              });
+            });
+          }
+        },
+        undefined,
+        context.subscriptions
+      );
+      
+      return results;
+    });
+  } catch (error) {
+    vscode.window.showErrorMessage(`Ошибка поиска: ${error.message}`);
+  }
+}
+``` 

package/docs/README.md

@@ -1,53 +1,102 @@
-# Документация SDK
+23# Code Solver SDK
 
-Добро пожаловать в документацию SDK для интеграции с Code Solver Backend API.
+JavaScript/TypeScript SDK для взаимодействия с API Code Solver, предназначенного для умной работы с кодом, семантического поиска и AI-ассистентов.
 
-## Содержание
+## Установка
 
-### Введение
-- [Быстрый старт](../README.md) - основная информация по установке и использованию SDK
+```bash
+npm install @code-solver/sdk
+```
 
-### Основные функции
-- [Потоковая передача мышления](./features/THINKING.md) - получение процесса мышления модели
-- [Работа с WebSocket](./WEBSOCKET.md) - соединения и потоковая передача данных
-- [Работа с проектами](./PROJECTS.md) - создание и управление проектами
+## Основные возможности
 
-### API Reference
-- [Аутентификация](./AUTHENTICATION.md) - способы аутентификации в API
-- [Обработка ошибок](./ERROR_HANDLING.md) - типы ошибок и их обработка
-- [API Reference](./API_REFERENCE.md) - полное описание всех методов SDK
+- **Работа с проектами**: создание, индексация и управление проектами
+- **Семантический поиск**: поиск по смыслу в коде проекта
+- **AI-чат с контекстом**: взаимодействие с AI-моделями в контексте проекта
+- **Работа с WebSocket**: потоковая обработка событий и ответов
+- **Мультиплатформенность**: поддержка как браузеров, так и Node.js
 
-### Расширенные возможности
-- [Механизм ping/pong](./advanced/PING_PONG.md) - мониторинг состояния соединений
+## Быстрый старт
 
-## Начало работы
+```javascript
+import { CodeSolverSDK } from '@code-solver/sdk';
 
-Установите SDK с помощью npm:
+// Инициализация SDK
+const sdk = new CodeSolverSDK({
+  baseURL: 'https://api.code-solver.com',
+  apiKey: 'ваш-api-ключ',
+  websocket: {
+    reconnect: true,
+    reconnectAttempts: 5
+  }
+});
 
-```bash
-npm install solver-sdk
-```
+// Проверка доступности API
+const isAvailable = await sdk.checkHealth();
+if (!isAvailable) {
+  console.error('API недоступен');
+  return;
+}
 
-Простой пример использования:
+// Создание проекта
+const project = await sdk.projects.createProject(
+  'Мой проект',
+  '/путь/к/проекту',
+  {
+    excludePatterns: ['node_modules', '.git', 'dist']
+  }
+);
+
+// Индексация проекта
+await sdk.projects.indexProject(project.id);
+
+// Отслеживание прогресса индексации через WebSocket
+sdk.projects.on('indexing_progress', (data) => {
+  console.log(`Прогресс индексации: ${data.progress}%`);
+});
 
-```javascript
-const { CodeSolverSDK } = require('solver-sdk');
+sdk.projects.on('indexing_complete', (data) => {
+  console.log('Индексация завершена!');
+});
 
-// Создание экземпляра SDK
-const sdk = new CodeSolverSDK({
-  baseURL: 'https://api.example.com',
-  apiKey: 'your-api-key'
+// Семантический поиск
+const searchResults = await sdk.search.semanticSearch(project.id, {
+  query: 'функция для обработки HTTP запросов',
+  limit: 10
 });
 
-// Получение списка моделей
-async function getModels() {
-  const models = await sdk.chat.getModels();
-  console.log('Доступные модели:', models);
-}
+// Взаимодействие с AI-ассистентом
+const chatResponse = await sdk.chat.chat([
+  {
+    role: 'system',
+    content: 'Ты опытный программист, помогающий разработчику.'
+  },
+  {
+    role: 'user',
+    content: 'Объясни, как работает функция getUserProfile в моем проекте.'
+  }
+], {
+  projectId: project.id,
+  model: 'claude-3-7-sonnet-20240229'
+});
 
-getModels().catch(console.error);
+console.log(chatResponse.answer);
 ```
 
-## Примеры использования
+## Документация
+
+Подробная документация доступна в следующих файлах:
+
+- [API Reference](./API_REFERENCE.md) - подробное описание всех методов SDK
+- [Authentication](./AUTHENTICATION.md) - информация по аутентификации
+- [Работа с WebSocket](./WEBSOCKET.md) - примеры работы с WebSocket соединениями
+- [Примеры интеграции](./INTEGRATION_EXAMPLES.md) - примеры интеграции с VS Code/Cursor
+
+## Поддерживаемые платформы
+
+- **Браузеры**: Chrome, Firefox, Safari, Edge
+- **Node.js**: 14.x и выше
+
+## Лицензия
 
-Полный набор примеров доступен в директории [examples](../examples). 
+MIT 

package/docs/WEBSOCKET.md

@@ -1,34 +1,165 @@
 # Работа с WebSocket соединениями
 
-В этом разделе описаны методы SDK для работы с WebSocket соединениями и потоковой передачей данных.
+В этом разделе описаны основные методы для работы с WebSocket соединениями.
 
-## Основы работы с WebSocket
-
-SDK предоставляет высокоуровневое API для работы с WebSocket, интегрированное в основные классы:
+## Получение WebSocket клиента
 
 ```javascript
 const { CodeSolverSDK } = require('solver-sdk');
 
 const sdk = new CodeSolverSDK({
   baseURL: 'https://api.example.com',
-  apiKey: 'your-api-key'
+  apiKey: 'your-api-key',
+  websocket: {
+    reconnect: true,
+    reconnectAttempts: 5,
+    reconnectDelay: 3000,
+    rejectUnauthorized: true // false для самоподписанных сертификатов
+  }
 });
 
 // Получение WebSocket клиента
 const wsClient = sdk.getWebSocketClient();
 
-// Подключение к пространству имен рассуждений
-await wsClient.connectToReasoning('reasoning-id');
+// Подключение к namespace рассуждений
+await wsClient.connectToReasoning();
+
+// Подключение к namespace индексации
+await wsClient.connectToIndexing();
+
+// Проверка статуса подключения
+const isConnected = wsClient.isConnected(WebSocketNamespace.REASONING);
+
+// Отключение от определенного namespace
+await wsClient.disconnect(WebSocketNamespace.REASONING);
+
+// Отключение от всех namespace
+await wsClient.disconnectAll();
+```
+
+## Мониторинг индексации проектов
+
+```javascript
+// Подключение к WebSocket для проектов
+await sdk.projects.connectWebSocket();
+
+// Отслеживание прогресса индексации
+sdk.projects.on('indexing_progress', (data) => {
+  console.log(`Прогресс индексации: ${data.progress}%`);
+  console.log(`Обработано файлов: ${data.processedFiles} из ${data.totalFiles}`);
+});
+
+// Завершение индексации
+sdk.projects.on('indexing_complete', (data) => {
+  console.log('Индексация завершена!', data.success ? 'Успешно' : 'С ошибками');
+  
+  // Отключение после завершения
+  sdk.projects.disconnectWebSocket();
+});
+
+// Остановка индексации
+await sdk.projects.stopIndexing(projectId);
+```
+
+## Потоковый чат с мышлением AI
+
+```javascript
+// Обработчик событий для потокового получения ответа и мышления
+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); // Вывод текста без переноса строки
+  } else if (eventType === 'message_stop') {
+    console.log('\nОтвет завершен');
+  }
+};
+
+// Отправка запроса 
+const messages = [
+  { role: 'user', content: 'Расскажи о JavaScript' }
+];
+
+const options = {
+  model: 'claude-3-7-sonnet-20240229',
+  thinking: true,
+  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);
 
 // Подписка на события
-wsClient.on('content_block_delta', (data) => {
-  if (data.delta?.type === 'thinking_delta') {
-    console.log('Фрагмент мышления:', data.delta.thinking);
+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
+
+```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  // Сохранение сессии
   }
 });
+```
 
-// Отключение
-wsClient.disconnect(WebSocketNamespace.REASONING);
+## Обработка ошибок в WebSocket
+
+```javascript
+try {
+  await sdk.projects.connectWebSocket();
+  
+  // Подписка на события ошибок
+  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
@@ -163,7 +294,6 @@ const sdk = new CodeSolverSDK({
   }
 });
 ```
-
 ## Дополнительная информация
 
-Для детального описания всех возможностей WebSocket, смотрите [руководство по мышлению](./features/THINKING.md) и примеры в директории [examples/websocket](../examples/websocket).
+Для детального описания всех возможностей WebSocket, смотрите [руководство по мышлению](./features/THINKING.md) и примеры в директории [examples/websocket](../examples/websocket).