solver-sdk 1.7.4 → 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,77 +1,102 @@
-# Документация Solver SDK
+23# Code Solver SDK
 
-Эта директория содержит подробную документацию по Solver SDK версии 1.7.2.
+JavaScript/TypeScript SDK для взаимодействия с API Code Solver, предназначенного для умной работы с кодом, семантического поиска и AI-ассистентов.
 
-## Содержание
+## Установка
 
-### Основная документация
-
-- [Потоковая передача мышления (Thinking Architecture)](./THINKING_ARCHITECTURE.md) - Архитектура системы потоковой передачи мышления
-- [Руководство по потоковой передаче мышления](./streaming-thinking-guide.md) - Практическое руководство по использованию потоковой передачи мышления
-- [Работа с региональными эндпоинтами](./REGIONS.md) - Информация о работе с региональными эндпоинтами Anthropic API
-- [Расширенные возможности SDK](./ADVANCED.md) - Продвинутые функции и конфигурация SDK
-- [WebSocket API](./WEBSOCKET.md) - Подробное руководство по работе с WebSocket
-- [Справочник WebSocket событий](./WEBSOCKET_EVENTS.md) - Полный список всех WebSocket событий SDK
-- [Механизм Ping/Pong](./PING_PONG.md) - Документация по мониторингу состояния WebSocket соединений
-- [Индексация проектов](./INDEXING.md) - Руководство по индексации и обновлению индекса проектов
+```bash
+npm install @code-solver/sdk
+```
 
-### Дополнительные материалы
+## Основные возможности
 
-- [Режим мышления](./thinking/thinking-mode.md) - Основная информация о режиме мышления
+- **Работа с проектами**: создание, индексация и управление проектами
+- **Семантический поиск**: поиск по смыслу в коде проекта
+- **AI-чат с контекстом**: взаимодействие с AI-моделями в контексте проекта
+- **Работа с WebSocket**: потоковая обработка событий и ответов
+- **Мультиплатформенность**: поддержка как браузеров, так и Node.js
 
-## Основные возможности SDK 1.7.2
+## Быстрый старт
 
-### Потоковая передача мышления (Streaming Thinking)
+```javascript
+import { CodeSolverSDK } from '@code-solver/sdk';
 
-В версии 1.7.2 добавлена полная поддержка потоковой передачи мышления с помощью метода `streamChatWithThinking()`. Это позволяет получать события мышления модели в реальном времени через WebSocket.
+// Инициализация SDK
+const sdk = new CodeSolverSDK({
+  baseURL: 'https://api.code-solver.com',
+  apiKey: 'ваш-api-ключ',
+  websocket: {
+    reconnect: true,
+    reconnectAttempts: 5
+  }
+});
 
-```javascript
-const response = await sdk.chat.streamChatWithThinking(
-  messages,
-  { model: 'claude-3-7-sonnet-20240229', thinking: true },
-  handleEvent
+// Проверка доступности 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}%`);
+});
 
-SDK поддерживает работу с различными региональными эндпоинтами Anthropic API:
+sdk.projects.on('indexing_complete', (data) => {
+  console.log('Индексация завершена!');
+});
 
-```javascript
-const sdk = new CodeSolverSDK({
-  providers: {
-    anthropic: {
-      region: 'eu-west-1'  // Использовать европейский регион
-    }
+// Семантический поиск
+const searchResults = await sdk.search.semanticSearch(project.id, {
+  query: 'функция для обработки HTTP запросов',
+  limit: 10
+});
+
+// Взаимодействие с AI-ассистентом
+const chatResponse = await sdk.chat.chat([
+  {
+    role: 'system',
+    content: 'Ты опытный программист, помогающий разработчику.'
+  },
+  {
+    role: 'user',
+    content: 'Объясни, как работает функция getUserProfile в моем проекте.'
   }
+], {
+  projectId: project.id,
+  model: 'claude-3-7-sonnet-20240229'
 });
 
-// Автоматическое переключение между регионами при ошибках
-const response = await sdk.chat.chatWithRegionFailover([...], options);
+console.log(chatResponse.answer);
 ```
 
-### WebSocket улучшения
-
-Улучшена надежность и диагностика WebSocket соединений:
+## Документация
 
-```javascript
-// Диагностика соединения
-const diagnostics = sdk.getWebSocketClient().diagnoseConnection(namespace);
-console.log(diagnostics);
-
-// Мониторинг здоровья
-sdk.getWebSocketClient().setupConnectionHealthCheck(interval);
-```
+Подробная документация доступна в следующих файлах:
 
-## Примеры кода
+- [API Reference](./API_REFERENCE.md) - подробное описание всех методов SDK
+- [Authentication](./AUTHENTICATION.md) - информация по аутентификации
+- [Работа с WebSocket](./WEBSOCKET.md) - примеры работы с WebSocket соединениями
+- [Примеры интеграции](./INTEGRATION_EXAMPLES.md) - примеры интеграции с VS Code/Cursor
 
-Примеры использования SDK доступны в директории `examples` корневого каталога проекта:
+## Поддерживаемые платформы
 
-- `example:check-api` - Проверка соединения с API
-- `example:indexing` - Индексация проектов
-- `example:dependencies` - Работа с зависимостями
-- `example:regions` - Проверка доступности регионов
+- **Браузеры**: Chrome, Firefox, Safari, Edge
+- **Node.js**: 14.x и выше
 
-## Обратная связь
+## Лицензия
 
-Если вы обнаружили ошибки в документации или у вас есть предложения по улучшению, пожалуйста, создайте issue в репозитории проекта. 
+MIT