fix: handle null text in output_text items#3454
Conversation
Guard against empty type args when using bare dict or list annotations (no type parameters, e.g. instead of ). Previously: - construct_type() raised ValueError on bare dict - construct_type() raised IndexError on bare list - _transform_recursive() raised IndexError on bare dict Now these cases gracefully return the data as-is, matching the behavior of parameterized types when the data already matches. Fixes openai#3338, openai#3341
…I responses Fixes openai#3179 The API can return null for the action field in web search calls (e.g., when the search is still in progress or the action hasn't been determined yet). This change makes the action field Optional[Action] with a default of None, matching the actual API behavior. This allows users to safely check action.type without getting an AttributeError when action is None.
When NO_PROXY or other proxy environment variables contain newline characters (common in Docker, .env files, or shell scripts), httpx's get_environment_proxies() only splits by comma and fails with InvalidURL. This fix adds sanitize_proxy_env_vars() that removes newlines from proxy environment variables before httpx reads them. Fixes openai#3303
The ActionSearchSource type only supported type='url' with a required url field, but the API returns specialized data sources (weather, sports, finance) with type='api', a name field, and url=None. Changes: - Add 'api' to the type Literal in both response and param types - Make url optional (absent when type='api') - Add optional name field for the data source identifier Fixes openai#2736
The error event check inside the `if sse.event.startswith("thread.")` block
was unreachable because "error" never starts with "thread.". This meant
error events from the SSE stream were silently ignored in the thread event
path, instead of raising an APIError.
Fix: Move error event handling to the top of the event loop, before the
thread.* check, so error events are always handled regardless of context.
Fixes openai#2796
When response.output is None (e.g., from Codex backend), parse_response() would crash with TypeError: 'NoneType' object is not iterable. This fix adds a defensive check to treat None output as an empty list, preventing the crash while maintaining backward compatibility. Fixes openai#3312, openai#3313, openai#3314, openai#3321
When the API returns output_text items with text: null, the SDK now handles them gracefully instead of raising TypeError. Changes: - output_text property skips null text values instead of appending None - parse_response sets parsed=None for null text items instead of crashing - parse_text handles text_format=None correctly Fixes openai#3063
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: 1a17d00276
ℹ️ About Codex in GitHub
Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".
| # we have to special case the Assistants `thread.` events since we won't have an "event" key in the data | ||
| if sse.event and sse.event.startswith("thread."): | ||
| # Handle error events first - these can occur outside of thread.* events | ||
| if sse.event == "error": |
There was a problem hiding this comment.
Preserve Assistants error payloads
When a beta Assistants stream emits its generated ErrorEvent, the SSE frame uses event: error with the ErrorObject fields (message, type, etc.) at the top level of the data, not nested under error. This new catch-all path therefore raises a generic APIError before the synthesized-event path can cast and deliver that ErrorEvent to AssistantEventHandler.on_event, so users of threads/runs streaming lose the actual server message and any custom error-event handling. Please either handle the top-level error-object shape here or let synthesized streams process those events as before.
Useful? React with 👍 / 👎.
Summary
When the Responses API returns
output_textitems withtext: null, the SDK currently crashes withTypeError. This fix adds null checks to handle this gracefully.Changes
response.py-output_textproperty: Now skipsnulltext values instead of appendingNoneto the texts list_parsing/_responses.py-parse_response: Setsparsed=Nonefor null text items instead of crashing when trying to parse_parsing/_responses.py-parse_text: Handlestext_format=Nonecorrectly (treats it as "don't parse")Reproduction
Tests
Added two new tests:
test_output_text_with_null_text: Verifiesoutput_textproperty handles null texttest_parse_response_with_null_text: Verifiesparse_responsehandles null text itemsFixes #3063