feat(temporal): add temporal integrations auto instrumentation (#367)

Temporal is now available as a first-class integration via
braintrust.auto_instrument(), which patches Temporal client and worker
setup to install BraintrustPlugin automatically when temporalio is
installed.

New applications can enable Temporal tracing with:

```python
import braintrust

braintrust.auto_instrument()
```

For explicit setup without global auto-instrumentation, users can call
setup_temporal():

```python
from braintrust.integrations.temporal import setup_temporal

setup_temporal(project_name="my-project")
```

If an application manually constructs Temporal plugin lists, use
BraintrustPlugin directly:

```python
from braintrust.integrations.temporal import BraintrustPlugin

plugins = [BraintrustPlugin(), *existing_plugins]
```

Migration guide: replace old contrib imports with integrations imports
for new code:

```python
# Before
from braintrust.contrib.temporal import BraintrustPlugin, BraintrustInterceptor

# After
from braintrust.integrations.temporal import BraintrustPlugin, BraintrustInterceptor
```

Prefer braintrust.auto_instrument() for new applications. The
braintrust.contrib.temporal module remains as a deprecated compatibility
re-export for its previous public API: BraintrustPlugin and
BraintrustInterceptor.

---------

Co-authored-by: Nova (SFK) <nova@starfolk.ai>
Co-authored-by: Claude Opus 4.7 <noreply@anthropic.com>

Author: 3 people

README.md

@@ -72,6 +72,7 @@ BRAINTRUST_API_KEY=<YOUR_API_KEY> braintrust eval tutorial_eval.py
 | [Strands](py/src/braintrust/integrations/strands/) | Yes | `strands-agents>=1.20.0` |
 | [Agno](py/src/braintrust/integrations/agno/) | Yes | `agno>=2.1.0` |
 | [AgentScope](py/src/braintrust/integrations/agentscope/) | Yes | `agentscope>=1.0.0` |
+| [Temporal](py/src/braintrust/integrations/temporal/) | Yes | `temporalio>=1.19.0` |
 | [pytest plugin](py/src/braintrust/wrappers/pytest_plugin/README.md) | No | `pytest>=8` |
 
 ## Documentation

py/noxfile.py

@@ -452,7 +452,7 @@ def test_mistral(session, version):
 def test_temporal(session, version):
     _install_test_deps(session)
     _install_matrix_dep(session, "temporalio", version)
-    _run_tests(session, "braintrust/contrib/temporal")
+    _run_tests(session, f"{INTEGRATION_DIR}/temporal")
 
 
 PYTEST_VERSIONS = _get_matrix_versions("pytest-matrix")

py/pyproject.toml

@@ -55,6 +55,8 @@ otel = [
 performance = [
     "orjson; platform_python_implementation != 'PyPy'",
 ]
+# Deprecated: Temporal is now available via braintrust.auto_instrument();
+# keep this extra as a compatibility alias until a future major release.
 temporal = [
     "temporalio>=1.19.0; python_version>='3.10'",
 ]

py/src/braintrust/auto.py

@@ -27,6 +27,7 @@
     OpenRouterIntegration,
     PydanticAIIntegration,
     StrandsIntegration,
+    TemporalIntegration,
 )
 from braintrust.integrations.base import BaseIntegration
 
@@ -68,6 +69,7 @@ def auto_instrument(
     autogen: bool = True,
     crewai: bool = True,
     strands: bool = True,
+    temporal: bool = True,
 ) -> dict[str, bool]:
     """
     Auto-instrument supported AI/ML libraries for Braintrust tracing.
@@ -98,6 +100,7 @@ def auto_instrument(
         autogen: Enable AutoGen instrumentation (default: True)
         crewai: Enable CrewAI instrumentation (default: True)
         strands: Enable Strands Agents instrumentation (default: True)
+        temporal: Enable Temporal instrumentation (default: True)
 
     Returns:
         Dict mapping integration name to whether it was successfully instrumented.
@@ -183,6 +186,8 @@ def auto_instrument(
         results["crewai"] = _instrument_integration(CrewAIIntegration)
     if strands:
         results["strands"] = _instrument_integration(StrandsIntegration)
+    if temporal:
+        results["temporal"] = _instrument_integration(TemporalIntegration)
 
     return results