genai-lite 0.2.0 → 0.3.0

package/dist/llm/LLMService.d.ts

@@ -1,13 +1,8 @@
 import type { ApiKeyProvider } from '../types';
-import type { LLMChatRequest, LLMResponse, LLMFailureResponse, ProviderInfo, ModelInfo, ApiProviderId } from "./types";
-import type { ILLMClientAdapter } from "./clients/types";
+import type { LLMChatRequest, LLMChatRequestWithPreset, LLMResponse, LLMFailureResponse, ProviderInfo, ModelInfo, ApiProviderId, LLMSettings, ModelContext, LLMMessage } from "./types";
 import type { ModelPreset } from "../types/presets";
-/**
- * Defines how custom presets interact with the default presets.
- * 'replace': Use only the custom presets provided. The default set is ignored.
- * 'extend': Use the default presets, and add/override them with the custom presets. This is the default behavior.
- */
-export type PresetMode = 'replace' | 'extend';
+import { type PresetMode } from "./services/PresetManager";
+export type { PresetMode };
 /**
  * Options for configuring the LLMService
  */
@@ -17,6 +12,17 @@ export interface LLMServiceOptions {
     /** The strategy for integrating custom presets. Defaults to 'extend'. */
     presetMode?: PresetMode;
 }
+/**
+ * Result from createMessages method
+ */
+export interface CreateMessagesResult {
+    /** The parsed messages with role assignments */
+    messages: LLMMessage[];
+    /** Model context variables that were injected during template rendering */
+    modelContext: ModelContext | null;
+    /** Settings extracted from the template's <META> block */
+    settings: Partial<LLMSettings>;
+}
 /**
  * Main process service for LLM operations
  *
@@ -30,9 +36,11 @@ export interface LLMServiceOptions {
  */
 export declare class LLMService {
     private getApiKey;
-    private clientAdapters;
-    private mockClientAdapter;
-    private presets;
+    private presetManager;
+    private adapterRegistry;
+    private requestValidator;
+    private settingsManager;
+    private modelResolver;
     constructor(getApiKey: ApiKeyProvider, options?: LLMServiceOptions);
     /**
      * Gets list of supported LLM providers
@@ -53,58 +61,52 @@ export declare class LLMService {
      * @param request - The LLM chat request
      * @returns Promise resolving to either success or failure response
      */
-    sendMessage(request: LLMChatRequest): Promise<LLMResponse | LLMFailureResponse>;
+    sendMessage(request: LLMChatRequest | LLMChatRequestWithPreset): Promise<LLMResponse | LLMFailureResponse>;
     /**
-     * Validates basic LLM request structure
+     * Gets all configured model presets
      *
-     * @param request - The request to validate
-     * @returns LLMFailureResponse if validation fails, null if valid
+     * @returns Array of model presets
      */
-    private validateRequestStructure;
+    getPresets(): ModelPreset[];
     /**
-     * Merges request settings with model-specific and global defaults
+     * Creates messages from a template with role tags and model-aware variable substitution
      *
-     * @param modelId - The model ID to get defaults for
-     * @param providerId - The provider ID to get defaults for
-     * @param requestSettings - Settings from the request
-     * @returns Complete settings object with all required fields
-     */
-    private mergeSettingsForModel;
-    /**
-     * Gets the appropriate client adapter for a provider
+     * This unified method combines the functionality of template rendering, model context
+     * injection, and role tag parsing into a single, intuitive API. It replaces the need
+     * to chain prepareMessage and buildMessagesFromTemplate for model-aware multi-turn prompts.
      *
-     * @param providerId - The provider ID
-     * @returns The client adapter to use
-     */
-    private getClientAdapter;
-    /**
-     * Registers a client adapter for a specific provider
+     * @param options Options for creating messages
+     * @returns Promise resolving to parsed messages and model context
      *
-     * @param providerId - The provider ID
-     * @param adapter - The client adapter implementation
+     * @example
+     * ```typescript
+     * const { messages } = await llm.createMessages({
+     *   template: `
+     *     <SYSTEM>You are a {{ thinking_enabled ? "thoughtful" : "helpful" }} assistant.</SYSTEM>
+     *     <USER>Help me with {{ task }}</USER>
+     *   `,
+     *   variables: { task: 'understanding async/await' },
+     *   presetId: 'openai-gpt-4.1-default'
+     * });
+     * ```
      */
-    registerClientAdapter(providerId: ApiProviderId, adapter: ILLMClientAdapter): void;
+    createMessages(options: {
+        template: string;
+        variables?: Record<string, any>;
+        presetId?: string;
+        providerId?: string;
+        modelId?: string;
+    }): Promise<CreateMessagesResult>;
     /**
      * Gets information about registered adapters
      *
      * @returns Map of provider IDs to adapter info
      */
-    getRegisteredAdapters(): Map<ApiProviderId, any>;
+    getRegisteredAdapters(): Map<string, import("./services/AdapterRegistry").AdapterInfo>;
     /**
      * Gets a summary of available providers and their adapter status
      *
      * @returns Summary of provider availability
      */
-    getProviderSummary(): {
-        totalProviders: number;
-        providersWithAdapters: number;
-        availableProviders: string[];
-        unavailableProviders: string[];
-    };
-    /**
-     * Gets all configured model presets
-     *
-     * @returns Array of model presets
-     */
-    getPresets(): ModelPreset[];
+    getProviderSummary(): import("./services/AdapterRegistry").ProviderSummary;
 }