Default OpenAI and Anthropic instrumentation to new version=2

[alexmojaki]

Summary

• add numeric semantic-convention version 2 for OpenAI and Anthropic instrumentation
• freeze the current latest telemetry behavior as version 2 and normalize latest to it internally
• make version 2 the public and provider-internal default while retaining version 1 and dual emission
• document the migration path and update the logfire-api generated signature surface

Tests

• uv run pytest tests/otel_integrations/test_openai.py tests/otel_integrations/test_anthropic.py
• uv run pytest tests/test_docs.py::test_formatting
• repository-wide Ruff, Ruff format, and Pyright checks via pre-commit

[devin-ai-integration]

✅ Devin Review: No Issues Found

Devin Review analyzed this PR and found no bugs or issues to report.

[coderabbitai]

Note

Reviews paused

It looks like this branch is under active development. To avoid overwhelming you with review comments due to an influx of new commits, CodeRabbit has automatically paused this review. You can configure this behavior by changing the reviews.auto_review.auto_pause_after_reviewed_commits setting.

Use the following commands to manage reviews:

• @coderabbitai resume to resume automatic reviews.
• @coderabbitai review to trigger a single review.

Use the checkboxes below for quick actions:

• ▶️ Resume reviews
• 🔍 Trigger review

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Team

Run ID: bfa95f53-2eb0-4aa3-855a-14163cc363e3

📥 Commits

Reviewing files that changed from the base of the PR and between f795ab1 and e5785da.

📒 Files selected for processing (9)

• docs/integrations/llms/anthropic.md
• docs/integrations/llms/openai.md
• logfire-api/logfire_api/_internal/main.pyi
• logfire/_internal/integrations/llm_providers/anthropic.py
• logfire/_internal/integrations/llm_providers/openai.py
• logfire/_internal/integrations/llm_providers/semconv.py
• logfire/_internal/main.py
• tests/otel_integrations/test_anthropic.py
• tests/otel_integrations/test_openai.py

🔗 Linked repositories identified

CodeRabbit considers these linked repositories for cross-repo context during reviews:

• pydantic/logfire (manual)
• pydantic/pydantic-ai (manual)

Included review availability: Your plan provides up to 8 included reviews per hour; 1 remains after this review.

---

📝 Walkthrough

Walkthrough

OpenAI and Anthropic instrumentation now default to semantic convention version 2. Version latest normalizes to version 2. Version 1 remains available, including dual emission with version 2. Endpoint, streaming, and response attributes use normalized version selection. Public signatures and documentation reflect the new default. Tests cover defaults, endpoint attributes, streaming output, absent inputs, normalization, and agent-span suppression.

Merge Risk: ⚪ Minimal · up to e5785

OpenAI and Anthropic instrumentation now defaults to semantic-convention version 2 while retaining version 1 and dual emission. No material current-head merge-readiness risk remains.

🚥 Pre-merge checks | ✅ 4

✅ Passed checks (4 passed)

Check name	Status	Explanation
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Title check	✅ Passed	The title clearly and concisely describes the primary change: making semantic-convention version 2 the default for OpenAI and Anthropic instrumentation.
Description check	✅ Passed	The description accurately summarizes version 2 support, latest-version normalization, retained compatibility, documentation updates, and test coverage.

✨ Finishing Touches

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch codex/add-semconv-version-2

---

_{Comment @coderabbitai help to get the list of available commands.}

[cubic-dev-ai]

No issues found across 9 files

Confidence score: 5/5

• Automated review surfaced no issues in the provided summaries.
• No files require special attention.

_{Re-trigger cubic}

[alexmojaki]

Suggested change

	```python skip-run="true" skip-reason="migration configuration example"
	import logfire
	logfire.instrument_anthropic(version=[1, 2])
	```python
	import logfire
	logfire.configure()
	logfire.instrument_anthropic(version=[1, 2])

[alexmojaki]

(AI) Addressed in a6db4fb

[alexmojaki]

same for openai

[alexmojaki]

(AI) Addressed in 586dda5

[alexmojaki]

why are you still skipping running

[alexmojaki]

(AI) Addressed in e3f9c24

[alexmojaki]

revert to the previous naming to match the types

[alexmojaki]

(AI) Addressed in 1c4e2cb