ai-llm

Назначение

Абстракция для работы с LLM-провайдерами: structured output (JSON), системные промпты, STT (speech-to-text).

Контракты

LLM-клиент

// Singleton-паттерн для инициализации клиента
function getClient(): LLMClient

// Типы для structured output
interface AnalysisInput {
  index: number;
  senderName: string;
  text: string;
  mediaDescriptions: string[];
}

interface ExtractedIssue {
  title: string;
  description: string;
  type: "bug" | "feature" | "improvement";
  priority: "low" | "medium" | "high" | "critical";
  steps_to_reproduce?: string;
  related_message_indices: number[];
  media_references: string[];
}

interface AnalysisResult {
  issues: ExtractedIssue[];
  raw: string;
}

// Основная функция
async function analyzeFeedback(
  messages: AnalysisInput[],
  projectName: string
): Promise<AnalysisResult>

**Паттерн structured output**: системный промпт задаёт JSON-формат → модель отвечает JSON → парсинг с fallback на извлечение JSON из markdown code blocks.

STT (Speech-to-Text)

async function transcribe(
  audioBuffer: Buffer,
  language?: string  // default: "ru"
): Promise<string>

Конфигурация

|-----------|----------|

Зависимости

Реализации

|------|------|----------|--------|

Адаптация