Skip to content

[framework] chore: clarify Gateway framework and runner names - #153

Merged
yyDing1 merged 2 commits into
verl-project:mainfrom
zackcxb:refactor/gateway-framework-naming
Aug 26, 2026
Merged

[framework] chore: clarify Gateway framework and runner names#153
yyDing1 merged 2 commits into
verl-project:mainfrom
zackcxb:refactor/gateway-framework-naming

Conversation

@zackcxb

@zackcxb zackcxb commented Aug 25, 2026

Copy link
Copy Markdown
Collaborator

Summary

Rename the Gateway-backed framework and private orchestration helpers so names reflect Gateway/session ownership and do not imply OpenAI-only support. This is a naming-only cleanup; rollout, reward, protocol, and TransferQueue behavior are unchanged.

Changes

  • Rename OpenAICompatibleAgentFramework to GatewayAgentFramework and update the package export plus default dynamic FQN.
  • Rename private orchestration helpers to _run_batch_rollouts, _run_prompt_rollouts, _run_agent_episode_with_concurrency_limit, and _run_agent_episode.
  • Preserve runner_name: the configured agent_runners key is the documented runner name matched by external agent_name.
  • Keep AgentRunner, run_task, Task.run(), and Agent.run() unchanged; clarify the AgentRunner and framework docstrings.
  • Keep the approved naming design/implementation plan outside the repository under cxb_dev/docs/plans.
  • Audit recipes, examples, YAML, dynamic FQNs, and docs: they reference the stable AgentFrameworkRolloutAdapter, run_task, and runner configuration contracts, not the renamed private helpers or old framework class, so no recipe edits are required.

Compatibility and migration

The package export and default dynamic FQN now use:

uni_agent.framework.framework.GatewayAgentFramework

@codecov-commenter

Copy link
Copy Markdown

⚠️ Please install the 'codecov app svg image' to ensure uploads and comments are reliably processed by Codecov.

Codecov Report

❌ Patch coverage is 77.77778% with 4 lines in your changes missing coverage. Please review.

Files with missing lines Patch % Lines
uni_agent/framework/framework.py 66.66% 4 Missing ⚠️

📢 Thoughts on this report? Let us know!

@zackcxb zackcxb changed the title [framework] clarify Gateway framework and runner names [framework] chore: clarify Gateway framework and runner names Aug 26, 2026
@yyDing1
yyDing1 merged commit cb653b8 into verl-project:main Aug 26, 2026
5 of 6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants