feat(api): add agent environment suspension and expiration by jbeckwith-oai · Pull Request #4046 · openai/openai-python

jbeckwith-oai · 2026-10-09T19:47:33Z

Summary

Adds client support for agent environment suspension and expiration events.

Changes

Add suspended and expired agent session environment stream event types.
Add suspended and expired agent environment webhook event types.
Allow the new webhook event names in create, update, and test subscription parameters.
Preserve the existing ready and failed lifecycle variants.

Validation

163 focused sync/async lifecycle and signed-webhook tests passed in Pydantic v2 mode.
Ruff check and format passed.
Repository-wide mypy passed across 1,982 files.
Public import smoke checks and git diff --check passed.
Two consecutive independent adversarial-review rounds found no in-scope blockers.

Rollout

Public SDK promotion and backend activation remain separate steps.

Castiron-Internal-PR: openai/openai-python-internal#197 Castiron-Source-SHA: 5c4d19e0e1c30c8f245282a7819c6dfbff8597d7 Castiron-Public-Base-SHA: 1a90f1c

github-actions · 2026-10-09T19:48:45Z

Castiron custom code

Evaluated main: 1a90f1c3242307d4654924c3c088759e9655aaa3.

✅ No new custom-code files detected.

52 mixed files remain; 0 existing customizations changed; 4 generated baselines changed.

Compared 1a90f1c32423 → 40b7a6d4b64e. Generated baselines verified.

File	Result	Current custom patch
`api.md`	Generated baseline changed	+119 / −0
`src/openai/resources/webhooks/webhooks.py`	Generated baseline changed	+89 / −4
`src/openai/types/webhooks/init.py`	Generated baseline changed	+6 / −1
`src/openai/types/webhooks/unwrap_webhook_event.py`	Generated baseline changed	+2 / −2

48 existing customizations unchanged

scripts/castiron/custom_code_budget.py
scripts/castiron/custom_code_report.py
scripts/castiron/test_custom_code_budget.py
scripts/castiron/test_custom_code_github.py
scripts/castiron/test_custom_code_publication.py
scripts/castiron/test_custom_code_report.py
src/openai/init.py
src/openai/_client.py
src/openai/resources/audio/transcriptions.py
src/openai/resources/audio/translations.py
src/openai/resources/beta/agents/environments/files.py
src/openai/resources/beta/agents/sessions/artifacts.py
src/openai/resources/beta/agents/sessions/sessions.py
src/openai/resources/beta/beta.py
src/openai/resources/beta/responses/responses.py
src/openai/resources/beta/threads/runs/runs.py
src/openai/resources/beta/threads/threads.py
src/openai/resources/chat/completions/completions.py
src/openai/resources/embeddings.py
src/openai/resources/files.py
src/openai/resources/live/forks.py
src/openai/resources/live/live.py
src/openai/resources/live/sideband.py
src/openai/resources/realtime/api.md
src/openai/resources/realtime/realtime.py
src/openai/resources/responses/responses.py
src/openai/resources/uploads/uploads.py
src/openai/resources/vector_stores/file_batches.py
src/openai/resources/vector_stores/files.py
src/openai/resources/videos.py
src/openai/resources/webhooks/init.py
src/openai/types/beta/agent_session_message.py
src/openai/types/chat/init.py
src/openai/types/chat/chat_completion_message_tool_call.py
src/openai/types/fine_tuning/fine_tuning_job_integration.py
src/openai/types/realtime/conversation_item_input_audio_transcription_delta_event.py
src/openai/types/realtime/realtime_error_event.py
src/openai/types/responses/init.py
src/openai/types/responses/response.py
src/openai/types/responses/response_function_web_search.py

8 more in the full report.

A changed generated baseline means this report cannot reliably identify which handwritten lines changed.

Inspect the custom-code diff

Download the exact patch produced by this run (requires repository access):

gh run download 37984145052 --repo openai/openai-python \
  --name castiron-custom-code-37984145052-1 --dir /tmp/castiron-custom-code-37984145052-1
git apply --stat /tmp/castiron-custom-code-37984145052-1/custom-code.patch
cat /tmp/castiron-custom-code-37984145052-1/custom-code.patch

Or reproduce it from an SDK checkout containing the vendored reporter:

