From d2c297eebadbcdba085cbf71a4a1eb9a2b199c28 Mon Sep 17 00:00:00 2001
From: "github-actions[bot]"
 <41898282+github-actions[bot]@users.noreply.github.com>
Date: Fri, 14 Aug 2026 21:21:22 +0000
Subject: [PATCH] chore: release main

---
 .release-please-manifest.json                 | 14 ++++----
 packages/claude-agents/CHANGELOG.md           | 29 +++++++++++++++
 packages/claude-agents/pyproject.toml         |  2 +-
 .../launchdarkly_ai_claude_agents/__init__.py |  2 +-
 packages/claude-messages/CHANGELOG.md         | 32 +++++++++++++++++
 packages/claude-messages/pyproject.toml       |  2 +-
 .../__init__.py                               |  2 +-
 packages/client/CHANGELOG.md                  | 31 ++++++++++++++++
 packages/client/pyproject.toml                |  2 +-
 .../src/launchdarkly_ai_server/__init__.py    |  2 +-
 packages/langchain-agents/CHANGELOG.md        | 33 +++++++++++++++++
 packages/langchain-agents/pyproject.toml      |  2 +-
 .../__init__.py                               |  2 +-
 packages/langchain-messages/CHANGELOG.md      | 35 +++++++++++++++++++
 packages/langchain-messages/pyproject.toml    |  2 +-
 .../__init__.py                               |  2 +-
 packages/openai-agents/CHANGELOG.md           | 33 +++++++++++++++++
 packages/openai-agents/pyproject.toml         |  2 +-
 .../launchdarkly_ai_openai_agents/__init__.py |  2 +-
 packages/openai-messages/CHANGELOG.md         | 31 ++++++++++++++++
 packages/openai-messages/pyproject.toml       |  2 +-
 .../__init__.py                               |  2 +-
 22 files changed, 245 insertions(+), 21 deletions(-)

diff --git a/.release-please-manifest.json b/.release-please-manifest.json
index e89334c..7d5db9a 100644
--- a/.release-please-manifest.json
+++ b/.release-please-manifest.json
@@ -1,10 +1,10 @@
 {
-  "packages/client": "0.1.3",
+  "packages/client": "0.2.0",
   "packages/ai": "0.1.3",
-  "packages/claude-agents": "0.1.4",
-  "packages/claude-messages": "0.1.4",
-  "packages/openai-agents": "0.1.4",
-  "packages/openai-messages": "0.1.4",
-  "packages/langchain-agents": "0.1.4",
-  "packages/langchain-messages": "0.1.4"
+  "packages/claude-agents": "0.2.0",
+  "packages/claude-messages": "0.2.0",
+  "packages/openai-agents": "0.2.0",
+  "packages/openai-messages": "0.2.0",
+  "packages/langchain-agents": "0.2.0",
+  "packages/langchain-messages": "0.2.0"
 }
diff --git a/packages/claude-agents/CHANGELOG.md b/packages/claude-agents/CHANGELOG.md
index 9de6a6b..6a0ac42 100644
--- a/packages/claude-agents/CHANGELOG.md
+++ b/packages/claude-agents/CHANGELOG.md
@@ -1,5 +1,34 @@
 # Changelog
 
