getsentry / getsentry/sentry-javascript

Replace deprecated `gen_ai.response.tool_calls` with `gen_ai.output.messages`

Open
#22,839 1 comment 0 reactions 0 assignees View on GitHub
Task
Dominant language
TypeScript
Stars
8.7k
Forks
1.8k
Avg merge
1d 17h
Merged PRs (30d)
515

Description

`@sentry/conventions` deprecates `gen_ai.response.tool_calls` in favor of `gen_ai.output.messages`. `gen_ai.response.tool_calls` holds a stringified array of tool-call objects; `gen_ai.output.messages` expects a stringified array of structured message objects (`[{role, parts: [...], finish_reason}]`), which unifies response text and tool calls into a single message.

Entails building the structured message format from the tool calls and emitting it under the new attribute. Affects all AI integrations (OpenAI, Anthropic, Google GenAI, LangChain, LangGraph, Workers AI, and the shared streaming path). Should be done together with the `gen_ai.response.text` replacement, since both merge into the same `gen_ai.output.messages` attribute.

We can likely postpone this until after the major, if we do it at all, since there are still discussions about handling this in Relay.

References:

* [`gen_ai.response.tool_calls`]()
* [`gen_ai.output.messages`]()

Contributor guide

Open the contributing guide

Research direction

Start by reviewing the gen_ai.response.tool_calls and gen_ai.output.messages convention references, then trace the OpenAI, Anthropic, Google GenAI, LangChain, LangGraph, Workers AI, and shared streaming integrations. Coordinate this with the gen_ai.response.text replacement and resolve the noted Relay discussion first; done means tool calls are represented in the new structured output-messages attribute across the affected paths.

Written by the indexing model from the issue text.

Assessment

Tech stack
typescript
Domain
observability
Issue type
Refactor
Difficulty
4/5
Estimated time
3-5 days
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.