git fetch --no-tags origin 1a90f1c3242307d4654924c3c088759e9655aaa3 40b7a6d4b64eb3d8d653f3395b9051f4cd1a04c4
python3 scripts/castiron/custom_code_report.py report \
  --base 1a90f1c3242307d4654924c3c088759e9655aaa3 \
  --head 40b7a6d4b64eb3d8d653f3395b9051f4cd1a04c4 --fetch --require-head-hash --public \
  --out /tmp/castiron-custom-code-40b7a6d4b64e
cat /tmp/castiron-custom-code-40b7a6d4b64e/custom-code.patch

This is the current full custom patch for mixed files, not an attribution of only the handwritten lines changed by this PR.

Full report and patch

chatgpt-codex-connector · 2026-10-09T20:00:50Z

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review	Status	Commit	Review trigger
📝 Code Review	✅ Completed 2026-10-09T20:02:42.761481Z	`40b7a6d`	Draft marked ready
🔒 Security Review	✅ Completed 2026-10-09T20:02:55.795666Z	`40b7a6d`	Draft marked ready

ℹ️ About Codex in GitHub

Your team has set up Codex to 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" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

openai-sdks · 2026-10-09T20:01:44Z

OkTest Summary

✅ 236/236 SDK tests passed in 9.021s for Python SDK PR #4046.

Test results — 42 files

Test	Result	Time
`tests/chat-completions-complex-body.test.ts`	✅ Passed	260ms
`tests/chat-completions-create.test.ts`	✅ Passed	213ms
`tests/chat-completions-stream.test.ts`	✅ Passed	283ms
`tests/files-content-binary.test.ts`	✅ Passed	186ms
`tests/files-create-multipart.test.ts`	✅ Passed	251ms
`tests/files-list-pagination.test.ts`	✅ Passed	267ms
`tests/initialize-config.test.ts`	✅ Passed	165ms
`tests/instance-isolation.test.ts`	✅ Passed	196ms
`tests/models-list.test.ts`	✅ Passed	214ms
`tests/responses-background-lifecycle.test.ts`	✅ Passed	173ms
`tests/responses-body-method-errors.test.ts`	✅ Passed	303ms
`tests/responses-cancel-timeout.test.ts`	✅ Passed	222ms
`tests/responses-cancel.test.ts`	✅ Passed	201ms
`tests/responses-compact-retries.test.ts`	✅ Passed	325ms
`tests/responses-compact.test.ts`	✅ Passed	189ms
`tests/responses-create-advanced-stream.test.ts`	✅ Passed	166ms
`tests/responses-create-advanced.test.ts`	✅ Passed	219ms
`tests/responses-create-disconnect.test.ts`	✅ Passed	1.282s
`tests/responses-create-errors.test.ts`	✅ Passed	201ms
`tests/responses-create-malformed-api-responses.test.ts`	✅ Passed	190ms
`tests/responses-create-retries.test.ts`	✅ Passed	327ms
`tests/responses-create-stream-failures.test.ts`	✅ Passed	200ms
`tests/responses-create-stream-timeout.test.ts`	✅ Passed	236ms
`tests/responses-create-stream-wire.test.ts`	✅ Passed	2.062s
`tests/responses-create-stream.test.ts`	✅ Passed	115ms
`tests/responses-create-terminal-states.test.ts`	✅ Passed	213ms
`tests/responses-create-timeout.test.ts`	✅ Passed	211ms
`tests/responses-create.test.ts`	✅ Passed	656ms
`tests/responses-delete.test.ts`	✅ Passed	193ms
`tests/responses-input-items-errors.test.ts`	✅ Passed	560ms
`tests/responses-input-items-list.test.ts`	✅ Passed	350ms
`tests/responses-input-items-options.test.ts`	✅ Passed	324ms
`tests/responses-input-tokens-count-timeout.test.ts`	✅ Passed	276ms
`tests/responses-input-tokens-count.test.ts`	✅ Passed	188ms
`tests/responses-malformed-inputs.test.ts`	✅ Passed	1.053s
`tests/responses-not-found-errors.test.ts`	✅ Passed	233ms
`tests/responses-parse.test.ts`	✅ Passed	298ms
`tests/responses-retrieve-retries.test.ts`	✅ Passed	194ms
`tests/responses-retrieve.test.ts`	✅ Passed	224ms
`tests/responses-stored-method-errors.test.ts`	✅ Passed	421ms
`tests/retry-behavior.test.ts`	✅ Passed	3.02s
`tests/sdk-error-shape.test.ts`	✅ Passed	297ms

