Remove deprecated methods from util-genai

[rads-1996]

Description

Fixes #246

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. List any relevant details for your test
configuration.

• Test suites have been run to ensure existing functionality does not break.

Checklist

See CONTRIBUTING.md
for the style guide, changelog guidance, and more.

• Followed the style guidelines of this project
• Changelog updated if the change requires an entry
• Unit tests added
• Documentation updated

[opentelemetry-pr-dashboard]

Pull request dashboard status

Merged · refreshed 2026-10-03 00:36 UTC

Status above doesn't look right?

• Anything look wrong? Report it with what you expected; it helps us improve the dashboard.

[Copilot]

Copilot review overview

🟡 Changes recommended

Deprecated API remnants, stale compatibility code, and a prohibited Pyright suppression remain unresolved.

Review effort: Balanced
Findings: 2 · 1

Open (3)

• Remove remaining deprecated ToolInvocation property · New
• Remove orphaned LLM lifecycle compatibility APIs · New
• Avoid type-ignore suppression for unused event helper · New

What changed in this PR

Removes deprecated util-genAI lifecycle APIs and updates affected tests and reviewer guidance.

Changes:

• Removes deprecated TelemetryHandler factories, lifecycle helpers, and utility functions.
• Migrates Anthropic and util tests to current factories.
• Updates changelog and repository instructions.

File	Description
.github/​instructions/​instrumentation.instructions.md	Updates handler construction guidance.
.github/​instructions/​util-genai.instructions.md	Updates invocation factory guidance.
util/​opentelemetry-util-genai/​.changelog/​823.removed	Records removed APIs.
util/​opentelemetry-util-genai/​src/​opentelemetry/​util/​genai/​handler.py	Removes deprecated handler APIs.
util/​opentelemetry-util-genai/​src/​opentelemetry/​util/​genai/​utils.py	Removes deprecated content helpers.
util/​opentelemetry-util-genai/​src/​opentelemetry/​util/​genai/​_inference_invocation.py	Adjusts the content-mode import.
util/​opentelemetry-util-genai/​tests/​test_utils.py	Removes legacy API tests.
util/​opentelemetry-util-genai/​tests/​test_toolcall.py	Uses the current tool factory.
util/​opentelemetry-util-genai/​tests/​test_handler_workflow.py	Renames workflow tests.
util/​opentelemetry-util-genai/​tests/​test_handler_metrics.py	Renames inference metric tests.
instrumentation/​opentelemetry-instrumentation-genai-anthropic/​tests/​test_async_wrappers.py	Migrates to handler.inference().

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

[Copilot]

Copilot review overview

🟢 Approval recommended

Deprecated APIs are removed consistently, remaining repository references are updated, and behavioral coverage is retained.

Review effort: Balanced
Findings: None

Resolved since last review (3)

• Remove orphaned LLM lifecycle compatibility APIs
• Remove remaining deprecated ToolInvocation property
• Avoid type-ignore suppression for unused event helper

[lmolkova]

Thank you! A small comment and we should be good to go

[lmolkova]

Removing get_telemetry_handler breaks released packages on import. langchain 1.0b0, 1.1b0, 1.1b1 and openai-agents 1.0b0, 1.1b0 import it at module level and accept any util below 2, so pip will pair them with the next util release.

Could we keep it, still deprecated, for the rest of 1.x? No released package from this repo uses the other removed APIs.

#841 adds a CI check that catches this kind of break.

[rads-1996]

Thanks for pointing this out. I have addressed the feedback.