solver-sdk 2.8.0 → 3.1.0

package/README.md

@@ -1,86 +1,20 @@
-# Solver SDK v2.7.0 🚀
+# Code Solver SDK v3.0
 
-**Production-ready** SDK для интеграции с Code Solver Backend API с поддержкой **VS Code Extension**.
+> **🚀 Версия 3.0 - полный переход на HTTP API**  
+> Убрана поддержка WebSocket, все взаимодействие происходит через REST API
 
-**🎉 Версия 2.7.0:** **VS Code интеграция с 10x ускорением!** HTTP Streaming для команд VS Code, гибридная архитектура, 45ms vs 443ms старая архитектура.
-
-<p align="center">
-  <a href="https://www.npmjs.com/package/solver-sdk"><img src="https://img.shields.io/npm/v/solver-sdk.svg" alt="NPM Version" /></a>
-  <a href="https://www.npmjs.com/package/solver-sdk"><img src="https://img.shields.io/npm/dm/solver-sdk.svg" alt="NPM Downloads" /></a>
-  <a href="https://github.com/code-solver/browser-sdk/blob/main/LICENSE"><img src="https://img.shields.io/npm/l/solver-sdk.svg" alt="License" /></a>
-</p>
-
-## ⚡ Что нового в v2.7.0
-
-- 🚀 **VS Code интеграция:** Нативное выполнение команд через HTTP Streaming  
-- ⚡ **10x ускорение:** 45ms vs 443ms старая архитектура команд VS Code
-- 🏗️ **Гибридная архитектура:** HTTP Streaming + WebSocket для оптимальной производительности
-- 🎯 **Новые типы:** `VSCodeCommandEvent`, `CommandExecutionResult`, `VSCodeCommands`
-- 🔄 **Двусторонняя связь:** Backend ←→ SDK ←→ Extension
-- 📊 **Real-time feedback:** Мгновенные результаты выполнения команд
-- 🛡️ **Backwards compatible:** Все существующие методы работают без изменений
-
-## 📋 Для разработчиков
-
-### 🎯 **VS Code Extension разработчики**
-- 📄 **[5-минутный старт](docs/QUICK_START.md)** - минимальный код для работы
-- 📚 **[Полное руководство](docs/VSCODE_INTEGRATION.md)** - детальные примеры и best practices
-
-### 🔧 **Backend интеграция**
-- 🏗️ **[Архитектура](docs/ARCHITECTURE.md)** - HTTP vs WebSocket решения
-- 🔌 **[WebSocket API](docs/WEBSOCKET.md)** - события и namespace'ы
-- 🔑 **[Аутентификация](docs/AUTHENTICATION.md)** - настройка API ключей
-
-### 📖 **Остальная документация**
-- [Основные возможности](#основные-возможности)
-- [Установка](#установка)  
-- [Быстрый старт](#быстрый-старт)
-- [API компоненты](#api)
-- [Примеры использования](#примеры)
+JavaScript/TypeScript SDK для работы с Code Solver API. Предоставляет простой интерфейс для индексации кода, поиска, работы с чатом и анализа зависимостей.
 
 ## 🎯 Основные возможности
 
-- **🚀 Production готовность (v2.5.0)**:
-  - "Fail Fast" подход без fallback'ов
-  - Честные ошибки без маскировки проблем
-  - Полный контроль WebSocket подключений
-  - API диагностика с детальными отчетами
-
-- **🎮 Гибкая инициализация (v2.5.0)**:
-  - `CodeSolverSDK.create()` - с валидацией API
-  - `new CodeSolverSDK()` - быстрая инициализация
-  - `autoConnect: false` - ручное управление WebSocket
-  - Алиасы методов для удобства (`create()`, `start()`, `stop()`)
-
-- **🔌 Контролируемые WebSocket**:
-  - Ручное подключение только когда нужно
-  - Автоматический ping/pong механизм
-  - Интеллектуальное переподключение
-  - Мониторинг здоровья соединения
-
-- **🧠 Потоковое мышление AI**:
-  - `streamChat()` с поддержкой Anthropic Claude thinking и VS Code команд
-  - Полная поддержка `ContentBlock[]` и `signature` блоков
-  - Сохранение криптографических подписей
-  - Обработка `signature_delta` событий
-
-- **🎯 VS Code Extension интеграция (v2.7.0)**:
-  - Нативное выполнение команд через HTTP Streaming
-  - 10x ускорение (45ms vs 443ms старая архитектура)
-  - Поддержка всех VS Code команд (создание файлов, редактирование, поиск)
-  - Real-time feedback и error handling
-
-- **🔍 Семантический поиск**:
-  - Инкрементальная индексация файлов
-  - Семантический поиск по коду
-  - Работа с зависимостями проектов
-
-- **🌐 Кросс-платформенность**:
-  - ESM, CommonJS, браузер, Node.js
-  - Полная TypeScript типизация
-  - Региональные Anthropic endpoints
-
-## Установка
+- **💬 Chat API** - взаимодействие с AI моделями (Claude, GPT)
+- **🔍 Code Search** - семантический поиск по коду
+- **📊 Project Indexing** - индексация и анализ проектов
+- **🕸️ Dependencies** - анализ зависимостей кода
+- **📝 Context API** - получение контекста для AI
+- **🛠️ Code Modification** - модификация кода через AI
+
+## 📦 Установка
 
 ```bash
 npm install solver-sdk
@@ -88,368 +22,266 @@ npm install solver-sdk
 
 ## 🚀 Быстрый старт
 
-### 🎯 **VS Code Extension интеграция** (основной use case)
-
 ```javascript
-// 📄 Полный код в docs/QUICK_START.md
 import { CodeSolverSDK } from 'solver-sdk';
 
-const sdk = await CodeSolverSDK.create({
-  baseURL: 'http://localhost:3000',
-  apiKey: 'your-api-key'
-});
-
-// 45ms команды VS Code - 10x ускорение!
-const stream = await sdk.chat.streamChat(messages, {
-  onVSCodeCommand: async (command) => {
-    return await vscode.commands.executeCommand(command.command, ...command.args);
-  }
-});
-```
-
-**📚 [Смотрите полный 5-минутный старт](docs/QUICK_START.md)**
-
-### ✅ Быстрая инициализация (без проверки API)
-
-```javascript
-const { CodeSolverSDK } = require('solver-sdk');
-
-// Быстрое создание без валидации
+// Создание SDK
 const sdk = new CodeSolverSDK({
-  baseURL: 'http://localhost:3000',
+  baseURL: 'https://your-api-server.com',
   apiKey: 'your-api-key',
-  websocket: { autoConnect: false }  // 🔧 Важно!
+  timeout: 30000
 });
 
-// Использование с честными ошибками
-try {
-  const projects = await sdk.projects.getAllProjects();
-  console.log('✅ Проекты:', projects);
-} catch (error) {
-  console.error('❌ Честная ошибка:', error.message);
-  // Нет fallback'ов - проблему нужно решать
-}
-```
+// Проверка здоровья API
+const isHealthy = await sdk.checkHealth();
+console.log('API доступен:', isHealthy);
 
-### В среде ESM (Node.js)
+// Создание проекта
+const project = await sdk.projects.createProject({
+  name: 'My Project',
+  path: '/path/to/project',
+  description: 'Описание проекта'
+});
 
-```javascript
-import { CodeSolverSDK } from 'solver-sdk';
+// Индексация проекта
+const indexingResult = await sdk.indexing.indexProject(
+  '/path/to/project',
+  'My Project'
+);
 
-// Создание экземпляра SDK
-const sdk = new CodeSolverSDK({
-  baseURL: 'https://localhost:3000',
-  apiKey: 'your-api-key'
-});
+// Ожидание завершения индексации
+const finalStatus = await sdk.indexing.waitForCompletion(indexingResult.projectId);
 
-// Пример использования
-async function example() {
-  const isHealthy = await sdk.checkHealth();
-  console.log('Сервер доступен:', isHealthy);
-}
+// Поиск кода
+const searchResults = await sdk.search.searchCode({
+  projectId: project.projectId,
+  query: 'function calculateSum',
+  maxResults: 10
+});
 
-example().catch(console.error);
+// Работа с чатом
+const response = await sdk.chat.chat([
+  { role: 'user', content: 'Объясни этот код' }
+], {
+  model: 'claude-3-5-sonnet-20241022',
+  maxTokens: 8192
+});
 ```
 
-### В браузере
+## 📋 API Методы
 
-```html
-<script src="node_modules/solver-sdk/dist/umd/code-solver-sdk.min.js"></script>
-<script>
-  // SDK доступен глобально как CodeSolverSDK
-  const sdk = new CodeSolverSDK.default({
-    baseURL: 'https://localhost:3000',
-    apiKey: 'your-api-key'
+### 📁 Projects API
+```javascript
+// Создание проекта
+await sdk.projects.createProject({
+  name: 'Project Name',
+  path: '/project/path',
+  description: 'Description'
   });
   
-  // Пример использования
-  sdk.checkHealth()
-    .then(isHealthy => console.log('Сервер доступен:', isHealthy))
-    .catch(console.error);
-</script>
-```
-
-## API
-
-### Основные компоненты
-
-- `CodeSolverSDK` - Основной класс SDK
-- `ReasoningApi` - API для работы с рассуждениями
-- `ProjectsApi` - API для работы с проектами
-- `SearchApi` - API для поиска кода
-- `AgentsApi` - API для работы с агентами
-- `ContextApi` - API для работы с контекстом кода
-- `DependenciesApi` - API для работы с зависимостями
-- `ChatApi` - API для работы с чатом и потоковой передачей мышления
+// Получение списка проектов  
+await sdk.projects.getProjects();
 
-### Опции SDK
-
-| Опция | Тип | Описание | Обязательна |
-|-------|-----|----------|-------------|
-| `baseURL` | string | Базовый URL API | Да |
-| `apiKey` | string | API ключ для авторизации | Нет |
-| `timeout` | number | Таймаут для HTTP запросов (мс) | Нет |
-| `headers` | object | Пользовательские HTTP заголовки | Нет |
-| `httpsAgent` | object | Опции для HTTPS агента (Node.js) | Нет |
-| `mode` | string | Режим работы SDK ('browser', 'node', 'auto') | Нет |
-| `websocket` | object | Настройки WebSocket (reconnect, timeout и др.) | Нет |
-
-## Продвинутые функции
-
-### Работа с проектами
+// Получение информации о проекте
+await sdk.projects.getProject(projectId);
+```
 
+### 🔄 Indexing API
 ```javascript
-// Получение списка проектов
-const projects = await sdk.projects.getAllProjects();
-console.log('Проекты:', projects);
+// Индексация проекта
+await sdk.indexing.indexProject('/path/to/project', 'Project Name');
 
-// Создание нового проекта
-const newProject = await sdk.projects.createProject('Мой проект', '/path/to/project');
-console.log('Новый проект:', newProject);
+// Получение статуса индексации
+await sdk.indexing.getStatus(projectId);
 
-// Запуск индексации
-await sdk.projects.indexProject(newProject.id);
+// Ожидание завершения
+await sdk.indexing.waitForCompletion(projectId);
 ```
 
-### Поиск кода
-
+### 🔍 Search API
 ```javascript
 // Поиск кода
-const searchResults = await sdk.search.searchCode(projectId, {
-  query: 'function example',
-  limit: 10
-});
-console.log('Результаты поиска:', searchResults);
-
-// Семантический поиск кода
-const semanticResults = await sdk.search.semanticSearch(projectId, {
-  query: 'функция для обработки HTTP запросов',
-  limit: 10
+await sdk.search.searchCode({
+  projectId: 'project-id',
+  query: 'search query',
+  maxResults: 20
 });
-console.log('Семантические результаты:', semanticResults);
 ```
 
-### Работа с рассуждениями через WebSocket
-
+### 💬 Chat API
 ```javascript
-// Создание рассуждения
-const reasoning = await sdk.reasoning.createReasoning({
-  projectId: projectId,
-  query: 'Объясни, как работает этот проект'
+// Обычный чат
+const response = await sdk.chat.chat([
+  { role: 'user', content: 'Объясни этот код' }
+], {
+  model: 'claude-3-5-sonnet-20241022',
+  maxTokens: 8192
 });
 
-// Подключение через WebSocket
-const wsClient = sdk.getWebSocketClient();
-await wsClient.connectToReasoning(reasoning.id);
-
-// Включение механизма ping/pong для мониторинга состояния соединения
-wsClient.enablePingPong(30000, 3);
-
-// Обработка событий мышления
-wsClient.on('content_block_delta', (data) => {
-  if (data.delta?.type === 'thinking_delta') {
-    console.log('Фрагмент размышления:', data.delta.thinking);
-  } else if (data.delta?.type === 'text_delta') {
-    console.log('Фрагмент ответа:', data.delta.text);
-  }
-});
+// Потоковый чат
+for await (const chunk of sdk.chat.streamChat(messages, options)) {
+  console.log(chunk.text);
+}
+```
 
-wsClient.on('message_stop', (data) => {
-  console.log('Завершено:', data);
-  
-  // Отключаем механизм ping/pong и закрываем соединение
-  wsClient.disablePingPong();
-  wsClient.disconnectAll();
-});
+### 🕸️ Dependencies API  
+```javascript
+// Граф зависимостей
+await sdk.dependencies.getDependencyGraph(projectId);
 
-// Мониторинг качества соединения
-const diagnostics = wsClient.diagnoseConnection(WebSocketNamespace.REASONING);
-console.log(`Состояние соединения:`, diagnostics);
+// Статистика зависимостей
+await sdk.dependencies.getDependencyStatistics(projectId);
 ```
 
-### API для работы с зависимостями
+## ⚙️ Конфигурация
 
 ```javascript
-// Получение зависимостей конкретного файла
-const fileDependencies = await sdk.dependencies.getFileDependencies(projectId, {
-  filePath: 'src/app.js'
+const sdk = new CodeSolverSDK({
+  baseURL: 'https://api.example.com',    // Обязательный
+  apiKey: 'your-api-key',                // Рекомендуется
+  timeout: 30000,                        // Таймаут запросов
+  headers: {                             // Дополнительные заголовки
+    'Custom-Header': 'value'
+  },
+  http: {                                // HTTP настройки
+    timeout: 45000,
+    retries: 3,
+    retryDelay: 1000
+  },
+  debug: true                            // Отладочная информация
 });
+```
+
+## 🧪 Тестирование
 
-console.log('Импорты:', fileDependencies.imports);
-console.log('Импортируется в:', fileDependencies.importedBy);
+```bash
+# Все тесты
+npm test
 
-// Получение полного графа зависимостей проекта
-const dependencyGraph = await sdk.dependencies.getDependencyGraph(projectId);
+# Только HTTP тесты
+npm test -- --testNamePattern="HTTP"
 
-// Анализ графа зависимостей и поиск циклов
-const analysis = await sdk.dependencies.analyzeDependencyGraph(projectId);
-console.log('Циклические зависимости:', analysis.cycles);
+# Интеграционные тесты
+npm run test:integration
 
-// Подключение к WebSocket для зависимостей
-await sdk.dependencies.connectWebSocket(projectId);
-sdk.dependencies.on('dependency_update', (data) => {
-  console.log('Обновление зависимостей:', data);
-});
+# Тесты индексации
+npm test -- --testPathPattern="indexing"
 ```
 
-### Потоковая передача мышления
+## 📚 Примеры использования
 
-Версия 1.7.4 включает полную поддержку потоковой передачи мышления через Anthropic API, а также улучшенную обработку ошибок:
+### Полный цикл работы с проектом
 
 ```javascript
-const { CodeSolverSDK } = require('solver-sdk');
+import { CodeSolverSDK } from 'solver-sdk';
 
-async function streamThinking() {
+async function fullWorkflow() {
   const sdk = new CodeSolverSDK({
-    baseURL: 'https://api.example.com',
-    apiKey: 'ваш-ключ-api'
+    baseURL: 'http://localhost:3001',
+    apiKey: 'your-api-key'
   });
   
-  // Сообщения для отправки
-  const messages = [
-    { role: 'user', content: 'Объясни, как работает blockchain' }
-  ];
-  
-  // Опции запроса
-  const options = {
-    model: 'claude-3-7-sonnet-20240229',
-    temperature: 0.7,
-    thinking: true,
-    authToken: 'your-auth-token' // Унифицированный параметр для аутентификации WebSocket
-  };
-  
-  // Обработчик событий WebSocket
-  const handleEvent = (eventType, data) => {
-    switch(eventType) {
-      case 'content_block_start':
-        if (data.content_block && data.content_block.type === 'thinking') {
-          console.log('Начало размышлений:');
-        }
-        break;
-        
-      case 'content_block_delta':
-        if (data.delta && data.delta.type === 'thinking_delta') {
-          process.stdout.write(data.delta.thinking); // Потоковый вывод размышлений
-        } else if (data.delta && data.delta.type === 'text_delta') {
-          process.stdout.write(data.delta.text); // Потоковый вывод итогового текста
-        }
-        break;
-        
-      case 'error':
-        console.error('Ошибка:', data.message);
-        
-        // Обработка ошибки географических ограничений
-        if (data.type === 'geo_restriction') {
-          console.error('Необходимо включить VPN для доступа к API Anthropic из вашего региона');
-        }
-        break;
-    }
-  };
-  
   try {
-    // Отправляем запрос с потоковым мышлением
-    const response = await sdk.chat.streamChatWithThinking(
-      messages,
-      options,
-      handleEvent
+    // 1. Создаем проект
+    const project = await sdk.projects.createProject({
+      name: 'My React App',
+      path: '/path/to/react-app',
+      description: 'React приложение для анализа'
+    });
+  
+    // 2. Запускаем индексацию
+    const indexing = await sdk.indexing.indexProject(
+      '/path/to/react-app',
+      'My React App'
     );
+
+    // 3. Ждем завершения индексации
+    console.log('Ожидание завершения индексации...');
+    await sdk.indexing.waitForCompletion(indexing.projectId);
+
+    // 4. Ищем React компоненты
+    const components = await sdk.search.searchCode({
+      projectId: project.projectId,
+      query: 'React.Component class',
+      maxResults: 10
+    });
+        
+    // 5. Анализируем зависимости
+    const dependencies = await sdk.dependencies.getDependencyGraph(project.projectId);
+
+    // 6. Задаем вопрос AI о коде
+    const aiResponse = await sdk.chat.chat([
+      {
+        role: 'user',
+        content: `Проанализируй найденные React компоненты: ${JSON.stringify(components)}`
+      }
+    ], {
+           model: 'claude-3-5-sonnet-20241022',
+     maxTokens: 8192
+    });
     
-    console.log(`Запрос успешно отправлен. Socket ID: ${response.socketId}`);
+    console.log('✅ Анализ завершен');
+    console.log('📊 Компоненты:', components.length);
+    console.log('🕸️ Зависимости:', dependencies);
+    console.log('🤖 AI анализ:', aiResponse.content[0].text);
+
   } catch (error) {
-    console.error('Ошибка:', error);
-    
-    // Проверка наличия ошибки географических ограничений
-    if (error.type === 'geo_restriction') {
-      console.error('Необходимо включить VPN для доступа к API Anthropic из вашего региона');
+    console.error('❌ Ошибка:', error.message);
     }
   }
-}
-
-streamThinking();
-```
-
-#### Поддерживаемые события WebSocket для мышления
-
-- `message_start` - начало сообщения от модели
-- `content_block_start` - начало блока контента (текст или thinking)
-- `content_block_delta` - дельта блока контента со следующими типами:
-  - `delta.type === 'thinking_delta'` - фрагмент размышления модели
-  - `delta.type === 'text_delta'` - фрагмент текстового ответа
-  - `delta.type === 'input_json_delta'` - фрагмент JSON для инструментов
-  - `delta.type === 'signature_delta'` - подпись блока мышления
-- `content_block_stop` - завершение блока контента
-- `message_delta` - дельта сообщения
-- `message_stop` - завершение сообщения
-
-## Примеры
-
-В директории [`examples`](./examples) доступны примеры использования SDK:
-
-```bash
-# Проверка подключения к API
-npm run example:check-api
-
-# Индексация проектов
-npm run example:indexing
 
-# Работа с зависимостями
-npm run example:dependencies
+fullWorkflow();
 ```
 
-## Совместимость
+## 🔧 Устранение неполадок
 
-SDK тщательно протестирован в различных средах и поддерживает:
-
-- **Браузеры**: Chrome 80+, Firefox 72+, Safari 14+, Edge 80+
-- **Node.js**: Версии 14.x и выше (как CommonJS, так и ESM)
-- **VS Code**: Desktop и Web версии
-
-## Разработка и тестирование
-
-```bash
-# Установка зависимостей
-npm install
-
-# Сборка SDK
-npm run build
-
-# Запуск всех тестов
-npm test
-
-# Тесты для рассуждений и WebSocket
-npm run test:reasoning:all
+### Проблемы с подключением
+```javascript
+// Диагностика API
+const diagnosis = await sdk.diagnoseAPI();
+console.log('Диагностика:', diagnosis);
 
-# Запуск примеров
-npm run example:check-api
+// Проверка здоровья конкретных эндпоинтов
+if (!diagnosis.healthy) {
+  console.log('Проблемные эндпоинты:', diagnosis.errors);
+}
 ```
 
-### Локальная разработка
-
+### Таймауты и повторы
 ```javascript
+// Увеличение таймаутов для больших проектов
 const sdk = new CodeSolverSDK({
-  baseURL: 'https://localhost:3000',
-  apiKey: 'test-api-key',
-  httpsAgent: new https.Agent({
-    rejectUnauthorized: false // Для самоподписанных сертификатов
-  }),
-  websocket: {
-    reconnect: true,
-    rejectUnauthorized: false
+  baseURL: 'https://api.example.com',
+  timeout: 120000,  // 2 минуты
+  http: {
+    timeout: 90000,
+    retries: 5,
+    retryDelay: 2000
   }
 });
 ```
 
-## Документация
+## 📝 Changelog v3.0
+
+### ✅ Добавлено
+- Полная поддержка HTTP-only API
+- Новый `IndexingClient` для простой индексации 
+- Улучшенная обработка ошибок
+- Подробная диагностика API
+- Потоковый чат через HTTP
 
-Подробная документация доступна в директории [`docs`](./docs):
+### ❌ Удалено
+- Поддержка WebSocket (полностью удалена)
+- `socket.io-client` зависимость
+- WebSocket события и обработчики
+- Сложные WebSocket конфигурации
 
-- [Начало работы](./docs/GETTING_STARTED.md)
-- [Работа с проектами](./docs/PROJECTS.md)
-- [Индексация проектов](./docs/INDEXING.md)
-- [Потоковая передача мышления](./docs/THINKING_ARCHITECTURE.md)
-- [Работа с регионами](./docs/ADVANCED.md)
-- [Полное API](./docs/API.md)
+### 🔄 Изменено
+- Все API методы теперь работают через HTTP
+- Упрощенная конфигурация SDK
+- Более быстрая инициализация
+- Лучшая совместимость с разными средами
 
-## Лицензия
+## 📄 Лицензия
 
-[MIT](./LICENSE)
+MIT License