solver-sdk 2.6.2 → 2.7.0

package/docs/API_REFERENCE.md

@@ -1,703 +0,0 @@
-# API Reference v2.5.0
-
-В этом документе описаны основные классы и методы AI Solver SDK v2.5.0.
-
-## Содержание
-
-- [CodeSolverSDK](#codesolversdk)
-- [ProjectsApi](#projectsapi)
-- [ReasoningApi](#reasoningapi)
-- [ChatApi](#chatapi)
-- [SearchApi](#searchapi)
-- [Helper Functions](#helper-functions)
-
-## CodeSolverSDK
-
-Основной класс SDK, предоставляющий доступ ко всем API.
-
-### Статический создатель (Рекомендуемый)
-
-```javascript
-const sdk = CodeSolverSDK.create(options);
-```
-
-### Параметры
-
-| Параметр | Тип | Описание | Обязательно | По умолчанию |
-|----------|-----|----------|-------------|--------------|
-| `baseURL` | string | Базовый URL API | Да | - |
-| `apiKey` | string | API ключ для авторизации | Да | - |
-| `autoConnect` | boolean | Автоматическое подключение WebSocket | Нет | false |
-| `timeout` | number | Таймаут для HTTP запросов (мс) | Нет | 30000 |
-| `headers` | object | Дополнительные HTTP заголовки | Нет | {} |
-| `wsURL` | string | URL для WebSocket (если отличается) | Нет | baseURL |
-
-### Методы
-
-#### `diagnoseAPI()`
-
-Проверяет доступность всех API endpoints.
-
-```javascript
-const results = await sdk.diagnoseAPI();
-console.log('Endpoints status:', results);
-// Возвращает объект с результатами проверки каждого endpoint
-```
-
-#### `diagnoseFull()`
-
-Детальная диагностика API и WebSocket.
-
-```javascript
-const detailed = await sdk.diagnoseFull();
-console.log('Full diagnostics:', detailed);
-```
-
-#### `diagnoseWebSocket()`
-
-Проверяет статус WebSocket соединений.
-
-```javascript
-const wsStatus = await sdk.diagnoseWebSocket();
-console.log('WebSocket status:', wsStatus);
-```
-
-#### `updateOptions(newOptions)`
-
-Обновляет настройки SDK.
-
-```javascript
-sdk.updateOptions({
-  apiKey: 'new-api-key',
-  timeout: 60000
-});
-```
-
-## ChatApi
-
-API для работы с чатом и AI-моделями.
-
-### Методы
-
-#### `chat(messages, options)`
-
-Отправляет запрос чата и возвращает полный ответ.
-
-```javascript
-const response = await sdk.chat.chat([
-  { role: 'user', content: 'Привет, как дела?' }
-], {
-  model: 'claude-3-7-sonnet-20240229'
-});
-```
-
-#### `streamChat(messages, options, callback)`
-
-Отправляет запрос чата и получает ответ в потоковом режиме.
-
-```javascript
-await sdk.chat.streamChat(
-  [{ role: 'user', content: 'Объясни JavaScript' }],
-  { model: 'claude-3-7-sonnet-20240229' },
-  (chunk) => console.log(chunk)
-);
-```
-
-#### `streamChatWithThinking(messages, options, callback)`
-
-Отправляет запрос чата с получением промежуточных шагов мышления.
-
-```javascript
-await sdk.chat.streamChatWithThinking(
-  [{ role: 'user', content: 'Объясни принцип работы реактивного программирования' }],
-  { 
-    model: 'claude-3-7-sonnet-20240229',
-    thinking: true 
-  },
-  (eventType, data) => {
-    if (eventType === 'thinking_delta') {
-      console.log('Мышление:', data.thinking);
-    } else if (eventType === 'text_delta') {
-      console.log('Ответ:', data.text);
-    }
-  }
-);
-```
-
-#### `connectWebSocket()`
-
-Подключается к WebSocket для событий чата.
-
-```javascript
-await sdk.chat.connectWebSocket();
-```
-
-## ProjectsApi
-
-API для работы с проектами. Доступен через `sdk.projects`.
-
-### Методы
-
-#### `create(projectData)`
-
-Создает новый проект.
-
-```javascript
-const project = await sdk.projects.create({
-  name: 'My Project',
-  path: '/path/to/project',
-  description: 'Optional description'
-});
-
-// Возвращает объект проекта с id, name, path, статусами и метаданными
-```
-
-#### `get(projectId)`
-
-Получает информацию о проекте по ID.
-
-```javascript
-const project = await sdk.projects.get('project-id');
-```
-
-#### `getAll()`
-
-Получает список всех проектов.
-
-```javascript
-const projects = await sdk.projects.getAll();
-// Возвращает { projects: Array, total: number }
-```
-
-#### `startIndexing(projectId)`
-
-Запускает индексацию проекта.
-
-```javascript
-await sdk.projects.startIndexing('project-id');
-// Возвращает { message: 'Индексация запущена', projectId, status: 'accepted' }
-```
-
-#### `getIndexingStatus(projectId)`
-
-Получает статус индексации проекта.
-
-```javascript
-const status = await sdk.projects.getIndexingStatus('project-id');
-// Возвращает { projectId, indexStatus, indexingProgress, filesIndexed, lastUpdated }
-```
-
-### WebSocket методы
-
-#### `connectWebSocket()`
-
-Подключается к WebSocket для отслеживания событий проектов.
-
-```javascript
-await sdk.projects.connectWebSocket();
-```
-
-#### `disconnectWebSocket()`
-
-Отключается от WebSocket.
-
-```javascript
-await sdk.projects.disconnectWebSocket();
-```
-
-### Event методы
-
-#### `onIndexingProgress(callback)`
-
-Отслеживает прогресс индексации.
-
-```javascript
-sdk.projects.onIndexingProgress((data) => {
-  console.log(`Progress: ${data.percentage}%`);
-  console.log(`Files: ${data.processedFiles}/${data.totalFiles}`);
-});
-```
-
-#### `onIndexingComplete(callback)`
-
-Событие завершения индексации.
-
-```javascript
-sdk.projects.onIndexingComplete((data) => {
-  console.log('Indexing completed:', data.projectId);
-  console.log('Total files:', data.totalFiles);
-});
-```
-
-#### `onIndexingError(callback)`
-
-Событие ошибки индексации.
-
-```javascript
-sdk.projects.onIndexingError((error) => {
-  console.error('Indexing error:', error.message);
-});
-```
-
-### Алиасы для совместимости
-
-```javascript
-// Старые методы (deprecated, но работают)
-await sdk.projects.createProject(name, path, options); // → create()
-await sdk.projects.indexProject(projectId);            // → startIndexing()
-await sdk.projects.getProject(projectId);              // → get()
-await sdk.projects.getAllProjects();                   // → getAll()
-```
-
-## SearchApi
-
-API для семантического поиска кода. Доступен через `sdk.search`.
-
-### Методы
-
-#### `searchProject(projectId, options)`
-
-Выполняет семантический поиск в проекте (POST запрос).
-
-```javascript
-const results = await sdk.search.searchProject('project-id', {
-  query: 'функция для обработки HTTP запросов',
-  limit: 10,
-  minScore: 0.7
-});
-
-// Возвращает массив результатов с релевантностью и фрагментами кода
-```
-
-#### `searchProjectGet(projectId, query, options)`
-
-Выполняет поиск через GET запрос с параметрами URL.
-
-```javascript
-const results = await sdk.search.searchProjectGet(
-  'project-id',
-  'поиск по коду',
-  { limit: 10 }
-);
-```
-
-### Алиасы для совместимости
-
-```javascript
-// Старые методы (deprecated, но работают)
-await sdk.search.searchCode(projectId, options);     // → searchProject()
-await sdk.search.semanticSearch(projectId, options); // → searchProject()
-```
-
-## ChatApi
-
-API для взаимодействия с AI чатом и Claude 4 thinking. Доступен через `sdk.chat`.
-
-### Методы
-
-#### `send(messages, options)`
-
-Отправляет сообщения в чат и получает ответ.
-
-```javascript
-const response = await sdk.chat.send([
-  {
-    role: 'user',
-    content: 'Объясни как работает эта функция'
-  }
-], {
-  projectId: 'project-id',
-  model: 'claude-3-5-sonnet-20241022'
-});
-
-console.log(response.content);
-```
-
-#### `stream(messages, options, onChunk)`
-
-Отправляет сообщения с потоковой передачей ответа.
-
-```javascript
-await sdk.chat.stream(
-  messages,
-  {
-    projectId: 'project-id',
-    model: 'claude-3-5-sonnet-20241022',
-    thinking: true
-  },
-  (chunk) => {
-    console.log('Chunk received:', chunk);
-  }
-);
-```
-
-### Thinking Support (Claude 4)
-
-#### С thinking блоками
-
-```javascript
-await sdk.chat.stream(
-  messages,
-  {
-    thinking: true,
-    tool_choice: { type: 'auto' } // Только auto/none с thinking
-  },
-  (eventType, data) => {
-    switch (eventType) {
-      case 'thinking_delta':
-        console.log('Thinking:', data.thinking);
-        break;
-      case 'text_delta':
-        console.log('Text:', data.text);
-        break;
-      case 'tool_use':
-        console.log('Tool:', data.tool_name);
-        break;
-    }
-  }
-);
-```
-
-### Complex Content Support
-
-```javascript
-const complexMessage = {
-  role: 'user',
-  content: [
-    { type: 'text', text: 'Анализируй этот код:' },
-    { type: 'text', text: 'function example() { return 42; }' }
-  ]
-};
-
-const response = await sdk.chat.send([complexMessage], options);
-```
-
-### WebSocket методы
-
-#### `connectWebSocket()`
-
-Подключается к WebSocket для потокового чата.
-
-```javascript
-await sdk.chat.connectWebSocket();
-```
-
-#### `disconnectWebSocket()`
-
-Отключается от chat WebSocket.
-
-```javascript
-await sdk.chat.disconnectWebSocket();
-```
-
-### Event методы
-
-#### `onTextDelta(callback)`
-
-Событие получения текстового фрагмента.
-
-```javascript
-sdk.chat.onTextDelta((text) => {
-  console.log('Text delta:', text);
-});
-```
-
-#### `onThinkingDelta(callback)`
-
-Событие получения thinking фрагмента.
-
-```javascript
-sdk.chat.onThinkingDelta((thinking) => {
-  console.log('Thinking delta:', thinking);
-});
-```
-
-#### `onToolUse(callback)`
-
-Событие использования инструмента.
-
-```javascript
-sdk.chat.onToolUse((tool) => {
-  console.log('Tool used:', tool.name, tool.input);
-});
-```
-
-#### `onMessageComplete(callback)`
-
-Событие завершения сообщения.
-
-```javascript
-sdk.chat.onMessageComplete((message) => {
-  console.log('Message completed:', message);
-});
-```
-
-### Поддерживаемые модели
-
-```javascript
-const models = [
-  'claude-3-5-sonnet-20241022',
-  'claude-3-5-haiku-20241022',
-  'claude-3-opus-20240229'
-];
-```
-
-## ReasoningApi
-
-API для работы с AI reasoning процессами. Доступен через `sdk.reasoning`.
-
-### Методы
-
-#### `create(reasoningData)`
-
-Создаёт новый reasoning процесс.
-
-```javascript
-const reasoning = await sdk.reasoning.create({
-  projectId: 'project-id',
-  query: 'Проанализируй архитектуру этого проекта'
-});
-
-// Возвращает объект reasoning с id, projectId, query, status
-```
-
-#### `get(reasoningId)`
-
-Получает информацию о reasoning процессе.
-
-```javascript
-const reasoning = await sdk.reasoning.get('reasoning-id');
-```
-
-#### `getByProject(projectId)`
-
-Получает все reasoning процессы проекта.
-
-```javascript
-const reasonings = await sdk.reasoning.getByProject('project-id');
-// Возвращает массив всех reasoning процессов проекта
-```
-
-#### `start(reasoningId)`
-
-Запускает reasoning процесс.
-
-```javascript
-await sdk.reasoning.start('reasoning-id');
-// Возвращает { message: 'Reasoning процесс запущен', id: reasoningId }
-```
-
-#### `stop(reasoningId)`
-
-Останавливает reasoning процесс.
-
-```javascript
-await sdk.reasoning.stop('reasoning-id');
-// Возвращает { message: 'Reasoning процесс остановлен', id: reasoningId }
-```
-
-### WebSocket методы
-
-#### `connectWebSocket()`
-
-Подключается к WebSocket для отслеживания reasoning событий.
-
-```javascript
-await sdk.reasoning.connectWebSocket();
-```
-
-#### `disconnectWebSocket()`
-
-Отключается от reasoning WebSocket.
-
-```javascript
-await sdk.reasoning.disconnectWebSocket();
-```
-
-### Event методы
-
-#### `onReasoningStarted(callback)`
-
-Событие начала reasoning процесса.
-
-```javascript
-sdk.reasoning.onReasoningStarted((data) => {
-  console.log('Reasoning started:', data.id);
-  console.log('Query:', data.query);
-});
-```
-
-#### `onReasoningProgress(callback)`
-
-Отслеживает прогресс reasoning.
-
-```javascript
-sdk.reasoning.onReasoningProgress((data) => {
-  console.log('Progress:', data.progress);
-  console.log('Current step:', data.currentStep);
-});
-```
-
-#### `onReasoningCompleted(callback)`
-
-Событие завершения reasoning.
-
-```javascript
-sdk.reasoning.onReasoningCompleted((data) => {
-  console.log('Reasoning completed:', data.id);
-  console.log('Results:', data.results);
-});
-```
-
-#### `onReasoningError(callback)`
-
-Событие ошибки reasoning.
-
-```javascript
-sdk.reasoning.onReasoningError((error) => {
-  console.error('Reasoning error:', error.message);
-});
-```
-
-### Алиасы для совместимости
-
-```javascript
-// Новые алиасы методов (v2.5.0)
-await sdk.reasoning.create(data);      // основной метод
-await sdk.reasoning.start(id);         // основной метод
-await sdk.reasoning.stop(id);          // основной метод
-
-// Старые методы (deprecated, но работают)
-await sdk.reasoning.createReasoning(data);  // → create()
-await sdk.reasoning.startReasoning(id);     // → start()
-await sdk.reasoning.stopReasoning(id);      // → stop()
-```
-
-## Helper Functions
-
-Вспомогательные функции для работы с сообщениями и инструментами.
-
-### Message Helpers
-
-#### `createComplexAssistantMessage(textContent, thinkingBlocks, toolUseBlocks)`
-
-Создает сложное assistant сообщение с thinking и tool blocks.
-
-```javascript
-import { createComplexAssistantMessage } from '@ai-solver/sdk';
-
-const message = createComplexAssistantMessage(
-  'Вот анализ кода:',
-  ['thinking block 1', 'thinking block 2'],
-  [{ type: 'tool_use', name: 'read_file', input: { path: 'app.js' } }]
-);
-```
-
-#### `createToolResultMessage(toolUseId, isError, content)`
-
-Создает сообщение с результатом выполнения инструмента.
-
-```javascript
-import { createToolResultMessage } from '@ai-solver/sdk';
-
-const resultMessage = createToolResultMessage(
-  'tool_use_123',
-  false,
-  'File contents: console.log("Hello");'
-);
-```
-
-#### `extractThinkingBlocks(message)`
-
-Извлекает thinking блоки из сообщения.
-
-```javascript
-import { extractThinkingBlocks } from '@ai-solver/sdk';
-
-const thinkingBlocks = extractThinkingBlocks(assistantMessage);
-console.log('Thinking blocks:', thinkingBlocks);
-```
-
-#### `extractToolUseBlocks(message)`
-
-Извлекает tool_use блоки из сообщения.
-
-```javascript
-import { extractToolUseBlocks } from '@ai-solver/sdk';
-
-const toolBlocks = extractToolUseBlocks(assistantMessage);
-console.log('Tool blocks:', toolBlocks);
-```
-
-### Tool Helpers
-
-#### `createStandardDevelopmentTools()`
-
-Создает стандартный набор инструментов для разработки (8 инструментов как в Cursor).
-
-```javascript
-import { createStandardDevelopmentTools } from '@ai-solver/sdk';
-
-const tools = createStandardDevelopmentTools();
-// Возвращает массив с инструментами:
-// - read_file
-// - edit_file
-// - create_file
-// - list_directory
-// - search_files
-// - run_command
-// - analyze_code
-// - explain_code
-
-const response = await sdk.chat.stream(messages, {
-  tools: tools,
-  tool_choice: { type: 'auto' }
-});
-```
-
-### Type Definitions
-
-#### `ChatMessage`
-
-```typescript
-interface ChatMessage {
-  role: 'user' | 'assistant' | 'system' | 'tool';
-  content: string | ContentBlock[];
-  name?: string;
-  tool_call_id?: string;
-}
-```
-
-#### `ContentBlock`
-
-```typescript
-interface ContentBlock {
-  type: 'text' | 'tool_use' | 'tool_result' | 'thinking';
-  text?: string;
-  id?: string;
-  name?: string;
-  input?: any;
-  content?: any;
-  is_error?: boolean;
-}
-```
-
-#### `ChatOptions`
-
-```typescript
-interface ChatOptions {
-  projectId?: string;
-  model?: string;
-  thinking?: boolean;
-  tools?: Tool[];
-  tool_choice?: ToolChoice;
-  max_tokens?: number;
-  temperature?: number;
-  stream?: boolean;
-}
-```
-
----
-
-**Документация обновлена для SDK v2.5.0**  
-**Дата обновления:** 28 июня 2025