diff --git a/codex-rs/app-server-protocol/schema/json/DynamicToolCallParams.json b/codex-rs/app-server-protocol/schema/json/DynamicToolCallParams.json
index 0aa8b9c571..991733da66 100644
--- a/codex-rs/app-server-protocol/schema/json/DynamicToolCallParams.json
+++ b/codex-rs/app-server-protocol/schema/json/DynamicToolCallParams.json
@@ -30,4 +30,4 @@
   ],
   "title": "DynamicToolCallParams",
   "type": "object"
-}
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/ServerNotification.json b/codex-rs/app-server-protocol/schema/json/ServerNotification.json
index dc629735d0..90e23a4aca 100644
--- a/codex-rs/app-server-protocol/schema/json/ServerNotification.json
+++ b/codex-rs/app-server-protocol/schema/json/ServerNotification.json
@@ -4053,7 +4053,7 @@
           "type": "string"
         },
         "items": {
-          "description": "Populated on history-bearing responses such as `thread/resume` and `thread/fork`. The `turn/completed` notification also includes the terminal turn items when they are still available from the live thread listener. Other responses and notifications may still return an empty list to keep payloads small.",
+          "description": "Populated on history-bearing responses such as `thread/resume` and `thread/fork`. The `turn/completed` notification may also include a compact terminal turn snapshot when it is still available from the live thread listener. Bulky command/tool outputs may be elided there to avoid replaying large payloads on the terminal notification.",
           "items": {
             "$ref": "#/definitions/ThreadItem"
           },
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 d32af787a3..b55d86e3c6 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
@@ -14099,8 +14099,8 @@
               },
               "namespace": {
                 "type": [
-                  "null",
-                  "string"
+                  "string",
+                  "null"
                 ]
               },
               "status": {
@@ -15812,7 +15812,7 @@
             "type": "string"
           },
           "items": {
-            "description": "Populated on history-bearing responses such as `thread/resume` and `thread/fork`. The `turn/completed` notification also includes the terminal turn items when they are still available from the live thread listener. Other responses and notifications may still return an empty list to keep payloads small.",
+            "description": "Populated on history-bearing responses such as `thread/resume` and `thread/fork`. The `turn/completed` notification may also include a compact terminal turn snapshot when it is still available from the live thread listener. Bulky command/tool outputs may be elided there to avoid replaying large payloads on the terminal notification.",
             "items": {
               "$ref": "#/definitions/v2/ThreadItem"
             },
@@ -16612,4 +16612,4 @@
   },
   "title": "CodexAppServerProtocol",
   "type": "object"
