build: widen openai floor to >=2.7

[linj-glitch]

In order to integrate into Gym, we need to widen the openai floor

What

Lowers the openai dependency floor from >=2.34.0 to >=2.7. The upper bound at the major version is unchanged, and the resolved version stays 2.34.0 — this only widens what consumers are allowed to bring.

Why

The floor was set to whatever version was current when the package metadata was written, not to a version the code needs. The same pattern shows in its neighbours: every floor equals its locked version (openai 2.34.0/2.34.0, pydantic 2.13.3/2.13.3, httpx 0.28.1/0.28.1).

It has a concrete downstream cost. NeMo Gym pins openai<=2.7.2, so adding nemo-switchyard to Gym is unsatisfiable today:

Because nemo-switchyard==0.1.0 depends on openai>=2.34.0,<3.0 and your
project depends on openai<=2.7.2, we can conclude that your project's
requirements are unsatisfiable.

That blocks the Gym <> Switchyard integration — Gym needs to launch the proxy for router evals and, later, to import Switchyard for schema mapping. Fixing it from Gym's side instead would mean migrating Gym's openai SDK across ~27 minor versions, touching ~10 core modules that import internal type paths (openai.types.responses.response_create_params, response_output_text_param, shared.chat_model, …). Relaxing an over-tight floor here is the cheaper and more accurate fix.

>=2.7 rather than lower is deliberate: it is the narrowest floor that overlaps Gym's ceiling, so the supported range grows no more than it has to.

Verification

Switchyard uses openai for request/response schema types plus the async client in lib/llm_client.py. Two checks:

1. Import surface — every openai symbol imported anywhere in switchyard/ resolves on 2.7.0, including openai.types.chat.chat_completion_message_function_tool_call, which was the one I expected to be version-gated. Zero missing modules or symbols.
2. Test suite — the Python suite at tag v0.1.0, run against the published nemo-switchyard[server]==0.1.0 wheel, is identical across every version tested:

openai	result
2.7.0	69 passed, 1 failed
2.7.1	69 passed, 1 failed
2.7.2	69 passed, 1 failed
2.34.0	69 passed, 1 failed
2.48.0	69 passed, 1 failed

The single failure is test_build_and_serve_registers_extra_endpoints, identical in all runs — an artifact of running the tests against the installed wheel rather than the source tree, not an openai regression. e2e, contract, getting_started and readme were excluded (network / docs deps).

For what it's worth the suite also passes on 2.0.0, 2.2.0 and 2.5.0, so 2.7 is a policy choice rather than a limit of the code. Happy to drop it further if reviewers prefer.

uv lock --check passes.

Follow-up

Once this ships in a release, adding nemo-switchyard to NeMo Gym becomes a one-line change scoped to the Switchyard model server package, rather than a change to Gym's core dependencies.

🤖 Generated with Claude Code

Summary by CodeRabbit

• Chores
  • Expanded compatibility to support a broader range of OpenAI library versions.
  • Added documentation clarifying the supported version range.

[github-actions]

PR Preview Action v1.8.1
🚀 View preview at https://NVIDIA-NeMo.github.io/Switchyard/pr-preview/pr-142/
Built to branch gh-pages at 2026-07-24 23:53 UTC. Preview will be ready when the GitHub Pages deployment is complete.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Enterprise

Run ID: 63a594f9-cd86-47b6-b0ba-4cbe243792a6

📥 Commits

Reviewing files that changed from the base of the PR and between 9a43930 and 4c62174.

⛔ Files ignored due to path filters (1)

• uv.lock is excluded by !**/*.lock, !uv.lock

📒 Files selected for processing (1)

• pyproject.toml

---

Walkthrough

The project’s OpenAI dependency floor changes from version 2.34.0 to 2.7, while the <3.0 upper bound remains unchanged. Inline comments document the supported compatibility range.

Changes

OpenAI Compatibility

Layer / File(s)	Summary
OpenAI dependency range pyproject.toml	The minimum OpenAI version is lowered to 2.7, the major-version cap remains below 3.0, and compatibility comments are added.

Estimated code review effort: 2 (Simple) | ~5 minutes

Poem

I’m a rabbit with a package to tune,
Lowering the floor beneath the moon.
Two point seven hops right in,
Three stays out with a guarded grin.
Comments bloom—what a tidy burrow!

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title clearly summarizes the main change: lowering the OpenAI dependency floor to 2.7.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

---

_{Comment @coderabbitai help to get the list of available commands.}