From 81addf0670c5b2e9f56de65ffe9459eb0200bbe2 Mon Sep 17 00:00:00 2001
From: Matthew Zeng <mzeng@openai.com>
Date: Wed, 11 Feb 2026 16:31:16 -0800
Subject: [PATCH] update

---
 .../schema/json/ServerNotification.json                    | 2 +-
 .../schema/json/codex_app_server_protocol.schemas.json     | 2 +-
 .../schema/json/v2/AppListUpdatedNotification.json         | 2 +-
 .../schema/json/v2/AppsListResponse.json                   | 2 +-
 .../app-server-protocol/schema/typescript/v2/AppInfo.ts    | 7 ++++++-
 codex-rs/app-server-protocol/src/protocol/v2.rs            | 7 ++++++-
 6 files changed, 16 insertions(+), 6 deletions(-)

diff --git a/codex-rs/app-server-protocol/schema/json/ServerNotification.json b/codex-rs/app-server-protocol/schema/json/ServerNotification.json
index 6d313e7e6d..41718c0d12 100644
--- a/codex-rs/app-server-protocol/schema/json/ServerNotification.json
+++ b/codex-rs/app-server-protocol/schema/json/ServerNotification.json
@@ -195,7 +195,7 @@
         },
         "isEnabled": {
           "default": true,
-          "description": "Whether this app is enabled in the loaded config.",
+          "description": "Whether this app is enabled in config.toml. Example: ```toml [app.bad_app] enabled = false ```",
           "type": "boolean"
         },
         "logoUrl": {
diff --git a/codex-rs/app-server-protocol/schema/json/codex_app_server_protocol.schemas.json b/codex-rs/app-server-protocol/schema/json/codex_app_server_protocol.schemas.json
index e80150ce5e..9f087d96e6 100644
--- a/codex-rs/app-server-protocol/schema/json/codex_app_server_protocol.schemas.json
+++ b/codex-rs/app-server-protocol/schema/json/codex_app_server_protocol.schemas.json
@@ -10060,7 +10060,7 @@
           },
           "isEnabled": {
             "default": true,
-            "description": "Whether this app is enabled in the loaded config.",
+            "description": "Whether this app is enabled in config.toml. Example: ```toml [app.bad_app] enabled = false ```",
             "type": "boolean"
           },
           "logoUrl": {
diff --git a/codex-rs/app-server-protocol/schema/json/v2/AppListUpdatedNotification.json b/codex-rs/app-server-protocol/schema/json/v2/AppListUpdatedNotification.json
index 8161db4bc8..4b6e3b53df 100644
--- a/codex-rs/app-server-protocol/schema/json/v2/AppListUpdatedNotification.json
+++ b/codex-rs/app-server-protocol/schema/json/v2/AppListUpdatedNotification.json
@@ -31,7 +31,7 @@
         },
         "isEnabled": {
           "default": true,
-          "description": "Whether this app is enabled in the loaded config.",
+          "description": "Whether this app is enabled in config.toml. Example: ```toml [app.bad_app] enabled = false ```",
           "type": "boolean"
         },
         "logoUrl": {
diff --git a/codex-rs/app-server-protocol/schema/json/v2/AppsListResponse.json b/codex-rs/app-server-protocol/schema/json/v2/AppsListResponse.json
index fbbe219646..8e302224f0 100644
--- a/codex-rs/app-server-protocol/schema/json/v2/AppsListResponse.json
+++ b/codex-rs/app-server-protocol/schema/json/v2/AppsListResponse.json
@@ -31,7 +31,7 @@
         },
         "isEnabled": {
           "default": true,
-          "description": "Whether this app is enabled in the loaded config.",
+          "description": "Whether this app is enabled in config.toml. Example: ```toml [app.bad_app] enabled = false ```",
           "type": "boolean"
         },
         "logoUrl": {
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/AppInfo.ts b/codex-rs/app-server-protocol/schema/typescript/v2/AppInfo.ts
index 7e88e1890b..919954295f 100644
--- a/codex-rs/app-server-protocol/schema/typescript/v2/AppInfo.ts
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/AppInfo.ts
@@ -7,6 +7,11 @@
  */
 export type AppInfo = { id: string, name: string, description: string | null, logoUrl: string | null, logoUrlDark: string | null, distributionChannel: string | null, installUrl: string | null, isAccessible: boolean, 
 /**
- * Whether this app is enabled in the loaded config.
+ * Whether this app is enabled in config.toml.
+ * Example:
+ * ```toml
+ * [app.bad_app]
+ * enabled = false
+ * ```
  */
 isEnabled: boolean, };
diff --git a/codex-rs/app-server-protocol/src/protocol/v2.rs b/codex-rs/app-server-protocol/src/protocol/v2.rs
index 260aa3d0e2..cdcb400fe4 100644
--- a/codex-rs/app-server-protocol/src/protocol/v2.rs
+++ b/codex-rs/app-server-protocol/src/protocol/v2.rs
@@ -1223,7 +1223,12 @@ pub struct AppInfo {
     pub install_url: Option<String>,
     #[serde(default)]
     pub is_accessible: bool,
-    /// Whether this app is enabled in the loaded config.
+    /// Whether this app is enabled in config.toml.
+    /// Example:
+    /// ```toml
+    /// [app.bad_app]
+    /// enabled = false
+    /// ```
     #[serde(default = "default_enabled")]
     pub is_enabled: bool,
 }