feat: Introduce ManagedModel and ModelRunner (PR-3) (#104)

feat: Add ModelRunner ABC with invoke_model() and
invoke_structured_model()
feat!: Rename ChatResponse to ModelResponse in providers/types.py
feat!: Extract OpenAIModelRunner from OpenAIRunnerFactory; factory is
now model-creation-only
feat!: Extract LangChainModelRunner from LangChainRunnerFactory; factory
is now model-creation-only
feat!: Extract shared utilities to openai_helper
feat!: Extract shared utilities to langchain_helper
feat: Deprecated create_chat(), use create_model() on the LDAIClient
feat: Deprecated Chat object in favor of ManagedModel

Author: jsonbailey

packages/ai-providers/server-ai-langchain/src/ldai_langchain/__init__.py

@@ -1,8 +1,22 @@
+from ldai_langchain.langchain_helper import (
+    convert_messages_to_langchain,
+    create_langchain_model,
+    get_ai_metrics_from_response,
+    get_ai_usage_from_response,
+    map_provider,
+)
+from ldai_langchain.langchain_model_runner import LangChainModelRunner
 from ldai_langchain.langchain_runner_factory import LangChainRunnerFactory
 
 __version__ = "0.1.0"
 
 __all__ = [
     '__version__',
     'LangChainRunnerFactory',
+    'LangChainModelRunner',
+    'convert_messages_to_langchain',
+    'create_langchain_model',
+    'get_ai_metrics_from_response',
+    'get_ai_usage_from_response',
+    'map_provider',
 ]

packages/ai-providers/server-ai-langchain/src/ldai_langchain/langchain_helper.py

@@ -0,0 +1,117 @@
+from typing import Any, Dict, List, Optional, Union
+
+from langchain_core.language_models.chat_models import BaseChatModel
+from langchain_core.messages import AIMessage, BaseMessage, HumanMessage, SystemMessage
+from ldai import LDMessage
+from ldai.models import AIConfigKind
+from ldai.providers.types import LDAIMetrics
+from ldai.tracker import TokenUsage
+
+
+def map_provider(ld_provider_name: str) -> str:
+    """
+    Map a LaunchDarkly provider name to its LangChain equivalent.
+
+    :param ld_provider_name: LaunchDarkly provider name
+    :return: LangChain-compatible provider name
+    """
+    lowercased_name = ld_provider_name.lower()
+    # Bedrock is the only provider that uses "provider:model_family" (e.g. Bedrock:Anthropic).
+    if lowercased_name.startswith('bedrock:'):
+        return 'bedrock_converse'
+
+    mapping: Dict[str, str] = {
+        'gemini': 'google-genai',
+        'bedrock': 'bedrock_converse',
+    }
+    return mapping.get(lowercased_name, lowercased_name)
+
+
+def convert_messages_to_langchain(
+    messages: List[LDMessage],
+) -> List[Union[HumanMessage, SystemMessage, AIMessage]]:
+    """
+    Convert LaunchDarkly messages to LangChain message objects.
+
+    :param messages: List of LDMessage objects
+    :return: List of LangChain message objects
+    :raises ValueError: If an unsupported message role is encountered
+    """
+    result: List[Union[HumanMessage, SystemMessage, AIMessage]] = []
+    for msg in messages:
+        if msg.role == 'system':
+            result.append(SystemMessage(content=msg.content))
+        elif msg.role == 'user':
+            result.append(HumanMessage(content=msg.content))
+        elif msg.role == 'assistant':
+            result.append(AIMessage(content=msg.content))
+        else:
+            raise ValueError(f'Unsupported message role: {msg.role}')
+    return result
+
+
+def create_langchain_model(ai_config: AIConfigKind) -> BaseChatModel:
+    """
+    Create a LangChain BaseChatModel from a LaunchDarkly AI configuration.
+
+    :param ai_config: The LaunchDarkly AI configuration
+    :return: A configured LangChain BaseChatModel
+    """
+    from langchain.chat_models import init_chat_model
+
+    config_dict = ai_config.to_dict()
+    model_dict = config_dict.get('model') or {}
+    provider_dict = config_dict.get('provider') or {}
+
+    model_name = model_dict.get('name', '')
+    provider = provider_dict.get('name', '')
+    parameters = dict(model_dict.get('parameters') or {})
+    mapped_provider = map_provider(provider)
+
+    # Bedrock requires the foundation provider (e.g. Bedrock:Anthropic) passed in
+    # parameters separately from model_provider, which is used for LangChain routing.
+    if mapped_provider == 'bedrock_converse' and 'provider' not in parameters:
+        parameters['provider'] = provider.removeprefix('bedrock:')
+
+    return init_chat_model(
+        model_name,
+        model_provider=mapped_provider,
+        **parameters,
+    )
+
+
+def get_ai_usage_from_response(response: Any) -> Optional[TokenUsage]:
+    """
+    Extract token usage from a LangChain response.
+
+    :param response: The response from a LangChain model (BaseMessage or similar)
+    :return: TokenUsage or None if unavailable
+    """
+    if hasattr(response, 'usage_metadata') and response.usage_metadata:
+        return TokenUsage(
+            total=response.usage_metadata.get('total_tokens', 0),
+            input=response.usage_metadata.get('input_tokens', 0),
+            output=response.usage_metadata.get('output_tokens', 0),
+        )
+    if hasattr(response, 'response_metadata') and response.response_metadata:
+        token_usage = (
+            response.response_metadata.get('tokenUsage')
+            or response.response_metadata.get('token_usage')
+        )
+        if token_usage:
+            return TokenUsage(
+                total=token_usage.get('totalTokens', 0) or token_usage.get('total_tokens', 0),
+                input=token_usage.get('promptTokens', 0) or token_usage.get('prompt_tokens', 0),
+                output=token_usage.get('completionTokens', 0) or token_usage.get('completion_tokens', 0),
+            )
+    return None
+
+
+def get_ai_metrics_from_response(response: Any) -> LDAIMetrics:
+    """
+    Extract LaunchDarkly AI metrics from a LangChain response.
+
+    :param response: The response from a LangChain model (BaseMessage or similar)
+    :return: LDAIMetrics with success status and token usage
+    """
+    return LDAIMetrics(success=True, usage=get_ai_usage_from_response(response))

packages/ai-providers/server-ai-langchain/src/ldai_langchain/langchain_model_runner.py

@@ -0,0 +1,109 @@
+from typing import Any, Dict, List
+
+from langchain_core.language_models.chat_models import BaseChatModel
+from langchain_core.messages import BaseMessage
+from ldai import LDMessage, log
+from ldai.providers.model_runner import ModelRunner
+from ldai.providers.types import LDAIMetrics, ModelResponse, StructuredResponse
+
+from ldai_langchain.langchain_helper import (
+    convert_messages_to_langchain,
+    get_ai_metrics_from_response,
+    get_ai_usage_from_response,
+)
+
+
+class LangChainModelRunner(ModelRunner):
+    """
+    ModelRunner implementation for LangChain.
+
+    Holds a fully-configured BaseChatModel.
+    Returned by LangChainConnector.create_model(config).
+    """
+
+    def __init__(self, llm: BaseChatModel):
+        self._llm = llm
+
+    def get_llm(self) -> BaseChatModel:
+        """
+        Return the underlying LangChain BaseChatModel.
+
+        :return: The BaseChatModel instance
+        """
+        return self._llm
+
+    async def invoke_model(self, messages: List[LDMessage]) -> ModelResponse:
+        """
+        Invoke the LangChain model with an array of messages.
+
+        :param messages: Array of LDMessage objects representing the conversation
+        :return: ModelResponse containing the model's response and metrics
+        """
+        try:
+            langchain_messages = convert_messages_to_langchain(messages)
+            response: BaseMessage = await self._llm.ainvoke(langchain_messages)
+            metrics = get_ai_metrics_from_response(response)
+
+            content: str = ''
+            if isinstance(response.content, str):
+                content = response.content
+            else:
+                log.warning(
+                    f'Multimodal response not supported, expecting a string. '
+                    f'Content type: {type(response.content)}, Content: {response.content}'
+                )
+                metrics = LDAIMetrics(success=False, usage=metrics.usage)
+
+            return ModelResponse(
+                message=LDMessage(role='assistant', content=content),
+                metrics=metrics,
+            )
+        except Exception as error:
+            log.warning(f'LangChain model invocation failed: {error}')
+            return ModelResponse(
+                message=LDMessage(role='assistant', content=''),
+                metrics=LDAIMetrics(success=False, usage=None),
+            )
+
+    async def invoke_structured_model(
+        self,
+        messages: List[LDMessage],
+        response_structure: Dict[str, Any],
+    ) -> StructuredResponse:
+        """
+        Invoke the LangChain model with structured output support.
+
+        :param messages: Array of LDMessage objects representing the conversation
+        :param response_structure: Dictionary defining the output structure
+        :return: StructuredResponse containing the structured data
+        """
+        structured_response = StructuredResponse(
+            data={},
+            raw_response='',
+            metrics=LDAIMetrics(success=False, usage=None),
+        )
+        try:
+            langchain_messages = convert_messages_to_langchain(messages)
+            structured_llm = self._llm.with_structured_output(response_structure, include_raw=True)
+            response = await structured_llm.ainvoke(langchain_messages)
+
+            if not isinstance(response, dict):
+                log.warning(f'Structured output did not return a dict. Got: {type(response)}')
+                return structured_response
+
+            raw_response = response.get('raw')
+            if raw_response is not None:
+                if hasattr(raw_response, 'content'):
+                    structured_response.raw_response = raw_response.content
+                structured_response.metrics.usage = get_ai_usage_from_response(raw_response)
+
+            if response.get('parsing_error'):
+                log.warning('LangChain structured model invocation had a parsing error')
+                return structured_response
+
+            structured_response.metrics.success = True
+            structured_response.data = response.get('parsed') or {}
+            return structured_response
+        except Exception as error:
+            log.warning(f'LangChain structured model invocation failed: {error}')
+            return structured_response