solver-sdk 2.3.0 → 2.6.0

package/docs/INTEGRATION_EXAMPLES.md

@@ -1,328 +0,0 @@
-# Примеры интеграции SDK
-
-В этом документе приведены примеры использования 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>
-          
-          <script>
-            const vscode = acquireVsCodeApi();
-            window.addEventListener('message', event => {
-              const message = event.data;
-              if (message.command === 'appendThinking') {
-                document.getElementById('thinking').textContent += message.content;
-              } else if (message.command === 'appendAnswer') {
-                document.getElementById('answer').textContent += message.content;
-              }
-            });
-          </script>
-        </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
-      );
-      
-    } 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 для отображения результатов
-      let resultsHtml = '';
-      results.results.forEach((result, index) => {
-        resultsHtml += `
-          <div class="result">
-            <div class="path" data-path="${result.path}">${result.path}</div>
-            <div class="snippet">${result.content || 'Содержимое недоступно'}</div>
-          </div>
-        `;
-      });
-      
-      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>
-          ${resultsHtml}
-          
-          <script>
-            const vscode = acquireVsCodeApi();
-            document.querySelectorAll('.path').forEach(element => {
-              element.addEventListener('click', () => {
-                vscode.postMessage({
-                  command: 'openFile',
-                  path: element.getAttribute('data-path')
-                });
-              });
-            });
-          </script>
-        </body>
-        </html>
-      `;
-      
-      // Обработчик сообщений от WebView
-      panel.webview.onDidReceiveMessage(message => {
-        if (message.command === 'openFile') {
-          const filePath = message.path;
-          vscode.workspace.openTextDocument(filePath)
-            .then(doc => vscode.window.showTextDocument(doc));
-        }
-      });
-    });
-  } catch (error) {
-    vscode.window.showErrorMessage(`Ошибка поиска: ${error.message}`);
-  }
-} 

package/docs/PING_PONG.md

@@ -1,113 +0,0 @@
-# Механизм Ping/Pong для WebSocket
-
-Для поддержания активных WebSocket соединений и проверки их состояния SDK использует механизм ping/pong.
-
-## Что такое ping/pong?
-
-Ping/pong - это механизм отправки специальных сообщений между клиентом и сервером для проверки активности соединения. 
-Клиент периодически отправляет сообщение "ping", на которое сервер должен ответить сообщением "pong".
-Если ответа нет в течение определенного времени, соединение считается разорванным.
-
-## Как это работает в SDK?
-
-SDK автоматически настраивает и управляет ping/pong механизмом, когда вы используете следующие высокоуровневые методы:
-
-```javascript
-// Подключение к WebSocket пространствам имен
-await sdk.connect(); // Подключается ко всем пространствам имен
-
-// Или более специфичные подключения
-await sdk.reasoning.connectWebSocket(reasoningId);
-await sdk.dependencies.connectWebSocket(projectId);
-await sdk.projects.connectWebSocket();
-```
-
-### Настройка ping/pong
-
-По умолчанию SDK использует следующие настройки:
-- Интервал ping: 25 секунд
-- Таймаут ожидания pong: 60 секунд
-
-Эти настройки можно изменить при инициализации SDK:
-
-```javascript
-const sdk = new CodeSolverSDK({
-  baseURL: 'https://api.example.com',
-  apiKey: 'your-api-key',
-  websocket: {
-    pingInterval: 30000,  // 30 секунд
-    pingTimeout: 90000    // 90 секунд
-  }
-});
-```
-
-### Преимущества автоматического ping/pong
-
-1. **Обнаружение разрывов соединения**: Если сервер не отвечает на ping, SDK обнаружит разрыв соединения.
-2. **Предотвращение тайм-аутов**: Регулярные ping/pong сообщения поддерживают соединение активным и предотвращают тайм-ауты на промежуточных серверах и брандмауэрах.
-3. **Автоматическое переподключение**: SDK может автоматически переподключаться при обнаружении разрыва соединения.
-
-### События ping/pong
-
-SDK предоставляет события для отслеживания состояния ping/pong:
-
-```javascript
-// Настройка обработчиков для всех WebSocket соединений
-sdk.on('connection_timeout', async (data) => {
-  console.warn(`Соединение с ${data.namespace} истекло по тайм-ауту`);
-  // Автоматически SDK попытается переподключиться
-});
-```
-
-## Рекомендуемые практики
-
-1. **Используйте высокоуровневые методы подключения**: Самый простой способ обеспечить надежное соединение - использовать встроенные высокоуровневые методы SDK.
-
-2. **Включите автоматическое переподключение**: При инициализации SDK установите параметры:
-   ```javascript
-   const sdk = new CodeSolverSDK({
-     baseURL: 'https://api.example.com',
-     apiKey: 'your-api-key',
-     websocket: {
-       reconnect: true,
-       reconnectAttempts: 5,
-       reconnectDelay: 2000
-     }
-   });
-   ```
-
-3. **Обрабатывайте события тайм-аута**: Регистрируйте обработчики событий, чтобы знать, когда соединение было потеряно.
-
-4. **Правильно завершайте соединения**: Перед закрытием приложения вызывайте метод для отключения:
-   ```javascript
-   // Отключение перед закрытием приложения
-   await sdk.disconnect();
-   ```
-
-## Пример обработки тайм-аутов
-
-```javascript
-// Инициализация SDK
-const sdk = new CodeSolverSDK({
-  baseURL: 'https://api.example.com',
-  apiKey: 'your-api-key'
-});
-
-// Подключение к WebSocket
-await sdk.connect();
-
-// Обработка события тайм-аута
-sdk.on('connection_timeout', handleConnectionTimeout);
-
-// Функция обработки тайм-аута
-async function handleConnectionTimeout(data) {
-  console.warn(`Соединение с ${data.namespace} прервано по тайм-ауту`);
-  
-  // Вы можете добавить свою логику обработки
-  // Например, уведомить пользователя или попытаться переподключиться
-}
-
-// Перед закрытием приложения
-// Корректно отключаемся
-await sdk.disconnect();
-```