[Feature]: OpenHands-managed provider fallback for Codex ACP conversations

Open
#6,964 1 comment 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

Nobody has claimed this yet.

Assessment

Difficulty
5/5
Estimated time
Over a week
Newbie friendliness
22/100
Issue type
Feature
Clarity
Mostly clear
Activity status
Active
Tech stack
python
Domain
ai, backend

Research direction

This is a design-level request: no file, class or test is named, and the reporter explicitly leaves the scope as "Unknown". Start by reading how Codex ACP conversations are configured and launched in the Agent Server, and where the existing native OpenHands LLM fallback is wired, to judge whether provider switching can be layered on without touching Codex itself. Done means the four acceptance criteria hold: opt-in bounded failover, an explicit report of the provider/model change, workspace preservation with a clear stop when continuity fails, and no credential leakage or tool-action replay. A maintainer should decide feasibility and shape before anyone starts coding.

Written by the indexing model from the issue text.

Description

priority:low
Is there an existing feature request for this?
  • I have searched existing issues and feature requests, and this is not a duplicate.
Problem or Use Case

Hi team! Would you consider adding opt-in provider fallback managed by OpenHands for Codex-backed ACP conversations?

My use case is a ChatGPT-backed Codex primary, with a separately authenticated Kimi Coding backup when the primary hits its quota or has a temporary outage. I'd like to keep Codex as the execution engine rather than switch to a different agent.

Kimi documents custom-provider support through Codex, so this is a request for a general orchestration capability, not a new provider-specific integration.

Desired Behavior

Let users configure a primary and backup provider/model, their credential references, and bounded failover conditions at the OpenHands layer, without requiring Codex itself to implement automatic failover.

The important part is a safe, visible handover. I'm not assuming native Codex session state can simply transfer between providers. If a fresh session or reconstructed context is needed, please make that clear and stop if safe continuation isn't possible.

Acceptance Criteria
  • Failover is opt-in, bounded, and triggered by configured conditions such as quota exhaustion or temporary provider failures.
  • Codex remains the execution engine, and the actual provider/model change is reported explicitly.
  • The workspace is preserved, with safe context recovery or a clear stop when continuity cannot be established.
  • Credentials remain protected, completed tool actions are not replayed, and permission or policy denials are not bypassed.
Alternatives Considered

Native OpenHands LLM fallback applies to a different inference path. openai/codex#32341 requests failover inside Codex; this request is for OpenHands-owned orchestration that can be considered independently.

Automatically routing work to competing providers may not align with OpenAI's commercial incentives, so they may be less interested in prioritising that request. An OpenHands-managed implementation would avoid that dependency and keep fallback decisions provider-neutral.

Priority / Severity

Medium - Would improve experience

Estimated Scope

Unknown - Not sure about the technical complexity

Feature Area
  • Agent API / Core functionality
  • Agent Server
  • Configuration / Settings
Additional Context

If there's already a supported way to do this for Codex ACP conversations, a pointer to its configuration and continuity guarantees would be very welcome. Thanks for taking a look!

Dominant language
Python
Stars
1.4k
Forks
797
Avg merge
1d 17h
Merged PRs (30d)
354

Getting set up

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from OpenHands/software-agent-sdk

All issues in OpenHands/software-agent-sdk

Similar issues

More Python issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.