From e41536944e7e89763c51d7780bd1c3f3b8957836 Mon Sep 17 00:00:00 2001
From: jif-oai <jif@openai.com>
Date: Mon, 16 Feb 2026 15:28:31 +0000
Subject: [PATCH] chore: rename collab feature flag key to multi_agent (#11918)

Summary
- rename the collab feature key to multi_agent while keeping the Feature
enum unchanged
- add legacy alias support so both "multi_agent" and "collab" map to the
same feature
- cover the alias behavior with a new unit test
---
 codex-rs/core/config.schema.json     | 6 ++++++
 codex-rs/core/src/features.rs        | 8 +++++++-
 codex-rs/core/src/features/legacy.rs | 4 ++++
 3 files changed, 17 insertions(+), 1 deletion(-)

diff --git a/codex-rs/core/config.schema.json b/codex-rs/core/config.schema.json
index 7a1c40a0a..c9da5c688 100644
--- a/codex-rs/core/config.schema.json
+++ b/codex-rs/core/config.schema.json
@@ -233,6 +233,9 @@
             "memory_tool": {
               "type": "boolean"
             },
+            "multi_agent": {
+              "type": "boolean"
+            },
             "personality": {
               "type": "boolean"
             },
@@ -1363,6 +1366,9 @@
         "memory_tool": {
           "type": "boolean"
         },
+        "multi_agent": {
+          "type": "boolean"
+        },
         "personality": {
           "type": "boolean"
         },
diff --git a/codex-rs/core/src/features.rs b/codex-rs/core/src/features.rs
index 33801c47c..00e38223b 100644
--- a/codex-rs/core/src/features.rs
+++ b/codex-rs/core/src/features.rs
@@ -552,7 +552,7 @@ pub const FEATURES: &[FeatureSpec] = &[
     },
     FeatureSpec {
         id: Feature::Collab,
-        key: "collab",
+        key: "multi_agent",
         stage: Stage::Experimental {
             name: "Sub-agents",
             menu_description: "Ask Codex to spawn multiple agents to parallelize the work and win in efficiency.",
@@ -738,4 +738,10 @@ mod tests {
         );
         assert_eq!(Feature::UseLinuxSandboxBwrap.default_enabled(), false);
     }
+
+    #[test]
+    fn collab_is_legacy_alias_for_multi_agent() {
+        assert_eq!(feature_for_key("multi_agent"), Some(Feature::Collab));
+        assert_eq!(feature_for_key("collab"), Some(Feature::Collab));
+    }
 }
diff --git a/codex-rs/core/src/features/legacy.rs b/codex-rs/core/src/features/legacy.rs
index 0c0f75714..41eab93bd 100644
--- a/codex-rs/core/src/features/legacy.rs
+++ b/codex-rs/core/src/features/legacy.rs
@@ -33,6 +33,10 @@ const ALIASES: &[Alias] = &[
         legacy_key: "web_search",
         feature: Feature::WebSearchRequest,
     },
+    Alias {
+        legacy_key: "collab",
+        feature: Feature::Collab,
+    },
 ];
 
 pub(crate) fn legacy_feature_keys() -> impl Iterator<Item = &'static str> {