feat: annotate experimental fields in app server protocol

.github/codex/labels/codex-rust-review.md

@@ -15,10 +15,10 @@ Things to look out for when doing the review:
 
 ## Code Organization
 
-- Each crate in the Cargo workspace in `codex-rs` has a specific purpose: make a note if you believe new code is not introduced in the correct crate.
+- Each create in the Cargo workspace in `codex-rs` has a specific purpose: make a note if you believe new code is not introduced in the correct crate.
 - When possible, try to keep the `core` crate as small as possible. Non-core but shared logic is often a good candidate for `codex-rs/common`.
 - Be wary of large files and offer suggestions for how to break things into more reasonably-sized files.
-- Rust files should generally be organized such that the public parts of the API appear near the top of the file and helper functions go below. This is analogous to the "inverted pyramid" structure that is favored in journalism.
+- Rust files should generally be organized such that the public parts of the API appear near the top of the file and helper functions go below. This is analagous to the "inverted pyramid" structure that is favored in journalism.
 
 ## Assertions in Tests
 

.github/workflows/issue-labeler.yml

@@ -38,10 +38,9 @@ jobs:
             - If applicable, add one of the following labels to specify which sub-product or product surface the issue relates to.
             1. CLI — the Codex command line interface.
             2. extension — VS Code (or other IDE) extension-specific issues.
-            3. app - Issues related to the Codex desktop application.
-            4. codex-web — Issues targeting the Codex web UI/Cloud experience.
-            5. github-action — Issues with the Codex GitHub action.
-            6. iOS — Issues with the Codex iOS app.
+            3. codex-web — Issues targeting the Codex web UI/Cloud experience.
+            4. github-action — Issues with the Codex GitHub action.
+            5. iOS — Issues with the Codex iOS app.
 
             - Additionally add zero or more of the following labels that are relevant to the issue content. Prefer a small set of precise labels over many broad ones.
             1. windows-os — Bugs or friction specific to Windows environments (always when PowerShell is mentioned, path handling, copy/paste, OS-specific auth or tooling failures).

README.md

@@ -1,7 +1,7 @@
 <p align="center"><code>npm i -g @openai/codex</code><br />or <code>brew install --cask codex</code></p>
 <p align="center"><strong>Codex CLI</strong> is a coding agent from OpenAI that runs locally on your computer.
 <p align="center">
-  <img src="https://github.com/openai/codex/blob/main/.github/codex-cli-splash.png" alt="Codex CLI splash" width="80%" />
+  <img src="./.github/codex-cli-splash.png" alt="Codex CLI splash" width="80%" />
 </p>
 </br>
 If you want Codex in your code editor (VS Code, Cursor, Windsurf), <a href="https://developers.openai.com/codex/ide">install in your IDE.</a>

announcement_tip.toml

@@ -14,4 +14,4 @@ target_app = "cli"
 [[announcements]]
 content = "This is a test announcement"
 version_regex = "^0\\.0\\.0$"
-to_date = "2026-05-10"
+to_date = "2026-01-10"

codex-rs/Cargo.toml

@@ -5,13 +5,15 @@ members = [
     "async-utils",
     "app-server",
     "app-server-protocol",
+    "app-server-protocol-stable-export",
+    "app-server-json-schema",
+    "app-server-ts-types",
     "app-server-test-client",
     "debug-client",
     "apply-patch",
     "arg0",
     "feedback",
     "codex-backend-openapi-models",
-    "cloud-requirements",
     "cloud-tasks",
     "cloud-tasks-client",
     "cli",
@@ -43,14 +45,12 @@ members = [
     "utils/cache",
     "utils/image",
     "utils/json-to-toml",
-    "utils/home-dir",
     "utils/pty",
     "utils/readiness",
     "utils/string",
     "codex-client",
     "codex-api",
     "state",
-    "codex-experimental-api-macros",
 ]
 resolver = "2"
 
@@ -69,12 +69,13 @@ app_test_support = { path = "app-server/tests/common" }
 codex-ansi-escape = { path = "ansi-escape" }
 codex-api = { path = "codex-api" }
 codex-app-server = { path = "app-server" }
+codex-app-server-json-schema = { path = "app-server-json-schema" }
 codex-app-server-protocol = { path = "app-server-protocol" }
+codex-app-server-ts-types = { path = "app-server-ts-types" }
 codex-apply-patch = { path = "apply-patch" }
 codex-arg0 = { path = "arg0" }
 codex-async-utils = { path = "async-utils" }
 codex-backend-client = { path = "backend-client" }
-codex-cloud-requirements = { path = "cloud-requirements" }
 codex-chatgpt = { path = "chatgpt" }
 codex-cli = { path = "cli"}
 codex-client = { path = "codex-client" }
@@ -82,7 +83,6 @@ codex-common = { path = "common" }
 codex-core = { path = "core" }
 codex-exec = { path = "exec" }
 codex-execpolicy = { path = "execpolicy" }
-codex-experimental-api-macros = { path = "codex-experimental-api-macros" }
 codex-feedback = { path = "feedback" }
 codex-file-search = { path = "file-search" }
 codex-git = { path = "utils/git" }
@@ -105,7 +105,6 @@ codex-utils-cache = { path = "utils/cache" }
 codex-utils-cargo-bin = { path = "utils/cargo-bin" }
 codex-utils-image = { path = "utils/image" }
 codex-utils-json-to-toml = { path = "utils/json-to-toml" }
-codex-utils-home-dir = { path = "utils/home-dir" }
 codex-utils-pty = { path = "utils/pty" }
 codex-utils-readiness = { path = "utils/readiness" }
 codex-utils-string = { path = "utils/string" }
@@ -157,7 +156,6 @@ image = { version = "^0.25.9", default-features = false }
 include_dir = "0.7.4"
 indexmap = "2.12.0"
 insta = "1.46.0"
-inventory = "0.3.19"
 itertools = "0.14.0"
 keyring = { version = "3.6", default-features = false }
 landlock = "0.4.4"

codex-rs/app-server-json-schema/BUILD.bazel

@@ -0,0 +1,21 @@
+load("//:defs.bzl", "codex_rust_crate")
+
+stable_files = glob(
+    include = ["stable/**"],
+    allow_empty = True,
+    exclude = [
+        "**/* *",
+        "BUILD.bazel",
+        "Cargo.toml",
+    ],
+)
+
+codex_rust_crate(
+    name = "app-server-json-schema",
+    compile_data = stable_files,
+    crate_name = "codex_app_server_json_schema",
+    extra_binaries = [
+        "//codex-rs/app-server-protocol-stable-export:codex-app-server-protocol-stable-export",
+    ],
+    test_data_extra = stable_files,
+)

codex-rs/app-server-json-schema/Cargo.toml

@@ -0,0 +1,17 @@
+[package]
+name = "codex-app-server-json-schema"
+version.workspace = true
+edition.workspace = true
+license.workspace = true
+
+[lints]
+workspace = true
+
+[dependencies]
+include_dir = { workspace = true }
+
+[dev-dependencies]
+anyhow = { workspace = true }
+codex-utils-cargo-bin = { workspace = true }
+pretty_assertions = { workspace = true }
+tempfile = { workspace = true }

codex-rs/app-server-json-schema/src/lib.rs

@@ -0,0 +1,39 @@
+use std::ffi::OsStr;
+use std::fs;
+use std::io;
+use std::path::Path;
+
+static STABLE_APP_SERVER_JSON_SCHEMA_DIR: include_dir::Dir<'_> =
+    include_dir::include_dir!("$CARGO_MANIFEST_DIR/stable");
+
+/// Write the bundled stable JSON Schema artifacts to `out_dir`.
+pub fn write_stable_json_schema(out_dir: &Path) -> io::Result<()> {
+    fs::create_dir_all(out_dir)?;
+    write_dir_recursive(&STABLE_APP_SERVER_JSON_SCHEMA_DIR, out_dir, "json")
+}
+
+fn write_dir_recursive(
+    dir: &include_dir::Dir<'_>,
+    out_dir: &Path,
+    extension: &str,
+) -> io::Result<()> {
+    for file in dir.files() {
+        if file
+            .path()
+            .extension()
+            .is_some_and(|ext| ext == OsStr::new(extension))
+        {
+            let out_path = out_dir.join(file.path());
+            if let Some(parent) = out_path.parent() {
+                fs::create_dir_all(parent)?;
+            }
+            fs::write(out_path, file.contents())?;
+        }
+    }
+
+    for child in dir.dirs() {
+        write_dir_recursive(child, out_dir, extension)?;
+    }
+
+    Ok(())
+}

codex-rs/app-server-json-schema/stable/ClientRequest.json

@@ -9,10 +9,6 @@
       "properties": {
         "conversationId": {
           "$ref": "#/definitions/ThreadId"
-        },
-        "experimentalRawEvents": {
-          "default": false,
-          "type": "boolean"
         }
       },
       "required": [
@@ -160,22 +156,6 @@
       ],
       "type": "object"
     },
