Skip to content

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

Merged
jsonbailey merged 8 commits intomainfrom
jb/aic-1664/managed-model
Mar 26, 2026
Merged

feat: Introduce ManagedModel and ModelRunner (PR-3)#104
jsonbailey merged 8 commits intomainfrom
jb/aic-1664/managed-model

Conversation

@jsonbailey
Copy link
Copy Markdown
Contributor

@jsonbailey jsonbailey commented Mar 11, 2026

feat: Add ModelRunner ABC with invoke_model() and invoke_structured_model()
feat: Add ManagedModel replacing Chat; expose get_model_runner() escape hatch
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


Note

High Risk
High risk because it changes core SDK abstractions and public APIs (e.g., Chat/ChatResponse -> ManagedModel/ModelResponse) and refactors provider invocation paths, which can break downstream integrations despite tests updates.

Overview
Introduces a new runtime abstraction, ModelRunner, and a new managed wrapper, ManagedModel, shifting the SDK’s model execution path from provider instances to configured runner objects.

Renames ChatResponse to ModelResponse across the SDK, updates RunnerFactory.create_model() to return a ModelRunner, and updates Judge to invoke structured output through a runner instead of an AIProvider.

Refactors the OpenAI and LangChain provider packages so their *RunnerFactory classes are model-creation-only, extracting invocation logic into OpenAIModelRunner/LangChainModelRunner and shared helper modules; updates exports and tests accordingly. Adds LDAIClient.create_model() and deprecates create_chat() and Chat (now a compatibility alias).

Written by Cursor Bugbot for commit 9285ffd. This will update automatically on new commits. Configure here.

@jsonbailey jsonbailey changed the title feat!: Introduce ManagedModel and ModelRunner (PR 3) feat!: Introduce ManagedModel and ModelRunner (PR-3) Mar 11, 2026
@jsonbailey jsonbailey force-pushed the jb/aic-1664/managed-model branch from 39bac26 to 3fc5d47 Compare March 11, 2026 18:36
@jsonbailey jsonbailey force-pushed the jb/aic-1664/adapter-executor-factory branch from 4bef65c to e10be52 Compare March 25, 2026 14:33
Base automatically changed from jb/aic-1664/adapter-executor-factory to main March 25, 2026 17:20
feat: Add ModelRunner ABC with invoke_model() and invoke_structured_model()
feat: Add ManagedModel replacing Chat; expose get_model_runner() escape hatch
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: Add OpenAIHelper with shared utilities for model and future agent runners
feat: Add LangChainHelper with shared utilities for model and future agent runners
feat!: LangChainRunnerFactory is now a no-arg factory; static helpers moved to LangChainHelper
fix: LDClient.create_chat() is deprecated in favour of create_model()
fix: Chat alias in ldai.chat is deprecated in favour of ManagedModel
fix: Rename ai_provider param to model_runner in Judge and ManagedModel
@jsonbailey jsonbailey force-pushed the jb/aic-1664/managed-model branch from 3fc5d47 to fc3880c Compare March 25, 2026 17:49
@jsonbailey jsonbailey marked this pull request as ready for review March 25, 2026 17:54
@jsonbailey jsonbailey requested a review from a team as a code owner March 25, 2026 17:54
@jsonbailey jsonbailey changed the title feat!: Introduce ManagedModel and ModelRunner (PR-3) feat: Introduce ManagedModel and ModelRunner (PR-3) Mar 25, 2026
Copy link
Copy Markdown

@cursor cursor bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Cursor Bugbot has reviewed your changes and found 1 potential issue.

Fix All in Cursor

Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, have a team admin enable autofix in the Cursor dashboard.

…ve unused import

- Restore mutable structured_response pattern from f951dac so raw_response
  and usage are preserved even when an exception occurs after partial extraction
- Rename LangChainHelper.convert_messages -> convert_messages_to_langchain
- Rename OpenAIHelper.convert_messages -> convert_messages_to_openai
- Remove unused TokenUsage import from openai_model_runner.py
- Fix runner_factory.create_model return type to Optional[ModelRunner]
- Fix isort in langchain/openai runner and helper files
- Fix isort in ldai/__init__.py and client.py

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
jsonbailey and others added 2 commits March 26, 2026 08:50
…vel functions

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@jsonbailey jsonbailey merged commit 453c71c into main Mar 26, 2026
46 checks passed
@jsonbailey jsonbailey deleted the jb/aic-1664/managed-model branch March 26, 2026 14:10
@github-actions github-actions bot mentioned this pull request Mar 26, 2026
jsonbailey added a commit that referenced this pull request Apr 2, 2026
🤖 I have created a release *beep* *boop*
---


<details><summary>launchdarkly-server-sdk-ai: 0.17.0</summary>

##
[0.17.0](launchdarkly-server-sdk-ai-0.16.1...launchdarkly-server-sdk-ai-0.17.0)
(2026-04-02)


### ⚠ BREAKING CHANGES

