solver-sdk 3.1.1 → 3.1.2

package/README.md

@@ -1,16 +1,15 @@
-# Code Solver SDK v3.0
+# Code Solver SDK v3.1.2
 
-> **🚀 Версия 3.0 - полный переход на HTTP API**  
-> Убрана поддержка WebSocket, все взаимодействие происходит через REST API
+> **JavaScript/TypeScript SDK для VS Code Extensions**  
+> Подключение к AI бэкенду для индексации, поиска и работы с кодом
 
-JavaScript/TypeScript SDK для работы с Code Solver API. Предоставляет простой интерфейс для индексации кода, поиска, работы с чатом и анализа зависимостей.
+JavaScript/TypeScript SDK для работы с Code Solver API. Предоставляет простой интерфейс для индексации кода, семантического поиска функций и работы с AI чатом.
 
 ## 🎯 Основные возможности
 
 - **💬 Chat API** - взаимодействие с AI моделями (Claude, GPT)
-- **🔍 Code Search** - семантический поиск по коду
+- **🔍 Code Search** - семантический поиск по коду и функциям
 - **📊 Project Indexing** - индексация и анализ проектов
-- **🕸️ Dependencies** - анализ зависимостей кода
 - **📝 Context API** - получение контекста для AI
 - **🛠️ Code Modification** - модификация кода через AI
 
@@ -26,46 +25,34 @@ npm install solver-sdk
 import { CodeSolverSDK } from 'solver-sdk';
 
 // Создание SDK
