cr

codex-rs/app-server-protocol/schema/json/v2/CommandExecOutputDeltaNotification.json

@@ -2,25 +2,46 @@
   "$schema": "http://json-schema.org/draft-07/schema#",
   "definitions": {
     "CommandExecOutputStream": {
-      "enum": [
-        "stdout",
-        "stderr"
-      ],
-      "type": "string"
+      "description": "Stream label for `command/exec/outputDelta` notifications.",
+      "oneOf": [
+        {
+          "description": "stdout stream. PTY mode multiplexes terminal output here.",
+          "enum": [
+            "stdout"
+          ],
+          "type": "string"
+        },
+        {
+          "description": "stderr stream.",
+          "enum": [
+            "stderr"
+          ],
+          "type": "string"
+        }
+      ]
     }
   },
+  "description": "Base64-encoded output chunk emitted for a streaming `command/exec` request.\n\nThese notifications are connection-scoped. If the originating connection closes, the server terminates the process.",
   "properties": {
     "capReached": {
+      "description": "`true` on the final streamed chunk for a stream when `outputBytesCap` truncated later output on that stream.",
       "type": "boolean"
     },
     "deltaBase64": {
+      "description": "Base64-encoded output bytes.",
       "type": "string"
     },
     "processId": {
+      "description": "Client-supplied, connection-scoped `processId` from the original `command/exec` request.",
       "type": "string"
     },
     "stream": {
-      "$ref": "#/definitions/CommandExecOutputStream"
+      "allOf": [
+        {
+          "$ref": "#/definitions/CommandExecOutputStream"
+        }
+      ],
+      "description": "Output stream for this chunk."
     }
   },
   "required": [