solver-sdk 2.6.2 → 2.7.0

package/docs/README_V2.5.md

@@ -1,266 +0,0 @@
-# AI Solver SDK v2.5.0
-
-JavaScript/TypeScript SDK для взаимодействия с AI Solver Backend API - умной системой работы с кодом, reasoning и AI-ассистентами.
-
-## Установка
-
-```bash
-npm install @ai-solver/sdk
-```
-
-## Основные возможности
-
-- **🚀 Проекты**: создание, индексация и управление
-- **🧠 AI Reasoning**: умное рассуждение в контексте кода  
-- **💬 AI Chat**: взаимодействие с Claude 4 thinking + tools
-- **🔍 Поиск**: семантический поиск по коду
-- **⚡ WebSocket**: real-time события и streaming
-- **🌐 Мультиплатформенность**: Browser + Node.js
-
-## Быстрый старт v2.5.0
-
-```javascript
-import { CodeSolverSDK } from '@ai-solver/sdk';
-
-// Рекомендуемый способ инициализации
-const sdk = CodeSolverSDK.create({
-  baseURL: 'http://localhost:3000',
-  apiKey: 'dev_sk_test_12345678',
-  autoConnect: false // Контролируемые WebSocket подключения
-});
-
-// Проверка всех endpoints
-const results = await sdk.diagnoseAPI();
-console.log('API статус:', results);
-
-// Создание проекта
-const project = await sdk.projects.create({
-  name: 'My AI Project',
-  path: '/path/to/project',
-  description: 'Test project for AI Solver'
-});
-
-// Запуск индексации
-await sdk.projects.startIndexing(project.id);
-
-// WebSocket события (подключение по требованию)
-await sdk.projects.connectWebSocket();
-sdk.projects.onIndexingProgress((progress) => {
-  console.log(`Прогресс: ${progress.percentage}%`);
-});
-
-// AI Reasoning процесс
-const reasoning = await sdk.reasoning.create({
-  projectId: project.id,
-  query: 'Проанализируй архитектуру этого проекта'
-});
-
-await sdk.reasoning.start(reasoning.id);
-
-// Chat с Claude 4 thinking
-const response = await sdk.chat.stream([
-  {
-    role: 'user', 
-    content: 'Объясни как работает эта функция',
-    tools: createStandardDevelopmentTools()
-  }
-], {
-  projectId: project.id,
-  model: 'claude-3-5-sonnet-20241022',
-  thinking: true
-});
-```
-
-## Новые возможности v2.5.0
-
-### ✨ **Complex Content Support**
-```javascript
-// Поддержка сложного контента
-const message = {
-  role: 'user',
-  content: [
-    { type: 'text', text: 'Анализируй этот код:' },
-    { type: 'text', text: 'function example() { return 42; }' },
-    { type: 'tool_use', id: 'tool_1', name: 'code_analyzer' }
-  ]
-};
-```
-
-### 🔧 **Tool Choice Validation**
-```javascript
-// Только auto/none с thinking
-const response = await sdk.chat.stream(messages, {
-  thinking: true,
-  tool_choice: { type: 'auto' } // ✅ Работает
-  // tool_choice: { type: 'any' } // ❌ Ошибка с thinking
-});
-```
-
-### 🔐 **Signature Preservation**
-```javascript
-// Автоматическое сохранение криптографических подписей
-sdk.chat.onThinkingSignature((signature) => {
-  console.log('Подпись thinking блока:', signature);
-});
-```
-
-### 🌊 **Streaming Events**
-```javascript
-// Новые события streaming
-sdk.chat.onTextDelta((text) => console.log('Текст:', text));
-sdk.chat.onThinkingDelta((thinking) => console.log('Мышление:', thinking));
-sdk.chat.onSignatureDelta((sig) => console.log('Подпись:', sig));
-```
-
-## Контролируемые WebSocket
-
-```javascript
-// v2.5.0 - полный контроль подключений
-const sdk = CodeSolverSDK.create({
-  autoConnect: false // Важно!
-});
-
-// Подключение только когда нужно
-await sdk.projects.connectWebSocket();
-await sdk.reasoning.connectWebSocket();
-await sdk.chat.connectWebSocket();
-
-// Отключение когда не нужно
-await sdk.projects.disconnectWebSocket();
-```
-
-## API Алиасы для совместимости
-
-```javascript
-// Полные названия (рекомендуемые)
-await sdk.reasoning.createReasoning(data);
-await sdk.reasoning.startReasoning(id);
-await sdk.reasoning.stopReasoning(id);
-
-// Короткие алиасы
-await sdk.reasoning.create(data);
-await sdk.reasoning.start(id);  
-await sdk.reasoning.stop(id);
-```
-
-## Helper функции
-
-```javascript
-import { 
-  createStandardDevelopmentTools,
-  extractThinkingBlocks,
-  extractToolUseBlocks,
-  createToolResultMessage,
-  createComplexAssistantMessage
-} from '@ai-solver/sdk';
-
-// 8 стандартных инструментов как в Cursor
-const tools = createStandardDevelopmentTools();
-
-// Извлечение thinking блоков
-const thinkingBlocks = extractThinkingBlocks(response);
-
-// Создание сложных сообщений
-const complexMessage = createComplexAssistantMessage(
-  'Результат анализа:',
-  thinkingBlocks,
-  toolUseBlocks
-);
-```
-
-## Диагностика и debugging
-
-```javascript
-// Проверка всех endpoints
-const results = await sdk.diagnoseAPI();
-console.log('Доступные endpoints:', results);
-
-// Детальная диагностика
-const detailed = await sdk.diagnoseFull();
-console.log('Статус backend:', detailed);
-
-// Проверка WebSocket
-const wsStatus = await sdk.diagnoseWebSocket();
-console.log('WebSocket статус:', wsStatus);
-```
-
-## Обработка ошибок
-
-```javascript
-try {
-  const project = await sdk.projects.create(projectData);
-} catch (error) {
-  if (error.status === 404) {
-    console.error('Backend недоступен');
-  } else if (error.status === 400) {
-    console.error('Некорректные данные:', error.message);
-  } else {
-    console.error('Неожиданная ошибка:', error);
-  }
-}
-```
-
-## Environment Configuration
-
-```javascript
-// Production
-const sdk = CodeSolverSDK.create({
-  baseURL: 'https://api.ai-solver.com',
-  apiKey: process.env.AI_SOLVER_API_KEY,
-  autoConnect: false
-});
-
-// Development  
-const sdk = CodeSolverSDK.create({
-  baseURL: 'http://localhost:3000',
-  apiKey: 'dev_sk_test_12345678',
-  autoConnect: false
-});
-```
-
-## Миграция с v2.4.x
-
-### Изменения инициализации:
-```javascript
-// ❌ v2.4.x (deprecated):
-const sdk = new CodeSolverSDK(options);
-await sdk.initialize();
-
-// ✅ v2.5.0:
-const sdk = CodeSolverSDK.create(options);
-// initialize() больше не нужен
-```
-
-### Изменения методов:
-```javascript
-// ❌ v2.4.x:
-await sdk.projects.createProject(name, path, options);
-
-// ✅ v2.5.0:  
-await sdk.projects.create({ name, path, description });
-```
-
-### WebSocket изменения:
-```javascript
-// ❌ v2.4.x (автоподключение):
-const sdk = new CodeSolverSDK(options); // Автоматически подключался
-
-// ✅ v2.5.0 (контролируемое):
-const sdk = CodeSolverSDK.create({ autoConnect: false });
-await sdk.projects.connectWebSocket(); // Явное подключение
-```
-
-## Поддерживаемые платформы
-
-- **Node.js**: 16.x и выше
-- **Browsers**: Chrome 90+, Firefox 88+, Safari 14+, Edge 90+
-- **TypeScript**: 4.5+ (опционально)
-
-## Лицензия
-
-MIT
-
----
-
-**Обновлено для AI Solver SDK v2.5.0**  
-**Совместимо с AI Solver Backend v1.0.0**