-const sdk = new CodeSolverSDK({
-  baseURL: 'https://your-api-server.com',
-  apiKey: 'your-api-key',
-  timeout: 30000
+const sdk = await CodeSolverSDK.create({
+  baseURL: 'http://localhost:3000'
 });
 
-// Проверка здоровья API
-const isHealthy = await sdk.checkHealth();
-console.log('API доступен:', isHealthy);
-
-// Создание проекта
-const project = await sdk.projects.createProject({
-  name: 'My Project',
-  path: '/path/to/project',
-  description: 'Описание проекта'
-});
-
-// Индексация проекта
-const indexingResult = await sdk.indexing.indexProject(
+// Создание и индексация проекта
+const project = await sdk.projects.findOrCreateProject(
   '/path/to/project',
   'My Project'
 );
 
-// Ожидание завершения индексации
-const finalStatus = await sdk.indexing.waitForCompletion(indexingResult.projectId);
+await sdk.projects.startIndexing(project.id);
 
 // Поиск кода
-const searchResults = await sdk.search.searchCode({
-  projectId: project.projectId,
+const searchResults = await sdk.search.searchCode(project.id, {
   query: 'function calculateSum',
-  maxResults: 10
+  limit: 10
+});
+
+// Поиск функций
+const functions = await sdk.search.searchFunctions(project.id, {
+  query: 'FileIndexingService',
+  limit: 5
 });
 
 // Работа с чатом
 const response = await sdk.chat.chat([
   { role: 'user', content: 'Объясни этот код' }
-], {
-  model: 'claude-3-5-sonnet-20241022',
-  maxTokens: 8192
-});
+], { projectId: project.id });
 ```
 
 ## 📋 API Методы
@@ -96,66 +83,60 @@ await sdk.projects.startIndexing(project.id);
 const status = await sdk.projects.getProjectStatus(project.id);
 
 // Ожидание завершения индексации
-while (status.indexStatus !== 'complete') {
+while (true) {
+  const status = await sdk.projects.getProjectStatus(project.id);
+  if (status.status === 'ready') break;
+  if (status.status === 'error') throw new Error('Ошибка индексации');
   await new Promise(resolve => setTimeout(resolve, 2000));
-  status = await sdk.projects.getProjectStatus(project.id);
 }
 ```
 
 ### 🔍 Search API
 ```javascript
 // Поиск кода
-await sdk.search.searchCode({
-  projectId: 'project-id',
+await sdk.search.searchCode(projectId, {
   query: 'search query',
-  maxResults: 20
+  limit: 20
 });
 ```
 
 ### 💬 Chat API
 ```javascript
-// Обычный чат
+// Обычный чат (projectId ОБЯЗАТЕЛЕН!)
 const response = await sdk.chat.chat([
   { role: 'user', content: 'Объясни этот код' }
-], {
-  model: 'claude-3-5-sonnet-20241022',
-  maxTokens: 8192
-});
+], { projectId: 'your-project-id' });
 
 // Потоковый чат
-for await (const chunk of sdk.chat.streamChat(messages, options)) {
+for await (const chunk of sdk.chat.streamChat(messages, { projectId: 'your-project-id' })) {
   console.log(chunk.text);
 }
 ```
 
-### 🕸️ Dependencies API  
-```javascript
-// Граф зависимостей
-await sdk.dependencies.getDependencyGraph(projectId);
-
-// Статистика зависимостей
-await sdk.dependencies.getDependencyStatistics(projectId);
-```
-
 ## ⚙️ Конфигурация
 
 ```javascript
-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                            // Отладочная информация
+const sdk = await CodeSolverSDK.create({
+  baseURL: 'http://localhost:3000',     // Обязательный
+  apiKey: 'your-api-key',               // Рекомендуется
+  timeout: 30000,                       // Таймаут запросов
+  debug: false                          // Отладка
 });
 ```
 
+**⚠️ Важно**: Для Chat API **обязательно** нужен `projectId`:
+```javascript
+// ❌ НЕ РАБОТАЕТ
+const response = await sdk.chat.chat(messages);
+
+// ✅ ПРАВИЛЬНО  
+const response = await sdk.chat.chat(messages, { projectId: 'your-project-id' });
+
+// 💡 Получить projectId можно так:
+const projects = await sdk.projects.getReadyProjects();
+const projectId = projects[0].id;
+```
+
 ## 🧪 Тестирование
 
 ```bash
@@ -180,18 +161,16 @@ npm test -- --testPathPattern="indexing"
 import { CodeSolverSDK } from 'solver-sdk';
 
 async function fullWorkflow() {
-  const sdk = new CodeSolverSDK({
-    baseURL: 'http://localhost:3001',
-    apiKey: 'your-api-key'
+  const sdk = await CodeSolverSDK.create({
+    baseURL: 'http://localhost:3000'
   });
   
   try {
     // 1. Создаем проект
-    const project = await sdk.projects.createProject({
-      name: 'My React App',
-      path: '/path/to/react-app',
-      description: 'React приложение для анализа'
-    });
+    const project = await sdk.projects.findOrCreateProject(
+      '/path/to/react-app',
+      'My React App'
+    );
   
     // 2. Запускаем индексацию
     console.log('Запуск индексации...');
@@ -201,40 +180,33 @@ async function fullWorkflow() {
     console.log('Ожидание завершения индексации...');
     while (true) {
       const status = await sdk.projects.getProjectStatus(project.id);
-      if (status.indexStatus === 'complete') break;
+      if (status.status === 'ready') break;
+      if (status.status === 'error') throw new Error('Ошибка индексации');
       await new Promise(resolve => setTimeout(resolve, 2000));
     }
 
     // 4. Ищем React компоненты
-    const components = await sdk.search.searchCode({
-      projectId: project.id,
+    const components = await sdk.search.searchCode(project.id, {
       query: 'React.Component class',
-      maxResults: 10
+      limit: 10
     });
-        
-    // 5. Анализируем зависимости
-    const dependencies = await sdk.dependencies.getDependencyGraph(project.id);
 
-    // 6. Задаем вопрос AI о коде
+    // 5. Задаем вопрос AI о коду
     const aiResponse = await sdk.chat.chat([
       {
         role: 'user',
         content: `Проанализируй найденные React компоненты: ${JSON.stringify(components)}`
       }
-    ], {
-           model: 'claude-3-5-sonnet-20241022',
-     maxTokens: 8192
-    });
+    ], { projectId: project.id });
     
     console.log('✅ Анализ завершен');
     console.log('📊 Компоненты:', components.length);
-    console.log('🕸️ Зависимости:', dependencies);
-    console.log('🤖 AI анализ:', aiResponse.content[0].text);
+    console.log('🤖 AI анализ:', aiResponse.content);
 
   } catch (error) {
     console.error('❌ Ошибка:', error.message);
-    }
   }
+}
 
 fullWorkflow();
 ```
@@ -243,50 +215,43 @@ fullWorkflow();
 
 ### Проблемы с подключением
 ```javascript
-// Диагностика API
-const diagnosis = await sdk.diagnoseAPI();
-console.log('Диагностика:', diagnosis);
-
-// Проверка здоровья конкретных эндпоинтов
-if (!diagnosis.healthy) {
-  console.log('Проблемные эндпоинты:', diagnosis.errors);
-}
+// Проверка здоровья API
+const isHealthy = await sdk.checkHealth();
+console.log('API доступен:', isHealthy);
 ```
 
 ### Таймауты и повторы
 ```javascript
 // Увеличение таймаутов для больших проектов
-const sdk = new CodeSolverSDK({
-  baseURL: 'https://api.example.com',
-  timeout: 120000,  // 2 минуты
-  http: {
-    timeout: 90000,
-    retries: 5,
-    retryDelay: 2000
-  }
+const sdk = await CodeSolverSDK.create({
+  baseURL: 'http://localhost:3000',
+  timeout: 120000  // 2 минуты
 });
 ```
 
-## 📝 Changelog v3.0
+## 📝 Changelog v3.1.2
 
 ### ✅ Добавлено
-- Полная поддержка HTTP-only API
-- Новый `IndexingClient` для простой индексации 
-- Улучшенная обработка ошибок
-- Подробная диагностика API
-- Потоковый чат через HTTP
+- Поиск функций через `/search/functions` API
+- Методы `searchFunctions()` и `searchFunctionsGet()`
+- Статистика функций `getFunctionStats()`
+- Автоматический выбор модели и токенов на бэкенде
+- Упрощенные Chat API без параметров модели
 
 ### ❌ Удалено
-- Поддержка WebSocket (полностью удалена)
-- `socket.io-client` зависимость
-- WebSocket события и обработчики
-- Сложные WebSocket конфигурации
+- `AgentsApi` - больше не используется
+- `DependenciesApi` - работает внутренне
+- `simple-indexing-client.ts` - дублировал ProjectsApi
+- Все устаревшие методы и примеры
+- Ручной выбор модели и лимитов токенов клиентом
 
 ### 🔄 Изменено
-- Все API методы теперь работают через HTTP
-- Упрощенная конфигурация SDK
-- Более быстрая инициализация
-- Лучшая совместимость с разными средами
+- Обновлены все примеры кода на актуальный синтаксис
+- Упрощена документация в один файл
+- Исправлены пути API с префиксом `/api/v1`
+- Улучшена обработка ошибок индексации
+- Chat API упрощен - модель выбирается автоматически
+- Полная синхронизация документации с реальным кодом
 
 ## 📄 Лицензия
 
@@ -378,9 +343,14 @@ export async function activate(context: vscode.ExtensionContext) {
     const projects = await sdk.projects.getReadyProjects();
     if (projects.length === 0) return;
     
-    const results = await sdk.search.searchFunctions(projects[0].id, { query, limit: 20 });
+    const response = await sdk.search.searchFunctions(projects[0].id, { query, limit: 20 });
+    
+    if (!response.success || response.results.length === 0) {
+      vscode.window.showInformationMessage('Функции не найдены');
+      return;
+    }
     
-    const items = results.results.map(fn => ({
+    const items = response.results.map(fn => ({
       label: fn.name,
       description: fn.signature,
       detail: `${fn.filePath}:${fn.startLine}`,
@@ -413,7 +383,7 @@ export async function activate(context: vscode.ExtensionContext) {
       { "command": "extension.searchFunctions", "title": "🔍 Поиск функций" }
     ]
   },
-  "dependencies": { "solver-sdk": "^3.1.0" }
+  "dependencies": { "solver-sdk": "^3.1.2" }
 }
 ```
 

package/dist/cjs/code-solver-sdk.js

@@ -10,7 +10,7 @@ const code_modification_api_js_1 = require("./api/code-modification-api.js");
 const index_js_1 = require("./api/chat-api/index.js");
 const models_api_js_1 = require("./api/models-api.js");
 // Версия SDK
-const SDK_VERSION = '3.0.0';
+const SDK_VERSION = '3.1.2';
 /**
  * Определение типа среды выполнения
  * @returns 'browser' | 'node' | 'unknown'

package/dist/cjs/index.js

@@ -20,7 +20,7 @@ Object.defineProperty(exports, "CodeSolverSDK", { enumerable: true, get: functio
 const http_client_js_1 = require("./utils/http-client.js");
 Object.defineProperty(exports, "HttpClient", { enumerable: true, get: function () { return http_client_js_1.HttpClient; } });
 // Версия SDK
-exports.VERSION = '3.1.1';
+exports.VERSION = '3.1.2';
 // Экспортируем основные интерфейсы и типы
 __exportStar(require("./interfaces/sdk-options.js"), exports);
 // Экспортируем HTTP API клиенты

package/dist/esm/code-solver-sdk.js

@@ -7,7 +7,7 @@ import { CodeModificationApi } from './api/code-modification-api.js';
 import { ChatApi } from './api/chat-api/index.js';
 import { ModelsApi } from './api/models-api.js';
 // Версия SDK
-const SDK_VERSION = '3.0.0';
+const SDK_VERSION = '3.1.2';
 /**
  * Определение типа среды выполнения
  * @returns 'browser' | 'node' | 'unknown'

package/dist/esm/index.js

@@ -1,7 +1,7 @@
 import { CodeSolverSDK } from './code-solver-sdk.js';
 import { HttpClient } from './utils/http-client.js';
 // Версия SDK
-export const VERSION = '3.1.1';
+export const VERSION = '3.1.2';
 // Экспортируем основные классы и интерфейсы
 export { CodeSolverSDK };
 export { HttpClient };

package/dist/types/index.d.ts

@@ -1,7 +1,7 @@
 import { CodeSolverSDK } from './code-solver-sdk.js';
 import { CodeSolverSDKOptions } from './interfaces/sdk-options.js';
 import { HttpClient } from './utils/http-client.js';
-export declare const VERSION = "3.1.1";
+export declare const VERSION = "3.1.2";
 export { CodeSolverSDK };
 export { CodeSolverSDKOptions };
 export { HttpClient };

package/package.json

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