solver-sdk/docs/README.md

SDK для интеграции с Code Solver Backend API (совместимо с браузером и Node.js), с поддержкой функциональности мышления (Thinking Mode)

# Документация Solver SDK

Эта директория содержит подробную документацию по Solver SDK версии 1.7.2.

## Содержание

### Основная документация

- [Потоковая передача мышления (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) - Руководство по индексации и обновлению индекса проектов

### Дополнительные материалы

- [Режим мышления](./thinking/thinking-mode.md) - Основная информация о режиме мышления

## Основные возможности SDK 1.7.2

### Потоковая передача мышления (Streaming Thinking)

В версии 1.7.2 добавлена полная поддержка потоковой передачи мышления с помощью метода `streamChatWithThinking()`. Это позволяет получать события мышления модели в реальном времени через WebSocket.

```javascript
const response = await sdk.chat.streamChatWithThinking(
  messages,
  { model: 'claude-3-7-sonnet-20240229', thinking: true },
  handleEvent
);
```

### Региональные эндпоинты

SDK поддерживает работу с различными региональными эндпоинтами Anthropic API:

```javascript
const sdk = new CodeSolverSDK({
  providers: {
    anthropic: {
      region: 'eu-west-1'  // Использовать европейский регион
    }
  }
});

// Автоматическое переключение между регионами при ошибках
const response = await sdk.chat.chatWithRegionFailover([...], options);
```

### WebSocket улучшения

Улучшена надежность и диагностика WebSocket соединений:

```javascript
// Диагностика соединения
const diagnostics = sdk.getWebSocketClient().diagnoseConnection(namespace);
console.log(diagnostics);

// Мониторинг здоровья
sdk.getWebSocketClient().setupConnectionHealthCheck(interval);
```

## Примеры кода

Примеры использования SDK доступны в директории `examples` корневого каталога проекта:

- `example:check-api` - Проверка соединения с API
- `example:indexing` - Индексация проектов
- `example:dependencies` - Работа с зависимостями
- `example:regions` - Проверка доступности регионов

## Обратная связь

Если вы обнаружили ошибки в документации или у вас есть предложения по улучшению, пожалуйста, создайте issue в репозитории проекта.