[BOT ISSUE] OpenAI Chat Completions missing reasoning model and web search metadata parameters

Start with METADATA_FIELDS in lib/braintrust/contrib/openai/instrumentation/chat.rb and lib/braintrust/contrib/ruby_openai/instrumentation/chat.rb, then compare the existing pattern in instrumentation/responses.rb. Update the Chat Completions metadata coverage for the three named parameters and verify that reasoning and web-search configuration appear in span metadata without changing the existing token parser.

Summary

The OpenAI Chat Completions instrumentation in both the openai and ruby-openai integrations does not capture several parameters that are critical for reasoning models and web search, because the METADATA_FIELDS lists have not been updated for newer API additions. Users of reasoning models (o1, o3, o4-mini) and web-search-enabled completions get incomplete observability — these parameters are silently dropped from span metadata.

What is missing

The METADATA_FIELDS constant in both Chat Completions instrumentations currently includes:

METADATA_FIELDS = %i[
  model frequency_penalty logit_bias logprobs max_tokens n
  presence_penalty response_format seed service_tier stop
  stream stream_options temperature top_p top_logprobs
  tools tool_choice parallel_tool_calls user functions function_call
].freeze

The following parameters accepted by the upstream OpenAI Chat Completions API are not captured:

Inconsistency with Responses API

The Responses API instrumentation in this SDK already captures the reasoning parameter (which contains effort and other reasoning config). The Chat Completions API uses different parameter names (max_completion_tokens, reasoning_effort) for equivalent functionality, but these are not captured.

Braintrust docs status

not_found — The Braintrust docs at https://www.braintrust.dev/docs/instrument/wrap-providers do not mention max_completion_tokens, reasoning_effort, reasoning models, or web_search_options.

Upstream sources

• Official OpenAI Ruby SDK: https://github.com/openai/openai-ruby — OpenAI::Resources::Chat::Completions#create accepts max_completion_tokens, reasoning_effort, prediction, audio, and web_search_options parameters
• OpenAI Chat Completions API docs: https://platform.openai.com/docs/api-reference/chat/create — documents all parameters including reasoning and web search
• OpenAI reasoning models guide: https://platform.openai.com/docs/guides/reasoning — documents max_completion_tokens and reasoning_effort as the primary configuration parameters

Local repo files inspected

• lib/braintrust/contrib/openai/instrumentation/chat.rb (lines 27–32) — METADATA_FIELDS missing max_completion_tokens, reasoning_effort, web_search_options
• lib/braintrust/contrib/ruby_openai/instrumentation/chat.rb (lines 32–37) — same METADATA_FIELDS list, same omissions
• lib/braintrust/contrib/openai/instrumentation/responses.rb (lines 26–31) — Responses API already captures reasoning parameter, showing the pattern exists
• lib/braintrust/contrib/support/openai.rb (lines 14–68) — usage token parser already handles *_tokens_details including reasoning_tokens, so metrics capture reasoning token usage but metadata doesn't capture the reasoning configuration