+## [0.2.0](https://github.com/launchdarkly/python-ai-sdk/compare/launchdarkly-ai-claude-agents-0.1.4...launchdarkly-ai-claude-agents-0.2.0) (2026-08-14)
+
+
+### ⚠ BREAKING CHANGES
+
+* **claude-agents:** stop an empty tool list switching off the built-ins
+* **claude-agents:** the span this handler emits is renamed from `claude.query` and `claude.query.stream` to `invoke_agent`. Queries selecting on the old names will not match. Prompt and completion content is no longer on spans unless the caller passes capture_content=True.
+
+### Features
+
+* **claude-agents:** emit invoke_agent, chat and execute_tool spans ([7831c81](https://github.com/launchdarkly/python-ai-sdk/commit/7831c8129bdeedb6440685a55a40280daf63b35d))
+
+
+### Bug Fixes
+
+* **claude-agents:** an abandoned stream is not an error for its tool spans ([10b8158](https://github.com/launchdarkly/python-ai-sdk/commit/10b81583650ae5356045cfa444313d8adde79bb5))
+* **claude-agents:** an empty run must not claim it cost nothing ([85c73ff](https://github.com/launchdarkly/python-ai-sdk/commit/85c73ffb9cb0af85304f38d93e3a896855f2c61a))
+* **claude-agents:** keep a tool span trackable when its content will not serialise ([0738606](https://github.com/launchdarkly/python-ai-sdk/commit/07386063f5e8157b44819fbadb2ebbd882ed859b))
+* **claude-agents:** keep the spans of a cancelled run ([b7dddfa](https://github.com/launchdarkly/python-ai-sdk/commit/b7dddfac2099fafed29870790cd48f48f96d10b1))
+* **claude-agents:** put the input content write inside the guard too ([f0160c2](https://github.com/launchdarkly/python-ai-sdk/commit/f0160c29f11b6b8965c07f209e09463414bca48a))
+* **claude-agents:** report a cancelled stream as cancelled, not abandoned ([d4f1b6f](https://github.com/launchdarkly/python-ai-sdk/commit/d4f1b6f76bf703e2bbfd24d4cfc007de0f9be4ba))
+* **claude-agents:** stop an empty tool list switching off the built-ins ([50e82fd](https://github.com/launchdarkly/python-ai-sdk/commit/50e82fd8903aa4fbd9c83697fa48f4ddb8c05d8d))
+
+
+### Documentation
+
+* describe the span tree the SDK now emits ([bc7815a](https://github.com/launchdarkly/python-ai-sdk/commit/bc7815a61e46c96df9cd786b20bfceb7d8b13334))
+* describe the span tree the SDK now emits ([#37](https://github.com/launchdarkly/python-ai-sdk/issues/37)) ([6a82ef5](https://github.com/launchdarkly/python-ai-sdk/commit/6a82ef5d1fdbae2b1228f9325d960979bcf50881))
+
 ## [0.1.4](https://github.com/launchdarkly/python-ai-sdk/compare/launchdarkly-ai-claude-agents-0.1.3...launchdarkly-ai-claude-agents-0.1.4) (2026-08-07)
 
 
diff --git a/packages/claude-agents/pyproject.toml b/packages/claude-agents/pyproject.toml
index 642f35f..77cfbdd 100644
--- a/packages/claude-agents/pyproject.toml
+++ b/packages/claude-agents/pyproject.toml
@@ -1,6 +1,6 @@
 [project]
 name = "launchdarkly-ai-claude-agents"
-version = "0.1.4"
+version = "0.2.0"
 requires-python = ">=3.12"
 dependencies = [
   "launchdarkly-ai-server",
diff --git a/packages/claude-agents/src/launchdarkly_ai_claude_agents/__init__.py b/packages/claude-agents/src/launchdarkly_ai_claude_agents/__init__.py
index 79eacb0..b5b8c3f 100644
--- a/packages/claude-agents/src/launchdarkly_ai_claude_agents/__init__.py
+++ b/packages/claude-agents/src/launchdarkly_ai_claude_agents/__init__.py
@@ -1,6 +1,6 @@
 """LaunchDarkly AI SDK - integration for Claude agents."""
 
-__version__ = "0.1.4"  # x-release-please-version
+__version__ = "0.2.0"  # x-release-please-version
 
 from . import native_graph  # noqa: F401
 from .builtins import (
diff --git a/packages/claude-messages/CHANGELOG.md b/packages/claude-messages/CHANGELOG.md
index 5f4b919..acaa441 100644
--- a/packages/claude-messages/CHANGELOG.md
+++ b/packages/claude-messages/CHANGELOG.md
@@ -1,5 +1,37 @@
 # Changelog
 
+## [0.2.0](https://github.com/launchdarkly/python-ai-sdk/compare/launchdarkly-ai-claude-messages-0.1.4...launchdarkly-ai-claude-messages-0.2.0) (2026-08-14)
+
+
+### ⚠ BREAKING CHANGES
+
+* **claude-messages:** the span this handler emits is renamed from `claude.messages` and `claude.messages.stream` to `invoke_agent`. Queries that select on the old names will not match. Prompt and completion content is no longer on spans unless the caller passes capture_content=True.
+
+### Features
+
+* **claude-messages:** emit invoke_agent, chat and execute_tool spans ([d4b5b6e](https://github.com/launchdarkly/python-ai-sdk/commit/d4b5b6eccb4714fd78384d78d8c1647c356d4c9c))
+
+
+### Bug Fixes
+
+* **claude-messages:** close the tool span a cancelled tool leaves open ([4f23cf4](https://github.com/launchdarkly/python-ai-sdk/commit/4f23cf439c449f33e13fce6b78681233f85f9ba2))
+* **claude-messages:** do not invent the cache figures Anthropic did not send ([db417b1](https://github.com/launchdarkly/python-ai-sdk/commit/db417b1ce2d47aef4ffa10f0bf2ac4056e2d008a))
+* **claude-messages:** fail the streaming chat span instead of abandoning it ([2f0e565](https://github.com/launchdarkly/python-ai-sdk/commit/2f0e565230c5130f0dc6206c634284ad146a74b3))
+* **claude-messages:** forward capture_content from the convenience wrapper ([b7531d3](https://github.com/launchdarkly/python-ai-sdk/commit/b7531d39ff3a60337c8a3552c34b9428bdfed573))
+* **claude-messages:** guard the streaming chat span's input write ([6e358dd](https://github.com/launchdarkly/python-ai-sdk/commit/6e358ddf7e5ac134737a590655ff6663063c7201))
+* **claude-messages:** keep every blocking chat-span write inside the guard ([21fb591](https://github.com/launchdarkly/python-ai-sdk/commit/21fb5918ee0508dd1dbc658c9fb212723e64ca81))
+* **claude-messages:** keep the spans of a cancelled run ([bb2e52f](https://github.com/launchdarkly/python-ai-sdk/commit/bb2e52f13f96d40d080ce51cf4025189bb83d3ac))
+* **claude-messages:** keep the streaming turn's billed tokens on a content failure ([1933374](https://github.com/launchdarkly/python-ai-sdk/commit/19333749371fd10551a76b2bae19f7aa1e4b6ccb))
+* **claude-messages:** put the input content write inside the guard too ([4aaa497](https://github.com/launchdarkly/python-ai-sdk/commit/4aaa497250db5c19c25ade189298418050347eae))
+* **claude-messages:** record a tool result inside the guard that ends its span ([19d932e](https://github.com/launchdarkly/python-ai-sdk/commit/19d932ebffeb23e2059a407b35a7acd9688a27a1))
+* **claude-messages:** report a cancelled stream as cancelled, not abandoned ([2d3379a](https://github.com/launchdarkly/python-ai-sdk/commit/2d3379ab2085b0dce53bda4a9f729bd50918b47d))
+
+
+### Documentation
+
+* describe the span tree the SDK now emits ([bc7815a](https://github.com/launchdarkly/python-ai-sdk/commit/bc7815a61e46c96df9cd786b20bfceb7d8b13334))
+* describe the span tree the SDK now emits ([#37](https://github.com/launchdarkly/python-ai-sdk/issues/37)) ([6a82ef5](https://github.com/launchdarkly/python-ai-sdk/commit/6a82ef5d1fdbae2b1228f9325d960979bcf50881))
+
 ## [0.1.4](https://github.com/launchdarkly/python-ai-sdk/compare/launchdarkly-ai-claude-messages-0.1.3...launchdarkly-ai-claude-messages-0.1.4) (2026-08-07)
 
 
diff --git a/packages/claude-messages/pyproject.toml b/packages/claude-messages/pyproject.toml
index 32f0fd7..1ed9dd5 100644
--- a/packages/claude-messages/pyproject.toml
+++ b/packages/claude-messages/pyproject.toml
@@ -1,6 +1,6 @@
 [project]
 name = "launchdarkly-ai-claude-messages"
-version = "0.1.4"
+version = "0.2.0"
 requires-python = ">=3.12"
 dependencies = [
   "launchdarkly-ai-server",
diff --git a/packages/claude-messages/src/launchdarkly_ai_claude_messages/__init__.py b/packages/claude-messages/src/launchdarkly_ai_claude_messages/__init__.py
index 0957214..ab5cfcb 100644
--- a/packages/claude-messages/src/launchdarkly_ai_claude_messages/__init__.py
+++ b/packages/claude-messages/src/launchdarkly_ai_claude_messages/__init__.py
@@ -1,6 +1,6 @@
 """LaunchDarkly AI SDK - integration for Claude messages."""
 
-__version__ = "0.1.4"  # x-release-please-version
+__version__ = "0.2.0"  # x-release-please-version
 
 from .handler import claude_messages, create_claude_messages_handler
 
diff --git a/packages/client/CHANGELOG.md b/packages/client/CHANGELOG.md
index 3dd419a..30c1a66 100644
--- a/packages/client/CHANGELOG.md
+++ b/packages/client/CHANGELOG.md
@@ -1,5 +1,36 @@
 # Changelog
 
+## [0.2.0](https://github.com/launchdarkly/python-ai-sdk/compare/launchdarkly-ai-server-0.1.3...launchdarkly-ai-server-0.2.0) (2026-08-14)
+
+
+### ⚠ BREAKING CHANGES
+
+* **client:** once the handlers move onto this layer, prompt and completion content will be absent from spans unless the caller passes capture_content=True. Anyone reading gen_ai.prompt.0.content today will need to opt in.
+
+### Features
+
+* **client:** cache-aware token accounting and a reusable span lifecycle ([f54ef59](https://github.com/launchdarkly/python-ai-sdk/commit/f54ef596c8d5c8dea5bdb555af49538e9da7b0cd))
+* **client:** end spans a cancelled run would otherwise strand ([dff27f6](https://github.com/launchdarkly/python-ai-sdk/commit/dff27f60915f6ea6fb24e0351c9eb5faec83ff27))
+* **client:** put conversation content on spans behind an opt-in flag ([2bb8310](https://github.com/launchdarkly/python-ai-sdk/commit/2bb8310bad322ebf9915c2214b8e7ca367d5878b))
+* **client:** tell a cancelled stream apart from an abandoned one ([14ed066](https://github.com/launchdarkly/python-ai-sdk/commit/14ed0668708bac31f110451cdf25d748e4076063))
+
+
+### Bug Fixes
+
+* **client:** a tool that returned nothing does not return null ([eb61eb2](https://github.com/launchdarkly/python-ai-sdk/commit/eb61eb2000d51fb8dd523eab6f7cfbaeafb1db99))
+* **client:** carry the cache breakdown into the public UsageDict ([c60fa7c](https://github.com/launchdarkly/python-ai-sdk/commit/c60fa7c6ade65542cbbbaefd440eca13e56088a4))
+* **client:** guard the fourth content writer, and assert the family rule ([d637b95](https://github.com/launchdarkly/python-ai-sdk/commit/d637b955290f0c9c671af62774018a8cb343e454))
+* **client:** keep the plain text a LangChain message holds in a list ([c11adca](https://github.com/launchdarkly/python-ai-sdk/commit/c11adca31cfe9a165441dca992496b10ab28a501))
+* **client:** make end_span_once a no-op on a None span ([a1772c1](https://github.com/launchdarkly/python-ai-sdk/commit/a1772c1a59c4f45e322d9805986ad494c2ef5bcc))
+* **client:** read a LangChain ChatMessage's own speaker ([d56103a](https://github.com/launchdarkly/python-ai-sdk/commit/d56103a615b7d6e4c93004209d257e3fe5771fa0))
+* **client:** read a LangChain message's role from the field, not only the method ([641f8e1](https://github.com/launchdarkly/python-ai-sdk/commit/641f8e194cfaf705e38cdd8820f4f9d90f8e1110))
+* **client:** stop the content carriers disagreeing, and stop them crashing ([b32d3fc](https://github.com/launchdarkly/python-ai-sdk/commit/b32d3fc7116abd35e9db090668962365c21fd932))
+
+
+### Documentation
+
+* describe the span tree the SDK now emits ([#37](https://github.com/launchdarkly/python-ai-sdk/issues/37)) ([6a82ef5](https://github.com/launchdarkly/python-ai-sdk/commit/6a82ef5d1fdbae2b1228f9325d960979bcf50881))
+
 ## [0.1.3](https://github.com/launchdarkly/python-ai-sdk/compare/launchdarkly-ai-server-0.1.2...launchdarkly-ai-server-0.1.3) (2026-08-07)
 
 
diff --git a/packages/client/pyproject.toml b/packages/client/pyproject.toml
index 9ea3ce7..92a1dd4 100644
--- a/packages/client/pyproject.toml
+++ b/packages/client/pyproject.toml
@@ -1,6 +1,6 @@
 [project]
 name = "launchdarkly-ai-server"
-version = "0.1.3"
+version = "0.2.0"
 requires-python = ">=3.12"
 dependencies = ["opentelemetry-api>=1.25"]
 description = "LaunchDarkly AI SDK core client for Python"
diff --git a/packages/client/src/launchdarkly_ai_server/__init__.py b/packages/client/src/launchdarkly_ai_server/__init__.py
index 73bfc3d..07397cf 100644
--- a/packages/client/src/launchdarkly_ai_server/__init__.py
+++ b/packages/client/src/launchdarkly_ai_server/__init__.py
@@ -1,6 +1,6 @@
 """LaunchDarkly AI SDK - core client for Python."""
 
-__version__ = "0.1.3"  # x-release-please-version
+__version__ = "0.2.0"  # x-release-please-version
 
 from .client import ConfigInstance, config
 from .content import (
diff --git a/packages/langchain-agents/CHANGELOG.md b/packages/langchain-agents/CHANGELOG.md
index 67dcb97..1cf0199 100644
--- a/packages/langchain-agents/CHANGELOG.md
+++ b/packages/langchain-agents/CHANGELOG.md
@@ -1,5 +1,38 @@
 # Changelog
 
+## [0.2.0](https://github.com/launchdarkly/python-ai-sdk/compare/launchdarkly-ai-langchain-agents-0.1.4...launchdarkly-ai-langchain-agents-0.2.0) (2026-08-14)
+
+
+### ⚠ BREAKING CHANGES
+
+* **langchain-agents:** the span this handler emits is renamed from `langchain.agent` and `langchain.agent.stream` to `invoke_agent`. Queries selecting on the old names will not match. Prompt and completion content is no longer on spans unless the caller passes capture_content=True. gen_ai.system changes value; see below.
+
+### Features
+
+* **langchain-agents:** emit invoke_agent, chat and execute_tool spans ([7683c9d](https://github.com/launchdarkly/python-ai-sdk/commit/7683c9df9cae4f9f4a7f2a5cdb0b3af07d322721))
+
+
+### Bug Fixes
+
+* **langchain-agents:** a callback that raises must not leave a span unreachable ([2169a05](https://github.com/launchdarkly/python-ai-sdk/commit/2169a05147511bc72e0f1ab81fa9f6fbeb65ad2a))
+* **langchain-agents:** a reported zero token count is not a missing one ([0d5e38c](https://github.com/launchdarkly/python-ai-sdk/commit/0d5e38c1d4ed44dbca0e2729d72314e6e4483647))
+* **langchain-agents:** an abandoned stream marks its open spans, it does not fail them ([d087d73](https://github.com/launchdarkly/python-ai-sdk/commit/d087d737382b6dd3660aa0a32ff36bb5a5be57f5))
+* **langchain-agents:** forward capture_content from the convenience wrapper ([06b210d](https://github.com/launchdarkly/python-ai-sdk/commit/06b210d0bab68e72b2734ea07c2a980af8b8c5e8))
+* **langchain-agents:** keep a turn's billed tokens when its content write fails ([485db67](https://github.com/launchdarkly/python-ai-sdk/commit/485db678ed9769a2f9750f0e2736040e15167218))
+* **langchain-agents:** keep the spans of a cancelled run ([ff53cc6](https://github.com/launchdarkly/python-ai-sdk/commit/ff53cc6d22c103ca524734839e7470ee5c6ee874))
+* **langchain-agents:** make a successful run's total agree with its own spans ([6333808](https://github.com/launchdarkly/python-ai-sdk/commit/6333808dea92c312643deceef2cabbf0a18d1c45))
+* **langchain-agents:** put the input content write inside the guard too ([0fa4ed1](https://github.com/launchdarkly/python-ai-sdk/commit/0fa4ed1c1a827315aa7f554cfea9279afde5d27c))
+* **langchain-agents:** record the root completion the way the chat span does ([1f4242b](https://github.com/launchdarkly/python-ai-sdk/commit/1f4242bf6baed11349466f4bce7df30e997d6558))
+* **langchain-agents:** report a cancelled stream as cancelled, not abandoned ([010a9ca](https://github.com/launchdarkly/python-ai-sdk/commit/010a9ca3f760b9cd8ed708a4e8be3e4a5142a7e5))
+* **langchain-agents:** total the streaming root from the callbacks when the messages report nothing ([6ff5a94](https://github.com/launchdarkly/python-ai-sdk/commit/6ff5a94586b889d205794abda60d44a646b5967f))
+* **langchain-agents:** track the chat span before writing content that can raise ([883da7b](https://github.com/launchdarkly/python-ai-sdk/commit/883da7b6ba09faf279a06d9e5d047b4cc8ec83a4))
+
+
+### Documentation
+
+* describe the span tree the SDK now emits ([bc7815a](https://github.com/launchdarkly/python-ai-sdk/commit/bc7815a61e46c96df9cd786b20bfceb7d8b13334))
+* describe the span tree the SDK now emits ([#37](https://github.com/launchdarkly/python-ai-sdk/issues/37)) ([6a82ef5](https://github.com/launchdarkly/python-ai-sdk/commit/6a82ef5d1fdbae2b1228f9325d960979bcf50881))
+
 ## [0.1.4](https://github.com/launchdarkly/python-ai-sdk/compare/launchdarkly-ai-langchain-agents-0.1.3...launchdarkly-ai-langchain-agents-0.1.4) (2026-08-07)
 
 
diff --git a/packages/langchain-agents/pyproject.toml b/packages/langchain-agents/pyproject.toml
index 1d73dc0..e0a08c9 100644
--- a/packages/langchain-agents/pyproject.toml
+++ b/packages/langchain-agents/pyproject.toml
@@ -1,6 +1,6 @@
 [project]
 name = "launchdarkly-ai-langchain-agents"
-version = "0.1.4"
+version = "0.2.0"
 requires-python = ">=3.12"
 dependencies = [
   "launchdarkly-ai-server",
diff --git a/packages/langchain-agents/src/launchdarkly_ai_langchain_agents/__init__.py b/packages/langchain-agents/src/launchdarkly_ai_langchain_agents/__init__.py
index ad26077..404f7d4 100644
--- a/packages/langchain-agents/src/launchdarkly_ai_langchain_agents/__init__.py
+++ b/packages/langchain-agents/src/launchdarkly_ai_langchain_agents/__init__.py
@@ -1,6 +1,6 @@
 """LaunchDarkly AI SDK - integration for LangChain agents."""
 
-__version__ = "0.1.4"  # x-release-please-version
+__version__ = "0.2.0"  # x-release-please-version
 
 from .graph import langchain_graph
 from .handler import create_langchain_agents_handler, langchain_agents
diff --git a/packages/langchain-messages/CHANGELOG.md b/packages/langchain-messages/CHANGELOG.md
index bceffc2..4290e51 100644
--- a/packages/langchain-messages/CHANGELOG.md
+++ b/packages/langchain-messages/CHANGELOG.md
@@ -1,5 +1,40 @@
 # Changelog
 
+## [0.2.0](https://github.com/launchdarkly/python-ai-sdk/compare/launchdarkly-ai-langchain-messages-0.1.4...launchdarkly-ai-langchain-messages-0.2.0) (2026-08-14)
+
+
+### ⚠ BREAKING CHANGES
+
+* **langchain-messages:** the span this handler emits is renamed from `langchain.invoke` and `langchain.stream` to `invoke_agent`. Queries selecting on the old names will not match. Prompt and completion content is no longer on spans unless the caller passes capture_content=True. gen_ai.system changes value; see below.
+
+### Features
+
+* **langchain-messages:** emit invoke_agent, chat and execute_tool spans ([51032b5](https://github.com/launchdarkly/python-ai-sdk/commit/51032b5f004d0977d4e38971822b38f28eb3c6b4))
+
+
+### Bug Fixes
+
+* **langchain-messages:** close the tool span a cancelled tool leaves open ([53c7f9a](https://github.com/launchdarkly/python-ai-sdk/commit/53c7f9a65006f06217e69830f2c7cf30a6e20eec))
+* **langchain-messages:** do not serialise the output nobody asked for ([0c9a5dd](https://github.com/launchdarkly/python-ai-sdk/commit/0c9a5ddba5b0bd2be4bae9bc36aa43351de7d225))
+* **langchain-messages:** fail the streaming chat span, and keep its tokens ([b084536](https://github.com/launchdarkly/python-ai-sdk/commit/b084536655b27799b957a595615b44bf9b4e2b5e))
+* **langchain-messages:** forward capture_content from the convenience wrapper ([79d8030](https://github.com/launchdarkly/python-ai-sdk/commit/79d8030b583f02ecb1e1d7a5d64cedbb266443be))
+* **langchain-messages:** guard the per-turn chat span's input write too ([2b901b4](https://github.com/launchdarkly/python-ai-sdk/commit/2b901b4349b34d276018d544a0b4c041ad23f4bb))
+* **langchain-messages:** guard the streaming root's output write ([178891a](https://github.com/launchdarkly/python-ai-sdk/commit/178891a337cf12abfdc7f931ff1615d10821b54d))
+* **langchain-messages:** keep every structured-turn write inside the guard ([de76f8b](https://github.com/launchdarkly/python-ai-sdk/commit/de76f8be4621abed38112a99fc3a2186a54bfffa))
+* **langchain-messages:** keep the spans of a cancelled run ([9c30fb3](https://github.com/launchdarkly/python-ai-sdk/commit/9c30fb377499f0f9218ec134c124e42e16118a19))
+* **langchain-messages:** one structured strategy, and don't report zeros as spend ([d7129d4](https://github.com/launchdarkly/python-ai-sdk/commit/d7129d44363a3ce2c41c2d3d0cd276ca8553538c))
+* **langchain-messages:** put the input content write inside the guard too ([a68fdff](https://github.com/launchdarkly/python-ai-sdk/commit/a68fdff9271565f9fa2dbc4bbb22691619588c5b))
+* **langchain-messages:** record a tool result inside the guard that ends its span ([72c7481](https://github.com/launchdarkly/python-ai-sdk/commit/72c7481d9fbde2d5bfc2f7dad7ce24593be12675))
+* **langchain-messages:** report a cancelled stream as cancelled, not abandoned ([9b8e10d](https://github.com/launchdarkly/python-ai-sdk/commit/9b8e10dafe6328505e5273ff16464dfd5e8141ab))
+* **langchain-messages:** two more ways a run misreported itself ([ad90d70](https://github.com/launchdarkly/python-ai-sdk/commit/ad90d709c36357ce4183503e074cba4269ead9d2))
+* **langchain-messages:** two ways a run could vanish from its own trace ([b8bdfaf](https://github.com/launchdarkly/python-ai-sdk/commit/b8bdfaf6813e33b4e7fc25c6b2930ffd1371458d))
+
+
+### Documentation
+
+* describe the span tree the SDK now emits ([bc7815a](https://github.com/launchdarkly/python-ai-sdk/commit/bc7815a61e46c96df9cd786b20bfceb7d8b13334))
+* describe the span tree the SDK now emits ([#37](https://github.com/launchdarkly/python-ai-sdk/issues/37)) ([6a82ef5](https://github.com/launchdarkly/python-ai-sdk/commit/6a82ef5d1fdbae2b1228f9325d960979bcf50881))
+
 ## [0.1.4](https://github.com/launchdarkly/python-ai-sdk/compare/launchdarkly-ai-langchain-messages-0.1.3...launchdarkly-ai-langchain-messages-0.1.4) (2026-08-07)
 
 
diff --git a/packages/langchain-messages/pyproject.toml b/packages/langchain-messages/pyproject.toml
index 78de489..77495e4 100644
--- a/packages/langchain-messages/pyproject.toml
+++ b/packages/langchain-messages/pyproject.toml
@@ -1,6 +1,6 @@
 [project]
 name = "launchdarkly-ai-langchain-messages"
-version = "0.1.4"
+version = "0.2.0"
 requires-python = ">=3.12"
 dependencies = [
   "launchdarkly-ai-server",
diff --git a/packages/langchain-messages/src/launchdarkly_ai_langchain_messages/__init__.py b/packages/langchain-messages/src/launchdarkly_ai_langchain_messages/__init__.py
index 0f66196..08dc246 100644
--- a/packages/langchain-messages/src/launchdarkly_ai_langchain_messages/__init__.py
+++ b/packages/langchain-messages/src/launchdarkly_ai_langchain_messages/__init__.py
@@ -1,6 +1,6 @@
 """LaunchDarkly AI SDK - integration for LangChain messages."""
 
-__version__ = "0.1.4"  # x-release-please-version
+__version__ = "0.2.0"  # x-release-please-version
 
 from .handler import create_langchain_messages_handler, langchain_messages
 
diff --git a/packages/openai-agents/CHANGELOG.md b/packages/openai-agents/CHANGELOG.md
index 9fb669b..81fbf72 100644
--- a/packages/openai-agents/CHANGELOG.md
+++ b/packages/openai-agents/CHANGELOG.md
@@ -1,5 +1,38 @@
 # Changelog
 
+## [0.2.0](https://github.com/launchdarkly/python-ai-sdk/compare/launchdarkly-ai-openai-agents-0.1.4...launchdarkly-ai-openai-agents-0.2.0) (2026-08-14)
+
+
+### ⚠ BREAKING CHANGES
+
+* **openai-agents:** the span this handler emits is renamed from `openai.agent.run` and `openai.agent.run.stream` to `invoke_agent`. Queries selecting on the old names will not match. Prompt and completion content is no longer on spans unless the caller passes capture_content=True.
+
+### Features
+
+* **openai-agents:** emit invoke_agent, chat and execute_tool spans ([c5331eb](https://github.com/launchdarkly/python-ai-sdk/commit/c5331eb7d251ceec09b3802ef8955c5af6a9c20b))
+
+
+### Bug Fixes
+
+* **openai-agents:** cancel the Runner even when there are no spans ([d9caaac](https://github.com/launchdarkly/python-ai-sdk/commit/d9caaac524cf9f3d26d989a43fcea241a22fd00e))
+* **openai-agents:** close the tool span when the SDK reports no call id ([1d66254](https://github.com/launchdarkly/python-ai-sdk/commit/1d66254e0435f1340cd34e88a41046b8b1ad9d83))
+* **openai-agents:** end the chat span the hook already stopped tracking ([9aecf05](https://github.com/launchdarkly/python-ai-sdk/commit/9aecf0575e27d573e0bc481ea1e7e0dedbe827e8))
+* **openai-agents:** forward capture_content from the convenience wrapper ([a2440e4](https://github.com/launchdarkly/python-ai-sdk/commit/a2440e45131997bfbe518ee7cff231b6b1f1c65d))
+* **openai-agents:** keep a tool span trackable when its content will not serialise ([32eb830](https://github.com/launchdarkly/python-ai-sdk/commit/32eb830899c464947e6dbd669806b7951402273d))
+* **openai-agents:** keep the spans of a cancelled run ([063a392](https://github.com/launchdarkly/python-ai-sdk/commit/063a39271ec979c5977e7a0022d903299cebc614))
+* **openai-agents:** put the input content write inside the guard too ([ead8ed5](https://github.com/launchdarkly/python-ai-sdk/commit/ead8ed586f3b71793249f24d1b9ba2197bae73ef))
+* **openai-agents:** report a cancelled stream as cancelled, not abandoned ([2b246d0](https://github.com/launchdarkly/python-ai-sdk/commit/2b246d0f7483f4e7f9d4fe06658cdc028afdeed7))
+* **openai-agents:** report tool arguments as an object, not a JSON string ([c646b6a](https://github.com/launchdarkly/python-ai-sdk/commit/c646b6a8a98831a2c64252886385a25473d8ec65))
+* **openai-agents:** stop double-counting a failed run's token spend ([8991dd5](https://github.com/launchdarkly/python-ai-sdk/commit/8991dd5233915f4e18e142d561a53174c7075c53))
+* **openai-agents:** stop tying token accounting to span creation ([0aa7241](https://github.com/launchdarkly/python-ai-sdk/commit/0aa72413907743d8e21c0f5616bd29b51ee1e789))
+* **openai-agents:** take the run total from the Runner, not from the hooks ([64cd458](https://github.com/launchdarkly/python-ai-sdk/commit/64cd4588a50c1333a3e9681c5ec34ea214b82f53))
+
+
+### Documentation
+
+* describe the span tree the SDK now emits ([bc7815a](https://github.com/launchdarkly/python-ai-sdk/commit/bc7815a61e46c96df9cd786b20bfceb7d8b13334))
+* describe the span tree the SDK now emits ([#37](https://github.com/launchdarkly/python-ai-sdk/issues/37)) ([6a82ef5](https://github.com/launchdarkly/python-ai-sdk/commit/6a82ef5d1fdbae2b1228f9325d960979bcf50881))
+
 ## [0.1.4](https://github.com/launchdarkly/python-ai-sdk/compare/launchdarkly-ai-openai-agents-0.1.3...launchdarkly-ai-openai-agents-0.1.4) (2026-08-07)
 
 
diff --git a/packages/openai-agents/pyproject.toml b/packages/openai-agents/pyproject.toml
index 377cc06..c4443db 100644
--- a/packages/openai-agents/pyproject.toml
+++ b/packages/openai-agents/pyproject.toml
@@ -1,6 +1,6 @@
 [project]
 name = "launchdarkly-ai-openai-agents"
-version = "0.1.4"
+version = "0.2.0"
 requires-python = ">=3.12"
 dependencies = [
   "launchdarkly-ai-server",
diff --git a/packages/openai-agents/src/launchdarkly_ai_openai_agents/__init__.py b/packages/openai-agents/src/launchdarkly_ai_openai_agents/__init__.py
index 167aea6..dd85cf8 100644
--- a/packages/openai-agents/src/launchdarkly_ai_openai_agents/__init__.py
+++ b/packages/openai-agents/src/launchdarkly_ai_openai_agents/__init__.py
@@ -1,6 +1,6 @@
 """LaunchDarkly AI SDK - integration for OpenAI agents."""
 
-__version__ = "0.1.4"  # x-release-please-version
+__version__ = "0.2.0"  # x-release-please-version
 
 from . import native_graph  # noqa: F401
 from .graph import openai_graph
diff --git a/packages/openai-messages/CHANGELOG.md b/packages/openai-messages/CHANGELOG.md
index 83bf2b1..e3cf327 100644
--- a/packages/openai-messages/CHANGELOG.md
+++ b/packages/openai-messages/CHANGELOG.md
@@ -1,5 +1,36 @@
 # Changelog
 
+## [0.2.0](https://github.com/launchdarkly/python-ai-sdk/compare/launchdarkly-ai-openai-messages-0.1.4...launchdarkly-ai-openai-messages-0.2.0) (2026-08-14)
+
+
+### ⚠ BREAKING CHANGES
+
+* **openai-messages:** the span this handler emits is renamed from `openai.response` and `openai.response.stream` to `invoke_agent`. Queries selecting on the old names will not match. Prompt and completion content is no longer on spans unless the caller passes capture_content=True.
+
+### Features
+
+* **openai-messages:** emit invoke_agent, chat and execute_tool spans ([17ad375](https://github.com/launchdarkly/python-ai-sdk/commit/17ad3751d8ef286826140c86116d1c978f3bf264))
+
+
+### Bug Fixes
+
+* **openai-messages:** close the tool span a cancelled tool leaves open ([35a254d](https://github.com/launchdarkly/python-ai-sdk/commit/35a254d0660a84c0eff606bd907efdc922635990))
+* **openai-messages:** drop output items that produced no content ([66bacd0](https://github.com/launchdarkly/python-ai-sdk/commit/66bacd06c0eaf0a0b13d39c55924b7266730e7ad))
+* **openai-messages:** fail the streaming chat span, and keep its tokens ([83f8684](https://github.com/launchdarkly/python-ai-sdk/commit/83f8684af2a01ab3111b9eea2cfc4aa6a3df5b26))
+* **openai-messages:** forward capture_content from the convenience wrapper ([495391f](https://github.com/launchdarkly/python-ai-sdk/commit/495391f2acd5752de3fe232162fc2b8936f6376f))
+* **openai-messages:** keep every chat-span write inside the guard that ends it ([a4fed91](https://github.com/launchdarkly/python-ai-sdk/commit/a4fed91da4c6d2239efef0f6c5ff8fedf0526c23))
+* **openai-messages:** keep the spans of a cancelled run ([c93a902](https://github.com/launchdarkly/python-ai-sdk/commit/c93a902a7d077adb50e561b5ebb01fd69b5335b2))
+* **openai-messages:** keep the tokens a turn already cost when its content fails ([8501379](https://github.com/launchdarkly/python-ai-sdk/commit/85013797c826d93247ac3dedc236d85f1f20321e))
+* **openai-messages:** record a tool result inside the guard that ends its span ([6b9813b](https://github.com/launchdarkly/python-ai-sdk/commit/6b9813bfee06cd647321ca8cafa4d665c0406efd))
+* **openai-messages:** report a cancelled stream as cancelled, not abandoned ([76c4cef](https://github.com/launchdarkly/python-ai-sdk/commit/76c4cefc7b6e476b91540b0e3397bdba2f384a23))
+* **openai-messages:** report tool arguments as an object, not a JSON string ([a6b9da9](https://github.com/launchdarkly/python-ai-sdk/commit/a6b9da9e0b268fa47d8c0b6dbf92de066ede3eaa))
+
+
+### Documentation
+
+* describe the span tree the SDK now emits ([bc7815a](https://github.com/launchdarkly/python-ai-sdk/commit/bc7815a61e46c96df9cd786b20bfceb7d8b13334))
+* describe the span tree the SDK now emits ([#37](https://github.com/launchdarkly/python-ai-sdk/issues/37)) ([6a82ef5](https://github.com/launchdarkly/python-ai-sdk/commit/6a82ef5d1fdbae2b1228f9325d960979bcf50881))
+
 ## [0.1.4](https://github.com/launchdarkly/python-ai-sdk/compare/launchdarkly-ai-openai-messages-0.1.3...launchdarkly-ai-openai-messages-0.1.4) (2026-08-07)
 
 
diff --git a/packages/openai-messages/pyproject.toml b/packages/openai-messages/pyproject.toml
index 3b5d742..57a8666 100644
--- a/packages/openai-messages/pyproject.toml
+++ b/packages/openai-messages/pyproject.toml
@@ -1,6 +1,6 @@
 [project]
 name = "launchdarkly-ai-openai-messages"
-version = "0.1.4"
+version = "0.2.0"
 requires-python = ">=3.12"
 dependencies = [
   "launchdarkly-ai-server",
diff --git a/packages/openai-messages/src/launchdarkly_ai_openai_messages/__init__.py b/packages/openai-messages/src/launchdarkly_ai_openai_messages/__init__.py
index df8776e..d74e515 100644
--- a/packages/openai-messages/src/launchdarkly_ai_openai_messages/__init__.py
+++ b/packages/openai-messages/src/launchdarkly_ai_openai_messages/__init__.py
@@ -1,6 +1,6 @@
 """LaunchDarkly AI SDK - integration for OpenAI messages."""
 
-__version__ = "0.1.4"  # x-release-please-version
+__version__ = "0.2.0"  # x-release-please-version
 
 from .handler import create_openai_messages_handler, openai_messages