add experimental label

Author: jsonbailey

packages/ai-providers/server-ai-langchain/pyproject.toml

@@ -25,7 +25,7 @@ dependencies = [
 ]
 
 [project.optional-dependencies]
-graph = ["langgraph>=0.1.0"]
+graph = ["langgraph>=1.0.0"]
 
 [project.urls]
 Homepage = "https://docs.launchdarkly.com/sdk/ai/python"
@@ -39,7 +39,7 @@ dev = [
     "mypy==1.18.2",
     "pycodestyle>=2.11.0",
     "isort>=5.12.0",
-    "langgraph>=0.1.0",
+    "langgraph>=1.0.0",
 ]
 
 [build-system]

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

@@ -1,5 +1,3 @@
-"""LangChain agent runner for LaunchDarkly AI SDK."""
-
 from typing import Any
 
 from ldai import log
@@ -14,6 +12,11 @@
 
 class LangChainAgentRunner(AgentRunner):
     """
+    CAUTION:
+    This feature is experimental and should NOT be considered ready for production use. 
+    It may change or be removed without notice and is not subject to backwards 
+    compatibility guarantees.
+
     AgentRunner implementation for LangChain.
 
     Wraps a compiled LangChain agent graph (from ``langchain.agents.create_agent``)

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

@@ -14,8 +14,38 @@
 class LangChainRunnerFactory(AIProvider):
     """LangChain ``AIProvider`` implementation for the LaunchDarkly AI SDK."""
 
+    def create_agent(self, config: Any, tools: Optional[ToolRegistry] = None) -> LangChainAgentRunner:
+        """
+        CAUTION:
+        This feature is experimental and should NOT be considered ready for production use. 
+        It may change or be removed without notice and is not subject to backwards 
+        compatibility guarantees.
+
+        Create a configured LangChainAgentRunner for the given AI agent config.
+
+        :param config: The LaunchDarkly AI agent configuration
+        :param tools: ToolRegistry mapping tool names to callables
+        :return: LangChainAgentRunner ready to run the agent
+        """
+        from langchain.agents import create_agent as lc_create_agent
+        instructions = (config.instructions or '') if hasattr(config, 'instructions') else ''
+        llm = create_langchain_model(config)
+        lc_tools = build_tools(config, tools or {})
+
+        agent = lc_create_agent(
+            llm,
+            tools=lc_tools or None,
+            system_prompt=instructions or None,
+        )
+        return LangChainAgentRunner(agent)
+
     def create_agent_graph(self, graph_def: Any, tools: ToolRegistry) -> Any:
         """
+        CAUTION:
+        This feature is experimental and should NOT be considered ready for production use. 
+        It may change or be removed without notice and is not subject to backwards 
+        compatibility guarantees.
+
         Create a configured LangGraphAgentGraphRunner for the given graph definition.
 
         :param graph_def: The AgentGraphDefinition to execute
@@ -36,23 +66,3 @@ def create_model(self, config: AIConfigKind) -> LangChainModelRunner:
         """
         llm = create_langchain_model(config)
         return LangChainModelRunner(llm)
-
-    def create_agent(self, config: Any, tools: Optional[ToolRegistry] = None) -> LangChainAgentRunner:
-        """
-        Create a configured LangChainAgentRunner for the given AI agent config.
-
-        :param config: The LaunchDarkly AI agent configuration
-        :param tools: ToolRegistry mapping tool names to callables
-        :return: LangChainAgentRunner ready to run the agent
-        """
-        from langchain.agents import create_agent as lc_create_agent
-        instructions = (config.instructions or '') if hasattr(config, 'instructions') else ''
-        llm = create_langchain_model(config)
-        lc_tools = build_tools(config, tools or {})
-
-        agent = lc_create_agent(
-            llm,
-            tools=lc_tools or None,
-            system_prompt=instructions or None,
-        )
-        return LangChainAgentRunner(agent)

packages/ai-providers/server-ai-openai/src/ldai_openai/openai_agent_graph_runner.py

@@ -1,5 +1,3 @@
-"""OpenAI agent graph runner for LaunchDarkly AI SDK."""
-
 import re
 import time
 from typing import Any, Dict, List, Optional
@@ -34,6 +32,11 @@ def __init__(self, last_handoff_ns: int, last_node_key: str) -> None:
 
 class OpenAIAgentGraphRunner(AgentGraphRunner):
     """
