[WIP] feat: add semantic convention support for anthropic sdk

[123liuziming]

Description

Please include a summary of the change and which issue is fixed. Please also include relevant motivation and context. List any dependencies that are required for this change.

Fixes # (issue)

Type of change

Please delete options that are not relevant.

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to not work as expected)
• This change requires a documentation update

How Has This Been Tested?

Please describe the tests that you ran to verify your changes. Provide instructions so we can reproduce. Please also list any relevant details for your test configuration

• Test A

Does This PR Require a Core Repo Change?

• Yes. - Link to PR:
• No.

Checklist:

See contributing.md for styleguide, changelog guidelines, and more.

• Followed the style guidelines of this project
• Changelogs have been updated
• Unit tests have been added
• Documentation has been updated

[CLAassistant]

Thank you for your submission! We really appreciate it. Like many open source projects, we ask that you all sign our Contributor License Agreement before we can accept your contribution.
0 out of 2 committers have signed the CLA.

❌ musi
❌ Copilot

---

musi seems not to be a GitHub user. You need a GitHub account to be able to sign the CLA. If you have already a GitHub account, please add the email address used for this commit to your account.
_{You have signed the CLA already but the status is still pending? Let us recheck it.}

[github-actions]

This PR has been automatically marked as stale because it has not had any activity for 14 days. It will be closed if no further activity occurs within 14 days of this comment.
If you're still working on this, please add a comment or push new commits.

[ralf0131]

Review by github-manager-bot

Summary

Adds a new instrumentation plugin for the Anthropic Python SDK (messages.create / AsyncMessages.create, including SSE streaming) following the OTel contrib pattern. Includes LICENSE, examples, and cassette-based tests covering basic/error/stop-reason/token-usage paths. Nice, clean structure overall.

Note: I see the PR is marked [WIP], so I've focused on design/architecture feedback rather than nitpicks — the findings below should hold even if individual lines change.

Findings

• [Warning] patch.py — AnthropicStreamWrapper and AsyncAnthropicStreamWrapper duplicate ~120 lines (_process_event, _cleanup, _ContentBlockAccumulator usage, and all state fields) almost verbatim. This is a real maintenance hazard: when a token-usage or content-block edge case is fixed in one, the other is easy to forget. Consider extracting a shared _StreamTelemetryMixin/base that both sync and async wrappers inherit, with only the __next__/__anext__ plumbing differing.
• [Info] Streaming span lifecycle: finalization (_cleanup → stop_llm/fail_llm) only runs via __next__ hitting StopIteration, __exit__, or explicit close(). If a caller partially consumes a stream and discards the iterator without using it as a context manager / calling close(), the LLM span is never ended (leak). There's no __del__ safety net. Worth at least documenting that streaming must be consumed in a with block, or adding a best-effort __del__.
• [Info] build_output_messages uses finish_reason=stop_reason or "error". If a stream completes normally but stop_reason wasn't captured by the time _cleanup runs, a successful response is labelled "error" — a false-positive error finish reason that would skew metrics. Consider distinguishing "absent" from "error".
• [Info] License header in patch.py is the full Apache header (good), but it's inconsistent with the sibling pydantic-ai / deepagents plugins which truncate to two lines. Aligning helps if a license-header lint is ever enabled.

Suggestions

Something like:

class _StreamTelemetryMixin:
    def _process_event(self, event): ...   # shared
    def _cleanup(self, error=None): ...    # shared

class AnthropicStreamWrapper(_StreamTelemetryMixin): ...
class AsyncAnthropicStreamWrapper(_StreamTelemetryMixin): ...

Cross-repo Note

No protocol/API shared with loongsuite-pilot; no cross-repo change needed.

---

Automated review by github-manager-bot

[ralf0131]

⚠️ Merge conflict detected

This PR has conflicts with the base branch and cannot be merged. Please rebase or merge the base branch into your branch and resolve the conflicts.

This is a one-time reminder. Feel free to @mention me for a re-review after conflicts are resolved.

---

Automated notification by github-manager-bot

[ralf0131]

CLA Not Signed

The Contributor License Agreement (CLA) check is currently pending on this PR (license/cla: Contributor License Agreement is not signed yet.). This PR cannot be merged until the CLA is signed.

@123liuziming please sign the CLA via the CLA assistant badge in the comment above, or visit https://cla-assistant.io/alibaba/loongsuite-python. Once signed, the license/cla status will turn green.

---

Automated check by github-manager-bot

[ralf0131]

Summary

This PR adds semantic convention support for the Anthropic SDK, aligning LoongSuite's instrumentation with upstream GenAI semantic conventions. The changes are comprehensive (30 files, 5400+ lines).

This PR cannot be approved/merged until the following issues are resolved:

1. CLA not signed — Please sign the Contributor License Agreement (see the CLA reminder comment above)
2. Merge conflicts — This PR has conflicts with the main branch that need to be resolved
3. [WIP] status — Once ready for final review, please remove the [WIP] tag

Please address these items and @mention me for a re-review.

---

Automated review by github-manager-bot

[ralf0131]

Summary

This PR adds semantic convention support for the Anthropic SDK, aligning LoongSuite instrumentation with upstream GenAI semantic conventions. The changes are comprehensive (30 files, 5400+ lines).

This PR cannot be approved/merged until the following issues are resolved:

1. CLA not signed — Please sign the Contributor License Agreement (see the CLA reminder comment above)
2. Merge conflicts — This PR has conflicts with the main branch that need to be resolved
3. [WIP] status — Once ready for final review, please remove the [WIP] tag

Please address these items and @mention me for a re-review.

---

Automated review by github-manager-bot

[ralf0131]

Summary

Adds Anthropic Python SDK semantic convention support for LoongSuite. This is a large implementation (5000+ lines, 30 files) covering the full instrumentation package for the Anthropic SDK, including message/tool-use span generation, token usage accounting, and streaming support.

This PR is marked as [WIP] and the contributor has not yet signed the CLA (see the CLA reminder comment above). Sharing initial observations:

Findings

• [Info] Comprehensive implementation covering the full Anthropic SDK surface area (messages, tool use, streaming).
• [Info] Follows the established LoongSuite instrumentation package structure — consistent with other packages.
• [Info] PR description still has the default template placeholders — consider filling in details before marking ready.
• [Info] ⚠️ CLA not signed — this PR cannot be merged until the contributor signs the CLA via cla-assistant.io.

Suggestions

• Fill in the PR description with test details and a summary of changes
• Sign the CLA to unblock merge when ready
• Consider adding a CHANGELOG entry

---

Automated review by github-manager-bot