solver-sdk 1.7.6 → 1.7.8

package/docs/indexing/INDEXING.md

@@ -1,625 +1,231 @@
-# Индексация проектов в Solver SDK
+# Индексация проектов
 
-Данный документ описывает процесс индексации проектов через SDK и отслеживания этого процесса с помощью WebSocket соединений.
+Это руководство описывает, как использовать SDK для индексации проектов и отдельных файлов.
 
-## Содержание
+## Инициализация SDK
 
-- [Введение](#введение)
-- [Быстрый старт](#быстрый-старт)
-- [API для индексации](#api-для-индексации)
-  - [Работа с проектами по ID](#работа-с-проектами-по-id)
-  - [Работа с проектами по пути](#работа-с-проектами-по-пути)
-  - [Инкрементальная индексация](#инкрементальная-индексация)
-- [Отслеживание процесса индексации](#отслеживание-процесса-индексации)
-  - [Подключение к WebSocket](#подключение-к-websocket)
-  - [События WebSocket](#события-websocket)
-- [Сценарии использования](#сценарии-использования)
-  - [Индексация существующего проекта](#индексация-существующего-проекта)
-  - [Создание и индексация проекта по пути](#создание-и-индексация-проекта-по-пути)
-  - [Интеграция с IDE](#интеграция-с-ide)
-  - [Наблюдение за файловой системой](#наблюдение-за-файловой-системой)
-- [Обработка ошибок](#обработка-ошибок)
+Прежде чем использовать функции индексации, необходимо инициализировать SDK с указанием API ключа:
 
-## Введение
-
-Индексация проекта - это процесс сканирования и анализа файлов проекта для дальнейшего поиска и обработки информации. Solver SDK предоставляет набор методов для создания проектов, управления индексацией и отслеживания этого процесса в реальном времени через WebSocket соединения.
-
-## Быстрый старт
-
-Вот простой пример, как создать и проиндексировать проект, используя SDK:
-
-```javascript
+```typescript
 import { CodeSolverSDK } from 'solver-sdk';
-import path from 'path';
 
-// 1. Инициализация SDK
 const sdk = new CodeSolverSDK({
   baseURL: 'https://api.example.com',
-  apiKey: 'your-api-key'
-});
-
-// 2. Создание и индексация проекта
-async function indexMyProject() {
-  try {
-    // Путь к проекту
-    const projectPath = '/path/to/your/project';
-    
-    // Создание и индексация в одной операции
-    const result = await sdk.projects.createAndIndexProject(
-      projectPath,
-      {
-        name: path.basename(projectPath),
-        excludePatterns: ['node_modules', '.git', 'dist']
-      }
-    );
-    
-    console.log(`Проект создан и индексация начата. ID проекта: ${result.projectId}`);
-    
-    // 3. Мониторинг прогресса индексации (опционально)
-    await sdk.projects.connectWebSocket();
-    
-    sdk.projects.on('indexing_progress', (data) => {
-      console.log(`Прогресс индексации: ${data.progress}%`);
-    });
-    
-    sdk.projects.on('indexing_complete', () => {
-      console.log('Индексация успешно завершена!');
-      sdk.projects.disconnectWebSocket();
-    });
-    
-    return result.projectId;
-  } catch (error) {
-    console.error(`Ошибка: ${error.message}`);
-    sdk.projects.disconnectWebSocket();
-    throw error;
-  }
-}
-
-// Запуск индексации
-indexMyProject().then(projectId => {
-  console.log(`Готово! Используйте ID проекта ${projectId} для поиска`);
+  apiKey: 'ваш_api_ключ', // API ключ обязателен для авторизации WebSocket соединений
 });
 ```
 
-## API для индексации
-
-SDK предоставляет два способа работы с проектами: по ID проекта и по пути к проекту на диске.
+## Индексация проекта
 
-### Работа с проектами по ID
+### Запуск индексации
 
-| Метод | Описание |
-|-------|----------|
-| `sdk.projects.indexProject(projectId, options)` | Запускает индексацию проекта |
-| `sdk.projects.stopIndexing(projectId)` | Останавливает индексацию проекта |
-| `sdk.projects.getIndexingStatus(projectId)` | Получает текущий статус индексации |
-| `sdk.projects.updateFileIndex(projectId, filePath, options)` | Обновляет индекс конкретного файла |
+Для запуска индексации проекта используйте метод `indexProject` или его псевдоним `startIndexing`:
 
-#### Запуск и остановка индексации
+```typescript
+// Полная индексация проекта
+await sdk.projects.indexProject('идентификатор_проекта', {
+  indexingMode: 'full'
+});
 
-```javascript
-// Запуск индексации по ID проекта
-const result = await sdk.projects.indexProject(projectId, {
-  forceFull: false, // true для принудительной полной переиндексации
-  includePatterns: ['**/*.js', '**/*.ts'], // glob паттерны для включения файлов
-  excludePatterns: ['**/node_modules/**'] // glob паттерны для исключения файлов
+// Инкрементальная индексация (только изменившиеся файлы)
+await sdk.projects.indexProject('идентификатор_проекта', {
+  indexingMode: 'incremental'
 });
-console.log('Индексация запущена. Задача:', result.taskId);
 
-// Получение статуса индексации
-const status = await sdk.projects.getIndexingStatus(projectId);
-console.log(`Статус: ${status.status}, прогресс: ${status.progress}%`);
+// Автоматический выбор режима индексации (рекомендуется)
+await sdk.projects.indexProject('идентификатор_проекта', {
+  indexingMode: 'auto'
+});
 
-// Остановка индексации
-await sdk.projects.stopIndexing(projectId);
-console.log('Индексация остановлена');
+// Псевдоним startIndexing (работает аналогично indexProject)
+await sdk.projects.startIndexing('идентификатор_проекта', {
+  indexingMode: 'auto'
+});
 ```
 
-### Работа с проектами по пути
+### Режимы индексации
 
-| Метод | Описание |
-|-------|----------|
-| `sdk.projects.getOrCreateProject(path, name?)` | Получает существующий или создает новый проект по пути |
-| `sdk.projects.indexProjectByPath(path, options)` | Запускает индексацию проекта по указанному пути |
-| `sdk.projects.createAndIndexProject(path, options)` | Создает проект и сразу запускает его индексацию |
-| `sdk.projects.ensureProjectExists(projectId, options)` | Проверяет существование проекта и при необходимости создает резервную копию |
+SDK поддерживает следующие режимы индексации:
 
-#### Создание и индексация
+- **full** - полная переиндексация всех файлов проекта
+- **incremental** - индексация только изменившихся файлов (более быстрая)
+- **auto** - автоматический выбор режима на основе метаданных проекта
 
-```javascript
-// Получить проект по пути (создать, если не существует)
-const project = await sdk.projects.getOrCreateProject(
-  '/path/to/project',
-  'Название проекта' // опционально
-);
-console.log(`Проект ID: ${project.id}`);
+Вы также можете использовать флаг `forceFull` для принудительной полной индексации:
 
-// Индексация проекта по пути
-const indexResult = await sdk.projects.indexProjectByPath('/path/to/project', {
-  forceFull: true,  // принудительная полная индексация
-  excludePatterns: ['node_modules', '.git']
+```typescript
+await sdk.projects.indexProject('идентификатор_проекта', {
+  forceFull: true
 });
-console.log(`Индексация запущена для проекта ${indexResult.projectId}`);
+```
 
-// Создание и индексация в одной операции
-const result = await sdk.projects.createAndIndexProject('/path/to/project', {
-  name: 'Мой проект',
-  forceFull: false, 
-  excludePatterns: ['node_modules', '.git']
+### Фильтрация файлов
+
+Можно указать шаблоны включения и исключения файлов:
+
+```typescript
+await sdk.projects.indexProject('идентификатор_проекта', {
+  indexingMode: 'auto',
+  includePatterns: ['**/*.js', '**/*.ts', '**/*.jsx', '**/*.tsx'],
+  excludePatterns: ['**/node_modules/**', '**/dist/**', '**/build/**']
 });
-console.log(`Проект ${result.projectId} создан и индексируется`);
 ```
 
-### Инкрементальная индексация
+## Обновление индекса отдельных файлов
 
-SDK поддерживает инкрементальную индексацию, позволяющую обновлять только изменившиеся файлы.
+Для индексации одного файла используйте метод `updateFileIndex`:
 
-```javascript
-// Обновление индекса файла с передачей содержимого
-const result = await sdk.projects.updateFileIndex(
-  projectId,
-  'src/components/App.js',
+```typescript
+// Индексация файла с чтением его содержимого с диска
+await sdk.projects.updateFileIndex(
+  'идентификатор_проекта',
+  'путь/к/файлу.js'
+);
+
+// Индексация с передачей содержимого файла
+await sdk.projects.updateFileIndex(
+  'идентификатор_проекта',
+  'путь/к/файлу.js',
   {
-    content: 'console.log("Hello World");', // содержимое файла
-    force: false // true для принудительного обновления
+    content: 'содержимое файла',
+    force: true // Принудительная индексация, даже если файл не изменился
   }
 );
 
-console.log(`Файл ${result.filePath} проиндексирован`);
-console.log(`Метаданные файла:`, result.fileIndex);
-
-// Обновление индекса без передачи содержимого
-// SDK прочитает файл с диска
-const result2 = await sdk.projects.updateFileIndex(projectId, 'src/utils/helper.js');
-```
-
-#### Пакетное обновление
-
-```javascript
-// Обновление нескольких файлов
-const filesToUpdate = [
-  { path: 'src/components/App.js' },
-  { path: 'src/utils/helpers.js', content: 'export function helper() {}' }
-];
-
-const results = await Promise.all(
-  filesToUpdate.map(file => 
-    sdk.projects.updateFileIndex(projectId, file.path, { content: file.content })
-  )
+// С дополнительными опциями
+await sdk.projects.updateFileIndex(
+  'идентификатор_проекта',
+  'путь/к/файлу.ts',
+  {
+    content: 'содержимое файла',
+    language: 'typescript', // Явное указание языка
+    updateDependencies: true // Обновление зависимостей после индексации
+  }
 );
-
-console.log(`Обновлено ${results.length} файлов`);
 ```
 
-## Отслеживание процесса индексации
-
-SDK предоставляет мощный механизм отслеживания процесса индексации в реальном времени через WebSocket соединения.
+## Работа с новыми проектами
 
-### Подключение к WebSocket
-
-```javascript
-// Подключение к WebSocket для событий индексации
-await sdk.projects.connectWebSocket();
+### Создание и индексация проекта
 
-// Проверка успешного подключения
-if (sdk.projects.isWebSocketConnected()) {
-  console.log('Успешно подключено к WebSocket');
-} else {
-  console.error('Не удалось подключиться к WebSocket');
-}
-
-// Установка обработчиков событий
-sdk.projects.on('indexing_start', (data) => {
-  console.log(`Индексация началась для проекта: ${data.projectId}`);
+```typescript
+// Создание проекта и немедленная индексация
+const result = await sdk.projects.createAndIndexProject('/путь/к/проекту', {
+  name: 'Название проекта',
+  indexingMode: 'full',
+  excludePatterns: ['**/node_modules/**', '**/dist/**']
 });
 
-sdk.projects.on('indexing_progress', (data) => {
-  console.log(`Прогресс: ${data.progress}% (${data.indexedFiles}/${data.totalFiles} файлов)`);
-});
+console.log(`Проект создан с ID: ${result.projectId}`);
+console.log(`Статус индексации: ${result.indexingStatus}`);
+```
 
-sdk.projects.on('indexing_complete', (data) => {
-  console.log(`Индексация завершена! Проиндексировано ${data.indexedFiles} файлов`);
-  sdk.projects.disconnectWebSocket(); // Отключение от WebSocket
-});
+### Поиск или создание проекта
+
+```typescript
+// Найти существующий проект или создать новый
+const project = await sdk.projects.getOrCreateProject('/путь/к/проекту', 'Название проекта');
+console.log(`ID проекта: ${project.id}`);
 
-sdk.projects.on('indexing_error', (data) => {
-  console.error(`Ошибка индексации: ${data.message}`);
-  sdk.projects.disconnectWebSocket();
+// После получения проекта можно запустить индексацию
+await sdk.projects.indexProject(project.id, {
+  indexingMode: 'auto'
 });
 ```
 
-### События WebSocket
-
-| Событие | Описание | Данные |
-|---------|----------|--------|
-| `indexing_start` | Начало процесса индексации | `{ projectId: string }` |
-| `indexing_progress` | Обновление прогресса | `{ projectId: string, totalFiles: number, indexedFiles: number, progress: number, startTime: string, elapsedTime: number, estimatedTimeRemaining?: number }` |
-| `indexing_complete` | Завершение индексации | `{ projectId: string, totalFiles: number, indexedFiles: number, skippedFiles: number, startTime: string, endTime: string, totalTime: number }` |
-| `indexing_error` | Ошибка индексации | `{ projectId: string, message: string, code?: string, details?: any }` |
-| `file_indexed` | Файл проиндексирован | `{ projectId: string, filePath: string, fileIndex: object }` |
-| `file_index_error` | Ошибка индексации файла | `{ projectId: string, filePath: string, message: string }` |
-
-## Сценарии использования
-
-### Индексация существующего проекта
-
-Пример полного процесса индексации с использованием Promise:
-
-```javascript
-async function indexProject(projectId) {
-  return new Promise(async (resolve, reject) => {
-    try {
-      // Подключение к WebSocket
-      await sdk.projects.connectWebSocket();
-      
-      // Создаем объект для отслеживания прогресса
-      const progress = {
-        started: false,
-        percentage: 0,
-        filesIndexed: 0,
-        totalFiles: 0
-      };
-      
-      // Установка обработчиков
-      sdk.projects.on('indexing_start', () => {
-        progress.started = true;
-        console.log('Индексация началась');
-      });
-      
-      sdk.projects.on('indexing_progress', (data) => {
-        progress.percentage = data.progress;
-        progress.filesIndexed = data.indexedFiles;
-        progress.totalFiles = data.totalFiles;
-        console.log(`Прогресс: ${data.progress}%`);
-      });
-      
-      sdk.projects.on('indexing_complete', (data) => {
-        console.log('Индексация завершена!');
-        sdk.projects.disconnectWebSocket();
-        resolve({
-          success: true,
-          projectId,
-          stats: {
-            totalFiles: data.totalFiles,
-            indexedFiles: data.indexedFiles,
-            totalTime: data.totalTime
-          }
-        });
-      });
-      
-      sdk.projects.on('indexing_error', (error) => {
-        console.error(`Ошибка: ${error.message}`);
-        sdk.projects.disconnectWebSocket();
-        reject(new Error(error.message));
-      });
-      
-      // Запуск индексации
-      await sdk.projects.indexProject(projectId);
-      console.log('Запрос на индексацию отправлен');
-      
-      // Таймаут для защиты от зависания
-      setTimeout(() => {
-        if (!progress.started || progress.percentage < 100) {
-          sdk.projects.disconnectWebSocket();
-          reject(new Error('Таймаут индексации'));
-        }
-      }, 300000); // 5 минут
-    } catch (error) {
-      sdk.projects.disconnectWebSocket();
-      reject(error);
-    }
-  });
-}
-
-// Использование
-indexProject('your-project-id')
-  .then(result => console.log('Результат:', result))
-  .catch(error => console.error('Ошибка:', error));
-```
+## Управление индексацией
 
-### Создание и индексация проекта по пути
-
-```javascript
-async function createAndIndexProjectByPath(projectPath, options = {}) {
-  try {
-    // Подключение к WebSocket
-    await sdk.projects.connectWebSocket();
-    
-    // Установка обработчиков
-    const cleanup = () => sdk.projects.disconnectWebSocket();
-    
-    sdk.projects.on('indexing_progress', (data) => {
-      console.log(`Прогресс: ${data.progress}%`);
-    });
-    
-    sdk.projects.on('indexing_error', (error) => {
-      console.error(`Ошибка: ${error.message}`);
-      cleanup();
-    });
-    
-    // Создание и индексация проекта
-    const result = await sdk.projects.createAndIndexProject(
-      projectPath,
-      {
-        name: options.name || path.basename(projectPath),
-        forceFull: options.forceFull || false,
-        excludePatterns: options.excludePatterns || ['node_modules', '.git']
-      }
-    );
-    
-    console.log(`Проект создан, ID: ${result.projectId}`);
-    
-    // Ожидание завершения индексации
-    return new Promise((resolve, reject) => {
-      sdk.projects.on('indexing_complete', (data) => {
-        console.log('Индексация завершена успешно!');
-        cleanup();
-        resolve({
-          projectId: result.projectId,
-          indexingStats: data
-        });
-      });
-      
-      // Таймаут
-      setTimeout(() => {
-        cleanup();
-        reject(new Error('Таймаут ожидания индексации'));
-      }, 300000); // 5 минут
-    });
-  } catch (error) {
-    sdk.projects.disconnectWebSocket();
-    throw error;
-  }
-}
+### Проверка статуса индексации
 
-// Использование
-createAndIndexProjectByPath('/path/to/project')
-  .then(result => console.log(`Проект ${result.projectId} успешно создан и проиндексирован`))
-  .catch(error => console.error(`Ошибка: ${error.message}`));
+```typescript
+// Получение текущего статуса индексации
+const status = await sdk.projects.getIndexingStatus('идентификатор_проекта');
+console.log(`Статус: ${status.status}`);
+console.log(`Количество файлов: ${status.fileCount}`);
+console.log(`Статистика по языкам:`, status.languageStats);
 ```
 
-### Интеграция с IDE
-
-Пример интеграции в расширение VS Code/Cursor:
+### Отмена индексации
 
-```javascript
-// Инициализация SDK в расширении
-const sdk = new CodeSolverSDK({
-  baseURL: 'https://api.example.com',
-  apiKey: vscode.workspace.getConfiguration('mySolverExtension').get('apiKey'),
-  timeout: 15000
-});
+```typescript
+// Отмена текущей индексации
+await sdk.projects.cancelIndexing('идентификатор_проекта');
+```
 
-// Функция для индексации активного рабочего пространства
-async function indexCurrentWorkspace() {
-  // Получаем текущую рабочую директорию
-  const workspaceFolders = vscode.workspace.workspaceFolders;
-  if (!workspaceFolders || workspaceFolders.length === 0) {
-    vscode.window.showErrorMessage('Откройте папку проекта для индексации');
-    return;
-  }
-  
-  const workspacePath = workspaceFolders[0].uri.fsPath;
-  const workspaceName = path.basename(workspacePath);
-  
-  // Показываем индикатор прогресса в VS Code
-  vscode.window.withProgress({
-    location: vscode.ProgressLocation.Notification,
-    title: 'Индексация проекта',
-    cancellable: true
-  }, async (progress, token) => {
-    // Обработчик отмены
-    token.onCancellationRequested(() => {
-      sdk.projects.disconnectWebSocket();
-      vscode.window.showInformationMessage('Индексация отменена');
-    });
-    
-    try {
-      // Подключаем WebSocket
-      await sdk.projects.connectWebSocket();
-      
-      // Начинаем индексацию
-      const result = await sdk.projects.createAndIndexProject(
-        workspacePath,
-        {
-          name: workspaceName,
-          excludePatterns: [
-            'node_modules', '.git', 'dist', 'build', 
-            ...vscode.workspace.getConfiguration('search').get('exclude')
-          ]
-        }
-      );
-      
-      // Сохраняем ID проекта в настройках VS Code
-      await vscode.workspace.getConfiguration().update(
-        'mySolverExtension.projectId',
-        result.projectId,
-        vscode.ConfigurationTarget.Workspace
-      );
-      
-      progress.report({ message: 'Индексация началась...', increment: 5 });
-      
-      // Мониторинг прогресса
-      sdk.projects.on('indexing_progress', (data) => {
-        progress.report({ 
-          message: `${data.progress}% (${data.indexedFiles}/${data.totalFiles})`,
-          increment: data.progress / 20 // для плавного обновления
-        });
-      });
-      
-      // Возвращаем Promise, который разрешится при завершении
-      return new Promise((resolve) => {
-        sdk.projects.on('indexing_complete', () => {
-          sdk.projects.disconnectWebSocket();
-          vscode.window.showInformationMessage('Индексация успешно завершена!');
-          resolve();
-        });
-        
-        sdk.projects.on('indexing_error', (error) => {
-          sdk.projects.disconnectWebSocket();
-          vscode.window.showErrorMessage(`Ошибка индексации: ${error.message}`);
-          resolve();
-        });
-      });
-    } catch (error) {
-      sdk.projects.disconnectWebSocket();
-      vscode.window.showErrorMessage(`Ошибка: ${error.message}`);
-    }
-  });
-}
+### Очистка ошибок индексации
 
-// Регистрация команды в VS Code
-context.subscriptions.push(
-  vscode.commands.registerCommand('mySolverExtension.indexProject', indexCurrentWorkspace)
-);
+```typescript
+// Очистка ошибки, если индексация завершилась с ошибкой
+await sdk.projects.clearIndexingError('идентификатор_проекта');
 ```
 
-### Наблюдение за файловой системой
+## Отслеживание индексации через WebSocket
 
-Пример автоматического обновления индекса при изменении файлов:
+SDK поддерживает отслеживание процесса индексации в реальном времени через WebSocket:
 
-```javascript
-const chokidar = require('chokidar');
-const path = require('path');
-
-async function watchAndIndex(projectId, projectPath) {
-  // Подключение WebSocket
-  await sdk.projects.connectWebSocket();
-  
-  // Установка обработчиков
-  sdk.projects.on('file_indexed', (data) => {
-    console.log(`Файл проиндексирован: ${data.filePath}`);
-  });
-  
-  // Настройка наблюдателя за файловой системой
-  const watcher = chokidar.watch(projectPath, {
-    ignored: [
-      /(^|[\/\\])\../, // скрытые файлы
-      '**/node_modules/**',
-      '**/dist/**',
-      '**/.git/**'
-    ],
-    persistent: true,
-    ignoreInitial: true
-  });
-  
-  // Обработка изменений файлов
-  watcher.on('change', async (filePath) => {
-    try {
-      // Получаем относительный путь
-      const relPath = path.relative(projectPath, filePath);
-      
-      console.log(`Обнаружено изменение файла: ${relPath}`);
-      
-      // Обновляем индекс для измененного файла
-      await sdk.projects.updateFileIndex(projectId, relPath);
-    } catch (error) {
-      console.error(`Ошибка при обновлении индекса: ${error.message}`);
-    }
-  });
-  
-  console.log(`Наблюдение за директорией ${projectPath} для проекта ${projectId} запущено`);
-  
-  // Возвращаем функцию для остановки наблюдения
-  return {
-    stop: () => {
-      watcher.close();
-      sdk.projects.disconnectWebSocket();
-      console.log(`Наблюдение за директорией ${projectPath} остановлено`);
-    }
-  };
-}
+```typescript
+// Подключение к WebSocket
+await sdk.projects.connectWebSocket();
 
-// Использование
-const projectId = 'your-project-id';
-const projectPath = '/path/to/project';
+// Подписка на события индексации отдельных файлов
+sdk.projects.on('file_indexed', (data) => {
+  console.log(`Файл индексирован: ${data.file.path}`);
+  console.log(`Язык: ${data.file.language}`);
+  console.log(`Тип изменения: ${data.file.changeType}`);
+});
 
-const watcher = await watchAndIndex(projectId, projectPath);
+// Подписка на событие завершения индексации
+sdk.projects.on('indexing_complete', (data) => {
+  console.log(`Индексация завершена для проекта ${data.projectId}`);
+  console.log(`Всего файлов: ${data.stats.totalFiles}`);
+  console.log(`Проиндексировано: ${data.stats.indexed}`);
+  console.log(`Ошибок: ${data.stats.failed}`);
+  console.log(`Время индексации: ${data.stats.time}мс`);
+});
 
-// Позже можно остановить наблюдение
-// watcher.stop();
+// Отключение от WebSocket после завершения работы
+await sdk.projects.disconnectWebSocket();
 ```
 
 ## Обработка ошибок
 
-При интеграции с SDK рекомендуется использовать надежную обработку ошибок.
-
-### Ошибки HTTP API
-
-```javascript
+```typescript
 try {
-  await sdk.projects.indexProject(projectId);
+  await sdk.projects.indexProject('идентификатор_проекта', {
+    indexingMode: 'full'
+  });
 } catch (error) {
-  // Проверка статус-кодов
-  if (error.status === 404) {
+  if (error.message.includes('не найден')) {
     console.error('Проект не найден');
-    // Возможное создание нового проекта
-    const newProject = await sdk.projects.createProject('Новый проект', projectPath);
-    await sdk.projects.indexProject(newProject.id);
-  } 
-  else if (error.status === 409) {
-    console.error('Индексация уже запущена');
-    // Можно проверить текущий статус
-    const status = await sdk.projects.getIndexingStatus(projectId);
-    console.log(`Текущий прогресс: ${status.progress}%`);
-  }
-  else if (error.status === 401 || error.status === 403) {
+  } else if (error.message.includes('forbidden')) {
     console.error('Ошибка авторизации. Проверьте API ключ');
-  }
-  else {
-    console.error('Неизвестная ошибка:', error.message);
+  } else {
+    console.error(`Ошибка индексации: ${error.message}`);
   }
 }
 ```
 
-### Надежное подключение к WebSocket
-
-```javascript
-// Функция для надежного подключения с автоматическим переподключением
-async function establishReliableConnection(projectId, maxRetries = 3) {
-  let retries = 0;
-  let connected = false;
-  
-  while (!connected && retries < maxRetries) {
-    try {
-      await sdk.projects.connectWebSocket();
-      connected = sdk.projects.isWebSocketConnected();
-      
-      if (connected) {
-        console.log('Подключение к WebSocket установлено');
-        
-        // Обработка отключений
-        sdk.projects.on('disconnect', () => {
-          console.log('WebSocket соединение прервано, переподключение...');
-          setTimeout(() => {
-            sdk.projects.connectWebSocket().catch(e => {
-              console.error('Ошибка переподключения:', e.message);
-            });
-          }, 2000);
-        });
-        
-        return true;
-      }
-      
-      retries++;
-      console.log(`Не удалось подключиться, попытка ${retries}/${maxRetries}...`);
-      await new Promise(resolve => setTimeout(resolve, 1000 * retries));
-    } catch (error) {
-      retries++;
-      console.error(`Ошибка подключения: ${error.message}`);
-      await new Promise(resolve => setTimeout(resolve, 1000 * retries));
-    }
-  }
-  
-  if (!connected) {
-    console.error('Не удалось установить WebSocket соединение после нескольких попыток');
-    return false;
-  }
-  
-  return connected;
-}
+## Авторизация WebSocket
 
-// Использование
-await establishReliableConnection(projectId);
-```
+Начиная с версии 1.7.7, SDK автоматически добавляет API ключ в качестве параметра `authToken` при подключении WebSocket, что обеспечивает корректную авторизацию для всех операций через WebSocket (индексация, рассуждения и т.д.).
+
+Для корректной работы WebSocket соединений:
+1. **Обязательно указывайте `apiKey` при инициализации SDK**
+2. Подключайтесь к WebSocket перед использованием событий
+3. Отключайтесь от WebSocket после завершения работы
+
+```typescript
+// Корректная инициализация с apiKey
+const sdk = new CodeSolverSDK({
+  baseURL: 'https://api.example.com',
+  apiKey: 'ваш_api_ключ' // Обязательно для WebSocket авторизации
+});
+
+// Подключение
+await sdk.projects.connectWebSocket();
+
+// Использование WebSocket...
 
-Дополнительные примеры использования API индексации можно найти в файле `solver-sdk/examples/indexing-example.js`. 
+// Отключение
+await sdk.projects.disconnectWebSocket();
+```