+    CAUTION:
+    This feature is experimental and should NOT be considered ready for production use. 
+    It may change or be removed without notice and is not subject to backwards 
+    compatibility guarantees.
+
     AgentGraphRunner implementation for the OpenAI Agents SDK.
 
     Runs the agent graph with the OpenAI Agents SDK and automatically records

packages/ai-providers/server-ai-openai/src/ldai_openai/openai_agent_runner.py

@@ -1,5 +1,3 @@
-"""OpenAI agent runner for LaunchDarkly AI SDK."""
-
 from typing import Any, Dict, List
 
 from ldai import log
@@ -14,6 +12,11 @@
 
 class OpenAIAgentRunner(AgentRunner):
     """
+    CAUTION:
+    This feature is experimental and should NOT be considered ready for production use. 
+    It may change or be removed without notice and is not subject to backwards 
+    compatibility guarantees.
+
     AgentRunner implementation for OpenAI.
 
     Executes a single agent using the OpenAI Agents SDK (``openai-agents``).

packages/ai-providers/server-ai-openai/src/ldai_openai/openai_runner_factory.py

@@ -36,37 +36,13 @@ def _extract_model_config(self, config: AIConfigKind) -> tuple:
         model_dict = config_dict.get('model') or {}
         return model_dict.get('name', ''), model_dict.get('parameters') or {}
 
-    def create_model(self, config: AIConfigKind) -> OpenAIModelRunner:
-        """
-        Create a configured OpenAIModelRunner for the given AI config.
-
-        Reuses the underlying AsyncOpenAI client so connection pooling is preserved.
-        Tool definitions are converted from LD's flat format to the Chat Completions
-        API format, with native tools mapped to their correct API type.
-
-        :param config: The LaunchDarkly AI configuration
-        :return: OpenAIModelRunner ready to invoke the model
-        """
-        model_name, parameters = self._extract_model_config(config)
-        parameters = dict(parameters)
-        tool_defs = parameters.pop('tools', None) or []
-        if tool_defs:
-            parameters['tools'] = normalize_tool_types(tool_defs)
-        return OpenAIModelRunner(self._client, model_name, parameters)
-
-    def create_agent_graph(self, graph_def: Any, tools: ToolRegistry) -> Any:
-        """
-        Create a configured OpenAIAgentGraphRunner for the given graph definition.
-
-        :param graph_def: The AgentGraphDefinition to execute
-        :param tools: Registry mapping tool names to callables
-        :return: OpenAIAgentGraphRunner ready to execute the graph
-        """
-        from ldai_openai.openai_agent_graph_runner import OpenAIAgentGraphRunner
-        return OpenAIAgentGraphRunner(graph_def, tools)
-
     def create_agent(self, config: Any, tools: Optional[ToolRegistry] = None) -> 'OpenAIAgentRunner':
         """
+        CAUTION:
+        This feature is experimental and should NOT be considered ready for production use. 
+        It may change or be removed without notice and is not subject to backwards 
+        compatibility guarantees.
+
         Create a configured OpenAIAgentRunner for the given AI agent config.
 
         :param config: The LaunchDarkly AI agent configuration
@@ -88,6 +64,40 @@ def create_agent(self, config: Any, tools: Optional[ToolRegistry] = None) -> 'Op
             tools or {},
         )
 
