@memberjunction/ai-prompts 3.4.0 → 4.0.0

package/dist/AIPromptRunner.d.ts

@@ -1,8 +1,64 @@
-/// <reference types="node" />
 import { ChatResult, ChatMessage } from '@memberjunction/ai';
 import { AIPromptRunResult } from '@memberjunction/ai-core-plus';
 import { AIModelEntityExtended, AIPromptEntityExtended, AIPromptRunEntityExtended } from "@memberjunction/ai-core-plus";
 import { TemplateMessageRole, AIPromptParams } from '@memberjunction/ai-core-plus';
+/**
+ * Advanced AI Prompt execution engine with comprehensive template support, hierarchical template composition,
+ * sophisticated model selection, parallelization, output validation, and execution tracking.
+ *
+ * ## Core Features
+ * - **Template-based prompt generation** using MJ Templates system
+ * - **Hierarchical template composition** with depth-first rendering and parallel template processing
+ * - **Advanced model selection** strategies (Default, Specific, ByPower)
+ * - **Parallel execution** with multiple models and execution groups
+ * - **Structured output validation** and type conversion with retry logic
+ * - **Comprehensive execution tracking** with agent run linking
+ * - **Configuration-driven behavior** with caching and performance optimization
+ * - **Real-time progress updates** and streaming response support
+ *
+ * ## Hierarchical Template Composition
+ * When `childPrompts` array is provided in {@link AIPromptParams}:
+ * 1. Renders child prompt templates in depth-first manner (children before parents)
+ * 2. At each level, renders sibling templates in parallel for optimal performance
+ * 3. Recursively handles grandchild templates (unlimited nesting depth)
+ * 4. Substitutes rendered child templates into corresponding placeholders in parent template
+ * 5. Executes the final composed prompt as a single operation
+ *
+ * This enables complex prompt composition patterns where templates can be built from reusable
+ * sub-templates, creating sophisticated prompts through hierarchical template inheritance.
+ *
+ * ## Agent Integration
+ * - Links executions to agent runs via `agentRunId` parameter
+ * - Supports agent decision-making workflows with structured JSON responses
+ * - Enables hierarchical template patterns in AI agents
+ *
+ * @example Basic Usage
+ * ```typescript
+ * const runner = new AIPromptRunner();
+ * const params = new AIPromptParams();
+ * params.prompt = aiPrompt;
+ * params.data = { key: 'value' };
+ * const result = await runner.ExecutePrompt(params);
+ * ```
+ *
+ * @example Hierarchical Template Composition
+ * ```typescript
+ * const params = new AIPromptParams();
+ * params.prompt = parentPrompt;
+ * params.childPrompts = [
+ *   new ChildPromptParam(analysisPrompt, 'analysis'),
+ *   new ChildPromptParam(summaryPrompt, 'summary'),
+ *   new ChildPromptParam(complexChild, 'complex') // This can have its own child templates
+ * ];
+ * params.data = { userInput: 'complex data to process' };
+ * const result = await runner.ExecutePrompt(params);
+ * // Child templates render first, then parent template uses {{ analysis }}, {{ summary }}, {{ complex }}
+ * // Final composed prompt is executed once
+ * ```
+ */
+/**
+ * Represents a model-vendor pair candidate for execution
+ */
 interface ModelVendorCandidate {
     model: AIModelEntityExtended;
     vendorId?: string;
@@ -15,6 +71,9 @@ interface ModelVendorCandidate {
     priority: number;
     source: 'explicit' | 'prompt-model' | 'model-type' | 'power-rank';
 }
+/**
+ * Configuration for failover behavior when primary model fails
+ */
 interface FailoverConfiguration {
     strategy: 'SameModelDifferentVendor' | 'NextBestModel' | 'PowerRank' | 'None';
     maxAttempts: number;
@@ -22,6 +81,9 @@ interface FailoverConfiguration {
     modelStrategy?: 'PreferSameModel' | 'PreferDifferentModel' | 'RequireSameModel';
     errorScope?: 'All' | 'NetworkOnly' | 'RateLimitOnly' | 'ServiceErrorOnly';
 }
+/**
+ * Tracks information about a failover attempt
+ */
 interface FailoverAttempt {
     attemptNumber: number;
     modelId: string;
@@ -38,8 +100,21 @@ export declare class AIPromptRunner {
     private _parallelCoordinator;
     private _jsonValidator;
     constructor();
+    /**
+     * Performs robust validation of an API key
+     * @returns true if the API key is valid (not null, undefined, or empty/whitespace)
+     */
     private isValidAPIKey;
+    /**
+     * Internal logging helper that wraps LogStatusEx with verbose control
+     * @param message The message to log
+     * @param verboseOnly Whether this is a verbose-only message
+     * @param params Optional prompt parameters for custom verbose check
+     */
     protected logStatus(message: string, verboseOnly?: boolean, params?: AIPromptParams): void;
+    /**
+     * Helper method for enhanced error logging with metadata
+     */
     protected logError(error: Error | string, options?: {
         category?: string;
         metadata?: Record<string, any>;
@@ -48,78 +123,541 @@ export declare class AIPromptRunner {
         severity?: 'warning' | 'error' | 'critical';
         maxErrorLength?: number;
     }): void;
+    /**
+     * Checks if a model vendor is configured as an inference provider
+     * @param modelVendor The model vendor to check
+     * @returns true if the vendor is an inference provider
+     */
     private isInferenceProvider;
+    /**
+     * Resolves credentials for AI model execution using a hierarchical resolution system.
+     *
+     * Resolution priority (highest to lowest):
+     * 1. Per-request override: params.credentialId
+     * 2. Prompt-Model specific: AIPromptModel.CredentialID
+     * 3. Model-Vendor specific: AIModelVendor.CredentialID
+     * 4. Vendor default: AIVendor.CredentialID
+     * 5. Legacy: params.apiKeys[] array
+     * 6. Legacy: AI_VENDOR_API_KEY__<DRIVER> environment variables
+     *
+     * IMPORTANT: When ANY credential ID is found (priorities 1-4), the system uses
+     * the Credentials path and ignores legacy methods (priorities 5-6).
+     *
+     * @param driverClass - The driver class name (e.g., 'OpenAILLM')
+     * @param promptId - The prompt ID for looking up AIPromptModel credentials
+     * @param modelId - The model ID for looking up AIPromptModel and AIModelVendor credentials
+     * @param vendorId - The vendor ID for looking up AIModelVendor and AIVendor credentials
+     * @param params - The prompt execution parameters containing contextUser and optional credentialId
+     * @returns The API key/configuration string to pass to the LLM constructor
+     */
     private resolveCredentialForExecution;
+    /**
+     * Attempts to resolve credentials from bindings with priority-based failover.
+     * Tries each binding in priority order until one succeeds.
+     */
     private tryCredentialBindingsWithFailover;
+    /**
+     * Attempts to resolve a single credential, returning null on failure for failover support.
+     */
     private tryResolveCredential;
+    /**
+     * Resolves a credential by its explicit ID (used for per-request override).
+     * This does not support failover since it's an explicit choice.
+     */
     private resolveCredentialById;
+    /**
+     * Finds a default credential matching a specific credential type.
+     */
     private findDefaultCredentialByType;
+    /**
+     * Checks if credentials are available for a given model-vendor combination.
+     * This is a pre-flight check used during model selection to determine which
+     * candidates have valid authentication configured.
+     *
+     * Checks the credential hierarchy:
+     * 1. Per-request override: params.credentialId
+     * 2. PromptModel bindings: AICredentialBinding WHERE BindingType='PromptModel'
+     * 3. ModelVendor bindings: AICredentialBinding WHERE BindingType='ModelVendor'
+     * 4. Vendor bindings: AICredentialBinding WHERE BindingType='Vendor'
+     * 5. Type-based default: Credential.IsDefault=1 matching AIVendor.CredentialTypeID
+     * 6. Legacy: params.apiKeys[] array
+     * 7. Legacy: AI_VENDOR_API_KEY__<DRIVER> environment variables
+     *
+     * @param driverClass - The driver class name (e.g., 'OpenAILLM')
+     * @param promptId - The prompt ID for looking up AIPromptModel bindings
+     * @param modelId - The model ID for looking up AIPromptModel and AIModelVendor bindings
+     * @param vendorId - The vendor ID for looking up AIModelVendor and AIVendor bindings
+     * @param params - The prompt execution parameters
+     * @returns true if credentials are available, false otherwise
+     */
     private hasCredentialsAvailable;
+    /**
+     * Executes an AI prompt with full support for templates, model selection, and validation.
+     *
+     * @param params Parameters for prompt execution
+     * @returns Promise<AIPromptRunResult<T>> The execution result with tracking information
+     *
+     * @example
+     * ```typescript
+     * // Execute with specific result type
+     * interface AnalysisResult {
+     *   sentiment: string;
+     *   score: number;
+     *   keywords: string[];
+     * }
+     *
+     * const result = await promptRunner.ExecutePrompt<AnalysisResult>({
+     *   prompt: sentimentPrompt,
+     *   data: { text: "Customer feedback text" }
+     * });
+     *
+     * if (result.success && result.result) {
+     *   // result.result is typed as AnalysisResult
+     *   console.log(`Sentiment: ${result.result.sentiment}, Score: ${result.result.score}`);
+     * }
+     * ```
+     */
     ExecutePrompt<T = unknown>(params: AIPromptParams): Promise<AIPromptRunResult<T>>;
+    /**
+     * Executes a single prompt (non-parallel) using traditional model selection.
+     *
+     * @param prompt - The AI prompt to execute
+     * @param renderedPromptText - The rendered prompt text
+     * @param params - Original execution parameters
+     * @param startTime - Execution start time
+     * @returns Promise<AIPromptRunResult<T>> - The execution result
+     */
     private executeSinglePrompt;
+    /**
+     * Executes a prompt using parallel execution with multiple models/tasks.
+     *
+     * @param prompt - The AI prompt to execute
+     * @param renderedPromptText - The rendered prompt text
+     * @param params - Original execution parameters
+     * @param startTime - Execution start time
+     * @returns Promise<AIPromptRunResult<T>> - The aggregated execution result
+     */
     private executePromptInParallel;
+    /**
+     * Loads a template entity by ID
+     */
     private loadTemplate;
+    /**
+     * Renders child prompt templates in a depth-first manner, composing them into a final template.
+     *
+     * @param childPrompts - Array of child prompts to render templates for
+     * @param params - Original execution parameters for context
+     * @param cancellationToken - Cancellation token for aborting rendering
+     * @returns Promise with rendered templates map
+     */
     private renderChildPromptTemplates;
+    /**
+     * Renders a prompt template with child prompt templates merged into the data context.
+     *
+     * @param prompt - The AI prompt to render
+     * @param params - Original execution parameters
+     * @param childTemplates - Map of placeholder names to rendered child prompt templates
+     * @returns Promise<string> - The rendered prompt text with child templates embedded
+     */
     private renderPromptWithChildTemplates;
+    /**
+     * Selects the appropriate AI model based on prompt configuration and parameters.
+     * Uses the unified buildModelVendorCandidates method to create an ordered list of candidates,
+     * then selects the first one with an available API key.
+     */
     private selectModel;
+    /**
+     * Builds a unified, ordered list of model-vendor candidates based on all selection criteria.
+     * Uses a 3-phase approach to properly handle SelectionStrategy='Specific' with AIPromptModel priorities.
+     *
+     * Phase 1: Handle explicit model ID (highest priority)
+     * Phase 2: Check if SelectionStrategy='Specific' with AIPromptModel entries - use ONLY those with AIPromptModel priorities
+     * Phase 3: Use general selection strategy (fallback) - blended priorities from legacy behavior
+     *
+     * @param prompt - The AI prompt with selection criteria
+     * @param explicitModelId - Explicitly specified model ID (highest priority)
+     * @param configurationId - Configuration ID for filtering
+     * @param preferredVendorId - Preferred vendor ID
+     * @returns Ordered array of model-vendor candidates (highest priority first)
+     */
     private buildModelVendorCandidates;
+    /**
+     * PHASE 1: Build candidates for explicitly specified model ID.
+     * Returns candidates for the single model if it's active and compatible.
+     */
     private buildCandidatesForExplicitModel;
+    /**
+     * PHASE 2: Build candidates for 'Specific' selection strategy.
+     * Uses AIPromptModel configuration with clean ranking:
+     * 1. Config-matching models first (by priority DESC)
+     * 2. Then universal (null config) models (by priority DESC)
+     */
     private buildCandidatesForSpecificStrategy;
+    /**
+     * PHASE 3: Build candidates for general selection strategies ('Default' or 'ByPower').
+     * Uses configuration-aware fallback hierarchy with legacy blended priority calculation.
+     */
     private buildCandidatesForGeneralSelection;
+    /**
+     * Helper: Filter prompt models by configuration matching rules.
+     * Supports configuration inheritance - includes models from the entire inheritance chain.
+     */
     private filterPromptModelsByConfiguration;
+    /**
+     * Helper: Sort prompt models for 'Specific' strategy.
+     * Respects configuration inheritance chain - child configs first, then parents, then null-config.
+     * Within each config level, sorts by priority DESC.
+     */
     private sortPromptModelsForSpecificStrategy;
+    /**
+     * Helper: Build candidates from sorted AIPromptModel records.
+     * Expands VendorID=null to all vendors for that model.
+     */
     private buildCandidatesFromPromptModels;
+    /**
+     * Helper: Create candidate for specific vendor from AIPromptModel.
+     */
     private createCandidateForSpecificVendor;
+    /**
+     * Helper: Create candidates for all vendors of a model, sorted by vendor priority.
+     */
     private createCandidatesForAllVendors;
+    /**
+     * Helper: Get prompt models for configuration with inheritance chain fallback.
+     * Walks the configuration inheritance chain looking for prompt models.
+     * Returns models from the first config in the chain that has any, or falls back to null-config.
+     */
     private getPromptModelsForConfiguration;
+    /**
+     * Helper: Add prompt-specific candidates with blended priorities (legacy behavior).
+     */
     private addPromptSpecificCandidates;
+    /**
+     * Helper: Add configuration fallback candidates from the inheritance chain.
+     * Adds models from parent configs (with decreasing priority) and null-config models as final fallback.
+     */
     private addConfigurationFallbackCandidates;
+    /**
+     * Helper: Add strategy-based candidates when no prompt models exist.
+     */
     private addStrategyBasedCandidates;
+    /**
+     * Helper: Get model pool filtered for strategy.
+     */
     private getModelPoolForStrategy;
+    /**
+     * Helper: Sort model pool by selection strategy.
+     */
     private sortModelPoolByStrategy;
+    /**
+     * Helper: Sort models by power preference.
+     */
     private sortByPowerPreference;
+    /**
+     * Helper: Create candidates for a model with AIModelVendor priorities (legacy behavior).
+     */
     private createCandidatesForModel;
+    /**
+     * Creates a properly typed AIModelSelectionInfo instance.
+     * TypeScript requires instantiating the class to get the getValidCandidates() method.
+     */
     private createSelectionInfo;
+    /**
+     * Converts model selection info into ModelVendorCandidate array for retry logic.
+     * Extracts only the valid candidates (those with available API keys) from the selection info.
+     *
+     * @param selectionInfo - Model selection information containing considered models
+     * @returns Array of valid model-vendor candidates sorted by priority
+     */
     private buildCandidatesFromSelectionInfo;
+    /**
+     * Enhanced version of selectModelWithAPIKey that tracks all considered models
+     * for model selection reporting. Uses the hierarchical credential resolution
+     * system to check for available credentials.
+     *
+     * @param candidates - Ordered array of model-vendor candidates
+     * @param promptId - The prompt ID for credential resolution
+     * @param params - Optional prompt parameters for verbose logging and credential override
+     * @returns Object containing selected candidate and all considered models
+     */
     private selectModelWithAPIKeyTracked;
+    /**
+     * Creates an AIPromptRun entity for execution tracking
+     */
     private createPromptRun;
+    /**
+     * Renders the prompt template with provided data
+     */
     private renderPromptTemplate;
+    /**
+     * Executes the AI model with failover support
+     *
+     * @remarks
+     * This method wraps the core executeModel functionality with intelligent failover
+     * capabilities. It will attempt to execute with different models/vendors according
+     * to the configured failover strategy when errors occur.
+     *
+     * The method calls several smaller, focused helper methods:
+     * - buildFailoverCandidates: Creates candidate models based on type restrictions
+     * - createCandidatesFromModels: Converts models to vendor-specific candidates
+     * - updatePromptRunWithFailoverSuccess: Records successful failover metadata
+     * - updatePromptRunWithFailoverFailure: Records failed failover metadata
+     * - createFailoverErrorResult: Creates standardized error response
+     */
     protected executeModelWithFailover(model: AIModelEntityExtended, renderedPrompt: string, prompt: AIPromptEntityExtended, params: AIPromptParams, vendorId: string | null, conversationMessages?: ChatMessage[], templateMessageRole?: TemplateMessageRole, cancellationToken?: AbortSignal, allCandidates?: ModelVendorCandidate[], promptRun?: AIPromptRunEntityExtended, vendorDriverClass?: string, vendorApiName?: string, vendorSupportsEffortLevel?: boolean, modelEffortLevel?: number): Promise<ChatResult>;
+    /**
+     * Builds failover candidates for a prompt based on available models and type restrictions
+     */
     protected buildFailoverCandidates(prompt: AIPromptEntityExtended): Promise<ModelVendorCandidate[]>;
+    /**
+     * Creates model-vendor candidates from a list of models
+     */
     protected createCandidatesFromModels(models: AIModelEntityExtended[]): ModelVendorCandidate[];
+    /**
+     * Updates prompt run with successful failover tracking data
+     */
     protected updatePromptRunWithFailoverSuccess(promptRun: AIPromptRunEntityExtended, failoverAttempts: FailoverAttempt[], currentModel: AIModelEntityExtended, currentVendorId: string | null): void;
+    /**
+     * Updates prompt run with failover failure tracking data
+     */
     private updatePromptRunWithFailoverFailure;
+    /**
+     * Creates an error result for failed failover attempts
+     */
     private createFailoverErrorResult;
+    /**
+     * Executes the AI model with the rendered prompt
+     */
     private executeModel;
+    /**
+     * Builds the message array combining rendered prompt with conversation messages
+     */
     private buildMessageArray;
+    /**
+     * Executes the model with retry logic for validation failures
+     */
     private executeWithValidationRetries;
+    /**
+     * Applies retry delay based on the prompt's retry strategy
+     */
+    /**
+     * Calculates retry delay for rate limit and other retriable errors.
+     * Uses the prompt's RetryStrategy and can respect suggested delays from provider.
+     */
     private calculateRetryDelay;
     private applyRetryDelay;
+    /**
+     * Filters out all candidates from a vendor when a vendor-level error occurs.
+     * Vendor-level errors affect all models from that vendor:
+     * - Authentication: Invalid API key
+     * - VendorValidationError: API schema/validation requirements
+     */
     private filterVendorCandidates;
+    /**
+     * Handles rate limit errors by retrying the same model/vendor with backoff.
+     * Returns true if the caller should continue (retry), false if should proceed to failover.
+     */
     private handleRateLimitRetry;
+    /**
+     * Processes a failover error (either from catch block or from failed ChatResult).
+     * Handles vendor filtering, rate limit retries, fatal error detection, and failover logic.
+     *
+     * @returns Decision object indicating whether to retry same model, continue to next candidate, or stop
+     */
     private processFailoverError;
+    /**
+     * Transitions to the next failover candidate.
+     * Returns the next candidate info or null if no candidates are available.
+     */
     private transitionToNextCandidate;
+    /**
+     * Provides a human-readable description of the validation decision
+     */
     private getValidationDecisionDescription;
+    /**
+     * Generates a JSON schema from an example object for validation
+     */
     private generateSchemaFromExample;
+    /**
+     * Detects if a key/value pair looks like a placeholder or example value
+     */
     private isLikelyPlaceholder;
+    /**
+     * Detects if an entire object looks like it contains only placeholder/example data
+     */
     private isObjectLikelyPlaceholder;
+    /**
+     * Generates schema for a specific value type
+     */
     private generateSchemaForValue;
+    /**
+     * Enhanced parsing and validation with detailed error reporting and JSON repair capabilities.
+     *
+     * @param modelResult - The raw result from the AI model
+     * @param prompt - The AI prompt entity containing configuration
+     * @param skipValidation - Whether to skip validation
+     * @param cleanValidationSyntax - Whether to clean validation syntax from results
+     * @param params - Optional prompt parameters containing additional configuration like attemptJSONRepair
+     * @returns Parsed result with optional validation results and errors
+     */
     private parseAndValidateResultEnhanced;
+    /**
+     * Parses a string output value.
+     *
+     * @param rawOutput - The raw output from the model
+     * @returns The parsed string value
+     */
     private parseStringOutput;
+    /**
+     * Parses a number output value with validation.
+     *
+     * @param rawOutput - The raw output from the model
+     * @param skipValidation - Whether to skip validation
+     * @param validationErrors - Array to collect validation errors
+     * @returns The parsed number value
+     * @throws Error if the value cannot be parsed as a number and validation is enabled
+     */
     private parseNumberOutput;
+    /**
+     * Parses a boolean output value with flexible input handling.
+     *
+     * @param rawOutput - The raw output from the model
+     * @param skipValidation - Whether to skip validation
+     * @param validationErrors - Array to collect validation errors
+     * @returns The parsed boolean value
+     * @throws Error if the value cannot be parsed as a boolean and validation is enabled
+     */
     private parseBooleanOutput;
+    /**
+     * Parses a date output value with validation.
+     *
+     * @param rawOutput - The raw output from the model
+     * @param skipValidation - Whether to skip validation
+     * @param validationErrors - Array to collect validation errors
+     * @returns The parsed Date value
+     * @throws Error if the value cannot be parsed as a date and validation is enabled
+     */
     private parseDateOutput;
+    /**
+     * Parses an object (JSON) output value with optional repair capabilities.
+     *
+     * @param rawOutput - The raw output from the model
+     * @param prompt - The AI prompt entity containing configuration
+     * @param skipValidation - Whether to skip validation
+     * @param cleanValidationSyntax - Whether to clean validation syntax
+     * @param validationErrors - Array to collect validation errors
+     * @param params - Optional prompt parameters containing attemptJSONRepair flag
+     * @returns The parsed object value
+     * @throws Error if the value cannot be parsed as JSON and validation is enabled
+     */
     private parseObjectOutput;
+    /**
+     * Attempts to repair malformed JSON using a two-step process.
+     *
+     * @param rawOutput - The malformed JSON string
+     * @param originalError - The original parsing error
+     * @param params - Prompt parameters containing contextUser
+     * @returns The repaired and parsed JSON object
+     * @throws Error if JSON repair fails
+     */
     private attemptJSONRepair;
+    /**
+     * Validates parsed result against JSON schema derived from OutputExample
+     */
     private validateAgainstSchema;
+    /**
+     * Updates the AIPromptRun entity with execution results
+     */
     private updatePromptRun;
+    /**
+     * Estimates the number of tokens in a rendered prompt and conversation messages.
+     * This is a rough estimation based on character count and typical token ratios.
+     *
+     * @param renderedPrompt - The rendered prompt text
+     * @param conversationMessages - Optional conversation messages
+     * @returns Estimated token count
+     */
+    /**
+     * Retrieves failover configuration from the prompt entity.
+     *
+     * @param prompt - The AI prompt entity containing failover settings
+     * @returns FailoverConfiguration object with strategy and settings
+     *
+     * @remarks
+     * This method extracts failover configuration from the prompt entity and provides
+     * default values when configuration is not specified. Override this method to
+     * implement custom failover configuration logic.
+     */
     protected getFailoverConfiguration(prompt: AIPromptEntityExtended): FailoverConfiguration;
+    /**
+     * Determines whether a failover attempt should be made based on the error and configuration.
+     *
+     * @param error - The error that occurred during execution
+     * @param config - The failover configuration
+     * @param attemptNumber - The current attempt number (1-based)
+     * @returns True if failover should be attempted, false otherwise
+     *
+     * @remarks
+     * This method uses the ErrorAnalyzer to classify errors and determine if they are
+     * eligible for failover based on the configured error scope. Override this method
+     * to implement custom failover decision logic.
+     */
     protected shouldAttemptFailover(error: Error, config: FailoverConfiguration, attemptNumber: number): boolean;
+    /**
+     * Checks if an error type matches the configured error scope
+     *
+     * @param errorType - The error type from ErrorAnalyzer
+     * @param scope - The configured error scope
+     * @returns True if the error matches the scope
+     */
     private errorMatchesScope;
+    /**
+     * Calculates the delay before the next failover attempt.
+     *
+     * @param attemptNumber - The current attempt number (1-based)
+     * @param baseDelaySeconds - The base delay in seconds from configuration
+     * @param previousError - The error from the previous attempt
+     * @returns Delay in milliseconds before the next attempt
+     *
+     * @remarks
+     * Implements exponential backoff with jitter by default. The delay increases
+     * exponentially with each attempt and includes random jitter to prevent
+     * thundering herd problems. Override this method to implement custom delay logic.
+     */
     protected calculateFailoverDelay(attemptNumber: number, baseDelaySeconds: number): number;
+    /**
+     * Selects candidate models for failover based on the strategy and current failure.
+     *
+     * @param currentModel - The model that just failed
+     * @param currentVendorId - The vendor ID that just failed
+     * @param strategy - The failover strategy to use
+     * @param modelStrategy - The model selection preference
+     * @param allCandidates - All available model-vendor candidates
+     * @param attemptHistory - History of previous failover attempts
+     * @returns Array of candidates sorted by priority (highest first)
+     *
+     * @remarks
+     * This method implements different strategies for selecting failover candidates:
+     * - SameModelDifferentVendor: Try the same model with different vendors
+     * - NextBestModel: Try different models in order of preference
+     * - PowerRank: Use the global power ranking of models
+     *
+     * Override this method to implement custom candidate selection logic.
+     */
     protected selectFailoverCandidates(currentModel: AIModelEntityExtended, currentVendorId: string | undefined, strategy: FailoverConfiguration['strategy'], modelStrategy: FailoverConfiguration['modelStrategy'], allCandidates: ModelVendorCandidate[], attemptHistory: FailoverAttempt[]): ModelVendorCandidate[];
+    /**
+     * Logs a failover attempt for tracking and debugging.
+     *
+     * @param promptId - The ID of the prompt being executed
+     * @param attempt - The failover attempt details
+     * @param willRetry - Whether another attempt will be made
+     *
+     * @remarks
+     * This method logs detailed information about each failover attempt to help with
+     * debugging and monitoring. Override this method to implement custom logging or
+     * integrate with external monitoring systems.
+     */
     protected logFailoverAttempt(promptId: string, attempt: FailoverAttempt, willRetry: boolean): void;
 }
-export declare function LoadAIPromptRunner(): void;
 export {};
 //# sourceMappingURL=AIPromptRunner.d.ts.map

package/dist/AIPromptRunner.d.ts.map

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