feat!: Make AI config factory methods synchronous

The create_model, create_agent, and create_agent_graph methods on
LDAIClient performed no async work — they only invoked sync helpers
(_client.track, _completion_config, RunnerFactory.create_*, and the
Managed* constructors). Marking them async forced callers into
needless coroutine plumbing.

Convert the three factories to plain def. Update docstring examples
and provider READMEs to drop the now-incorrect await on the factory
call (run() on the returned Managed* is still async).

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

Author: jsonbailey

packages/ai-providers/server-ai-langchain/README.md

@@ -48,7 +48,7 @@ context = Context.builder("user-123").build()
 
 async def main():
     # Create a ManagedModel backed by the LangChain provider
-    model = await ai_client.create_model(
+    model = ai_client.create_model(
         "ai-config-key",
         context,
         AICompletionConfigDefault(
@@ -74,7 +74,7 @@ LaunchDarkly AI config flag, selects the LangChain runner automatically, and
 returns a `ManagedModel` that wraps the runner:
 
 ```python
-model = await ai_client.create_model("ai-config-key", context)
+model = ai_client.create_model("ai-config-key", context)
 
 if model:
     result = await model.run("What is feature flagging?")
@@ -121,7 +121,7 @@ print(result.parsed)  # {"sentiment": "positive", "confidence": 0.95}
 `LDAIConfigTracker`. For manual tracking, use the tracker directly:
 
 ```python
-model = await ai_client.create_model("ai-config-key", context)
+model = ai_client.create_model("ai-config-key", context)
 
 if model:
     result = await model.run("Explain feature flags.")

packages/ai-providers/server-ai-openai/README.md

@@ -35,7 +35,7 @@ context = Context.builder("user-123").build()
 
 async def main():
     # Create a ManagedModel backed by the OpenAI provider
-    model = await ai_client.create_model(
+    model = ai_client.create_model(
         "ai-config-key",
         context,
         AICompletionConfigDefault(
@@ -61,7 +61,7 @@ LaunchDarkly AI config flag, selects the OpenAI runner automatically, and
 returns a `ManagedModel` that wraps the runner:
 
 ```python
-model = await ai_client.create_model("ai-config-key", context)
+model = ai_client.create_model("ai-config-key", context)
 
 if model:
     result = await model.run("What is feature flagging?")
@@ -107,7 +107,7 @@ print(result.parsed)  # {"sentiment": "positive", "confidence": 0.95}
 `LDAIConfigTracker`. For manual tracking, use the tracker directly:
 
 ```python
-model = await ai_client.create_model("ai-config-key", context)
+model = ai_client.create_model("ai-config-key", context)
 
 if model:
     result = await model.run("Explain feature flags.")

packages/sdk/server-ai/README.md

@@ -115,7 +115,7 @@ from ldai import LDAIClient, AICompletionConfigDefault, ModelConfig, LDMessage
 # Use the same default_config from the retrieval section above
 async def main():
     context = Context.create("user-123")
-    model = await ai_client.create_model(
+    model = ai_client.create_model(
         'customer-support-chat',
         context,
         default_config,

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

@@ -383,7 +383,7 @@ def _build_evaluator(
                 judge_instances.append(judge)
         return Evaluator(judge_instances)
 
-    async def create_model(
+    def create_model(
         self,
         key: str,
         context: Context,
@@ -404,7 +404,7 @@ async def create_model(
 
         Example::
 
-            model = await client.create_model(
+            model = client.create_model(
                 "customer-support-chat",
                 context,
                 AICompletionConfigDefault(
@@ -435,7 +435,7 @@ async def create_model(
 
         return ManagedModel(config, runner)
 
-    async def create_agent(
+    def create_agent(
         self,
         key: str,
         context: Context,
@@ -463,7 +463,7 @@ async def create_agent(
 
         Example::
 
-            agent = await client.create_agent(
+            agent = client.create_agent(
                 "customer-support-agent",
                 context,
                 tools={"get-order": fetch_order_fn},
@@ -722,7 +722,7 @@ def graph_tracker_factory() -> AIGraphTracker:
             create_tracker=graph_tracker_factory,
         )
 
-    async def create_agent_graph(
+    def create_agent_graph(
         self,
         key: str,
         context: Context,
@@ -748,7 +748,7 @@ async def create_agent_graph(
 
         Example::
 
-            graph = await client.create_agent_graph(
+            graph = client.create_agent_graph(
                 "travel-assistant-graph",
                 context,
                 tools={

packages/sdk/server-ai/tests/test_managed_agent.py

@@ -310,30 +310,27 @@ async def _evaluate_coro(input_text: str, output_text: str) -> List[JudgeResult]
 class TestLDAIClientCreateAgent:
     """Tests for LDAIClient.create_agent."""
 
-    @pytest.mark.asyncio
-    async def test_returns_none_when_agent_is_disabled(self, ldai_client: LDAIClient):
+    def test_returns_none_when_agent_is_disabled(self, ldai_client: LDAIClient):
         """Should return None when agent config is disabled."""
         context = Context.create('user-key')
-        result = await ldai_client.create_agent('disabled-agent', context)
+        result = ldai_client.create_agent('disabled-agent', context)
 
         assert result is None
 
-    @pytest.mark.asyncio
-    async def test_returns_none_when_provider_unavailable(self, ldai_client: LDAIClient):
+    def test_returns_none_when_provider_unavailable(self, ldai_client: LDAIClient):
         """Should return None when no AI provider is available."""
         import ldai.providers.runner_factory as rf
         context = Context.create('user-key')
 
         original = rf.RunnerFactory.create_agent
         rf.RunnerFactory.create_agent = MagicMock(return_value=None)
         try:
-            result = await ldai_client.create_agent('customer-support-agent', context)
+            result = ldai_client.create_agent('customer-support-agent', context)
             assert result is None
         finally:
             rf.RunnerFactory.create_agent = original
 
-    @pytest.mark.asyncio
-    async def test_returns_managed_agent_when_runner_available(self, ldai_client: LDAIClient):
+    def test_returns_managed_agent_when_runner_available(self, ldai_client: LDAIClient):
         """Should return ManagedAgent when runner is successfully created."""
         import ldai.providers.runner_factory as rf
         context = Context.create('user-key')
@@ -346,7 +343,7 @@ async def test_returns_managed_agent_when_runner_available(self, ldai_client: LD
         original = rf.RunnerFactory.create_agent
         rf.RunnerFactory.create_agent = MagicMock(return_value=mock_runner)
         try:
-            result = await ldai_client.create_agent('customer-support-agent', context)
+            result = ldai_client.create_agent('customer-support-agent', context)
             assert isinstance(result, ManagedAgent)
             assert result.get_agent_runner() is mock_runner
         finally:

packages/sdk/server-ai/tests/test_managed_agent_graph.py

@@ -303,7 +303,7 @@ async def test_create_agent_graph_returns_managed_agent_graph(ldai_client: LDAIC
         'ldai.providers.runner_factory.RunnerFactory.create_agent_graph',
         new=MagicMock(return_value=stub_runner),
     ):
-        managed = await ldai_client.create_agent_graph('travel-graph', context)
+        managed = ldai_client.create_agent_graph('travel-graph', context)
 
     assert managed is not None
     assert isinstance(managed, ManagedAgentGraph)
@@ -313,7 +313,7 @@ async def test_create_agent_graph_returns_managed_agent_graph(ldai_client: LDAIC
 @pytest.mark.asyncio
 async def test_create_agent_graph_returns_none_when_disabled(ldai_client: LDAIClient):
     context = Context.create('user-key')
-    managed = await ldai_client.create_agent_graph('disabled-graph', context)
+    managed = ldai_client.create_agent_graph('disabled-graph', context)
     assert managed is None
 
 
@@ -325,7 +325,7 @@ async def test_create_agent_graph_returns_none_when_runner_factory_fails(ldai_cl
         'ldai.providers.runner_factory.RunnerFactory.create_agent_graph',
         new=MagicMock(return_value=None),
     ):
-        managed = await ldai_client.create_agent_graph('travel-graph', context)
+        managed = ldai_client.create_agent_graph('travel-graph', context)
 
     assert managed is None
 
@@ -344,7 +344,7 @@ def fake_create_agent_graph(graph_def, tools_arg, default_ai_provider=None):
         'ldai.providers.runner_factory.RunnerFactory.create_agent_graph',
         new=fake_create_agent_graph,
     ):
-        await ldai_client.create_agent_graph('travel-graph', context, tools=tools)
+        ldai_client.create_agent_graph('travel-graph', context, tools=tools)
 
     assert captured['tools'] is tools
 
@@ -357,7 +357,7 @@ async def test_create_agent_graph_run_produces_result(ldai_client: LDAIClient):
         'ldai.providers.runner_factory.RunnerFactory.create_agent_graph',
         new=MagicMock(return_value=StubAgentGraphRunner("final answer")),
     ):
-        managed = await ldai_client.create_agent_graph('travel-graph', context)
+        managed = ldai_client.create_agent_graph('travel-graph', context)
 
     assert managed is not None
     result = await managed.run("find restaurants")