-}
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/codex_app_server_protocol.v2.schemas.json b/codex-rs/app-server-protocol/schema/json/codex_app_server_protocol.v2.schemas.json
index b0c141ec8c..42cfb5847e 100644
--- a/codex-rs/app-server-protocol/schema/json/codex_app_server_protocol.v2.schemas.json
+++ b/codex-rs/app-server-protocol/schema/json/codex_app_server_protocol.v2.schemas.json
@@ -13710,7 +13710,7 @@
           "type": "string"
         },
         "items": {
-          "description": "Populated on history-bearing responses such as `thread/resume` and `thread/fork`. The `turn/completed` notification also includes the terminal turn items when they are still available from the live thread listener. Other responses and notifications may still return an empty list to keep payloads small.",
+          "description": "Populated on history-bearing responses such as `thread/resume` and `thread/fork`. The `turn/completed` notification may also include a compact terminal turn snapshot when it is still available from the live thread listener. Bulky command/tool outputs may be elided there to avoid replaying large payloads on the terminal notification.",
           "items": {
             "$ref": "#/definitions/ThreadItem"
           },
diff --git a/codex-rs/app-server-protocol/schema/json/v2/ReviewStartResponse.json b/codex-rs/app-server-protocol/schema/json/v2/ReviewStartResponse.json
index 9a50640fb8..07eeefa1a0 100644
--- a/codex-rs/app-server-protocol/schema/json/v2/ReviewStartResponse.json
+++ b/codex-rs/app-server-protocol/schema/json/v2/ReviewStartResponse.json
@@ -1323,7 +1323,7 @@
           "type": "string"
         },
         "items": {
-          "description": "Populated on history-bearing responses such as `thread/resume` and `thread/fork`. The `turn/completed` notification also includes the terminal turn items when they are still available from the live thread listener. Other responses and notifications may still return an empty list to keep payloads small.",
+          "description": "Populated on history-bearing responses such as `thread/resume` and `thread/fork`. The `turn/completed` notification may also include a compact terminal turn snapshot when it is still available from the live thread listener. Bulky command/tool outputs may be elided there to avoid replaying large payloads on the terminal notification.",
           "items": {
             "$ref": "#/definitions/ThreadItem"
           },
diff --git a/codex-rs/app-server-protocol/schema/json/v2/ThreadForkResponse.json b/codex-rs/app-server-protocol/schema/json/v2/ThreadForkResponse.json
index 4e1e80694b..e35c71d94f 100644
--- a/codex-rs/app-server-protocol/schema/json/v2/ThreadForkResponse.json
+++ b/codex-rs/app-server-protocol/schema/json/v2/ThreadForkResponse.json
@@ -1912,7 +1912,7 @@
           "type": "string"
         },
         "items": {
-          "description": "Populated on history-bearing responses such as `thread/resume` and `thread/fork`. The `turn/completed` notification also includes the terminal turn items when they are still available from the live thread listener. Other responses and notifications may still return an empty list to keep payloads small.",
+          "description": "Populated on history-bearing responses such as `thread/resume` and `thread/fork`. The `turn/completed` notification may also include a compact terminal turn snapshot when it is still available from the live thread listener. Bulky command/tool outputs may be elided there to avoid replaying large payloads on the terminal notification.",
           "items": {
             "$ref": "#/definitions/ThreadItem"
           },
diff --git a/codex-rs/app-server-protocol/schema/json/v2/ThreadListResponse.json b/codex-rs/app-server-protocol/schema/json/v2/ThreadListResponse.json
index 4c1c2efa89..803f4c7b0f 100644
--- a/codex-rs/app-server-protocol/schema/json/v2/ThreadListResponse.json
+++ b/codex-rs/app-server-protocol/schema/json/v2/ThreadListResponse.json
@@ -1674,7 +1674,7 @@
           "type": "string"
         },
         "items": {
-          "description": "Populated on history-bearing responses such as `thread/resume` and `thread/fork`. The `turn/completed` notification also includes the terminal turn items when they are still available from the live thread listener. Other responses and notifications may still return an empty list to keep payloads small.",
+          "description": "Populated on history-bearing responses such as `thread/resume` and `thread/fork`. The `turn/completed` notification may also include a compact terminal turn snapshot when it is still available from the live thread listener. Bulky command/tool outputs may be elided there to avoid replaying large payloads on the terminal notification.",
           "items": {
             "$ref": "#/definitions/ThreadItem"
           },
diff --git a/codex-rs/app-server-protocol/schema/json/v2/ThreadMetadataUpdateResponse.json b/codex-rs/app-server-protocol/schema/json/v2/ThreadMetadataUpdateResponse.json
index 1fe7a12d24..97d30c5f1f 100644
--- a/codex-rs/app-server-protocol/schema/json/v2/ThreadMetadataUpdateResponse.json
+++ b/codex-rs/app-server-protocol/schema/json/v2/ThreadMetadataUpdateResponse.json
@@ -1674,7 +1674,7 @@
           "type": "string"
         },
         "items": {
-          "description": "Populated on history-bearing responses such as `thread/resume` and `thread/fork`. The `turn/completed` notification also includes the terminal turn items when they are still available from the live thread listener. Other responses and notifications may still return an empty list to keep payloads small.",
+          "description": "Populated on history-bearing responses such as `thread/resume` and `thread/fork`. The `turn/completed` notification may also include a compact terminal turn snapshot when it is still available from the live thread listener. Bulky command/tool outputs may be elided there to avoid replaying large payloads on the terminal notification.",
           "items": {
             "$ref": "#/definitions/ThreadItem"
           },
diff --git a/codex-rs/app-server-protocol/schema/json/v2/ThreadReadResponse.json b/codex-rs/app-server-protocol/schema/json/v2/ThreadReadResponse.json
index e1dc64b988..67dd860dad 100644
--- a/codex-rs/app-server-protocol/schema/json/v2/ThreadReadResponse.json
+++ b/codex-rs/app-server-protocol/schema/json/v2/ThreadReadResponse.json
@@ -1674,7 +1674,7 @@
           "type": "string"
         },
         "items": {
-          "description": "Populated on history-bearing responses such as `thread/resume` and `thread/fork`. The `turn/completed` notification also includes the terminal turn items when they are still available from the live thread listener. Other responses and notifications may still return an empty list to keep payloads small.",
+          "description": "Populated on history-bearing responses such as `thread/resume` and `thread/fork`. The `turn/completed` notification may also include a compact terminal turn snapshot when it is still available from the live thread listener. Bulky command/tool outputs may be elided there to avoid replaying large payloads on the terminal notification.",
           "items": {
             "$ref": "#/definitions/ThreadItem"
           },
diff --git a/codex-rs/app-server-protocol/schema/json/v2/ThreadResumeResponse.json b/codex-rs/app-server-protocol/schema/json/v2/ThreadResumeResponse.json
index f776b676ff..6cda6d8239 100644
--- a/codex-rs/app-server-protocol/schema/json/v2/ThreadResumeResponse.json
+++ b/codex-rs/app-server-protocol/schema/json/v2/ThreadResumeResponse.json
@@ -1912,7 +1912,7 @@
           "type": "string"
         },
         "items": {
-          "description": "Populated on history-bearing responses such as `thread/resume` and `thread/fork`. The `turn/completed` notification also includes the terminal turn items when they are still available from the live thread listener. Other responses and notifications may still return an empty list to keep payloads small.",
+          "description": "Populated on history-bearing responses such as `thread/resume` and `thread/fork`. The `turn/completed` notification may also include a compact terminal turn snapshot when it is still available from the live thread listener. Bulky command/tool outputs may be elided there to avoid replaying large payloads on the terminal notification.",
           "items": {
             "$ref": "#/definitions/ThreadItem"
           },
diff --git a/codex-rs/app-server-protocol/schema/json/v2/ThreadRollbackResponse.json b/codex-rs/app-server-protocol/schema/json/v2/ThreadRollbackResponse.json
index c2c9b3a14d..3e4c4d2a58 100644
--- a/codex-rs/app-server-protocol/schema/json/v2/ThreadRollbackResponse.json
+++ b/codex-rs/app-server-protocol/schema/json/v2/ThreadRollbackResponse.json
@@ -1674,7 +1674,7 @@
           "type": "string"
         },
         "items": {
-          "description": "Populated on history-bearing responses such as `thread/resume` and `thread/fork`. The `turn/completed` notification also includes the terminal turn items when they are still available from the live thread listener. Other responses and notifications may still return an empty list to keep payloads small.",
+          "description": "Populated on history-bearing responses such as `thread/resume` and `thread/fork`. The `turn/completed` notification may also include a compact terminal turn snapshot when it is still available from the live thread listener. Bulky command/tool outputs may be elided there to avoid replaying large payloads on the terminal notification.",
           "items": {
             "$ref": "#/definitions/ThreadItem"
           },
diff --git a/codex-rs/app-server-protocol/schema/json/v2/ThreadStartResponse.json b/codex-rs/app-server-protocol/schema/json/v2/ThreadStartResponse.json
index f4f71dbf24..f7e6179214 100644
--- a/codex-rs/app-server-protocol/schema/json/v2/ThreadStartResponse.json
+++ b/codex-rs/app-server-protocol/schema/json/v2/ThreadStartResponse.json
@@ -1912,7 +1912,7 @@
           "type": "string"
         },
         "items": {
-          "description": "Populated on history-bearing responses such as `thread/resume` and `thread/fork`. The `turn/completed` notification also includes the terminal turn items when they are still available from the live thread listener. Other responses and notifications may still return an empty list to keep payloads small.",
+          "description": "Populated on history-bearing responses such as `thread/resume` and `thread/fork`. The `turn/completed` notification may also include a compact terminal turn snapshot when it is still available from the live thread listener. Bulky command/tool outputs may be elided there to avoid replaying large payloads on the terminal notification.",
           "items": {
             "$ref": "#/definitions/ThreadItem"
           },
diff --git a/codex-rs/app-server-protocol/schema/json/v2/ThreadStartedNotification.json b/codex-rs/app-server-protocol/schema/json/v2/ThreadStartedNotification.json
index af81c86f5b..a4d8a4bbe8 100644
--- a/codex-rs/app-server-protocol/schema/json/v2/ThreadStartedNotification.json
+++ b/codex-rs/app-server-protocol/schema/json/v2/ThreadStartedNotification.json
@@ -1674,7 +1674,7 @@
           "type": "string"
         },
         "items": {
-          "description": "Populated on history-bearing responses such as `thread/resume` and `thread/fork`. The `turn/completed` notification also includes the terminal turn items when they are still available from the live thread listener. Other responses and notifications may still return an empty list to keep payloads small.",
+          "description": "Populated on history-bearing responses such as `thread/resume` and `thread/fork`. The `turn/completed` notification may also include a compact terminal turn snapshot when it is still available from the live thread listener. Bulky command/tool outputs may be elided there to avoid replaying large payloads on the terminal notification.",
           "items": {
             "$ref": "#/definitions/ThreadItem"
           },
diff --git a/codex-rs/app-server-protocol/schema/json/v2/ThreadTurnsListResponse.json b/codex-rs/app-server-protocol/schema/json/v2/ThreadTurnsListResponse.json
index 8d4ee72e17..5f7f37c0dc 100644
--- a/codex-rs/app-server-protocol/schema/json/v2/ThreadTurnsListResponse.json
+++ b/codex-rs/app-server-protocol/schema/json/v2/ThreadTurnsListResponse.json
@@ -1323,7 +1323,7 @@
           "type": "string"
         },
         "items": {
-          "description": "Only populated on a `thread/resume` or `thread/fork` response. For all other responses and notifications returning a Turn, the items field will be an empty list.",
+          "description": "Populated on history-bearing responses such as `thread/resume` and `thread/fork`. The `turn/completed` notification may also include a compact terminal turn snapshot when it is still available from the live thread listener. Bulky command/tool outputs may be elided there to avoid replaying large payloads on the terminal notification.",
           "items": {
             "$ref": "#/definitions/ThreadItem"
           },
diff --git a/codex-rs/app-server-protocol/schema/json/v2/ThreadUnarchiveResponse.json b/codex-rs/app-server-protocol/schema/json/v2/ThreadUnarchiveResponse.json
index 1f6c9987c8..1ed3d4b331 100644
--- a/codex-rs/app-server-protocol/schema/json/v2/ThreadUnarchiveResponse.json
+++ b/codex-rs/app-server-protocol/schema/json/v2/ThreadUnarchiveResponse.json
@@ -1674,7 +1674,7 @@
           "type": "string"
         },
         "items": {
-          "description": "Populated on history-bearing responses such as `thread/resume` and `thread/fork`. The `turn/completed` notification also includes the terminal turn items when they are still available from the live thread listener. Other responses and notifications may still return an empty list to keep payloads small.",
+          "description": "Populated on history-bearing responses such as `thread/resume` and `thread/fork`. The `turn/completed` notification may also include a compact terminal turn snapshot when it is still available from the live thread listener. Bulky command/tool outputs may be elided there to avoid replaying large payloads on the terminal notification.",
           "items": {
             "$ref": "#/definitions/ThreadItem"
           },
diff --git a/codex-rs/app-server-protocol/schema/json/v2/TurnCompletedNotification.json b/codex-rs/app-server-protocol/schema/json/v2/TurnCompletedNotification.json
index 1aab9ad372..8b658a4708 100644
--- a/codex-rs/app-server-protocol/schema/json/v2/TurnCompletedNotification.json
+++ b/codex-rs/app-server-protocol/schema/json/v2/TurnCompletedNotification.json
@@ -1323,7 +1323,7 @@
           "type": "string"
         },
         "items": {
-          "description": "Populated on history-bearing responses such as `thread/resume` and `thread/fork`. The `turn/completed` notification also includes the terminal turn items when they are still available from the live thread listener. Other responses and notifications may still return an empty list to keep payloads small.",
+          "description": "Populated on history-bearing responses such as `thread/resume` and `thread/fork`. The `turn/completed` notification may also include a compact terminal turn snapshot when it is still available from the live thread listener. Bulky command/tool outputs may be elided there to avoid replaying large payloads on the terminal notification.",
           "items": {
             "$ref": "#/definitions/ThreadItem"
           },
diff --git a/codex-rs/app-server-protocol/schema/json/v2/TurnStartResponse.json b/codex-rs/app-server-protocol/schema/json/v2/TurnStartResponse.json
index a6ecf5c75c..161b0ff6b7 100644
--- a/codex-rs/app-server-protocol/schema/json/v2/TurnStartResponse.json
+++ b/codex-rs/app-server-protocol/schema/json/v2/TurnStartResponse.json
@@ -1323,7 +1323,7 @@
           "type": "string"
         },
         "items": {
-          "description": "Populated on history-bearing responses such as `thread/resume` and `thread/fork`. The `turn/completed` notification also includes the terminal turn items when they are still available from the live thread listener. Other responses and notifications may still return an empty list to keep payloads small.",
+          "description": "Populated on history-bearing responses such as `thread/resume` and `thread/fork`. The `turn/completed` notification may also include a compact terminal turn snapshot when it is still available from the live thread listener. Bulky command/tool outputs may be elided there to avoid replaying large payloads on the terminal notification.",
           "items": {
             "$ref": "#/definitions/ThreadItem"
           },
diff --git a/codex-rs/app-server-protocol/schema/json/v2/TurnStartedNotification.json b/codex-rs/app-server-protocol/schema/json/v2/TurnStartedNotification.json
index 0a2bec35e0..f2e8dda91a 100644
--- a/codex-rs/app-server-protocol/schema/json/v2/TurnStartedNotification.json
+++ b/codex-rs/app-server-protocol/schema/json/v2/TurnStartedNotification.json
@@ -1323,7 +1323,7 @@
           "type": "string"
         },
         "items": {
-          "description": "Populated on history-bearing responses such as `thread/resume` and `thread/fork`. The `turn/completed` notification also includes the terminal turn items when they are still available from the live thread listener. Other responses and notifications may still return an empty list to keep payloads small.",
+          "description": "Populated on history-bearing responses such as `thread/resume` and `thread/fork`. The `turn/completed` notification may also include a compact terminal turn snapshot when it is still available from the live thread listener. Bulky command/tool outputs may be elided there to avoid replaying large payloads on the terminal notification.",
           "items": {
             "$ref": "#/definitions/ThreadItem"
           },
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/Turn.ts b/codex-rs/app-server-protocol/schema/typescript/v2/Turn.ts
index b68175b14e..07f59c4424 100644
--- a/codex-rs/app-server-protocol/schema/typescript/v2/Turn.ts
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/Turn.ts
@@ -8,9 +8,9 @@ import type { TurnStatus } from "./TurnStatus";
 export type Turn = { id: string,
 /**
  * Populated on history-bearing responses such as `thread/resume` and `thread/fork`.
- * The `turn/completed` notification also includes the terminal turn items when they are
- * still available from the live thread listener. Other responses and notifications may
- * still return an empty list to keep payloads small.
+ * The `turn/completed` notification may also include a compact terminal turn snapshot when
+ * it is still available from the live thread listener. Bulky command/tool outputs may be
+ * elided there to avoid replaying large payloads on the terminal notification.
  */
 items: Array<ThreadItem>, status: TurnStatus,
 /**