-    "CollaborationMode": {
-      "description": "Collaboration mode for a Codex session.",
-      "properties": {
-        "mode": {
-          "$ref": "#/definitions/ModeKind"
-        },
-        "settings": {
-          "$ref": "#/definitions/Settings"
-        }
-      },
-      "required": [
-        "mode",
-        "settings"
-      ],
-      "type": "object"
-    },
     "CommandExecParams": {
       "properties": {
         "command": {
@@ -674,29 +654,8 @@
       ],
       "type": "object"
     },
-    "InitializeCapabilities": {
-      "description": "Client-declared capabilities negotiated during initialize.",
-      "properties": {
-        "experimentalApi": {
-          "default": false,
-          "description": "Opt into receiving experimental API methods and fields.",
-          "type": "boolean"
-        }
-      },
-      "type": "object"
-    },
     "InitializeParams": {
       "properties": {
-        "capabilities": {
-          "anyOf": [
-            {
-              "$ref": "#/definitions/InitializeCapabilities"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        },
         "clientInfo": {
           "$ref": "#/definitions/ClientInfo"
         }
@@ -963,33 +922,6 @@
           ],
           "title": "ChatgptLoginAccountParams",
           "type": "object"
-        },
-        {
-          "description": "[UNSTABLE] FOR OPENAI INTERNAL USE ONLY - DO NOT USE. The access token must contain the same scopes that Codex-managed ChatGPT auth tokens have.",
-          "properties": {
-            "accessToken": {
-              "description": "Access token (JWT) supplied by the client. This token is used for backend API requests.",
-              "type": "string"
-            },
-            "idToken": {
-              "description": "ID token (JWT) supplied by the client.\n\nThis token is used for identity and account metadata (email, plan type, workspace id).",
-              "type": "string"
-            },
-            "type": {
-              "enum": [
-                "chatgptAuthTokens"
-              ],
-              "title": "ChatgptAuthTokensLoginAccountParamsType",
-              "type": "string"
-            }
-          },
-          "required": [
-            "accessToken",
-            "idToken",
-            "type"
-          ],
-          "title": "ChatgptAuthTokensLoginAccountParams",
-          "type": "object"
         }
       ]
     },
@@ -1038,14 +970,6 @@
       ],
       "type": "string"
     },
