@dxtmisha/scripts 0.11.7 → 1.0.0

package/dist/library-ai.d.ts

@@ -0,0 +1,482 @@
+import { Anthropic } from '@anthropic-ai/sdk';
+import { GoogleGenAI } from '@google/genai';
+import { OpenAI } from 'openai';
+import { XaiProvider } from '@ai-sdk/xai';
+
+/**
+ * Abstract AI base class providing common mechanics for AI integrations.
+ * Handles prompt accumulation, model selection and unified response workflow.
+ *
+ * Абстрактный базовый класс AI, обеспечивающий общую механику интеграций:
+ * накопление prompt, выбор модели и унифицированный цикл получения ответа.
+ *
+ * Responsibilities / Ответственности:
+ * - Accumulate and compose prompt context / Накопление и компоновка контекста
+ * - Select active model / Выбор активной модели
+ * - Normalize generation call flow / Нормализация вызова генерации
+ *
+ * Extension points / Точки расширения:
+ * - init(): client / auth / transport setup
+ * - response(): concrete model invocation
+ *
+ * Расширение через методы:
+ * - init(): инициализация клиента / авторизация / транспорт
+ * - response(): конкретный вызов модели
+ */
+export declare abstract class AiAbstract<AI = any> {
+    protected key: string;
+    protected model: string;
+    protected config: Record<string, any>;
+    /** AI client instance / Экземпляр AI-клиента */
+    protected ai?: AI;
+    /** Prompt prefix / Префикс prompt */
+    protected prompt: string;
+    /** Accumulated image list / Накопленный список изображений */
+    protected images: AiImageList;
+    /** Accumulated contents / Накопленное содержимое */
+    protected contents: string[];
+    /**
+     * Constructor initializes implementation specific resources.
+     *
+     * Конструктор инициализирует ресурсы конкретной реализации.
+     * @param key API key / API ключ
+     * @param model initial model id / начальный идентификатор модели
+     * @param config configuration object / объект конфигурации
+     */
+    constructor(key: string, model: string, config?: Record<string, any>);
+    /**
+     * Returns accumulated image list.
+     *
+     * Возвращает накопленный список изображений.
+     * @returns accumulated image list / накопленный список изображений
+     */
+    getImages(): AiImageList;
+    /**
+     * Returns accumulated contents.
+     *
+     * Возвращает накопленное содержимое.
+     * @returns accumulated contents / накопленное содержимое
+     */
+    getContents(): string[];
+    /**
+     * Appends an image to the accumulated image list.
+     *
+     * Добавляет изображение к накопленному списку изображений.
+     * @param image image item / элемент изображения
+     * @returns current instance / текущий экземпляр
+     */
+    addImage(image: AiImageItem): this;
+    /**
+     * Appends content to the accumulated contents.
+     *
+     * Добавляет содержимое к накопленному содержимому.
+     * @param content content string / строка содержимого
+     * @returns current instance / текущий экземпляр
+     */
+    addContent(content: string): this;
+    /**
+     * Appends a new line to the accumulated prompt block.
+     *
+     * Добавляет новую строку к накопленному блоку prompt.
+     * @param prompt prompt string to append / строка prompt для добавления
+     */
+    addPrompt(prompt: string): void;
+    /**
+     * Clears entire accumulated image list.
+     *
+     * Очищает весь накопленный список изображений.
+     * @returns current instance / текущий экземпляр
+     */
+    resetImages(): this;
+    /**
+     * Clears entire accumulated contents.
+     *
+     * Очищает все накопленное содержимое.
+     * @returns current instance / текущий экземпляр
+     */
+    resetContents(): this;
+    /**
+     * Clears entire accumulated prompt.
+     *
+     * Полностью очищает накопленный prompt.
+     */
+    resetPrompt(): void;
+    /**
+     * Sets / switches API key for authentication.
+     *
+     * Устанавливает / переключает API ключ для аутентификации.
+     * @param key new API key / новый API ключ
+     * @returns current instance / текущий экземпляр
+     */
+    setKey(key: string): this;
+    /**
+     * Sets / switches current model for generation.
+     *
+     * Устанавливает / переключает текущую модель для генерации.
+     * @param model model identifier / идентификатор модели
+     * @returns current instance / текущий экземпляр
+     */
+    setModel(model: string): this;
+    /**
+     * Sets / switches configuration object.
+     *
+     * Устанавливает / переключает объект конфигурации.
+     * @param config configuration object / объект конфигурации
+     * @returns current instance / текущий экземпляр
+     */
+    setConfig(config: Record<string, any>): this;
+    /**
+     * Generates AI response using active model and composed contents.
+     * Supports retry with random delay and configurable error handling.
+     *
+     * Генерирует отклик ИИ, используя активную модель и собранный контент.
+     * Поддерживает повторные попытки со случайной задержкой и настраиваемой обработкой ошибок.
+     * @param contents input contents for generation / входное содержимое для генерации
+     * @param exitOnError whether to terminate the process on unrecoverable failure / завершать ли процесс при неустранимой ошибке
+     * @param maxRetries number of retry attempts before giving up / количество повторных попыток перед отказом
+     * @returns generated response text / сгенерированный текст ответа
+     */
+    generate(contents: string, exitOnError?: boolean, maxRetries?: number): Promise<string>;
+    /**
+     * Combines persistent prompt prefix with provided contents.
+     *
+     * Объединяет постоянный префикс prompt с переданным содержимым.
+     * @param contents input contents / входное содержимое
+     * @returns combined prompt content / объединенное содержимое prompt
+     */
+    protected getMainContents(contents: string): string;
+    /**
+     * Implementation hook: initialize client / transport / auth.
+     *
+     * Хук реализации: инициализация клиента / транспорта / авторизации.
+     */
+    protected abstract init(): Promise<void> | void;
+    /**
+     * Implementation hook: convert accumulated images to model-specific format.
+     *
+     * Хук реализации: преобразовать накопленные изображения в формат, специфичный для модели.
+     */
+    protected abstract toImages(): void;
+    /**
+     * Implementation hook: convert accumulated contents to model-specific format.
+     *
+     * Хук реализации: преобразовать накопленное содержимое в формат, специфичный для модели.
+     */
+    protected abstract toContents(): void;
+    /**
+     * Implementation hook: perform model call and return textual result.
+     *
+     * Хук реализации: выполнить вызов модели и вернуть текстовый результат.
+     * @param model active model id / идентификатор активной модели
+     * @param contents composed prompt + contents / собранный prompt + содержимое
+     * @returns generated response string / сгенерированная строка ответа
+     */
+    protected abstract response(model: string, contents: string): Promise<string>;
+}
+
+/**
+ * Claude AI implementation of AiAbstract.
+ * Initializes Anthropic client and performs text generation requests.
+ *
+ * Реализация Claude AI поверх AiAbstract.
+ * Инициализирует клиент Anthropic и выполняет запросы генерации текста.
+ *
+ * Responsibilities / Ответственности:
+ * - Provide API key / Предоставить API ключ
+ * - Initialize low-level client / Инициализировать низкоуровневый клиент
+ * - Call messages.create and extract plain text / Вызвать messages.create и извлечь текст
+ *
+ * Notes / Примечания:
+ * - Model must be set via setModel() before generate() / Модель нужно задать через setModel()
+ * - Returns empty string if response is missing / Возвращает пустую строку при отсутствии результата
+ */
+export declare class AiClaude extends AiClaudeLite {
+    /**
+     * Constructor initializes Claude AI with project configuration.
+     *
+     * Конструктор инициализирует Claude AI с конфигурацией проекта.
+     */
+    constructor();
+}
+
+/**
+ * Claude AI implementation of AiAbstract.
+ * Initializes Anthropic client and performs text generation requests.
+ *
+ * Реализация Claude AI поверх AiAbstract.
+ * Инициализирует клиент Anthropic и выполняет запросы генерации текста.
+ *
+ * Responsibilities / Ответственности:
+ * - Provide API key / Предоставить API ключ
+ * - Initialize Anthropic client / Инициализировать клиент Anthropic
+ * - Call messages.create and extract text content / Вызвать messages.create и извлечь текст
+ *
+ * Notes / Примечания:
+ * - Model must be set via setModel() before generate() / Модель нужно задать через setModel()
+ * - Returns empty string if response is missing / Возвращает пустую строку при отсутствии результата
+ */
+export declare class AiClaudeLite extends AiAbstract<Anthropic> {
+    /**
+     * Initializes Anthropic client instance.
+     *
+     * Инициализирует экземпляр клиента Anthropic.
+     */
+    protected init(): Promise<void>;
+    /**
+     * Implementation hook: convert accumulated images to model-specific format.
+     * Claude expects images as content blocks with type 'image'.
+     *
+     * Хук реализации: преобразовать накопленные изображения в формат, специфичный для модели.
+     * Claude ожидает изображения как блоки контента с типом 'image'.
+     * @returns array of converted image blocks / массив преобразованных блоков изображений
+     */
+    protected toImages(): any;
+    /**
+     * Implementation hook: convert accumulated contents to model-specific format.
+     * Claude expects text as content blocks with type 'text'.
+     *
+     * Хук реализации: преобразовать накопленное содержимое в формат, специфичный для модели.
+     * Claude ожидает текст как блоки контента с типом 'text'.
+     * @returns array of converted text blocks / массив преобразованных текстовых блоков
+     */
+    protected toContents(): any;
+    /**
+     * Performs content generation request and returns textual result.
+     *
+     * Выполняет запрос генерации контента и возвращает текстовый результат.
+     * @param model model identifier (e.g., 'claude-3-5-sonnet-20241022') / идентификатор модели
+     * @param contents composed contents for generation / собранный контент для генерации
+     * @returns generated text response / сгенерированный текстовый ответ
+     */
+    protected response(model: string, contents: string): Promise<string>;
+}
+
+/**
+ * Google AI (Gemini) implementation of AiAbstract.
+ * Initializes GoogleGenAI client and performs text generation requests.
+ *
+ * Реализация Google AI (Gemini) поверх AiAbstract.
+ * Инициализирует клиент GoogleGenAI и выполняет запросы генерации текста.
+ *
+ * Responsibilities / Ответственности:
+ * - Provide API key / Предоставить API ключ
+ * - Initialize low-level client / Инициализировать низкоуровневый клиент
+ * - Call generateContent and extract plain text / Вызвать generateContent и извлечь текст
+ *
+ * Notes / Примечания:
+ * - Model must be set via setModel() before generate() / Модель нужно задать через setModel()
+ * - Returns empty string if response is missing / Возвращает пустую строку при отсутствии результата
+ */
+export declare class AiGoogle extends AiGoogleLite {
+    /**
+     * Constructor initializes Google AI with project configuration.
+     *
+     * Конструктор инициализирует Google AI с конфигурацией проекта.
+     */
+    constructor();
+}
+
+/**
+ * Google AI (Gemini) implementation of AiAbstract.
+ * Initializes GoogleGenAI client and performs text generation requests.
+ *
+ * Реализация Google AI (Gemini) поверх AiAbstract.
+ * Инициализирует клиент GoogleGenAI и выполняет запросы генерации текста.
+ *
+ * Responsibilities / Ответственности:
+ * - Provide API key / Предоставить API ключ
+ * - Initialize low-level client / Инициализировать низкоуровневый клиент
+ * - Call generateContent and extract plain text / Вызвать generateContent и извлечь текст
+ *
+ * Notes / Примечания:
+ * - Model must be set via setModel() before generate() / Модель нужно задать через setModel()
+ * - Returns empty string if response is missing / Возвращает пустую строку при отсутствии результата
+ */
+export declare class AiGoogleLite extends AiAbstract<GoogleGenAI> {
+    /**
+     * Initializes GoogleGenAI client instance.
+     *
+     * Инициализирует экземпляр клиента GoogleGenAI.
+     */
+    protected init(): Promise<void>;
+    /**
+     * Implementation hook: convert accumulated images to model-specific format.
+     *
+     * Хук реализации: преобразовать накопленные изображения в формат, специфичный для модели.
+     * @returns array of converted inline data images / массив преобразованных встроенных данных изображений
+     */
+    protected toImages(): any;
+    /**
+     * Implementation hook: convert accumulated contents to model-specific format.
+     *
+     * Хук реализации: преобразовать накопленное содержимое в формат, специфичный для модели.
+     * @returns array of converted text parts / массив преобразованных текстовых частей
+     */
+    protected toContents(): any;
+    /**
+     * Performs content generation request and returns textual result.
+     *
+     * Выполняет запрос генерации контента и возвращает текстовый результат.
+     * @param model model identifier / идентификатор модели
+     * @param contents composed contents for generation / собранный контент для генерации
+     * @returns generated text response / сгенерированный текстовый ответ
+     */
+    protected response(model: string, contents: string): Promise<string>;
+}
+
+/**
+ * AI image item representing a base64 encoded image with MIME type.
+ *
+ * Элемент изображения AI, представляющий base64-кодированное изображение с MIME-типом.
+ */
+declare type AiImageItem = {
+    /** Image MIME type / MIME-тип изображения */
+    mime: string;
+    /** Base64 encoded image string / Строка изображения в кодировке base64 */
+    base64: string;
+};
+
+/**
+ * List of AI image items.
+ *
+ * Список элементов изображений AI.
+ */
+declare type AiImageList = AiImageItem[];
+
+/**
+ * OpenAI implementation of AiAbstract.
+ * Initializes OpenAI client and performs text generation requests.
+ *
+ * Реализация OpenAI поверх AiAbstract.
+ * Инициализирует клиент OpenAI и выполняет запросы генерации текста.
+ *
+ * Responsibilities / Ответственности:
+ * - Provide API key / Предоставить API ключ
+ * - Initialize low-level client / Инициализировать низкоуровневый клиент
+ * - Call chat.completions.create and extract plain text / Вызвать chat.completions.create и извлечь текст
+ *
+ * Notes / Примечания:
+ * - Model must be set via setModel() before generate() / Модель нужно задать через setModel()
+ * - Returns empty string if response is missing / Возвращает пустую строку при отсутствии результата
+ */
+export declare class AiOpenAi extends AiOpenAiLite {
+    /**
+     * Constructor initializes OpenAI with project configuration.
+     *
+     * Конструктор инициализирует OpenAI с конфигурацией проекта.
+     */
+    constructor();
+}
+
+/**
+ * OpenAI implementation of AiAbstract.
+ * Initializes OpenAI client and performs text generation requests.
+ *
+ * Реализация OpenAI поверх AiAbstract.
+ * Инициализирует клиент OpenAI и выполняет запросы генерации текста.
+ *
+ * Responsibilities / Ответственности:
+ * - Provide API key / Предоставить API ключ
+ * - Initialize OpenAI client / Инициализировать клиент OpenAI
+ * - Call chat.completions.create and extract text content / Вызвать chat.completions.create и извлечь текст
+ *
+ * Notes / Примечания:
+ * - Model must be set via setModel() before generate() / Модель нужно задать через setModel()
+ * - Returns empty string if response is missing / Возвращает пустую строку при отсутствии результата
+ */
+export declare class AiOpenAiLite extends AiAbstract<OpenAI> {
+    /**
+     * Initializes OpenAI client instance.
+     *
+     * Инициализирует экземпляр клиента OpenAI.
+     */
+    protected init(): Promise<void>;
+    /**
+     * Implementation hook: convert accumulated images to model-specific format.
+     * OpenAI expects images as content blocks with type 'image_url'.
+     *
+     * Хук реализации: преобразовать накопленные изображения в формат, специфичный для модели.
+     * OpenAI ожидает изображения как блоки контента с типом 'image_url'.
+     * @returns array of converted image blocks / массив преобразованных блоков изображений
+     */
+    protected toImages(): any;
+    /**
+     * Implementation hook: convert accumulated contents to model-specific format.
+     * OpenAI expects text as content blocks with type 'text'.
+     *
+     * Хук реализации: преобразовать накопленное содержимое в формат, специфичный для модели.
+     * OpenAI ожидает текст как блоки контента с типом 'text'.
+     * @returns array of converted text blocks / массив преобразованных текстовых блоков
+     */
+    protected toContents(): any;
+    /**
+     * Performs content generation request and returns textual result.
+     *
+     * Выполняет запрос генерации контента и возвращает текстовый результат.
+     * @param model model identifier (e.g., 'gpt-4o') / идентификатор модели
+     * @param contents composed contents for generation / собранный контент для генерации
+     * @returns generated text response / сгенерированный текстовый ответ
+     */
+    protected response(model: string, contents: string): Promise<string>;
+}
+
+/**
+ * Z.ai (Zhipu AI) implementation extending AiZAiLite.
+ * Automatically configured using project environment settings.
+ *
+ * Реализация Z.ai (Zhipu AI) расширяющая AiZAiLite.
+ * Автоматически настраивается с использованием настроек окружения проекта.
+ */
+export declare class AiZAi extends AiZAiLite {
+    /**
+     * Constructor initializes Z.ai / xAI with project configuration.
+     *
+     * Конструктор инициализирует Z.ai / xAI с конфигурацией проекта.
+     */
+    constructor();
+}
+
+/**
+ * xAI (Grok) implementation of AiAbstract using @ai-sdk/xai and ai SDK.
+ * Performs text generation requests via Grok models (e.g. grok-4.5).
+ *
+ * Реализация xAI (Grok) поверх AiAbstract с использованием @ai-sdk/xai и ai SDK.
+ * Выполняет запросы генерации текста через модели Grok (например, grok-4.5).
+ *
+ * Responsibilities / Ответственности:
+ * - Initialize xAI client provider / Инициализировать провайдер клиента xAI
+ * - Execute generateText via Grok responses model / Выполнять generateText через модель ответов Grok
+ */
+export declare class AiZAiLite extends AiAbstract<XaiProvider> {
+    /**
+     * Initializes xAI client provider instance.
+     *
+     * Инициализирует экземпляр провайдера клиента xAI.
+     */
+    protected init(): Promise<void>;
+    /**
+     * Implementation hook: convert accumulated images to model-specific format.
+     *
+     * Хук реализации: преобразовать накопленные изображения в формат, специфичный для модели.
+     * @returns array of converted image blocks / массив преобразованных блоков изображений
+     */
+    protected toImages(): any[];
+    /**
+     * Implementation hook: convert accumulated contents to model-specific format.
+     *
+     * Хук реализации: преобразовать накопленное содержимое в формат, специфичный для модели.
+     * @returns array of converted text blocks / массив преобразованных текстовых блоков
+     */
+    protected toContents(): any[];
+    /**
+     * Performs content generation request using xAI responses model and returns textual result.
+     *
+     * Выполняет запрос генерации контента с использованием модели ответов xAI и возвращает текстовый результат.
+     * @param model Model identifier (e.g., 'grok-4.5') / Идентификатор модели
+     * @param contents Composed contents for generation / Собранный контент для генерации
+     * @returns Generated text response / Сгенерированный текстовый ответ
+     */
+    protected response(model: string, contents: string): Promise<string>;
+}
+
+export { }

package/dist/library-ai.js

@@ -0,0 +1,2 @@
+import { a as e, c as t, i as n, n as r, o as i, r as a, s as o, t as s, u as c } from "./AiZAi-x3CInynJ.js";
+export { c as AiAbstract, o as AiClaude, t as AiClaudeLite, e as AiGoogle, i as AiGoogleLite, a as AiOpenAi, n as AiOpenAiLite, s as AiZAi, r as AiZAiLite };