codex - 💡(How to fix) Fix Declarative Dynamic Workflows foundation for Codex

What variant of Codex are you using?

CLI

What feature would you like to see?

Summary

I would like to propose an experimental foundation for declarative Dynamic Workflows in Codex.

I understand from docs/contributing.md that unsolicited PRs are not currently accepted, so I am opening this as a proposal first rather than requesting code review directly.

Prototype branch:

https://github.com/ErenAri/codex/tree/dynamic-workflows-pr4

Compare view:

https://github.com/openai/codex/compare/main...ErenAri:codex:dynamic-workflows-pr4

Motivation

Codex already has subagent and MultiAgentV2 infrastructure. A workflow layer could provide a typed foundation for repeatable, bounded, inspectable multi-agent orchestration without placing all intermediate orchestration state inside the main model context.

The goal is not to add a broad user-facing workflow runtime immediately. The goal is to establish a conservative foundation that can later support workflows safely.

Prototype scope

The prototype includes:

• a standalone codex-workflows crate
• TOML workflow manifest parsing and validation
• strict unknown-field rejection
• deterministic DAG validation and phase waves
• an in-memory workflow run store
• a mock workflow executor
• an async-compatible workflow scheduler/executor abstraction
• a private core-side MultiAgent workflow executor adapter
• a minimal CLI validation command:

codex workflows validate <path>

### Additional information

_No response_