-    "ModeKind": {
-      "description": "Initial collaboration mode to use when the TUI starts.",
-      "enum": [
-        "plan",
-        "default"
-      ],
-      "type": "string"
-    },
     "ModelListParams": {
       "properties": {
         "cursor": {
@@ -2107,34 +2031,6 @@
       },
       "type": "object"
     },
-    "Settings": {
-      "description": "Settings for a collaboration mode.",
-      "properties": {
-        "developer_instructions": {
-          "type": [
-            "string",
-            "null"
-          ]
-        },
-        "model": {
-          "type": "string"
-        },
-        "reasoning_effort": {
-          "anyOf": [
-            {
-              "$ref": "#/definitions/ReasoningEffort"
-            },
-            {
-              "type": "null"
-            }
-          ]
-        }
-      },
-      "required": [
-        "model"
-      ],
-      "type": "object"
-    },
     "SkillsConfigWriteParams": {
       "properties": {
         "enabled": {
@@ -2251,13 +2147,6 @@
             "null"
           ]
         },
-        "path": {
-          "description": "[UNSTABLE] Specify the rollout path to fork from. If specified, the thread_id param will be ignored.",
-          "type": [
-            "string",
-            "null"
-          ]
-        },
         "sandbox": {
           "anyOf": [
             {
@@ -2414,16 +2303,6 @@
             "null"
           ]
         },
-        "history": {
-          "description": "[UNSTABLE] FOR CODEX CLOUD - DO NOT USE. If specified, the thread will be resumed with the provided history instead of loaded from disk.",
-          "items": {
-            "$ref": "#/definitions/ResponseItem"
-          },
-          "type": [
-            "array",
-            "null"
-          ]
-        },
         "model": {
           "description": "Configuration overrides for the resumed thread, if any.",
           "type": [
@@ -2437,13 +2316,6 @@
             "null"
           ]
         },
-        "path": {
-          "description": "[UNSTABLE] Specify the rollout path to resume from. If specified, the thread_id param will be ignored.",
-          "type": [
-            "string",
-            "null"
-          ]
-        },
         "personality": {
           "anyOf": [
             {
@@ -2491,21 +2363,6 @@
       ],
       "type": "object"
     },
-    "ThreadSetNameParams": {
-      "properties": {
-        "name": {
-          "type": "string"
-        },
-        "threadId": {
-          "type": "string"
-        }
-      },
-      "required": [
-        "name",
-        "threadId"
-      ],
-      "type": "object"
-    },
     "ThreadSortKey": {
       "enum": [
         "created_at",
@@ -2565,17 +2422,21 @@
             "null"
           ]
         },
+        "dynamicTools": {
+          "items": {
+            "$ref": "#/definitions/DynamicToolSpec"
+          },
+          "type": [
+            "array",
+            "null"
+          ]
+        },
         "ephemeral": {
           "type": [
             "boolean",
             "null"
           ]
         },
-        "experimentalRawEvents": {
-          "default": false,
-          "description": "If true, opt into emitting raw response items on the event stream.\n\nThis is for internal use only (e.g. Codex Cloud). (TODO): Figure out a better way to categorize internal / experimental events & protocols.",
-          "type": "boolean"
-        },
         "model": {
           "type": [
             "string",
@@ -2650,17 +2511,6 @@
           ],
           "description": "Override the approval policy for this turn and subsequent turns."
         },
-        "collaborationMode": {
-          "anyOf": [
-            {
-              "$ref": "#/definitions/CollaborationMode"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "description": "EXPERIMENTAL - set a pre-set collaboration mode. Takes precedence over model, reasoning_effort, and developer instructions if set."
-        },
         "cwd": {
           "description": "Override the working directory for this turn and subsequent turns.",
           "type": [
@@ -2906,15 +2756,6 @@
       "oneOf": [
         {
           "properties": {
-            "queries": {
-              "items": {
-                "type": "string"
-              },
-              "type": [
-                "array",
-                "null"
-              ]
-            },
             "query": {
               "type": [
                 "string",
@@ -3127,30 +2968,6 @@
       "title": "Thread/archiveRequest",
       "type": "object"
     },
-    {
-      "properties": {
-        "id": {
-          "$ref": "#/definitions/RequestId"
-        },
-        "method": {
-          "enum": [
-            "thread/name/set"
-          ],
-          "title": "Thread/name/setRequestMethod",
-          "type": "string"
-        },
-        "params": {
-          "$ref": "#/definitions/ThreadSetNameParams"
-        }
-      },
-      "required": [
-        "id",
-        "method",
-        "params"
-      ],
-      "title": "Thread/name/setRequest",
-      "type": "object"
-    },
     {
       "properties": {
         "id": {

codex-rs/app-server-json-schema/stable/EventMsg.json

@@ -680,14 +680,6 @@
         {
           "description": "Agent has started a turn. v1 wire format uses `task_started`; accept `turn_started` for v2 interop.",
           "properties": {
-            "collaboration_mode_kind": {
-              "allOf": [
-                {
-                  "$ref": "#/definitions/ModeKind"
-                }
-              ],
-              "default": "default"
-            },
             "model_context_window": {
               "format": "int64",
               "type": [
@@ -1049,14 +1041,12 @@
               "description": "How to sandbox commands executed in the system"
             },
             "session_id": {
-              "$ref": "#/definitions/ThreadId"
-            },
-            "thread_name": {
-              "description": "Optional user-facing thread name (may be unset).",
-              "type": [
-                "string",
-                "null"
-              ]
+              "allOf": [
+                {
+                  "$ref": "#/definitions/ThreadId"
+                }
+              ],
+              "description": "Name left as session_id instead of thread_id for backwards compatibility."
             },
             "type": {
               "enum": [
@@ -1080,33 +1070,6 @@
           "title": "SessionConfiguredEventMsg",
           "type": "object"
         },
-        {
-          "description": "Updated session metadata (e.g., thread name changes).",
-          "properties": {
-            "thread_id": {
-              "$ref": "#/definitions/ThreadId"
-            },
-            "thread_name": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "type": {
-              "enum": [
-                "thread_name_updated"
-              ],
-              "title": "ThreadNameUpdatedEventMsgType",
-              "type": "string"
-            }
-          },
-          "required": [
-            "thread_id",
-            "type"
-          ],
-          "title": "ThreadNameUpdatedEventMsg",
-          "type": "object"
-        },
         {
           "description": "Incremental MCP startup progress updates.",
           "properties": {
@@ -2168,7 +2131,6 @@
           "properties": {
             "explanation": {
               "default": null,
-              "description": "Arguments for the `update_plan` todo/checklist tool (not plan mode).",
               "type": [
                 "string",
                 "null"
@@ -2394,38 +2356,6 @@
           "title": "AgentMessageContentDeltaEventMsg",
           "type": "object"
         },
-        {
-          "properties": {
-            "delta": {
-              "type": "string"
-            },
-            "item_id": {
-              "type": "string"
-            },
-            "thread_id": {
-              "type": "string"
-            },
-            "turn_id": {
-              "type": "string"
-            },
-            "type": {
-              "enum": [
-                "plan_delta"
-              ],
-              "title": "PlanDeltaEventMsgType",
-              "type": "string"
-            }
-          },
-          "required": [
-            "delta",
-            "item_id",
-            "thread_id",
-            "turn_id",
-            "type"
-          ],
-          "title": "PlanDeltaEventMsg",
-          "type": "object"
-        },
         {
           "properties": {
             "delta": {
@@ -3276,14 +3206,6 @@
         }
       ]
     },
-    "ModeKind": {
-      "description": "Initial collaboration mode to use when the TUI starts.",
-      "enum": [
-        "plan",
-        "default"
-      ],
-      "type": "string"
-    },
     "NetworkAccess": {
       "description": "Represents whether outbound network access is available to the agent.",
       "enum": [
@@ -4990,30 +4912,6 @@
           "title": "AgentMessageTurnItem",
           "type": "object"
         },
-        {
-          "properties": {
-            "id": {
-              "type": "string"
-            },
-            "text": {
-              "type": "string"
-            },
-            "type": {
-              "enum": [
-                "Plan"
-              ],
-              "title": "PlanTurnItemType",
-              "type": "string"
-            }
-          },
-          "required": [
-            "id",
-            "text",
-            "type"
-          ],
-          "title": "PlanTurnItem",
-          "type": "object"
-        },
         {
           "properties": {
             "id": {
@@ -5227,15 +5125,6 @@
       "oneOf": [
         {
           "properties": {
-            "queries": {
-              "items": {
-                "type": "string"
-              },
-              "type": [
-                "array",
-                "null"
-              ]
-            },
             "query": {
               "type": [
                 "string",
@@ -5424,14 +5313,6 @@
     {
       "description": "Agent has started a turn. v1 wire format uses `task_started`; accept `turn_started` for v2 interop.",
       "properties": {
-        "collaboration_mode_kind": {
-          "allOf": [
-            {
-              "$ref": "#/definitions/ModeKind"
-            }
-          ],
-          "default": "default"
-        },
         "model_context_window": {
           "format": "int64",
           "type": [
@@ -5793,14 +5674,12 @@
           "description": "How to sandbox commands executed in the system"
         },
         "session_id": {
-          "$ref": "#/definitions/ThreadId"
-        },
-        "thread_name": {
-          "description": "Optional user-facing thread name (may be unset).",
-          "type": [
-            "string",
-            "null"
-          ]
+          "allOf": [
+            {
+              "$ref": "#/definitions/ThreadId"
+            }
+          ],
+          "description": "Name left as session_id instead of thread_id for backwards compatibility."
         },
         "type": {
           "enum": [
@@ -5824,33 +5703,6 @@
       "title": "SessionConfiguredEventMsg",
       "type": "object"
     },
-    {
-      "description": "Updated session metadata (e.g., thread name changes).",
-      "properties": {
-        "thread_id": {
-          "$ref": "#/definitions/ThreadId"
-        },
-        "thread_name": {
-          "type": [
-            "string",
-            "null"
-          ]
-        },
-        "type": {
-          "enum": [
-            "thread_name_updated"
-          ],
-          "title": "ThreadNameUpdatedEventMsgType",
-          "type": "string"
-        }
-      },
-      "required": [
-        "thread_id",
-        "type"
-      ],
-      "title": "ThreadNameUpdatedEventMsg",
-      "type": "object"
-    },
     {
       "description": "Incremental MCP startup progress updates.",
       "properties": {
@@ -6912,7 +6764,6 @@
       "properties": {
         "explanation": {
           "default": null,
-          "description": "Arguments for the `update_plan` todo/checklist tool (not plan mode).",
           "type": [
             "string",
             "null"
@@ -7138,38 +6989,6 @@
       "title": "AgentMessageContentDeltaEventMsg",
       "type": "object"
     },
-    {
-      "properties": {
-        "delta": {
-          "type": "string"
-        },
-        "item_id": {
-          "type": "string"
-        },
-        "thread_id": {
-          "type": "string"
-        },
-        "turn_id": {
-          "type": "string"
-        },
-        "type": {
-          "enum": [
-            "plan_delta"
-          ],
-          "title": "PlanDeltaEventMsgType",
-          "type": "string"
-        }
-      },
-      "required": [
-        "delta",
-        "item_id",
-        "thread_id",
-        "turn_id",
-        "type"
-      ],
-      "title": "PlanDeltaEventMsg",
-      "type": "object"
-    },
     {
       "properties": {
         "delta": {

codex-rs/app-server-json-schema/stable/FileChangeRequestApprovalParams.json

@@ -1,13 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
   "properties": {
-    "grantRoot": {
-      "description": "[UNSTABLE] When set, the agent is asking the user to allow writes under this root for the remainder of the session (unclear if this is honored today).",
-      "type": [
-        "string",
-        "null"
-      ]
-    },
     "itemId": {
       "type": "string"
     },

codex-rs/app-server-json-schema/stable/ServerNotification.json

@@ -257,7 +257,7 @@
       "type": "object"
     },
     "AuthMode": {
-      "description": "Authentication mode for OpenAI-backed providers.",
+      "description": "Authentication mode for OpenAI-backed providers.\n\nThis is used internally to determine the base URL for generating responses, and to gate ChatGPT-only behaviors like rate limits and available models (as opposed to API key-based auth).",
       "oneOf": [
         {
           "description": "OpenAI API key provided by the caller and stored by Codex.",
@@ -272,13 +272,6 @@
             "chatgpt"
           ],
           "type": "string"
-        },
-        {
-          "description": "[UNSTABLE] FOR OPENAI INTERNAL USE ONLY - DO NOT USE.\n\nChatGPT auth tokens are supplied by an external host app and are only stored in memory. Token refresh must be handled by the external host app.",
-          "enum": [
-            "chatgptAuthTokens"
-          ],
-          "type": "string"
         }
       ]
     },
@@ -1258,14 +1251,6 @@
         {
           "description": "Agent has started a turn. v1 wire format uses `task_started`; accept `turn_started` for v2 interop.",
           "properties": {
-            "collaboration_mode_kind": {
-              "allOf": [
-                {
-                  "$ref": "#/definitions/ModeKind"
-                }
-              ],
-              "default": "default"
-            },
             "model_context_window": {
               "format": "int64",
               "type": [
@@ -1627,14 +1612,12 @@
               "description": "How to sandbox commands executed in the system"
             },
             "session_id": {
-              "$ref": "#/definitions/ThreadId"
-            },
-            "thread_name": {
-              "description": "Optional user-facing thread name (may be unset).",
-              "type": [
-                "string",
-                "null"
-              ]
+              "allOf": [
+                {
+                  "$ref": "#/definitions/ThreadId"
+                }
+              ],
+              "description": "Name left as session_id instead of thread_id for backwards compatibility."
             },
             "type": {
               "enum": [
@@ -1658,33 +1641,6 @@
           "title": "SessionConfiguredEventMsg",
           "type": "object"
         },
-        {
-          "description": "Updated session metadata (e.g., thread name changes).",
-          "properties": {
-            "thread_id": {
-              "$ref": "#/definitions/ThreadId"
-            },
-            "thread_name": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "type": {
-              "enum": [
-                "thread_name_updated"
-              ],
-              "title": "ThreadNameUpdatedEventMsgType",
-              "type": "string"
-            }
-          },
-          "required": [
-            "thread_id",
-            "type"
-          ],
-          "title": "ThreadNameUpdatedEventMsg",
-          "type": "object"
-        },
         {
           "description": "Incremental MCP startup progress updates.",
           "properties": {
@@ -1840,7 +1796,7 @@
         {
           "properties": {
             "action": {
-              "$ref": "#/definitions/WebSearchAction2"
+              "$ref": "#/definitions/WebSearchAction"
             },
             "call_id": {
               "type": "string"
@@ -2746,7 +2702,6 @@
           "properties": {
             "explanation": {
               "default": null,
-              "description": "Arguments for the `update_plan` todo/checklist tool (not plan mode).",
               "type": [
                 "string",
                 "null"
@@ -2972,38 +2927,6 @@
           "title": "AgentMessageContentDeltaEventMsg",
           "type": "object"
         },
-        {
-          "properties": {
-            "delta": {
-              "type": "string"
-            },
-            "item_id": {
-              "type": "string"
-            },
-            "thread_id": {
-              "type": "string"
-            },
-            "turn_id": {
-              "type": "string"
-            },
-            "type": {
-              "enum": [
-                "plan_delta"
-              ],
-              "title": "PlanDeltaEventMsgType",
-              "type": "string"
-            }
-          },
-          "required": [
-            "delta",
-            "item_id",
-            "thread_id",
-            "turn_id",
-            "type"
-          ],
-          "title": "PlanDeltaEventMsg",
-          "type": "object"
-        },
         {
           "properties": {
             "delta": {
@@ -4057,14 +3980,6 @@
       ],
       "type": "string"
     },
-    "ModeKind": {
-      "description": "Initial collaboration mode to use when the TUI starts.",
-      "enum": [
-        "plan",
-        "default"
-      ],
-      "type": "string"
-    },
     "NetworkAccess": {
       "description": "Represents whether outbound network access is available to the agent.",
       "enum": [
@@ -4251,30 +4166,6 @@
         }
       ]
     },
-    "PlanDeltaNotification": {
-      "description": "EXPERIMENTAL - proposed plan streaming deltas for plan items. Clients should not assume concatenated deltas match the completed plan item content.",
-      "properties": {
-        "delta": {
-          "type": "string"
-        },
-        "itemId": {
-          "type": "string"
-        },
-        "threadId": {
-          "type": "string"
-        },
-        "turnId": {
-          "type": "string"
-        }
-      },
-      "required": [
-        "delta",
-        "itemId",
-        "threadId",
-        "turnId"
-      ],
-      "type": "object"
-    },
     "PlanItemArg": {
       "additionalProperties": false,
       "properties": {
@@ -5095,7 +4986,7 @@
             "action": {
               "anyOf": [
                 {
-                  "$ref": "#/definitions/WebSearchAction2"
+                  "$ref": "#/definitions/WebSearchAction"
                 },
                 {
                   "type": "null"
@@ -6033,13 +5924,6 @@
           "description": "Model provider used for this thread (for example, 'openai').",
           "type": "string"
         },
-        "path": {
-          "description": "[UNSTABLE] Path to the thread on disk.",
-          "type": [
-            "string",
-            "null"
-          ]
-        },
         "preview": {
           "description": "Usually the first user message in the thread, if available.",
           "type": "string"
@@ -6134,31 +6018,6 @@
           "title": "AgentMessageThreadItem",
           "type": "object"
         },
-        {
-          "description": "EXPERIMENTAL - proposed plan item content. The completed plan item is authoritative and may not match the concatenation of `PlanDelta` text.",
-          "properties": {
-            "id": {
-              "type": "string"
-            },
-            "text": {
-              "type": "string"
-            },
-            "type": {
-              "enum": [
-                "plan"
-              ],
-              "title": "PlanThreadItemType",
-              "type": "string"
-            }
-          },
-          "required": [
-            "id",
-            "text",
-            "type"
-          ],
-          "title": "PlanThreadItem",
-          "type": "object"
-        },
         {
           "properties": {
             "content": {
@@ -6427,16 +6286,6 @@
         },
         {
           "properties": {
-            "action": {
-              "anyOf": [
-                {
-                  "$ref": "#/definitions/WebSearchAction"
-                },
-                {
-                  "type": "null"
-                }
-              ]
-            },
             "id": {
               "type": "string"
             },
@@ -6553,23 +6402,6 @@
         }
       ]
     },
-    "ThreadNameUpdatedNotification": {
-      "properties": {
-        "threadId": {
-          "type": "string"
-        },
-        "threadName": {
-          "type": [
-            "string",
-            "null"
-          ]
-        }
-      },
-      "required": [
-        "threadId"
-      ],
-      "type": "object"
-    },
     "ThreadStartedNotification": {
       "properties": {
         "thread": {
@@ -6993,30 +6825,6 @@
           "title": "AgentMessageTurnItem",
           "type": "object"
         },
-        {
-          "properties": {
-            "id": {
-              "type": "string"
-            },
-            "text": {
-              "type": "string"
-            },
-            "type": {
-              "enum": [
-                "Plan"
-              ],
-              "title": "PlanTurnItemType",
-              "type": "string"
-            }
-          },
-          "required": [
-            "id",
-            "text",
-            "type"
-          ],
-          "title": "PlanTurnItem",
-          "type": "object"
-        },
         {
           "properties": {
             "id": {
@@ -7054,7 +6862,7 @@
         {
           "properties": {
             "action": {
-              "$ref": "#/definitions/WebSearchAction2"
+              "$ref": "#/definitions/WebSearchAction"
             },
             "id": {
               "type": "string"
@@ -7425,15 +7233,6 @@
       "oneOf": [
         {
           "properties": {
-            "queries": {
-              "items": {
-                "type": "string"
-              },
-              "type": [
-                "array",
-                "null"
-              ]
-            },
             "query": {
               "type": [
                 "string",
@@ -7458,7 +7257,7 @@
           "properties": {
             "type": {
               "enum": [
-                "openPage"
+                "open_page"
               ],
               "title": "OpenPageWebSearchActionType",
               "type": "string"
@@ -7486,7 +7285,7 @@
             },
             "type": {
               "enum": [
-                "findInPage"
+                "find_in_page"
               ],
               "title": "FindInPageWebSearchActionType",
               "type": "string"
@@ -7522,107 +7321,6 @@
         }
       ]
     },
-    "WebSearchAction2": {
-      "oneOf": [
-        {
-          "properties": {
-            "queries": {
-              "items": {
-                "type": "string"
-              },
-              "type": [
-                "array",
-                "null"
-              ]
-            },
-            "query": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "type": {
-              "enum": [
-                "search"
-              ],
-              "title": "SearchWebSearchAction2Type",
-              "type": "string"
-            }
-          },
-          "required": [
-            "type"
-          ],
-          "title": "SearchWebSearchAction2",
-          "type": "object"
-        },
-        {
-          "properties": {
-            "type": {
-              "enum": [
-                "open_page"
-              ],
-              "title": "OpenPageWebSearchAction2Type",
-              "type": "string"
-            },
-            "url": {
-              "type": [
-                "string",
-                "null"
-              ]
-            }
-          },
-          "required": [
-            "type"
-          ],
-          "title": "OpenPageWebSearchAction2",
-          "type": "object"
-        },
-        {
-          "properties": {
-            "pattern": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "type": {
-              "enum": [
-                "find_in_page"
-              ],
-              "title": "FindInPageWebSearchAction2Type",
-              "type": "string"
-            },
-            "url": {
-              "type": [
-                "string",
-                "null"
-              ]
-            }
-          },
-          "required": [
-            "type"
-          ],
-          "title": "FindInPageWebSearchAction2",
-          "type": "object"
-        },
-        {
-          "properties": {
-            "type": {
-              "enum": [
-                "other"
-              ],
-              "title": "OtherWebSearchAction2Type",
-              "type": "string"
-            }
-          },
-          "required": [
-            "type"
-          ],
-          "title": "OtherWebSearchAction2",
-          "type": "object"
-        }
-      ]
-    },
     "WindowsWorldWritableWarningNotification": {
       "properties": {
         "extraCount": {
@@ -7691,26 +7389,6 @@
       "title": "Thread/startedNotification",
       "type": "object"
     },
-    {
-      "properties": {
-        "method": {
-          "enum": [
-            "thread/name/updated"
-          ],
-          "title": "Thread/name/updatedNotificationMethod",
-          "type": "string"
-        },
-        "params": {
-          "$ref": "#/definitions/ThreadNameUpdatedNotification"
-        }
-      },
-      "required": [
-        "method",
-        "params"
-      ],
-      "title": "Thread/name/updatedNotification",
-      "type": "object"
-    },
     {
       "properties": {
         "method": {
@@ -7892,27 +7570,6 @@
       "title": "Item/agentMessage/deltaNotification",
       "type": "object"
     },
-    {
-      "description": "EXPERIMENTAL - proposed plan streaming deltas for plan items.",
-      "properties": {
-        "method": {
-          "enum": [
-            "item/plan/delta"
-          ],
-          "title": "Item/plan/deltaNotificationMethod",
-          "type": "string"
-        },
-        "params": {
-          "$ref": "#/definitions/PlanDeltaNotification"
-        }
-      },
-      "required": [
-        "method",
-        "params"
-      ],
-      "title": "Item/plan/deltaNotification",
-      "type": "object"
-    },
     {
       "properties": {
         "method": {

codex-rs/app-server-json-schema/stable/ServerRequest.json

@@ -38,35 +38,6 @@
       ],
       "type": "object"
     },
-    "ChatgptAuthTokensRefreshParams": {
-      "properties": {
-        "previousAccountId": {
-          "description": "Workspace/account identifier that Codex was previously using.\n\nClients that manage multiple accounts/workspaces can use this as a hint to refresh the token for the correct workspace.\n\nThis may be `null` when the prior ID token did not include a workspace identifier (`chatgpt_account_id`) or when the token could not be parsed.",
-          "type": [
-            "string",
-            "null"
-          ]
-        },
-        "reason": {
-          "$ref": "#/definitions/ChatgptAuthTokensRefreshReason"
-        }
-      },
-      "required": [
-        "reason"
-      ],
-      "type": "object"
-    },
-    "ChatgptAuthTokensRefreshReason": {
-      "oneOf": [
-        {
-          "description": "Codex attempted a backend request and received `401 Unauthorized`.",
-          "enum": [
-            "unauthorized"
-          ],
-          "type": "string"
-        }
-      ]
-    },
     "CommandAction": {
       "oneOf": [
         {
@@ -374,13 +345,6 @@
     },
     "FileChangeRequestApprovalParams": {
       "properties": {
-        "grantRoot": {
-          "description": "[UNSTABLE] When set, the agent is asking the user to allow writes under this root for the remainder of the session (unclear if this is honored today).",
-          "type": [
-            "string",
-            "null"
-          ]
-        },
         "itemId": {
           "type": "string"
         },
@@ -529,86 +493,6 @@
     },
     "ThreadId": {
       "type": "string"
-    },
-    "ToolRequestUserInputOption": {
-      "description": "EXPERIMENTAL. Defines a single selectable option for request_user_input.",
-      "properties": {
-        "description": {
-          "type": "string"
-        },
-        "label": {
-          "type": "string"
-        }
-      },
-      "required": [
-        "description",
-        "label"
-      ],
-      "type": "object"
-    },
-    "ToolRequestUserInputParams": {
-      "description": "EXPERIMENTAL. Params sent with a request_user_input event.",
-      "properties": {
-        "itemId": {
-          "type": "string"
-        },
-        "questions": {
-          "items": {
-            "$ref": "#/definitions/ToolRequestUserInputQuestion"
-          },
-          "type": "array"
-        },
-        "threadId": {
-          "type": "string"
-        },
-        "turnId": {
-          "type": "string"
-        }
-      },
-      "required": [
-        "itemId",
-        "questions",
-        "threadId",
-        "turnId"
-      ],
-      "type": "object"
-    },
-    "ToolRequestUserInputQuestion": {
-      "description": "EXPERIMENTAL. Represents one request_user_input question and its required options.",
-      "properties": {
-        "header": {
-          "type": "string"
-        },
-        "id": {
-          "type": "string"
-        },
-        "isOther": {
-          "default": false,
-          "type": "boolean"
-        },
-        "isSecret": {
-          "default": false,
-          "type": "boolean"
-        },
-        "options": {
-          "items": {
-            "$ref": "#/definitions/ToolRequestUserInputOption"
-          },
-          "type": [
-            "array",
-            "null"
-          ]
-        },
-        "question": {
-          "type": "string"
-        }
-      },
-      "required": [
-        "header",
-        "id",
-        "question"
-      ],
-      "type": "object"
     }
   },
   "description": "Request initiated from the server and sent to the client.",
@@ -663,31 +547,6 @@
       "title": "Item/fileChange/requestApprovalRequest",
       "type": "object"
     },
-    {
-      "description": "EXPERIMENTAL - Request input from the user for a tool call.",
-      "properties": {
-        "id": {
-          "$ref": "#/definitions/RequestId"
-        },
-        "method": {
-          "enum": [
-            "item/tool/requestUserInput"
-          ],
-          "title": "Item/tool/requestUserInputRequestMethod",
-          "type": "string"
-        },
-        "params": {
-          "$ref": "#/definitions/ToolRequestUserInputParams"
-        }
-      },
-      "required": [
-        "id",
-        "method",
-        "params"
-      ],
-      "title": "Item/tool/requestUserInputRequest",
-      "type": "object"
-    },
     {
       "description": "Execute a dynamic tool call on the client.",
       "properties": {
@@ -713,30 +572,6 @@
       "title": "Item/tool/callRequest",
       "type": "object"
     },
-    {
-      "properties": {
-        "id": {
-          "$ref": "#/definitions/RequestId"
-        },
-        "method": {
-          "enum": [
-            "account/chatgptAuthTokens/refresh"
-          ],
-          "title": "Account/chatgptAuthTokens/refreshRequestMethod",
-          "type": "string"
-        },
-        "params": {
-          "$ref": "#/definitions/ChatgptAuthTokensRefreshParams"
-        }
-      },
-      "required": [
-        "id",
-        "method",
-        "params"
-      ],
-      "title": "Account/chatgptAuthTokens/refreshRequest",
-      "type": "object"
-    },
     {
       "description": "DEPRECATED APIs below Request to approve a patch. This request is used for Turns started via the legacy APIs (i.e. SendUserTurn, SendUserMessage).",
       "properties": {

codex-rs/app-server-json-schema/stable/v1/AddConversationListenerParams.json

@@ -8,10 +8,6 @@
   "properties": {
     "conversationId": {
       "$ref": "#/definitions/ThreadId"
-    },
-    "experimentalRawEvents": {
-      "default": false,
-      "type": "boolean"
     }
   },
   "required": [

codex-rs/app-server-json-schema/stable/v1/AuthStatusChangeNotification.json

@@ -2,7 +2,7 @@
   "$schema": "http://json-schema.org/draft-07/schema#",
   "definitions": {
     "AuthMode": {
-      "description": "Authentication mode for OpenAI-backed providers.",
+      "description": "Authentication mode for OpenAI-backed providers.\n\nThis is used internally to determine the base URL for generating responses, and to gate ChatGPT-only behaviors like rate limits and available models (as opposed to API key-based auth).",
       "oneOf": [
         {
           "description": "OpenAI API key provided by the caller and stored by Codex.",
@@ -17,13 +17,6 @@
             "chatgpt"
           ],
           "type": "string"
-        },
-        {
-          "description": "[UNSTABLE] FOR OPENAI INTERNAL USE ONLY - DO NOT USE.\n\nChatGPT auth tokens are supplied by an external host app and are only stored in memory. Token refresh must be handled by the external host app.",
-          "enum": [
-            "chatgptAuthTokens"
-          ],
-          "type": "string"
         }
       ]
     }

codex-rs/app-server-json-schema/stable/v1/ForkConversationResponse.json

@@ -680,14 +680,6 @@
         {
           "description": "Agent has started a turn. v1 wire format uses `task_started`; accept `turn_started` for v2 interop.",
           "properties": {
-            "collaboration_mode_kind": {
-              "allOf": [
-                {
-                  "$ref": "#/definitions/ModeKind"
-                }
-              ],
-              "default": "default"
-            },
             "model_context_window": {
               "format": "int64",
               "type": [
@@ -1049,14 +1041,12 @@
               "description": "How to sandbox commands executed in the system"
             },
             "session_id": {
-              "$ref": "#/definitions/ThreadId"
-            },
-            "thread_name": {
-              "description": "Optional user-facing thread name (may be unset).",
-              "type": [
-                "string",
-                "null"
-              ]
+              "allOf": [
+                {
+                  "$ref": "#/definitions/ThreadId"
+                }
+              ],
+              "description": "Name left as session_id instead of thread_id for backwards compatibility."
             },
             "type": {
               "enum": [
@@ -1080,33 +1070,6 @@
           "title": "SessionConfiguredEventMsg",
           "type": "object"
         },
-        {
-          "description": "Updated session metadata (e.g., thread name changes).",
-          "properties": {
-            "thread_id": {
-              "$ref": "#/definitions/ThreadId"
-            },
-            "thread_name": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "type": {
-              "enum": [
-                "thread_name_updated"
-              ],
-              "title": "ThreadNameUpdatedEventMsgType",
-              "type": "string"
-            }
-          },
-          "required": [
-            "thread_id",
-            "type"
-          ],
-          "title": "ThreadNameUpdatedEventMsg",
-          "type": "object"
-        },
         {
           "description": "Incremental MCP startup progress updates.",
           "properties": {
@@ -2168,7 +2131,6 @@
           "properties": {
             "explanation": {
               "default": null,
-              "description": "Arguments for the `update_plan` todo/checklist tool (not plan mode).",
               "type": [
                 "string",
                 "null"
@@ -2394,38 +2356,6 @@
           "title": "AgentMessageContentDeltaEventMsg",
           "type": "object"
         },
-        {
-          "properties": {
-            "delta": {
-              "type": "string"
-            },
-            "item_id": {
-              "type": "string"
-            },
-            "thread_id": {
-              "type": "string"
-            },
-            "turn_id": {
-              "type": "string"
-            },
-            "type": {
-              "enum": [
-                "plan_delta"
-              ],
-              "title": "PlanDeltaEventMsgType",
-              "type": "string"
-            }
-          },
-          "required": [
-            "delta",
-            "item_id",
-            "thread_id",
-            "turn_id",
-            "type"
-          ],
-          "title": "PlanDeltaEventMsg",
-          "type": "object"
-        },
         {
           "properties": {
             "delta": {
@@ -3276,14 +3206,6 @@
         }
       ]
     },
-    "ModeKind": {
-      "description": "Initial collaboration mode to use when the TUI starts.",
-      "enum": [
-        "plan",
-        "default"
-      ],
-      "type": "string"
-    },
     "NetworkAccess": {
       "description": "Represents whether outbound network access is available to the agent.",
       "enum": [
@@ -4990,30 +4912,6 @@
           "title": "AgentMessageTurnItem",
           "type": "object"
         },
-        {
-          "properties": {
-            "id": {
-              "type": "string"
-            },
-            "text": {
-              "type": "string"
-            },
-            "type": {
-              "enum": [
-                "Plan"
-              ],
-              "title": "PlanTurnItemType",
-              "type": "string"
-            }
-          },
-          "required": [
-            "id",
-            "text",
-            "type"
-          ],
-          "title": "PlanTurnItem",
-          "type": "object"
-        },
         {
           "properties": {
             "id": {
@@ -5227,15 +5125,6 @@
       "oneOf": [
         {
           "properties": {
-            "queries": {
-              "items": {
-                "type": "string"
-              },
-              "type": [
-                "array",
-                "null"
-              ]
-            },
             "query": {
               "type": [
                 "string",

codex-rs/app-server-json-schema/stable/v1/GetAuthStatusResponse.json

@@ -2,7 +2,7 @@
   "$schema": "http://json-schema.org/draft-07/schema#",
   "definitions": {
     "AuthMode": {
-      "description": "Authentication mode for OpenAI-backed providers.",
+      "description": "Authentication mode for OpenAI-backed providers.\n\nThis is used internally to determine the base URL for generating responses, and to gate ChatGPT-only behaviors like rate limits and available models (as opposed to API key-based auth).",
       "oneOf": [
         {
           "description": "OpenAI API key provided by the caller and stored by Codex.",
@@ -17,13 +17,6 @@
             "chatgpt"
           ],
           "type": "string"
-        },
-        {
-          "description": "[UNSTABLE] FOR OPENAI INTERNAL USE ONLY - DO NOT USE.\n\nChatGPT auth tokens are supplied by an external host app and are only stored in memory. Token refresh must be handled by the external host app.",
-          "enum": [
-            "chatgptAuthTokens"
-          ],
-          "type": "string"
         }
       ]
     }

codex-rs/app-server-json-schema/stable/v1/InitializeParams.json

@@ -21,30 +21,9 @@
         "version"
       ],
       "type": "object"
-    },
-    "InitializeCapabilities": {
-      "description": "Client-declared capabilities negotiated during initialize.",
-      "properties": {
-        "experimentalApi": {
-          "default": false,
-          "description": "Opt into receiving experimental API methods and fields.",
-          "type": "boolean"
-        }
-      },
-      "type": "object"
     }
   },
   "properties": {
-    "capabilities": {
-      "anyOf": [
-        {
-          "$ref": "#/definitions/InitializeCapabilities"
-        },
-        {
-          "type": "null"
-        }
-      ]
-    },
     "clientInfo": {
       "$ref": "#/definitions/ClientInfo"
     }

codex-rs/app-server-json-schema/stable/v1/ResumeConversationParams.json

@@ -775,15 +775,6 @@
       "oneOf": [
         {
           "properties": {
-            "queries": {
-              "items": {
-                "type": "string"
-              },
-              "type": [
-                "array",
-                "null"
-              ]
-            },
             "query": {
               "type": [
                 "string",

codex-rs/app-server-json-schema/stable/v1/ResumeConversationResponse.json

@@ -680,14 +680,6 @@
         {
           "description": "Agent has started a turn. v1 wire format uses `task_started`; accept `turn_started` for v2 interop.",
           "properties": {
-            "collaboration_mode_kind": {
-              "allOf": [
-                {
-                  "$ref": "#/definitions/ModeKind"
-                }
-              ],
-              "default": "default"
-            },
             "model_context_window": {
               "format": "int64",
               "type": [
@@ -1049,14 +1041,12 @@
               "description": "How to sandbox commands executed in the system"
             },
             "session_id": {
-              "$ref": "#/definitions/ThreadId"
-            },
-            "thread_name": {
-              "description": "Optional user-facing thread name (may be unset).",
-              "type": [
-                "string",
-                "null"
-              ]
+              "allOf": [
+                {
+                  "$ref": "#/definitions/ThreadId"
+                }
+              ],
+              "description": "Name left as session_id instead of thread_id for backwards compatibility."
             },
             "type": {
               "enum": [
@@ -1080,33 +1070,6 @@
           "title": "SessionConfiguredEventMsg",
           "type": "object"
         },
-        {
-          "description": "Updated session metadata (e.g., thread name changes).",
-          "properties": {
-            "thread_id": {
-              "$ref": "#/definitions/ThreadId"
-            },
-            "thread_name": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "type": {
-              "enum": [
-                "thread_name_updated"
-              ],
-              "title": "ThreadNameUpdatedEventMsgType",
-              "type": "string"
-            }
-          },
-          "required": [
-            "thread_id",
-            "type"
-          ],
-          "title": "ThreadNameUpdatedEventMsg",
-          "type": "object"
-        },
         {
           "description": "Incremental MCP startup progress updates.",
           "properties": {
@@ -2168,7 +2131,6 @@
           "properties": {
             "explanation": {
               "default": null,
-              "description": "Arguments for the `update_plan` todo/checklist tool (not plan mode).",
               "type": [
                 "string",
                 "null"
@@ -2394,38 +2356,6 @@
           "title": "AgentMessageContentDeltaEventMsg",
           "type": "object"
         },
-        {
-          "properties": {
-            "delta": {
-              "type": "string"
-            },
-            "item_id": {
-              "type": "string"
-            },
-            "thread_id": {
-              "type": "string"
-            },
-            "turn_id": {
-              "type": "string"
-            },
-            "type": {
-              "enum": [
-                "plan_delta"
-              ],
-              "title": "PlanDeltaEventMsgType",
-              "type": "string"
-            }
-          },
-          "required": [
-            "delta",
-            "item_id",
-            "thread_id",
-            "turn_id",
-            "type"
-          ],
-          "title": "PlanDeltaEventMsg",
-          "type": "object"
-        },
         {
           "properties": {
             "delta": {
@@ -3276,14 +3206,6 @@
         }
       ]
     },
-    "ModeKind": {
-      "description": "Initial collaboration mode to use when the TUI starts.",
-      "enum": [
-        "plan",
-        "default"
-      ],
-      "type": "string"
-    },
     "NetworkAccess": {
       "description": "Represents whether outbound network access is available to the agent.",
       "enum": [
@@ -4990,30 +4912,6 @@
           "title": "AgentMessageTurnItem",
           "type": "object"
         },
-        {
-          "properties": {
-            "id": {
-              "type": "string"
-            },
-            "text": {
-              "type": "string"
-            },
-            "type": {
-              "enum": [
-                "Plan"
-              ],
-              "title": "PlanTurnItemType",
-              "type": "string"
-            }
-          },
-          "required": [
-            "id",
-            "text",
-            "type"
-          ],
-          "title": "PlanTurnItem",
-          "type": "object"
-        },
         {
           "properties": {
             "id": {
@@ -5227,15 +5125,6 @@
       "oneOf": [
         {
           "properties": {
-            "queries": {
-              "items": {
-                "type": "string"
-              },
-              "type": [
-                "array",
-                "null"
-              ]
-            },
             "query": {
               "type": [
                 "string",

codex-rs/app-server-json-schema/stable/v1/SessionConfiguredNotification.json

@@ -680,14 +680,6 @@
         {
           "description": "Agent has started a turn. v1 wire format uses `task_started`; accept `turn_started` for v2 interop.",
           "properties": {
-            "collaboration_mode_kind": {
-              "allOf": [
-                {
-                  "$ref": "#/definitions/ModeKind"
-                }
-              ],
-              "default": "default"
-            },
             "model_context_window": {
               "format": "int64",
               "type": [
@@ -1049,14 +1041,12 @@
               "description": "How to sandbox commands executed in the system"
             },
             "session_id": {
-              "$ref": "#/definitions/ThreadId"
-            },
-            "thread_name": {
-              "description": "Optional user-facing thread name (may be unset).",
-              "type": [
-                "string",
-                "null"
-              ]
+              "allOf": [
+                {
+                  "$ref": "#/definitions/ThreadId"
+                }
+              ],
+              "description": "Name left as session_id instead of thread_id for backwards compatibility."
             },
             "type": {
               "enum": [
@@ -1080,33 +1070,6 @@
           "title": "SessionConfiguredEventMsg",
           "type": "object"
         },
-        {
-          "description": "Updated session metadata (e.g., thread name changes).",
-          "properties": {
-            "thread_id": {
-              "$ref": "#/definitions/ThreadId"
-            },
-            "thread_name": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "type": {
-              "enum": [
-                "thread_name_updated"
-              ],
-              "title": "ThreadNameUpdatedEventMsgType",
-              "type": "string"
-            }
-          },
-          "required": [
-            "thread_id",
-            "type"
-          ],
-          "title": "ThreadNameUpdatedEventMsg",
-          "type": "object"
-        },
         {
           "description": "Incremental MCP startup progress updates.",
           "properties": {
@@ -2168,7 +2131,6 @@
           "properties": {
             "explanation": {
               "default": null,
-              "description": "Arguments for the `update_plan` todo/checklist tool (not plan mode).",
               "type": [
                 "string",
                 "null"
@@ -2394,38 +2356,6 @@
           "title": "AgentMessageContentDeltaEventMsg",
           "type": "object"
         },
-        {
-          "properties": {
-            "delta": {
-              "type": "string"
-            },
-            "item_id": {
-              "type": "string"
-            },
-            "thread_id": {
-              "type": "string"
-            },
-            "turn_id": {
-              "type": "string"
-            },
-            "type": {
-              "enum": [
-                "plan_delta"
-              ],
-              "title": "PlanDeltaEventMsgType",
-              "type": "string"
-            }
-          },
-          "required": [
-            "delta",
-            "item_id",
-            "thread_id",
-            "turn_id",
-            "type"
-          ],
-          "title": "PlanDeltaEventMsg",
-          "type": "object"
-        },
         {
           "properties": {
             "delta": {
@@ -3276,14 +3206,6 @@
         }
       ]
     },
-    "ModeKind": {
-      "description": "Initial collaboration mode to use when the TUI starts.",
-      "enum": [
-        "plan",
-        "default"
-      ],
-      "type": "string"
-    },
     "NetworkAccess": {
       "description": "Represents whether outbound network access is available to the agent.",
       "enum": [
@@ -4990,30 +4912,6 @@
           "title": "AgentMessageTurnItem",
           "type": "object"
         },
-        {
-          "properties": {
-            "id": {
-              "type": "string"
-            },
-            "text": {
-              "type": "string"
-            },
-            "type": {
-              "enum": [
-                "Plan"
-              ],
-              "title": "PlanTurnItemType",
-              "type": "string"
-            }
-          },
-          "required": [
-            "id",
-            "text",
-            "type"
-          ],
-          "title": "PlanTurnItem",
-          "type": "object"
-        },
         {
           "properties": {
             "id": {
@@ -5227,15 +5125,6 @@
       "oneOf": [
         {
           "properties": {
-            "queries": {
-              "items": {
-                "type": "string"
-              },
-              "type": [
-                "array",
-                "null"
-              ]
-            },
             "query": {
               "type": [
                 "string",

codex-rs/app-server-json-schema/stable/v2/AccountUpdatedNotification.json

@@ -2,7 +2,7 @@
   "$schema": "http://json-schema.org/draft-07/schema#",
   "definitions": {
     "AuthMode": {
-      "description": "Authentication mode for OpenAI-backed providers.",
+      "description": "Authentication mode for OpenAI-backed providers.\n\nThis is used internally to determine the base URL for generating responses, and to gate ChatGPT-only behaviors like rate limits and available models (as opposed to API key-based auth).",
       "oneOf": [
         {
           "description": "OpenAI API key provided by the caller and stored by Codex.",
@@ -17,13 +17,6 @@
             "chatgpt"
           ],
           "type": "string"
-        },
-        {
-          "description": "[UNSTABLE] FOR OPENAI INTERNAL USE ONLY - DO NOT USE.\n\nChatGPT auth tokens are supplied by an external host app and are only stored in memory. Token refresh must be handled by the external host app.",
-          "enum": [
-            "chatgptAuthTokens"
-          ],
-          "type": "string"
         }
       ]
     }

codex-rs/app-server-json-schema/stable/v2/ConfigRequirementsReadResponse.json

@@ -29,26 +29,10 @@
             "array",
             "null"
           ]
-        },
-        "enforceResidency": {
-          "anyOf": [
-            {
-              "$ref": "#/definitions/ResidencyRequirement"
-            },
-            {
-              "type": "null"
-            }
-          ]
         }
       },
       "type": "object"
     },
-    "ResidencyRequirement": {
-      "enum": [
-        "us"
-      ],
-      "type": "string"
-    },
     "SandboxMode": {
       "enum": [
         "read-only",