@mate-academy/llm-gateway 1.0.2 → 1.0.4

package/README.md

@@ -173,6 +173,383 @@ Supports both completion and assistance APIs. For more information, see [OpenAI
 
 Supports completion API through Google's Generative AI models. For more information, see [Google Generative AI documentation](https://ai.google.dev/docs).
 
+## Developer Guide: Adding a New Provider
+
+To add support for a new LLM provider, follow these steps:
+
+### 1. Create Provider Directory Structure
+
+Create a new directory in `src/providers` with your provider name, following the established pattern:
+
+```
+src/providers/YourProvider/
+├── index.ts                    # Entry point for provider exports
+├── YourProvider.constants.ts   # Provider-specific constants
+├── YourProvider.entity.ts      # Provider-specific entity
+├── YourProvider.typedefs.ts    # TypeScript definitions
+├── YourProviderService.factory.ts # Factory for your provider's services
+└── services/                   # Provider service implementations
+    ├── index.ts
+    ├── YourProviderCompletionService.ts
+    └── YourProviderAssistanceService.ts
+```
+
+### 2. Add Provider to LLM Providers Enum
+
+Update the LLM providers enum in `src/LLMService.typedefs.ts`:
+
+```typescript
+export enum LLMProviders {
+  OpenAI = 'openai',
+  GoogleGenerativeAI = 'google',
+  YourProvider = 'your-provider-id',
+}
+```
+
+### 3. Define Provider-Specific Types
+
+Create type definitions in `src/providers/YourProvider/YourProvider.typedefs.ts`:
+
+```typescript
+// Define model names as an enum for type safety
+export enum YourProviderModelNames {
+  MODEL_ONE = 'model-one',
+  MODEL_TWO = 'model-extended',
+}
+
+// Define message roles if applicable
+export enum YourProviderRoles {
+  User = 'user',
+  Assistant = 'assistant',
+  System = 'system',
+}
+
+// Add any other provider-specific enums or interfaces
+```
+
+Then ensure your provider is properly integrated in the main type system by updating the necessary type mappings in `src/LLMService.typedefs.ts`:
+
+```typescript
+// Add import for your provider's types
+import { type YourProviderModelNames } from './providers/YourProvider/YourProvider.typedefs';
+
+// Update the LLMProviders enum
+export enum LLMProviders {
+  OpenAI = 'OpenAI',
+  GoogleGenerativeAI = 'GoogleGenerativeAI',
+  YourProvider = 'YourProvider',
+}
+
+// Update LLMInstances type mapping
+export type LLMInstances = {
+  // ...existing code...
+  [LLMProviders.YourProvider]: YourProviderClient; // Your provider's client type
+};
+
+// Update LLMInstanceOptions type mapping
+export type LLMInstanceOptions = {
+  // ...existing code...
+  [LLMProviders.YourProvider]: {
+    apiKey: string;
+    // Add other provider-specific options
+  };
+};
+
+// Update LLMModelName type mapping
+export type LLMModelName = {
+  // ...existing code...
+  [LLMProviders.YourProvider]: YourProviderModelNames;
+};
+```
+
+### 4. Implement Provider Constants
+
+Define constants in `src/providers/YourProvider/YourProvider.constants.ts`:
+
+```typescript
+import {
+  type LLMProviderAvailableModels,
+  type LLMProviderModelsByPurpose,
+  type LLMProviders,
+  LLMPurposes,
+  type LLMServiceBuilder,
+} from '../../LLMService.typedefs';
+import { YourProviderModelNames } from './YourProvider.typedefs';
+import {
+  YourProviderAssistanceService,
+  YourProviderCompletionService,
+} from './services';
+import { pick } from '../../functional.utils';
+
+// Define available models with their capabilities and configurations
+const YOUR_PROVIDER_AVAILABLE_MODELS: LLMProviderAvailableModels<
+  LLMProviders.YourProvider
+> = {
+  [YourProviderModelNames.MODEL_ONE]: {
+    name: YourProviderModelNames.MODEL_ONE,
+    limits: {
+      maxInputTokens: 8_000,
+      maxOutputTokens: 2_000,
+    },
+    config: {
+      temperature: 0.2,
+    },
+  },
+  [YourProviderModelNames.MODEL_TWO]: {
+    name: YourProviderModelNames.MODEL_TWO,
+    limits: {
+      maxInputTokens: 16_000,
+      maxOutputTokens: 4_000,
+    },
+    config: {
+      temperature: 0.2,
+    },
+  },
+};
+
+// Specify which models are available for each purpose
+export const YOUR_PROVIDER_MODELS: LLMProviderModelsByPurpose<
+  LLMPurposes,
+  LLMProviders.YourProvider
+> = {
+  [LLMPurposes.Completion]: pick(
+    YOUR_PROVIDER_AVAILABLE_MODELS,
+    [
+      YourProviderModelNames.MODEL_ONE,
+      YourProviderModelNames.MODEL_TWO,
+    ],
+  ),
+  [LLMPurposes.Assistance]: pick(
+    YOUR_PROVIDER_AVAILABLE_MODELS,
+    [
+      YourProviderModelNames.MODEL_TWO, // Only MODEL_TWO supports assistance
+    ],
+  ),
+};
+
+// Define service builders for each LLM purpose
+export const YOUR_PROVIDER_SERVICE_BUILDERS: {
+  [purpose in LLMPurposes]: (
+    LLMServiceBuilder<LLMProviders.YourProvider, purpose> | null
+  )
+} = {
+  [LLMPurposes.Completion]: (logger, options) => (
+    new YourProviderCompletionService(logger, options)
+  ),
+  [LLMPurposes.Assistance]: (logger, options) => (
+    new YourProviderAssistanceService(logger, options)
+  ),
+};
+```
+
+### 5. Implement Provider Entity (if needed)
+
+Create the entity class in `src/providers/YourProvider/YourProvider.entity.ts`:
+
+```typescript
+export class YourProviderEntity {
+  // Implement provider-specific methods
+}
+```
+
+### 6. Implement Service Classes
+
+Create service implementations in the `services` directory:
+
+**CompletionService (src/providers/YourProvider/services/YourProviderCompletionService.ts)**:
+
+```typescript
+import { Logger } from '../../../LLMService.typedefs';
+import { LLMCompletionService } from '../../../services/LLMCompletionService.abstract';
+import { CompletionParams, CompletionResult, LLMProviders } from '../../../LLMService.typedefs';
+import { YourProviderEntity } from '../YourProvider.entity';
+
+export class YourProviderCompletionService extends LLMCompletionService<LLMProviders.YourProvider> {
+  constructor(
+    logger: Logger,
+    private readonly providerEntity: YourProviderEntity,
+  ) {
+    super(logger);
+  }
+
+  async complete(params: CompletionParams): Promise<CompletionResult> {
+    this.logger.info('Starting completion with YourProvider', { params });
+
+    try {
+      // Implement provider-specific completion logic
+
+      return {
+        text: 'Completed text',
+        // Include other required fields
+      };
+    } catch (error) {
+      this.logger.error('Error in YourProvider completion', { error });
+      throw error;
+    }
+  }
+}
+```
+
+**AssistanceService (if applicable)**:
+
+```typescript
+import { Logger } from '../../../LLMService.typedefs';
+import { LLMAssistanceService } from '../../../services/LLMAssistanceService.abstract';
+import {
+  AssistantParams,
+  ThreadParams,
+  MessageParams,
+  LLMProviders
+} from '../../../LLMService.typedefs';
+import { YourProviderEntity } from '../YourProvider.entity';
+
+export class YourProviderAssistanceService extends LLMAssistanceService<LLMProviders.YourProvider> {
+  constructor(
+    logger: Logger,
+    private readonly providerEntity: YourProviderEntity,
+  ) {
+    super(logger);
+  }
+
+  // Implement required assistance methods
+}
+```
+
+### 7. Create Service Factory
+
+First, define service builders in `src/providers/YourProvider/YourProvider.constants.ts`:
+
+```typescript
+import {
+  LLMPurposes,
+  type LLMServiceBuilder,
+} from '../../LLMService.typedefs';
+import {
+  YourProviderAssistanceService,
+  YourProviderCompletionService,
+} from './services';
+
+export const YOUR_PROVIDER_SERVICE_BUILDERS: {
+  [purpose in LLMPurposes]: (
+    LLMServiceBuilder<LLMProviders.YourProvider, purpose> | null
+  )
+} = {
+  [LLMPurposes.Completion]: (logger, options) => (
+    new YourProviderCompletionService(logger, options)
+  ),
+  [LLMPurposes.Assistance]: (logger, options) => (
+    new YourProviderAssistanceService(logger, options)
+  ),
+};
+```
+
+Then, implement the service factory in `src/providers/YourProvider/YourProviderService.factory.ts`:
+
+```typescript
+import { type Logger } from '@mate-academy/core';
+import {
+  type LLMInstanceOptions,
+  LLMProviders,
+  type LLMPurposes,
+  type LLMServiceByPurpose,
+} from '../../LLMService.typedefs';
+import { LLMServicePurposeFactory } from '../../services';
+import { YOUR_PROVIDER_SERVICE_BUILDERS } from './YourProvider.constants';
+
+export class YourProviderServiceFactory extends LLMServicePurposeFactory<
+  LLMProviders.YourProvider
+> {
+  createService<
+    Purpose extends LLMPurposes
+  >(
+    purpose: Purpose,
+    logger: Logger,
+    options: LLMInstanceOptions[LLMProviders.YourProvider],
+  ): LLMServiceByPurpose<LLMProviders.YourProvider>[Purpose] {
+    const serviceBuilder = YOUR_PROVIDER_SERVICE_BUILDERS[purpose];
+
+    if (!serviceBuilder) {
+      throw new Error(`Purpose [${purpose}] is not supported for [${LLMProviders.YourProvider}] service`);
+    }
+
+    return serviceBuilder(logger, options);
+  }
+}
+```
+
+### 8. Update Entry Point Files
+
+Update the provider's `index.ts`:
+
+```typescript
+export * from './YourProvider.constants';
+export * from './YourProvider.entity';
+export * from './YourProvider.typedefs';
+export * from './YourProviderService.factory';
+export * from './services';
+```
+
+Update the main providers `index.ts` at `src/providers/index.ts`:
+
+```typescript
+// ... other providers
+export * from './YourProvider';
+```
+
+### 9. Update LLM Service Factory
+
+Modify `src/LLMService.factory.ts` to include your new provider:
+
+```typescript
+import {
+  LLMProviders,
+  Logger,
+  YourProviderOptions,
+} from './LLMService.typedefs';
+import { YourProviderServiceFactory } from './providers/YourProvider';
+import { YourProviderOptions } from './providers/YourProvider/YourProvider.typedefs';
+
+export class LLMServiceFactory {
+  static resolveProviderOptions<T extends LLMProviders>(
+    provider: T,
+    optionsMap: {
+      // ... other providers
+      [LLMProviders.YourProvider]?: YourProviderOptions;
+    },
+  ) {
+    return optionsMap[provider];
+  }
+
+  static getCompletionService<T extends LLMProviders>(
+    provider: T,
+    logger: Logger,
+    options: any,
+  ) {
+    switch (provider) {
+      // ... other providers
+      case LLMProviders.YourProvider:
+        return YourProviderServiceFactory.createCompletionService(logger, options);
+      default:
+        throw new Error(`Unsupported provider: ${provider}`);
+    }
+  }
+
+  static getAssistanceService<T extends LLMProviders>(
+    provider: T,
+    logger: Logger,
+    options: any,
+  ) {
+    switch (provider) {
+      // ... other providers
+      case LLMProviders.YourProvider:
+        return YourProviderServiceFactory.createAssistanceService(logger, options);
+      default:
+        throw new Error(`Unsupported provider: ${provider}`);
+    }
+  }
+}
+```
+
 ## License
 
 [MIT](LICENSE)

package/dist/LLMService.factory.d.ts

@@ -1,8 +1,51 @@
 import { type Logger } from '@mate-academy/core';
 import { type LLMInstanceOptions, LLMProviders, LLMPurposes, type LLMServiceByPurpose } from './LLMService.typedefs';
 export declare class LLMServiceFactory {
+    /**
+     * Gets a service for the specified LLM purpose and provider
+     *
+     * @private
+     * @static
+     * @template Purpose - The purpose of the LLM service (Completion or Assistance)
+     * @template Provider - The LLM provider (OpenAI, GoogleGenerativeAI)
+     * @param {Purpose} purpose - The purpose of the service
+     * @param {Provider} provider - The LLM provider
+     * @param {Logger} logger - Logger instance
+     * @param {LLMInstanceOptions[Provider]} options - Provider-specific options
+     * @returns {LLMServiceByPurpose<Provider>[Purpose]} The LLM service instance
+     * @throws {Error} If the provider is not supported
+     */
     private static getService;
+    /**
+     * Gets a completion service for the specified LLM provider
+     *
+     * @static
+     * @template Provider - The LLM provider type
+     * @param {Provider} provider - The LLM provider (OpenAI, GoogleGenerativeAI)
+     * @param {Logger} logger - Logger instance
+     * @param {LLMInstanceOptions[Provider]} options - Provider-specific options
+     * @returns {LLMServiceByPurpose<Provider>[LLMPurposes.Completion]} A completion service instance
+     */
     static getCompletionService<Provider extends LLMProviders>(provider: Provider, logger: Logger, options: LLMInstanceOptions[Provider]): LLMServiceByPurpose<Provider>[LLMPurposes.Completion];
+    /**
+     * Gets an assistance service for the specified LLM provider
+     *
+     * @static
+     * @template Provider - The LLM provider type
+     * @param {Provider} provider - The LLM provider (OpenAI, GoogleGenerativeAI)
+     * @param {Logger} logger - Logger instance
+     * @param {LLMInstanceOptions[Provider]} options - Provider-specific options
+     * @returns {LLMServiceByPurpose<Provider>[LLMPurposes.Assistance]} An assistance service instance
+     */
     static getAssistanceService<Provider extends LLMProviders>(provider: Provider, logger: Logger, options: LLMInstanceOptions[Provider]): LLMServiceByPurpose<Provider>[LLMPurposes.Assistance];
+    /**
+     * Resolves the options for the specified provider from an options map
+     *
+     * @static
+     * @template Provider - The LLM provider type
+     * @param {Provider} provider - The LLM provider to get options for
+     * @param {Record<Provider, LLMInstanceOptions[Provider]>} options - Map of provider options
+     * @returns {LLMInstanceOptions[Provider]} The options for the specified provider
+     */
     static resolveProviderOptions<Provider extends LLMProviders>(provider: Provider, options: Record<Provider, LLMInstanceOptions[Provider]>): LLMInstanceOptions[Provider];
 }

package/dist/LLMService.factory.js

@@ -4,6 +4,20 @@ exports.LLMServiceFactory = void 0;
 const LLMService_typedefs_1 = require("./LLMService.typedefs");
 const LLMService_constants_1 = require("./LLMService.constants");
 class LLMServiceFactory {
+    /**
+     * Gets a service for the specified LLM purpose and provider
+     *
+     * @private
+     * @static
+     * @template Purpose - The purpose of the LLM service (Completion or Assistance)
+     * @template Provider - The LLM provider (OpenAI, GoogleGenerativeAI)
+     * @param {Purpose} purpose - The purpose of the service
+     * @param {Provider} provider - The LLM provider
+     * @param {Logger} logger - Logger instance
+     * @param {LLMInstanceOptions[Provider]} options - Provider-specific options
+     * @returns {LLMServiceByPurpose<Provider>[Purpose]} The LLM service instance
+     * @throws {Error} If the provider is not supported
+     */
     static getService(purpose, provider, logger, options) {
         switch (provider) {
             case LLMService_typedefs_1.LLMProviders.OpenAI:
@@ -14,12 +28,41 @@ class LLMServiceFactory {
                 throw new Error(`Provider [${provider}] is not supported`);
         }
     }
+    /**
+     * Gets a completion service for the specified LLM provider
+     *
+     * @static
+     * @template Provider - The LLM provider type
+     * @param {Provider} provider - The LLM provider (OpenAI, GoogleGenerativeAI)
+     * @param {Logger} logger - Logger instance
+     * @param {LLMInstanceOptions[Provider]} options - Provider-specific options
+     * @returns {LLMServiceByPurpose<Provider>[LLMPurposes.Completion]} A completion service instance
+     */
     static getCompletionService(provider, logger, options) {
         return this.getService(LLMService_typedefs_1.LLMPurposes.Completion, provider, logger, options);
     }
+    /**
+     * Gets an assistance service for the specified LLM provider
+     *
+     * @static
+     * @template Provider - The LLM provider type
+     * @param {Provider} provider - The LLM provider (OpenAI, GoogleGenerativeAI)
+     * @param {Logger} logger - Logger instance
+     * @param {LLMInstanceOptions[Provider]} options - Provider-specific options
+     * @returns {LLMServiceByPurpose<Provider>[LLMPurposes.Assistance]} An assistance service instance
+     */
     static getAssistanceService(provider, logger, options) {
         return this.getService(LLMService_typedefs_1.LLMPurposes.Assistance, provider, logger, options);
     }
+    /**
+     * Resolves the options for the specified provider from an options map
+     *
+     * @static
+     * @template Provider - The LLM provider type
+     * @param {Provider} provider - The LLM provider to get options for
+     * @param {Record<Provider, LLMInstanceOptions[Provider]>} options - Map of provider options
+     * @returns {LLMInstanceOptions[Provider]} The options for the specified provider
+     */
     static resolveProviderOptions(provider, options) {
         return options[provider];
     }

package/dist/LLMService.factory.js.map

@@ -1 +1 @@
-{"version":3,"file":"LLMService.factory.js","sourceRoot":"","sources":["../src/LLMService.factory.ts"],"names":[],"mappings":";;;AACA,+DAK+B;AAC/B,iEAA+D;AAE/D,MAAa,iBAAiB;IAepB,MAAM,CAAC,UAAU,CAIvB,OAAgB,EAChB,QAAkB,EAClB,MAAc,EACd,OAAqC;QAErC,QAAQ,QAAQ,EAAE,CAAC;YACjB,KAAK,kCAAY,CAAC,MAAM,CAAC;YACzB,KAAK,kCAAY,CAAC,kBAAkB;gBAClC,OAAO,4CAAqB,CAAC,QAAQ,CAAC;qBACnC,aAAa,CACZ,OAAO,EACP,MAAM,EACN,OAAO,CACR,CAAC;YAEN;gBACE,MAAM,IAAI,KAAK,CAAC,aAAa,QAAQ,oBAAoB,CAAC,CAAC;QAC/D,CAAC;IACH,CAAC;IAYD,MAAM,CAAC,oBAAoB,CACzB,QAAkB,EAClB,MAAc,EACd,OAAqC;QAErC,OAAO,IAAI,CAAC,UAAU,CAAC,iCAAW,CAAC,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IAC5E,CAAC;IAYD,MAAM,CAAC,oBAAoB,CACzB,QAAkB,EAClB,MAAc,EACd,OAAqC;QAErC,OAAO,IAAI,CAAC,UAAU,CAAC,iCAAW,CAAC,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IAC5E,CAAC;IAWD,MAAM,CAAC,sBAAsB,CAC3B,QAAkB,EAClB,OAAuD;QAEvD,OAAO,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC3B,CAAC;CACF;AA1FD,8CA0FC"}
+{"version":3,"file":"LLMService.factory.js","sourceRoot":"","sources":["../src/LLMService.factory.ts"],"names":[],"mappings":";;;AACA,+DAK+B;AAC/B,iEAA+D;AAE/D,MAAa,iBAAiB;IAC5B;;;;;;;;;;;;;OAaG;IACK,MAAM,CAAC,UAAU,CAIvB,OAAgB,EAChB,QAAkB,EAClB,MAAc,EACd,OAAqC;QAErC,QAAQ,QAAQ,EAAE,CAAC;YACjB,KAAK,kCAAY,CAAC,MAAM,CAAC;YACzB,KAAK,kCAAY,CAAC,kBAAkB;gBAClC,OAAO,4CAAqB,CAAC,QAAQ,CAAC;qBACnC,aAAa,CACZ,OAAO,EACP,MAAM,EACN,OAAO,CACR,CAAC;YAEN;gBACE,MAAM,IAAI,KAAK,CAAC,aAAa,QAAQ,oBAAoB,CAAC,CAAC;QAC/D,CAAC;IACH,CAAC;IAED;;;;;;;;;OASG;IACH,MAAM,CAAC,oBAAoB,CACzB,QAAkB,EAClB,MAAc,EACd,OAAqC;QAErC,OAAO,IAAI,CAAC,UAAU,CAAC,iCAAW,CAAC,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IAC5E,CAAC;IAED;;;;;;;;;OASG;IACH,MAAM,CAAC,oBAAoB,CACzB,QAAkB,EAClB,MAAc,EACd,OAAqC;QAErC,OAAO,IAAI,CAAC,UAAU,CAAC,iCAAW,CAAC,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IAC5E,CAAC;IAED;;;;;;;;OAQG;IACH,MAAM,CAAC,sBAAsB,CAC3B,QAAkB,EAClB,OAAuD;QAEvD,OAAO,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC3B,CAAC;CACF;AA1FD,8CA0FC"}

package/dist/LLMService.typedefs.d.ts

@@ -5,100 +5,202 @@ import { type OpenAIModelNames } from './providers/OpenAI/OpenAI.typedefs';
 import { type GoogleGenerativeAIModelNames } from './providers/GoogleGenerativeAI/GoogleGenerativeAI.typedefs';
 import { type LLMCompletionService } from './services/LLMCompletionService.abstract';
 import { type LLMAssistanceService } from './services/LLMAssistanceService.abstract';
+/**
+ * Enum of supported LLM providers.
+ */
 export declare enum LLMProviders {
     OpenAI = "OpenAI",
     GoogleGenerativeAI = "GoogleGenerativeAI"
 }
+/**
+ * Maps each LLM provider to its corresponding instance type.
+ */
 export type LLMInstances = {
     [LLMProviders.OpenAI]: OpenAI;
     [LLMProviders.GoogleGenerativeAI]: GoogleGenAI;
 };
+/**
+ * Configuration options for initializing each LLM provider's client.
+ */
 export type LLMInstanceOptions = {
     [LLMProviders.OpenAI]: ClientOptions;
     [LLMProviders.GoogleGenerativeAI]: {
         apiKey: string;
     };
 };
+/**
+ * Supported service purposes/types that the LLM gateway provides.
+ */
 export declare enum LLMPurposes {
     Completion = "completion",
     Assistance = "assistance"
 }
+/**
+ * Maps each LLM purpose to its corresponding service implementation for a specific provider.
+ * @template Provider - The LLM provider type
+ */
 export type LLMServiceByPurpose<Provider extends LLMProviders> = {
     [LLMPurposes.Completion]: LLMCompletionService<Provider>;
     [LLMPurposes.Assistance]: LLMAssistanceService<Provider>;
 };
+/**
+ * Function type for building an LLM service instance for a specific provider and purpose.
+ * @template Provider - The LLM provider type
+ * @template Purpose - The service purpose type
+ * @param logger - Logger instance for service logging
+ * @param options - Provider-specific configuration options
+ * @returns An instance of the requested LLM service
+ */
 export type LLMServiceBuilder<Provider extends LLMProviders, Purpose extends LLMPurposes> = (logger: Logger, options: LLMInstanceOptions[Provider]) => LLMServiceByPurpose<Provider>[Purpose];
+/**
+ * Defines token limits for LLM models.
+ */
 export interface LLMLimits {
     maxInputTokens: number;
     maxOutputTokens: number;
 }
+/**
+ * Configuration parameters that control LLM generation behavior.
+ */
 export interface LLMConfig {
     temperature?: number;
     top_p?: number | null;
 }
+/**
+ * Maps a provider to all available models it can access.
+ * @template Provider - The LLM provider type
+ */
 export type LLMProviderAvailableModels<Provider extends LLMProviders> = Record<LLMModelName[Provider], LLMModel<Provider>>;
+/**
+ * Maps service purposes to the available models for a specific provider.
+ * @template Purpose - The service purpose type
+ * @template Provider - The LLM provider type
+ */
 export type LLMProviderModelsByPurpose<Purpose extends LLMPurposes, Provider extends LLMProviders> = Record<Purpose, Partial<LLMProviderAvailableModels<Provider>>>;
+/**
+ * Maps each provider to its supported model names.
+ */
 export type LLMModelName = {
     [LLMProviders.OpenAI]: OpenAIModelNames;
     [LLMProviders.GoogleGenerativeAI]: GoogleGenerativeAIModelNames;
 };
+/**
+ * Represents an LLM model with its configuration and limitations.
+ * @template Provider - The LLM provider type
+ */
 export interface LLMModel<Provider extends LLMProviders> {
     name: LLMModelName[Provider];
     limits: LLMLimits;
     config: LLMConfig;
 }
+/**
+ * Roles that can be assigned to messages in an LLM conversation.
+ */
 export declare enum LLMRoles {
     User = "user",
     Assistant = "assistant"
 }
+/**
+ * Represents a message in an LLM conversation.
+ */
 export interface LLMMessage {
     role: LLMRoles;
     content: string;
 }
+/**
+ * Represents an error that occurred during an LLM request.
+ */
 export type LLMRequestError = Error;
+/**
+ * Generic result type for LLM requests that can either succeed or fail.
+ * @template R - The type of the successful result
+ */
 export type LLMRequestResult<R> = R | {
     error: LLMRequestError;
 };
+/**
+ * Result type for LLM completion requests.
+ */
 export type LLMCompletionResult = LLMRequestResult<{
     text: string;
 }>;
+/**
+ * Options for sending a message to an LLM service.
+ * @template Provider - The LLM provider type
+ */
 export interface LLMSendMessageOptions<Provider extends LLMProviders> {
     message: LLMMessage;
     model: LLMModel<Provider>;
     history?: LLMMessage[];
     instructions?: string;
 }
+/**
+ * Supported MIME types for files that can be uploaded to LLM services.
+ */
 export declare enum LLMUploadFileMimeTypes {
     PNG = "image/png",
     PLAIN_TEXT = "text/plain"
 }
+/**
+ * Represents a file to be uploaded to an LLM service.
+ */
 export interface LLMUploadFile {
     mimeType: LLMUploadFileMimeTypes;
     name: string;
     path: string;
 }
+/**
+ * Represents a file that has been successfully uploaded to an LLM service.
+ */
 export interface LLMUploadedFile extends LLMUploadFile {
     fileId: string;
 }
+/**
+ * Result type for file upload operations.
+ */
 export type LLMUploadFileResult = LLMRequestResult<LLMUploadedFile>;
+/**
+ * Options for creating a file storage for a specific LLM provider.
+ * @template Provider - The LLM provider type
+ */
 export interface LLMCreateFileStorageOptions<Provider extends LLMProviders> {
     uploadedFiles: LLMUploadedFile[];
     model: LLMModel<Provider>;
     instructions?: string;
 }
+/**
+ * Represents a created file storage in an LLM service.
+ */
 export interface LLMCreatedFileStorage {
     storageId: string;
 }
+/**
+ * Result type for file storage creation operations.
+ */
 export type LLMCreateFileStorageResult = LLMRequestResult<LLMCreatedFileStorage>;
+/**
+ * Options for creating an assistant with a specific LLM provider.
+ * @template Provider - The LLM provider type
+ */
 export interface LLMCreateAssistantOptions<Provider extends LLMProviders> {
     model: LLMModel<Provider>;
     instructions?: string;
     storageIds?: string[];
 }
+/**
+ * Represents a created assistant in an LLM service.
+ */
 export interface LLMCreatedAssistant {
     assistantId: string;
 }
+/**
+ * Result type for assistant creation operations.
+ */
 export type LLMCreateAssistantResult = LLMRequestResult<LLMCreatedAssistant>;
+/**
+ * Options for creating a chat session with a specific LLM provider.
+ * @template Provider - The LLM provider type
+ */
 export interface LLMCreateChatOptions<Provider extends LLMProviders> {
     model: LLMModel<Provider>;
     instructions?: string;
@@ -106,21 +208,44 @@ export interface LLMCreateChatOptions<Provider extends LLMProviders> {
     files?: LLMUploadedFile[];
     storageId?: string;
 }
+/**
+ * Represents a created chat session in an LLM service.
+ */
 export interface LLMCreatedChat {
     chatId: string;
 }
+/**
+ * Result type for chat creation operations.
+ */
 export type LLMCreateChatResult = LLMRequestResult<LLMCreatedChat>;
+/**
+ * Extends LLMMessage with attachment and instruction capabilities for assistance services.
+ */
 export interface LLMAssistanceMessage extends LLMMessage {
     attachment?: LLMUploadFileResult;
     instructions?: string;
 }
+/**
+ * Options for using an assistant with a specific LLM provider.
+ * @template Provider - The LLM provider type
+ */
 export interface LLMAssistanceOptions<Provider extends LLMProviders> {
     model: LLMModel<Provider>;
     message: LLMAssistanceMessage;
     chatId: string;
     assistantId: string;
 }
+/**
+ * Result type for assistance requests.
+ */
 export type LLMAssistanceResult = LLMRequestResult<{
     text: string;
 }>;
+/**
+ * Function type for counting tokens in messages for a specific provider's model.
+ * @template Provider - The LLM provider type
+ * @param messages - Array of message strings to count tokens for
+ * @param model - The LLM model to use for token counting
+ * @returns Promise resolving to the number of tokens
+ */
 export type LLMCountTokensFunction<Provider extends LLMProviders> = (messages: string[], model: LLMModel<Provider>) => Promise<number>;

package/dist/LLMService.typedefs.js

@@ -1,21 +1,33 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.LLMUploadFileMimeTypes = exports.LLMRoles = exports.LLMPurposes = exports.LLMProviders = void 0;
+/**
+ * Enum of supported LLM providers.
+ */
 var LLMProviders;
 (function (LLMProviders) {
     LLMProviders["OpenAI"] = "OpenAI";
     LLMProviders["GoogleGenerativeAI"] = "GoogleGenerativeAI";
 })(LLMProviders || (exports.LLMProviders = LLMProviders = {}));
+/**
+ * Supported service purposes/types that the LLM gateway provides.
+ */
 var LLMPurposes;
 (function (LLMPurposes) {
     LLMPurposes["Completion"] = "completion";
     LLMPurposes["Assistance"] = "assistance";
 })(LLMPurposes || (exports.LLMPurposes = LLMPurposes = {}));
+/**
+ * Roles that can be assigned to messages in an LLM conversation.
+ */
 var LLMRoles;
 (function (LLMRoles) {
     LLMRoles["User"] = "user";
     LLMRoles["Assistant"] = "assistant";
 })(LLMRoles || (exports.LLMRoles = LLMRoles = {}));
+/**
+ * Supported MIME types for files that can be uploaded to LLM services.
+ */
 var LLMUploadFileMimeTypes;
 (function (LLMUploadFileMimeTypes) {
     LLMUploadFileMimeTypes["PNG"] = "image/png";

package/dist/LLMService.typedefs.js.map

@@ -1 +1 @@
-{"version":3,"file":"LLMService.typedefs.js","sourceRoot":"","sources":["../src/LLMService.typedefs.ts"],"names":[],"mappings":";;;AAWA,IAAY,YAGX;AAHD,WAAY,YAAY;IACtB,iCAAiB,CAAA;IACjB,yDAAyC,CAAA;AAC3C,CAAC,EAHW,YAAY,4BAAZ,YAAY,QAGvB;AAqBD,IAAY,WAGX;AAHD,WAAY,WAAW;IACrB,wCAAyB,CAAA;IACzB,wCAAyB,CAAA;AAC3B,CAAC,EAHW,WAAW,2BAAX,WAAW,QAGtB;AAwFD,IAAY,QAGX;AAHD,WAAY,QAAQ;IAClB,yBAAa,CAAA;IACb,mCAAuB,CAAA;AACzB,CAAC,EAHW,QAAQ,wBAAR,QAAQ,QAGnB;AAwCD,IAAY,sBAGX;AAHD,WAAY,sBAAsB;IAChC,2CAAiB,CAAA;IACjB,mDAAyB,CAAA;AAC3B,CAAC,EAHW,sBAAsB,sCAAtB,sBAAsB,QAGjC"}
+{"version":3,"file":"LLMService.typedefs.js","sourceRoot":"","sources":["../src/LLMService.typedefs.ts"],"names":[],"mappings":";;;AAQA;;GAEG;AACH,IAAY,YAGX;AAHD,WAAY,YAAY;IACtB,iCAAiB,CAAA;IACjB,yDAAyC,CAAA;AAC3C,CAAC,EAHW,YAAY,4BAAZ,YAAY,QAGvB;AAkBD;;GAEG;AACH,IAAY,WAGX;AAHD,WAAY,WAAW;IACrB,wCAAyB,CAAA;IACzB,wCAAyB,CAAA;AAC3B,CAAC,EAHW,WAAW,2BAAX,WAAW,QAGtB;AAqFD;;GAEG;AACH,IAAY,QAGX;AAHD,WAAY,QAAQ;IAClB,yBAAa,CAAA;IACb,mCAAuB,CAAA;AACzB,CAAC,EAHW,QAAQ,wBAAR,QAAQ,QAGnB;AAqCD;;GAEG;AACH,IAAY,sBAGX;AAHD,WAAY,sBAAsB;IAChC,2CAAiB,CAAA;IACjB,mDAAyB,CAAA;AAC3B,CAAC,EAHW,sBAAsB,sCAAtB,sBAAsB,QAGjC"}

package/dist/providers/GoogleGenerativeAI/GoogleGenerativeAI.constants.js

@@ -85,6 +85,7 @@ exports.GOOGLE_AI_MODELS = {
         GoogleGenerativeAI_typedefs_1.GoogleGenerativeAIModelNames.GEMINI_2_0_FLASH,
         GoogleGenerativeAI_typedefs_1.GoogleGenerativeAIModelNames.GEMINI_2_5_PRO_PREVIEW,
     ]),
+    // Stable models are used for assistance as they support additional methods
     [LLMService_typedefs_1.LLMPurposes.Assistance]: (0, functional_utils_1.pick)(GOOGLE_AI_AVAILABLE_MODELS, [
         GoogleGenerativeAI_typedefs_1.GoogleGenerativeAIModelNames.GEMINI_1_5_FLASH_STABLE,
         GoogleGenerativeAI_typedefs_1.GoogleGenerativeAIModelNames.GEMINI_1_5_PRO_STABLE,

package/dist/providers/GoogleGenerativeAI/GoogleGenerativeAI.constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"GoogleGenerativeAI.constants.js","sourceRoot":"","sources":["../../../src/providers/GoogleGenerativeAI/GoogleGenerativeAI.constants.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"GoogleGenerativeAI.constants.js","sourceRoot":"","sources":["../../../src/providers/GoogleGenerativeAI/GoogleGenerativeAI.constants.ts"],"names":[],"mappings":"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"}

package/dist/providers/GoogleGenerativeAI/services/GoogleGenerativeAIAssistance.service.js

@@ -173,11 +173,13 @@ class GoogleGenerativeAIAssistanceService extends services_1.LLMAssistanceServic
         return Promise.resolve();
     }
     createAssistant() {
+        // Google Generative AI does not have an assistant concept at the moment
         return Promise.resolve({
             assistantId: '',
         });
     }
     deleteAssistant() {
+        // Google Generative AI does not have an assistant concept at the moment
         return Promise.resolve();
     }
     async assistInChat(options) {

package/dist/providers/GoogleGenerativeAI/services/GoogleGenerativeAIAssistance.service.js.map

@@ -1 +1 @@
-{"version":3,"file":"GoogleGenerativeAIAssistance.service.js","sourceRoot":"","sources":["../../../../src/providers/GoogleGenerativeAI/services/GoogleGenerativeAIAssistance.service.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"GoogleGenerativeAIAssistance.service.js","sourceRoot":"","sources":["../../../../src/providers/GoogleGenerativeAI/services/GoogleGenerativeAIAssistance.service.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mate-academy/llm-gateway",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "description": "A gateway package for LLM services.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",