View OkTest run #37984086047

_{SDK merge (962d7a1bfbff) · head (40b7a6d4b64e) · base (1a90f1c32423) · OkTest (aae4f6a5102a)}

markstuart-oai

Approved at 40b7a6d4b64eb3d8d653f3395b9051f4cd1a04c4.

The suspended and expired variants are wired through session states, discriminated stream and webhook unions, exports, and sync/async subscription methods. The tests cover typed SSE events in strict and loose modes and signed webhook payloads. Signature verification remains ahead of parsing.

All current public CI checks pass. This was a source and hosted-CI review; I ran no repository tests or live backend calls. Backend activation remains a separate rollout step.

Automated Release PR --- ## [3.28.0](openai/openai-python@v3.27.0...v3.28.0) (2026-10-09) ### Features * **api:** add agent environment suspension and expiration ([openai#4046](openai#4046)) ([6aa25a9](openai@6aa25a9)) ### Chores * **deps:** bump astral-sh/setup-uv from 10.1.0 to 10.2.0 ([openai#4026](openai#4026)) ([8bfffd4](openai@8bfffd4)) * **deps:** bump CodeQL init and analyze to 4.38.2 ([openai#4025](openai#4025)) ([4f5e618](openai@4f5e618)) * **deps:** update PyJWT security constraint to 2.14.0 ([openai#3991](openai#3991)) ([aaed2a7](openai@aaed2a7)) --- This PR was generated with [Release Please](https://github.com/googleapis/release-please). See [documentation](https://github.com/googleapis/release-please#release-please). Co-authored-by: openai-sdks[bot] <284451331+openai-sdks[bot]@users.noreply.github.com>

feat(api): add agent environment suspension and expiration

40b7a6d

Castiron-Internal-PR: openai/openai-python-internal#197 Castiron-Source-SHA: 5c4d19e0e1c30c8f245282a7819c6dfbff8597d7 Castiron-Public-Base-SHA: 1a90f1c

jbeckwith-oai marked this pull request as ready for review October 9, 2026 20:00

jbeckwith-oai requested a review from a team as a code owner October 9, 2026 20:00

jbeckwith-oai enabled auto-merge October 9, 2026 20:00

dpiet-oai approved these changes Oct 9, 2026

View reviewed changes

jbeckwith-oai added this pull request to the merge queue Oct 9, 2026

markstuart-oai approved these changes Oct 9, 2026

View reviewed changes

Merged via the queue into main with commit 6aa25a9 Oct 9, 2026
30 checks passed

jbeckwith-oai deleted the castiron/promotions/pr-197 branch October 9, 2026 20:24

openai-sdks Bot mentioned this pull request Oct 9, 2026

release: 3.28.0 #4045

Merged

Navigation Menu

Repository navigation

feat(api): add agent environment suspension and expiration - #4046

feat(api): add agent environment suspension and expiration#4046
jbeckwith-oai merged 1 commit into
mainfrom
castiron/promotions/pr-197

jbeckwith-oai commented Oct 9, 2026 •

edited

Loading

Uh oh!

github-actions Bot commented Oct 9, 2026 •

edited

Loading

Uh oh!

chatgpt-codex-connector Bot commented Oct 9, 2026 •

edited

Loading

Uh oh!

openai-sdks Bot commented Oct 9, 2026 •

edited

Loading

Uh oh!

markstuart-oai left a comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Conversation

jbeckwith-oai commented Oct 9, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Changes

Validation

Rollout

Uh oh!

github-actions Bot commented Oct 9, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Castiron custom code

Uh oh!

chatgpt-codex-connector Bot commented Oct 9, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Codex Review Summary

Uh oh!

openai-sdks Bot commented Oct 9, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

OkTest Summary

Uh oh!

markstuart-oai left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

jbeckwith-oai commented Oct 9, 2026 •

edited

Loading

github-actions Bot commented Oct 9, 2026 •

edited

Loading

chatgpt-codex-connector Bot commented Oct 9, 2026 •

edited

Loading

openai-sdks Bot commented Oct 9, 2026 •

edited

Loading