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

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

Merged
jbeckwith-oai merged 1 commit into
mainfrom
castiron/promotions/pr-197
Oct 9, 2026
Merged

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

Conversation

@jbeckwith-oai

@jbeckwith-oai jbeckwith-oai commented Oct 9, 2026 •
edited
Loading

Copy link
Copy Markdown
Contributor

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.

@jbeckwith-oai
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
@github-actions

github-actions Bot commented Oct 9, 2026 •
edited
Loading

Copy link
Copy Markdown
Contributor

@jbeckwith-oai
jbeckwith-oai marked this pull request as ready for review October 9, 2026 20:00
@jbeckwith-oai
jbeckwith-oai requested a review from a team as a code owner October 9, 2026 20:00
@chatgpt-codex-connector

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

Copy link
Copy Markdown

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

openai-sdks Bot commented Oct 9, 2026 •
edited
Loading

Copy link
Copy Markdown
Contributor

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)

@jbeckwith-oai
jbeckwith-oai added this pull request to the merge queue Oct 9, 2026
markstuart-oai
markstuart-oai approved these changes Oct 9, 2026
View reviewed changes

@markstuart-oai markstuart-oai left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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.

Merged via the queue into main with commit 6aa25a9 Oct 9, 2026
30 checks passed
@jbeckwith-oai
jbeckwith-oai deleted the castiron/promotions/pr-197 branch October 9, 2026 20:24
@openai-sdks openai-sdks Bot mentioned this pull request Oct 9, 2026
Merged
gh-actions-shared Bot pushed a commit to xf-qubit/openai-python that referenced this pull request Oct 9, 2026
@openai-sdks
release: 3.28.0 (openai#4045)
ef676db 
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>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@markstuart-oai markstuart-oai markstuart-oai approved these changes
@dpiet-oai dpiet-oai dpiet-oai approved these changes

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

3 participants

@jbeckwith-oai @markstuart-oai @dpiet-oai