@launchdarkly/server-sdk-ai 0.16.5 → 0.16.7

package/dist/index.d.cts

@@ -367,7 +367,7 @@ interface LDJudgeConfiguration {
     judges: LDJudge[];
 }
 /**
- * Base AI Config interface for default implementations with optional enabled property.
+ * Base AI Config for default implementations with optional enabled property.
  */
 interface LDAIConfigDefault {
     /**
@@ -514,9 +514,9 @@ interface LDAIAgentRequestConfig {
      */
     key: string;
     /**
-     * Default configuration for the agent.
+     * Default configuration for the agent. When omitted or null, a disabled default is used.
      */
-    defaultValue: LDAIAgentConfigDefault;
+    defaultValue?: LDAIAgentConfigDefault;
     /**
      * Variables for instructions interpolation.
      */
@@ -768,8 +768,8 @@ interface LDAIClient {
      * @param context The LaunchDarkly context object that contains relevant information about the
      * current environment, user, or session. This context may influence how the configuration is
      * processed or personalized.
-     * @param defaultValue A fallback value containing model configuration and messages. This will
-     * be used if the configuration is not available from LaunchDarkly.
+     * @param defaultValue Optional fallback when the configuration is not available from LaunchDarkly.
+     * When omitted or null, a disabled default is used.
      * @param variables A map of key-value pairs representing dynamic variables to be injected into
      * the message content. The keys correspond to placeholders within the template, and the values
      * are the corresponding replacements.
@@ -784,7 +784,7 @@ interface LDAIClient {
      * const context = {...};
      * const variables = {username: 'john'};
      * const defaultValue = {
-     *  enabled: false,
+     *  enabled: true,
      *  model: { name: 'gpt-4' },
      *  provider: { name: 'openai' },
      * };
@@ -813,11 +813,11 @@ interface LDAIClient {
      * }
      * ```
      */
-    completionConfig(key: string, context: LDContext, defaultValue: LDAICompletionConfigDefault, variables?: Record<string, unknown>): Promise<LDAICompletionConfig>;
+    completionConfig(key: string, context: LDContext, defaultValue?: LDAICompletionConfigDefault, variables?: Record<string, unknown>): Promise<LDAICompletionConfig>;
     /**
      * @deprecated Use `completionConfig` instead. This method will be removed in a future version.
      */
-    config(key: string, context: LDContext, defaultValue: LDAICompletionConfigDefault, variables?: Record<string, unknown>): Promise<LDAICompletionConfig>;
+    config(key: string, context: LDContext, defaultValue?: LDAICompletionConfigDefault, variables?: Record<string, unknown>): Promise<LDAICompletionConfig>;
     /**
      * Retrieves and processes a single AI Config agent based on the provided key, LaunchDarkly context,
      * and variables. This includes the model configuration and the customized instructions.
@@ -826,7 +826,8 @@ interface LDAIClient {
      * @param context The LaunchDarkly context object that contains relevant information about the
      * current environment, user, or session. This context may influence how the configuration is
      * processed or personalized.
-     * @param defaultValue A fallback value containing model configuration and instructions.
+     * @param defaultValue Optional fallback when the configuration is not available from LaunchDarkly.
+     * When omitted or null, a disabled default is used.
      * @param variables A map of key-value pairs representing dynamic variables to be injected into
      * the instructions. The keys correspond to placeholders within the template, and the values
      * are the corresponding replacements.
@@ -851,11 +852,11 @@ interface LDAIClient {
      * agentConfig.tracker.trackSuccess();
      * ```
      */
-    agentConfig(key: string, context: LDContext, defaultValue: LDAIAgentConfigDefault, variables?: Record<string, unknown>): Promise<LDAIAgentConfig>;
+    agentConfig(key: string, context: LDContext, defaultValue?: LDAIAgentConfigDefault, variables?: Record<string, unknown>): Promise<LDAIAgentConfig>;
     /**
      * @deprecated Use `agentConfig` instead. This method will be removed in a future version.
      */
-    agent(key: string, context: LDContext, defaultValue: LDAIAgentConfigDefault, variables?: Record<string, unknown>): Promise<LDAIAgentConfig>;
+    agent(key: string, context: LDContext, defaultValue?: LDAIAgentConfigDefault, variables?: Record<string, unknown>): Promise<LDAIAgentConfig>;
     /**
      * Retrieves and processes a Judge AI Config based on the provided key, LaunchDarkly context,
      * and variables. This includes the model configuration and the customized messages for evaluation.
@@ -864,8 +865,8 @@ interface LDAIClient {
      * @param context The LaunchDarkly context object that contains relevant information about the
      * current environment, user, or session. This context may influence how the configuration is
      * processed or personalized.
-     * @param defaultValue A fallback value containing model configuration and messages. This will
-     * be used if the configuration is not available from LaunchDarkly.
+     * @param defaultValue Optional fallback when the configuration is not available from LaunchDarkly.
+     * When omitted or null, a disabled default is used.
      * @param variables Optional variables for template interpolation in messages and instructions.
      * @returns A promise that resolves to a tracked judge configuration.
      *
@@ -883,13 +884,13 @@ interface LDAIClient {
      * judgeConf.tracker.trackSuccess();
      * ```
      */
-    judgeConfig(key: string, context: LDContext, defaultValue: LDAIJudgeConfigDefault, variables?: Record<string, unknown>): Promise<LDAIJudgeConfig>;
+    judgeConfig(key: string, context: LDContext, defaultValue?: LDAIJudgeConfigDefault, variables?: Record<string, unknown>): Promise<LDAIJudgeConfig>;
     /**
      * Retrieves and processes multiple AI Config agents based on the provided agent configurations
      * and LaunchDarkly context. This includes the model configuration and the customized instructions.
      *
-     * @param agentConfigs An array of agent configurations, each containing the agent key, default configuration,
-     * and variables for instructions interpolation.
+     * @param agentConfigs An array of agent configurations, each containing the agent key, optional default
+     * configuration (when omitted or null, a disabled default is used), and variables for instructions interpolation.
      * @param context The LaunchDarkly context object that contains relevant information about the
      * current environment, user, or session. This context may influence how the configuration is
      * processed or personalized.
@@ -941,7 +942,8 @@ interface LDAIClient {
      *
      * @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 defaultValue Optional fallback when the configuration is not available from LaunchDarkly.
+     * When omitted or null, a disabled default is used.
      * @param variables Dictionary of values for instruction interpolation.
      * The variables will also be used for judge evaluation. For the judge only, the variables
      * `message_history` and `response_to_evaluate` are reserved and will be ignored.
@@ -953,7 +955,7 @@ interface LDAIClient {
      * const key = "customer_support_chat";
      * const context = {...};
      * const defaultValue = {
-     *   enabled: false,
+     *   enabled: true,
      *   model: { name: "gpt-4" },
      *   provider: { name: "openai" },
      *   messages: [
@@ -969,17 +971,18 @@ interface LDAIClient {
      * }
      * ```
      */
-    createChat(key: string, context: LDContext, defaultValue: LDAICompletionConfigDefault, variables?: Record<string, unknown>, defaultAiProvider?: SupportedAIProvider): Promise<TrackedChat | undefined>;
+    createChat(key: string, context: LDContext, defaultValue?: LDAICompletionConfigDefault, variables?: Record<string, unknown>, defaultAiProvider?: SupportedAIProvider): Promise<TrackedChat | undefined>;
     /**
      * @deprecated Use `createChat` instead. This method will be removed in a future version.
      */
-    initChat(key: string, context: LDContext, defaultValue: LDAICompletionConfigDefault, variables?: Record<string, unknown>, defaultAiProvider?: SupportedAIProvider): Promise<TrackedChat | undefined>;
+    initChat(key: string, context: LDContext, defaultValue?: LDAICompletionConfigDefault, variables?: Record<string, unknown>, defaultAiProvider?: SupportedAIProvider): Promise<TrackedChat | undefined>;
     /**
      * Creates and returns a new Judge instance for AI evaluation.
      *
      * @param key The key identifying the AI judge configuration to use
      * @param context Standard LDContext used when evaluating flags
-     * @param defaultValue A default value representing a standard AI config result
+     * @param defaultValue Optional fallback when the configuration is not available from LaunchDarkly.
+     * When omitted or null, a disabled default is used.
      * @param variables Dictionary of values for instruction interpolation.
      * The variables `message_history` and `response_to_evaluate` are reserved for the judge and will be ignored.
      * @param defaultAiProvider Optional default AI provider to use.
@@ -1006,7 +1009,7 @@ interface LDAIClient {
      * }
      * ```
      */
-    createJudge(key: string, context: LDContext, defaultValue: LDAIJudgeConfigDefault, variables?: Record<string, unknown>, defaultAiProvider?: SupportedAIProvider): Promise<Judge | undefined>;
+    createJudge(key: string, context: LDContext, defaultValue?: LDAIJudgeConfigDefault, variables?: Record<string, unknown>, defaultAiProvider?: SupportedAIProvider): Promise<Judge | undefined>;
 }
 
 /**

package/dist/index.d.ts

@@ -367,7 +367,7 @@ interface LDJudgeConfiguration {
     judges: LDJudge[];
 }
 /**
- * Base AI Config interface for default implementations with optional enabled property.
+ * Base AI Config for default implementations with optional enabled property.
  */
 interface LDAIConfigDefault {
     /**
@@ -514,9 +514,9 @@ interface LDAIAgentRequestConfig {
      */
     key: string;
     /**
-     * Default configuration for the agent.
+     * Default configuration for the agent. When omitted or null, a disabled default is used.
      */
-    defaultValue: LDAIAgentConfigDefault;
+    defaultValue?: LDAIAgentConfigDefault;
     /**
      * Variables for instructions interpolation.
      */
@@ -768,8 +768,8 @@ interface LDAIClient {
      * @param context The LaunchDarkly context object that contains relevant information about the
      * current environment, user, or session. This context may influence how the configuration is
      * processed or personalized.
-     * @param defaultValue A fallback value containing model configuration and messages. This will
-     * be used if the configuration is not available from LaunchDarkly.
+     * @param defaultValue Optional fallback when the configuration is not available from LaunchDarkly.
+     * When omitted or null, a disabled default is used.
      * @param variables A map of key-value pairs representing dynamic variables to be injected into
      * the message content. The keys correspond to placeholders within the template, and the values
      * are the corresponding replacements.
@@ -784,7 +784,7 @@ interface LDAIClient {
      * const context = {...};
      * const variables = {username: 'john'};
      * const defaultValue = {
-     *  enabled: false,
+     *  enabled: true,
      *  model: { name: 'gpt-4' },
      *  provider: { name: 'openai' },
      * };
@@ -813,11 +813,11 @@ interface LDAIClient {
      * }
      * ```
      */
-    completionConfig(key: string, context: LDContext, defaultValue: LDAICompletionConfigDefault, variables?: Record<string, unknown>): Promise<LDAICompletionConfig>;
+    completionConfig(key: string, context: LDContext, defaultValue?: LDAICompletionConfigDefault, variables?: Record<string, unknown>): Promise<LDAICompletionConfig>;
     /**
      * @deprecated Use `completionConfig` instead. This method will be removed in a future version.
      */
-    config(key: string, context: LDContext, defaultValue: LDAICompletionConfigDefault, variables?: Record<string, unknown>): Promise<LDAICompletionConfig>;
+    config(key: string, context: LDContext, defaultValue?: LDAICompletionConfigDefault, variables?: Record<string, unknown>): Promise<LDAICompletionConfig>;
     /**
      * Retrieves and processes a single AI Config agent based on the provided key, LaunchDarkly context,
      * and variables. This includes the model configuration and the customized instructions.
@@ -826,7 +826,8 @@ interface LDAIClient {
      * @param context The LaunchDarkly context object that contains relevant information about the
      * current environment, user, or session. This context may influence how the configuration is
      * processed or personalized.
-     * @param defaultValue A fallback value containing model configuration and instructions.
+     * @param defaultValue Optional fallback when the configuration is not available from LaunchDarkly.
+     * When omitted or null, a disabled default is used.
      * @param variables A map of key-value pairs representing dynamic variables to be injected into
      * the instructions. The keys correspond to placeholders within the template, and the values
      * are the corresponding replacements.
@@ -851,11 +852,11 @@ interface LDAIClient {
      * agentConfig.tracker.trackSuccess();
      * ```
      */
-    agentConfig(key: string, context: LDContext, defaultValue: LDAIAgentConfigDefault, variables?: Record<string, unknown>): Promise<LDAIAgentConfig>;
+    agentConfig(key: string, context: LDContext, defaultValue?: LDAIAgentConfigDefault, variables?: Record<string, unknown>): Promise<LDAIAgentConfig>;
     /**
      * @deprecated Use `agentConfig` instead. This method will be removed in a future version.
      */
-    agent(key: string, context: LDContext, defaultValue: LDAIAgentConfigDefault, variables?: Record<string, unknown>): Promise<LDAIAgentConfig>;
+    agent(key: string, context: LDContext, defaultValue?: LDAIAgentConfigDefault, variables?: Record<string, unknown>): Promise<LDAIAgentConfig>;
     /**
      * Retrieves and processes a Judge AI Config based on the provided key, LaunchDarkly context,
      * and variables. This includes the model configuration and the customized messages for evaluation.
@@ -864,8 +865,8 @@ interface LDAIClient {
      * @param context The LaunchDarkly context object that contains relevant information about the
      * current environment, user, or session. This context may influence how the configuration is
      * processed or personalized.
-     * @param defaultValue A fallback value containing model configuration and messages. This will
-     * be used if the configuration is not available from LaunchDarkly.
+     * @param defaultValue Optional fallback when the configuration is not available from LaunchDarkly.
+     * When omitted or null, a disabled default is used.
      * @param variables Optional variables for template interpolation in messages and instructions.
      * @returns A promise that resolves to a tracked judge configuration.
      *
@@ -883,13 +884,13 @@ interface LDAIClient {
      * judgeConf.tracker.trackSuccess();
      * ```
      */
-    judgeConfig(key: string, context: LDContext, defaultValue: LDAIJudgeConfigDefault, variables?: Record<string, unknown>): Promise<LDAIJudgeConfig>;
+    judgeConfig(key: string, context: LDContext, defaultValue?: LDAIJudgeConfigDefault, variables?: Record<string, unknown>): Promise<LDAIJudgeConfig>;
     /**
      * Retrieves and processes multiple AI Config agents based on the provided agent configurations
      * and LaunchDarkly context. This includes the model configuration and the customized instructions.
      *
-     * @param agentConfigs An array of agent configurations, each containing the agent key, default configuration,
-     * and variables for instructions interpolation.
+     * @param agentConfigs An array of agent configurations, each containing the agent key, optional default
+     * configuration (when omitted or null, a disabled default is used), and variables for instructions interpolation.
      * @param context The LaunchDarkly context object that contains relevant information about the
      * current environment, user, or session. This context may influence how the configuration is
      * processed or personalized.
@@ -941,7 +942,8 @@ interface LDAIClient {
      *
      * @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 defaultValue Optional fallback when the configuration is not available from LaunchDarkly.
+     * When omitted or null, a disabled default is used.
      * @param variables Dictionary of values for instruction interpolation.
      * The variables will also be used for judge evaluation. For the judge only, the variables
      * `message_history` and `response_to_evaluate` are reserved and will be ignored.
@@ -953,7 +955,7 @@ interface LDAIClient {
      * const key = "customer_support_chat";
      * const context = {...};
      * const defaultValue = {
-     *   enabled: false,
+     *   enabled: true,
      *   model: { name: "gpt-4" },
      *   provider: { name: "openai" },
      *   messages: [
@@ -969,17 +971,18 @@ interface LDAIClient {
      * }
      * ```
      */
-    createChat(key: string, context: LDContext, defaultValue: LDAICompletionConfigDefault, variables?: Record<string, unknown>, defaultAiProvider?: SupportedAIProvider): Promise<TrackedChat | undefined>;
+    createChat(key: string, context: LDContext, defaultValue?: LDAICompletionConfigDefault, variables?: Record<string, unknown>, defaultAiProvider?: SupportedAIProvider): Promise<TrackedChat | undefined>;
     /**
      * @deprecated Use `createChat` instead. This method will be removed in a future version.
      */
-    initChat(key: string, context: LDContext, defaultValue: LDAICompletionConfigDefault, variables?: Record<string, unknown>, defaultAiProvider?: SupportedAIProvider): Promise<TrackedChat | undefined>;
+    initChat(key: string, context: LDContext, defaultValue?: LDAICompletionConfigDefault, variables?: Record<string, unknown>, defaultAiProvider?: SupportedAIProvider): Promise<TrackedChat | undefined>;
     /**
      * Creates and returns a new Judge instance for AI evaluation.
      *
      * @param key The key identifying the AI judge configuration to use
      * @param context Standard LDContext used when evaluating flags
-     * @param defaultValue A default value representing a standard AI config result
+     * @param defaultValue Optional fallback when the configuration is not available from LaunchDarkly.
+     * When omitted or null, a disabled default is used.
      * @param variables Dictionary of values for instruction interpolation.
      * The variables `message_history` and `response_to_evaluate` are reserved for the judge and will be ignored.
      * @param defaultAiProvider Optional default AI provider to use.
@@ -1006,7 +1009,7 @@ interface LDAIClient {
      * }
      * ```
      */
-    createJudge(key: string, context: LDContext, defaultValue: LDAIJudgeConfigDefault, variables?: Record<string, unknown>, defaultAiProvider?: SupportedAIProvider): Promise<Judge | undefined>;
+    createJudge(key: string, context: LDContext, defaultValue?: LDAIJudgeConfigDefault, variables?: Record<string, unknown>, defaultAiProvider?: SupportedAIProvider): Promise<Judge | undefined>;
 }
 
 /**

package/dist/index.js

@@ -883,7 +883,7 @@ var LDAIConfigTrackerImpl = class {
 
 // src/sdkInfo.ts
 var aiSdkName = "@launchdarkly/server-sdk-ai";
-var aiSdkVersion = "0.16.5";
+var aiSdkVersion = "0.16.7";
 var aiSdkLanguage = "javascript";
 
 // src/LDAIClientImpl.ts
@@ -899,6 +899,7 @@ var INIT_TRACK_CONTEXT = {
   key: "ld-internal-tracking",
   anonymous: true
 };
+var disabledAIConfig = { enabled: false };
 var LDAIClientImpl = class {
   constructor(_ldClient) {
     this._ldClient = _ldClient;
@@ -966,7 +967,7 @@ var LDAIClientImpl = class {
       const judge = await this.createJudge(
         judgeConfig.key,
         context,
-        { enabled: false },
+        void 0,
         variables,
         defaultAiProvider
       );
@@ -986,7 +987,7 @@ var LDAIClientImpl = class {
   }
   async completionConfig(key, context, defaultValue, variables) {
     this._ldClient.track(TRACK_USAGE_COMPLETION_CONFIG, context, key, 1);
-    return this._completionConfig(key, context, defaultValue, variables);
+    return this._completionConfig(key, context, defaultValue ?? disabledAIConfig, variables);
   }
   /**
    * @deprecated Use `completionConfig` instead. This method will be removed in a future version.
@@ -1000,11 +1001,17 @@ var LDAIClientImpl = class {
   }
   async judgeConfig(key, context, defaultValue, variables) {
     this._ldClient.track(TRACK_USAGE_JUDGE_CONFIG, context, key, 1);
-    return this._judgeConfig(key, context, defaultValue, variables);
+    return this._judgeConfig(key, context, defaultValue ?? disabledAIConfig, variables);
   }
   async agentConfig(key, context, defaultValue, variables) {
     this._ldClient.track(TRACK_USAGE_AGENT_CONFIG, context, key, 1);
-    const config = await this._evaluate(key, context, defaultValue, "agent", variables);
+    const config = await this._evaluate(
+      key,
+      context,
+      defaultValue ?? disabledAIConfig,
+      "agent",
+      variables
+    );
     return config;
   }
   /**
@@ -1026,7 +1033,7 @@ var LDAIClientImpl = class {
         const agent = await this._evaluate(
           config.key,
           context,
-          config.defaultValue,
+          config.defaultValue ?? disabledAIConfig,
           "agent",
           config.variables
         );
@@ -1043,7 +1050,12 @@ var LDAIClientImpl = class {
   }
   async createChat(key, context, defaultValue, variables, defaultAiProvider) {
     this._ldClient.track(TRACK_USAGE_CREATE_CHAT, context, key, 1);
-    const config = await this._completionConfig(key, context, defaultValue, variables);
+    const config = await this._completionConfig(
+      key,
+      context,
+      defaultValue ?? disabledAIConfig,
+      variables
+    );
     if (!config.enabled || !config.tracker) {
       this._logger?.info(`Chat configuration is disabled: ${key}`);
       return void 0;
@@ -1078,7 +1090,12 @@ var LDAIClientImpl = class {
         message_history: "{{message_history}}",
         response_to_evaluate: "{{response_to_evaluate}}"
       };
-      const judgeConfig = await this._judgeConfig(key, context, defaultValue, extendedVariables);
+      const judgeConfig = await this._judgeConfig(
+        key,
+        context,
+        defaultValue ?? disabledAIConfig,
+        extendedVariables
+      );
       if (!judgeConfig.enabled || !judgeConfig.tracker) {
         this._logger?.info(`Judge configuration is disabled: ${key}`);
         return void 0;