* Bump minimum LangChain version to 1.0.0
* Split track_metrics_of into sync and async variants
([#112](#112))
* Remove node-scoped methods from AIGraphTracker (track_node_invocation,
track_tool_call, track_node_judge_response), use related AIConfigTracker
methods instead
* Extract shared utilities to openai_helper
* Extract shared utilities to langchain_helper
* Restructure provider factory and support additional create methods
([#102](#102))

### Features

* Add get_ai_usage_from_response to openai_helper
([4fab18f](4fab18f))
* Add get_tool_calls_from_response and sum_token_usage_from_messages to
langchain_helper
([4fab18f](4fab18f))
* Add LangGraphAgentGraphRunner
([56ce0fd](56ce0fd))
* Add LDAIClient.create_agent() returning ManagedAgent
([53fd95e](53fd95e))
* Add ManagedAgentGraph support
([#111](#111))
([56ce0fd](56ce0fd))
* Add ModelRunner ABC with invoke_model() and
([453c71c](453c71c))
* Add OpenAIAgentGraphRunner
([56ce0fd](56ce0fd))
* Add OpenAIAgentRunner with agentic tool-calling loop
([53fd95e](53fd95e))
* add optimization package stub
([872e81e](872e81e))
* Add optional graph_key to all LDAIConfigTracker track_* methods for
graph correlation
([4fab18f](4fab18f))
* Add track_tool_call/track_tool_calls to LDAIConfigTracker
([4fab18f](4fab18f))
* Adds optimization package stub
([58b7731](58b7731))
* Bump minimum LangChain version to 1.0.0
([dc592c5](dc592c5))
* Deprecated Chat object in favor of ManagedModel
([453c71c](453c71c))
* Deprecated create_chat(), use create_model() on the LDAIClient
([453c71c](453c71c))
* Drop support for python 3.9
([#114](#114))
([dc592c5](dc592c5))
* Extract shared utilities to langchain_helper
([453c71c](453c71c))
* Extract shared utilities to openai_helper
([453c71c](453c71c))
* Introduce ManagedAgent and AgentRunner implementations
([#110](#110))
([53fd95e](53fd95e))
* Introduce ManagedModel and ModelRunner (PR-3)
([#104](#104))
([453c71c](453c71c))
* Restructure provider factory and support additional create methods
([#102](#102))
([e6e4907](e6e4907))
* Split track_metrics_of into sync and async variants
([#112](#112))
([4fab18f](4fab18f))


### Bug Fixes

* make AIGraphTracker.track_total_tokens accept Optional[TokenUsage],
skip when None or total &lt;= 0
([4fab18f](4fab18f))
* Remove node-scoped methods from AIGraphTracker (track_node_invocation,
track_tool_call, track_node_judge_response), use related AIConfigTracker
methods instead
([4fab18f](4fab18f))
* use time.perf_counter_ns() for sub-millisecond precision in duration
calculations
([4fab18f](4fab18f))
</details>

<details><summary>launchdarkly-server-sdk-ai-langchain: 0.4.0</summary>

##
[0.4.0](launchdarkly-server-sdk-ai-langchain-0.3.2...launchdarkly-server-sdk-ai-langchain-0.4.0)
(2026-04-02)


### ⚠ BREAKING CHANGES

* Bump minimum LangChain version to 1.0.0
* Split track_metrics_of into sync and async variants
([#112](#112))
* Remove node-scoped methods from AIGraphTracker (track_node_invocation,
track_tool_call, track_node_judge_response), use related AIConfigTracker
methods instead
* Extract shared utilities to openai_helper
* Extract shared utilities to langchain_helper
* Restructure provider factory and support additional create methods
([#102](#102))

### Features

* Add get_ai_usage_from_response to openai_helper
([4fab18f](4fab18f))
* Add get_tool_calls_from_response and sum_token_usage_from_messages to
langchain_helper
([4fab18f](4fab18f))
* Add LangGraphAgentGraphRunner
([56ce0fd](56ce0fd))
* Add LDAIClient.create_agent() returning ManagedAgent
([53fd95e](53fd95e))
* Add ManagedAgentGraph support
([#111](#111))
([56ce0fd](56ce0fd))
* Add ModelRunner ABC with invoke_model() and
([453c71c](453c71c))
* Add OpenAIAgentGraphRunner
([56ce0fd](56ce0fd))
* Add OpenAIAgentRunner with agentic tool-calling loop
([53fd95e](53fd95e))
* add optimization package stub
([872e81e](872e81e))
* Add optional graph_key to all LDAIConfigTracker track_* methods for
graph correlation
([4fab18f](4fab18f))
* Add track_tool_call/track_tool_calls to LDAIConfigTracker
([4fab18f](4fab18f))
* Adds optimization package stub
([58b7731](58b7731))
* Bump minimum LangChain version to 1.0.0
([dc592c5](dc592c5))
* Deprecated Chat object in favor of ManagedModel
([453c71c](453c71c))
* Deprecated create_chat(), use create_model() on the LDAIClient
([453c71c](453c71c))
* Drop support for python 3.9
([#114](#114))
([dc592c5](dc592c5))
* Extract shared utilities to langchain_helper
([453c71c](453c71c))
* Extract shared utilities to openai_helper
([453c71c](453c71c))
* Introduce ManagedAgent and AgentRunner implementations
([#110](#110))
([53fd95e](53fd95e))
* Introduce ManagedModel and ModelRunner (PR-3)
([#104](#104))
([453c71c](453c71c))
* Restructure provider factory and support additional create methods
([#102](#102))
([e6e4907](e6e4907))
* Split track_metrics_of into sync and async variants
([#112](#112))
([4fab18f](4fab18f))


### Bug Fixes

* make AIGraphTracker.track_total_tokens accept Optional[TokenUsage],
skip when None or total &lt;= 0
([4fab18f](4fab18f))
* Remove node-scoped methods from AIGraphTracker (track_node_invocation,
track_tool_call, track_node_judge_response), use related AIConfigTracker
methods instead
([4fab18f](4fab18f))
* use time.perf_counter_ns() for sub-millisecond precision in duration
calculations
([4fab18f](4fab18f))
</details>

<details><summary>launchdarkly-server-sdk-ai-openai: 0.3.0</summary>

##
[0.3.0](launchdarkly-server-sdk-ai-openai-0.2.1...launchdarkly-server-sdk-ai-openai-0.3.0)
(2026-04-02)


### ⚠ BREAKING CHANGES

* Bump minimum LangChain version to 1.0.0
* Extract shared utilities to openai_helper
* Extract shared utilities to langchain_helper
* Restructure provider factory and support additional create methods
([#102](#102))

### Features

* Add LangGraphAgentGraphRunner
([56ce0fd](56ce0fd))
* Add LDAIClient.create_agent() returning ManagedAgent
([53fd95e](53fd95e))
* Add ManagedAgentGraph support
([#111](#111))
([56ce0fd](56ce0fd))
* Add ModelRunner ABC with invoke_model() and
([453c71c](453c71c))
* Add OpenAIAgentGraphRunner
([56ce0fd](56ce0fd))
* Add OpenAIAgentRunner with agentic tool-calling loop
([53fd95e](53fd95e))
* add optimization package stub
([872e81e](872e81e))
* Adds optimization package stub
([58b7731](58b7731))
* Bump minimum LangChain version to 1.0.0
([dc592c5](dc592c5))
* Deprecated Chat object in favor of ManagedModel
([453c71c](453c71c))
* Deprecated create_chat(), use create_model() on the LDAIClient
([453c71c](453c71c))
* Drop support for python 3.9
([#114](#114))
([dc592c5](dc592c5))
* Extract shared utilities to langchain_helper
([453c71c](453c71c))
* Extract shared utilities to openai_helper
([453c71c](453c71c))
* Introduce ManagedAgent and AgentRunner implementations
([#110](#110))
([53fd95e](53fd95e))
* Introduce ManagedModel and ModelRunner (PR-3)
([#104](#104))
([453c71c](453c71c))
* Restructure provider factory and support additional create methods
([#102](#102))
([e6e4907](e6e4907))
</details>

<details><summary>launchdarkly-server-sdk-ai-optimization:
0.1.0</summary>

## 0.1.0 (2026-04-02)


### ⚠ BREAKING CHANGES

* Bump minimum LangChain version to 1.0.0

### Features

* Add optimization package stub
([#109](#109))
([ebd5166](ebd5166))
* Adds optimization package stub
([58b7731](58b7731))
* Adds optimization package stub
([cc85a05](cc85a05))
* Bump minimum LangChain version to 1.0.0
([dc592c5](dc592c5))
* Drop support for python 3.9
([#114](#114))
([dc592c5](dc592c5))


### Bug Fixes

* consistency with other makefiles
([b9a5601](b9a5601))
</details>

---
This PR was generated with [Release
Please](https://github.com/googleapis/release-please). See
[documentation](https://github.com/googleapis/release-please#release-please).

<!-- CURSOR_SUMMARY -->
---

> [!NOTE]
> **Low Risk**
> Low risk because this PR only updates release metadata (versions,
manifests, provenance docs, and changelogs) without changing runtime
code paths.
> 
> **Overview**
> Bumps package versions for the release: `launchdarkly-server-sdk-ai`
to `0.17.0`, LangChain provider to `0.4.0`, OpenAI provider to `0.3.0`,
and introduces/bumps `launchdarkly-server-sdk-ai-optimization` to
`0.1.0` (via `.release-please-manifest.json` and each package’s
`pyproject.toml`/`__init__.__version__`).
> 
> Updates `CHANGELOG.md` entries and `PROVENANCE.md` version references
to match the new release numbers.
> 
> <sup>Written by [Cursor
Bugbot](https://cursor.com/dashboard?tab=bugbot) for commit
ae3e183. This will update automatically
on new commits. Configure
[here](https://cursor.com/dashboard?tab=bugbot).</sup>
<!-- /CURSOR_SUMMARY -->

---------

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Co-authored-by: jsonbailey <jbailey@launchdarkly.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants