feat!: remove deprecated client method aliases and type aliases

Remove the following deprecated symbols ahead of the next release:

- LDAIClient.config() -> use completion_config()
- LDAIClient.create_chat() -> use create_model()
- LDAIClient.agent() -> use agent_config()
- LDAIClient.agents() -> use agent_configs()
- LDAIConfigTracker.track_openai_metrics() -> use track_metrics_of with
  get_ai_metrics_from_response from ldai_openai
- LDAIMetricSummary.duration -> use duration_ms
- Chat class and ldai/chat/ shim package -> use ManagedModel
- LDAIAgent type alias -> use AIAgentConfig
- LDAIAgentConfig type alias -> use AIAgentConfigRequest
- LDAIAgentDefaults type alias -> use AIAgentConfigDefault
- AIConfig public re-export -> internal base class only

BREAKING CHANGE: All deprecated method aliases, type aliases, and the
ldai.chat shim package are removed. Migrate to the documented
replacements listed above.

Note: The plural-form ``evaluation_metric_keys`` field on AIJudgeConfig
and AIJudgeConfigDefault is intentionally kept for wire-format
compatibility with existing LD-side judge configurations.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: jsonbailey

packages/sdk/server-ai/src/ldai/__init__.py

@@ -3,29 +3,24 @@
 from ldclient import log
 
 from ldai.agent_graph import AgentGraphDefinition
-from ldai.chat import Chat  # Deprecated — use ManagedModel
 from ldai.client import LDAIClient
 from ldai.evaluator import Evaluator
 from ldai.judge import Judge
 from ldai.managed_agent import ManagedAgent
 from ldai.managed_agent_graph import ManagedAgentGraph
 from ldai.managed_model import ManagedModel