+    def create_agent_graph(self, graph_def: Any, tools: ToolRegistry) -> Any:
+        """
+        CAUTION:
+        This feature is experimental and should NOT be considered ready for production use. 
+        It may change or be removed without notice and is not subject to backwards 
+        compatibility guarantees.
+
+        Create a configured OpenAIAgentGraphRunner for the given graph definition.
+
+        :param graph_def: The AgentGraphDefinition to execute
+        :param tools: Registry mapping tool names to callables
+        :return: OpenAIAgentGraphRunner ready to execute the graph
+        """
+        from ldai_openai.openai_agent_graph_runner import OpenAIAgentGraphRunner
+        return OpenAIAgentGraphRunner(graph_def, tools)
+
+    def create_model(self, config: AIConfigKind) -> OpenAIModelRunner:
+        """
+        Create a configured OpenAIModelRunner for the given AI config.
+
+        Reuses the underlying AsyncOpenAI client so connection pooling is preserved.
+        Tool definitions are converted from LD's flat format to the Chat Completions
+        API format, with native tools mapped to their correct API type.
+
+        :param config: The LaunchDarkly AI configuration
+        :return: OpenAIModelRunner ready to invoke the model
+        """
+        model_name, parameters = self._extract_model_config(config)
+        parameters = dict(parameters)
+        tool_defs = parameters.pop('tools', None) or []
+        if tool_defs:
+            parameters['tools'] = normalize_tool_types(tool_defs)
+        return OpenAIModelRunner(self._client, model_name, parameters)
+
     def get_client(self) -> AsyncOpenAI:
         """
         Return the underlying AsyncOpenAI client.

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

@@ -390,6 +390,11 @@ async def create_agent(
         default_ai_provider: Optional[str] = None,
     ) -> Optional[ManagedAgent]:
         """
+        CAUTION:
+        This feature is experimental and should NOT be considered ready for production use. 
+        It may change or be removed without notice and is not subject to backwards 
+        compatibility guarantees.
+
         Creates and returns a new ManagedAgent for AI agent invocations.
 
         :param key: The key identifying the AI agent configuration to use
@@ -675,6 +680,11 @@ async def create_agent_graph(
         default_ai_provider: Optional[str] = None,
     ) -> Optional[ManagedAgentGraph]:
         """
+        CAUTION:
+        This feature is experimental and should NOT be considered ready for production use. 
+        It may change or be removed without notice and is not subject to backwards 
+        compatibility guarantees.
+
         Creates and returns a new ManagedAgentGraph for AI agent graph execution.
 
         Resolves the graph configuration via ``agent_graph()``, creates a

packages/sdk/server-ai/src/ldai/providers/agent_graph_runner.py

@@ -6,6 +6,11 @@
 @runtime_checkable
 class AgentGraphRunner(Protocol):
     """
+    CAUTION:
+    This feature is experimental and should NOT be considered ready for production use. 
+    It may change or be removed without notice and is not subject to backwards 
+    compatibility guarantees.
+
     Runtime capability interface for multi-agent graph execution.
 
     An AgentGraphRunner is a focused, configured object returned by

packages/sdk/server-ai/src/ldai/providers/agent_runner.py

@@ -6,6 +6,11 @@
 @runtime_checkable
 class AgentRunner(Protocol):
     """
+    CAUTION:
+    This feature is experimental and should NOT be considered ready for production use. 
+    It may change or be removed without notice and is not subject to backwards 
+    compatibility guarantees.
+
     Runtime capability interface for single-agent execution.
 
     An AgentRunner is a focused, configured object returned by

packages/sdk/server-ai/src/ldai/providers/ai_provider.py

@@ -75,6 +75,11 @@ def create_model(self, config: Any) -> Optional[Any]:
 
     def create_agent(self, config: Any, tools: Optional[ToolRegistry] = None) -> Optional[Any]:
         """
+        CAUTION:
+        This feature is experimental and should NOT be considered ready for production use. 
+        It may change or be removed without notice and is not subject to backwards 
+        compatibility guarantees.
+
         Create a configured agent executor for the given AI config and tool registry.
 
         Default implementation warns. Provider implementations should override this method.
@@ -88,6 +93,11 @@ def create_agent(self, config: Any, tools: Optional[ToolRegistry] = None) -> Opt
 
     def create_agent_graph(self, graph_def: Any, tools: Any) -> Optional[Any]:
         """
+        CAUTION:
+        This feature is experimental and should NOT be considered ready for production use. 
+        It may change or be removed without notice and is not subject to backwards 
+        compatibility guarantees.
+
         Create a configured agent graph executor for the given graph definition and tools.
 
         Default implementation warns. Provider implementations should override this method.