[REL-12055] resolve client.py conflict

andrewklatzke · andrewklatzke · commit 4f1c86a8dc94 · 2026-03-02T09:45:35.000-09:00
diff --git a/.release-please-manifest.json b/.release-please-manifest.json
@@ -1,5 +1,5 @@
 {
-  "packages/sdk/server-ai": "0.14.0",
-  "packages/ai-providers/server-ai-langchain": "0.3.0",
-  "packages/ai-providers/server-ai-openai": "0.1.0"
+  "packages/sdk/server-ai": "0.14.2",
+  "packages/ai-providers/server-ai-langchain": "0.3.1",
+  "packages/ai-providers/server-ai-openai": "0.1.1"
 }
diff --git a/README.md b/README.md
@@ -1,10 +1,17 @@
 # LaunchDarkly Server-side AI library for Python
 
-## LaunchDarkly overview
+This repository contains LaunchDarkly AI SDK packages for Python, including the core AI SDK and AI provider integrations.
 
-[LaunchDarkly](https://www.launchdarkly.com) is a feature management platform that serves trillions of feature flags daily to help teams build better software, faster. [Get started](https://docs.launchdarkly.com/home/getting-started) using LaunchDarkly today!
+## Packages
 
-[![Twitter Follow](https://img.shields.io/twitter/follow/launchdarkly.svg?style=social&label=Follow&maxAge=2592000)](https://twitter.com/intent/follow?screen_name=launchdarkly)
+| Package | PyPI | README |
+| ------- | ---- | ------ |
+| [launchdarkly-server-sdk-ai](packages/sdk/server-ai) | [![PyPI](https://img.shields.io/pypi/v/launchdarkly-server-sdk-ai.svg)](https://pypi.org/project/launchdarkly-server-sdk-ai/) | [README](packages/sdk/server-ai/README.md) |
+
+| AI Provider Packages | PyPI | README |
+| -------------------- | ---- | ------ |
+| [launchdarkly-server-sdk-ai-openai](packages/ai-providers/server-ai-openai) | [![PyPI](https://img.shields.io/pypi/v/launchdarkly-server-sdk-ai-openai.svg)](https://pypi.org/project/launchdarkly-server-sdk-ai-openai/) | [README](packages/ai-providers/server-ai-openai/README.md) |
+| [launchdarkly-server-sdk-ai-langchain](packages/ai-providers/server-ai-langchain) | [![PyPI](https://img.shields.io/pypi/v/launchdarkly-server-sdk-ai-langchain.svg)](https://pypi.org/project/launchdarkly-server-sdk-ai-langchain/) | [README](packages/ai-providers/server-ai-langchain/README.md) |
 
 ## Supported Python versions
 
@@ -18,6 +25,12 @@ Refer to the [SDK reference guide](https://docs.launchdarkly.com/sdk/ai/python)
 
 Read our [documentation](http://docs.launchdarkly.com) for in-depth instructions on configuring and using LaunchDarkly. You can also head straight to the [reference guide for the python SDK](http://docs.launchdarkly.com/docs/python-sdk-ai-reference).
 
+## LaunchDarkly overview
+
+[LaunchDarkly](https://www.launchdarkly.com) is a feature management platform that serves trillions of feature flags daily to help teams build better software, faster. [Get started](https://docs.launchdarkly.com/home/getting-started) using LaunchDarkly today!
+
+[![Twitter Follow](https://img.shields.io/twitter/follow/launchdarkly.svg?style=social&label=Follow&maxAge=2592000)](https://twitter.com/intent/follow?screen_name=launchdarkly)
+
 ## Contributing
 
 We encourage pull requests and other contributions from the community. Check out our [contributing guidelines](CONTRIBUTING.md) for instructions on how to contribute to this library.
diff --git a/packages/ai-providers/server-ai-langchain/CHANGELOG.md b/packages/ai-providers/server-ai-langchain/CHANGELOG.md
@@ -1,5 +1,12 @@
 # Changelog
 
+## [0.3.1](https://github.com/launchdarkly/python-server-sdk-ai/compare/launchdarkly-server-sdk-ai-langchain-0.3.0...launchdarkly-server-sdk-ai-langchain-0.3.1) (2026-02-23)
+
+
+### Bug Fixes
+
+* Update pre-release usage guidance ([#90](https://github.com/launchdarkly/python-server-sdk-ai/issues/90)) ([4f986c4](https://github.com/launchdarkly/python-server-sdk-ai/commit/4f986c4b4f74f001e5487892509129bdc9aa091c))
+
 ## [0.3.0](https://github.com/launchdarkly/python-server-sdk-ai/compare/launchdarkly-server-sdk-ai-langchain-0.2.0...launchdarkly-server-sdk-ai-langchain-0.3.0) (2026-01-02)
 
 
diff --git a/packages/ai-providers/server-ai-langchain/README.md b/packages/ai-providers/server-ai-langchain/README.md
@@ -2,6 +2,12 @@
 
 [![PyPI](https://img.shields.io/pypi/v/launchdarkly-server-sdk-ai-langchain.svg)](https://pypi.org/project/launchdarkly-server-sdk-ai-langchain/)
 
+> [!CAUTION]
+> This package is in pre-release and not subject to backwards compatibility
+> guarantees. The API may change based on feedback.
+>
+> Pin to a specific minor version and review the [changelog](CHANGELOG.md) before upgrading.
+
 This package provides LangChain integration for the LaunchDarkly Server-Side AI SDK, allowing you to use LangChain models and chains with LaunchDarkly's tracking and configuration capabilities.
 
 ## Installation
diff --git a/packages/ai-providers/server-ai-langchain/pyproject.toml b/packages/ai-providers/server-ai-langchain/pyproject.toml
@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "launchdarkly-server-sdk-ai-langchain"
-version = "0.3.0"
+version = "0.3.1"
 description = "LaunchDarkly AI SDK LangChain Provider"
 authors = ["LaunchDarkly <dev@launchdarkly.com>"]
 license = "Apache-2.0"
diff --git a/packages/ai-providers/server-ai-openai/CHANGELOG.md b/packages/ai-providers/server-ai-openai/CHANGELOG.md
@@ -1,5 +1,12 @@
 # Changelog
 
+## [0.1.1](https://github.com/launchdarkly/python-server-sdk-ai/compare/launchdarkly-server-sdk-ai-openai-0.1.0...launchdarkly-server-sdk-ai-openai-0.1.1) (2026-02-23)
+
+
+### Bug Fixes
+
+* Update pre-release usage guidance ([#90](https://github.com/launchdarkly/python-server-sdk-ai/issues/90)) ([4f986c4](https://github.com/launchdarkly/python-server-sdk-ai/commit/4f986c4b4f74f001e5487892509129bdc9aa091c))
+
 ## 0.1.0 (2026-01-02)
 
 
diff --git a/packages/ai-providers/server-ai-openai/README.md b/packages/ai-providers/server-ai-openai/README.md
@@ -2,6 +2,12 @@
 
 [![PyPI](https://img.shields.io/pypi/v/launchdarkly-server-sdk-ai-openai-dev.svg?style=flat-square)](https://pypi.org/project/launchdarkly-server-sdk-ai-openai-dev/)
 
+> [!CAUTION]
+> This package is in pre-release and not subject to backwards compatibility
+> guarantees. The API may change based on feedback.
+>
+> Pin to a specific minor version and review the [changelog](CHANGELOG.md) before upgrading.
+
 This package provides an OpenAI integration for the LaunchDarkly AI SDK.
 
 ## Installation
diff --git a/packages/ai-providers/server-ai-openai/pyproject.toml b/packages/ai-providers/server-ai-openai/pyproject.toml
@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "launchdarkly-server-sdk-ai-openai"
-version = "0.1.0"
+version = "0.1.1"
 description = "LaunchDarkly AI SDK OpenAI Provider"
 authors = ["LaunchDarkly <dev@launchdarkly.com>"]
 license = "Apache-2.0"
diff --git a/packages/sdk/server-ai/CHANGELOG.md b/packages/sdk/server-ai/CHANGELOG.md
@@ -2,6 +2,21 @@
 
 All notable changes to the LaunchDarkly Python AI package will be documented in this file. This project adheres to [Semantic Versioning](http://semver.org).
 
+## [0.14.2](https://github.com/launchdarkly/python-server-sdk-ai/compare/launchdarkly-server-sdk-ai-0.14.1...launchdarkly-server-sdk-ai-0.14.2) (2026-02-25)
+
+
+### Bug Fixes
+
+* Only track usage for entry methods ([#94](https://github.com/launchdarkly/python-server-sdk-ai/issues/94)) ([22d91d9](https://github.com/launchdarkly/python-server-sdk-ai/commit/22d91d9982e27daf68016357a14fb6eca22dc8d6))
+
+## [0.14.1](https://github.com/launchdarkly/python-server-sdk-ai/compare/launchdarkly-server-sdk-ai-0.14.0...launchdarkly-server-sdk-ai-0.14.1) (2026-02-23)
+
+
+### Bug Fixes
+
+* Improve usage reporting ([#92](https://github.com/launchdarkly/python-server-sdk-ai/issues/92)) ([e21eb89](https://github.com/launchdarkly/python-server-sdk-ai/commit/e21eb890cc190822fd857f7a1032d2543400b356))
+* Update pre-release usage guidance ([#90](https://github.com/launchdarkly/python-server-sdk-ai/issues/90)) ([4f986c4](https://github.com/launchdarkly/python-server-sdk-ai/commit/4f986c4b4f74f001e5487892509129bdc9aa091c))
+
 ## [0.14.0](https://github.com/launchdarkly/python-server-sdk-ai/compare/launchdarkly-server-sdk-ai-0.13.0...launchdarkly-server-sdk-ai-0.14.0) (2026-01-27)
 
 
diff --git a/packages/sdk/server-ai/PROVENANCE.md b/packages/sdk/server-ai/PROVENANCE.md
@@ -10,7 +10,7 @@ To verify SLSA provenance attestations, we recommend using [slsa-verifier](https
 
 ```
 # Set the version of the library to verify
-VERSION=0.14.0
+VERSION=0.14.2
 ```
 
 <!-- x-release-please-end -->
diff --git a/packages/sdk/server-ai/README.md b/packages/sdk/server-ai/README.md
@@ -2,12 +2,11 @@
 
 This package contains the LaunchDarkly Server-Side AI SDK for Python (`launchdarkly-server-sdk-ai`).
 
-# ⛔️⛔️⛔️⛔️
-
 > [!CAUTION]
-> This library is a alpha version and should not be considered ready for production use while this message is visible.
-
-# ☝️☝️☝️☝️☝️☝️
+> This SDK is in pre-release and not subject to backwards compatibility
+> guarantees. The API may change based on feedback.
+>
+> Pin to a specific minor version and review the [changelog](CHANGELOG.md) before upgrading.
 
 ## LaunchDarkly overview
 
diff --git a/packages/sdk/server-ai/pyproject.toml b/packages/sdk/server-ai/pyproject.toml
@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "launchdarkly-server-sdk-ai"
-version = "0.14.0"
+version = "0.14.2"
 description = "LaunchDarkly SDK for AI"
 authors = ["LaunchDarkly <dev@launchdarkly.com>"]
 license = "Apache-2.0"
diff --git a/packages/sdk/server-ai/src/ldai/__init__.py b/packages/sdk/server-ai/src/ldai/__init__.py
@@ -1,4 +1,4 @@
-__version__ = "0.14.0"  # x-release-please-version
+__version__ = "0.14.2"  # x-release-please-version
 
 from ldclient import log
 
diff --git a/packages/sdk/server-ai/src/ldai/client.py b/packages/sdk/server-ai/src/ldai/client.py
@@ -15,33 +15,43 @@
                          JudgeConfiguration, LDMessage, ModelConfig,
                          ProviderConfig)
 from ldai.providers.ai_provider_factory import AIProviderFactory
+from ldai.sdk_info import AI_SDK_LANGUAGE, AI_SDK_NAME, AI_SDK_VERSION
 from ldai.tracker import AIGraphTracker, LDAIConfigTracker
 
+_TRACK_SDK_INFO = '$ld:ai:sdk:info'
+_TRACK_USAGE_COMPLETION_CONFIG = '$ld:ai:usage:completion-config'
+_TRACK_USAGE_CREATE_CHAT = '$ld:ai:usage:create-chat'
+_TRACK_USAGE_JUDGE_CONFIG = '$ld:ai:usage:judge-config'
+_TRACK_USAGE_CREATE_JUDGE = '$ld:ai:usage:create-judge'
+_TRACK_USAGE_AGENT_CONFIG = '$ld:ai:usage:agent-config'
+_TRACK_USAGE_AGENT_CONFIGS = '$ld:ai:usage:agent-configs'
+
+_INIT_TRACK_CONTEXT = Context.builder('ld-internal-tracking').kind('ld_ai').anonymous(True).build()
+
 
 class LDAIClient:
     """The LaunchDarkly AI SDK client object."""
 
     def __init__(self, client: LDClient):
         self._client = client
+        self._client.track(
+            _TRACK_SDK_INFO,
+            _INIT_TRACK_CONTEXT,
+            {
+                'aiSdkName': AI_SDK_NAME,
+                'aiSdkVersion': AI_SDK_VERSION,
+                'aiSdkLanguage': AI_SDK_LANGUAGE,
+            },
+            1,
+        )
 
-    def completion_config(
+    def _completion_config(
         self,
         key: str,
         context: Context,
         default_value: AICompletionConfigDefault,
         variables: Optional[Dict[str, Any]] = None,
     ) -> AICompletionConfig:
-        """
-        Get the value of a completion configuration.
-
-        :param key: The key of the completion configuration.
-        :param context: The context to evaluate the completion configuration in.
-        :param default_value: The default value of the completion configuration.
-        :param variables: Additional variables for the completion configuration.
-        :return: The completion configuration with a tracker used for gathering metrics.
-        """
-        self._client.track('$ld:ai:config:function:single', context, key, 1)
-
         model, provider, messages, instructions, tracker, enabled, judge_configuration, _ = self.__evaluate(
             key, context, default_value.to_dict(), variables
         )
@@ -58,6 +68,26 @@ def completion_config(
 
         return config
 
+    def completion_config(
+        self,
+        key: str,
+        context: Context,
+        default_value: AICompletionConfigDefault,
+        variables: Optional[Dict[str, Any]] = None,
+    ) -> AICompletionConfig:
+        """
+        Get the value of a completion configuration.
+
+        :param key: The key of the completion configuration.
+        :param context: The context to evaluate the completion configuration in.
+        :param default_value: The default value of the completion configuration.
+        :param variables: Additional variables for the completion configuration.
+        :return: The completion configuration with a tracker used for gathering metrics.
+        """
+        self._client.track(_TRACK_USAGE_COMPLETION_CONFIG, context, key, 1)
+
+        return self._completion_config(key, context, default_value, variables)
+
     def config(
         self,
         key: str,
@@ -78,24 +108,13 @@ def config(
         """
         return self.completion_config(key, context, default_value, variables)
 
-    def judge_config(
+    def _judge_config(
         self,
         key: str,
         context: Context,
         default_value: AIJudgeConfigDefault,
         variables: Optional[Dict[str, Any]] = None,
     ) -> AIJudgeConfig:
-        """
-        Get the value of a judge configuration.
-
-        :param key: The key of the judge configuration.
-        :param context: The context to evaluate the judge configuration in.
-        :param default_value: The default value of the judge configuration.
-        :param variables: Additional variables for the judge configuration.
-        :return: The judge configuration with a tracker used for gathering metrics.
-        """
-        self._client.track('$ld:ai:judge:function:single', context, key, 1)
-
         model, provider, messages, instructions, tracker, enabled, judge_configuration, variation = self.__evaluate(
             key, context, default_value.to_dict(), variables
         )
@@ -129,6 +148,26 @@ def _extract_evaluation_metric_key(variation: Dict[str, Any]) -> Optional[str]:
 
         return config
 
+    def judge_config(
+        self,
+        key: str,
+        context: Context,
+        default_value: AIJudgeConfigDefault,
+        variables: Optional[Dict[str, Any]] = None,
+    ) -> AIJudgeConfig:
+        """
+        Get the value of a judge configuration.
+
+        :param key: The key of the judge configuration.
+        :param context: The context to evaluate the judge configuration in.
+        :param default_value: The default value of the judge configuration.
+        :param variables: Additional variables for the judge configuration.
+        :return: The judge configuration with a tracker used for gathering metrics.
+        """
+        self._client.track(_TRACK_USAGE_JUDGE_CONFIG, context, key, 1)
+
+        return self._judge_config(key, context, default_value, variables)
+
     async def create_judge(
         self,
         key: str,
@@ -170,7 +209,7 @@ async def create_judge(
                     if relevance_eval:
                         print('Relevance score:', relevance_eval.score)
         """
-        self._client.track('$ld:ai:judge:function:createJudge', context, key, 1)
+        self._client.track(_TRACK_USAGE_CREATE_JUDGE, context, key, 1)
 
         try:
             if variables:
@@ -183,7 +222,7 @@ async def create_judge(
             extended_variables['message_history'] = '{{message_history}}'
             extended_variables['response_to_evaluate'] = '{{response_to_evaluate}}'
 
-            judge_config = self.judge_config(key, context, default_value, extended_variables)
+            judge_config = self._judge_config(key, context, default_value, extended_variables)
 
             if not judge_config.enabled or not judge_config.tracker:
                 return None
@@ -281,9 +320,9 @@ async def create_chat(
                 messages = chat.get_messages()
                 print(f"Conversation has {len(messages)} messages")
         """
-        self._client.track('$ld:ai:config:function:createChat', context, key, 1)
+        self._client.track(_TRACK_USAGE_CREATE_CHAT, context, key, 1)
         log.debug(f"Creating chat for key: {key}")
-        config = self.completion_config(key, context, default_value, variables)
+        config = self._completion_config(key, context, default_value, variables)
 
         if not config.enabled or not config.tracker:
             return None
@@ -340,7 +379,7 @@ def agent_config(
         :return: Configured AIAgentConfig instance.
         """
         self._client.track(
-            "$ld:ai:agent:function:single",
+            _TRACK_USAGE_AGENT_CONFIG,
             context,
             key,
             1
@@ -406,7 +445,7 @@ def agent_configs(
         """
         agent_count = len(agent_configs)
         self._client.track(
-            "$ld:ai:agent:function:multiple",
+            _TRACK_USAGE_AGENT_CONFIGS,
             context,
             agent_count,
             agent_count
diff --git a/packages/sdk/server-ai/src/ldai/sdk_info.py b/packages/sdk/server-ai/src/ldai/sdk_info.py
@@ -0,0 +1,7 @@
+from importlib.metadata import metadata
+
+_meta = metadata('launchdarkly-server-sdk-ai')
+
+AI_SDK_NAME: str = _meta['Name']
+AI_SDK_VERSION: str = _meta['Version']
+AI_SDK_LANGUAGE: str = 'python'
diff --git a/packages/sdk/server-ai/tests/test_model_config.py b/packages/sdk/server-ai/tests/test_model_config.py
@@ -323,9 +323,31 @@ def test_config_method_tracking(ldai_client: LDAIClient):
 
     config = client.config('test-config-key', context, default_value)
 
-    mock_client.track.assert_called_once_with(
-        '$ld:ai:config:function:single',
+    mock_client.track.assert_any_call(
+        '$ld:ai:usage:completion-config',
         context,
         'test-config-key',
         1
     )
+
+
+def test_sdk_info_tracked_on_init():
+    from unittest.mock import Mock
+
+    from ldai.client import _INIT_TRACK_CONTEXT
+    from ldai.sdk_info import AI_SDK_LANGUAGE, AI_SDK_NAME, AI_SDK_VERSION
+
+    mock_client = Mock()
+
+    client = LDAIClient(mock_client)
+
+    mock_client.track.assert_called_once_with(
+        '$ld:ai:sdk:info',
+        _INIT_TRACK_CONTEXT,
+        {
+            'aiSdkName': AI_SDK_NAME,
+            'aiSdkVersion': AI_SDK_VERSION,
+            'aiSdkLanguage': AI_SDK_LANGUAGE,
+        },
+        1,
+    )

Original file line number	Diff line number	Diff line change
`@@ -1,5 +1,5 @@`
`1`	`1`	`{`
`2`		`- "packages/sdk/server-ai": "0.14.0",`
`3`		`- "packages/ai-providers/server-ai-langchain": "0.3.0",`
`4`		`- "packages/ai-providers/server-ai-openai": "0.1.0"`
	`2`	`+ "packages/sdk/server-ai": "0.14.2",`
	`3`	`+ "packages/ai-providers/server-ai-langchain": "0.3.1",`
	`4`	`+ "packages/ai-providers/server-ai-openai": "0.1.1"`
`5`	`5`	`}`