-from ldai.models import (  # Deprecated aliases for backward compatibility
+from ldai.models import (
     AIAgentConfig,
     AIAgentConfigDefault,
     AIAgentConfigRequest,
     AIAgentGraphConfig,
     AIAgents,
     AICompletionConfig,
     AICompletionConfigDefault,
-    AIConfig,
     AIJudgeConfig,
     AIJudgeConfigDefault,
     Edge,
     JudgeConfiguration,
-    LDAIAgent,
-    LDAIAgentConfig,
-    LDAIAgentDefaults,
     LDMessage,
     LDTool,
     ModelConfig,
@@ -81,10 +76,4 @@
     'ModelConfig',
     'ProviderConfig',
     'log',
-    # Deprecated exports
-    'AIConfig',
-    'Chat',
-    'LDAIAgent',
-    'LDAIAgentConfig',
-    'LDAIAgentDefaults',
 ]

packages/sdk/server-ai/src/ldai/chat/__init__.py

@@ -1,5 +1,4 @@
 import uuid
-import warnings
 from typing import Any, Callable, Dict, List, Optional, Tuple
 
 import chevron
@@ -187,27 +186,6 @@ def completion_config(
             key, context, default or _DISABLED_COMPLETION_DEFAULT, variables, default_ai_provider
         )
 
-    def config(
-        self,
-        key: str,
-        context: Context,
-        default: Optional[AICompletionConfigDefault] = None,
-        variables: Optional[Dict[str, Any]] = None,
-    ) -> AICompletionConfig:
-        """
-        Get the value of a model configuration.
-
-        .. deprecated:: Use :meth:`completion_config` instead. This method will be removed in a future version.
-
-        :param key: The key of the model configuration.
-        :param context: The context to evaluate the model configuration in.
-        :param default: The default value of the model configuration.
-        :param variables: Additional variables for the model configuration.
-        :return: The value of the model configuration along with a tracker used for gathering metrics.
-        """
-        warnings.warn("config() is deprecated, use completion_config() instead", DeprecationWarning, stacklevel=2)
-        return self.completion_config(key, context, default, variables)
-
     def _judge_config(
         self,
         key: str,
@@ -455,20 +433,6 @@ async def create_model(
 
         return ManagedModel(config, runner)
 
-    async def create_chat(
-        self,
-        key: str,
-        context: Context,
-        default: Optional[AICompletionConfigDefault] = None,
-        variables: Optional[Dict[str, Any]] = None,
-        default_ai_provider: Optional[str] = None,
-    ) -> Optional[ManagedModel]:
-        """
-        .. deprecated:: Use :meth:`create_model` instead. This method will be removed in a future version.
-        """
-        warnings.warn("create_chat() is deprecated, use create_model() instead", DeprecationWarning, stacklevel=2)
-        return await self.create_model(key, context, default, variables, default_ai_provider)
-
     async def create_agent(
         self,
         key: str,
@@ -578,23 +542,6 @@ def agent_config(
             key, context, default or _DISABLED_AGENT_DEFAULT, variables
         )
 
-    def agent(
-        self,
-        config: AIAgentConfigRequest,
-        context: Context,
-    ) -> AIAgentConfig:
-        """
-        Retrieve a single AI Config agent.
-
-        .. deprecated:: Use :meth:`agent_config` instead. This method will be removed in a future version.
-
-        :param config: The agent configuration to use.
-        :param context: The context to evaluate the agent configuration in.
-        :return: Configured AIAgentConfig instance.
-        """
-        warnings.warn("agent() is deprecated, use agent_config() instead", DeprecationWarning, stacklevel=2)
-        return self.agent_config(config.key, context, config.default, config.variables)
-
     def agent_configs(
         self,
         agent_configs: List[AIAgentConfigRequest],
@@ -827,23 +774,6 @@ async def create_agent_graph(
 
         return ManagedAgentGraph(graph, runner)
 
-    def agents(
-        self,
-        agent_configs: List[AIAgentConfigRequest],
-        context: Context,
-    ) -> AIAgents:
-        """
-        Retrieve multiple AI agent configurations.
-
-        .. deprecated:: Use :meth:`agent_configs` instead. This method will be removed in a future version.
-
-        :param agent_configs: List of agent configurations to retrieve.
-        :param context: The context to evaluate the agent configurations in.
-        :return: Dictionary mapping agent keys to their AIAgentConfig configurations.
-        """
-        warnings.warn("agents() is deprecated, use agent_configs() instead", DeprecationWarning, stacklevel=2)
-        return self.agent_configs(agent_configs, context)
-
     def __evaluate(
         self,
         key: str,

packages/sdk/server-ai/src/ldai/client.py

@@ -1,4 +1,3 @@
-import warnings
 from dataclasses import dataclass, field
 from typing import TYPE_CHECKING, Any, Callable, Dict, List, Literal, Optional, Union
 
@@ -424,22 +423,3 @@ class AIAgentGraphConfig:
     root_config_key: str
     edges: List[Edge]
     enabled: bool = True
-
-
-# ============================================================================
-# Deprecated Type Aliases for Backward Compatibility
-# ============================================================================
-
-# Note: AIConfig is now defined above as a base class (line 169).
-# For backward compatibility, code should migrate to:
-# - Use AICompletionConfigDefault for default/input values
-# - Use AICompletionConfig for return values
-
-# Deprecated: Use AIAgentConfigDefault instead
-LDAIAgentDefaults = AIAgentConfigDefault
-
-# Deprecated: Use AIAgentConfigRequest instead
-LDAIAgentConfig = AIAgentConfigRequest
-
-# Deprecated: Use AIAgentConfig instead (note: this was the old return type)
-LDAIAgent = AIAgentConfig

packages/sdk/server-ai/src/ldai/models.py

@@ -3,7 +3,6 @@
 import base64
 import json
 import time
-import warnings
 from dataclasses import dataclass
 from enum import Enum
 from typing import TYPE_CHECKING, Any, Callable, Dict, Iterable, List, Optional
@@ -59,19 +58,6 @@ def duration_ms(self) -> Optional[int]:
         """Duration of the AI operation in milliseconds."""
         return self._duration_ms
 
-    @property
-    def duration(self) -> Optional[int]:
-        """
-        .. deprecated::
-            Use :attr:`duration_ms` instead.
-        """
-        warnings.warn(
-            "LDAIMetricSummary.duration is deprecated. Use duration_ms instead.",
-            DeprecationWarning,
-            stacklevel=2,
-        )
-        return self._duration_ms
-
     @property
     def success(self) -> Optional[bool]:
         return self._success
@@ -463,48 +449,6 @@ def track_error(self) -> None:
             "$ld:ai:generation:error", self._context, self.__get_track_data(), 1
         )
 
-    def track_openai_metrics(self, func):
-        """
-        Track OpenAI-specific operations.
-
-        .. deprecated:: Use :meth:`track_metrics_of` with ``get_ai_metrics_from_response``
-            from ``ldai_openai`` instead. This method will be removed in a future version.
-
-        This function will track the duration of the operation, the token
-        usage, and the success or error status.
-
-        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 func: Function to track.
-        :return: Result of the tracked function.
-        """
-        warnings.warn(
-            "track_openai_metrics is deprecated. Use track_metrics_of with "
-            "get_ai_metrics_from_response from ldai_openai instead.",
-            DeprecationWarning,
-            stacklevel=2,
-        )
-        start_ns = time.perf_counter_ns()
-        try:
-            result = func()
-            duration = (time.perf_counter_ns() - start_ns) // 1_000_000
-            self.track_duration(duration)
-            self.track_success()
-            if hasattr(result, "usage") and hasattr(result.usage, "to_dict"):
-                self.track_tokens(_openai_to_token_usage(result.usage.to_dict()))
-        except Exception:
-            duration = (time.perf_counter_ns() - start_ns) // 1_000_000
-            self.track_duration(duration)
-            self.track_error()
-            raise
-
-        return result
-
     def track_bedrock_converse_metrics(self, res: dict) -> dict:
         """
         Track AWS Bedrock conversation operations.
@@ -597,20 +541,6 @@ def _bedrock_to_token_usage(data: dict) -> TokenUsage:
     )
 
 
-def _openai_to_token_usage(data: dict) -> TokenUsage:
-    """
-    Convert an OpenAI usage dictionary to a TokenUsage object.
-
-    :param data: Dictionary containing OpenAI usage data.
-    :return: TokenUsage object containing usage data.
-    """
-    return TokenUsage(
-        total=data.get("total_tokens", 0),
-        input=data.get("prompt_tokens", 0),
-        output=data.get("completion_tokens", 0),
-    )
-
-
 class AIGraphTracker:
     """
     Tracks graph-level metrics for AI agent graph operations.