@launchdarkly/server-sdk-ai 0.11.3 → 0.12.0

package/dist/api/LDAIClient.d.ts

@@ -1,6 +1,8 @@
 import { LDContext } from '@launchdarkly/js-server-sdk-common';
 import { LDAIAgent, LDAIAgentConfig, LDAIAgentDefaults } from './agents';
+import { TrackedChat } from './chat';
 import { LDAIConfig, LDAIDefaults } from './config/LDAIConfig';
+import { SupportedAIProvider } from './providers';
 /**
  * Interface for performing AI operations using LaunchDarkly.
  */
@@ -126,5 +128,42 @@ export interface LDAIClient {
      * ```
      */
     agents<const T extends readonly LDAIAgentConfig[]>(agentConfigs: T, context: LDContext): Promise<Record<T[number]['key'], LDAIAgent>>;
+    /**
+     * Initializes and returns a new TrackedChat instance for chat interactions.
+     * This method serves as the primary entry point for creating TrackedChat instances from configuration.
+     *
+     * @param key The key identifying the AI chat configuration to use.
+     * @param context The standard LDContext used when evaluating flags.
+     * @param defaultValue A default value representing a standard AI chat config result.
+     * @param variables Dictionary of values for instruction interpolation.
+     * @returns A promise that resolves to the TrackedChat instance, or null if the configuration is disabled.
+     *
+     * @example
+     * ```
+     * const key = "customer_support_chat";
+     * const context = {...};
+     * const defaultValue = {
+     *   config: {
+     *     enabled: false,
+     *     model: { name: "gpt-4" },
+     *     messages: [
+     *       { role: "system", content: "You are a helpful customer support agent." }
+     *     ]
+     *   }
+     * };
+     * const variables = { customerName: 'John' };
+     *
+     * const chat = await client.initChat(key, context, defaultValue, variables);
+     * if (chat) {
+     *   const response = await chat.invoke("I need help with my order");
+     *   console.log(response.message.content);
+     *
+     *   // Access configuration and tracker if needed
+     *   console.log('Model:', chat.getConfig().model?.name);
+     *   chat.getTracker().trackSuccess();
+     * }
+     * ```
+     */
+    initChat(key: string, context: LDContext, defaultValue: LDAIDefaults, variables?: Record<string, unknown>, defaultAiProvider?: SupportedAIProvider): Promise<TrackedChat | undefined>;
 }
 //# sourceMappingURL=LDAIClient.d.ts.map

package/dist/api/LDAIClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"LDAIClient.d.ts","sourceRoot":"","sources":["../../src/api/LDAIClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,oCAAoC,CAAC;AAE/D,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AACzE,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAE/D;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAkDG;IACH,MAAM,CACJ,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,SAAS,EAClB,YAAY,EAAE,YAAY,EAC1B,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAClC,OAAO,CAAC,UAAU,CAAC,CAAC;IAEvB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;IACH,KAAK,CACH,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,SAAS,EAClB,YAAY,EAAE,iBAAiB,EAC/B,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAClC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEtB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAmCG;IACH,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,SAAS,eAAe,EAAE,EAC/C,YAAY,EAAE,CAAC,EACf,OAAO,EAAE,SAAS,GACjB,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC;CACjD"}
+{"version":3,"file":"LDAIClient.d.ts","sourceRoot":"","sources":["../../src/api/LDAIClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,oCAAoC,CAAC;AAE/D,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AACzE,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAElD;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAkDG;IACH,MAAM,CACJ,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,SAAS,EAClB,YAAY,EAAE,YAAY,EAC1B,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAClC,OAAO,CAAC,UAAU,CAAC,CAAC;IAEvB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;IACH,KAAK,CACH,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,SAAS,EAClB,YAAY,EAAE,iBAAiB,EAC/B,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAClC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEtB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAmCG;IACH,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,SAAS,eAAe,EAAE,EAC/C,YAAY,EAAE,CAAC,EACf,OAAO,EAAE,SAAS,GACjB,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC;IAEhD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAmCG;IACH,QAAQ,CACN,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,SAAS,EAClB,YAAY,EAAE,YAAY,EAC1B,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,iBAAiB,CAAC,EAAE,mBAAmB,GACtC,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAAC;CACrC"}

package/dist/api/chat/TrackedChat.d.ts

@@ -0,0 +1,54 @@
+import { LDAIConfig, LDMessage } from '../config/LDAIConfig';
+import { LDAIConfigTracker } from '../config/LDAIConfigTracker';
+import { AIProvider } from '../providers/AIProvider';
+import { ChatResponse } from './types';
+/**
+ * Concrete implementation of TrackedChat that provides chat functionality
+ * by delegating to an AIProvider implementation.
+ * This class handles conversation management and tracking, while delegating
+ * the actual model invocation to the provider.
+ */
+export declare class TrackedChat {
+    protected readonly aiConfig: LDAIConfig;
+    protected readonly tracker: LDAIConfigTracker;
+    protected readonly provider: AIProvider;
+    protected messages: LDMessage[];
+    constructor(aiConfig: LDAIConfig, tracker: LDAIConfigTracker, provider: AIProvider);
+    /**
+     * Invoke the chat model with a prompt string.
+     * This method handles conversation management and tracking, delegating to the provider's invokeModel method.
+     */
+    invoke(prompt: string): Promise<ChatResponse>;
+    /**
+     * Get the underlying AI configuration used to initialize this TrackedChat.
+     */
+    getConfig(): LDAIConfig;
+    /**
+     * Get the underlying AI configuration tracker used to initialize this TrackedChat.
+     */
+    getTracker(): LDAIConfigTracker;
+    /**
+     * Get the underlying AI provider instance.
+     * This provides direct access to the provider for advanced use cases.
+     */
+    getProvider(): AIProvider;
+    /**
+     * Append messages to the conversation history.
+     * Adds messages to the conversation history without invoking the model,
+     * which is useful for managing multi-turn conversations or injecting context.
+     *
+     * @param messages Array of messages to append to the conversation history
+     */
+    appendMessages(messages: LDMessage[]): void;
+    /**
+     * Get all messages in the conversation history.
+     *
+     * @param includeConfigMessages Whether to include the config messages from the AIConfig.
+     *                              Defaults to false.
+     * @returns Array of messages. When includeConfigMessages is true, returns both config
+     *          messages and conversation history with config messages prepended. When false,
+     *          returns only the conversation history messages.
+     */
+    getMessages(includeConfigMessages?: boolean): LDMessage[];
+}
+//# sourceMappingURL=TrackedChat.d.ts.map

package/dist/api/chat/TrackedChat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TrackedChat.d.ts","sourceRoot":"","sources":["../../../src/api/chat/TrackedChat.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC;;;;;GAKG;AACH,qBAAa,WAAW;IAIpB,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,UAAU;IACvC,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,iBAAiB;IAC7C,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,UAAU;IALzC,SAAS,CAAC,QAAQ,EAAE,SAAS,EAAE,CAAC;gBAGX,QAAQ,EAAE,UAAU,EACpB,OAAO,EAAE,iBAAiB,EAC1B,QAAQ,EAAE,UAAU;IAKzC;;;OAGG;IACG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAwBnD;;OAEG;IACH,SAAS,IAAI,UAAU;IAIvB;;OAEG;IACH,UAAU,IAAI,iBAAiB;IAI/B;;;OAGG;IACH,WAAW,IAAI,UAAU;IAIzB;;;;;;OAMG;IACH,cAAc,CAAC,QAAQ,EAAE,SAAS,EAAE,GAAG,IAAI;IAI3C;;;;;;;;OAQG;IACH,WAAW,CAAC,qBAAqB,GAAE,OAAe,GAAG,SAAS,EAAE;CAOjE"}

package/dist/api/chat/TrackedChat.js

@@ -0,0 +1,84 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TrackedChat = void 0;
+/**
+ * Concrete implementation of TrackedChat that provides chat functionality
+ * by delegating to an AIProvider implementation.
+ * This class handles conversation management and tracking, while delegating
+ * the actual model invocation to the provider.
+ */
+class TrackedChat {
+    constructor(aiConfig, tracker, provider) {
+        this.aiConfig = aiConfig;
+        this.tracker = tracker;
+        this.provider = provider;
+        this.messages = [];
+    }
+    /**
+     * Invoke the chat model with a prompt string.
+     * This method handles conversation management and tracking, delegating to the provider's invokeModel method.
+     */
+    async invoke(prompt) {
+        // Convert prompt string to LDMessage with role 'user' and add to conversation history
+        const userMessage = {
+            role: 'user',
+            content: prompt,
+        };
+        this.messages.push(userMessage);
+        // Prepend config messages to conversation history for model invocation
+        const configMessages = this.aiConfig.messages || [];
+        const allMessages = [...configMessages, ...this.messages];
+        // Delegate to provider-specific implementation with tracking
+        const response = await this.tracker.trackMetricsOf((result) => result.metrics, () => this.provider.invokeModel(allMessages));
+        // Add the assistant response to the conversation history
+        this.messages.push(response.message);
+        return response;
+    }
+    /**
+     * Get the underlying AI configuration used to initialize this TrackedChat.
+     */
+    getConfig() {
+        return this.aiConfig;
+    }
+    /**
+     * Get the underlying AI configuration tracker used to initialize this TrackedChat.
+     */
+    getTracker() {
+        return this.tracker;
+    }
+    /**
+     * Get the underlying AI provider instance.
+     * This provides direct access to the provider for advanced use cases.
+     */
+    getProvider() {
+        return this.provider;
+    }
+    /**
+     * Append messages to the conversation history.
+     * Adds messages to the conversation history without invoking the model,
+     * which is useful for managing multi-turn conversations or injecting context.
+     *
+     * @param messages Array of messages to append to the conversation history
+     */
+    appendMessages(messages) {
+        this.messages.push(...messages);
+    }
+    /**
+     * Get all messages in the conversation history.
+     *
+     * @param includeConfigMessages Whether to include the config messages from the AIConfig.
+     *                              Defaults to false.
+     * @returns Array of messages. When includeConfigMessages is true, returns both config
+     *          messages and conversation history with config messages prepended. When false,
+     *          returns only the conversation history messages.
+     */
+    getMessages(includeConfigMessages = false) {
+        if (includeConfigMessages) {
+            const configMessages = this.aiConfig.messages || [];
+            return [...configMessages, ...this.messages];
+        }
+        return [...this.messages];
+    }
+}
+exports.TrackedChat = TrackedChat;
+//# sourceMappingURL=TrackedChat.js.map

package/dist/api/chat/TrackedChat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TrackedChat.js","sourceRoot":"","sources":["../../../src/api/chat/TrackedChat.ts"],"names":[],"mappings":";;;AAKA;;;;;GAKG;AACH,MAAa,WAAW;IAGtB,YACqB,QAAoB,EACpB,OAA0B,EAC1B,QAAoB;QAFpB,aAAQ,GAAR,QAAQ,CAAY;QACpB,YAAO,GAAP,OAAO,CAAmB;QAC1B,aAAQ,GAAR,QAAQ,CAAY;QAEvC,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC;IACrB,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,MAAM,CAAC,MAAc;QACzB,sFAAsF;QACtF,MAAM,WAAW,GAAc;YAC7B,IAAI,EAAE,MAAM;YACZ,OAAO,EAAE,MAAM;SAChB,CAAC;QACF,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAEhC,uEAAuE;QACvE,MAAM,cAAc,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,IAAI,EAAE,CAAC;QACpD,MAAM,WAAW,GAAG,CAAC,GAAG,cAAc,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;QAE1D,6DAA6D;QAC7D,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,cAAc,CAChD,CAAC,MAAoB,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,EACxC,GAAG,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,WAAW,CAAC,CAC7C,CAAC;QAEF,yDAAyD;QACzD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAErC,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;OAEG;IACH,SAAS;QACP,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,UAAU;QACR,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED;;;OAGG;IACH,WAAW;QACT,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED;;;;;;OAMG;IACH,cAAc,CAAC,QAAqB;QAClC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,CAAC;IAClC,CAAC;IAED;;;;;;;;OAQG;IACH,WAAW,CAAC,wBAAiC,KAAK;QAChD,IAAI,qBAAqB,EAAE;YACzB,MAAM,cAAc,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,IAAI,EAAE,CAAC;YACpD,OAAO,CAAC,GAAG,cAAc,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;SAC9C;QACD,OAAO,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC5B,CAAC;CACF;AAxFD,kCAwFC"}

package/dist/api/chat/index.d.ts

@@ -0,0 +1,3 @@
+export * from './types';
+export * from './TrackedChat';
+//# sourceMappingURL=index.d.ts.map

package/dist/api/chat/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/api/chat/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,eAAe,CAAC"}

package/dist/api/chat/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./types"), exports);
+__exportStar(require("./TrackedChat"), exports);
+//# sourceMappingURL=index.js.map

package/dist/api/chat/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/api/chat/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0CAAwB;AACxB,gDAA8B"}

package/dist/api/chat/types.d.ts

@@ -0,0 +1,16 @@
+import { LDMessage } from '../config/LDAIConfig';
+import { LDAIMetrics } from '../metrics/LDAIMetrics';
+/**
+ * Chat response structure.
+ */
+export interface ChatResponse {
+    /**
+     * The response message from the AI.
+     */
+    message: LDMessage;
+    /**
+     * Metrics information including success status and token usage.
+     */
+    metrics: LDAIMetrics;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/api/chat/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/api/chat/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAErD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,OAAO,EAAE,SAAS,CAAC;IAEnB;;OAEG;IACH,OAAO,EAAE,WAAW,CAAC;CACtB"}

package/dist/api/chat/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/api/chat/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/api/chat/types.ts"],"names":[],"mappings":""}

package/dist/api/config/LDAIConfigTracker.d.ts

@@ -1,4 +1,4 @@
-import { LDFeedbackKind, LDTokenUsage } from '../metrics';
+import { LDAIMetrics, LDFeedbackKind, LDTokenUsage } from '../metrics';
 /**
  * Metrics which have been tracked.
  */
@@ -78,6 +78,21 @@ export interface LDAIConfigTracker {
      * @returns The result of the function.
      */
     trackDurationOf(func: () => Promise<any>): Promise<any>;
+    /**
+     * Track metrics for a generic AI operation.
+     *
+     * This function will track the duration of the operation, extract metrics using the provided
+     * metrics extractor function, and track success or error status accordingly.
+     *
+     * If the provided function throws, then this method will also throw.
+     * In the case the provided function throws, this function will record the duration and an error.
+     * A failed operation will not have any token usage data.
+     *
+     * @param metricsExtractor Function that extracts LDAIMetrics from the operation result
+     * @param func Function which executes the operation
+     * @returns The result of the operation
+     */
+    trackMetricsOf<TRes>(metricsExtractor: (result: TRes) => LDAIMetrics, func: () => Promise<TRes>): Promise<TRes>;
     /**
      * Track an OpenAI operation.
      *
@@ -133,7 +148,9 @@ export interface LDAIConfigTracker {
     trackVercelAISDKGenerateTextMetrics<TRes extends {
         usage?: {
             totalTokens?: number;
+            inputTokens?: number;
             promptTokens?: number;
+            outputTokens?: number;
             completionTokens?: number;
         };
     }>(func: () => Promise<TRes>): Promise<TRes>;
@@ -153,7 +170,9 @@ export interface LDAIConfigTracker {
         finishReason?: Promise<string>;
         usage?: Promise<{
             totalTokens?: number;
+            inputTokens?: number;
             promptTokens?: number;
+            outputTokens?: number;
             completionTokens?: number;
         }>;
     }>(func: () => TRes): TRes;

package/dist/api/config/LDAIConfigTracker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"LDAIConfigTracker.d.ts","sourceRoot":"","sources":["../../../src/api/config/LDAIConfigTracker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1D;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,MAAM,CAAC,EAAE,YAAY,CAAC;IAEtB;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;OAEG;IACH,QAAQ,CAAC,EAAE;QAAE,IAAI,EAAE,cAAc,CAAA;KAAE,CAAC;IAEpC;;OAEG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;;;OAMG;IACH,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAExC;;;;OAIG;IACH,WAAW,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;IAExC;;OAEG;IACH,YAAY,IAAI,IAAI,CAAC;IAErB;;OAEG;IACH,UAAU,IAAI,IAAI,CAAC;IAEnB;;;;OAIG;IACH,aAAa,CAAC,QAAQ,EAAE;QAAE,IAAI,EAAE,cAAc,CAAA;KAAE,GAAG,IAAI,CAAC;IAExD;;;;OAIG;IACH,qBAAqB,CAAC,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAExD;;;;;;;;;;OAUG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,OAAO,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAExD;;;;;;;;;;;OAWG;IACH,kBAAkB,CAChB,IAAI,SAAS;QACX,KAAK,CAAC,EAAE;YACN,YAAY,CAAC,EAAE,MAAM,CAAC;YACtB,aAAa,CAAC,EAAE,MAAM,CAAC;YACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC;SAC5B,CAAC;KACH,EAED,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GACxB,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB;;;;;;;OAOG;IACH,2BAA2B,CACzB,IAAI,SAAS;QACX,SAAS,EAAE;YAAE,cAAc,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QACvC,OAAO,CAAC,EAAE;YAAE,SAAS,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QACjC,KAAK,CAAC,EAAE;YACN,WAAW,CAAC,EAAE,MAAM,CAAC;YACrB,YAAY,CAAC,EAAE,MAAM,CAAC;YACtB,WAAW,CAAC,EAAE,MAAM,CAAC;SACtB,CAAC;KACH,EAED,GAAG,EAAE,IAAI,GACR,IAAI,CAAC;IAER;;;;;;;;;;;OAWG;IACH,mCAAmC,CACjC,IAAI,SAAS;QACX,KAAK,CAAC,EAAE;YACN,WAAW,CAAC,EAAE,MAAM,CAAC;YACrB,YAAY,CAAC,EAAE,MAAM,CAAC;YACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;SAC3B,CAAC;KACH,EAED,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GACxB,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB;;;;;;;;;;;OAWG;IACH,iCAAiC,CAC/B,IAAI,SAAS;QACX,YAAY,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QAC/B,KAAK,CAAC,EAAE,OAAO,CAAC;YACd,WAAW,CAAC,EAAE,MAAM,CAAC;YACrB,YAAY,CAAC,EAAE,MAAM,CAAC;YACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;SAC3B,CAAC,CAAC;KACJ,EAED,IAAI,EAAE,MAAM,IAAI,GACf,IAAI,CAAC;IAER;;OAEG;IACH,UAAU,IAAI,iBAAiB,CAAC;CACjC"}
+{"version":3,"file":"LDAIConfigTracker.d.ts","sourceRoot":"","sources":["../../../src/api/config/LDAIConfigTracker.ts"],"names":[],"mappings":"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"}

package/dist/api/config/VercelAISDK.d.ts

@@ -7,6 +7,7 @@ export interface VercelAISDKConfig<TMod> {
     model: TMod;
     messages?: LDMessage[] | undefined;
     maxTokens?: number | undefined;
+    maxOutputTokens?: number | undefined;
     temperature?: number | undefined;
     topP?: number | undefined;
     topK?: number | undefined;

package/dist/api/config/VercelAISDK.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"VercelAISDK.d.ts","sourceRoot":"","sources":["../../../src/api/config/VercelAISDK.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C,MAAM,MAAM,mBAAmB,CAAC,IAAI,IAAI,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;AAEpE,MAAM,WAAW,qBAAqB;IACpC,uBAAuB,CAAC,EAAE,SAAS,EAAE,GAAG,SAAS,CAAC;CACnD;AAED,MAAM,WAAW,iBAAiB,CAAC,IAAI;IACrC,KAAK,EAAE,IAAI,CAAC;IACZ,QAAQ,CAAC,EAAE,SAAS,EAAE,GAAG,SAAS,CAAC;IACnC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,gBAAgB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,aAAa,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IACrC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B"}
+{"version":3,"file":"VercelAISDK.d.ts","sourceRoot":"","sources":["../../../src/api/config/VercelAISDK.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C,MAAM,MAAM,mBAAmB,CAAC,IAAI,IAAI,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;AAEpE,MAAM,WAAW,qBAAqB;IACpC,uBAAuB,CAAC,EAAE,SAAS,EAAE,GAAG,SAAS,CAAC;CACnD;AAED,MAAM,WAAW,iBAAiB,CAAC,IAAI;IACrC,KAAK,EAAE,IAAI,CAAC;IACZ,QAAQ,CAAC,EAAE,SAAS,EAAE,GAAG,SAAS,CAAC;IACnC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,gBAAgB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,aAAa,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IACrC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B"}

package/dist/api/index.d.ts

@@ -1,5 +1,7 @@
 export * from './config';
 export * from './agents';
+export * from './chat';
 export * from './metrics';
 export * from './LDAIClient';
+export * from './providers';
 //# sourceMappingURL=index.d.ts.map

package/dist/api/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC"}

package/dist/api/index.js

@@ -16,6 +16,8 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./config"), exports);
 __exportStar(require("./agents"), exports);
+__exportStar(require("./chat"), exports);
 __exportStar(require("./metrics"), exports);
 __exportStar(require("./LDAIClient"), exports);
+__exportStar(require("./providers"), exports);
 //# sourceMappingURL=index.js.map

package/dist/api/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,2CAAyB;AACzB,4CAA0B;AAC1B,+CAA6B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,2CAAyB;AACzB,yCAAuB;AACvB,4CAA0B;AAC1B,+CAA6B;AAC7B,8CAA4B"}

package/dist/api/metrics/LDAIMetrics.d.ts

@@ -0,0 +1,17 @@
+import { LDTokenUsage } from './LDTokenUsage';
+/**
+ * Metrics information for AI operations that includes success status and token usage.
+ * This class combines success/failure tracking with token usage metrics.
+ */
+export interface LDAIMetrics {
+    /**
+     * Whether the AI operation was successful.
+     */
+    success: boolean;
+    /**
+     * Token usage information for the operation.
+     * This will be undefined if no token usage data is available.
+     */
+    usage?: LDTokenUsage;
+}
+//# sourceMappingURL=LDAIMetrics.d.ts.map

package/dist/api/metrics/LDAIMetrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LDAIMetrics.d.ts","sourceRoot":"","sources":["../../../src/api/metrics/LDAIMetrics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;;OAGG;IACH,KAAK,CAAC,EAAE,YAAY,CAAC;CACtB"}

package/dist/api/metrics/LDAIMetrics.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=LDAIMetrics.js.map

package/dist/api/metrics/LDAIMetrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LDAIMetrics.js","sourceRoot":"","sources":["../../../src/api/metrics/LDAIMetrics.ts"],"names":[],"mappings":""}

package/dist/api/metrics/VercelAISDKTokenUsage.d.ts

@@ -1,7 +1,9 @@
 import { LDTokenUsage } from './LDTokenUsage';
 export declare function createVercelAISDKTokenUsage(data: {
     totalTokens?: number;
+    inputTokens?: number;
     promptTokens?: number;
+    outputTokens?: number;
     completionTokens?: number;
 }): LDTokenUsage;
 //# sourceMappingURL=VercelAISDKTokenUsage.d.ts.map

package/dist/api/metrics/VercelAISDKTokenUsage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"VercelAISDKTokenUsage.d.ts","sourceRoot":"","sources":["../../../src/api/metrics/VercelAISDKTokenUsage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,wBAAgB,2BAA2B,CAAC,IAAI,EAAE;IAChD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,GAAG,YAAY,CAMf"}
+{"version":3,"file":"VercelAISDKTokenUsage.d.ts","sourceRoot":"","sources":["../../../src/api/metrics/VercelAISDKTokenUsage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,wBAAgB,2BAA2B,CAAC,IAAI,EAAE;IAChD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,GAAG,YAAY,CAMf"}

package/dist/api/metrics/VercelAISDKTokenUsage.js

@@ -2,11 +2,11 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createVercelAISDKTokenUsage = void 0;
 function createVercelAISDKTokenUsage(data) {
-    var _a, _b, _c;
+    var _a, _b, _c, _d, _e;
     return {
         total: (_a = data.totalTokens) !== null && _a !== void 0 ? _a : 0,
-        input: (_b = data.promptTokens) !== null && _b !== void 0 ? _b : 0,
-        output: (_c = data.completionTokens) !== null && _c !== void 0 ? _c : 0,
+        input: (_c = (_b = data.inputTokens) !== null && _b !== void 0 ? _b : data.promptTokens) !== null && _c !== void 0 ? _c : 0,
+        output: (_e = (_d = data.outputTokens) !== null && _d !== void 0 ? _d : data.completionTokens) !== null && _e !== void 0 ? _e : 0,
     };
 }
 exports.createVercelAISDKTokenUsage = createVercelAISDKTokenUsage;

package/dist/api/metrics/VercelAISDKTokenUsage.js.map

@@ -1 +1 @@
-{"version":3,"file":"VercelAISDKTokenUsage.js","sourceRoot":"","sources":["../../../src/api/metrics/VercelAISDKTokenUsage.ts"],"names":[],"mappings":";;;AAEA,SAAgB,2BAA2B,CAAC,IAI3C;;IACC,OAAO;QACL,KAAK,EAAE,MAAA,IAAI,CAAC,WAAW,mCAAI,CAAC;QAC5B,KAAK,EAAE,MAAA,IAAI,CAAC,YAAY,mCAAI,CAAC;QAC7B,MAAM,EAAE,MAAA,IAAI,CAAC,gBAAgB,mCAAI,CAAC;KACnC,CAAC;AACJ,CAAC;AAVD,kEAUC"}
+{"version":3,"file":"VercelAISDKTokenUsage.js","sourceRoot":"","sources":["../../../src/api/metrics/VercelAISDKTokenUsage.ts"],"names":[],"mappings":";;;AAEA,SAAgB,2BAA2B,CAAC,IAM3C;;IACC,OAAO;QACL,KAAK,EAAE,MAAA,IAAI,CAAC,WAAW,mCAAI,CAAC;QAC5B,KAAK,EAAE,MAAA,MAAA,IAAI,CAAC,WAAW,mCAAI,IAAI,CAAC,YAAY,mCAAI,CAAC;QACjD,MAAM,EAAE,MAAA,MAAA,IAAI,CAAC,YAAY,mCAAI,IAAI,CAAC,gBAAgB,mCAAI,CAAC;KACxD,CAAC;AACJ,CAAC;AAZD,kEAYC"}

package/dist/api/metrics/index.d.ts

@@ -1,6 +1,7 @@
 export * from './BedrockTokenUsage';
 export * from './OpenAiUsage';
 export * from './LDFeedbackKind';
+export * from './LDAIMetrics';
 export * from './LDTokenUsage';
 export * from './VercelAISDKTokenUsage';
 //# sourceMappingURL=index.d.ts.map

package/dist/api/metrics/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/api/metrics/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/api/metrics/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,yBAAyB,CAAC"}

package/dist/api/metrics/index.js

@@ -17,6 +17,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./BedrockTokenUsage"), exports);
 __exportStar(require("./OpenAiUsage"), exports);
 __exportStar(require("./LDFeedbackKind"), exports);
+__exportStar(require("./LDAIMetrics"), exports);
 __exportStar(require("./LDTokenUsage"), exports);
 __exportStar(require("./VercelAISDKTokenUsage"), exports);
 //# sourceMappingURL=index.js.map

package/dist/api/metrics/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/api/metrics/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,sDAAoC;AACpC,gDAA8B;AAC9B,mDAAiC;AACjC,iDAA+B;AAC/B,0DAAwC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/api/metrics/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,sDAAoC;AACpC,gDAA8B;AAC9B,mDAAiC;AACjC,gDAA8B;AAC9B,iDAA+B;AAC/B,0DAAwC"}

package/dist/api/providers/AIProvider.d.ts

@@ -0,0 +1,35 @@
+import { LDLogger } from '@launchdarkly/js-server-sdk-common';
+import { ChatResponse } from '../chat/types';
+import { LDAIConfig, LDMessage } from '../config/LDAIConfig';
+/**
+ * Abstract base class for AI providers that implement chat model functionality.
+ * This class provides the contract that all provider implementations must follow
+ * to integrate with LaunchDarkly's tracking and configuration capabilities.
+ *
+ * Following the AICHAT spec recommendation to use base classes with non-abstract methods
+ * for better extensibility and backwards compatibility.
+ */
+export declare abstract class AIProvider {
+    protected readonly logger?: LDLogger;
+    constructor(logger?: LDLogger);
+    /**
+     * Invoke the chat model with an array of messages.
+     * This method should convert messages to provider format, invoke the model,
+     * and return a ChatResponse with the result and metrics.
+     *
+     * @param messages Array of LDMessage objects representing the conversation
+     * @returns Promise that resolves to a ChatResponse containing the model's response
+     */
+    abstract invokeModel(messages: LDMessage[]): Promise<ChatResponse>;
+    /**
+     * Static method that constructs an instance of the provider.
+     * Each provider implementation must provide their own static create method
+     * that accepts an AIConfig and returns a configured instance.
+     *
+     * @param aiConfig The LaunchDarkly AI configuration
+     * @param logger Optional logger for the provider
+     * @returns Promise that resolves to a configured provider instance
+     */
+    static create(aiConfig: LDAIConfig, logger?: LDLogger): Promise<AIProvider>;
+}
+//# sourceMappingURL=AIProvider.d.ts.map

package/dist/api/providers/AIProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AIProvider.d.ts","sourceRoot":"","sources":["../../../src/api/providers/AIProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAC;AAE9D,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAE7D;;;;;;;GAOG;AACH,8BAAsB,UAAU;IAC9B,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC;gBAEzB,MAAM,CAAC,EAAE,QAAQ;IAG7B;;;;;;;OAOG;IACH,QAAQ,CAAC,WAAW,CAAC,QAAQ,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,YAAY,CAAC;IAElE;;;;;;;;OAQG;WAEU,MAAM,CAAC,QAAQ,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC;CAGlF"}

package/dist/api/providers/AIProvider.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AIProvider = void 0;
+/**
+ * Abstract base class for AI providers that implement chat model functionality.
+ * This class provides the contract that all provider implementations must follow
+ * to integrate with LaunchDarkly's tracking and configuration capabilities.
+ *
+ * Following the AICHAT spec recommendation to use base classes with non-abstract methods
+ * for better extensibility and backwards compatibility.
+ */
+class AIProvider {
+    constructor(logger) {
+        this.logger = logger;
+    }
+    /**
+     * Static method that constructs an instance of the provider.
+     * Each provider implementation must provide their own static create method
+     * that accepts an AIConfig and returns a configured instance.
+     *
+     * @param aiConfig The LaunchDarkly AI configuration
+     * @param logger Optional logger for the provider
+     * @returns Promise that resolves to a configured provider instance
+     */
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    static async create(aiConfig, logger) {
+        throw new Error('Provider implementations must override the static create method');
+    }
+}
+exports.AIProvider = AIProvider;
+//# sourceMappingURL=AIProvider.js.map

package/dist/api/providers/AIProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AIProvider.js","sourceRoot":"","sources":["../../../src/api/providers/AIProvider.ts"],"names":[],"mappings":";;;AAKA;;;;;;;GAOG;AACH,MAAsB,UAAU;IAG9B,YAAY,MAAiB;QAC3B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAWD;;;;;;;;OAQG;IACH,6DAA6D;IAC7D,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,QAAoB,EAAE,MAAiB;QACzD,MAAM,IAAI,KAAK,CAAC,iEAAiE,CAAC,CAAC;IACrF,CAAC;CACF;AA7BD,gCA6BC"}

package/dist/api/providers/AIProviderFactory.d.ts

@@ -0,0 +1,39 @@
+import { LDLogger } from '@launchdarkly/js-server-sdk-common';
+import { LDAIConfig } from '../config/LDAIConfig';
+import { AIProvider } from './AIProvider';
+/**
+ * List of supported AI providers.
+ */
+export declare const SUPPORTED_AI_PROVIDERS: readonly ["openai", "langchain", "vercel"];
+/**
+ * Type representing the supported AI providers.
+ */
+export type SupportedAIProvider = (typeof SUPPORTED_AI_PROVIDERS)[number];
+/**
+ * Factory for creating AIProvider instances based on the provider configuration.
+ */
+export declare class AIProviderFactory {
+    /**
+     * Create an AIProvider instance based on the AI configuration.
+     * This method attempts to load provider-specific implementations dynamically.
+     * Returns undefined if the provider is not supported.
+     *
+     * @param aiConfig The AI configuration
+     * @param logger Optional logger for logging provider initialization
+     * @param defaultAiProvider Optional default AI provider to use
+     */
+    static create(aiConfig: LDAIConfig, logger?: LDLogger, defaultAiProvider?: SupportedAIProvider): Promise<AIProvider | undefined>;
+    /**
+     * Determine which providers to try based on defaultAiProvider and providerName.
+     */
+    private static _getProvidersToTry;
+    /**
+     * Try to create a provider of the specified type.
+     */
+    private static _tryCreateProvider;
+    /**
+     * Create a provider instance dynamically.
+     */
+    private static _createProvider;
+}
+//# sourceMappingURL=AIProviderFactory.d.ts.map

package/dist/api/providers/AIProviderFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AIProviderFactory.d.ts","sourceRoot":"","sources":["../../../src/api/providers/AIProviderFactory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAC;AAE9D,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C;;GAEG;AACH,eAAO,MAAM,sBAAsB,4CAKzB,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE1E;;GAEG;AACH,qBAAa,iBAAiB;IAC5B;;;;;;;;OAQG;WACU,MAAM,CACjB,QAAQ,EAAE,UAAU,EACpB,MAAM,CAAC,EAAE,QAAQ,EACjB,iBAAiB,CAAC,EAAE,mBAAmB,GACtC,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;IAsBlC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,kBAAkB;IA0BjC;;OAEG;mBACkB,kBAAkB;IAgCvC;;OAEG;mBACkB,eAAe;CAyBrC"}