diff --git a/.github/codex/labels/codex-rust-review.md b/.github/codex/labels/codex-rust-review.md
index ae82d272d7..ae74953a5c 100644
--- a/.github/codex/labels/codex-rust-review.md
+++ b/.github/codex/labels/codex-rust-review.md
@@ -15,10 +15,10 @@ Things to look out for when doing the review:
## Code Organization
-- 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.
+- 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.
- 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 analagous 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 analogous to the "inverted pyramid" structure that is favored in journalism.
## Assertions in Tests
diff --git a/.github/workflows/issue-labeler.yml b/.github/workflows/issue-labeler.yml
index da77812fec..8146b8c5bd 100644
--- a/.github/workflows/issue-labeler.yml
+++ b/.github/workflows/issue-labeler.yml
@@ -38,9 +38,10 @@ 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. 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.
+ 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.
- 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).
diff --git a/README.md b/README.md
index eb4ace74f2..ae5073beae 100644
--- a/README.md
+++ b/README.md
@@ -1,7 +1,7 @@
npm i -g @openai/codex
or brew install --cask codex
Codex CLI is a coding agent from OpenAI that runs locally on your computer.
- 
+ 
If you want Codex in your code editor (VS Code, Cursor, Windsurf), install in your IDE.
diff --git a/codex-rs/Cargo.lock b/codex-rs/Cargo.lock
index 5cb338be1d..57186f82f1 100644
--- a/codex-rs/Cargo.lock
+++ b/codex-rs/Cargo.lock
@@ -154,7 +154,7 @@ dependencies = [
"serde_json",
"serde_urlencoded",
"smallvec",
- "socket2 0.6.1",
+ "socket2 0.6.2",
"time",
"tracing",
"url",
@@ -162,9 +162,9 @@ dependencies = [
[[package]]
name = "addr2line"
-version = "0.24.2"
+version = "0.25.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "dfbe277e56a376000877090da837660b4427aad530e3028d44e0bffe4f89a1c1"
+checksum = "1b5d307320b3181d6d7954e663bd7c774a838b8220fe0593c86d9fb09f498b4b"
dependencies = [
"gimli",
]
@@ -193,7 +193,7 @@ source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "5a15f179cd60c4584b8a8c596927aadc462e27f2ca70c04e0071964a73ba7a75"
dependencies = [
"cfg-if",
- "getrandom 0.3.3",
+ "getrandom 0.3.4",
"once_cell",
"version_check",
"zerocopy",
@@ -201,9 +201,9 @@ dependencies = [
[[package]]
name = "aho-corasick"
-version = "1.1.3"
+version = "1.1.4"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "8e60d3430d3a69478ad0993f19238d2df97c507009a52b3c10addcd7f6bcb916"
+checksum = "ddd31a130427c27518df266943a5308ed92d4b226cc639f5a8f1002816174301"
dependencies = [
"memchr",
]
@@ -229,7 +229,7 @@ checksum = "fe233a377643e0fc1a56421d7c90acdec45c291b30345eb9f08e8d0ddce5a4ab"
dependencies = [
"proc-macro2",
"quote",
- "syn 2.0.104",
+ "syn 2.0.114",
]
[[package]]
@@ -271,9 +271,9 @@ dependencies = [
[[package]]
name = "anstream"
-version = "0.6.19"
+version = "0.6.21"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "301af1932e46185686725e0fad2f8f2aa7da69dd70bf6ecc44d6b703844a3933"
+checksum = "43d5b281e737544384e969a5ccad3f1cdd24b48086a0fc1b2a5262a26b8f4f4a"
dependencies = [
"anstyle",
"anstyle-parse",
@@ -286,9 +286,9 @@ dependencies = [
[[package]]
name = "anstyle"
-version = "1.0.11"
+version = "1.0.13"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "862ed96ca487e809f1c8e5a8447f6ee2cf102f846893800b20cebdf541fc6bbd"
+checksum = "5192cca8006f1fd4f7237516f40fa183bb07f8fbdfedaa0036de5ea9b0b45e78"
[[package]]
name = "anstyle-parse"
@@ -301,22 +301,22 @@ dependencies = [
[[package]]
name = "anstyle-query"
-version = "1.1.3"
+version = "1.1.5"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "6c8bdeb6047d8983be085bab0ba1472e6dc604e7041dbf6fcd5e71523014fae9"
+checksum = "40c48f72fd53cd289104fc64099abca73db4166ad86ea0b4341abe65af83dadc"
dependencies = [
- "windows-sys 0.59.0",
+ "windows-sys 0.61.2",
]
[[package]]
name = "anstyle-wincon"
-version = "3.0.9"
+version = "3.0.11"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "403f75924867bb1033c59fbf0797484329750cfbe3c4325cd33127941fabc882"
+checksum = "291e6a250ff86cd4a820112fb8898808a366d8f9f58ce16d1f538353ad55747d"
dependencies = [
"anstyle",
"once_cell_polyfill",
- "windows-sys 0.59.0",
+ "windows-sys 0.61.2",
]
[[package]]
@@ -408,13 +408,12 @@ dependencies = [
[[package]]
name = "assert_cmd"
-version = "2.0.17"
+version = "2.1.2"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "2bd389a4b2970a01282ee455294913c0a43724daedcd1a24c3eb0ec1c1320b66"
+checksum = "9c5bcfa8749ac45dd12cb11055aeeb6b27a3895560d60d71e3c23bf979e60514"
dependencies = [
"anstyle",
"bstr",
- "doc-comment",
"libc",
"predicates",
"predicates-core",
@@ -490,16 +489,16 @@ dependencies = [
"futures-lite",
"parking",
"polling",
- "rustix 1.0.8",
+ "rustix 1.1.3",
"slab",
- "windows-sys 0.61.1",
+ "windows-sys 0.61.2",
]
[[package]]
name = "async-lock"
-version = "3.4.1"
+version = "3.4.2"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "5fd03604047cee9b6ce9de9f70c6cd540a0520c813cbd49bae61f33ab80ed1dc"
+checksum = "290f7f2596bd5b78a9fec8088ccd89180d7f9f55b94b0576823bbbdc72ee8311"
dependencies = [
"event-listener",
"event-listener-strategy",
@@ -521,7 +520,7 @@ dependencies = [
"cfg-if",
"event-listener",
"futures-lite",
- "rustix 1.0.8",
+ "rustix 1.1.3",
]
[[package]]
@@ -532,7 +531,7 @@ checksum = "3b43422f69d8ff38f95f1b2bb76517c91589a924d1559a0e935d7c8ce0274c11"
dependencies = [
"proc-macro2",
"quote",
- "syn 2.0.104",
+ "syn 2.0.114",
]
[[package]]
@@ -547,10 +546,10 @@ dependencies = [
"cfg-if",
"futures-core",
"futures-io",
- "rustix 1.0.8",
+ "rustix 1.1.3",
"signal-hook-registry",
"slab",
- "windows-sys 0.61.1",
+ "windows-sys 0.61.2",
]
[[package]]
@@ -572,7 +571,7 @@ checksum = "c7c24de15d275a1ecfd47a380fb4d5ec9bfe0933f309ed5e705b775596a3574d"
dependencies = [
"proc-macro2",
"quote",
- "syn 2.0.104",
+ "syn 2.0.114",
]
[[package]]
@@ -589,7 +588,7 @@ checksum = "9035ad2d096bed7955a320ee7e2230574d28fd3c3a0f186cbea1ff3c7eed5dbb"
dependencies = [
"proc-macro2",
"quote",
- "syn 2.0.104",
+ "syn 2.0.114",
]
[[package]]
@@ -632,7 +631,7 @@ dependencies = [
"axum-core",
"bytes",
"futures-util",
- "http 1.3.1",
+ "http 1.4.0",
"http-body",
"http-body-util",
"hyper",
@@ -661,7 +660,7 @@ checksum = "08c78f31d7b1291f7ee735c1c6780ccde7785daae9a9206026862dab7d8792d1"
dependencies = [
"bytes",
"futures-core",
- "http 1.3.1",
+ "http 1.4.0",
"http-body",
"http-body-util",
"mime",
@@ -673,9 +672,9 @@ dependencies = [
[[package]]
name = "backtrace"
-version = "0.3.75"
+version = "0.3.76"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "6806a6321ec58106fea15becdad98371e28d92ccbc7c8f1b3b6dd724fe8f1002"
+checksum = "bb531853791a215d7c62a30daf0dde835f381ab5de4589cfe7c649d2cbe92bd6"
dependencies = [
"addr2line",
"cfg-if",
@@ -683,7 +682,7 @@ dependencies = [
"miniz_oxide",
"object",
"rustc-demangle",
- "windows-targets 0.52.6",
+ "windows-link",
]
[[package]]
@@ -694,9 +693,9 @@ checksum = "72b3254f16251a8381aa12e40e3c4d2f0199f8c6508fbecb9d91f575e0fbb8c6"
[[package]]
name = "base64ct"
-version = "1.8.1"
+version = "1.8.3"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "0e050f626429857a27ddccb31e0aca21356bfa709c04041aefddac081a8f068a"
+checksum = "2af50177e190e07a26ab74f8b1efbfe2ef87da2116221318cb1c2e82baf7de06"
[[package]]
name = "beef"
@@ -719,7 +718,7 @@ dependencies = [
"regex",
"rustc-hash",
"shlex",
- "syn 2.0.104",
+ "syn 2.0.114",
]
[[package]]
@@ -770,6 +769,15 @@ dependencies = [
"generic-array",
]
+[[package]]
+name = "block2"
+version = "0.6.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "cdeb9d870516001442e364c5220d3574d2da8dc765554b4a617230d33fa58ef5"
+dependencies = [
+ "objc2",
+]
+
[[package]]
name = "blocking"
version = "1.6.2"
@@ -794,9 +802,9 @@ dependencies = [
[[package]]
name = "bstr"
-version = "1.12.0"
+version = "1.12.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "234113d19d0d7d613b40e86fb654acf958910802bcceab913a4f9e7cda03b1a4"
+checksum = "63044e1ae8e69f3b5a92c736ca6269b8d12fa7efe39bf34ddb06d102cf0e2cab"
dependencies = [
"memchr",
"regex-automata",
@@ -805,15 +813,15 @@ dependencies = [
[[package]]
name = "bumpalo"
-version = "3.19.0"
+version = "3.19.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "46c5e41b57b8bba42a04676d81cb89e9ee8e859a1a66f80a5a72e1cb76b34d43"
+checksum = "5dd9dc738b7a8311c7ade152424974d8115f2cdad61e8dab8dac9f2362298510"
[[package]]
name = "bytemuck"
-version = "1.23.1"
+version = "1.25.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "5c76a5792e44e4abe34d3abf15636779261d45a7450612059293d1d2cfc63422"
+checksum = "c8efb64bd706a16a1bdde310ae86b351e4d21550d98d056f22f8a7f7a2183fec"
[[package]]
name = "byteorder"
@@ -829,9 +837,9 @@ checksum = "8f1fe948ff07f4bd06c30984e69f5b4899c516a3ef74f34df92a2df2ab535495"
[[package]]
name = "bytes"
-version = "1.10.1"
+version = "1.11.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "d71b6127be86fdcfddb610f7182ac57211d4b18a3e9c82eb2d17662f2227ad6a"
+checksum = "b35204fbdc0b3f4446b89fc1ac2cf84a8a68971995d0bf2e925ec7cd960f9cb3"
[[package]]
name = "bytestring"
@@ -868,9 +876,9 @@ dependencies = [
[[package]]
name = "cc"
-version = "1.2.52"
+version = "1.2.55"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "cd4932aefd12402b36c60956a4fe0035421f544799057659ff86f923657aada3"
+checksum = "47b26a0954ae34af09b50f0de26458fa95369a0d478d8236d3f93082b219bd29"
dependencies = [
"find-msvc-tools",
"jobserver",
@@ -895,9 +903,9 @@ dependencies = [
[[package]]
name = "cfg-if"
-version = "1.0.1"
+version = "1.0.4"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "9555578bc9e57714c812a1f84e4fc5b4d21fcb063490c624de019f7464c91268"
+checksum = "9330f8b2ff13f34540b44e946ef35111825727b38d33286ef986142615121801"
[[package]]
name = "cfg_aliases"
@@ -933,7 +941,7 @@ dependencies = [
"num-traits",
"serde",
"wasm-bindgen",
- "windows-link 0.2.0",
+ "windows-link",
]
[[package]]
@@ -965,9 +973,9 @@ dependencies = [
[[package]]
name = "clap"
-version = "4.5.54"
+version = "4.5.56"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "c6e6ff9dcd79cff5cd969a17a545d79e84ab086e444102a591e288a8aa3ce394"
+checksum = "a75ca66430e33a14957acc24c5077b503e7d374151b2b4b3a10c83b4ceb4be0e"
dependencies = [
"clap_builder",
"clap_derive",
@@ -975,9 +983,9 @@ dependencies = [
[[package]]
name = "clap_builder"
-version = "4.5.54"
+version = "4.5.56"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "fa42cf4d2b7a41bc8f663a7cab4031ebafa1bf3875705bfaf8466dc60ab52c00"
+checksum = "793207c7fa6300a0608d1080b858e5fdbe713cdc1c8db9fb17777d8a13e63df0"
dependencies = [
"anstream",
"anstyle",
@@ -988,30 +996,30 @@ dependencies = [
[[package]]
name = "clap_complete"
-version = "4.5.64"
+version = "4.5.65"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "4c0da80818b2d95eca9aa614a30783e42f62bf5fdfee24e68cfb960b071ba8d1"
+checksum = "430b4dc2b5e3861848de79627b2bedc9f3342c7da5173a14eaa5d0f8dc18ae5d"
dependencies = [
"clap",
]
[[package]]
name = "clap_derive"
-version = "4.5.49"
+version = "4.5.55"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "2a0b5487afeab2deb2ff4e03a807ad1a03ac532ff5a2cee5d86884440c7f7671"
+checksum = "a92793da1a46a5f2a02a6f4c46c6496b28c43638adea8306fcb0caa1634f24e5"
dependencies = [
"heck",
"proc-macro2",
"quote",
- "syn 2.0.104",
+ "syn 2.0.114",
]
[[package]]
name = "clap_lex"
-version = "0.7.5"
+version = "0.7.7"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "b94f61472cee1439c0b966b47e3aca9ae07e45d070759512cd390ea2bebc6675"
+checksum = "c3e64b0cc0439b12df2fa678eae89a1c56a529fd067a9115f7827f1fffd22b32"
[[package]]
name = "clipboard-win"
@@ -1058,13 +1066,13 @@ dependencies = [
"codex-protocol",
"eventsource-stream",
"futures",
- "http 1.3.1",
+ "http 1.4.0",
"pretty_assertions",
"regex-lite",
"reqwest",
"serde",
"serde_json",
- "thiserror 2.0.17",
+ "thiserror 2.0.18",
"tokio",
"tokio-test",
"tokio-tungstenite",
@@ -1088,6 +1096,7 @@ dependencies = [
"codex-arg0",
"codex-backend-client",
"codex-chatgpt",
+ "codex-cloud-requirements",
"codex-common",
"codex-core",
"codex-execpolicy",
@@ -1110,7 +1119,7 @@ dependencies = [
"tempfile",
"time",
"tokio",
- "toml 0.9.5",
+ "toml 0.9.11+spec-1.1.0",
"tracing",
"tracing-subscriber",
"uuid",
@@ -1123,15 +1132,20 @@ version = "0.0.0"
dependencies = [
"anyhow",
"clap",
+ "codex-experimental-api-macros",
"codex-protocol",
"codex-utils-absolute-path",
+ "codex-utils-cargo-bin",
+ "inventory",
"mcp-types",
"pretty_assertions",
"schemars 0.8.22",
"serde",
"serde_json",
+ "similar",
"strum_macros 0.27.2",
- "thiserror 2.0.17",
+ "tempfile",
+ "thiserror 2.0.18",
"ts-rs",
"uuid",
]
@@ -1160,7 +1174,7 @@ dependencies = [
"pretty_assertions",
"similar",
"tempfile",
- "thiserror 2.0.17",
+ "thiserror 2.0.18",
"tree-sitter",
"tree-sitter-bash",
]
@@ -1265,7 +1279,7 @@ dependencies = [
"supports-color 3.0.2",
"tempfile",
"tokio",
- "toml 0.9.5",
+ "toml 0.9.11+spec-1.1.0",
"tracing",
]
@@ -1277,14 +1291,14 @@ dependencies = [
"bytes",
"eventsource-stream",
"futures",
- "http 1.3.1",
+ "http 1.4.0",
"opentelemetry",
"opentelemetry_sdk",
"rand 0.9.2",
"reqwest",
"serde",
"serde_json",
- "thiserror 2.0.17",
+ "thiserror 2.0.18",
"tokio",
"tracing",
"tracing-opentelemetry",
@@ -1306,7 +1320,7 @@ dependencies = [
"serde_json",
"tempfile",
"tokio",
- "toml 0.9.5",
+ "toml 0.9.11+spec-1.1.0",
"tracing",
]
@@ -1351,7 +1365,7 @@ dependencies = [
"diffy",
"serde",
"serde_json",
- "thiserror 2.0.17",
+ "thiserror 2.0.18",
]
[[package]]
@@ -1366,7 +1380,7 @@ dependencies = [
"codex-utils-absolute-path",
"pretty_assertions",
"serde",
- "toml 0.9.5",
+ "toml 0.9.11+spec-1.1.0",
]
[[package]]
@@ -1400,6 +1414,7 @@ dependencies = [
"codex-state",
"codex-utils-absolute-path",
"codex-utils-cargo-bin",
+ "codex-utils-home-dir",
"codex-utils-pty",
"codex-utils-readiness",
"codex-utils-string",
@@ -1407,16 +1422,15 @@ dependencies = [
"core-foundation 0.9.4",
"core_test_support",
"ctor 0.6.3",
- "dirs",
"dunce",
"encoding_rs",
"env-flags",
"eventsource-stream",
"futures",
- "http 1.3.1",
+ "http 1.4.0",
"image",
"include_dir",
- "indexmap 2.12.0",
+ "indexmap 2.13.0",
"indoc",
"keyring",
"landlock",
@@ -1426,6 +1440,7 @@ dependencies = [
"multimap",
"once_cell",
"openssl-sys",
+ "opentelemetry_sdk",
"os_info",
"predicates",
"pretty_assertions",
@@ -1447,11 +1462,12 @@ dependencies = [
"tempfile",
"test-case",
"test-log",
- "thiserror 2.0.17",
+ "thiserror 2.0.18",
"time",
"tokio",
+ "tokio-tungstenite",
"tokio-util",
- "toml 0.9.5",
+ "toml 0.9.11+spec-1.1.0",
"toml_edit 0.24.0+spec-1.1.0",
"tracing",
"tracing-subscriber",
@@ -1487,6 +1503,7 @@ dependencies = [
"assert_cmd",
"clap",
"codex-arg0",
+ "codex-cloud-requirements",
"codex-common",
"codex-core",
"codex-protocol",
@@ -1531,7 +1548,7 @@ dependencies = [
"serde",
"serde_json",
"shlex",
- "socket2 0.6.1",
+ "socket2 0.6.2",
"tempfile",
"tokio",
"tokio-util",
@@ -1552,7 +1569,7 @@ dependencies = [
"shlex",
"starlark",
"tempfile",
- "thiserror 2.0.17",
+ "thiserror 2.0.18",
]
[[package]]
@@ -1575,6 +1592,15 @@ dependencies = [
"tempfile",
]
+[[package]]
+name = "codex-experimental-api-macros"
+version = "0.0.0"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn 2.0.114",
+]
+
[[package]]
name = "codex-feedback"
version = "0.0.0"
@@ -1614,7 +1640,7 @@ dependencies = [
"schemars 0.8.22",
"serde",
"tempfile",
- "thiserror 2.0.17",
+ "thiserror 2.0.18",
"ts-rs",
"walkdir",
]
@@ -1763,7 +1789,7 @@ dependencies = [
"codex-protocol",
"codex-utils-absolute-path",
"eventsource-stream",
- "http 1.3.1",
+ "http 1.4.0",
"opentelemetry",
"opentelemetry-appender-tracing",
"opentelemetry-otlp",
@@ -1774,8 +1800,9 @@ dependencies = [
"serde",
"serde_json",
"strum_macros 0.27.2",
- "thiserror 2.0.17",
+ "thiserror 2.0.18",
"tokio",
+ "tokio-tungstenite",
"tracing",
"tracing-opentelemetry",
"tracing-subscriber",
@@ -1842,7 +1869,7 @@ dependencies = [
"codex-keyring-store",
"codex-protocol",
"codex-utils-cargo-bin",
- "dirs",
+ "codex-utils-home-dir",
"futures",
"keyring",
"mcp-types",
@@ -1874,6 +1901,7 @@ dependencies = [
"codex-otel",
"codex-protocol",
"dirs",
+ "log",
"owo-colors",
"pretty_assertions",
"serde",
@@ -1955,11 +1983,11 @@ dependencies = [
"supports-color 3.0.2",
"tempfile",
"textwrap 0.16.2",
- "thiserror 2.0.17",
+ "thiserror 2.0.18",
"tokio",
"tokio-stream",
"tokio-util",
- "toml 0.9.5",
+ "toml 0.9.11+spec-1.1.0",
"tracing",
"tracing-appender",
"tracing-subscriber",
@@ -2004,7 +2032,16 @@ version = "0.0.0"
dependencies = [
"assert_cmd",
"runfiles",
- "thiserror 2.0.17",
+ "thiserror 2.0.18",
+]
+
+[[package]]
+name = "codex-utils-home-dir"
+version = "0.0.0"
+dependencies = [
+ "dirs",
+ "pretty_assertions",
+ "tempfile",
]
[[package]]
@@ -2015,7 +2052,7 @@ dependencies = [
"codex-utils-cache",
"image",
"tempfile",
- "thiserror 2.0.17",
+ "thiserror 2.0.18",
"tokio",
]
@@ -2025,7 +2062,7 @@ version = "0.0.0"
dependencies = [
"pretty_assertions",
"serde_json",
- "toml 0.9.5",
+ "toml 0.9.11+spec-1.1.0",
]
[[package]]
@@ -2050,7 +2087,7 @@ version = "0.0.0"
dependencies = [
"assert_matches",
"async-trait",
- "thiserror 2.0.17",
+ "thiserror 2.0.18",
"time",
"tokio",
]
@@ -2382,9 +2419,9 @@ checksum = "460fbee9c2c2f33933d720630a6a0bac33ba7053db5344fac858d4b8952d77d5"
[[package]]
name = "crypto-common"
-version = "0.1.6"
+version = "0.1.7"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "1bfb12502f3fc46cca1bb51ac28df9d618d813cdc3d2f25b9fe775a34af26bb3"
+checksum = "78c8292055d1c1df0cce5d180393dc8cce0abec0a7102adb6c7b1eef6016d60a"
dependencies = [
"generic-array",
"typenum",
@@ -2437,16 +2474,6 @@ version = "0.0.7"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "52560adf09603e58c9a7ee1fe1dcb95a16927b17c127f0ac02d6e768a0e25bc1"
-[[package]]
-name = "darling"
-version = "0.20.11"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "fc7f46116c46ff9ab3eb1597a45688b6715c6e628b5c133e288e709a29bcb4ee"
-dependencies = [
- "darling_core 0.20.11",
- "darling_macro 0.20.11",
-]
-
[[package]]
name = "darling"
version = "0.21.3"
@@ -2467,20 +2494,6 @@ dependencies = [
"darling_macro 0.23.0",
]
-[[package]]
-name = "darling_core"
-version = "0.20.11"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "0d00b9596d185e565c2207a0b01f8bd1a135483d02d9b7b0a54b11da8d53412e"
-dependencies = [
- "fnv",
- "ident_case",
- "proc-macro2",
- "quote",
- "strsim 0.11.1",
- "syn 2.0.104",
-]
-
[[package]]
name = "darling_core"
version = "0.21.3"
@@ -2492,7 +2505,7 @@ dependencies = [
"proc-macro2",
"quote",
"strsim 0.11.1",
- "syn 2.0.104",
+ "syn 2.0.114",
]
[[package]]
@@ -2505,18 +2518,7 @@ dependencies = [
"proc-macro2",
"quote",
"strsim 0.11.1",
- "syn 2.0.104",
-]
-
-[[package]]
-name = "darling_macro"
-version = "0.20.11"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "fc34b93ccb385b40dc71c6fceac4b2ad23662c7eeb248cf10d529b7e055b6ead"
-dependencies = [
- "darling_core 0.20.11",
- "quote",
- "syn 2.0.104",
+ "syn 2.0.114",
]
[[package]]
@@ -2527,7 +2529,7 @@ checksum = "d38308df82d1080de0afee5d069fa14b0326a88c14f15c5ccda35b4a6c414c81"
dependencies = [
"darling_core 0.21.3",
"quote",
- "syn 2.0.104",
+ "syn 2.0.114",
]
[[package]]
@@ -2538,7 +2540,7 @@ checksum = "ac3984ec7bd6cfa798e62b4a642426a5be0e68f9401cfc2a01e3fa9ea2fcdb8d"
dependencies = [
"darling_core 0.23.0",
"quote",
- "syn 2.0.104",
+ "syn 2.0.114",
]
[[package]]
@@ -2549,9 +2551,9 @@ checksum = "d7a1e2f27636f116493b8b860f5546edb47c8d8f8ea73e1d2a20be88e28d1fea"
[[package]]
name = "dbus"
-version = "0.9.9"
+version = "0.9.10"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "190b6255e8ab55a7b568df5a883e9497edc3e4821c06396612048b430e5ad1e9"
+checksum = "21b3aa68d7e7abee336255bd7248ea965cc393f3e70411135a6f6a4b651345d4"
dependencies = [
"libc",
"libdbus-sys",
@@ -2628,9 +2630,9 @@ dependencies = [
[[package]]
name = "deranged"
-version = "0.5.4"
+version = "0.5.5"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "a41953f86f8a05768a6cda24def994fd2f424b04ec5c719cf89989779f199071"
+checksum = "ececcb659e7ba858fb4f10388c250a7252eb0a27373f1a72b8748afdd248e587"
dependencies = [
"powerfmt",
"serde_core",
@@ -2674,7 +2676,7 @@ dependencies = [
"convert_case 0.6.0",
"proc-macro2",
"quote",
- "syn 2.0.104",
+ "syn 2.0.114",
"unicode-xid",
]
@@ -2688,7 +2690,7 @@ dependencies = [
"proc-macro2",
"quote",
"rustc_version",
- "syn 2.0.104",
+ "syn 2.0.114",
"unicode-xid",
]
@@ -2752,8 +2754,8 @@ checksum = "e01a3366d27ee9890022452ee61b2b63a67e6f13f58900b651ff5665f0bb1fab"
dependencies = [
"libc",
"option-ext",
- "redox_users 0.5.0",
- "windows-sys 0.61.1",
+ "redox_users 0.5.2",
+ "windows-sys 0.61.2",
]
[[package]]
@@ -2795,15 +2797,9 @@ checksum = "97369cbbc041bc366949bc74d34658d6cda5621039731c6310521892a3a20ae0"
dependencies = [
"proc-macro2",
"quote",
- "syn 2.0.104",
+ "syn 2.0.114",
]
-[[package]]
-name = "doc-comment"
-version = "0.3.3"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "fea41bba32d969b513997752735605054bc0dfa92b4c56bf1189f2e174be7a10"
-
[[package]]
name = "dotenvy"
version = "0.15.7"
@@ -2818,9 +2814,9 @@ checksum = "75b325c5dbd37f80359721ad39aca5a29fb04c89279657cffdda8736d0c0b9d2"
[[package]]
name = "dtor"
-version = "0.1.0"
+version = "0.1.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "e58a0764cddb55ab28955347b45be00ade43d4d6f3ba4bf3dc354e4ec9432934"
+checksum = "404d02eeb088a82cfd873006cb713fe411306c7d182c344905e101fb1167d301"
dependencies = [
"dtor-proc-macro",
]
@@ -2854,14 +2850,14 @@ checksum = "83e195b4945e88836d826124af44fdcb262ec01ef94d44f14f4fb5103f19892a"
dependencies = [
"proc-macro2",
"quote",
- "syn 2.0.104",
+ "syn 2.0.114",
]
[[package]]
name = "dyn-clone"
-version = "1.0.19"
+version = "1.0.20"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "1c7a8fb8a9fbf66c1f703fe16184d10ca0ee9d23be5b4436400408ba54a95005"
+checksum = "d0881ea181b1df73ff77ffaaf9c7544ecc11e82fba9b5f27b262a3c73a332555"
[[package]]
name = "either"
@@ -2898,9 +2894,9 @@ dependencies = [
[[package]]
name = "endi"
-version = "1.1.0"
+version = "1.1.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "a3d8a32ae18130a3c84dd492d4215c3d913c3b07c6b63c2eb3eb7ff1101ab7bf"
+checksum = "66b7e2430c6dff6a955451e2cfc438f09cea1965a9d6f87f7e3b90decc014099"
[[package]]
name = "endian-type"
@@ -2923,7 +2919,7 @@ dependencies = [
"heck",
"proc-macro2",
"quote",
- "syn 2.0.104",
+ "syn 2.0.114",
]
[[package]]
@@ -2944,7 +2940,7 @@ checksum = "67c78a4d8fdf9953a5c9d458f9efe940fd97a0cab0941c075a813ac594733827"
dependencies = [
"proc-macro2",
"quote",
- "syn 2.0.104",
+ "syn 2.0.114",
]
[[package]]
@@ -2955,9 +2951,9 @@ checksum = "dbfd0e7fc632dec5e6c9396a27bc9f9975b4e039720e1fd3e34021d3ce28c415"
[[package]]
name = "env_filter"
-version = "0.1.3"
+version = "0.1.4"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "186e05a59d4c50738528153b83b0b0194d3a29507dfec16eccd4b342903397d0"
+checksum = "1bf3c259d255ca70051b30e2e95b5446cdb8949ac4cd22c0d7fd634d89f568e2"
dependencies = [
"log",
"regex",
@@ -2999,12 +2995,12 @@ dependencies = [
[[package]]
name = "errno"
-version = "0.3.13"
+version = "0.3.14"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "778e2ac28f6c47af28e4907f13ffd1e1ddbd400980a9abd7c8df189bf578a5ad"
+checksum = "39cab71617ae0d63f51a36d69f866391735b51691dbda63cf6f96d042b63efeb"
dependencies = [
"libc",
- "windows-sys 0.60.2",
+ "windows-sys 0.61.2",
]
[[package]]
@@ -3026,9 +3022,9 @@ dependencies = [
[[package]]
name = "event-listener"
-version = "5.4.0"
+version = "5.4.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "3492acde4c3fc54c845eaab3eed8bd00c7a7d881f78bfc801e43a93dec1331ae"
+checksum = "e13b66accf52311f30a0db42147dadea9850cb48cd070028831ae5f5d4b856ab"
dependencies = [
"concurrent-queue",
"parking",
@@ -3084,7 +3080,7 @@ version = "2.3.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "37909eebbb50d72f9059c3b6d82c0463f2ff062c9e95845c43a6c9c0355411be"
dependencies = [
- "getrandom 0.2.16",
+ "getrandom 0.2.17",
]
[[package]]
@@ -3104,7 +3100,7 @@ checksum = "a0aca10fb742cb43f9e7bb8467c91aa9bcb8e3ffbc6a6f7389bb93ffc920577d"
dependencies = [
"proc-macro2",
"quote",
- "syn 2.0.104",
+ "syn 2.0.114",
]
[[package]]
@@ -3114,7 +3110,7 @@ source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "0ce92ff622d6dadf7349484f42c93271a0d49b7cc4d466a936405bacbe10aa78"
dependencies = [
"cfg-if",
- "rustix 1.0.8",
+ "rustix 1.1.3",
"windows-sys 0.59.0",
]
@@ -3140,9 +3136,9 @@ dependencies = [
[[package]]
name = "find-msvc-tools"
-version = "0.1.7"
+version = "0.1.9"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f449e6c6c08c865631d4890cfacf252b3d396c9bcc83adb6623cdb02a8336c41"
+checksum = "5baebc0774151f905a1a2cc41989300b1e6fbb29aff0ceffa1064fdd3088d582"
[[package]]
name = "findshlibs"
@@ -3158,9 +3154,9 @@ dependencies = [
[[package]]
name = "fixed_decimal"
-version = "0.7.0"
+version = "0.7.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "35943d22b2f19c0cb198ecf915910a8158e94541c89dcc63300d7799d46c2c5e"
+checksum = "35eabf480f94d69182677e37571d3be065822acfafd12f2f085db44fbbcc8e57"
dependencies = [
"displaydoc",
"smallvec",
@@ -3174,10 +3170,16 @@ source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "0ce7134b9999ecaf8bcd65542e436736ef32ddca1b3e06094cb6ec5755203b80"
[[package]]
-name = "flate2"
-version = "1.1.2"
+name = "fixedbitset"
+version = "0.5.7"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "4a3d7db9596fecd151c5f638c0ee5d5bd487b6e0ea232e5dc96d5250f6f94b1d"
+checksum = "1d674e81391d1e1ab681a28d99df07927c6d4aa5b027d7da16ba32d1d21ecd99"
+
+[[package]]
+name = "flate2"
+version = "1.1.8"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b375d6465b98090a5f25b1c7703f3859783755aa9a80433b36e0379a3ec2f369"
dependencies = [
"crc32fast",
"miniz_oxide",
@@ -3260,7 +3262,7 @@ checksum = "1a5c6c585bc94aaf2c7b51dd4c2ba22680844aba4c687be581871a6f518c5742"
dependencies = [
"proc-macro2",
"quote",
- "syn 2.0.104",
+ "syn 2.0.114",
]
[[package]]
@@ -3277,9 +3279,9 @@ checksum = "aa9a19cbb55df58761df49b23516a86d432839add4af60fc256da840f66ed35b"
[[package]]
name = "form_urlencoded"
-version = "1.2.1"
+version = "1.2.2"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "e13624c2627564efccf4934284bdd98cbaa14e79b0b5a141218e507b3a823456"
+checksum = "cb4cb245038516f5f85277875cdaa4f7d2c9a0fa0468de06ed190163b1581fcf"
dependencies = [
"percent-encoding",
]
@@ -3389,7 +3391,7 @@ checksum = "162ee34ebcb7c64a8abebc059ce0fee27c2262618d7b60ed8faf72fef13c3650"
dependencies = [
"proc-macro2",
"quote",
- "syn 2.0.104",
+ "syn 2.0.114",
]
[[package]]
@@ -3442,8 +3444,8 @@ dependencies = [
"libc",
"log",
"rustversion",
- "windows-link 0.2.0",
- "windows-result 0.3.4",
+ "windows-link",
+ "windows-result 0.4.1",
]
[[package]]
@@ -3458,55 +3460,55 @@ dependencies = [
[[package]]
name = "gethostname"
-version = "0.4.3"
+version = "1.1.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "0176e0459c2e4a1fe232f984bca6890e681076abb9934f6cea7c326f3fc47818"
+checksum = "1bd49230192a3797a9a4d6abe9b3eed6f7fa4c8a8a4947977c6f80025f92cbd8"
dependencies = [
- "libc",
- "windows-targets 0.48.5",
+ "rustix 1.1.3",
+ "windows-link",
]
[[package]]
name = "getopts"
-version = "0.2.23"
+version = "0.2.24"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "cba6ae63eb948698e300f645f87c70f76630d505f23b8907cf1e193ee85048c1"
+checksum = "cfe4fbac503b8d1f88e6676011885f34b7174f46e59956bba534ba83abded4df"
dependencies = [
"unicode-width 0.2.1",
]
[[package]]
name = "getrandom"
-version = "0.2.16"
+version = "0.2.17"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "335ff9f135e4384c8150d6f27c6daed433577f86b4750418338c01a1a2528592"
+checksum = "ff2abc00be7fca6ebc474524697ae276ad847ad0a6b3faa4bcb027e9a4614ad0"
dependencies = [
"cfg-if",
"js-sys",
"libc",
- "wasi 0.11.1+wasi-snapshot-preview1",
+ "wasi",
"wasm-bindgen",
]
[[package]]
name = "getrandom"
-version = "0.3.3"
+version = "0.3.4"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "26145e563e54f2cadc477553f1ec5ee650b00862f0a58bcd12cbdc5f0ea2d2f4"
+checksum = "899def5c37c4fd7b2664648c28120ecec138e4d395b459e5ca34f9cce2dd77fd"
dependencies = [
"cfg-if",
"js-sys",
"libc",
"r-efi",
- "wasi 0.14.2+wasi-0.2.4",
+ "wasip2",
"wasm-bindgen",
]
[[package]]
name = "gimli"
-version = "0.31.1"
+version = "0.32.3"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "07e28edb80900c19c28f1072f2e8aeca7fa06b23cd4169cefe1af5aa3260783f"
+checksum = "e629b9b98ef3dd8afe6ca2bd0f89306cec16d43d907889945bc5d6687f2f13c7"
[[package]]
name = "glob"
@@ -3524,22 +3526,22 @@ dependencies = [
"bstr",
"log",
"regex-automata",
- "regex-syntax 0.8.5",
+ "regex-syntax 0.8.8",
]
[[package]]
name = "h2"
-version = "0.4.11"
+version = "0.4.13"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "17da50a276f1e01e0ba6c029e47b7100754904ee8a278f886546e98575380785"
+checksum = "2f44da3a8150a6703ed5d34e164b875fd14c2cdab9af1252a9a1020bde2bdc54"
dependencies = [
"atomic-waker",
"bytes",
"fnv",
"futures-core",
"futures-sink",
- "http 1.3.1",
- "indexmap 2.12.0",
+ "http 1.4.0",
+ "indexmap 2.13.0",
"slab",
"tokio",
"tokio-util",
@@ -3548,12 +3550,13 @@ dependencies = [
[[package]]
name = "half"
-version = "2.6.0"
+version = "2.7.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "459196ed295495a68f7d7fe1d84f6c4b7ff0e21fe3017b2f283c6fac3ad803c9"
+checksum = "6ea2d84b969582b4b1864a92dc5d27cd2b77b622a8d79306834f1be5ba20d84b"
dependencies = [
"cfg-if",
"crunchy",
+ "zerocopy",
]
[[package]]
@@ -3574,9 +3577,9 @@ dependencies = [
[[package]]
name = "hashbrown"
-version = "0.15.4"
+version = "0.15.5"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "5971ac85611da7067dbfcabef3c70ebb5606018acd9e2a3903a0da507521e0d5"
+checksum = "9229cfe53dfd69f0609a49f65461bd93001ea1ef889cd5529dd176593f5338a1"
dependencies = [
"allocator-api2",
"equivalent",
@@ -3585,9 +3588,9 @@ dependencies = [
[[package]]
name = "hashbrown"
-version = "0.16.0"
+version = "0.16.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "5419bdc4f6a9207fbeba6d11b604d481addf78ecd10c11ad51e76c2f6482748d"
+checksum = "841d1cc9bed7f9236f321df977030373f4a4163ae1a7dbfe1a51a2c1a51d9100"
dependencies = [
"allocator-api2",
"equivalent",
@@ -3600,7 +3603,7 @@ version = "0.10.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "7382cf6263419f2d8df38c55d7da83da5c18aef87fc7a7fc1fb1e344edfe14c1"
dependencies = [
- "hashbrown 0.15.4",
+ "hashbrown 0.15.5",
]
[[package]]
@@ -3639,7 +3642,7 @@ dependencies = [
"once_cell",
"rand 0.9.2",
"ring",
- "thiserror 2.0.17",
+ "thiserror 2.0.18",
"tinyvec",
"tokio",
"tracing",
@@ -3662,7 +3665,7 @@ dependencies = [
"rand 0.9.2",
"resolv-conf",
"smallvec",
- "thiserror 2.0.17",
+ "thiserror 2.0.18",
"tokio",
"tracing",
]
@@ -3687,22 +3690,22 @@ dependencies = [
[[package]]
name = "home"
-version = "0.5.11"
+version = "0.5.12"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "589533453244b0995c858700322199b2becb13b627df2851f64a2775d024abcf"
+checksum = "cc627f471c528ff0c4a49e1d5e60450c8f6461dd6d10ba9dcd3a61d3dff7728d"
dependencies = [
- "windows-sys 0.59.0",
+ "windows-sys 0.61.2",
]
[[package]]
name = "hostname"
-version = "0.4.1"
+version = "0.4.2"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "a56f203cd1c76362b69e3863fd987520ac36cf70a8c92627449b2f64a8cf7d65"
+checksum = "617aaa3557aef3810a6369d0a99fac8a080891b68bd9f9812a1eeda0c0730cbd"
dependencies = [
"cfg-if",
"libc",
- "windows-link 0.1.3",
+ "windows-link",
]
[[package]]
@@ -3718,12 +3721,11 @@ dependencies = [
[[package]]
name = "http"
-version = "1.3.1"
+version = "1.4.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f4a85d31aea989eead29a3aaf9e1115a180df8282431156e533de47660892565"
+checksum = "e3ba2a386d7f85a81f119ad7498ebe444d2e22c2af0b86b069416ace48b3311a"
dependencies = [
"bytes",
- "fnv",
"itoa",
]
@@ -3734,7 +3736,7 @@ source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "1efedce1fb8e6913f23e0c92de8e62cd5b772a67e7b3946df930a62566c93184"
dependencies = [
"bytes",
- "http 1.3.1",
+ "http 1.4.0",
]
[[package]]
@@ -3745,7 +3747,7 @@ checksum = "b021d93e26becf5dc7e1b75b1bed1fd93124b374ceb73f43d4d4eafec896a64a"
dependencies = [
"bytes",
"futures-core",
- "http 1.3.1",
+ "http 1.4.0",
"http-body",
"pin-project-lite",
]
@@ -3770,16 +3772,16 @@ checksum = "df3b46402a9d5adb4c86a0cf463f42e19994e3ee891101b1841f30a545cb49a9"
[[package]]
name = "hyper"
-version = "1.7.0"
+version = "1.8.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "eb3aa54a13a0dfe7fbe3a59e0c76093041720fdc77b110cc0fc260fafb4dc51e"
+checksum = "2ab2d4f250c3d7b1c9fcdff1cece94ea4e2dfbec68614f7b87cb205f24ca9d11"
dependencies = [
"atomic-waker",
"bytes",
"futures-channel",
"futures-core",
"h2",
- "http 1.3.1",
+ "http 1.4.0",
"http-body",
"httparse",
"httpdate",
@@ -3797,7 +3799,7 @@ version = "0.27.7"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "e3c93eb611681b207e1fe55d5a71ecf91572ec8a6705cdb6857f7d8d5242cf58"
dependencies = [
- "http 1.3.1",
+ "http 1.4.0",
"hyper",
"hyper-util",
"rustls",
@@ -3806,7 +3808,7 @@ dependencies = [
"tokio",
"tokio-rustls",
"tower-service",
- "webpki-roots 1.0.2",
+ "webpki-roots 1.0.5",
]
[[package]]
@@ -3840,23 +3842,23 @@ dependencies = [
[[package]]
name = "hyper-util"
-version = "0.1.16"
+version = "0.1.19"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "8d9b05277c7e8da2c93a568989bb6207bef0112e8d17df7a6eda4a3cf143bc5e"
+checksum = "727805d60e7938b76b826a6ef209eb70eaa1812794f9424d4a4e2d740662df5f"
dependencies = [
"base64",
"bytes",
"futures-channel",
"futures-core",
"futures-util",
- "http 1.3.1",
+ "http 1.4.0",
"http-body",
"hyper",
"ipnet",
"libc",
"percent-encoding",
"pin-project-lite",
- "socket2 0.6.1",
+ "socket2 0.6.2",
"system-configuration",
"tokio",
"tower-service",
@@ -3866,9 +3868,9 @@ dependencies = [
[[package]]
name = "iana-time-zone"
-version = "0.1.63"
+version = "0.1.65"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "b0c919e5debc312ad217002b8048a17b7d83f80703865bbfcfebb0458b0b27d8"
+checksum = "e31bc9ad994ba00e440a8aa5c9ef0ec67d5cb5e5cb0cc7f8b744a35b389cc470"
dependencies = [
"android_system_properties",
"core-foundation-sys",
@@ -3876,7 +3878,7 @@ dependencies = [
"js-sys",
"log",
"wasm-bindgen",
- "windows-core 0.61.2",
+ "windows-core 0.62.2",
]
[[package]]
@@ -3953,9 +3955,9 @@ dependencies = [
[[package]]
name = "icu_locale_data"
-version = "2.1.1"
+version = "2.1.2"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f03e2fcaefecdf05619f3d6f91740e79ab969b4dd54f77cbf546b1d0d28e3147"
+checksum = "1c5f1d16b4c3a2642d3a719f18f6b06070ab0aef246a6418130c955ae08aa831"
[[package]]
name = "icu_normalizer"
@@ -3979,9 +3981,9 @@ checksum = "7aedcccd01fc5fe81e6b489c15b247b8b0690feb23304303a9e560f37efc560a"
[[package]]
name = "icu_properties"
-version = "2.1.1"
+version = "2.1.2"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "e93fcd3157766c0c8da2f8cff6ce651a31f0810eaa1c51ec363ef790bbb5fb99"
+checksum = "020bfc02fe870ec3a66d93e677ccca0562506e5872c650f893269e08615d74ec"
dependencies = [
"icu_collections",
"icu_locale_core",
@@ -3993,9 +3995,9 @@ dependencies = [
[[package]]
name = "icu_properties_data"
-version = "2.1.1"
+version = "2.1.2"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "02845b3647bb045f1100ecd6480ff52f34c35f82d9880e029d329c21d1054899"
+checksum = "616c294cf8d725c6afcd8f55abc17c56464ef6211f9ed59cccffe534129c77af"
[[package]]
name = "icu_provider"
@@ -4022,9 +4024,9 @@ checksum = "b9e0384b61958566e926dc50660321d12159025e767c18e043daf26b70104c39"
[[package]]
name = "idna"
-version = "1.0.3"
+version = "1.1.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "686f825264d630750a544639377bae737628043f20d38bbc029e8f29ea968a7e"
+checksum = "3b0875f23caa03898994f6ddc501886a45c7d3d62d04d2d90788d47be1b1e4de"
dependencies = [
"idna_adapter",
"smallvec",
@@ -4043,9 +4045,9 @@ dependencies = [
[[package]]
name = "ignore"
-version = "0.4.23"
+version = "0.4.25"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "6d89fd380afde86567dfba715db065673989d6253f42b88179abd3eae47bda4b"
+checksum = "d3d782a365a015e0f5c04902246139249abf769125006fbe7649e2ee88169b4a"
dependencies = [
"crossbeam-deque",
"globset",
@@ -4069,8 +4071,8 @@ dependencies = [
"num-traits",
"png",
"tiff",
- "zune-core 0.5.0",
- "zune-jpeg 0.5.5",
+ "zune-core 0.5.1",
+ "zune-jpeg 0.5.12",
]
[[package]]
@@ -4100,9 +4102,9 @@ dependencies = [
[[package]]
name = "indenter"
-version = "0.3.3"
+version = "0.3.4"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "ce23b50ad8242c51a442f3ff322d56b02f08852c77e4c0b4d3fd684abc89c683"
+checksum = "964de6e86d545b246d84badc0fef527924ace5134f30641c203ef52ba83f58d5"
[[package]]
name = "indexmap"
@@ -4117,21 +4119,24 @@ dependencies = [
[[package]]
name = "indexmap"
-version = "2.12.0"
+version = "2.13.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "6717a8d2a5a929a1a2eb43a12812498ed141a0bcfb7e8f7844fbdbe4303bba9f"
+checksum = "7714e70437a7dc3ac8eb7e6f8df75fd8eb422675fc7678aff7364301092b1017"
dependencies = [
"equivalent",
- "hashbrown 0.16.0",
+ "hashbrown 0.16.1",
"serde",
"serde_core",
]
[[package]]
name = "indoc"
-version = "2.0.6"
+version = "2.0.7"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f4c7245a08504955605670dbf141fceab975f15ca21570696aebe9d2e71576bd"
+checksum = "79cf5c93f93228cf8efb3ba362535fb11199ac548a09ce117c9b1adc3030d706"
+dependencies = [
+ "rustversion",
+]
[[package]]
name = "inotify"
@@ -4165,9 +4170,9 @@ dependencies = [
[[package]]
name = "insta"
-version = "1.46.0"
+version = "1.46.2"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "1b66886d14d18d420ab5052cbff544fc5d34d0b2cdd35eb5976aaa10a4a472e5"
+checksum = "38c91d64f9ad425e80200a50a0e8b8a641680b44e33ce832efe5b8bc65161b07"
dependencies = [
"console",
"once_cell",
@@ -4177,22 +4182,22 @@ dependencies = [
[[package]]
name = "instability"
-version = "0.3.9"
+version = "0.3.11"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "435d80800b936787d62688c927b6490e887c7ef5ff9ce922c6c6050fca75eb9a"
+checksum = "357b7205c6cd18dd2c86ed312d1e70add149aea98e7ef72b9fdf0270e555c11d"
dependencies = [
- "darling 0.20.11",
+ "darling 0.23.0",
"indoc",
"proc-macro2",
"quote",
- "syn 2.0.104",
+ "syn 2.0.114",
]
[[package]]
name = "inventory"
-version = "0.3.20"
+version = "0.3.21"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "ab08d7cd2c5897f2c949e5383ea7c7db03fb19130ffcfbf7eda795137ae3cb83"
+checksum = "bc61209c082fbeb19919bee74b176221b27223e27b65d781eb91af24eb1fb46e"
dependencies = [
"rustversion",
]
@@ -4217,9 +4222,9 @@ checksum = "469fb0b9cefa57e3ef31275ee7cacb78f2fdca44e4765491884a2b119d4eb130"
[[package]]
name = "iri-string"
-version = "0.7.8"
+version = "0.7.10"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "dbc5ebe9c3a1a7a5127f920a418f7585e9e758e911d0466ed004f393b0e380b2"
+checksum = "c91338f0783edbd6195decb37bae672fd3b165faffb89bf7b9e6942f8b1a731a"
dependencies = [
"memchr",
"serde",
@@ -4227,13 +4232,13 @@ dependencies = [
[[package]]
name = "is-terminal"
-version = "0.4.16"
+version = "0.4.17"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "e04d7f318608d35d4b61ddd75cbdaee86b023ebe2bd5a66ee0915f0bf93095a9"
+checksum = "3640c1c38b8e4e43584d8df18be5fc6b0aa314ce6ebf51b53313d4306cca8e46"
dependencies = [
"hermit-abi",
"libc",
- "windows-sys 0.59.0",
+ "windows-sys 0.61.2",
]
[[package]]
@@ -4244,9 +4249,9 @@ checksum = "7655c9839580ee829dfacba1d1278c2b7883e50a277ff7541299489d6bdfdc45"
[[package]]
name = "is_terminal_polyfill"
-version = "1.70.1"
+version = "1.70.2"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "7943c866cc5cd64cbc25b2e01621d07fa8eb2a1a23160ee81ce38704e97b8ecf"
+checksum = "a6cb138bb79a146c1bd460005623e142ef0181e3d0219cb493e02f7d08a35695"
[[package]]
name = "itertools"
@@ -4277,32 +4282,32 @@ dependencies = [
[[package]]
name = "itoa"
-version = "1.0.15"
+version = "1.0.17"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "4a5f13b858c8d314ee3e8f639011f7ccefe71f97f96e50151fb991f267928e2c"
+checksum = "92ecc6618181def0457392ccd0ee51198e065e016d1d527a7ac1b6dc7c1f09d2"
[[package]]
name = "jiff"
-version = "0.2.15"
+version = "0.2.18"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "be1f93b8b1eb69c77f24bbb0afdf66f54b632ee39af40ca21c4365a1d7347e49"
+checksum = "e67e8da4c49d6d9909fe03361f9b620f58898859f5c7aded68351e85e71ecf50"
dependencies = [
"jiff-static",
"log",
"portable-atomic",
"portable-atomic-util",
- "serde",
+ "serde_core",
]
[[package]]
name = "jiff-static"
-version = "0.2.15"
+version = "0.2.18"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "03343451ff899767262ec32146f6d559dd759fdadf42ff0e227c7c48f72594b4"
+checksum = "e0c84ee7f197eca9a86c6fd6cb771e55eb991632f15f2bc3ca6ec838929e6e78"
dependencies = [
"proc-macro2",
"quote",
- "syn 2.0.104",
+ "syn 2.0.114",
]
[[package]]
@@ -4333,15 +4338,15 @@ version = "0.1.34"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "9afb3de4395d6b3e67a780b6de64b51c978ecf11cb9a462c66be7d4ca9039d33"
dependencies = [
- "getrandom 0.3.3",
+ "getrandom 0.3.4",
"libc",
]
[[package]]
name = "js-sys"
-version = "0.3.77"
+version = "0.3.85"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "1cfaf33c695fc6e08064efbc1f72ec937429614f25eef83af942d0e227c3a28f"
+checksum = "8c942ebf8e95485ca0d52d97da7c5a2c387d0e7f0ba4c35e93bfcaee045955b3"
dependencies = [
"once_cell",
"wasm-bindgen",
@@ -4398,7 +4403,7 @@ dependencies = [
"is-terminal",
"itertools 0.10.5",
"lalrpop-util",
- "petgraph",
+ "petgraph 0.6.5",
"regex",
"regex-syntax 0.6.29",
"string_cache",
@@ -4424,7 +4429,7 @@ checksum = "49fefd6652c57d68aaa32544a4c0e642929725bdc1fd929367cdeb673ab81088"
dependencies = [
"enumflags2",
"libc",
- "thiserror 2.0.17",
+ "thiserror 2.0.18",
]
[[package]]
@@ -4444,15 +4449,15 @@ dependencies = [
[[package]]
name = "libc"
-version = "0.2.177"
+version = "0.2.180"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "2874a2af47a2325c2001a6e6fad9b16a53b802102b528163885171cf92b15976"
+checksum = "bcc35a38544a891a5f7c865aca548a982ccb3b8650a5b06d0fd33a10283c56fc"
[[package]]
name = "libdbus-sys"
-version = "0.2.6"
+version = "0.2.7"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "5cbe856efeb50e4681f010e9aaa2bf0a644e10139e54cde10fc83a307c23bd9f"
+checksum = "328c4789d42200f1eeec05bd86c9c13c7f091d2ba9a6ea35acdf51f31bc0f043"
dependencies = [
"pkg-config",
]
@@ -4464,7 +4469,7 @@ source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "d7c4b02199fee7c5d21a5ae7d8cfa79a6ef5bb2fc834d6e9058e89c825efdc55"
dependencies = [
"cfg-if",
- "windows-link 0.2.0",
+ "windows-link",
]
[[package]]
@@ -4475,13 +4480,13 @@ checksum = "b6d2cec3eae94f9f509c767b45932f1ada8350c4bdb85af2fcab4a3c14807981"
[[package]]
name = "libredox"
-version = "0.1.6"
+version = "0.1.12"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "4488594b9328dee448adb906d8b126d9b7deb7cf5c22161ee591610bb1be83c0"
+checksum = "3d0b95e02c851351f877147b7deea7b1afb1df71b63aa5f8270716e0c5720616"
dependencies = [
"bitflags 2.10.0",
"libc",
- "redox_syscall",
+ "redox_syscall 0.7.0",
]
[[package]]
@@ -4513,15 +4518,15 @@ checksum = "d26c52dbd32dccf2d10cac7725f8eae5296885fb5703b261f7d0a0739ec807ab"
[[package]]
name = "linux-raw-sys"
-version = "0.9.4"
+version = "0.11.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "cd945864f07fe9f5371a27ad7b52a172b4b499999f1d97574c9fa68373937e12"
+checksum = "df1d3c3b53da64cf5760482273a98e575c651a67eec7f77df96b5b642de8f039"
[[package]]
name = "litemap"
-version = "0.8.0"
+version = "0.8.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "241eaef5fd12c88705a01fc1066c48c4b36e0dd4377dcdc7ec3942cea7a69956"
+checksum = "6373607a59f0be73a39b6fe456b8192fcc3585f602af20751600e974dd455e77"
[[package]]
name = "local-waker"
@@ -4531,11 +4536,10 @@ checksum = "4d873d7c67ce09b42110d801813efbc9364414e356be9935700d368351657487"
[[package]]
name = "lock_api"
-version = "0.4.13"
+version = "0.4.14"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "96936507f153605bddfcda068dd804796c84324ed2510809e5b2a624c81da765"
+checksum = "224399e74b87b5f3557511d98dff8b14089b3dadafcab6bb93eab67d3aace965"
dependencies = [
- "autocfg",
"scopeguard",
]
@@ -4590,7 +4594,7 @@ version = "0.12.5"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "234cf4f4a04dc1f57e24b96cc0cd600cf2af460d4161ac5ecdd0af8e1f3b2a38"
dependencies = [
- "hashbrown 0.15.4",
+ "hashbrown 0.15.5",
]
[[package]]
@@ -4599,7 +4603,7 @@ version = "0.16.3"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "a1dc47f592c06f33f8e3aea9591776ec7c9f9e4124778ff8a3c3b87159f7e593"
dependencies = [
- "hashbrown 0.16.0",
+ "hashbrown 0.16.1",
]
[[package]]
@@ -4695,9 +4699,9 @@ checksum = "ae960838283323069879657ca3de837e9f7bbb4c7bf6ea7f1b290d5e9476d2e0"
[[package]]
name = "memchr"
-version = "2.7.5"
+version = "2.7.6"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "32a282da65faaf38286cf3be983213fcf1d2e2a58700e808f83f4ea9a4804bc0"
+checksum = "f52b00d39961fc5b2736ea853c9cc86238e165017a493d1d5c8eac6bdc4cc273"
[[package]]
name = "memoffset"
@@ -4751,21 +4755,21 @@ dependencies = [
[[package]]
name = "mio"
-version = "1.0.4"
+version = "1.1.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "78bed444cc8a2160f01cbcf811ef18cac863ad68ae8ca62092e8db51d51c761c"
+checksum = "a69bcab0ad47271a0234d9422b131806bf3968021e5dc9328caf2d4cd58557fc"
dependencies = [
"libc",
"log",
- "wasi 0.11.1+wasi-snapshot-preview1",
- "windows-sys 0.59.0",
+ "wasi",
+ "windows-sys 0.61.2",
]
[[package]]
name = "moka"
-version = "0.12.12"
+version = "0.12.13"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "a3dec6bd31b08944e08b58fd99373893a6c17054d6f3ea5006cc894f4f4eee2a"
+checksum = "b4ac832c50ced444ef6be0767a008b02c106a909ba79d1d830501e94b96f6b7e"
dependencies = [
"crossbeam-channel",
"crossbeam-epoch",
@@ -4780,9 +4784,9 @@ dependencies = [
[[package]]
name = "moxcms"
-version = "0.7.5"
+version = "0.7.11"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "ddd32fa8935aeadb8a8a6b6b351e40225570a37c43de67690383d87ef170cd08"
+checksum = "ac9557c559cd6fc9867e122e20d2cbefc9ca29d80d027a8e39310920ed2f0a97"
dependencies = [
"num-traits",
"pxfm",
@@ -4806,7 +4810,7 @@ dependencies = [
"libc",
"log",
"openssl",
- "openssl-probe",
+ "openssl-probe 0.1.6",
"openssl-sys",
"schannel",
"security-framework 2.11.1",
@@ -4917,17 +4921,20 @@ dependencies = [
[[package]]
name = "notify-types"
-version = "2.0.0"
+version = "2.1.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "5e0826a989adedc2a244799e823aece04662b66609d96af8dff7ac6df9a8925d"
+checksum = "42b8cfee0e339a0337359f3c88165702ac6e600dc01c0cc9579a92d62b08477a"
+dependencies = [
+ "bitflags 2.10.0",
+]
[[package]]
name = "nu-ansi-term"
-version = "0.50.1"
+version = "0.50.3"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "d4a28e057d01f97e61255210fcff094d74ed0466038633e95017f5beb68e4399"
+checksum = "7957b9740744892f114936ab4a57b3f487491bbeafaf8083688b16841a4240e5"
dependencies = [
- "windows-sys 0.52.0",
+ "windows-sys 0.61.2",
]
[[package]]
@@ -5000,9 +5007,9 @@ dependencies = [
[[package]]
name = "num-conv"
-version = "0.1.0"
+version = "0.2.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "51d515d32fb182ee37cda2ccdcb92950d6a3c2893aa280e540671c2cd0f3b1d9"
+checksum = "cf97ec579c3c42f953ef76dbf8d55ac91fb219dde70e49aa4a6b7d74e9919050"
[[package]]
name = "num-integer"
@@ -5072,8 +5079,8 @@ checksum = "51e219e79014df21a225b1860a479e2dcd7cbd9130f4defd4bd0e191ea31d67d"
dependencies = [
"base64",
"chrono",
- "getrandom 0.2.16",
- "http 1.3.1",
+ "getrandom 0.2.17",
+ "http 1.4.0",
"rand 0.8.5",
"reqwest",
"serde",
@@ -5086,18 +5093,18 @@ dependencies = [
[[package]]
name = "objc2"
-version = "0.6.2"
+version = "0.6.3"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "561f357ba7f3a2a61563a186a163d0a3a5247e1089524a3981d49adb775078bc"
+checksum = "b7c2599ce0ec54857b29ce62166b0ed9b4f6f1a70ccc9a71165b6154caca8c05"
dependencies = [
"objc2-encode",
]
[[package]]
name = "objc2-app-kit"
-version = "0.3.1"
+version = "0.3.2"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "e6f29f568bec459b0ddff777cec4fe3fd8666d82d5a40ebd0ff7e66134f89bcc"
+checksum = "d49e936b501e5c5bf01fda3a9452ff86dc3ea98ad5f283e1455153142d97518c"
dependencies = [
"bitflags 2.10.0",
"objc2",
@@ -5106,10 +5113,31 @@ dependencies = [
]
[[package]]
-name = "objc2-core-foundation"
-version = "0.3.1"
+name = "objc2-cloud-kit"
+version = "0.3.2"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "1c10c2894a6fed806ade6027bcd50662746363a9589d3ec9d9bef30a4e4bc166"
+checksum = "73ad74d880bb43877038da939b7427bba67e9dd42004a18b809ba7d87cee241c"
+dependencies = [
+ "bitflags 2.10.0",
+ "objc2",
+ "objc2-foundation",
+]
+
+[[package]]
+name = "objc2-core-data"
+version = "0.3.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0b402a653efbb5e82ce4df10683b6b28027616a2715e90009947d50b8dd298fa"
+dependencies = [
+ "objc2",
+ "objc2-foundation",
+]
+
+[[package]]
+name = "objc2-core-foundation"
+version = "0.3.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "2a180dd8642fa45cdb7dd721cd4c11b1cadd4929ce112ebd8b9f5803cc79d536"
dependencies = [
"bitflags 2.10.0",
"dispatch2",
@@ -5118,9 +5146,9 @@ dependencies = [
[[package]]
name = "objc2-core-graphics"
-version = "0.3.1"
+version = "0.3.2"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "989c6c68c13021b5c2d6b71456ebb0f9dc78d752e86a98da7c716f4f9470f5a4"
+checksum = "e022c9d066895efa1345f8e33e584b9f958da2fd4cd116792e15e07e4720a807"
dependencies = [
"bitflags 2.10.0",
"dispatch2",
@@ -5129,6 +5157,38 @@ dependencies = [
"objc2-io-surface",
]
+[[package]]
+name = "objc2-core-image"
+version = "0.3.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e5d563b38d2b97209f8e861173de434bd0214cf020e3423a52624cd1d989f006"
+dependencies = [
+ "objc2",
+ "objc2-foundation",
+]
+
+[[package]]
+name = "objc2-core-location"
+version = "0.3.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ca347214e24bc973fc025fd0d36ebb179ff30536ed1f80252706db19ee452009"
+dependencies = [
+ "objc2",
+ "objc2-foundation",
+]
+
+[[package]]
+name = "objc2-core-text"
+version = "0.3.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0cde0dfb48d25d2b4862161a4d5fcc0e3c24367869ad306b0c9ec0073bfed92d"
+dependencies = [
+ "bitflags 2.10.0",
+ "objc2",
+ "objc2-core-foundation",
+ "objc2-core-graphics",
+]
+
[[package]]
name = "objc2-encode"
version = "4.1.0"
@@ -5137,20 +5197,22 @@ checksum = "ef25abbcd74fb2609453eb695bd2f860d389e457f67dc17cafc8b8cbc89d0c33"
[[package]]
name = "objc2-foundation"
-version = "0.3.1"
+version = "0.3.2"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "900831247d2fe1a09a683278e5384cfb8c80c79fe6b166f9d14bfdde0ea1b03c"
+checksum = "e3e0adef53c21f888deb4fa59fc59f7eb17404926ee8a6f59f5df0fd7f9f3272"
dependencies = [
"bitflags 2.10.0",
+ "block2",
+ "libc",
"objc2",
"objc2-core-foundation",
]
[[package]]
name = "objc2-io-surface"
-version = "0.3.1"
+version = "0.3.2"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "7282e9ac92529fa3457ce90ebb15f4ecbc383e8338060960760fa2cf75420c3c"
+checksum = "180788110936d59bab6bd83b6060ffdfffb3b922ba1396b312ae795e1de9d81d"
dependencies = [
"bitflags 2.10.0",
"objc2",
@@ -5158,10 +5220,53 @@ dependencies = [
]
[[package]]
-name = "object"
-version = "0.36.7"
+name = "objc2-quartz-core"
+version = "0.3.2"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "62948e14d923ea95ea2c7c86c71013138b66525b86bdc08d2dcc262bdb497b87"
+checksum = "96c1358452b371bf9f104e21ec536d37a650eb10f7ee379fff67d2e08d537f1f"
+dependencies = [
+ "bitflags 2.10.0",
+ "objc2",
+ "objc2-core-foundation",
+ "objc2-foundation",
+]
+
+[[package]]
+name = "objc2-ui-kit"
+version = "0.3.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d87d638e33c06f577498cbcc50491496a3ed4246998a7fbba7ccb98b1e7eab22"
+dependencies = [
+ "bitflags 2.10.0",
+ "block2",
+ "objc2",
+ "objc2-cloud-kit",
+ "objc2-core-data",
+ "objc2-core-foundation",
+ "objc2-core-graphics",
+ "objc2-core-image",
+ "objc2-core-location",
+ "objc2-core-text",
+ "objc2-foundation",
+ "objc2-quartz-core",
+ "objc2-user-notifications",
+]
+
+[[package]]
+name = "objc2-user-notifications"
+version = "0.3.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9df9128cbbfef73cda168416ccf7f837b62737d748333bfe9ab71c245d76613e"
+dependencies = [
+ "objc2",
+ "objc2-foundation",
+]
+
+[[package]]
+name = "object"
+version = "0.37.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ff76201f031d8863c38aa7f905eca4f53abbfa15f609db4277d44cd8938f33fe"
dependencies = [
"memchr",
]
@@ -5178,15 +5283,15 @@ dependencies = [
[[package]]
name = "once_cell_polyfill"
-version = "1.70.1"
+version = "1.70.2"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "a4895175b425cb1f87721b59f0f286c2092bd4af812243672510e1ac53e2e0ad"
+checksum = "384b8ab6d37215f3c5301a95a4accb5d64aa607f1fcb26a11b5303878451b4fe"
[[package]]
name = "openssl"
-version = "0.10.73"
+version = "0.10.75"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "8505734d46c8ab1e19a1dce3aef597ad87dcb4c37e7188231769bd6bd51cebf8"
+checksum = "08838db121398ad17ab8531ce9de97b244589089e290a384c900cb9ff7434328"
dependencies = [
"bitflags 2.10.0",
"cfg-if",
@@ -5205,7 +5310,7 @@ checksum = "a948666b637a0f465e8564c73e89d4dde00d72d4d473cc972f390fc3dcee7d9c"
dependencies = [
"proc-macro2",
"quote",
- "syn 2.0.104",
+ "syn 2.0.114",
]
[[package]]
@@ -5215,10 +5320,16 @@ source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "d05e27ee213611ffe7d6348b942e8f942b37114c00cc03cec254295a4a17852e"
[[package]]
-name = "openssl-src"
-version = "300.5.1+3.5.1"
+name = "openssl-probe"
+version = "0.2.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "735230c832b28c000e3bc117119e6466a663ec73506bc0a9907ea4187508e42a"
+checksum = "7c87def4c32ab89d880effc9e097653c8da5d6ef28e6b539d313baaacfbafcbe"
+
+[[package]]
+name = "openssl-src"
+version = "300.5.5+3.5.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "3f1787d533e03597a7934fd0a765f0d28e94ecc5fb7789f8053b1e699a56f709"
dependencies = [
"cc",
]
@@ -5246,7 +5357,7 @@ dependencies = [
"futures-sink",
"js-sys",
"pin-project-lite",
- "thiserror 2.0.17",
+ "thiserror 2.0.18",
"tracing",
]
@@ -5270,7 +5381,7 @@ checksum = "d7a6d09a73194e6b66df7c8f1b680f156d916a1a942abf2de06823dd02b7855d"
dependencies = [
"async-trait",
"bytes",
- "http 1.3.1",
+ "http 1.4.0",
"opentelemetry",
"reqwest",
]
@@ -5281,7 +5392,7 @@ version = "0.31.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "7a2366db2dca4d2ad033cad11e6ee42844fd727007af5ad04a1730f4cb8163bf"
dependencies = [
- "http 1.3.1",
+ "http 1.4.0",
"opentelemetry",
"opentelemetry-http",
"opentelemetry-proto",
@@ -5289,7 +5400,7 @@ dependencies = [
"prost",
"reqwest",
"serde_json",
- "thiserror 2.0.17",
+ "thiserror 2.0.18",
"tokio",
"tonic",
"tracing",
@@ -5330,7 +5441,7 @@ dependencies = [
"opentelemetry",
"percent-encoding",
"rand 0.9.2",
- "thiserror 2.0.17",
+ "thiserror 2.0.18",
"tokio",
"tokio-stream",
]
@@ -5353,31 +5464,35 @@ dependencies = [
[[package]]
name = "os_info"
-version = "3.12.0"
+version = "3.14.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "d0e1ac5fde8d43c34139135df8ea9ee9465394b2d8d20f032d38998f64afffc3"
+checksum = "e4022a17595a00d6a369236fdae483f0de7f0a339960a53118b818238e132224"
dependencies = [
+ "android_system_properties",
"log",
- "plist",
+ "nix 0.30.1",
+ "objc2",
+ "objc2-foundation",
+ "objc2-ui-kit",
"serde",
- "windows-sys 0.52.0",
+ "windows-sys 0.61.2",
]
[[package]]
name = "os_pipe"
-version = "1.2.2"
+version = "1.2.3"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "db335f4760b14ead6290116f2427bf33a14d4f0617d49f78a246de10c1831224"
+checksum = "7d8fae84b431384b68627d0f9b3b1245fcf9f46f6c0e3dc902e9dce64edd1967"
dependencies = [
"libc",
- "windows-sys 0.59.0",
+ "windows-sys 0.61.2",
]
[[package]]
name = "owo-colors"
-version = "4.2.2"
+version = "4.2.3"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "48dd4f4a2c8405440fd0462561f0e5806bd0f77e86f51c761481bdd4018b545e"
+checksum = "9c6901729fa79e91a0913333229e9ca5dc725089d1c363b2f4b4760709dc4a52"
dependencies = [
"supports-color 2.1.0",
"supports-color 3.0.2",
@@ -5391,9 +5506,9 @@ checksum = "f38d5652c16fde515bb1ecef450ab0f6a219d619a7274976324d5e377f7dceba"
[[package]]
name = "parking_lot"
-version = "0.12.4"
+version = "0.12.5"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "70d58bf43669b5795d1576d0641cfb6fbb2057bf629506267a92807158584a13"
+checksum = "93857453250e3077bd71ff98b6a65ea6621a19bb0f559a85248955ac12c45a1a"
dependencies = [
"lock_api",
"parking_lot_core",
@@ -5401,15 +5516,15 @@ dependencies = [
[[package]]
name = "parking_lot_core"
-version = "0.9.11"
+version = "0.9.12"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "bc838d2a56b5b1a6c25f55575dfc605fabb63bb2365f6c2353ef9159aa69e4a5"
+checksum = "2621685985a2ebf1c516881c026032ac7deafcda1a2c9b7850dc81e3dfcb64c1"
dependencies = [
"cfg-if",
"libc",
- "redox_syscall",
+ "redox_syscall 0.5.18",
"smallvec",
- "windows-targets 0.52.6",
+ "windows-link",
]
[[package]]
@@ -5420,9 +5535,9 @@ checksum = "57c0d7b74b563b49d38dae00a0c37d4d6de9b432382b2892f0574ddcae73fd0a"
[[package]]
name = "pastey"
-version = "0.2.0"
+version = "0.2.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "57d6c094ee800037dff99e02cab0eaf3142826586742a270ab3d7a62656bd27a"
+checksum = "b867cad97c0791bbd3aaa6472142568c6c9e8f71937e98379f584cfb0cf35bec"
[[package]]
name = "path-absolutize"
@@ -5459,9 +5574,9 @@ dependencies = [
[[package]]
name = "percent-encoding"
-version = "2.3.1"
+version = "2.3.2"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "e3148f5046208a5d56bcfc03053e3ca6334e51da8dfb19b6cdc8b306fae3283e"
+checksum = "9b4f627cb1b25917193a259e49bdad08f671f8d9708acfd5fe0a8c1455d87220"
[[package]]
name = "petgraph"
@@ -5469,8 +5584,19 @@ version = "0.6.5"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "b4c5cc86750666a3ed20bdaf5ca2a0344f9c67674cae0515bec2da16fbaa47db"
dependencies = [
- "fixedbitset",
- "indexmap 2.12.0",
+ "fixedbitset 0.4.2",
+ "indexmap 2.13.0",
+]
+
+[[package]]
+name = "petgraph"
+version = "0.8.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8701b58ea97060d5e5b155d383a69952a60943f0e6dfe30b04c287beb0b27455"
+dependencies = [
+ "fixedbitset 0.5.7",
+ "hashbrown 0.15.5",
+ "indexmap 2.13.0",
]
[[package]]
@@ -5499,7 +5625,7 @@ checksum = "6e918e4ff8c4549eb882f14b3a4bc8c8bc93de829416eacf579f1207a8fbf861"
dependencies = [
"proc-macro2",
"quote",
- "syn 2.0.104",
+ "syn 2.0.114",
]
[[package]]
@@ -5552,19 +5678,6 @@ version = "0.3.32"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "7edddbd0b52d732b21ad9a5fab5c704c14cd949e5e9a1ec5929a24fded1b904c"
-[[package]]
-name = "plist"
-version = "1.7.4"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "3af6b589e163c5a788fab00ce0c0366f6efbb9959c2f9874b224936af7fce7e1"
-dependencies = [
- "base64",
- "indexmap 2.12.0",
- "quick-xml 0.38.0",
- "serde",
- "time",
-]
-
[[package]]
name = "png"
version = "0.18.0"
@@ -5588,21 +5701,21 @@ dependencies = [
"concurrent-queue",
"hermit-abi",
"pin-project-lite",
- "rustix 1.0.8",
- "windows-sys 0.61.1",
+ "rustix 1.1.3",
+ "windows-sys 0.61.2",
]
[[package]]
name = "portable-atomic"
-version = "1.11.1"
+version = "1.13.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f84267b20a16ea918e43c6a88433c2d54fa145c92a811b5b047ccbe153674483"
+checksum = "c33a9471896f1c69cecef8d20cbe2f7accd12527ce60845ff44c153bb2a21b49"
[[package]]
name = "portable-atomic-util"
-version = "0.2.4"
+version = "0.2.5"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "d8a2f0d8d040d7848a709caf78912debcc3f33ee4b3cac47d73d1e1069e83507"
+checksum = "7a9db96d7fa8782dd8c15ce32ffe8680bbd1e978a43bf51a34d39483540495f5"
dependencies = [
"portable-atomic",
]
@@ -5711,25 +5824,25 @@ dependencies = [
[[package]]
name = "proc-macro2"
-version = "1.0.95"
+version = "1.0.106"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "02b3e5e68a3a1a02aad3ec490a98007cbc13c37cbe84a3cd7b8e406d76e7f778"
+checksum = "8fd00f0bb2e90d81d1044c2b32617f68fcb9fa3bb7640c23e9c748e53fb30934"
dependencies = [
"unicode-ident",
]
[[package]]
name = "process-wrap"
-version = "9.0.0"
+version = "9.0.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "5e5fd83ab7fa55fd06f5e665e3fc52b8bca451c0486b8ea60ad649cd1c10a5da"
+checksum = "fd1395947e69c07400ef4d43db0051d6f773c21f647ad8b97382fc01f0204c60"
dependencies = [
"futures",
- "indexmap 2.12.0",
+ "indexmap 2.13.0",
"nix 0.30.1",
"tokio",
"tracing",
- "windows 0.61.3",
+ "windows 0.62.2",
]
[[package]]
@@ -5743,15 +5856,15 @@ dependencies = [
"rand 0.9.2",
"rand_chacha 0.9.0",
"rand_xorshift",
- "regex-syntax 0.8.5",
+ "regex-syntax 0.8.8",
"unarray",
]
[[package]]
name = "prost"
-version = "0.14.1"
+version = "0.14.3"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "7231bd9b3d3d33c86b58adbac74b5ec0ad9f496b19d22801d773636feaa95f3d"
+checksum = "d2ea70524a2f82d518bce41317d0fae74151505651af45faf1ffbd6fd33f0568"
dependencies = [
"bytes",
"prost-derive",
@@ -5759,22 +5872,22 @@ dependencies = [
[[package]]
name = "prost-derive"
-version = "0.14.1"
+version = "0.14.3"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "9120690fafc389a67ba3803df527d0ec9cbbc9cc45e4cc20b332996dfb672425"
+checksum = "27c6023962132f4b30eb4c172c91ce92d933da334c59c23cddee82358ddafb0b"
dependencies = [
"anyhow",
"itertools 0.14.0",
"proc-macro2",
"quote",
- "syn 2.0.104",
+ "syn 2.0.114",
]
[[package]]
name = "psl"
-version = "2.1.178"
+version = "2.1.184"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "5a54161bdf033552d905f5e653fb6263690e63df54745ad5199a5f8fa802a0d6"
+checksum = "81dc6a90669f481b41cae3005c68efa36bef275b95aa9123a7af7f1c68c6e5b2"
dependencies = [
"psl-types",
]
@@ -5806,9 +5919,9 @@ checksum = "bd348ff538bc9caeda7ee8cad2d1d48236a1f443c1fa3913c6a02fe0043b1dd3"
[[package]]
name = "pxfm"
-version = "0.1.23"
+version = "0.1.27"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f55f4fedc84ed39cb7a489322318976425e42a147e2be79d8f878e2884f94e84"
+checksum = "7186d3822593aa4393561d186d1393b3923e9d6163d3fbfd6e825e3e6cf3e6a8"
dependencies = [
"num-traits",
]
@@ -5821,18 +5934,9 @@ checksum = "a993555f31e5a609f617c12db6250dedcac1b0a85076912c436e6fc9b2c8e6a3"
[[package]]
name = "quick-xml"
-version = "0.37.5"
+version = "0.38.4"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "331e97a1af0bf59823e6eadffe373d7b27f485be8748f71471c662c1f269b7fb"
-dependencies = [
- "memchr",
-]
-
-[[package]]
-name = "quick-xml"
-version = "0.38.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "8927b0664f5c5a98265138b7e3f90aa19a6b21353182469ace36d4ac527b7b1b"
+checksum = "b66c2058c55a409d601666cffe35f04333cf1013010882cec174a7467cd4e21c"
dependencies = [
"memchr",
]
@@ -5850,8 +5954,8 @@ dependencies = [
"quinn-udp",
"rustc-hash",
"rustls",
- "socket2 0.6.1",
- "thiserror 2.0.17",
+ "socket2 0.6.2",
+ "thiserror 2.0.18",
"tokio",
"tracing",
"web-time",
@@ -5864,7 +5968,7 @@ source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "f1906b49b0c3bc04b5fe5d86a77925ae6524a19b816ae38ce1e426255f1d8a31"
dependencies = [
"bytes",
- "getrandom 0.3.3",
+ "getrandom 0.3.4",
"lru-slab",
"rand 0.9.2",
"ring",
@@ -5872,7 +5976,7 @@ dependencies = [
"rustls",
"rustls-pki-types",
"slab",
- "thiserror 2.0.17",
+ "thiserror 2.0.18",
"tinyvec",
"tracing",
"web-time",
@@ -5887,16 +5991,16 @@ dependencies = [
"cfg_aliases 0.2.1",
"libc",
"once_cell",
- "socket2 0.6.1",
+ "socket2 0.6.2",
"tracing",
"windows-sys 0.60.2",
]
[[package]]
name = "quote"
-version = "1.0.40"
+version = "1.0.44"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "1885c039570dc00dcb4ff087a89e185fd56bae234ddc7f056a945bf36467248d"
+checksum = "21b2ebcf727b7760c461f091f9f0f539b77b8e87f2fd88131e7f1b433b3cece4"
dependencies = [
"proc-macro2",
]
@@ -5929,9 +6033,9 @@ dependencies = [
[[package]]
name = "rama-boring"
-version = "0.5.9"
+version = "0.5.10"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "288926585d0b8ed1b1dd278a31ea1367007ad0bd4263ca84810e10939c2398a3"
+checksum = "84f7f862c81618f9aef40bd32e73986321109a24272c79e040377c5ac29491e8"
dependencies = [
"bitflags 2.10.0",
"foreign-types 0.5.0",
@@ -5942,9 +6046,9 @@ dependencies = [
[[package]]
name = "rama-boring-sys"
-version = "0.5.9"
+version = "0.5.10"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "421ebb40444a6d740f867a5055a710a73e7cd74b9b389583b45e9b29d1330465"
+checksum = "d5bfe3e86d71e9b91dae7561d5ceeaceb37a7d4fc078ab241afd7aab777f606f"
dependencies = [
"bindgen",
"cmake",
@@ -5954,9 +6058,9 @@ dependencies = [
[[package]]
name = "rama-boring-tokio"
-version = "0.5.9"
+version = "0.5.10"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "913cf3d377b37ff903cd57c2f6133ba7da5b7e0fe94821dec83daa8a024bb6ce"
+checksum = "9c7d71fab2ce4408cc40f819865501dbc63272ddab0e77dd3500ff77f1a0f883"
dependencies = [
"rama-boring",
"rama-boring-sys",
@@ -6019,7 +6123,7 @@ dependencies = [
"chrono",
"const_format",
"csv",
- "http 1.3.1",
+ "http 1.4.0",
"http-range-header",
"httpdate",
"iri-string",
@@ -6073,7 +6177,7 @@ dependencies = [
"futures-channel",
"httparse",
"httpdate",
- "indexmap 2.12.0",
+ "indexmap 2.13.0",
"itoa",
"parking_lot",
"pin-project-lite",
@@ -6119,7 +6223,7 @@ dependencies = [
"bytes",
"const_format",
"fnv",
- "http 1.3.1",
+ "http 1.4.0",
"http-body",
"http-body-util",
"itoa",
@@ -6148,7 +6252,7 @@ dependencies = [
"proc-macro-crate",
"proc-macro2",
"quote",
- "syn 2.0.104",
+ "syn 2.0.114",
]
[[package]]
@@ -6175,7 +6279,7 @@ dependencies = [
"rama-utils",
"serde",
"sha2",
- "socket2 0.6.1",
+ "socket2 0.6.2",
"tokio",
]
@@ -6292,7 +6396,7 @@ source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "6db2770f06117d490610c7488547d543617b21bfa07796d7a12f6f1bd53850d1"
dependencies = [
"rand_chacha 0.9.0",
- "rand_core 0.9.3",
+ "rand_core 0.9.5",
]
[[package]]
@@ -6312,7 +6416,7 @@ source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "d3022b5f1df60f26e1ffddd6c66e8aa15de382ae63b3a0c1bfc0e4d3e3f325cb"
dependencies = [
"ppv-lite86",
- "rand_core 0.9.3",
+ "rand_core 0.9.5",
]
[[package]]
@@ -6321,16 +6425,16 @@ version = "0.6.4"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "ec0be4795e2f6a28069bec0b5ff3e2ac9bafc99e6a9a7dc3547996c5c816922c"
dependencies = [
- "getrandom 0.2.16",
+ "getrandom 0.2.17",
]
[[package]]
name = "rand_core"
-version = "0.9.3"
+version = "0.9.5"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "99d9a13982dcf210057a8a78572b2217b667c3beacbf3a0d8b454f6f82837d38"
+checksum = "76afc826de14238e6e8c374ddcc1fa19e374fd8dd986b0d2af0d02377261d83c"
dependencies = [
- "getrandom 0.3.3",
+ "getrandom 0.3.4",
]
[[package]]
@@ -6339,7 +6443,7 @@ version = "0.4.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "513962919efc330f829edb2535844d1b912b0fbe2ca165d613e4e8788bb05a5a"
dependencies = [
- "rand_core 0.9.3",
+ "rand_core 0.9.5",
]
[[package]]
@@ -6393,9 +6497,18 @@ dependencies = [
[[package]]
name = "redox_syscall"
-version = "0.5.15"
+version = "0.5.18"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "7e8af0dde094006011e6a740d4879319439489813bd0bcdc7d821beaeeff48ec"
+checksum = "ed2bf2547551a7053d6fdfafda3f938979645c44812fbfcda098faae3f1a362d"
+dependencies = [
+ "bitflags 2.10.0",
+]
+
+[[package]]
+name = "redox_syscall"
+version = "0.7.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "49f3fe0889e69e2ae9e41f4d6c4c0181701d00e4697b356fb1f74173a5e0ee27"
dependencies = [
"bitflags 2.10.0",
]
@@ -6406,40 +6519,40 @@ version = "0.4.6"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "ba009ff324d1fc1b900bd1fdb31564febe58a8ccc8a6fdbb93b543d33b13ca43"
dependencies = [
- "getrandom 0.2.16",
+ "getrandom 0.2.17",
"libredox",
"thiserror 1.0.69",
]
[[package]]
name = "redox_users"
-version = "0.5.0"
+version = "0.5.2"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "dd6f9d3d47bdd2ad6945c5015a226ec6155d0bcdfd8f7cd29f86b71f8de99d2b"
+checksum = "a4e608c6638b9c18977b00b475ac1f28d14e84b27d8d42f70e0bf1e3dec127ac"
dependencies = [
- "getrandom 0.2.16",
+ "getrandom 0.2.17",
"libredox",
- "thiserror 2.0.17",
+ "thiserror 2.0.18",
]
[[package]]
name = "ref-cast"
-version = "1.0.24"
+version = "1.0.25"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "4a0ae411dbe946a674d89546582cea4ba2bb8defac896622d6496f14c23ba5cf"
+checksum = "f354300ae66f76f1c85c5f84693f0ce81d747e2c3f21a45fef496d89c960bf7d"
dependencies = [
"ref-cast-impl",
]
[[package]]
name = "ref-cast-impl"
-version = "1.0.24"
+version = "1.0.25"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "1165225c21bff1f3bbce98f5a1f889949bc902d3575308cc7b0de30b4f6d27c7"
+checksum = "b7186006dcb21920990093f30e3dea63b7d6e977bf1256be20c3563a5db070da"
dependencies = [
"proc-macro2",
"quote",
- "syn 2.0.104",
+ "syn 2.0.114",
]
[[package]]
@@ -6451,7 +6564,7 @@ dependencies = [
"aho-corasick",
"memchr",
"regex-automata",
- "regex-syntax 0.8.5",
+ "regex-syntax 0.8.8",
]
[[package]]
@@ -6462,7 +6575,7 @@ checksum = "5276caf25ac86c8d810222b3dbb938e512c55c6831a10f3e6ed1c93b84041f1c"
dependencies = [
"aho-corasick",
"memchr",
- "regex-syntax 0.8.5",
+ "regex-syntax 0.8.8",
]
[[package]]
@@ -6479,15 +6592,15 @@ checksum = "f162c6dd7b008981e4d40210aca20b4bd0f9b60ca9271061b07f78537722f2e1"
[[package]]
name = "regex-syntax"
-version = "0.8.5"
+version = "0.8.8"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "2b15c43186be67a4fd63bee50d0303afffcef381492ebe2c5d87f324e1b8815c"
+checksum = "7a2d987857b319362043e95f5353c0535c1f58eec5336fdfcf626430af7def58"
[[package]]
name = "reqwest"
-version = "0.12.24"
+version = "0.12.28"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "9d0946410b9f7b082a427e4ef5c8ff541a88b357bc6c637c40db3a68ac70a36f"
+checksum = "eddd3ca559203180a307f12d114c268abf583f59b03cb906fd0b3ff8646c1147"
dependencies = [
"base64",
"bytes",
@@ -6496,7 +6609,7 @@ dependencies = [
"futures-core",
"futures-util",
"h2",
- "http 1.3.1",
+ "http 1.4.0",
"http-body",
"http-body-util",
"hyper",
@@ -6529,7 +6642,7 @@ dependencies = [
"wasm-bindgen-futures",
"wasm-streams",
"web-sys",
- "webpki-roots 1.0.2",
+ "webpki-roots 1.0.5",
]
[[package]]
@@ -6546,7 +6659,7 @@ checksum = "a4689e6c2294d81e88dc6261c768b63bc4fcdb852be6d1352498b114f61383b7"
dependencies = [
"cc",
"cfg-if",
- "getrandom 0.2.16",
+ "getrandom 0.2.17",
"libc",
"untrusted",
"windows-sys 0.52.0",
@@ -6563,7 +6676,7 @@ dependencies = [
"bytes",
"chrono",
"futures",
- "http 1.3.1",
+ "http 1.4.0",
"http-body",
"http-body-util",
"oauth2",
@@ -6573,11 +6686,11 @@ dependencies = [
"rand 0.9.2",
"reqwest",
"rmcp-macros",
- "schemars 1.0.4",
+ "schemars 1.2.1",
"serde",
"serde_json",
"sse-stream",
- "thiserror 2.0.17",
+ "thiserror 2.0.18",
"tokio",
"tokio-stream",
"tokio-util",
@@ -6597,7 +6710,7 @@ dependencies = [
"proc-macro2",
"quote",
"serde_json",
- "syn 2.0.104",
+ "syn 2.0.114",
]
[[package]]
@@ -6627,9 +6740,9 @@ source = "git+https://github.com/dzbarsky/rules_rust?rev=b56cbaa8465e74127f1ea21
[[package]]
name = "rustc-demangle"
-version = "0.1.25"
+version = "0.1.27"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "989e6739f80c4ad5b13e0fd7fe89531180375b18520cc8c82080e4dc4035b84f"
+checksum = "b50b8869d9fc858ce7266cce0194bd74df58b9d0e3f6df3a9fc8eb470d95c09d"
[[package]]
name = "rustc-hash"
@@ -6661,22 +6774,22 @@ dependencies = [
[[package]]
name = "rustix"
-version = "1.0.8"
+version = "1.1.3"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "11181fbabf243db407ef8df94a6ce0b2f9a733bd8be4ad02b4eda9602296cac8"
+checksum = "146c9e247ccc180c1f61615433868c99f3de3ae256a30a43b49f67c2d9171f34"
dependencies = [
"bitflags 2.10.0",
"errno",
"libc",
- "linux-raw-sys 0.9.4",
- "windows-sys 0.60.2",
+ "linux-raw-sys 0.11.0",
+ "windows-sys 0.61.2",
]
[[package]]
name = "rustls"
-version = "0.23.29"
+version = "0.23.36"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "2491382039b29b9b11ff08b76ff6c97cf287671dbb74f0be44bda389fffe9bd1"
+checksum = "c665f33d38cea657d9614f766881e4d510e0eda4239891eea56b4cadcf01801b"
dependencies = [
"log",
"once_cell",
@@ -6689,11 +6802,11 @@ dependencies = [
[[package]]
name = "rustls-native-certs"
-version = "0.8.1"
+version = "0.8.3"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "7fcff2dd52b58a8d98a70243663a0d234c4e2b79235637849d15913394a247d3"
+checksum = "612460d5f7bea540c490b2b6395d8e34a953e52b491accd6c86c8164c5932a63"
dependencies = [
- "openssl-probe",
+ "openssl-probe 0.2.1",
"rustls-pki-types",
"schannel",
"security-framework 3.5.1",
@@ -6701,9 +6814,9 @@ dependencies = [
[[package]]
name = "rustls-pki-types"
-version = "1.12.0"
+version = "1.14.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "229a4a4c221013e7e1f1a043678c5cc39fe5171437c88fb47151a21e6f5b5c79"
+checksum = "be040f8b0a225e40375822a563fa9524378b9d63112f53e19ffff34df5d33fdd"
dependencies = [
"web-time",
"zeroize",
@@ -6711,9 +6824,9 @@ dependencies = [
[[package]]
name = "rustls-webpki"
-version = "0.103.4"
+version = "0.103.9"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "0a17884ae0c1b773f1ccd2bd4a8c72f16da897310a98b0e84bf349ad5ead92fc"
+checksum = "d7df23109aa6c1567d1c575b9952556388da57401e4ace1d15f79eedad0d8f53"
dependencies = [
"ring",
"rustls-pki-types",
@@ -6722,9 +6835,9 @@ dependencies = [
[[package]]
name = "rustversion"
-version = "1.0.21"
+version = "1.0.22"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "8a0d197bd2c9dc6e53b84da9556a69ba4cdfab8619eb41a8bd1cc2027a0f6b1d"
+checksum = "b39cdef0fa800fc44525c84ccb54a029961a8215f9619753635a9c0d2538d46d"
[[package]]
name = "rustyline"
@@ -6750,9 +6863,9 @@ dependencies = [
[[package]]
name = "ryu"
-version = "1.0.20"
+version = "1.0.22"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "28d3b2b1366ec20994f1fd18c3c594f05c5dd4bc44d8bb0c1c632c8d6829481f"
+checksum = "a50f4cf475b65d88e057964e0e9bb1f0aa9bbb2036dc65c64596b42932536984"
[[package]]
name = "same-file"
@@ -6778,7 +6891,7 @@ version = "0.1.28"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "891d81b926048e76efe18581bf793546b4c0eaf8448d72be8de2bbee5fd166e1"
dependencies = [
- "windows-sys 0.61.1",
+ "windows-sys 0.61.2",
]
[[package]]
@@ -6849,14 +6962,14 @@ dependencies = [
[[package]]
name = "schemars"
-version = "1.0.4"
+version = "1.2.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "82d20c4491bc164fa2f6c5d44565947a52ad80b9505d8e36f8d54c27c739fcd0"
+checksum = "a2b42f36aa1cd011945615b92222f6bf73c599a102a300334cd7f8dbeec726cc"
dependencies = [
"chrono",
"dyn-clone",
"ref-cast",
- "schemars_derive 1.0.4",
+ "schemars_derive 1.2.1",
"serde",
"serde_json",
]
@@ -6870,19 +6983,19 @@ dependencies = [
"proc-macro2",
"quote",
"serde_derive_internals",
- "syn 2.0.104",
+ "syn 2.0.114",
]
[[package]]
name = "schemars_derive"
-version = "1.0.4"
+version = "1.2.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "33d020396d1d138dc19f1165df7545479dcd58d93810dc5d646a16e55abefa80"
+checksum = "7d115b50f4aaeea07e79c1912f645c7513d81715d0420f8bc77a18c6260b307f"
dependencies = [
"proc-macro2",
"quote",
"serde_derive_internals",
- "syn 2.0.104",
+ "syn 2.0.114",
]
[[package]]
@@ -6975,9 +7088,9 @@ checksum = "d767eb0aabc880b29956c35734170f26ed551a859dbd361d140cdbeca61ab1e2"
[[package]]
name = "sentry"
-version = "0.46.0"
+version = "0.46.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "d9794f69ad475e76c057e326175d3088509649e3aed98473106b9fe94ba59424"
+checksum = "2f925d575b468e88b079faf590a8dd0c9c99e2ec29e9bab663ceb8b45056312f"
dependencies = [
"httpdate",
"native-tls",
@@ -6995,9 +7108,9 @@ dependencies = [
[[package]]
name = "sentry-actix"
-version = "0.46.0"
+version = "0.46.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "e0fee202934063ace4f1d1d063113b8982293762628e563a2d2fba08fb20b110"
+checksum = "18bac0f6b8621fa0f85e298901e51161205788322e1a995e3764329020368058"
dependencies = [
"actix-http",
"actix-web",
@@ -7008,9 +7121,9 @@ dependencies = [
[[package]]
name = "sentry-backtrace"
-version = "0.46.0"
+version = "0.46.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "e81137ad53b8592bd0935459ad74c0376053c40084aa170451e74eeea8dbc6c3"
+checksum = "6cb1ef7534f583af20452b1b1bf610a60ed9c8dd2d8485e7bd064efc556a78fb"
dependencies = [
"backtrace",
"regex",
@@ -7019,9 +7132,9 @@ dependencies = [
[[package]]
name = "sentry-contexts"
-version = "0.46.0"
+version = "0.46.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "cfb403c66cc2651a01b9bacda2e7c22cd51f7e8f56f206aa4310147eb3259282"
+checksum = "ebd6be899d9938390b6d1ec71e2f53bd9e57b6a9d8b1d5b049e5c364e7da9078"
dependencies = [
"hostname",
"libc",
@@ -7033,9 +7146,9 @@ dependencies = [
[[package]]
name = "sentry-core"
-version = "0.46.0"
+version = "0.46.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "cfc409727ae90765ca8ea76fe6c949d6f159a11d02e130b357fa652ee9efcada"
+checksum = "26ab054c34b87f96c3e4701bea1888317cde30cc7e4a6136d2c48454ab96661c"
dependencies = [
"rand 0.9.2",
"sentry-types",
@@ -7046,9 +7159,9 @@ dependencies = [
[[package]]
name = "sentry-debug-images"
-version = "0.46.0"
+version = "0.46.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "06a2778a222fd90ebb01027c341a72f8e24b0c604c6126504a4fe34e5500e646"
+checksum = "5637ec550dc6f8c49a711537950722d3fc4baa6fd433c371912104eaff31e2a5"
dependencies = [
"findshlibs",
"sentry-core",
@@ -7056,9 +7169,9 @@ dependencies = [
[[package]]
name = "sentry-panic"
-version = "0.46.0"
+version = "0.46.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "3df79f4e1e72b2a8b75a0ebf49e78709ceb9b3f0b451f13adc92a0361b0aaabe"
+checksum = "3f02c7162f7b69b8de872b439d4696dc1d65f80b13ddd3c3831723def4756b63"
dependencies = [
"sentry-backtrace",
"sentry-core",
@@ -7066,9 +7179,9 @@ dependencies = [
[[package]]
name = "sentry-tracing"
-version = "0.46.0"
+version = "0.46.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "ff2046f527fd4b75e0b6ab3bd656c67dce42072f828dc4d03c206d15dca74a93"
+checksum = "e1dd47df349a80025819f3d25c3d2f751df705d49c65a4cdc0f130f700972a48"
dependencies = [
"bitflags 2.10.0",
"sentry-backtrace",
@@ -7079,16 +7192,16 @@ dependencies = [
[[package]]
name = "sentry-types"
-version = "0.46.0"
+version = "0.46.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "c7b9b4e4c03a4d3643c18c78b8aa91d2cbee5da047d2fa0ca4bb29bc67e6c55c"
+checksum = "eecbd63e9d15a26a40675ed180d376fcb434635d2e33de1c24003f61e3e2230d"
dependencies = [
"debugid",
"hex",
"rand 0.9.2",
"serde",
"serde_json",
- "thiserror 2.0.17",
+ "thiserror 2.0.18",
"time",
"url",
"uuid",
@@ -7121,7 +7234,7 @@ checksum = "d540f220d3187173da220f885ab66608367b6574e925011a9353e4badda91d79"
dependencies = [
"proc-macro2",
"quote",
- "syn 2.0.104",
+ "syn 2.0.114",
]
[[package]]
@@ -7132,7 +7245,7 @@ checksum = "18d26a20a969b9e3fdf2fc2d9f21eda6c40e2de84c9408bb5d3b05d499aae711"
dependencies = [
"proc-macro2",
"quote",
- "syn 2.0.104",
+ "syn 2.0.114",
]
[[package]]
@@ -7142,7 +7255,7 @@ source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "2acf96b1d9364968fce46ebb548f1c0e1d7eceae27bdff73865d42e6c7369d94"
dependencies = [
"form_urlencoded",
- "indexmap 2.12.0",
+ "indexmap 2.13.0",
"itoa",
"ryu",
"serde_core",
@@ -7150,16 +7263,16 @@ dependencies = [
[[package]]
name = "serde_json"
-version = "1.0.145"
+version = "1.0.149"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "402a6f66d8c709116cf22f558eab210f5a50187f702eb4d7e5ef38d9a7f1c79c"
+checksum = "83fc039473c5595ace860d8c4fafa220ff474b3fc6bfdb4293327f1a37e94d86"
dependencies = [
- "indexmap 2.12.0",
+ "indexmap 2.13.0",
"itoa",
"memchr",
- "ryu",
"serde",
"serde_core",
+ "zmij",
]
[[package]]
@@ -7181,16 +7294,16 @@ checksum = "175ee3e80ae9982737ca543e96133087cbd9a485eecc3bc4de9c1a37b47ea59c"
dependencies = [
"proc-macro2",
"quote",
- "syn 2.0.104",
+ "syn 2.0.114",
]
[[package]]
name = "serde_spanned"
-version = "1.0.0"
+version = "1.0.4"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "40734c41988f7306bb04f0ecf60ec0f3f1caa34290e4e8ea471dcd3346483b83"
+checksum = "f8bbf91e5a4d6315eee45e704372590b30e260ee83af6639d64557f51b067776"
dependencies = [
- "serde",
+ "serde_core",
]
[[package]]
@@ -7215,9 +7328,9 @@ dependencies = [
"chrono",
"hex",
"indexmap 1.9.3",
- "indexmap 2.12.0",
+ "indexmap 2.13.0",
"schemars 0.9.0",
- "schemars 1.0.4",
+ "schemars 1.2.1",
"serde_core",
"serde_json",
"serde_with_macros",
@@ -7233,7 +7346,7 @@ dependencies = [
"darling 0.21.3",
"proc-macro2",
"quote",
- "syn 2.0.104",
+ "syn 2.0.114",
]
[[package]]
@@ -7242,7 +7355,7 @@ version = "0.9.34+deprecated"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "6a8b1a1a2ebf674015cc02edccce75287f1a0130d394307b36743c2f5d504b47"
dependencies = [
- "indexmap 2.12.0",
+ "indexmap 2.13.0",
"itoa",
"ryu",
"serde",
@@ -7251,9 +7364,9 @@ dependencies = [
[[package]]
name = "serial2"
-version = "0.2.31"
+version = "0.2.33"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "26e1e5956803a69ddd72ce2de337b577898801528749565def03515f82bad5bb"
+checksum = "8cc76fa68e25e771492ca1e3c53d447ef0be3093e05cd3b47f4b712ba10c6f3c"
dependencies = [
"cfg-if",
"libc",
@@ -7262,11 +7375,12 @@ dependencies = [
[[package]]
name = "serial_test"
-version = "3.2.0"
+version = "3.3.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "1b258109f244e1d6891bf1053a55d63a5cd4f8f4c30cf9a1280989f80e7a1fa9"
+checksum = "0d0b343e184fc3b7bb44dff0705fffcf4b3756ba6aff420dddd8b24ca145e555"
dependencies = [
- "futures",
+ "futures-executor",
+ "futures-util",
"log",
"once_cell",
"parking_lot",
@@ -7276,13 +7390,13 @@ dependencies = [
[[package]]
name = "serial_test_derive"
-version = "3.2.0"
+version = "3.3.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "5d69265a08751de7844521fd15003ae0a888e035773ba05695c5c759a6f89eef"
+checksum = "6f50427f258fb77356e4cd4aa0e87e2bd2c66dbcee41dc405282cae2bfc26c83"
dependencies = [
"proc-macro2",
"quote",
- "syn 2.0.104",
+ "syn 2.0.114",
]
[[package]]
@@ -7334,9 +7448,9 @@ dependencies = [
[[package]]
name = "shell-words"
-version = "1.1.0"
+version = "1.1.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "24188a676b6ae68c3b2cb3a01be17fbf7240ce009799bb56d5b1409051e78fde"
+checksum = "dc6fe69c597f9c37bfeeeeeb33da3530379845f10be461a66d16d03eca2ded77"
[[package]]
name = "shlex"
@@ -7356,9 +7470,9 @@ dependencies = [
[[package]]
name = "signal-hook-mio"
-version = "0.2.4"
+version = "0.2.5"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "34db1a06d485c9142248b7a054f034b349b212551f3dfd19c94d45a754a217cd"
+checksum = "b75a19a7a740b25bc7944bdee6172368f988763b744e3d4dfe753f6b4ece40cc"
dependencies = [
"libc",
"mio",
@@ -7367,10 +7481,11 @@ dependencies = [
[[package]]
name = "signal-hook-registry"
-version = "1.4.5"
+version = "1.4.8"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "9203b8055f63a2a00e2f593bb0510367fe707d7ff1e5c872de2f537b339e5410"
+checksum = "c4db69cba1110affc0e9f7bcd48bbf87b3f4fc7c61fc9155afd4c469eb3d6c1b"
dependencies = [
+ "errno",
"libc",
]
@@ -7386,9 +7501,9 @@ dependencies = [
[[package]]
name = "simd-adler32"
-version = "0.3.7"
+version = "0.3.8"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "d66dc143e6b11c1eddc06d5c423cfc97062865baf299914ab64caa38182078fe"
+checksum = "e320a6c5ad31d271ad523dcf3ad13e2767ad8b1cb8f047f75a8aeaf8da139da2"
[[package]]
name = "simdutf8"
@@ -7404,15 +7519,15 @@ checksum = "bbbb5d9659141646ae647b42fe094daf6c6192d1620870b449d9557f748b2daa"
[[package]]
name = "siphasher"
-version = "1.0.1"
+version = "1.0.2"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "56199f7ddabf13fe5074ce809e7d3f42b42ae711800501b5b16ea82ad029c39d"
+checksum = "b2aa850e253778c88a04c3d7323b043aeda9d3e30d5971937c1855769763678e"
[[package]]
name = "slab"
-version = "0.4.11"
+version = "0.4.12"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "7a2ae44ef20feb57a68b23d846850f861394c2e02dc425a50098ae8c90267589"
+checksum = "0c790de23124f9ab44544d7ac05d60440adc586479ce501c1d6d7da3cd8c9cf5"
[[package]]
name = "smallvec"
@@ -7451,9 +7566,9 @@ dependencies = [
[[package]]
name = "socket2"
-version = "0.6.1"
+version = "0.6.2"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "17129e116933cf371d018bb80ae557e889637989d8638274fb25622827b03881"
+checksum = "86f4aa3ad99f2088c990dfa82d367e19cb29268ed67c574d10d0a4bfe71f07e0"
dependencies = [
"libc",
"windows-sys 0.60.2",
@@ -7508,9 +7623,9 @@ dependencies = [
"futures-intrusive",
"futures-io",
"futures-util",
- "hashbrown 0.15.4",
+ "hashbrown 0.15.5",
"hashlink",
- "indexmap 2.12.0",
+ "indexmap 2.13.0",
"log",
"memchr",
"once_cell",
@@ -7520,7 +7635,7 @@ dependencies = [
"serde_json",
"sha2",
"smallvec",
- "thiserror 2.0.17",
+ "thiserror 2.0.18",
"time",
"tokio",
"tokio-stream",
@@ -7540,7 +7655,7 @@ dependencies = [
"quote",
"sqlx-core",
"sqlx-macros-core",
- "syn 2.0.104",
+ "syn 2.0.114",
]
[[package]]
@@ -7563,7 +7678,7 @@ dependencies = [
"sqlx-mysql",
"sqlx-postgres",
"sqlx-sqlite",
- "syn 2.0.104",
+ "syn 2.0.114",
"tokio",
"url",
]
@@ -7606,7 +7721,7 @@ dependencies = [
"smallvec",
"sqlx-core",
"stringprep",
- "thiserror 2.0.17",
+ "thiserror 2.0.18",
"time",
"tracing",
"uuid",
@@ -7646,7 +7761,7 @@ dependencies = [
"smallvec",
"sqlx-core",
"stringprep",
- "thiserror 2.0.17",
+ "thiserror 2.0.18",
"time",
"tracing",
"uuid",
@@ -7673,7 +7788,7 @@ dependencies = [
"serde",
"serde_urlencoded",
"sqlx-core",
- "thiserror 2.0.17",
+ "thiserror 2.0.18",
"time",
"tracing",
"url",
@@ -7695,9 +7810,9 @@ dependencies = [
[[package]]
name = "stable_deref_trait"
-version = "1.2.0"
+version = "1.2.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "a8f112729512f8e442d81f95a8a7ddf2b7c6b8a1a6f509a95864142b30cab2d3"
+checksum = "6ce2be8dc25455e1f91df71bfa12ad37d7af1092ae736f3a6cd0e37bc7810596"
[[package]]
name = "starlark"
@@ -7748,7 +7863,7 @@ dependencies = [
"dupe",
"proc-macro2",
"quote",
- "syn 2.0.104",
+ "syn 2.0.114",
]
[[package]]
@@ -7861,7 +7976,7 @@ dependencies = [
"proc-macro2",
"quote",
"rustversion",
- "syn 2.0.104",
+ "syn 2.0.114",
]
[[package]]
@@ -7873,7 +7988,7 @@ dependencies = [
"heck",
"proc-macro2",
"quote",
- "syn 2.0.104",
+ "syn 2.0.114",
]
[[package]]
@@ -7914,9 +8029,9 @@ dependencies = [
[[package]]
name = "syn"
-version = "2.0.104"
+version = "2.0.114"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "17b6f705963418cdb9927482fa304bc562ece2fdd4f616084c50b7023b435a40"
+checksum = "d4d107df263a3013ef9b1879b0df87d706ff80f65a86ea879bd9c31f9b307c2a"
dependencies = [
"proc-macro2",
"quote",
@@ -7940,7 +8055,7 @@ checksum = "728a70f3dbaf5bab7f0c4b1ac8d7ae5ea60a4b5549c8a5914361c99147a709d2"
dependencies = [
"proc-macro2",
"quote",
- "syn 2.0.104",
+ "syn 2.0.114",
]
[[package]]
@@ -7981,15 +8096,15 @@ checksum = "7b2093cf4c8eb1e67749a6762251bc9cd836b6fc171623bd0a9d324d37af2417"
[[package]]
name = "tempfile"
-version = "3.23.0"
+version = "3.24.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "2d31c77bdf42a745371d260a26ca7163f1e0924b64afa0b688e61b5a9fa02f16"
+checksum = "655da9c7eb6305c55742045d5a8d2037996d61d8de95806335c7c86ce0f82e9c"
dependencies = [
"fastrand",
- "getrandom 0.3.3",
+ "getrandom 0.3.4",
"once_cell",
- "rustix 1.0.8",
- "windows-sys 0.61.1",
+ "rustix 1.1.3",
+ "windows-sys 0.61.2",
]
[[package]]
@@ -8014,12 +8129,12 @@ dependencies = [
[[package]]
name = "terminal_size"
-version = "0.4.2"
+version = "0.4.3"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "45c6481c4829e4cc63825e62c49186a34538b7b2750b73b266581ffb612fb5ed"
+checksum = "60b8cb979cb11c32ce1603f8137b22262a9d131aaa5c37b5678025f22b8becd0"
dependencies = [
- "rustix 1.0.8",
- "windows-sys 0.59.0",
+ "rustix 1.1.3",
+ "windows-sys 0.60.2",
]
[[package]]
@@ -8046,7 +8161,7 @@ dependencies = [
"cfg-if",
"proc-macro2",
"quote",
- "syn 2.0.104",
+ "syn 2.0.114",
]
[[package]]
@@ -8057,7 +8172,7 @@ checksum = "5c89e72a01ed4c579669add59014b9a524d609c0c88c6a585ce37485879f6ffb"
dependencies = [
"proc-macro2",
"quote",
- "syn 2.0.104",
+ "syn 2.0.114",
"test-case-core",
]
@@ -8080,7 +8195,7 @@ checksum = "be35209fd0781c5401458ab66e4f98accf63553e8fae7425503e92fdd319783b"
dependencies = [
"proc-macro2",
"quote",
- "syn 2.0.104",
+ "syn 2.0.114",
]
[[package]]
@@ -8114,11 +8229,11 @@ dependencies = [
[[package]]
name = "thiserror"
-version = "2.0.17"
+version = "2.0.18"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f63587ca0f12b72a0600bcba1d40081f830876000bb46dd2337a3051618f4fc8"
+checksum = "4288b5bcbc7920c07a1149a35cf9590a2aa808e0bc1eafaade0b80947865fbc4"
dependencies = [
- "thiserror-impl 2.0.17",
+ "thiserror-impl 2.0.18",
]
[[package]]
@@ -8129,18 +8244,18 @@ checksum = "4fee6c4efc90059e10f81e6d42c60a18f76588c3d74cb83a0b242a2b6c7504c1"
dependencies = [
"proc-macro2",
"quote",
- "syn 2.0.104",
+ "syn 2.0.114",
]
[[package]]
name = "thiserror-impl"
-version = "2.0.17"
+version = "2.0.18"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "3ff15c8ecd7de3849db632e14d18d2571fa09dfc5ed93479bc4485c7a517c913"
+checksum = "ebc4ee7f67670e9b64d05fa4253e753e016c6c95ff35b89b7941d6b856dec1d5"
dependencies = [
"proc-macro2",
"quote",
- "syn 2.0.104",
+ "syn 2.0.114",
]
[[package]]
@@ -8163,14 +8278,14 @@ dependencies = [
"half",
"quick-error",
"weezl",
- "zune-jpeg 0.4.19",
+ "zune-jpeg 0.4.21",
]
[[package]]
name = "time"
-version = "0.3.44"
+version = "0.3.46"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "91e7d9e3bb61134e77bde20dd4825b97c010155709965fedf0f49bb138e52a9d"
+checksum = "9da98b7d9b7dad93488a84b8248efc35352b0b2657397d4167e7ad67e5d535e5"
dependencies = [
"deranged",
"itoa",
@@ -8178,22 +8293,22 @@ dependencies = [
"num-conv",
"num_threads",
"powerfmt",
- "serde",
+ "serde_core",
"time-core",
"time-macros",
]
[[package]]
name = "time-core"
-version = "0.1.6"
+version = "0.1.8"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "40868e7c1d2f0b8d73e4a8c7f0ff63af4f6d19be117e90bd73eb1d62cf831c6b"
+checksum = "7694e1cfe791f8d31026952abf09c69ca6f6fa4e1a1229e18988f06a04a12dca"
[[package]]
name = "time-macros"
-version = "0.2.24"
+version = "0.2.26"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "30cfb0125f12d9c277f35663a0a33f8c30190f4e4574868a330595412d34ebf3"
+checksum = "78cc610bac2dcee56805c99642447d4c5dbde4d01f752ffea0199aee1f601dc4"
dependencies = [
"num-conv",
"time-core",
@@ -8222,11 +8337,12 @@ dependencies = [
[[package]]
name = "tinystr"
-version = "0.8.1"
+version = "0.8.2"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "5d4f6d1145dcb577acf783d4e601bc1d76a13337bb54e6233add580b07344c8b"
+checksum = "42d3e9c45c09de15d06dd8acf5f4e0e399e85927b7f00711024eb7ae10fa4869"
dependencies = [
"displaydoc",
+ "serde_core",
"zerovec",
]
@@ -8257,9 +8373,9 @@ dependencies = [
"parking_lot",
"pin-project-lite",
"signal-hook-registry",
- "socket2 0.6.1",
+ "socket2 0.6.2",
"tokio-macros",
- "windows-sys 0.61.1",
+ "windows-sys 0.61.2",
]
[[package]]
@@ -8283,7 +8399,7 @@ checksum = "af407857209536a95c8e56f8231ef2c2e2aff839b22e07a1ffcbc617e9db9fa5"
dependencies = [
"proc-macro2",
"quote",
- "syn 2.0.104",
+ "syn 2.0.114",
]
[[package]]
@@ -8298,9 +8414,9 @@ dependencies = [
[[package]]
name = "tokio-rustls"
-version = "0.26.2"
+version = "0.26.4"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "8e727b36a1a0e8b74c376ac2211e40c2c8af09fb4013c60d910495810f008e9b"
+checksum = "1729aa945f29d91ba541258c8df89027d5792d85a8841fb65e8bf0f4ede4ef61"
dependencies = [
"rustls",
"tokio",
@@ -8370,12 +8486,12 @@ dependencies = [
[[package]]
name = "toml"
-version = "0.9.5"
+version = "0.9.11+spec-1.1.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "75129e1dc5000bfbaa9fee9d1b21f974f9fbad9daec557a521ee6e080825f6e8"
+checksum = "f3afc9a848309fe1aaffaed6e1546a7a14de1f935dc9d89d32afd9a44bab7c46"
dependencies = [
- "indexmap 2.12.0",
- "serde",
+ "indexmap 2.13.0",
+ "serde_core",
"serde_spanned",
"toml_datetime",
"toml_parser",
@@ -8398,7 +8514,7 @@ version = "0.23.10+spec-1.0.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "84c8b9f757e028cee9fa244aea147aab2a9ec09d5325a9b01e0a49730c2b5269"
dependencies = [
- "indexmap 2.12.0",
+ "indexmap 2.13.0",
"toml_datetime",
"toml_parser",
"winnow",
@@ -8410,7 +8526,7 @@ version = "0.24.0+spec-1.1.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "8c740b185920170a6d9191122cafef7010bd6270a3824594bff6784c04d7f09e"
dependencies = [
- "indexmap 2.12.0",
+ "indexmap 2.13.0",
"toml_datetime",
"toml_parser",
"toml_writer",
@@ -8434,14 +8550,14 @@ checksum = "ab16f14aed21ee8bfd8ec22513f7287cd4a91aa92e44edfe2c17ddd004e92607"
[[package]]
name = "tonic"
-version = "0.14.2"
+version = "0.14.3"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "eb7613188ce9f7df5bfe185db26c5814347d110db17920415cf2fbcad85e7203"
+checksum = "a286e33f82f8a1ee2df63f4fa35c0becf4a85a0cb03091a15fd7bf0b402dc94a"
dependencies = [
"async-trait",
"base64",
"bytes",
- "http 1.3.1",
+ "http 1.4.0",
"http-body",
"http-body-util",
"hyper",
@@ -8462,9 +8578,9 @@ dependencies = [
[[package]]
name = "tonic-prost"
-version = "0.14.2"
+version = "0.14.3"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "66bd50ad6ce1252d87ef024b3d64fe4c3cf54a86fb9ef4c631fdd0ded7aeaa67"
+checksum = "d6c55a2d6a14174563de34409c9f92ff981d006f56da9c6ecd40d9d4a31500b0"
dependencies = [
"bytes",
"prost",
@@ -8473,13 +8589,13 @@ dependencies = [
[[package]]
name = "tower"
-version = "0.5.2"
+version = "0.5.3"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "d039ad9159c98b70ecfd540b2573b97f7f52c3e8d9f8ad57a24b916a536975f9"
+checksum = "ebe5ef63511595f1344e2d5cfa636d973292adc0eec1f0ad45fae9f0851ab1d4"
dependencies = [
"futures-core",
"futures-util",
- "indexmap 2.12.0",
+ "indexmap 2.13.0",
"pin-project-lite",
"slab",
"sync_wrapper",
@@ -8492,14 +8608,14 @@ dependencies = [
[[package]]
name = "tower-http"
-version = "0.6.6"
+version = "0.6.8"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "adc82fd73de2a9722ac5da747f12383d2bfdb93591ee6c58486e0097890f05f2"
+checksum = "d4e6559d53cc268e5031cd8429d05415bc4cb4aefc4aa5d6cc35fbf5b924a1f8"
dependencies = [
"bitflags 2.10.0",
"bytes",
"futures-util",
- "http 1.3.1",
+ "http 1.4.0",
"http-body",
"iri-string",
"pin-project-lite",
@@ -8534,12 +8650,12 @@ dependencies = [
[[package]]
name = "tracing-appender"
-version = "0.2.3"
+version = "0.2.4"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "3566e8ce28cc0a3fe42519fc80e6b4c943cc4c8cef275620eb8dac2d3d4e06cf"
+checksum = "786d480bce6247ab75f005b14ae1624ad978d3029d9113f0a22fa1ac773faeaf"
dependencies = [
"crossbeam-channel",
- "thiserror 1.0.69",
+ "thiserror 2.0.18",
"time",
"tracing-subscriber",
]
@@ -8552,7 +8668,7 @@ checksum = "7490cfa5ec963746568740651ac6781f701c9c5ea257c58e057f3ba8cf69e8da"
dependencies = [
"proc-macro2",
"quote",
- "syn 2.0.104",
+ "syn 2.0.114",
]
[[package]]
@@ -8588,16 +8704,13 @@ dependencies = [
[[package]]
name = "tracing-opentelemetry"
-version = "0.32.0"
+version = "0.32.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "1e6e5658463dd88089aba75c7791e1d3120633b1bfde22478b28f625a9bb1b8e"
+checksum = "1ac28f2d093c6c477eaa76b23525478f38de514fa9aeb1285738d4b97a9552fc"
dependencies = [
"js-sys",
"opentelemetry",
- "opentelemetry_sdk",
- "rustversion",
"smallvec",
- "thiserror 2.0.17",
"tracing",
"tracing-core",
"tracing-log",
@@ -8641,7 +8754,7 @@ source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "04659ddb06c87d233c566112c1c9c5b9e98256d9af50ec3bc9c8327f873a7568"
dependencies = [
"quote",
- "syn 2.0.104",
+ "syn 2.0.114",
]
[[package]]
@@ -8652,7 +8765,7 @@ checksum = "78f873475d258561b06f1c595d93308a7ed124d9977cb26b148c2084a4a3cc87"
dependencies = [
"cc",
"regex",
- "regex-syntax 0.8.5",
+ "regex-syntax 0.8.8",
"serde_json",
"streaming-iterator",
"tree-sitter-language",
@@ -8660,9 +8773,9 @@ dependencies = [
[[package]]
name = "tree-sitter-bash"
-version = "0.25.0"
+version = "0.25.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "871b0606e667e98a1237ebdc1b0d7056e0aebfdc3141d12b399865d4cb6ed8a6"
+checksum = "9e5ec769279cc91b561d3df0d8a5deb26b0ad40d183127f409494d6d8fc53062"
dependencies = [
"cc",
"tree-sitter-language",
@@ -8676,26 +8789,25 @@ checksum = "adc5f880ad8d8f94e88cb81c3557024cf1a8b75e3b504c50481ed4f5a6006ff3"
dependencies = [
"regex",
"streaming-iterator",
- "thiserror 2.0.17",
+ "thiserror 2.0.18",
"tree-sitter",
]
[[package]]
name = "tree-sitter-language"
-version = "0.1.5"
+version = "0.1.7"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "c4013970217383f67b18aef68f6fb2e8d409bc5755227092d32efb0422ba24b8"
+checksum = "009994f150cc0cd50ff54917d5bc8bffe8cad10ca10d81c34da2ec421ae61782"
[[package]]
name = "tree_magic_mini"
-version = "3.2.0"
+version = "3.2.2"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f943391d896cdfe8eec03a04d7110332d445be7df856db382dd96a730667562c"
+checksum = "b8765b90061cba6c22b5831f675da109ae5561588290f9fa2317adab2714d5a6"
dependencies = [
"memchr",
- "nom 7.1.3",
- "once_cell",
- "petgraph",
+ "nom 8.0.0",
+ "petgraph 0.8.3",
]
[[package]]
@@ -8711,7 +8823,7 @@ source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "4994acea2522cd2b3b85c1d9529a55991e3ad5e25cdcd3de9d505972c4379424"
dependencies = [
"serde_json",
- "thiserror 2.0.17",
+ "thiserror 2.0.18",
"ts-rs-macros",
"uuid",
]
@@ -8724,7 +8836,7 @@ checksum = "ee6ff59666c9cbaec3533964505d39154dc4e0a56151fdea30a09ed0301f62e2"
dependencies = [
"proc-macro2",
"quote",
- "syn 2.0.104",
+ "syn 2.0.114",
"termcolor",
]
@@ -8735,22 +8847,22 @@ source = "git+https://github.com/JakkuSakura/tungstenite-rs?rev=f514de8644821113
dependencies = [
"bytes",
"data-encoding",
- "http 1.3.1",
+ "http 1.4.0",
"httparse",
"log",
"rand 0.9.2",
"rustls",
"rustls-pki-types",
"sha1",
- "thiserror 2.0.17",
+ "thiserror 2.0.18",
"utf-8",
]
[[package]]
name = "typenum"
-version = "1.18.0"
+version = "1.19.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "1dccffe3ce07af9386bfd29e80c0ab1a8205a2fc34e4bcd40364df902cfa8f3f"
+checksum = "562d481066bde0658276a35467c4af00bdc6ee726305698a55b86e61d7ad82bb"
[[package]]
name = "uds_windows"
@@ -8780,9 +8892,9 @@ checksum = "eaea85b334db583fe3274d12b4cd1880032beab409c0d774be044d4480ab9a94"
[[package]]
name = "unicase"
-version = "2.8.1"
+version = "2.9.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "75b844d17643ee918803943289730bec8aac480150456169e647ed0b576ba539"
+checksum = "dbc4bc3a9f746d862c45cb89d705aa10f187bb96c76001afab07a0d35ce60142"
[[package]]
name = "unicode-bidi"
@@ -8792,9 +8904,9 @@ checksum = "5c1cb5db39152898a79168971543b1cb5020dff7fe43c8dc468b0885f5e29df5"
[[package]]
name = "unicode-ident"
-version = "1.0.18"
+version = "1.0.22"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "5a5f39404a5da50712a4c1eecf25e90dd62b613502b7e925fd4e4d19b5c96512"
+checksum = "9312f7c4f6ff9069b165498234ce8be658059c6728633667c526e27dc2cf1df5"
[[package]]
name = "unicode-linebreak"
@@ -8888,21 +9000,22 @@ source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "d81f9efa9df032be5934a46a068815a10a042b494b6a58cb0a1a97bb5467ed6f"
dependencies = [
"base64",
- "http 1.3.1",
+ "http 1.4.0",
"httparse",
"log",
]
[[package]]
name = "url"
-version = "2.5.4"
+version = "2.5.8"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "32f8b686cadd1473f4bd0117a5d28d36b1ade384ea9b5069a1c40aefed7fda60"
+checksum = "ff67a8a4397373c3ef660812acab3268222035010ab8680ec4215f38ba3d0eed"
dependencies = [
"form_urlencoded",
"idna",
"percent-encoding",
"serde",
+ "serde_derive",
]
[[package]]
@@ -8931,13 +9044,13 @@ checksum = "06abde3611657adf66d383f00b093d7faecc7fa57071cce2578660c9f1010821"
[[package]]
name = "uuid"
-version = "1.18.1"
+version = "1.20.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "2f87b8aa10b915a06587d0dec516c282ff295b475d94abf425d62b57710070a2"
+checksum = "ee48d38b119b0cd71fe4141b30f5ba9c7c5d9f4e7a3a8b4a674e4b6ef789976f"
dependencies = [
- "getrandom 0.3.3",
+ "getrandom 0.3.4",
"js-sys",
- "serde",
+ "serde_core",
"sha1_smol",
"wasm-bindgen",
]
@@ -9016,12 +9129,12 @@ source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "ccf3ec651a847eb01de73ccad15eb7d99f80485de043efb2f370cd654f4ea44b"
[[package]]
-name = "wasi"
-version = "0.14.2+wasi-0.2.4"
+name = "wasip2"
+version = "1.0.2+wasi-0.2.9"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "9683f9a5a998d873c0d21fcbe3c083009670149a8fab228644b8bd36b2c48cb3"
+checksum = "9517f9239f02c069db75e65f174b3da828fe5f5b945c4dd26bd25d89c03ebcf5"
dependencies = [
- "wit-bindgen-rt",
+ "wit-bindgen",
]
[[package]]
@@ -9032,37 +9145,25 @@ checksum = "b8dad83b4f25e74f184f64c43b150b91efe7647395b42289f38e50566d82855b"
[[package]]
name = "wasm-bindgen"
-version = "0.2.100"
+version = "0.2.108"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "1edc8929d7499fc4e8f0be2262a241556cfc54a0bea223790e71446f2aab1ef5"
+checksum = "64024a30ec1e37399cf85a7ffefebdb72205ca1c972291c51512360d90bd8566"
dependencies = [
"cfg-if",
"once_cell",
"rustversion",
"wasm-bindgen-macro",
-]
-
-[[package]]
-name = "wasm-bindgen-backend"
-version = "0.2.100"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "2f0a0651a5c2bc21487bde11ee802ccaf4c51935d0d3d42a6101f98161700bc6"
-dependencies = [
- "bumpalo",
- "log",
- "proc-macro2",
- "quote",
- "syn 2.0.104",
"wasm-bindgen-shared",
]
[[package]]
name = "wasm-bindgen-futures"
-version = "0.4.50"
+version = "0.4.58"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "555d470ec0bc3bb57890405e5d4322cc9ea83cebb085523ced7be4144dac1e61"
+checksum = "70a6e77fd0ae8029c9ea0063f87c46fde723e7d887703d74ad2616d792e51e6f"
dependencies = [
"cfg-if",
+ "futures-util",
"js-sys",
"once_cell",
"wasm-bindgen",
@@ -9071,9 +9172,9 @@ dependencies = [
[[package]]
name = "wasm-bindgen-macro"
-version = "0.2.100"
+version = "0.2.108"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "7fe63fc6d09ed3792bd0897b314f53de8e16568c2b3f7982f468c0bf9bd0b407"
+checksum = "008b239d9c740232e71bd39e8ef6429d27097518b6b30bdf9086833bd5b6d608"
dependencies = [
"quote",
"wasm-bindgen-macro-support",
@@ -9081,22 +9182,22 @@ dependencies = [
[[package]]
name = "wasm-bindgen-macro-support"
-version = "0.2.100"
+version = "0.2.108"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "8ae87ea40c9f689fc23f209965b6fb8a99ad69aeeb0231408be24920604395de"
+checksum = "5256bae2d58f54820e6490f9839c49780dff84c65aeab9e772f15d5f0e913a55"
dependencies = [
+ "bumpalo",
"proc-macro2",
"quote",
- "syn 2.0.104",
- "wasm-bindgen-backend",
+ "syn 2.0.114",
"wasm-bindgen-shared",
]
[[package]]
name = "wasm-bindgen-shared"
-version = "0.2.100"
+version = "0.2.108"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "1a05d73b933a847d6cccdda8f838a22ff101ad9bf93e33684f39c1f5f0eece3d"
+checksum = "1f01b580c9ac74c8d8f0c0e4afb04eeef2acf145458e52c03845ee9cd23e3d12"
dependencies = [
"unicode-ident",
]
@@ -9116,34 +9217,34 @@ dependencies = [
[[package]]
name = "wayland-backend"
-version = "0.3.11"
+version = "0.3.12"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "673a33c33048a5ade91a6b139580fa174e19fb0d23f396dca9fa15f2e1e49b35"
+checksum = "fee64194ccd96bf648f42a65a7e589547096dfa702f7cadef84347b66ad164f9"
dependencies = [
"cc",
"downcast-rs",
- "rustix 1.0.8",
+ "rustix 1.1.3",
"smallvec",
"wayland-sys",
]
[[package]]
name = "wayland-client"
-version = "0.31.11"
+version = "0.31.12"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "c66a47e840dc20793f2264eb4b3e4ecb4b75d91c0dd4af04b456128e0bdd449d"
+checksum = "b8e6faa537fbb6c186cb9f1d41f2f811a4120d1b57ec61f50da451a0c5122bec"
dependencies = [
"bitflags 2.10.0",
- "rustix 1.0.8",
+ "rustix 1.1.3",
"wayland-backend",
"wayland-scanner",
]
[[package]]
name = "wayland-protocols"
-version = "0.32.9"
+version = "0.32.10"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "efa790ed75fbfd71283bd2521a1cfdc022aabcc28bdcff00851f9e4ae88d9901"
+checksum = "baeda9ffbcfc8cd6ddaade385eaf2393bd2115a69523c735f12242353c3df4f3"
dependencies = [
"bitflags 2.10.0",
"wayland-backend",
@@ -9153,9 +9254,9 @@ dependencies = [
[[package]]
name = "wayland-protocols-wlr"
-version = "0.3.9"
+version = "0.3.10"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "efd94963ed43cf9938a090ca4f7da58eb55325ec8200c3848963e98dc25b78ec"
+checksum = "e9597cdf02cf0c34cd5823786dce6b5ae8598f05c2daf5621b6e178d4f7345f3"
dependencies = [
"bitflags 2.10.0",
"wayland-backend",
@@ -9166,29 +9267,29 @@ dependencies = [
[[package]]
name = "wayland-scanner"
-version = "0.31.7"
+version = "0.31.8"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "54cb1e9dc49da91950bdfd8b848c49330536d9d1fb03d4bfec8cae50caa50ae3"
+checksum = "5423e94b6a63e68e439803a3e153a9252d5ead12fd853334e2ad33997e3889e3"
dependencies = [
"proc-macro2",
- "quick-xml 0.37.5",
+ "quick-xml",
"quote",
]
[[package]]
name = "wayland-sys"
-version = "0.31.7"
+version = "0.31.8"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "34949b42822155826b41db8e5d0c1be3a2bd296c747577a43a3e6daefc296142"
+checksum = "1e6dbfc3ac5ef974c92a2235805cc0114033018ae1290a72e474aa8b28cbbdfd"
dependencies = [
"pkg-config",
]
[[package]]
name = "web-sys"
-version = "0.3.77"
+version = "0.3.85"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "33b6dd2ef9186f1f2072e409e99cd22a975331a6b3591b12c764e0e55c60d5d2"
+checksum = "312e32e551d92129218ea9a2452120f4aabc03529ef03e4d0d82fb2780608598"
dependencies = [
"js-sys",
"wasm-bindgen",
@@ -9222,9 +9323,9 @@ dependencies = [
[[package]]
name = "webpki-root-certs"
-version = "1.0.4"
+version = "1.0.5"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "ee3e3b5f5e80bc89f30ce8d0343bf4e5f12341c51f3e26cbeecbc7c85443e85b"
+checksum = "36a29fc0408b113f68cf32637857ab740edfafdf460c326cd2afaa2d84cc05dc"
dependencies = [
"rustls-pki-types",
]
@@ -9235,23 +9336,23 @@ version = "0.26.11"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "521bc38abb08001b01866da9f51eb7c5d647a19260e00054a8c7fd5f9e57f7a9"
dependencies = [
- "webpki-roots 1.0.2",
+ "webpki-roots 1.0.5",
]
[[package]]
name = "webpki-roots"
-version = "1.0.2"
+version = "1.0.5"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "7e8983c3ab33d6fb807cfcdad2491c4ea8cbc8ed839181c7dfd9c67c83e261b2"
+checksum = "12bed680863276c63889429bfd6cab3b99943659923822de1c8a39c49e4d722c"
dependencies = [
"rustls-pki-types",
]
[[package]]
name = "weezl"
-version = "0.1.10"
+version = "0.1.12"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "a751b3277700db47d3e574514de2eced5e54dc8a5436a3bf7a0b248b2cee16f3"
+checksum = "a28ac98ddc8b9274cb41bb4d9d4d5c425b6020c50c46f25559911905610b4a88"
[[package]]
name = "which"
@@ -9260,7 +9361,7 @@ source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "d3fabb953106c3c8eea8306e4393700d7657561cb43122571b172bbfb7c7ba1d"
dependencies = [
"env_home",
- "rustix 1.0.8",
+ "rustix 1.1.3",
"winsafe",
]
@@ -9286,7 +9387,7 @@ version = "0.3.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "f9b0540e91e49de3817c314da0dd3bc518093ceacc6ea5327cb0e1eb073e5189"
dependencies = [
- "thiserror 2.0.17",
+ "thiserror 2.0.18",
]
[[package]]
@@ -9313,11 +9414,11 @@ checksum = "ac3b87c63620426dd9b991e5ce0329eff545bccbbb34f3be09ff6fb6ab51b7b6"
[[package]]
name = "winapi-util"
-version = "0.1.9"
+version = "0.1.11"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "cf221c93e13a30d793f7645a0e7762c55d169dbb0a49671918a2319d289b10bb"
+checksum = "c2a7b1c03c876122aa43f3020e6c3c3ee5c05081c9a00739faf7503aeba10d22"
dependencies = [
- "windows-sys 0.59.0",
+ "windows-sys 0.61.2",
]
[[package]]
@@ -9338,24 +9439,23 @@ dependencies = [
[[package]]
name = "windows"
-version = "0.61.3"
+version = "0.62.2"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "9babd3a767a4c1aef6900409f85f5d53ce2544ccdfaa86dad48c91782c6d6893"
+checksum = "527fadee13e0c05939a6a05d5bd6eec6cd2e3dbd648b9f8e447c6518133d8580"
dependencies = [
"windows-collections",
- "windows-core 0.61.2",
+ "windows-core 0.62.2",
"windows-future",
- "windows-link 0.1.3",
"windows-numerics",
]
[[package]]
name = "windows-collections"
-version = "0.2.0"
+version = "0.3.2"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "3beeceb5e5cfd9eb1d76b381630e82c4241ccd0d27f1a39ed41b2760b255c5e8"
+checksum = "23b2d95af1a8a14a3c7367e1ed4fc9c20e0a26e79551b1454d72583c97cc6610"
dependencies = [
- "windows-core 0.61.2",
+ "windows-core 0.62.2",
]
[[package]]
@@ -9373,25 +9473,25 @@ dependencies = [
[[package]]
name = "windows-core"
-version = "0.61.2"
+version = "0.62.2"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "c0fdd3ddb90610c7638aa2b3a3ab2904fb9e5cdbecc643ddb3647212781c4ae3"
+checksum = "b8e83a14d34d0623b51dce9581199302a221863196a1dde71a7663a4c2be9deb"
dependencies = [
- "windows-implement 0.60.0",
- "windows-interface 0.59.1",
- "windows-link 0.1.3",
- "windows-result 0.3.4",
- "windows-strings 0.4.2",
+ "windows-implement 0.60.2",
+ "windows-interface 0.59.3",
+ "windows-link",
+ "windows-result 0.4.1",
+ "windows-strings 0.5.1",
]
[[package]]
name = "windows-future"
-version = "0.2.1"
+version = "0.3.2"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "fc6a41e98427b19fe4b73c550f060b59fa592d7d686537eebf9385621bfbad8e"
+checksum = "e1d6f90251fe18a279739e78025bd6ddc52a7e22f921070ccdc67dde84c605cb"
dependencies = [
- "windows-core 0.61.2",
- "windows-link 0.1.3",
+ "windows-core 0.62.2",
+ "windows-link",
"windows-threading",
]
@@ -9403,18 +9503,18 @@ checksum = "2bbd5b46c938e506ecbce286b6628a02171d56153ba733b6c741fc627ec9579b"
dependencies = [
"proc-macro2",
"quote",
- "syn 2.0.104",
+ "syn 2.0.114",
]
[[package]]
name = "windows-implement"
-version = "0.60.0"
+version = "0.60.2"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "a47fddd13af08290e67f4acabf4b459f647552718f683a7b415d290ac744a836"
+checksum = "053e2e040ab57b9dc951b72c264860db7eb3b0200ba345b4e4c3b14f67855ddf"
dependencies = [
"proc-macro2",
"quote",
- "syn 2.0.104",
+ "syn 2.0.114",
]
[[package]]
@@ -9425,51 +9525,45 @@ checksum = "053c4c462dc91d3b1504c6fe5a726dd15e216ba718e84a0e46a88fbe5ded3515"
dependencies = [
"proc-macro2",
"quote",
- "syn 2.0.104",
+ "syn 2.0.114",
]
[[package]]
name = "windows-interface"
-version = "0.59.1"
+version = "0.59.3"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "bd9211b69f8dcdfa817bfd14bf1c97c9188afa36f4750130fcdf3f400eca9fa8"
+checksum = "3f316c4a2570ba26bbec722032c4099d8c8bc095efccdc15688708623367e358"
dependencies = [
"proc-macro2",
"quote",
- "syn 2.0.104",
+ "syn 2.0.114",
]
[[package]]
name = "windows-link"
-version = "0.1.3"
+version = "0.2.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "5e6ad25900d524eaabdbbb96d20b4311e1e7ae1699af4fb28c17ae66c80d798a"
-
-[[package]]
-name = "windows-link"
-version = "0.2.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "45e46c0661abb7180e7b9c281db115305d49ca1709ab8242adf09666d2173c65"
+checksum = "f0805222e57f7521d6a62e36fa9163bc891acd422f971defe97d64e70d0a4fe5"
[[package]]
name = "windows-numerics"
-version = "0.2.0"
+version = "0.3.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "9150af68066c4c5c07ddc0ce30421554771e528bde427614c61038bc2c92c2b1"
+checksum = "6e2e40844ac143cdb44aead537bbf727de9b044e107a0f1220392177d15b0f26"
dependencies = [
- "windows-core 0.61.2",
- "windows-link 0.1.3",
+ "windows-core 0.62.2",
+ "windows-link",
]
[[package]]
name = "windows-registry"
-version = "0.5.3"
+version = "0.6.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "5b8a9ed28765efc97bbc954883f4e6796c33a06546ebafacbabee9696967499e"
+checksum = "02752bf7fbdcce7f2a27a742f798510f3e5ad88dbe84871e5168e2120c3d5720"
dependencies = [
- "windows-link 0.1.3",
- "windows-result 0.3.4",
- "windows-strings 0.4.2",
+ "windows-link",
+ "windows-result 0.4.1",
+ "windows-strings 0.5.1",
]
[[package]]
@@ -9483,11 +9577,11 @@ dependencies = [
[[package]]
name = "windows-result"
-version = "0.3.4"
+version = "0.4.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "56f42bd332cc6c8eac5af113fc0c1fd6a8fd2aa08a0119358686e5160d0586c6"
+checksum = "7781fa89eaf60850ac3d2da7af8e5242a5ea78d1a11c49bf2910bb5a73853eb5"
dependencies = [
- "windows-link 0.1.3",
+ "windows-link",
]
[[package]]
@@ -9502,11 +9596,11 @@ dependencies = [
[[package]]
name = "windows-strings"
-version = "0.4.2"
+version = "0.5.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "56e6c93f3a0c3b36176cb1327a4958a0353d5d166c2a35cb268ace15e91d3b57"
+checksum = "7837d08f69c77cf6b07689544538e017c1bfcf57e34b4c0ff58e6c2cd3b37091"
dependencies = [
- "windows-link 0.1.3",
+ "windows-link",
]
[[package]]
@@ -9551,16 +9645,16 @@ version = "0.60.2"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "f2f500e4d28234f72040990ec9d39e3a6b950f9f22d3dba18416c35882612bcb"
dependencies = [
- "windows-targets 0.53.2",
+ "windows-targets 0.53.5",
]
[[package]]
name = "windows-sys"
-version = "0.61.1"
+version = "0.61.2"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "6f109e41dd4a3c848907eb83d5a42ea98b3769495597450cf6d153507b166f0f"
+checksum = "ae137229bcbd6cdf0f7b80a31df61766145077ddf49416a728b02cb3921ff3fc"
dependencies = [
- "windows-link 0.2.0",
+ "windows-link",
]
[[package]]
@@ -9611,27 +9705,28 @@ dependencies = [
[[package]]
name = "windows-targets"
-version = "0.53.2"
+version = "0.53.5"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "c66f69fcc9ce11da9966ddb31a40968cad001c5bedeb5c2b82ede4253ab48aef"
+checksum = "4945f9f551b88e0d65f3db0bc25c33b8acea4d9e41163edf90dcd0b19f9069f3"
dependencies = [
- "windows_aarch64_gnullvm 0.53.0",
- "windows_aarch64_msvc 0.53.0",
- "windows_i686_gnu 0.53.0",
- "windows_i686_gnullvm 0.53.0",
- "windows_i686_msvc 0.53.0",
- "windows_x86_64_gnu 0.53.0",
- "windows_x86_64_gnullvm 0.53.0",
- "windows_x86_64_msvc 0.53.0",
+ "windows-link",
+ "windows_aarch64_gnullvm 0.53.1",
+ "windows_aarch64_msvc 0.53.1",
+ "windows_i686_gnu 0.53.1",
+ "windows_i686_gnullvm 0.53.1",
+ "windows_i686_msvc 0.53.1",
+ "windows_x86_64_gnu 0.53.1",
+ "windows_x86_64_gnullvm 0.53.1",
+ "windows_x86_64_msvc 0.53.1",
]
[[package]]
name = "windows-threading"
-version = "0.1.0"
+version = "0.2.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "b66463ad2e0ea3bbf808b7f1d371311c80e115c0b71d60efc142cafbcfb057a6"
+checksum = "3949bd5b99cafdf1c7ca86b43ca564028dfe27d66958f2470940f73d86d75b37"
dependencies = [
- "windows-link 0.1.3",
+ "windows-link",
]
[[package]]
@@ -9654,9 +9749,9 @@ checksum = "32a4622180e7a0ec044bb555404c800bc9fd9ec262ec147edd5989ccd0c02cd3"
[[package]]
name = "windows_aarch64_gnullvm"
-version = "0.53.0"
+version = "0.53.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "86b8d5f90ddd19cb4a147a5fa63ca848db3df085e25fee3cc10b39b6eebae764"
+checksum = "a9d8416fa8b42f5c947f8482c43e7d89e73a173cead56d044f6a56104a6d1b53"
[[package]]
name = "windows_aarch64_msvc"
@@ -9678,9 +9773,9 @@ checksum = "09ec2a7bb152e2252b53fa7803150007879548bc709c039df7627cabbd05d469"
[[package]]
name = "windows_aarch64_msvc"
-version = "0.53.0"
+version = "0.53.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "c7651a1f62a11b8cbd5e0d42526e55f2c99886c77e007179efff86c2b137e66c"
+checksum = "b9d782e804c2f632e395708e99a94275910eb9100b2114651e04744e9b125006"
[[package]]
name = "windows_i686_gnu"
@@ -9702,9 +9797,9 @@ checksum = "8e9b5ad5ab802e97eb8e295ac6720e509ee4c243f69d781394014ebfe8bbfa0b"
[[package]]
name = "windows_i686_gnu"
-version = "0.53.0"
+version = "0.53.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "c1dc67659d35f387f5f6c479dc4e28f1d4bb90ddd1a5d3da2e5d97b42d6272c3"
+checksum = "960e6da069d81e09becb0ca57a65220ddff016ff2d6af6a223cf372a506593a3"
[[package]]
name = "windows_i686_gnullvm"
@@ -9714,9 +9809,9 @@ checksum = "0eee52d38c090b3caa76c563b86c3a4bd71ef1a819287c19d586d7334ae8ed66"
[[package]]
name = "windows_i686_gnullvm"
-version = "0.53.0"
+version = "0.53.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "9ce6ccbdedbf6d6354471319e781c0dfef054c81fbc7cf83f338a4296c0cae11"
+checksum = "fa7359d10048f68ab8b09fa71c3daccfb0e9b559aed648a8f95469c27057180c"
[[package]]
name = "windows_i686_msvc"
@@ -9738,9 +9833,9 @@ checksum = "240948bc05c5e7c6dabba28bf89d89ffce3e303022809e73deaefe4f6ec56c66"
[[package]]
name = "windows_i686_msvc"
-version = "0.53.0"
+version = "0.53.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "581fee95406bb13382d2f65cd4a908ca7b1e4c2f1917f143ba16efe98a589b5d"
+checksum = "1e7ac75179f18232fe9c285163565a57ef8d3c89254a30685b57d83a38d326c2"
[[package]]
name = "windows_x86_64_gnu"
@@ -9762,9 +9857,9 @@ checksum = "147a5c80aabfbf0c7d901cb5895d1de30ef2907eb21fbbab29ca94c5b08b1a78"
[[package]]
name = "windows_x86_64_gnu"
-version = "0.53.0"
+version = "0.53.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "2e55b5ac9ea33f2fc1716d1742db15574fd6fc8dadc51caab1c16a3d3b4190ba"
+checksum = "9c3842cdd74a865a8066ab39c8a7a473c0778a3f29370b5fd6b4b9aa7df4a499"
[[package]]
name = "windows_x86_64_gnullvm"
@@ -9786,9 +9881,9 @@ checksum = "24d5b23dc417412679681396f2b49f3de8c1473deb516bd34410872eff51ed0d"
[[package]]
name = "windows_x86_64_gnullvm"
-version = "0.53.0"
+version = "0.53.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "0a6e035dd0599267ce1ee132e51c27dd29437f63325753051e71dd9e42406c57"
+checksum = "0ffa179e2d07eee8ad8f57493436566c7cc30ac536a3379fdf008f47f6bb7ae1"
[[package]]
name = "windows_x86_64_msvc"
@@ -9810,15 +9905,15 @@ checksum = "589f6da84c646204747d1270a2a5661ea66ed1cced2631d546fdfb155959f9ec"
[[package]]
name = "windows_x86_64_msvc"
-version = "0.53.0"
+version = "0.53.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "271414315aff87387382ec3d271b52d7ae78726f5d44ac98b4f4030c91880486"
+checksum = "d6bbff5f0aada427a1e5a6da5f1f98158182f26556f345ac9e04d36d0ebed650"
[[package]]
name = "winnow"
-version = "0.7.13"
+version = "0.7.14"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "21a0236b59786fed61e2a80582dd500fe61f18b5dca67a4a067d0bc9039339cf"
+checksum = "5a5364e9d77fcdeeaa6062ced926ee3381faa2ee02d3eb83a5c27a8825540829"
dependencies = [
"memchr",
]
@@ -9873,7 +9968,7 @@ dependencies = [
"base64",
"deadpool",
"futures",
- "http 1.3.1",
+ "http 1.4.0",
"http-body-util",
"hyper",
"hyper-util",
@@ -9887,26 +9982,22 @@ dependencies = [
]
[[package]]
-name = "wit-bindgen-rt"
-version = "0.39.0"
+name = "wit-bindgen"
+version = "0.51.0"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "6f42320e61fe2cfd34354ecb597f86f413484a798ba44a8ca1165c58d42da6c1"
-dependencies = [
- "bitflags 2.10.0",
-]
+checksum = "d7249219f66ced02969388cf2bb044a09756a083d0fab1e566056b04d9fbcaa5"
[[package]]
name = "wl-clipboard-rs"
-version = "0.9.2"
+version = "0.9.3"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "8e5ff8d0e60065f549fafd9d6cb626203ea64a798186c80d8e7df4f8af56baeb"
+checksum = "e9651471a32e87d96ef3a127715382b2d11cc7c8bb9822ded8a7cc94072eb0a3"
dependencies = [
"libc",
"log",
"os_pipe",
- "rustix 0.38.44",
- "tempfile",
- "thiserror 2.0.17",
+ "rustix 1.1.3",
+ "thiserror 2.0.18",
"tree_magic_mini",
"wayland-backend",
"wayland-client",
@@ -9922,20 +10013,20 @@ checksum = "9edde0db4769d2dc68579893f2306b26c6ecfbe0ef499b013d731b7b9247e0b9"
[[package]]
name = "x11rb"
-version = "0.13.1"
+version = "0.13.2"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "5d91ffca73ee7f68ce055750bf9f6eca0780b8c85eff9bc046a3b0da41755e12"
+checksum = "9993aa5be5a26815fe2c3eacfc1fde061fc1a1f094bf1ad2a18bf9c495dd7414"
dependencies = [
"gethostname",
- "rustix 0.38.44",
+ "rustix 1.1.3",
"x11rb-protocol",
]
[[package]]
name = "x11rb-protocol"
-version = "0.13.1"
+version = "0.13.2"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "ec107c4503ea0b4a98ef47356329af139c0a4f7750e621cf2973cd3385ebcb3d"
+checksum = "ea6fc2961e4ef194dcbfe56bb845534d0dc8098940c7e5c012a258bfec6701bd"
[[package]]
name = "xdg-home"
@@ -9955,11 +10046,10 @@ checksum = "cfe53a6657fd280eaa890a3bc59152892ffa3e30101319d168b781ed6529b049"
[[package]]
name = "yoke"
-version = "0.8.0"
+version = "0.8.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "5f41bb01b8226ef4bfd589436a297c53d118f65921786300e427be8d487695cc"
+checksum = "72d6e5c6afb84d73944e5cedb052c4680d5657337201555f9f2a16b7406d4954"
dependencies = [
- "serde",
"stable_deref_trait",
"yoke-derive",
"zerofrom",
@@ -9967,13 +10057,13 @@ dependencies = [
[[package]]
name = "yoke-derive"
-version = "0.8.0"
+version = "0.8.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "38da3c9736e16c5d3c8c597a9aaa5d1fa565d0532ae05e27c24aa62fb32c0ab6"
+checksum = "b659052874eb698efe5b9e8cf382204678a0086ebf46982b79d6ca3182927e5d"
dependencies = [
"proc-macro2",
"quote",
- "syn 2.0.104",
+ "syn 2.0.114",
"synstructure",
]
@@ -10024,7 +10114,7 @@ dependencies = [
"proc-macro-crate",
"proc-macro2",
"quote",
- "syn 2.0.104",
+ "syn 2.0.114",
"zvariant_utils",
]
@@ -10041,22 +10131,22 @@ dependencies = [
[[package]]
name = "zerocopy"
-version = "0.8.26"
+version = "0.8.37"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "1039dd0d3c310cf05de012d8a39ff557cb0d23087fd44cad61df08fc31907a2f"
+checksum = "7456cf00f0685ad319c5b1693f291a650eaf345e941d082fc4e03df8a03996ac"
dependencies = [
"zerocopy-derive",
]
[[package]]
name = "zerocopy-derive"
-version = "0.8.26"
+version = "0.8.37"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "9ecf5b4cc5364572d7f4c329661bcc82724222973f2cab6f050a4e5c22f75181"
+checksum = "1328722bbf2115db7e19d69ebcc15e795719e2d66b60827c6a69a117365e37a0"
dependencies = [
"proc-macro2",
"quote",
- "syn 2.0.104",
+ "syn 2.0.114",
]
[[package]]
@@ -10076,7 +10166,7 @@ checksum = "d71e5d6e06ab090c67b5e44993ec16b72dcbaabc526db883a360057678b48502"
dependencies = [
"proc-macro2",
"quote",
- "syn 2.0.104",
+ "syn 2.0.114",
"synstructure",
]
@@ -10091,20 +10181,20 @@ dependencies = [
[[package]]
name = "zeroize_derive"
-version = "1.4.2"
+version = "1.4.3"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "ce36e65b0d2999d2aafac989fb249189a141aee1f53c612c1f37d72631959f69"
+checksum = "85a5b4158499876c763cb03bc4e49185d3cccbabb15b33c627f7884f43db852e"
dependencies = [
"proc-macro2",
"quote",
- "syn 2.0.104",
+ "syn 2.0.114",
]
[[package]]
name = "zerotrie"
-version = "0.2.2"
+version = "0.2.3"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "36f0bbd478583f79edad978b407914f61b2972f5af6fa089686016be8f9af595"
+checksum = "2a59c17a5562d507e4b54960e8569ebee33bee890c70aa3fe7b97e85a9fd7851"
dependencies = [
"displaydoc",
"yoke",
@@ -10125,15 +10215,21 @@ dependencies = [
[[package]]
name = "zerovec-derive"
-version = "0.11.1"
+version = "0.11.2"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "5b96237efa0c878c64bd89c436f661be4e46b2f3eff1ebb976f7ef2321d2f58f"
+checksum = "eadce39539ca5cb3985590102671f2567e659fca9666581ad3411d59207951f3"
dependencies = [
"proc-macro2",
"quote",
- "syn 2.0.104",
+ "syn 2.0.114",
]
+[[package]]
+name = "zmij"
+version = "1.0.19"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "3ff05f8caa9038894637571ae6b9e29466c1f4f829d26c9b28f869a29cbe3445"
+
[[package]]
name = "zstd"
version = "0.13.3"
@@ -10170,26 +10266,26 @@ checksum = "3f423a2c17029964870cfaabb1f13dfab7d092a62a29a89264f4d36990ca414a"
[[package]]
name = "zune-core"
-version = "0.5.0"
+version = "0.5.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "111f7d9820f05fd715df3144e254d6fc02ee4088b0644c0ffd0efc9e6d9d2773"
+checksum = "cb8a0807f7c01457d0379ba880ba6322660448ddebc890ce29bb64da71fb40f9"
[[package]]
name = "zune-jpeg"
-version = "0.4.19"
+version = "0.4.21"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "2c9e525af0a6a658e031e95f14b7f889976b74a11ba0eca5a5fc9ac8a1c43a6a"
+checksum = "29ce2c8a9384ad323cf564b67da86e21d3cfdff87908bc1223ed5c99bc792713"
dependencies = [
"zune-core 0.4.12",
]
[[package]]
name = "zune-jpeg"
-version = "0.5.5"
+version = "0.5.12"
source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "dc6fb7703e32e9a07fb3f757360338b3a567a5054f21b5f52a666752e333d58e"
+checksum = "410e9ecef634c709e3831c2cfdb8d9c32164fae1c67496d5b68fff728eec37fe"
dependencies = [
- "zune-core 0.5.0",
+ "zune-core 0.5.1",
]
[[package]]
@@ -10214,7 +10310,7 @@ dependencies = [
"proc-macro-crate",
"proc-macro2",
"quote",
- "syn 2.0.104",
+ "syn 2.0.114",
"zvariant_utils",
]
@@ -10226,5 +10322,5 @@ checksum = "c51bcff7cc3dbb5055396bcf774748c3dab426b4b8659046963523cee4808340"
dependencies = [
"proc-macro2",
"quote",
- "syn 2.0.104",
+ "syn 2.0.114",
]
diff --git a/codex-rs/Cargo.toml b/codex-rs/Cargo.toml
index 327e6beeb0..3171c8a96c 100644
--- a/codex-rs/Cargo.toml
+++ b/codex-rs/Cargo.toml
@@ -43,12 +43,14 @@ 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"
@@ -80,6 +82,7 @@ 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" }
@@ -102,6 +105,7 @@ 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" }
@@ -153,6 +157,7 @@ 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"
diff --git a/codex-rs/app-server-protocol/BUILD.bazel b/codex-rs/app-server-protocol/BUILD.bazel
index a95310aded..b95356e742 100644
--- a/codex-rs/app-server-protocol/BUILD.bazel
+++ b/codex-rs/app-server-protocol/BUILD.bazel
@@ -3,4 +3,5 @@ load("//:defs.bzl", "codex_rust_crate")
codex_rust_crate(
name = "app-server-protocol",
crate_name = "codex_app_server_protocol",
+ test_data_extra = glob(["schema/**"], allow_empty = True),
)
diff --git a/codex-rs/app-server-protocol/Cargo.toml b/codex-rs/app-server-protocol/Cargo.toml
index 1c21bd6ea0..2788801051 100644
--- a/codex-rs/app-server-protocol/Cargo.toml
+++ b/codex-rs/app-server-protocol/Cargo.toml
@@ -15,6 +15,7 @@ workspace = true
anyhow = { workspace = true }
clap = { workspace = true, features = ["derive"] }
codex-protocol = { workspace = true }
+codex-experimental-api-macros = { workspace = true }
codex-utils-absolute-path = { workspace = true }
mcp-types = { workspace = true }
schemars = { workspace = true }
@@ -23,8 +24,12 @@ serde_json = { workspace = true }
strum_macros = { workspace = true }
thiserror = { workspace = true }
ts-rs = { workspace = true }
+inventory = { workspace = true }
uuid = { workspace = true, features = ["serde", "v7"] }
[dev-dependencies]
anyhow = { workspace = true }
+codex-utils-cargo-bin = { workspace = true }
pretty_assertions = { workspace = true }
+similar = { workspace = true }
+tempfile = { workspace = true }
diff --git a/codex-rs/app-server-protocol/schema/json/ApplyPatchApprovalParams.json b/codex-rs/app-server-protocol/schema/json/ApplyPatchApprovalParams.json
new file mode 100644
index 0000000000..da271c75ad
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/ApplyPatchApprovalParams.json
@@ -0,0 +1,114 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "definitions": {
+ "FileChange": {
+ "oneOf": [
+ {
+ "properties": {
+ "content": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "add"
+ ],
+ "title": "AddFileChangeType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "content",
+ "type"
+ ],
+ "title": "AddFileChange",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "content": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "delete"
+ ],
+ "title": "DeleteFileChangeType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "content",
+ "type"
+ ],
+ "title": "DeleteFileChange",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "move_path": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "update"
+ ],
+ "title": "UpdateFileChangeType",
+ "type": "string"
+ },
+ "unified_diff": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "unified_diff"
+ ],
+ "title": "UpdateFileChange",
+ "type": "object"
+ }
+ ]
+ },
+ "ThreadId": {
+ "type": "string"
+ }
+ },
+ "properties": {
+ "callId": {
+ "description": "Use to correlate this with [codex_core::protocol::PatchApplyBeginEvent] and [codex_core::protocol::PatchApplyEndEvent].",
+ "type": "string"
+ },
+ "conversationId": {
+ "$ref": "#/definitions/ThreadId"
+ },
+ "fileChanges": {
+ "additionalProperties": {
+ "$ref": "#/definitions/FileChange"
+ },
+ "type": "object"
+ },
+ "grantRoot": {
+ "description": "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"
+ ]
+ },
+ "reason": {
+ "description": "Optional explanatory reason (e.g. request for extra write access).",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "callId",
+ "conversationId",
+ "fileChanges"
+ ],
+ "title": "ApplyPatchApprovalParams",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/ApplyPatchApprovalResponse.json b/codex-rs/app-server-protocol/schema/json/ApplyPatchApprovalResponse.json
new file mode 100644
index 0000000000..b00ac1184e
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/ApplyPatchApprovalResponse.json
@@ -0,0 +1,73 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "definitions": {
+ "ReviewDecision": {
+ "description": "User's decision in response to an ExecApprovalRequest.",
+ "oneOf": [
+ {
+ "description": "User has approved this command and the agent should execute it.",
+ "enum": [
+ "approved"
+ ],
+ "type": "string"
+ },
+ {
+ "additionalProperties": false,
+ "description": "User has approved this command and wants to apply the proposed execpolicy amendment so future matching commands are permitted.",
+ "properties": {
+ "approved_execpolicy_amendment": {
+ "properties": {
+ "proposed_execpolicy_amendment": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ }
+ },
+ "required": [
+ "proposed_execpolicy_amendment"
+ ],
+ "type": "object"
+ }
+ },
+ "required": [
+ "approved_execpolicy_amendment"
+ ],
+ "title": "ApprovedExecpolicyAmendmentReviewDecision",
+ "type": "object"
+ },
+ {
+ "description": "User has approved this command and wants to automatically approve any future identical instances (`command` and `cwd` match exactly) for the remainder of the session.",
+ "enum": [
+ "approved_for_session"
+ ],
+ "type": "string"
+ },
+ {
+ "description": "User has denied this command and the agent should not execute it, but it should continue the session and try something else.",
+ "enum": [
+ "denied"
+ ],
+ "type": "string"
+ },
+ {
+ "description": "User has denied this command and the agent should not do anything until the user's next command.",
+ "enum": [
+ "abort"
+ ],
+ "type": "string"
+ }
+ ]
+ }
+ },
+ "properties": {
+ "decision": {
+ "$ref": "#/definitions/ReviewDecision"
+ }
+ },
+ "required": [
+ "decision"
+ ],
+ "title": "ApplyPatchApprovalResponse",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/ChatgptAuthTokensRefreshParams.json b/codex-rs/app-server-protocol/schema/json/ChatgptAuthTokensRefreshParams.json
new file mode 100644
index 0000000000..b3e828e80d
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/ChatgptAuthTokensRefreshParams.json
@@ -0,0 +1,33 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "definitions": {
+ "ChatgptAuthTokensRefreshReason": {
+ "oneOf": [
+ {
+ "description": "Codex attempted a backend request and received `401 Unauthorized`.",
+ "enum": [
+ "unauthorized"
+ ],
+ "type": "string"
+ }
+ ]
+ }
+ },
+ "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"
+ ],
+ "title": "ChatgptAuthTokensRefreshParams",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/ChatgptAuthTokensRefreshResponse.json b/codex-rs/app-server-protocol/schema/json/ChatgptAuthTokensRefreshResponse.json
new file mode 100644
index 0000000000..48d149492d
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/ChatgptAuthTokensRefreshResponse.json
@@ -0,0 +1,17 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "accessToken": {
+ "type": "string"
+ },
+ "idToken": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "accessToken",
+ "idToken"
+ ],
+ "title": "ChatgptAuthTokensRefreshResponse",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/ClientNotification.json b/codex-rs/app-server-protocol/schema/json/ClientNotification.json
new file mode 100644
index 0000000000..dde0b31fbd
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/ClientNotification.json
@@ -0,0 +1,22 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "oneOf": [
+ {
+ "properties": {
+ "method": {
+ "enum": [
+ "initialized"
+ ],
+ "title": "InitializedNotificationMethod",
+ "type": "string"
+ }
+ },
+ "required": [
+ "method"
+ ],
+ "title": "InitializedNotification",
+ "type": "object"
+ }
+ ],
+ "title": "ClientNotification"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/ClientRequest.json b/codex-rs/app-server-protocol/schema/json/ClientRequest.json
new file mode 100644
index 0000000000..85e5940bc3
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/ClientRequest.json
@@ -0,0 +1,4333 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "definitions": {
+ "AbsolutePathBuf": {
+ "description": "A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem).\n\nIMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set, the deserialization will fail unless the path being deserialized is already absolute.",
+ "type": "string"
+ },
+ "AddConversationListenerParams": {
+ "properties": {
+ "conversationId": {
+ "$ref": "#/definitions/ThreadId"
+ },
+ "experimentalRawEvents": {
+ "default": false,
+ "type": "boolean"
+ }
+ },
+ "required": [
+ "conversationId"
+ ],
+ "type": "object"
+ },
+ "AppsListParams": {
+ "properties": {
+ "cursor": {
+ "description": "Opaque pagination cursor returned by a previous call.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "limit": {
+ "description": "Optional page size; defaults to a reasonable server-side value.",
+ "format": "uint32",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "ArchiveConversationParams": {
+ "properties": {
+ "conversationId": {
+ "$ref": "#/definitions/ThreadId"
+ },
+ "rolloutPath": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "conversationId",
+ "rolloutPath"
+ ],
+ "type": "object"
+ },
+ "AskForApproval": {
+ "enum": [
+ "untrusted",
+ "on-failure",
+ "on-request",
+ "never"
+ ],
+ "type": "string"
+ },
+ "AskForApproval2": {
+ "description": "Determines the conditions under which the user is consulted to approve running the command proposed by Codex.",
+ "oneOf": [
+ {
+ "description": "Under this policy, only \"known safe\" commands—as determined by `is_safe_command()`—that **only read files** are auto‑approved. Everything else will ask the user to approve.",
+ "enum": [
+ "untrusted"
+ ],
+ "type": "string"
+ },
+ {
+ "description": "*All* commands are auto‑approved, but they are expected to run inside a sandbox where network access is disabled and writes are confined to a specific set of paths. If the command fails, it will be escalated to the user to approve execution without a sandbox.",
+ "enum": [
+ "on-failure"
+ ],
+ "type": "string"
+ },
+ {
+ "description": "The model decides when to ask the user for approval.",
+ "enum": [
+ "on-request"
+ ],
+ "type": "string"
+ },
+ {
+ "description": "Never ask the user to approve commands. Failures are immediately returned to the model, and never escalated to the user for approval.",
+ "enum": [
+ "never"
+ ],
+ "type": "string"
+ }
+ ]
+ },
+ "ByteRange": {
+ "properties": {
+ "end": {
+ "format": "uint",
+ "minimum": 0.0,
+ "type": "integer"
+ },
+ "start": {
+ "format": "uint",
+ "minimum": 0.0,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "end",
+ "start"
+ ],
+ "type": "object"
+ },
+ "CancelLoginAccountParams": {
+ "properties": {
+ "loginId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "loginId"
+ ],
+ "type": "object"
+ },
+ "CancelLoginChatGptParams": {
+ "properties": {
+ "loginId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "loginId"
+ ],
+ "type": "object"
+ },
+ "ClientInfo": {
+ "properties": {
+ "name": {
+ "type": "string"
+ },
+ "title": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "version": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "version"
+ ],
+ "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": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "cwd": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "sandboxPolicy": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/SandboxPolicy"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "timeoutMs": {
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "command"
+ ],
+ "type": "object"
+ },
+ "ConfigBatchWriteParams": {
+ "properties": {
+ "edits": {
+ "items": {
+ "$ref": "#/definitions/ConfigEdit"
+ },
+ "type": "array"
+ },
+ "expectedVersion": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "filePath": {
+ "description": "Path to the config file to write; defaults to the user's `config.toml` when omitted.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "edits"
+ ],
+ "type": "object"
+ },
+ "ConfigEdit": {
+ "properties": {
+ "keyPath": {
+ "type": "string"
+ },
+ "mergeStrategy": {
+ "$ref": "#/definitions/MergeStrategy"
+ },
+ "value": true
+ },
+ "required": [
+ "keyPath",
+ "mergeStrategy",
+ "value"
+ ],
+ "type": "object"
+ },
+ "ConfigReadParams": {
+ "properties": {
+ "cwd": {
+ "description": "Optional working directory to resolve project config layers. If specified, return the effective config as seen from that directory (i.e., including any project layers between `cwd` and the project/repo root).",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "includeLayers": {
+ "default": false,
+ "type": "boolean"
+ }
+ },
+ "type": "object"
+ },
+ "ConfigValueWriteParams": {
+ "properties": {
+ "expectedVersion": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "filePath": {
+ "description": "Path to the config file to write; defaults to the user's `config.toml` when omitted.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "keyPath": {
+ "type": "string"
+ },
+ "mergeStrategy": {
+ "$ref": "#/definitions/MergeStrategy"
+ },
+ "value": true
+ },
+ "required": [
+ "keyPath",
+ "mergeStrategy",
+ "value"
+ ],
+ "type": "object"
+ },
+ "ContentItem": {
+ "oneOf": [
+ {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "input_text"
+ ],
+ "title": "InputTextContentItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "InputTextContentItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "image_url": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "input_image"
+ ],
+ "title": "InputImageContentItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "image_url",
+ "type"
+ ],
+ "title": "InputImageContentItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "output_text"
+ ],
+ "title": "OutputTextContentItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "OutputTextContentItem",
+ "type": "object"
+ }
+ ]
+ },
+ "DynamicToolSpec": {
+ "properties": {
+ "description": {
+ "type": "string"
+ },
+ "inputSchema": true,
+ "name": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "description",
+ "inputSchema",
+ "name"
+ ],
+ "type": "object"
+ },
+ "ExecOneOffCommandParams": {
+ "properties": {
+ "command": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "cwd": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "sandboxPolicy": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/SandboxPolicy2"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "timeoutMs": {
+ "format": "uint64",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "command"
+ ],
+ "type": "object"
+ },
+ "FeedbackUploadParams": {
+ "properties": {
+ "classification": {
+ "type": "string"
+ },
+ "includeLogs": {
+ "type": "boolean"
+ },
+ "reason": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "threadId": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "classification",
+ "includeLogs"
+ ],
+ "type": "object"
+ },
+ "ForkConversationParams": {
+ "properties": {
+ "conversationId": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ThreadId"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "overrides": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/NewConversationParams"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "path": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "FunctionCallOutputContentItem": {
+ "description": "Responses API compatible content items that can be returned by a tool call. This is a subset of ContentItem with the types we support as function call outputs.",
+ "oneOf": [
+ {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "input_text"
+ ],
+ "title": "InputTextFunctionCallOutputContentItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "InputTextFunctionCallOutputContentItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "image_url": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "input_image"
+ ],
+ "title": "InputImageFunctionCallOutputContentItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "image_url",
+ "type"
+ ],
+ "title": "InputImageFunctionCallOutputContentItem",
+ "type": "object"
+ }
+ ]
+ },
+ "FunctionCallOutputPayload": {
+ "description": "The payload we send back to OpenAI when reporting a tool call result.\n\n`content` preserves the historical plain-string payload so downstream integrations (tests, logging, etc.) can keep treating tool output as `String`. When an MCP server returns richer data we additionally populate `content_items` with the structured form that the Responses/Chat Completions APIs understand.",
+ "properties": {
+ "content": {
+ "type": "string"
+ },
+ "content_items": {
+ "items": {
+ "$ref": "#/definitions/FunctionCallOutputContentItem"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "success": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "content"
+ ],
+ "type": "object"
+ },
+ "FuzzyFileSearchParams": {
+ "properties": {
+ "cancellationToken": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "query": {
+ "type": "string"
+ },
+ "roots": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ }
+ },
+ "required": [
+ "query",
+ "roots"
+ ],
+ "type": "object"
+ },
+ "GetAccountParams": {
+ "properties": {
+ "refreshToken": {
+ "default": false,
+ "description": "When `true`, requests a proactive token refresh before returning.\n\nIn managed auth mode this triggers the normal refresh-token flow. In external auth mode this flag is ignored. Clients should refresh tokens themselves and call `account/login/start` with `chatgptAuthTokens`.",
+ "type": "boolean"
+ }
+ },
+ "type": "object"
+ },
+ "GetAuthStatusParams": {
+ "properties": {
+ "includeToken": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "refreshToken": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "GetConversationSummaryParams": {
+ "anyOf": [
+ {
+ "properties": {
+ "rolloutPath": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "rolloutPath"
+ ],
+ "title": "RolloutPathGetConversationSummaryParams",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "conversationId": {
+ "$ref": "#/definitions/ThreadId"
+ }
+ },
+ "required": [
+ "conversationId"
+ ],
+ "title": "ConversationIdGetConversationSummaryParams",
+ "type": "object"
+ }
+ ]
+ },
+ "GhostCommit": {
+ "description": "Details of a ghost commit created from a repository state.",
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "parent": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "preexisting_untracked_dirs": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "preexisting_untracked_files": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ }
+ },
+ "required": [
+ "id",
+ "preexisting_untracked_dirs",
+ "preexisting_untracked_files"
+ ],
+ "type": "object"
+ },
+ "GitDiffToRemoteParams": {
+ "properties": {
+ "cwd": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "cwd"
+ ],
+ "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"
+ }
+ },
+ "required": [
+ "clientInfo"
+ ],
+ "type": "object"
+ },
+ "InputItem": {
+ "oneOf": [
+ {
+ "properties": {
+ "data": {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "text_elements": {
+ "default": [],
+ "description": "UI-defined spans within `text` used to render or persist special elements.",
+ "items": {
+ "$ref": "#/definitions/V1TextElement"
+ },
+ "type": "array"
+ }
+ },
+ "required": [
+ "text"
+ ],
+ "type": "object"
+ },
+ "type": {
+ "enum": [
+ "text"
+ ],
+ "title": "TextInputItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "data",
+ "type"
+ ],
+ "title": "TextInputItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "data": {
+ "properties": {
+ "image_url": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "image_url"
+ ],
+ "type": "object"
+ },
+ "type": {
+ "enum": [
+ "image"
+ ],
+ "title": "ImageInputItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "data",
+ "type"
+ ],
+ "title": "ImageInputItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "data": {
+ "properties": {
+ "path": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "path"
+ ],
+ "type": "object"
+ },
+ "type": {
+ "enum": [
+ "localImage"
+ ],
+ "title": "LocalImageInputItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "data",
+ "type"
+ ],
+ "title": "LocalImageInputItem",
+ "type": "object"
+ }
+ ]
+ },
+ "InterruptConversationParams": {
+ "properties": {
+ "conversationId": {
+ "$ref": "#/definitions/ThreadId"
+ }
+ },
+ "required": [
+ "conversationId"
+ ],
+ "type": "object"
+ },
+ "ListConversationsParams": {
+ "properties": {
+ "cursor": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "modelProviders": {
+ "items": {
+ "type": "string"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "pageSize": {
+ "format": "uint",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "ListMcpServerStatusParams": {
+ "properties": {
+ "cursor": {
+ "description": "Opaque pagination cursor returned by a previous call.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "limit": {
+ "description": "Optional page size; defaults to a server-defined value.",
+ "format": "uint32",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "LocalShellAction": {
+ "oneOf": [
+ {
+ "properties": {
+ "command": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "env": {
+ "additionalProperties": {
+ "type": "string"
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "timeout_ms": {
+ "format": "uint64",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "exec"
+ ],
+ "title": "ExecLocalShellActionType",
+ "type": "string"
+ },
+ "user": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "working_directory": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "command",
+ "type"
+ ],
+ "title": "ExecLocalShellAction",
+ "type": "object"
+ }
+ ]
+ },
+ "LocalShellStatus": {
+ "enum": [
+ "completed",
+ "in_progress",
+ "incomplete"
+ ],
+ "type": "string"
+ },
+ "LoginAccountParams": {
+ "oneOf": [
+ {
+ "properties": {
+ "apiKey": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "apiKey"
+ ],
+ "title": "ApiKeyLoginAccountParamsType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "apiKey",
+ "type"
+ ],
+ "title": "ApiKeyLoginAccountParams",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "chatgpt"
+ ],
+ "title": "ChatgptLoginAccountParamsType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "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"
+ }
+ ]
+ },
+ "LoginApiKeyParams": {
+ "properties": {
+ "apiKey": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "apiKey"
+ ],
+ "type": "object"
+ },
+ "McpServerOauthLoginParams": {
+ "properties": {
+ "name": {
+ "type": "string"
+ },
+ "scopes": {
+ "items": {
+ "type": "string"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "timeoutSecs": {
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "name"
+ ],
+ "type": "object"
+ },
+ "MergeStrategy": {
+ "enum": [
+ "replace",
+ "upsert"
+ ],
+ "type": "string"
+ },
+ "ModeKind": {
+ "description": "Initial collaboration mode to use when the TUI starts.",
+ "enum": [
+ "plan",
+ "code",
+ "pair_programming",
+ "execute",
+ "custom"
+ ],
+ "type": "string"
+ },
+ "ModelListParams": {
+ "properties": {
+ "cursor": {
+ "description": "Opaque pagination cursor returned by a previous call.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "limit": {
+ "description": "Optional page size; defaults to a reasonable server-side value.",
+ "format": "uint32",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "NetworkAccess": {
+ "enum": [
+ "restricted",
+ "enabled"
+ ],
+ "type": "string"
+ },
+ "NetworkAccess2": {
+ "description": "Represents whether outbound network access is available to the agent.",
+ "enum": [
+ "restricted",
+ "enabled"
+ ],
+ "type": "string"
+ },
+ "NewConversationParams": {
+ "properties": {
+ "approvalPolicy": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/AskForApproval2"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "baseInstructions": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "compactPrompt": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "config": {
+ "additionalProperties": true,
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "cwd": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "developerInstructions": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "includeApplyPatchTool": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "model": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "modelProvider": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "profile": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "sandbox": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/SandboxMode2"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "Personality": {
+ "enum": [
+ "friendly",
+ "pragmatic"
+ ],
+ "type": "string"
+ },
+ "ReasoningEffort": {
+ "description": "See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#get-started-with-reasoning",
+ "enum": [
+ "none",
+ "minimal",
+ "low",
+ "medium",
+ "high",
+ "xhigh"
+ ],
+ "type": "string"
+ },
+ "ReasoningItemContent": {
+ "oneOf": [
+ {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "reasoning_text"
+ ],
+ "title": "ReasoningTextReasoningItemContentType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "ReasoningTextReasoningItemContent",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "text"
+ ],
+ "title": "TextReasoningItemContentType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "TextReasoningItemContent",
+ "type": "object"
+ }
+ ]
+ },
+ "ReasoningItemReasoningSummary": {
+ "oneOf": [
+ {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "summary_text"
+ ],
+ "title": "SummaryTextReasoningItemReasoningSummaryType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "SummaryTextReasoningItemReasoningSummary",
+ "type": "object"
+ }
+ ]
+ },
+ "ReasoningSummary": {
+ "description": "A summary of the reasoning performed by the model. This can be useful for debugging and understanding the model's reasoning process. See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#reasoning-summaries",
+ "oneOf": [
+ {
+ "enum": [
+ "auto",
+ "concise",
+ "detailed"
+ ],
+ "type": "string"
+ },
+ {
+ "description": "Option to disable reasoning summaries.",
+ "enum": [
+ "none"
+ ],
+ "type": "string"
+ }
+ ]
+ },
+ "RemoveConversationListenerParams": {
+ "properties": {
+ "subscriptionId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "subscriptionId"
+ ],
+ "type": "object"
+ },
+ "RequestId": {
+ "anyOf": [
+ {
+ "type": "string"
+ },
+ {
+ "format": "int64",
+ "type": "integer"
+ }
+ ]
+ },
+ "ResponseItem": {
+ "oneOf": [
+ {
+ "properties": {
+ "content": {
+ "items": {
+ "$ref": "#/definitions/ContentItem"
+ },
+ "type": "array"
+ },
+ "end_turn": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "id": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "writeOnly": true
+ },
+ "role": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "message"
+ ],
+ "title": "MessageResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "content",
+ "role",
+ "type"
+ ],
+ "title": "MessageResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "content": {
+ "default": null,
+ "items": {
+ "$ref": "#/definitions/ReasoningItemContent"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "encrypted_content": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "id": {
+ "type": "string",
+ "writeOnly": true
+ },
+ "summary": {
+ "items": {
+ "$ref": "#/definitions/ReasoningItemReasoningSummary"
+ },
+ "type": "array"
+ },
+ "type": {
+ "enum": [
+ "reasoning"
+ ],
+ "title": "ReasoningResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "summary",
+ "type"
+ ],
+ "title": "ReasoningResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "action": {
+ "$ref": "#/definitions/LocalShellAction"
+ },
+ "call_id": {
+ "description": "Set when using the Responses API.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "id": {
+ "description": "Set when using the chat completions API.",
+ "type": [
+ "string",
+ "null"
+ ],
+ "writeOnly": true
+ },
+ "status": {
+ "$ref": "#/definitions/LocalShellStatus"
+ },
+ "type": {
+ "enum": [
+ "local_shell_call"
+ ],
+ "title": "LocalShellCallResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "action",
+ "status",
+ "type"
+ ],
+ "title": "LocalShellCallResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "arguments": {
+ "type": "string"
+ },
+ "call_id": {
+ "type": "string"
+ },
+ "id": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "writeOnly": true
+ },
+ "name": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "function_call"
+ ],
+ "title": "FunctionCallResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "arguments",
+ "call_id",
+ "name",
+ "type"
+ ],
+ "title": "FunctionCallResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "call_id": {
+ "type": "string"
+ },
+ "output": {
+ "$ref": "#/definitions/FunctionCallOutputPayload"
+ },
+ "type": {
+ "enum": [
+ "function_call_output"
+ ],
+ "title": "FunctionCallOutputResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "output",
+ "type"
+ ],
+ "title": "FunctionCallOutputResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "call_id": {
+ "type": "string"
+ },
+ "id": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "writeOnly": true
+ },
+ "input": {
+ "type": "string"
+ },
+ "name": {
+ "type": "string"
+ },
+ "status": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "custom_tool_call"
+ ],
+ "title": "CustomToolCallResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "input",
+ "name",
+ "type"
+ ],
+ "title": "CustomToolCallResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "call_id": {
+ "type": "string"
+ },
+ "output": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "custom_tool_call_output"
+ ],
+ "title": "CustomToolCallOutputResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "output",
+ "type"
+ ],
+ "title": "CustomToolCallOutputResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "action": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/WebSearchAction"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "id": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "writeOnly": true
+ },
+ "status": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "web_search_call"
+ ],
+ "title": "WebSearchCallResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "WebSearchCallResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "ghost_commit": {
+ "$ref": "#/definitions/GhostCommit"
+ },
+ "type": {
+ "enum": [
+ "ghost_snapshot"
+ ],
+ "title": "GhostSnapshotResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "ghost_commit",
+ "type"
+ ],
+ "title": "GhostSnapshotResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "encrypted_content": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "compaction"
+ ],
+ "title": "CompactionResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "encrypted_content",
+ "type"
+ ],
+ "title": "CompactionResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "other"
+ ],
+ "title": "OtherResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "OtherResponseItem",
+ "type": "object"
+ }
+ ]
+ },
+ "ResumeConversationParams": {
+ "properties": {
+ "conversationId": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ThreadId"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "history": {
+ "items": {
+ "$ref": "#/definitions/ResponseItem"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "overrides": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/NewConversationParams"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "path": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "ReviewDelivery": {
+ "enum": [
+ "inline",
+ "detached"
+ ],
+ "type": "string"
+ },
+ "ReviewStartParams": {
+ "properties": {
+ "delivery": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ReviewDelivery"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "default": null,
+ "description": "Where to run the review: inline (default) on the current thread or detached on a new thread (returned in `reviewThreadId`)."
+ },
+ "target": {
+ "$ref": "#/definitions/ReviewTarget"
+ },
+ "threadId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "target",
+ "threadId"
+ ],
+ "type": "object"
+ },
+ "ReviewTarget": {
+ "oneOf": [
+ {
+ "description": "Review the working tree: staged, unstaged, and untracked files.",
+ "properties": {
+ "type": {
+ "enum": [
+ "uncommittedChanges"
+ ],
+ "title": "UncommittedChangesReviewTargetType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "UncommittedChangesReviewTarget",
+ "type": "object"
+ },
+ {
+ "description": "Review changes between the current branch and the given base branch.",
+ "properties": {
+ "branch": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "baseBranch"
+ ],
+ "title": "BaseBranchReviewTargetType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "branch",
+ "type"
+ ],
+ "title": "BaseBranchReviewTarget",
+ "type": "object"
+ },
+ {
+ "description": "Review the changes introduced by a specific commit.",
+ "properties": {
+ "sha": {
+ "type": "string"
+ },
+ "title": {
+ "description": "Optional human-readable label (e.g., commit subject) for UIs.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "commit"
+ ],
+ "title": "CommitReviewTargetType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "sha",
+ "type"
+ ],
+ "title": "CommitReviewTarget",
+ "type": "object"
+ },
+ {
+ "description": "Arbitrary instructions, equivalent to the old free-form prompt.",
+ "properties": {
+ "instructions": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "custom"
+ ],
+ "title": "CustomReviewTargetType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "instructions",
+ "type"
+ ],
+ "title": "CustomReviewTarget",
+ "type": "object"
+ }
+ ]
+ },
+ "SandboxMode": {
+ "enum": [
+ "read-only",
+ "workspace-write",
+ "danger-full-access"
+ ],
+ "type": "string"
+ },
+ "SandboxMode2": {
+ "enum": [
+ "read-only",
+ "workspace-write",
+ "danger-full-access"
+ ],
+ "type": "string"
+ },
+ "SandboxPolicy": {
+ "oneOf": [
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "dangerFullAccess"
+ ],
+ "title": "DangerFullAccessSandboxPolicyType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "DangerFullAccessSandboxPolicy",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "readOnly"
+ ],
+ "title": "ReadOnlySandboxPolicyType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "ReadOnlySandboxPolicy",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "networkAccess": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/NetworkAccess"
+ }
+ ],
+ "default": "restricted"
+ },
+ "type": {
+ "enum": [
+ "externalSandbox"
+ ],
+ "title": "ExternalSandboxSandboxPolicyType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "ExternalSandboxSandboxPolicy",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "excludeSlashTmp": {
+ "default": false,
+ "type": "boolean"
+ },
+ "excludeTmpdirEnvVar": {
+ "default": false,
+ "type": "boolean"
+ },
+ "networkAccess": {
+ "default": false,
+ "type": "boolean"
+ },
+ "type": {
+ "enum": [
+ "workspaceWrite"
+ ],
+ "title": "WorkspaceWriteSandboxPolicyType",
+ "type": "string"
+ },
+ "writableRoots": {
+ "default": [],
+ "items": {
+ "$ref": "#/definitions/AbsolutePathBuf"
+ },
+ "type": "array"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "WorkspaceWriteSandboxPolicy",
+ "type": "object"
+ }
+ ]
+ },
+ "SandboxPolicy2": {
+ "description": "Determines execution restrictions for model shell commands.",
+ "oneOf": [
+ {
+ "description": "No restrictions whatsoever. Use with caution.",
+ "properties": {
+ "type": {
+ "enum": [
+ "danger-full-access"
+ ],
+ "title": "DangerFullAccessSandboxPolicy2Type",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "DangerFullAccessSandboxPolicy2",
+ "type": "object"
+ },
+ {
+ "description": "Read-only access to the entire file-system.",
+ "properties": {
+ "type": {
+ "enum": [
+ "read-only"
+ ],
+ "title": "ReadOnlySandboxPolicy2Type",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "ReadOnlySandboxPolicy2",
+ "type": "object"
+ },
+ {
+ "description": "Indicates the process is already in an external sandbox. Allows full disk access while honoring the provided network setting.",
+ "properties": {
+ "network_access": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/NetworkAccess2"
+ }
+ ],
+ "default": "restricted",
+ "description": "Whether the external sandbox permits outbound network traffic."
+ },
+ "type": {
+ "enum": [
+ "external-sandbox"
+ ],
+ "title": "ExternalSandboxSandboxPolicy2Type",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "ExternalSandboxSandboxPolicy2",
+ "type": "object"
+ },
+ {
+ "description": "Same as `ReadOnly` but additionally grants write access to the current working directory (\"workspace\").",
+ "properties": {
+ "exclude_slash_tmp": {
+ "default": false,
+ "description": "When set to `true`, will NOT include the `/tmp` among the default writable roots on UNIX. Defaults to `false`.",
+ "type": "boolean"
+ },
+ "exclude_tmpdir_env_var": {
+ "default": false,
+ "description": "When set to `true`, will NOT include the per-user `TMPDIR` environment variable among the default writable roots. Defaults to `false`.",
+ "type": "boolean"
+ },
+ "network_access": {
+ "default": false,
+ "description": "When set to `true`, outbound network access is allowed. `false` by default.",
+ "type": "boolean"
+ },
+ "type": {
+ "enum": [
+ "workspace-write"
+ ],
+ "title": "WorkspaceWriteSandboxPolicy2Type",
+ "type": "string"
+ },
+ "writable_roots": {
+ "description": "Additional folders (beyond cwd and possibly TMPDIR) that should be writable from within the sandbox.",
+ "items": {
+ "$ref": "#/definitions/AbsolutePathBuf"
+ },
+ "type": "array"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "WorkspaceWriteSandboxPolicy2",
+ "type": "object"
+ }
+ ]
+ },
+ "SendUserMessageParams": {
+ "properties": {
+ "conversationId": {
+ "$ref": "#/definitions/ThreadId"
+ },
+ "items": {
+ "items": {
+ "$ref": "#/definitions/InputItem"
+ },
+ "type": "array"
+ }
+ },
+ "required": [
+ "conversationId",
+ "items"
+ ],
+ "type": "object"
+ },
+ "SendUserTurnParams": {
+ "properties": {
+ "approvalPolicy": {
+ "$ref": "#/definitions/AskForApproval2"
+ },
+ "conversationId": {
+ "$ref": "#/definitions/ThreadId"
+ },
+ "cwd": {
+ "type": "string"
+ },
+ "effort": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ReasoningEffort"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "items": {
+ "items": {
+ "$ref": "#/definitions/InputItem"
+ },
+ "type": "array"
+ },
+ "model": {
+ "type": "string"
+ },
+ "outputSchema": {
+ "description": "Optional JSON Schema used to constrain the final assistant message for this turn."
+ },
+ "sandboxPolicy": {
+ "$ref": "#/definitions/SandboxPolicy2"
+ },
+ "summary": {
+ "$ref": "#/definitions/ReasoningSummary"
+ }
+ },
+ "required": [
+ "approvalPolicy",
+ "conversationId",
+ "cwd",
+ "items",
+ "model",
+ "sandboxPolicy",
+ "summary"
+ ],
+ "type": "object"
+ },
+ "SetDefaultModelParams": {
+ "properties": {
+ "model": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "reasoningEffort": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ReasoningEffort"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ }
+ },
+ "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": {
+ "type": "boolean"
+ },
+ "path": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "enabled",
+ "path"
+ ],
+ "type": "object"
+ },
+ "SkillsListParams": {
+ "properties": {
+ "cwds": {
+ "description": "When empty, defaults to the current session working directory.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "forceReload": {
+ "description": "When true, bypass the skills cache and re-scan skills from disk.",
+ "type": "boolean"
+ }
+ },
+ "type": "object"
+ },
+ "TextElement": {
+ "properties": {
+ "byteRange": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ByteRange"
+ }
+ ],
+ "description": "Byte range in the parent `text` buffer that this element occupies."
+ },
+ "placeholder": {
+ "description": "Optional human-readable placeholder for the element, displayed in the UI.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "byteRange"
+ ],
+ "type": "object"
+ },
+ "ThreadArchiveParams": {
+ "properties": {
+ "threadId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "threadId"
+ ],
+ "type": "object"
+ },
+ "ThreadForkParams": {
+ "description": "There are two ways to fork a thread: 1. By thread_id: load the thread from disk by thread_id and fork it into a new thread. 2. By path: load the thread from disk by path and fork it into a new thread.\n\nIf using path, the thread_id param will be ignored.\n\nPrefer using thread_id whenever possible.",
+ "properties": {
+ "approvalPolicy": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/AskForApproval"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "baseInstructions": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "config": {
+ "additionalProperties": true,
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "cwd": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "developerInstructions": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "model": {
+ "description": "Configuration overrides for the forked thread, if any.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "modelProvider": {
+ "type": [
+ "string",
+ "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": [
+ {
+ "$ref": "#/definitions/SandboxMode"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "threadId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "threadId"
+ ],
+ "type": "object"
+ },
+ "ThreadId": {
+ "type": "string"
+ },
+ "ThreadListParams": {
+ "properties": {
+ "archived": {
+ "description": "Optional archived filter; when set to true, only archived threads are returned. If false or null, only non-archived threads are returned.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "cursor": {
+ "description": "Opaque pagination cursor returned by a previous call.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "limit": {
+ "description": "Optional page size; defaults to a reasonable server-side value.",
+ "format": "uint32",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "modelProviders": {
+ "description": "Optional provider filter; when set, only sessions recorded under these providers are returned. When present but empty, includes all providers.",
+ "items": {
+ "type": "string"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "sortKey": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ThreadSortKey"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Optional sort key; defaults to created_at."
+ },
+ "sourceKinds": {
+ "description": "Optional source filter; when set, only sessions from these source kinds are returned. When omitted or empty, defaults to interactive sources.",
+ "items": {
+ "$ref": "#/definitions/ThreadSourceKind"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "ThreadLoadedListParams": {
+ "properties": {
+ "cursor": {
+ "description": "Opaque pagination cursor returned by a previous call.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "limit": {
+ "description": "Optional page size; defaults to no limit.",
+ "format": "uint32",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "ThreadReadParams": {
+ "properties": {
+ "includeTurns": {
+ "default": false,
+ "description": "When true, include turns and their items from rollout history.",
+ "type": "boolean"
+ },
+ "threadId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "threadId"
+ ],
+ "type": "object"
+ },
+ "ThreadResumeParams": {
+ "description": "There are three ways to resume a thread: 1. By thread_id: load the thread from disk by thread_id and resume it. 2. By history: instantiate the thread from memory and resume it. 3. By path: load the thread from disk by path and resume it.\n\nThe precedence is: history > path > thread_id. If using history or path, the thread_id param will be ignored.\n\nPrefer using thread_id whenever possible.",
+ "properties": {
+ "approvalPolicy": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/AskForApproval"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "baseInstructions": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "config": {
+ "additionalProperties": true,
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "cwd": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "developerInstructions": {
+ "type": [
+ "string",
+ "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": [
+ "string",
+ "null"
+ ]
+ },
+ "modelProvider": {
+ "type": [
+ "string",
+ "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": [
+ {
+ "$ref": "#/definitions/Personality"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "sandbox": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/SandboxMode"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "threadId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "threadId"
+ ],
+ "type": "object"
+ },
+ "ThreadRollbackParams": {
+ "properties": {
+ "numTurns": {
+ "description": "The number of turns to drop from the end of the thread. Must be >= 1.\n\nThis only modifies the thread's history and does not revert local file changes that have been made by the agent. Clients are responsible for reverting these changes.",
+ "format": "uint32",
+ "minimum": 0.0,
+ "type": "integer"
+ },
+ "threadId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "numTurns",
+ "threadId"
+ ],
+ "type": "object"
+ },
+ "ThreadSetNameParams": {
+ "properties": {
+ "name": {
+ "type": "string"
+ },
+ "threadId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "threadId"
+ ],
+ "type": "object"
+ },
+ "ThreadSortKey": {
+ "enum": [
+ "created_at",
+ "updated_at"
+ ],
+ "type": "string"
+ },
+ "ThreadSourceKind": {
+ "enum": [
+ "cli",
+ "vscode",
+ "exec",
+ "appServer",
+ "subAgent",
+ "subAgentReview",
+ "subAgentCompact",
+ "subAgentThreadSpawn",
+ "subAgentOther",
+ "unknown"
+ ],
+ "type": "string"
+ },
+ "ThreadStartParams": {
+ "properties": {
+ "approvalPolicy": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/AskForApproval"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "baseInstructions": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "config": {
+ "additionalProperties": true,
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "cwd": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "developerInstructions": {
+ "type": [
+ "string",
+ "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",
+ "null"
+ ]
+ },
+ "modelProvider": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "personality": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Personality"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "sandbox": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/SandboxMode"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "ThreadUnarchiveParams": {
+ "properties": {
+ "threadId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "threadId"
+ ],
+ "type": "object"
+ },
+ "TurnInterruptParams": {
+ "properties": {
+ "threadId": {
+ "type": "string"
+ },
+ "turnId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "threadId",
+ "turnId"
+ ],
+ "type": "object"
+ },
+ "TurnStartParams": {
+ "properties": {
+ "approvalPolicy": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/AskForApproval"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "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": [
+ "string",
+ "null"
+ ]
+ },
+ "effort": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ReasoningEffort"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Override the reasoning effort for this turn and subsequent turns."
+ },
+ "input": {
+ "items": {
+ "$ref": "#/definitions/UserInput"
+ },
+ "type": "array"
+ },
+ "model": {
+ "description": "Override the model for this turn and subsequent turns.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "outputSchema": {
+ "description": "Optional JSON Schema used to constrain the final assistant message for this turn."
+ },
+ "personality": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Personality"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Override the personality for this turn and subsequent turns."
+ },
+ "sandboxPolicy": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/SandboxPolicy"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Override the sandbox policy for this turn and subsequent turns."
+ },
+ "summary": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ReasoningSummary"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Override the reasoning summary for this turn and subsequent turns."
+ },
+ "threadId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "input",
+ "threadId"
+ ],
+ "type": "object"
+ },
+ "UserInput": {
+ "oneOf": [
+ {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "text_elements": {
+ "default": [],
+ "description": "UI-defined spans within `text` used to render or persist special elements.",
+ "items": {
+ "$ref": "#/definitions/TextElement"
+ },
+ "type": "array"
+ },
+ "type": {
+ "enum": [
+ "text"
+ ],
+ "title": "TextUserInputType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "TextUserInput",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "image"
+ ],
+ "title": "ImageUserInputType",
+ "type": "string"
+ },
+ "url": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "url"
+ ],
+ "title": "ImageUserInput",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "localImage"
+ ],
+ "title": "LocalImageUserInputType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "path",
+ "type"
+ ],
+ "title": "LocalImageUserInput",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "name": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "skill"
+ ],
+ "title": "SkillUserInputType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "path",
+ "type"
+ ],
+ "title": "SkillUserInput",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "name": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "mention"
+ ],
+ "title": "MentionUserInputType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "path",
+ "type"
+ ],
+ "title": "MentionUserInput",
+ "type": "object"
+ }
+ ]
+ },
+ "V1ByteRange": {
+ "properties": {
+ "end": {
+ "description": "End byte offset (exclusive) within the UTF-8 text buffer.",
+ "format": "uint",
+ "minimum": 0.0,
+ "type": "integer"
+ },
+ "start": {
+ "description": "Start byte offset (inclusive) within the UTF-8 text buffer.",
+ "format": "uint",
+ "minimum": 0.0,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "end",
+ "start"
+ ],
+ "type": "object"
+ },
+ "V1TextElement": {
+ "properties": {
+ "byteRange": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/V1ByteRange"
+ }
+ ],
+ "description": "Byte range in the parent `text` buffer that this element occupies."
+ },
+ "placeholder": {
+ "description": "Optional human-readable placeholder for the element, displayed in the UI.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "byteRange"
+ ],
+ "type": "object"
+ },
+ "WebSearchAction": {
+ "oneOf": [
+ {
+ "properties": {
+ "queries": {
+ "items": {
+ "type": "string"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "query": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "search"
+ ],
+ "title": "SearchWebSearchActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "SearchWebSearchAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "open_page"
+ ],
+ "title": "OpenPageWebSearchActionType",
+ "type": "string"
+ },
+ "url": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "OpenPageWebSearchAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "pattern": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "find_in_page"
+ ],
+ "title": "FindInPageWebSearchActionType",
+ "type": "string"
+ },
+ "url": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "FindInPageWebSearchAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "other"
+ ],
+ "title": "OtherWebSearchActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "OtherWebSearchAction",
+ "type": "object"
+ }
+ ]
+ }
+ },
+ "description": "Request from the client to the server.",
+ "oneOf": [
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "initialize"
+ ],
+ "title": "InitializeRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/InitializeParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "title": "InitializeRequest",
+ "type": "object"
+ },
+ {
+ "description": "NEW APIs",
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "thread/start"
+ ],
+ "title": "Thread/startRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/ThreadStartParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "title": "Thread/startRequest",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "thread/resume"
+ ],
+ "title": "Thread/resumeRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/ThreadResumeParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "title": "Thread/resumeRequest",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "thread/fork"
+ ],
+ "title": "Thread/forkRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/ThreadForkParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "title": "Thread/forkRequest",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "thread/archive"
+ ],
+ "title": "Thread/archiveRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/ThreadArchiveParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "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": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "thread/unarchive"
+ ],
+ "title": "Thread/unarchiveRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/ThreadUnarchiveParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "title": "Thread/unarchiveRequest",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "thread/rollback"
+ ],
+ "title": "Thread/rollbackRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/ThreadRollbackParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "title": "Thread/rollbackRequest",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "thread/list"
+ ],
+ "title": "Thread/listRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/ThreadListParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "title": "Thread/listRequest",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "thread/loaded/list"
+ ],
+ "title": "Thread/loaded/listRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/ThreadLoadedListParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "title": "Thread/loaded/listRequest",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "thread/read"
+ ],
+ "title": "Thread/readRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/ThreadReadParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "title": "Thread/readRequest",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "skills/list"
+ ],
+ "title": "Skills/listRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/SkillsListParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "title": "Skills/listRequest",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "app/list"
+ ],
+ "title": "App/listRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/AppsListParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "title": "App/listRequest",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "skills/config/write"
+ ],
+ "title": "Skills/config/writeRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/SkillsConfigWriteParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "title": "Skills/config/writeRequest",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "turn/start"
+ ],
+ "title": "Turn/startRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/TurnStartParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "title": "Turn/startRequest",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "turn/interrupt"
+ ],
+ "title": "Turn/interruptRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/TurnInterruptParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "title": "Turn/interruptRequest",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "review/start"
+ ],
+ "title": "Review/startRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/ReviewStartParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "title": "Review/startRequest",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "model/list"
+ ],
+ "title": "Model/listRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/ModelListParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "title": "Model/listRequest",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "mcpServer/oauth/login"
+ ],
+ "title": "McpServer/oauth/loginRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/McpServerOauthLoginParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "title": "McpServer/oauth/loginRequest",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "config/mcpServer/reload"
+ ],
+ "title": "Config/mcpServer/reloadRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "type": "null"
+ }
+ },
+ "required": [
+ "id",
+ "method"
+ ],
+ "title": "Config/mcpServer/reloadRequest",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "mcpServerStatus/list"
+ ],
+ "title": "McpServerStatus/listRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/ListMcpServerStatusParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "title": "McpServerStatus/listRequest",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "account/login/start"
+ ],
+ "title": "Account/login/startRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/LoginAccountParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "title": "Account/login/startRequest",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "account/login/cancel"
+ ],
+ "title": "Account/login/cancelRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/CancelLoginAccountParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "title": "Account/login/cancelRequest",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "account/logout"
+ ],
+ "title": "Account/logoutRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "type": "null"
+ }
+ },
+ "required": [
+ "id",
+ "method"
+ ],
+ "title": "Account/logoutRequest",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "account/rateLimits/read"
+ ],
+ "title": "Account/rateLimits/readRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "type": "null"
+ }
+ },
+ "required": [
+ "id",
+ "method"
+ ],
+ "title": "Account/rateLimits/readRequest",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "feedback/upload"
+ ],
+ "title": "Feedback/uploadRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/FeedbackUploadParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "title": "Feedback/uploadRequest",
+ "type": "object"
+ },
+ {
+ "description": "Execute a command (argv vector) under the server's sandbox.",
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "command/exec"
+ ],
+ "title": "Command/execRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/CommandExecParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "title": "Command/execRequest",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "config/read"
+ ],
+ "title": "Config/readRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/ConfigReadParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "title": "Config/readRequest",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "config/value/write"
+ ],
+ "title": "Config/value/writeRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/ConfigValueWriteParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "title": "Config/value/writeRequest",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "config/batchWrite"
+ ],
+ "title": "Config/batchWriteRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/ConfigBatchWriteParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "title": "Config/batchWriteRequest",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "configRequirements/read"
+ ],
+ "title": "ConfigRequirements/readRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "type": "null"
+ }
+ },
+ "required": [
+ "id",
+ "method"
+ ],
+ "title": "ConfigRequirements/readRequest",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "account/read"
+ ],
+ "title": "Account/readRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/GetAccountParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "title": "Account/readRequest",
+ "type": "object"
+ },
+ {
+ "description": "DEPRECATED APIs below",
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "newConversation"
+ ],
+ "title": "NewConversationRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/NewConversationParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "title": "NewConversationRequest",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "getConversationSummary"
+ ],
+ "title": "GetConversationSummaryRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/GetConversationSummaryParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "title": "GetConversationSummaryRequest",
+ "type": "object"
+ },
+ {
+ "description": "List recorded Codex conversations (rollouts) with optional pagination and search.",
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "listConversations"
+ ],
+ "title": "ListConversationsRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/ListConversationsParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "title": "ListConversationsRequest",
+ "type": "object"
+ },
+ {
+ "description": "Resume a recorded Codex conversation from a rollout file.",
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "resumeConversation"
+ ],
+ "title": "ResumeConversationRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/ResumeConversationParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "title": "ResumeConversationRequest",
+ "type": "object"
+ },
+ {
+ "description": "Fork a recorded Codex conversation into a new session.",
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "forkConversation"
+ ],
+ "title": "ForkConversationRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/ForkConversationParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "title": "ForkConversationRequest",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "archiveConversation"
+ ],
+ "title": "ArchiveConversationRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/ArchiveConversationParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "title": "ArchiveConversationRequest",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "sendUserMessage"
+ ],
+ "title": "SendUserMessageRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/SendUserMessageParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "title": "SendUserMessageRequest",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "sendUserTurn"
+ ],
+ "title": "SendUserTurnRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/SendUserTurnParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "title": "SendUserTurnRequest",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "interruptConversation"
+ ],
+ "title": "InterruptConversationRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/InterruptConversationParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "title": "InterruptConversationRequest",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "addConversationListener"
+ ],
+ "title": "AddConversationListenerRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/AddConversationListenerParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "title": "AddConversationListenerRequest",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "removeConversationListener"
+ ],
+ "title": "RemoveConversationListenerRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/RemoveConversationListenerParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "title": "RemoveConversationListenerRequest",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "gitDiffToRemote"
+ ],
+ "title": "GitDiffToRemoteRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/GitDiffToRemoteParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "title": "GitDiffToRemoteRequest",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "loginApiKey"
+ ],
+ "title": "LoginApiKeyRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/LoginApiKeyParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "title": "LoginApiKeyRequest",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "loginChatGpt"
+ ],
+ "title": "LoginChatGptRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "type": "null"
+ }
+ },
+ "required": [
+ "id",
+ "method"
+ ],
+ "title": "LoginChatGptRequest",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "cancelLoginChatGpt"
+ ],
+ "title": "CancelLoginChatGptRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/CancelLoginChatGptParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "title": "CancelLoginChatGptRequest",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "logoutChatGpt"
+ ],
+ "title": "LogoutChatGptRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "type": "null"
+ }
+ },
+ "required": [
+ "id",
+ "method"
+ ],
+ "title": "LogoutChatGptRequest",
+ "type": "object"
+ },
+ {
+ "description": "DEPRECATED in favor of GetAccount",
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "getAuthStatus"
+ ],
+ "title": "GetAuthStatusRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/GetAuthStatusParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "title": "GetAuthStatusRequest",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "getUserSavedConfig"
+ ],
+ "title": "GetUserSavedConfigRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "type": "null"
+ }
+ },
+ "required": [
+ "id",
+ "method"
+ ],
+ "title": "GetUserSavedConfigRequest",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "setDefaultModel"
+ ],
+ "title": "SetDefaultModelRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/SetDefaultModelParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "title": "SetDefaultModelRequest",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "getUserAgent"
+ ],
+ "title": "GetUserAgentRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "type": "null"
+ }
+ },
+ "required": [
+ "id",
+ "method"
+ ],
+ "title": "GetUserAgentRequest",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "userInfo"
+ ],
+ "title": "UserInfoRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "type": "null"
+ }
+ },
+ "required": [
+ "id",
+ "method"
+ ],
+ "title": "UserInfoRequest",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "fuzzyFileSearch"
+ ],
+ "title": "FuzzyFileSearchRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/FuzzyFileSearchParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "title": "FuzzyFileSearchRequest",
+ "type": "object"
+ },
+ {
+ "description": "Execute a command (argv vector) under the server's sandbox.",
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "execOneOffCommand"
+ ],
+ "title": "ExecOneOffCommandRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/ExecOneOffCommandParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "title": "ExecOneOffCommandRequest",
+ "type": "object"
+ }
+ ],
+ "title": "ClientRequest"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/CommandExecutionRequestApprovalParams.json b/codex-rs/app-server-protocol/schema/json/CommandExecutionRequestApprovalParams.json
new file mode 100644
index 0000000000..9257aec839
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/CommandExecutionRequestApprovalParams.json
@@ -0,0 +1,174 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "definitions": {
+ "CommandAction": {
+ "oneOf": [
+ {
+ "properties": {
+ "command": {
+ "type": "string"
+ },
+ "name": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "read"
+ ],
+ "title": "ReadCommandActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "command",
+ "name",
+ "path",
+ "type"
+ ],
+ "title": "ReadCommandAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "command": {
+ "type": "string"
+ },
+ "path": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "listFiles"
+ ],
+ "title": "ListFilesCommandActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "command",
+ "type"
+ ],
+ "title": "ListFilesCommandAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "command": {
+ "type": "string"
+ },
+ "path": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "query": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "search"
+ ],
+ "title": "SearchCommandActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "command",
+ "type"
+ ],
+ "title": "SearchCommandAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "command": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "unknown"
+ ],
+ "title": "UnknownCommandActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "command",
+ "type"
+ ],
+ "title": "UnknownCommandAction",
+ "type": "object"
+ }
+ ]
+ }
+ },
+ "properties": {
+ "command": {
+ "description": "The command to be executed.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "commandActions": {
+ "description": "Best-effort parsed command actions for friendly display.",
+ "items": {
+ "$ref": "#/definitions/CommandAction"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "cwd": {
+ "description": "The command's working directory.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "itemId": {
+ "type": "string"
+ },
+ "proposedExecpolicyAmendment": {
+ "description": "Optional proposed execpolicy amendment to allow similar commands without prompting.",
+ "items": {
+ "type": "string"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "reason": {
+ "description": "Optional explanatory reason (e.g. request for network access).",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "threadId": {
+ "type": "string"
+ },
+ "turnId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "itemId",
+ "threadId",
+ "turnId"
+ ],
+ "title": "CommandExecutionRequestApprovalParams",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/CommandExecutionRequestApprovalResponse.json b/codex-rs/app-server-protocol/schema/json/CommandExecutionRequestApprovalResponse.json
new file mode 100644
index 0000000000..fcc3eba786
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/CommandExecutionRequestApprovalResponse.json
@@ -0,0 +1,72 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "definitions": {
+ "CommandExecutionApprovalDecision": {
+ "oneOf": [
+ {
+ "description": "User approved the command.",
+ "enum": [
+ "accept"
+ ],
+ "type": "string"
+ },
+ {
+ "description": "User approved the command and future identical commands should run without prompting.",
+ "enum": [
+ "acceptForSession"
+ ],
+ "type": "string"
+ },
+ {
+ "additionalProperties": false,
+ "description": "User approved the command, and wants to apply the proposed execpolicy amendment so future matching commands can run without prompting.",
+ "properties": {
+ "acceptWithExecpolicyAmendment": {
+ "properties": {
+ "execpolicy_amendment": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ }
+ },
+ "required": [
+ "execpolicy_amendment"
+ ],
+ "type": "object"
+ }
+ },
+ "required": [
+ "acceptWithExecpolicyAmendment"
+ ],
+ "title": "AcceptWithExecpolicyAmendmentCommandExecutionApprovalDecision",
+ "type": "object"
+ },
+ {
+ "description": "User denied the command. The agent will continue the turn.",
+ "enum": [
+ "decline"
+ ],
+ "type": "string"
+ },
+ {
+ "description": "User denied the command. The turn will also be immediately interrupted.",
+ "enum": [
+ "cancel"
+ ],
+ "type": "string"
+ }
+ ]
+ }
+ },
+ "properties": {
+ "decision": {
+ "$ref": "#/definitions/CommandExecutionApprovalDecision"
+ }
+ },
+ "required": [
+ "decision"
+ ],
+ "title": "CommandExecutionRequestApprovalResponse",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/DynamicToolCallParams.json b/codex-rs/app-server-protocol/schema/json/DynamicToolCallParams.json
new file mode 100644
index 0000000000..2ccc94ca06
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/DynamicToolCallParams.json
@@ -0,0 +1,27 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "arguments": true,
+ "callId": {
+ "type": "string"
+ },
+ "threadId": {
+ "type": "string"
+ },
+ "tool": {
+ "type": "string"
+ },
+ "turnId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "arguments",
+ "callId",
+ "threadId",
+ "tool",
+ "turnId"
+ ],
+ "title": "DynamicToolCallParams",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/DynamicToolCallResponse.json b/codex-rs/app-server-protocol/schema/json/DynamicToolCallResponse.json
new file mode 100644
index 0000000000..662d3bda4f
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/DynamicToolCallResponse.json
@@ -0,0 +1,17 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "output": {
+ "type": "string"
+ },
+ "success": {
+ "type": "boolean"
+ }
+ },
+ "required": [
+ "output",
+ "success"
+ ],
+ "title": "DynamicToolCallResponse",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/EventMsg.json b/codex-rs/app-server-protocol/schema/json/EventMsg.json
new file mode 100644
index 0000000000..407626d82d
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/EventMsg.json
@@ -0,0 +1,7610 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "definitions": {
+ "AbsolutePathBuf": {
+ "description": "A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem).\n\nIMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set, the deserialization will fail unless the path being deserialized is already absolute.",
+ "type": "string"
+ },
+ "AgentMessageContent": {
+ "oneOf": [
+ {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "Text"
+ ],
+ "title": "TextAgentMessageContentType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "TextAgentMessageContent",
+ "type": "object"
+ }
+ ]
+ },
+ "AgentStatus": {
+ "description": "Agent lifecycle status, derived from emitted events.",
+ "oneOf": [
+ {
+ "description": "Agent is waiting for initialization.",
+ "enum": [
+ "pending_init"
+ ],
+ "type": "string"
+ },
+ {
+ "description": "Agent is currently running.",
+ "enum": [
+ "running"
+ ],
+ "type": "string"
+ },
+ {
+ "additionalProperties": false,
+ "description": "Agent is done. Contains the final assistant message.",
+ "properties": {
+ "completed": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "completed"
+ ],
+ "title": "CompletedAgentStatus",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "Agent encountered an error.",
+ "properties": {
+ "errored": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "errored"
+ ],
+ "title": "ErroredAgentStatus",
+ "type": "object"
+ },
+ {
+ "description": "Agent has been shutdown.",
+ "enum": [
+ "shutdown"
+ ],
+ "type": "string"
+ },
+ {
+ "description": "Agent is not found.",
+ "enum": [
+ "not_found"
+ ],
+ "type": "string"
+ }
+ ]
+ },
+ "Annotations": {
+ "description": "Optional annotations for the client. The client can use annotations to inform how objects are used or displayed",
+ "properties": {
+ "audience": {
+ "items": {
+ "$ref": "#/definitions/Role"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "lastModified": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "priority": {
+ "format": "double",
+ "type": [
+ "number",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "AskForApproval": {
+ "description": "Determines the conditions under which the user is consulted to approve running the command proposed by Codex.",
+ "oneOf": [
+ {
+ "description": "Under this policy, only \"known safe\" commands—as determined by `is_safe_command()`—that **only read files** are auto‑approved. Everything else will ask the user to approve.",
+ "enum": [
+ "untrusted"
+ ],
+ "type": "string"
+ },
+ {
+ "description": "*All* commands are auto‑approved, but they are expected to run inside a sandbox where network access is disabled and writes are confined to a specific set of paths. If the command fails, it will be escalated to the user to approve execution without a sandbox.",
+ "enum": [
+ "on-failure"
+ ],
+ "type": "string"
+ },
+ {
+ "description": "The model decides when to ask the user for approval.",
+ "enum": [
+ "on-request"
+ ],
+ "type": "string"
+ },
+ {
+ "description": "Never ask the user to approve commands. Failures are immediately returned to the model, and never escalated to the user for approval.",
+ "enum": [
+ "never"
+ ],
+ "type": "string"
+ }
+ ]
+ },
+ "AudioContent": {
+ "description": "Audio provided to or from an LLM.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "data": {
+ "type": "string"
+ },
+ "mimeType": {
+ "type": "string"
+ },
+ "type": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "data",
+ "mimeType",
+ "type"
+ ],
+ "type": "object"
+ },
+ "BlobResourceContents": {
+ "properties": {
+ "blob": {
+ "type": "string"
+ },
+ "mimeType": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "uri": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "blob",
+ "uri"
+ ],
+ "type": "object"
+ },
+ "ByteRange": {
+ "properties": {
+ "end": {
+ "description": "End byte offset (exclusive) within the UTF-8 text buffer.",
+ "format": "uint",
+ "minimum": 0.0,
+ "type": "integer"
+ },
+ "start": {
+ "description": "Start byte offset (inclusive) within the UTF-8 text buffer.",
+ "format": "uint",
+ "minimum": 0.0,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "end",
+ "start"
+ ],
+ "type": "object"
+ },
+ "CallToolResult": {
+ "description": "The server's response to a tool call.",
+ "properties": {
+ "content": {
+ "items": {
+ "$ref": "#/definitions/ContentBlock"
+ },
+ "type": "array"
+ },
+ "isError": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "structuredContent": true
+ },
+ "required": [
+ "content"
+ ],
+ "type": "object"
+ },
+ "CodexErrorInfo": {
+ "description": "Codex errors that we expose to clients.",
+ "oneOf": [
+ {
+ "enum": [
+ "context_window_exceeded",
+ "usage_limit_exceeded",
+ "internal_server_error",
+ "unauthorized",
+ "bad_request",
+ "sandbox_error",
+ "thread_rollback_failed",
+ "other"
+ ],
+ "type": "string"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "model_cap": {
+ "properties": {
+ "model": {
+ "type": "string"
+ },
+ "reset_after_seconds": {
+ "format": "uint64",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "model"
+ ],
+ "type": "object"
+ }
+ },
+ "required": [
+ "model_cap"
+ ],
+ "title": "ModelCapCodexErrorInfo",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "http_connection_failed": {
+ "properties": {
+ "http_status_code": {
+ "format": "uint16",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "http_connection_failed"
+ ],
+ "title": "HttpConnectionFailedCodexErrorInfo",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "Failed to connect to the response SSE stream.",
+ "properties": {
+ "response_stream_connection_failed": {
+ "properties": {
+ "http_status_code": {
+ "format": "uint16",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "response_stream_connection_failed"
+ ],
+ "title": "ResponseStreamConnectionFailedCodexErrorInfo",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "The response SSE stream disconnected in the middle of a turnbefore completion.",
+ "properties": {
+ "response_stream_disconnected": {
+ "properties": {
+ "http_status_code": {
+ "format": "uint16",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "response_stream_disconnected"
+ ],
+ "title": "ResponseStreamDisconnectedCodexErrorInfo",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "Reached the retry limit for responses.",
+ "properties": {
+ "response_too_many_failed_attempts": {
+ "properties": {
+ "http_status_code": {
+ "format": "uint16",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "response_too_many_failed_attempts"
+ ],
+ "title": "ResponseTooManyFailedAttemptsCodexErrorInfo",
+ "type": "object"
+ }
+ ]
+ },
+ "ContentBlock": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/TextContent"
+ },
+ {
+ "$ref": "#/definitions/ImageContent"
+ },
+ {
+ "$ref": "#/definitions/AudioContent"
+ },
+ {
+ "$ref": "#/definitions/ResourceLink"
+ },
+ {
+ "$ref": "#/definitions/EmbeddedResource"
+ }
+ ]
+ },
+ "ContentItem": {
+ "oneOf": [
+ {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "input_text"
+ ],
+ "title": "InputTextContentItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "InputTextContentItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "image_url": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "input_image"
+ ],
+ "title": "InputImageContentItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "image_url",
+ "type"
+ ],
+ "title": "InputImageContentItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "output_text"
+ ],
+ "title": "OutputTextContentItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "OutputTextContentItem",
+ "type": "object"
+ }
+ ]
+ },
+ "CreditsSnapshot": {
+ "properties": {
+ "balance": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "has_credits": {
+ "type": "boolean"
+ },
+ "unlimited": {
+ "type": "boolean"
+ }
+ },
+ "required": [
+ "has_credits",
+ "unlimited"
+ ],
+ "type": "object"
+ },
+ "CustomPrompt": {
+ "properties": {
+ "argument_hint": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "content": {
+ "type": "string"
+ },
+ "description": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "name": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "content",
+ "name",
+ "path"
+ ],
+ "type": "object"
+ },
+ "Duration": {
+ "properties": {
+ "nanos": {
+ "format": "uint32",
+ "minimum": 0.0,
+ "type": "integer"
+ },
+ "secs": {
+ "format": "uint64",
+ "minimum": 0.0,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "nanos",
+ "secs"
+ ],
+ "type": "object"
+ },
+ "EmbeddedResource": {
+ "description": "The contents of a resource, embedded into a prompt or tool call result.\n\nIt is up to the client how best to render embedded resources for the benefit of the LLM and/or the user.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "resource": {
+ "$ref": "#/definitions/EmbeddedResourceResource"
+ },
+ "type": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "resource",
+ "type"
+ ],
+ "type": "object"
+ },
+ "EmbeddedResourceResource": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/TextResourceContents"
+ },
+ {
+ "$ref": "#/definitions/BlobResourceContents"
+ }
+ ]
+ },
+ "EventMsg": {
+ "description": "Response event from the agent NOTE: Make sure none of these values have optional types, as it will mess up the extension code-gen.",
+ "oneOf": [
+ {
+ "description": "Error while executing a submission",
+ "properties": {
+ "codex_error_info": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/CodexErrorInfo"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "default": null
+ },
+ "message": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "error"
+ ],
+ "title": "ErrorEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "message",
+ "type"
+ ],
+ "title": "ErrorEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Warning issued while processing a submission. Unlike `Error`, this indicates the turn continued but the user should still be notified.",
+ "properties": {
+ "message": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "warning"
+ ],
+ "title": "WarningEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "message",
+ "type"
+ ],
+ "title": "WarningEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Conversation history was compacted (either automatically or manually).",
+ "properties": {
+ "type": {
+ "enum": [
+ "context_compacted"
+ ],
+ "title": "ContextCompactedEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "ContextCompactedEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Conversation history was rolled back by dropping the last N user turns.",
+ "properties": {
+ "num_turns": {
+ "description": "Number of user turns that were removed from context.",
+ "format": "uint32",
+ "minimum": 0.0,
+ "type": "integer"
+ },
+ "type": {
+ "enum": [
+ "thread_rolled_back"
+ ],
+ "title": "ThreadRolledBackEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "num_turns",
+ "type"
+ ],
+ "title": "ThreadRolledBackEventMsg",
+ "type": "object"
+ },
+ {
+ "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": "code"
+ },
+ "model_context_window": {
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "task_started"
+ ],
+ "title": "TaskStartedEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "TaskStartedEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Agent has completed all actions. v1 wire format uses `task_complete`; accept `turn_complete` for v2 interop.",
+ "properties": {
+ "last_agent_message": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "task_complete"
+ ],
+ "title": "TaskCompleteEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "TaskCompleteEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Usage update for the current session, including totals and last turn. Optional means unknown — UIs should not display when `None`.",
+ "properties": {
+ "info": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/TokenUsageInfo"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "rate_limits": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/RateLimitSnapshot"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "type": {
+ "enum": [
+ "token_count"
+ ],
+ "title": "TokenCountEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "TokenCountEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Agent text output message",
+ "properties": {
+ "message": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "agent_message"
+ ],
+ "title": "AgentMessageEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "message",
+ "type"
+ ],
+ "title": "AgentMessageEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "User/system input message (what was sent to the model)",
+ "properties": {
+ "images": {
+ "description": "Image URLs sourced from `UserInput::Image`. These are safe to replay in legacy UI history events and correspond to images sent to the model.",
+ "items": {
+ "type": "string"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "local_images": {
+ "default": [],
+ "description": "Local file paths sourced from `UserInput::LocalImage`. These are kept so the UI can reattach images when editing history, and should not be sent to the model or treated as API-ready URLs.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "message": {
+ "type": "string"
+ },
+ "text_elements": {
+ "default": [],
+ "description": "UI-defined spans within `message` used to render or persist special elements.",
+ "items": {
+ "$ref": "#/definitions/TextElement"
+ },
+ "type": "array"
+ },
+ "type": {
+ "enum": [
+ "user_message"
+ ],
+ "title": "UserMessageEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "message",
+ "type"
+ ],
+ "title": "UserMessageEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Agent text output delta message",
+ "properties": {
+ "delta": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "agent_message_delta"
+ ],
+ "title": "AgentMessageDeltaEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "delta",
+ "type"
+ ],
+ "title": "AgentMessageDeltaEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Reasoning event from agent.",
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "agent_reasoning"
+ ],
+ "title": "AgentReasoningEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "AgentReasoningEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Agent reasoning delta event from agent.",
+ "properties": {
+ "delta": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "agent_reasoning_delta"
+ ],
+ "title": "AgentReasoningDeltaEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "delta",
+ "type"
+ ],
+ "title": "AgentReasoningDeltaEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Raw chain-of-thought from agent.",
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "agent_reasoning_raw_content"
+ ],
+ "title": "AgentReasoningRawContentEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "AgentReasoningRawContentEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Agent reasoning content delta event from agent.",
+ "properties": {
+ "delta": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "agent_reasoning_raw_content_delta"
+ ],
+ "title": "AgentReasoningRawContentDeltaEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "delta",
+ "type"
+ ],
+ "title": "AgentReasoningRawContentDeltaEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Signaled when the model begins a new reasoning summary section (e.g., a new titled block).",
+ "properties": {
+ "item_id": {
+ "default": "",
+ "type": "string"
+ },
+ "summary_index": {
+ "default": 0,
+ "format": "int64",
+ "type": "integer"
+ },
+ "type": {
+ "enum": [
+ "agent_reasoning_section_break"
+ ],
+ "title": "AgentReasoningSectionBreakEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "AgentReasoningSectionBreakEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Ack the client's configure message.",
+ "properties": {
+ "approval_policy": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/AskForApproval"
+ }
+ ],
+ "description": "When to escalate for approval for execution"
+ },
+ "cwd": {
+ "description": "Working directory that should be treated as the *root* of the session.",
+ "type": "string"
+ },
+ "forked_from_id": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ThreadId"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "history_entry_count": {
+ "description": "Current number of entries in the history log.",
+ "format": "uint",
+ "minimum": 0.0,
+ "type": "integer"
+ },
+ "history_log_id": {
+ "description": "Identifier of the history log file (inode on Unix, 0 otherwise).",
+ "format": "uint64",
+ "minimum": 0.0,
+ "type": "integer"
+ },
+ "initial_messages": {
+ "description": "Optional initial messages (as events) for resumed sessions. When present, UIs can use these to seed the history.",
+ "items": {
+ "$ref": "#/definitions/EventMsg"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "model": {
+ "description": "Tell the client what model is being queried.",
+ "type": "string"
+ },
+ "model_provider_id": {
+ "type": "string"
+ },
+ "reasoning_effort": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ReasoningEffort"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "The effort the model is putting into reasoning about the user's request."
+ },
+ "rollout_path": {
+ "description": "Path in which the rollout is stored. Can be `None` for ephemeral threads",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "sandbox_policy": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/SandboxPolicy"
+ }
+ ],
+ "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"
+ ]
+ },
+ "type": {
+ "enum": [
+ "session_configured"
+ ],
+ "title": "SessionConfiguredEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "approval_policy",
+ "cwd",
+ "history_entry_count",
+ "history_log_id",
+ "model",
+ "model_provider_id",
+ "sandbox_policy",
+ "session_id",
+ "type"
+ ],
+ "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": {
+ "server": {
+ "description": "Server name being started.",
+ "type": "string"
+ },
+ "status": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/McpStartupStatus"
+ }
+ ],
+ "description": "Current startup status."
+ },
+ "type": {
+ "enum": [
+ "mcp_startup_update"
+ ],
+ "title": "McpStartupUpdateEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "server",
+ "status",
+ "type"
+ ],
+ "title": "McpStartupUpdateEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Aggregate MCP startup completion summary.",
+ "properties": {
+ "cancelled": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "failed": {
+ "items": {
+ "$ref": "#/definitions/McpStartupFailure"
+ },
+ "type": "array"
+ },
+ "ready": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "type": {
+ "enum": [
+ "mcp_startup_complete"
+ ],
+ "title": "McpStartupCompleteEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "cancelled",
+ "failed",
+ "ready",
+ "type"
+ ],
+ "title": "McpStartupCompleteEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "call_id": {
+ "description": "Identifier so this can be paired with the McpToolCallEnd event.",
+ "type": "string"
+ },
+ "invocation": {
+ "$ref": "#/definitions/McpInvocation"
+ },
+ "type": {
+ "enum": [
+ "mcp_tool_call_begin"
+ ],
+ "title": "McpToolCallBeginEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "invocation",
+ "type"
+ ],
+ "title": "McpToolCallBeginEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "call_id": {
+ "description": "Identifier for the corresponding McpToolCallBegin that finished.",
+ "type": "string"
+ },
+ "duration": {
+ "$ref": "#/definitions/Duration"
+ },
+ "invocation": {
+ "$ref": "#/definitions/McpInvocation"
+ },
+ "result": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/Result_of_CallToolResult_or_String"
+ }
+ ],
+ "description": "Result of the tool call. Note this could be an error."
+ },
+ "type": {
+ "enum": [
+ "mcp_tool_call_end"
+ ],
+ "title": "McpToolCallEndEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "duration",
+ "invocation",
+ "result",
+ "type"
+ ],
+ "title": "McpToolCallEndEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "call_id": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "web_search_begin"
+ ],
+ "title": "WebSearchBeginEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "type"
+ ],
+ "title": "WebSearchBeginEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "action": {
+ "$ref": "#/definitions/WebSearchAction"
+ },
+ "call_id": {
+ "type": "string"
+ },
+ "query": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "web_search_end"
+ ],
+ "title": "WebSearchEndEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "action",
+ "call_id",
+ "query",
+ "type"
+ ],
+ "title": "WebSearchEndEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Notification that the server is about to execute a command.",
+ "properties": {
+ "call_id": {
+ "description": "Identifier so this can be paired with the ExecCommandEnd event.",
+ "type": "string"
+ },
+ "command": {
+ "description": "The command to be executed.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "cwd": {
+ "description": "The command's working directory if not the default cwd for the agent.",
+ "type": "string"
+ },
+ "interaction_input": {
+ "description": "Raw input sent to a unified exec session (if this is an interaction event).",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "parsed_cmd": {
+ "items": {
+ "$ref": "#/definitions/ParsedCommand"
+ },
+ "type": "array"
+ },
+ "process_id": {
+ "description": "Identifier for the underlying PTY process (when available).",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "source": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ExecCommandSource"
+ }
+ ],
+ "default": "agent",
+ "description": "Where the command originated. Defaults to Agent for backward compatibility."
+ },
+ "turn_id": {
+ "description": "Turn ID that this command belongs to.",
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "exec_command_begin"
+ ],
+ "title": "ExecCommandBeginEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "command",
+ "cwd",
+ "parsed_cmd",
+ "turn_id",
+ "type"
+ ],
+ "title": "ExecCommandBeginEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Incremental chunk of output from a running command.",
+ "properties": {
+ "call_id": {
+ "description": "Identifier for the ExecCommandBegin that produced this chunk.",
+ "type": "string"
+ },
+ "chunk": {
+ "description": "Raw bytes from the stream (may not be valid UTF-8).",
+ "type": "string"
+ },
+ "stream": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ExecOutputStream"
+ }
+ ],
+ "description": "Which stream produced this chunk."
+ },
+ "type": {
+ "enum": [
+ "exec_command_output_delta"
+ ],
+ "title": "ExecCommandOutputDeltaEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "chunk",
+ "stream",
+ "type"
+ ],
+ "title": "ExecCommandOutputDeltaEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Terminal interaction for an in-progress command (stdin sent and stdout observed).",
+ "properties": {
+ "call_id": {
+ "description": "Identifier for the ExecCommandBegin that produced this chunk.",
+ "type": "string"
+ },
+ "process_id": {
+ "description": "Process id associated with the running command.",
+ "type": "string"
+ },
+ "stdin": {
+ "description": "Stdin sent to the running session.",
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "terminal_interaction"
+ ],
+ "title": "TerminalInteractionEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "process_id",
+ "stdin",
+ "type"
+ ],
+ "title": "TerminalInteractionEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "aggregated_output": {
+ "default": "",
+ "description": "Captured aggregated output",
+ "type": "string"
+ },
+ "call_id": {
+ "description": "Identifier for the ExecCommandBegin that finished.",
+ "type": "string"
+ },
+ "command": {
+ "description": "The command that was executed.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "cwd": {
+ "description": "The command's working directory if not the default cwd for the agent.",
+ "type": "string"
+ },
+ "duration": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/Duration"
+ }
+ ],
+ "description": "The duration of the command execution."
+ },
+ "exit_code": {
+ "description": "The command's exit code.",
+ "format": "int32",
+ "type": "integer"
+ },
+ "formatted_output": {
+ "description": "Formatted output from the command, as seen by the model.",
+ "type": "string"
+ },
+ "interaction_input": {
+ "description": "Raw input sent to a unified exec session (if this is an interaction event).",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "parsed_cmd": {
+ "items": {
+ "$ref": "#/definitions/ParsedCommand"
+ },
+ "type": "array"
+ },
+ "process_id": {
+ "description": "Identifier for the underlying PTY process (when available).",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "source": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ExecCommandSource"
+ }
+ ],
+ "default": "agent",
+ "description": "Where the command originated. Defaults to Agent for backward compatibility."
+ },
+ "stderr": {
+ "description": "Captured stderr",
+ "type": "string"
+ },
+ "stdout": {
+ "description": "Captured stdout",
+ "type": "string"
+ },
+ "turn_id": {
+ "description": "Turn ID that this command belongs to.",
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "exec_command_end"
+ ],
+ "title": "ExecCommandEndEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "command",
+ "cwd",
+ "duration",
+ "exit_code",
+ "formatted_output",
+ "parsed_cmd",
+ "stderr",
+ "stdout",
+ "turn_id",
+ "type"
+ ],
+ "title": "ExecCommandEndEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Notification that the agent attached a local image via the view_image tool.",
+ "properties": {
+ "call_id": {
+ "description": "Identifier for the originating tool call.",
+ "type": "string"
+ },
+ "path": {
+ "description": "Local filesystem path provided to the tool.",
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "view_image_tool_call"
+ ],
+ "title": "ViewImageToolCallEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "path",
+ "type"
+ ],
+ "title": "ViewImageToolCallEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "call_id": {
+ "description": "Identifier for the associated exec call, if available.",
+ "type": "string"
+ },
+ "command": {
+ "description": "The command to be executed.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "cwd": {
+ "description": "The command's working directory.",
+ "type": "string"
+ },
+ "parsed_cmd": {
+ "items": {
+ "$ref": "#/definitions/ParsedCommand"
+ },
+ "type": "array"
+ },
+ "proposed_execpolicy_amendment": {
+ "description": "Proposed execpolicy amendment that can be applied to allow future runs.",
+ "items": {
+ "type": "string"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "reason": {
+ "description": "Optional human-readable reason for the approval (e.g. retry without sandbox).",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "turn_id": {
+ "default": "",
+ "description": "Turn ID that this command belongs to. Uses `#[serde(default)]` for backwards compatibility.",
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "exec_approval_request"
+ ],
+ "title": "ExecApprovalRequestEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "command",
+ "cwd",
+ "parsed_cmd",
+ "type"
+ ],
+ "title": "ExecApprovalRequestEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "call_id": {
+ "description": "Responses API call id for the associated tool call, if available.",
+ "type": "string"
+ },
+ "questions": {
+ "items": {
+ "$ref": "#/definitions/RequestUserInputQuestion"
+ },
+ "type": "array"
+ },
+ "turn_id": {
+ "default": "",
+ "description": "Turn ID that this request belongs to. Uses `#[serde(default)]` for backwards compatibility.",
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "request_user_input"
+ ],
+ "title": "RequestUserInputEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "questions",
+ "type"
+ ],
+ "title": "RequestUserInputEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "arguments": true,
+ "callId": {
+ "type": "string"
+ },
+ "tool": {
+ "type": "string"
+ },
+ "turnId": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "dynamic_tool_call_request"
+ ],
+ "title": "DynamicToolCallRequestEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "arguments",
+ "callId",
+ "tool",
+ "turnId",
+ "type"
+ ],
+ "title": "DynamicToolCallRequestEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "message": {
+ "type": "string"
+ },
+ "server_name": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "elicitation_request"
+ ],
+ "title": "ElicitationRequestEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "message",
+ "server_name",
+ "type"
+ ],
+ "title": "ElicitationRequestEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "call_id": {
+ "description": "Responses API call id for the associated patch apply call, if available.",
+ "type": "string"
+ },
+ "changes": {
+ "additionalProperties": {
+ "$ref": "#/definitions/FileChange"
+ },
+ "type": "object"
+ },
+ "grant_root": {
+ "description": "When set, the agent is asking the user to allow writes under this root for the remainder of the session.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "reason": {
+ "description": "Optional explanatory reason (e.g. request for extra write access).",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "turn_id": {
+ "default": "",
+ "description": "Turn ID that this patch belongs to. Uses `#[serde(default)]` for backwards compatibility with older senders.",
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "apply_patch_approval_request"
+ ],
+ "title": "ApplyPatchApprovalRequestEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "changes",
+ "type"
+ ],
+ "title": "ApplyPatchApprovalRequestEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Notification advising the user that something they are using has been deprecated and should be phased out.",
+ "properties": {
+ "details": {
+ "description": "Optional extra guidance, such as migration steps or rationale.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "summary": {
+ "description": "Concise summary of what is deprecated.",
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "deprecation_notice"
+ ],
+ "title": "DeprecationNoticeEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "summary",
+ "type"
+ ],
+ "title": "DeprecationNoticeEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "message": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "background_event"
+ ],
+ "title": "BackgroundEventEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "message",
+ "type"
+ ],
+ "title": "BackgroundEventEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "message": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "undo_started"
+ ],
+ "title": "UndoStartedEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "UndoStartedEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "message": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "success": {
+ "type": "boolean"
+ },
+ "type": {
+ "enum": [
+ "undo_completed"
+ ],
+ "title": "UndoCompletedEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "success",
+ "type"
+ ],
+ "title": "UndoCompletedEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Notification that a model stream experienced an error or disconnect and the system is handling it (e.g., retrying with backoff).",
+ "properties": {
+ "additional_details": {
+ "default": null,
+ "description": "Optional details about the underlying stream failure (often the same human-readable message that is surfaced as the terminal error if retries are exhausted).",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "codex_error_info": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/CodexErrorInfo"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "default": null
+ },
+ "message": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "stream_error"
+ ],
+ "title": "StreamErrorEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "message",
+ "type"
+ ],
+ "title": "StreamErrorEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Notification that the agent is about to apply a code patch. Mirrors `ExecCommandBegin` so front‑ends can show progress indicators.",
+ "properties": {
+ "auto_approved": {
+ "description": "If true, there was no ApplyPatchApprovalRequest for this patch.",
+ "type": "boolean"
+ },
+ "call_id": {
+ "description": "Identifier so this can be paired with the PatchApplyEnd event.",
+ "type": "string"
+ },
+ "changes": {
+ "additionalProperties": {
+ "$ref": "#/definitions/FileChange"
+ },
+ "description": "The changes to be applied.",
+ "type": "object"
+ },
+ "turn_id": {
+ "default": "",
+ "description": "Turn ID that this patch belongs to. Uses `#[serde(default)]` for backwards compatibility.",
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "patch_apply_begin"
+ ],
+ "title": "PatchApplyBeginEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "auto_approved",
+ "call_id",
+ "changes",
+ "type"
+ ],
+ "title": "PatchApplyBeginEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Notification that a patch application has finished.",
+ "properties": {
+ "call_id": {
+ "description": "Identifier for the PatchApplyBegin that finished.",
+ "type": "string"
+ },
+ "changes": {
+ "additionalProperties": {
+ "$ref": "#/definitions/FileChange"
+ },
+ "default": {},
+ "description": "The changes that were applied (mirrors PatchApplyBeginEvent::changes).",
+ "type": "object"
+ },
+ "stderr": {
+ "description": "Captured stderr (parser errors, IO failures, etc.).",
+ "type": "string"
+ },
+ "stdout": {
+ "description": "Captured stdout (summary printed by apply_patch).",
+ "type": "string"
+ },
+ "success": {
+ "description": "Whether the patch was applied successfully.",
+ "type": "boolean"
+ },
+ "turn_id": {
+ "default": "",
+ "description": "Turn ID that this patch belongs to. Uses `#[serde(default)]` for backwards compatibility.",
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "patch_apply_end"
+ ],
+ "title": "PatchApplyEndEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "stderr",
+ "stdout",
+ "success",
+ "type"
+ ],
+ "title": "PatchApplyEndEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "turn_diff"
+ ],
+ "title": "TurnDiffEventMsgType",
+ "type": "string"
+ },
+ "unified_diff": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "unified_diff"
+ ],
+ "title": "TurnDiffEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Response to GetHistoryEntryRequest.",
+ "properties": {
+ "entry": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/HistoryEntry"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "The entry at the requested offset, if available and parseable."
+ },
+ "log_id": {
+ "format": "uint64",
+ "minimum": 0.0,
+ "type": "integer"
+ },
+ "offset": {
+ "format": "uint",
+ "minimum": 0.0,
+ "type": "integer"
+ },
+ "type": {
+ "enum": [
+ "get_history_entry_response"
+ ],
+ "title": "GetHistoryEntryResponseEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "log_id",
+ "offset",
+ "type"
+ ],
+ "title": "GetHistoryEntryResponseEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "List of MCP tools available to the agent.",
+ "properties": {
+ "auth_statuses": {
+ "additionalProperties": {
+ "$ref": "#/definitions/McpAuthStatus"
+ },
+ "description": "Authentication status for each configured MCP server.",
+ "type": "object"
+ },
+ "resource_templates": {
+ "additionalProperties": {
+ "items": {
+ "$ref": "#/definitions/ResourceTemplate"
+ },
+ "type": "array"
+ },
+ "description": "Known resource templates grouped by server name.",
+ "type": "object"
+ },
+ "resources": {
+ "additionalProperties": {
+ "items": {
+ "$ref": "#/definitions/Resource"
+ },
+ "type": "array"
+ },
+ "description": "Known resources grouped by server name.",
+ "type": "object"
+ },
+ "tools": {
+ "additionalProperties": {
+ "$ref": "#/definitions/Tool"
+ },
+ "description": "Fully qualified tool name -> tool definition.",
+ "type": "object"
+ },
+ "type": {
+ "enum": [
+ "mcp_list_tools_response"
+ ],
+ "title": "McpListToolsResponseEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "auth_statuses",
+ "resource_templates",
+ "resources",
+ "tools",
+ "type"
+ ],
+ "title": "McpListToolsResponseEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "List of custom prompts available to the agent.",
+ "properties": {
+ "custom_prompts": {
+ "items": {
+ "$ref": "#/definitions/CustomPrompt"
+ },
+ "type": "array"
+ },
+ "type": {
+ "enum": [
+ "list_custom_prompts_response"
+ ],
+ "title": "ListCustomPromptsResponseEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "custom_prompts",
+ "type"
+ ],
+ "title": "ListCustomPromptsResponseEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "List of skills available to the agent.",
+ "properties": {
+ "skills": {
+ "items": {
+ "$ref": "#/definitions/SkillsListEntry"
+ },
+ "type": "array"
+ },
+ "type": {
+ "enum": [
+ "list_skills_response"
+ ],
+ "title": "ListSkillsResponseEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "skills",
+ "type"
+ ],
+ "title": "ListSkillsResponseEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Notification that skill data may have been updated and clients may want to reload.",
+ "properties": {
+ "type": {
+ "enum": [
+ "skills_update_available"
+ ],
+ "title": "SkillsUpdateAvailableEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "SkillsUpdateAvailableEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "explanation": {
+ "default": null,
+ "description": "Arguments for the `update_plan` todo/checklist tool (not plan mode).",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "plan": {
+ "items": {
+ "$ref": "#/definitions/PlanItemArg"
+ },
+ "type": "array"
+ },
+ "type": {
+ "enum": [
+ "plan_update"
+ ],
+ "title": "PlanUpdateEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "plan",
+ "type"
+ ],
+ "title": "PlanUpdateEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "reason": {
+ "$ref": "#/definitions/TurnAbortReason"
+ },
+ "type": {
+ "enum": [
+ "turn_aborted"
+ ],
+ "title": "TurnAbortedEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "reason",
+ "type"
+ ],
+ "title": "TurnAbortedEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Notification that the agent is shutting down.",
+ "properties": {
+ "type": {
+ "enum": [
+ "shutdown_complete"
+ ],
+ "title": "ShutdownCompleteEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "ShutdownCompleteEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Entered review mode.",
+ "properties": {
+ "target": {
+ "$ref": "#/definitions/ReviewTarget"
+ },
+ "type": {
+ "enum": [
+ "entered_review_mode"
+ ],
+ "title": "EnteredReviewModeEventMsgType",
+ "type": "string"
+ },
+ "user_facing_hint": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "target",
+ "type"
+ ],
+ "title": "EnteredReviewModeEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Exited review mode with an optional final result to apply.",
+ "properties": {
+ "review_output": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ReviewOutputEvent"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "type": {
+ "enum": [
+ "exited_review_mode"
+ ],
+ "title": "ExitedReviewModeEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "ExitedReviewModeEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "item": {
+ "$ref": "#/definitions/ResponseItem"
+ },
+ "type": {
+ "enum": [
+ "raw_response_item"
+ ],
+ "title": "RawResponseItemEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "item",
+ "type"
+ ],
+ "title": "RawResponseItemEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "item": {
+ "$ref": "#/definitions/TurnItem"
+ },
+ "thread_id": {
+ "$ref": "#/definitions/ThreadId"
+ },
+ "turn_id": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "item_started"
+ ],
+ "title": "ItemStartedEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "item",
+ "thread_id",
+ "turn_id",
+ "type"
+ ],
+ "title": "ItemStartedEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "item": {
+ "$ref": "#/definitions/TurnItem"
+ },
+ "thread_id": {
+ "$ref": "#/definitions/ThreadId"
+ },
+ "turn_id": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "item_completed"
+ ],
+ "title": "ItemCompletedEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "item",
+ "thread_id",
+ "turn_id",
+ "type"
+ ],
+ "title": "ItemCompletedEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "delta": {
+ "type": "string"
+ },
+ "item_id": {
+ "type": "string"
+ },
+ "thread_id": {
+ "type": "string"
+ },
+ "turn_id": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "agent_message_content_delta"
+ ],
+ "title": "AgentMessageContentDeltaEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "delta",
+ "item_id",
+ "thread_id",
+ "turn_id",
+ "type"
+ ],
+ "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": {
+ "type": "string"
+ },
+ "item_id": {
+ "type": "string"
+ },
+ "summary_index": {
+ "default": 0,
+ "format": "int64",
+ "type": "integer"
+ },
+ "thread_id": {
+ "type": "string"
+ },
+ "turn_id": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "reasoning_content_delta"
+ ],
+ "title": "ReasoningContentDeltaEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "delta",
+ "item_id",
+ "thread_id",
+ "turn_id",
+ "type"
+ ],
+ "title": "ReasoningContentDeltaEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "content_index": {
+ "default": 0,
+ "format": "int64",
+ "type": "integer"
+ },
+ "delta": {
+ "type": "string"
+ },
+ "item_id": {
+ "type": "string"
+ },
+ "thread_id": {
+ "type": "string"
+ },
+ "turn_id": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "reasoning_raw_content_delta"
+ ],
+ "title": "ReasoningRawContentDeltaEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "delta",
+ "item_id",
+ "thread_id",
+ "turn_id",
+ "type"
+ ],
+ "title": "ReasoningRawContentDeltaEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Collab interaction: agent spawn begin.",
+ "properties": {
+ "call_id": {
+ "description": "Identifier for the collab tool call.",
+ "type": "string"
+ },
+ "prompt": {
+ "description": "Initial prompt sent to the agent. Can be empty to prevent CoT leaking at the beginning.",
+ "type": "string"
+ },
+ "sender_thread_id": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ThreadId"
+ }
+ ],
+ "description": "Thread ID of the sender."
+ },
+ "type": {
+ "enum": [
+ "collab_agent_spawn_begin"
+ ],
+ "title": "CollabAgentSpawnBeginEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "prompt",
+ "sender_thread_id",
+ "type"
+ ],
+ "title": "CollabAgentSpawnBeginEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Collab interaction: agent spawn end.",
+ "properties": {
+ "call_id": {
+ "description": "Identifier for the collab tool call.",
+ "type": "string"
+ },
+ "new_thread_id": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ThreadId"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Thread ID of the newly spawned agent, if it was created."
+ },
+ "prompt": {
+ "description": "Initial prompt sent to the agent. Can be empty to prevent CoT leaking at the beginning.",
+ "type": "string"
+ },
+ "sender_thread_id": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ThreadId"
+ }
+ ],
+ "description": "Thread ID of the sender."
+ },
+ "status": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/AgentStatus"
+ }
+ ],
+ "description": "Last known status of the new agent reported to the sender agent."
+ },
+ "type": {
+ "enum": [
+ "collab_agent_spawn_end"
+ ],
+ "title": "CollabAgentSpawnEndEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "prompt",
+ "sender_thread_id",
+ "status",
+ "type"
+ ],
+ "title": "CollabAgentSpawnEndEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Collab interaction: agent interaction begin.",
+ "properties": {
+ "call_id": {
+ "description": "Identifier for the collab tool call.",
+ "type": "string"
+ },
+ "prompt": {
+ "description": "Prompt sent from the sender to the receiver. Can be empty to prevent CoT leaking at the beginning.",
+ "type": "string"
+ },
+ "receiver_thread_id": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ThreadId"
+ }
+ ],
+ "description": "Thread ID of the receiver."
+ },
+ "sender_thread_id": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ThreadId"
+ }
+ ],
+ "description": "Thread ID of the sender."
+ },
+ "type": {
+ "enum": [
+ "collab_agent_interaction_begin"
+ ],
+ "title": "CollabAgentInteractionBeginEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "prompt",
+ "receiver_thread_id",
+ "sender_thread_id",
+ "type"
+ ],
+ "title": "CollabAgentInteractionBeginEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Collab interaction: agent interaction end.",
+ "properties": {
+ "call_id": {
+ "description": "Identifier for the collab tool call.",
+ "type": "string"
+ },
+ "prompt": {
+ "description": "Prompt sent from the sender to the receiver. Can be empty to prevent CoT leaking at the beginning.",
+ "type": "string"
+ },
+ "receiver_thread_id": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ThreadId"
+ }
+ ],
+ "description": "Thread ID of the receiver."
+ },
+ "sender_thread_id": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ThreadId"
+ }
+ ],
+ "description": "Thread ID of the sender."
+ },
+ "status": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/AgentStatus"
+ }
+ ],
+ "description": "Last known status of the receiver agent reported to the sender agent."
+ },
+ "type": {
+ "enum": [
+ "collab_agent_interaction_end"
+ ],
+ "title": "CollabAgentInteractionEndEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "prompt",
+ "receiver_thread_id",
+ "sender_thread_id",
+ "status",
+ "type"
+ ],
+ "title": "CollabAgentInteractionEndEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Collab interaction: waiting begin.",
+ "properties": {
+ "call_id": {
+ "description": "ID of the waiting call.",
+ "type": "string"
+ },
+ "receiver_thread_ids": {
+ "description": "Thread ID of the receivers.",
+ "items": {
+ "$ref": "#/definitions/ThreadId"
+ },
+ "type": "array"
+ },
+ "sender_thread_id": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ThreadId"
+ }
+ ],
+ "description": "Thread ID of the sender."
+ },
+ "type": {
+ "enum": [
+ "collab_waiting_begin"
+ ],
+ "title": "CollabWaitingBeginEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "receiver_thread_ids",
+ "sender_thread_id",
+ "type"
+ ],
+ "title": "CollabWaitingBeginEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Collab interaction: waiting end.",
+ "properties": {
+ "call_id": {
+ "description": "ID of the waiting call.",
+ "type": "string"
+ },
+ "sender_thread_id": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ThreadId"
+ }
+ ],
+ "description": "Thread ID of the sender."
+ },
+ "statuses": {
+ "additionalProperties": {
+ "$ref": "#/definitions/AgentStatus"
+ },
+ "description": "Last known status of the receiver agents reported to the sender agent.",
+ "type": "object"
+ },
+ "type": {
+ "enum": [
+ "collab_waiting_end"
+ ],
+ "title": "CollabWaitingEndEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "sender_thread_id",
+ "statuses",
+ "type"
+ ],
+ "title": "CollabWaitingEndEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Collab interaction: close begin.",
+ "properties": {
+ "call_id": {
+ "description": "Identifier for the collab tool call.",
+ "type": "string"
+ },
+ "receiver_thread_id": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ThreadId"
+ }
+ ],
+ "description": "Thread ID of the receiver."
+ },
+ "sender_thread_id": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ThreadId"
+ }
+ ],
+ "description": "Thread ID of the sender."
+ },
+ "type": {
+ "enum": [
+ "collab_close_begin"
+ ],
+ "title": "CollabCloseBeginEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "receiver_thread_id",
+ "sender_thread_id",
+ "type"
+ ],
+ "title": "CollabCloseBeginEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Collab interaction: close end.",
+ "properties": {
+ "call_id": {
+ "description": "Identifier for the collab tool call.",
+ "type": "string"
+ },
+ "receiver_thread_id": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ThreadId"
+ }
+ ],
+ "description": "Thread ID of the receiver."
+ },
+ "sender_thread_id": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ThreadId"
+ }
+ ],
+ "description": "Thread ID of the sender."
+ },
+ "status": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/AgentStatus"
+ }
+ ],
+ "description": "Last known status of the receiver agent reported to the sender agent before the close."
+ },
+ "type": {
+ "enum": [
+ "collab_close_end"
+ ],
+ "title": "CollabCloseEndEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "receiver_thread_id",
+ "sender_thread_id",
+ "status",
+ "type"
+ ],
+ "title": "CollabCloseEndEventMsg",
+ "type": "object"
+ }
+ ]
+ },
+ "ExecCommandSource": {
+ "enum": [
+ "agent",
+ "user_shell",
+ "unified_exec_startup",
+ "unified_exec_interaction"
+ ],
+ "type": "string"
+ },
+ "ExecOutputStream": {
+ "enum": [
+ "stdout",
+ "stderr"
+ ],
+ "type": "string"
+ },
+ "FileChange": {
+ "oneOf": [
+ {
+ "properties": {
+ "content": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "add"
+ ],
+ "title": "AddFileChangeType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "content",
+ "type"
+ ],
+ "title": "AddFileChange",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "content": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "delete"
+ ],
+ "title": "DeleteFileChangeType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "content",
+ "type"
+ ],
+ "title": "DeleteFileChange",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "move_path": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "update"
+ ],
+ "title": "UpdateFileChangeType",
+ "type": "string"
+ },
+ "unified_diff": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "unified_diff"
+ ],
+ "title": "UpdateFileChange",
+ "type": "object"
+ }
+ ]
+ },
+ "FunctionCallOutputContentItem": {
+ "description": "Responses API compatible content items that can be returned by a tool call. This is a subset of ContentItem with the types we support as function call outputs.",
+ "oneOf": [
+ {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "input_text"
+ ],
+ "title": "InputTextFunctionCallOutputContentItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "InputTextFunctionCallOutputContentItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "image_url": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "input_image"
+ ],
+ "title": "InputImageFunctionCallOutputContentItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "image_url",
+ "type"
+ ],
+ "title": "InputImageFunctionCallOutputContentItem",
+ "type": "object"
+ }
+ ]
+ },
+ "FunctionCallOutputPayload": {
+ "description": "The payload we send back to OpenAI when reporting a tool call result.\n\n`content` preserves the historical plain-string payload so downstream integrations (tests, logging, etc.) can keep treating tool output as `String`. When an MCP server returns richer data we additionally populate `content_items` with the structured form that the Responses/Chat Completions APIs understand.",
+ "properties": {
+ "content": {
+ "type": "string"
+ },
+ "content_items": {
+ "items": {
+ "$ref": "#/definitions/FunctionCallOutputContentItem"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "success": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "content"
+ ],
+ "type": "object"
+ },
+ "GhostCommit": {
+ "description": "Details of a ghost commit created from a repository state.",
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "parent": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "preexisting_untracked_dirs": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "preexisting_untracked_files": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ }
+ },
+ "required": [
+ "id",
+ "preexisting_untracked_dirs",
+ "preexisting_untracked_files"
+ ],
+ "type": "object"
+ },
+ "HistoryEntry": {
+ "properties": {
+ "conversation_id": {
+ "type": "string"
+ },
+ "text": {
+ "type": "string"
+ },
+ "ts": {
+ "format": "uint64",
+ "minimum": 0.0,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "conversation_id",
+ "text",
+ "ts"
+ ],
+ "type": "object"
+ },
+ "ImageContent": {
+ "description": "An image provided to or from an LLM.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "data": {
+ "type": "string"
+ },
+ "mimeType": {
+ "type": "string"
+ },
+ "type": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "data",
+ "mimeType",
+ "type"
+ ],
+ "type": "object"
+ },
+ "LocalShellAction": {
+ "oneOf": [
+ {
+ "properties": {
+ "command": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "env": {
+ "additionalProperties": {
+ "type": "string"
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "timeout_ms": {
+ "format": "uint64",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "exec"
+ ],
+ "title": "ExecLocalShellActionType",
+ "type": "string"
+ },
+ "user": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "working_directory": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "command",
+ "type"
+ ],
+ "title": "ExecLocalShellAction",
+ "type": "object"
+ }
+ ]
+ },
+ "LocalShellStatus": {
+ "enum": [
+ "completed",
+ "in_progress",
+ "incomplete"
+ ],
+ "type": "string"
+ },
+ "McpAuthStatus": {
+ "enum": [
+ "unsupported",
+ "not_logged_in",
+ "bearer_token",
+ "o_auth"
+ ],
+ "type": "string"
+ },
+ "McpInvocation": {
+ "properties": {
+ "arguments": {
+ "description": "Arguments to the tool call."
+ },
+ "server": {
+ "description": "Name of the MCP server as defined in the config.",
+ "type": "string"
+ },
+ "tool": {
+ "description": "Name of the tool as given by the MCP server.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "server",
+ "tool"
+ ],
+ "type": "object"
+ },
+ "McpStartupFailure": {
+ "properties": {
+ "error": {
+ "type": "string"
+ },
+ "server": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "error",
+ "server"
+ ],
+ "type": "object"
+ },
+ "McpStartupStatus": {
+ "oneOf": [
+ {
+ "properties": {
+ "state": {
+ "enum": [
+ "starting"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "state"
+ ],
+ "title": "StateMcpStartupStatus",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "state": {
+ "enum": [
+ "ready"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "state"
+ ],
+ "title": "StateMcpStartupStatus2",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "error": {
+ "type": "string"
+ },
+ "state": {
+ "enum": [
+ "failed"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "error",
+ "state"
+ ],
+ "type": "object"
+ },
+ {
+ "properties": {
+ "state": {
+ "enum": [
+ "cancelled"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "state"
+ ],
+ "title": "StateMcpStartupStatus3",
+ "type": "object"
+ }
+ ]
+ },
+ "ModeKind": {
+ "description": "Initial collaboration mode to use when the TUI starts.",
+ "enum": [
+ "plan",
+ "code",
+ "pair_programming",
+ "execute",
+ "custom"
+ ],
+ "type": "string"
+ },
+ "NetworkAccess": {
+ "description": "Represents whether outbound network access is available to the agent.",
+ "enum": [
+ "restricted",
+ "enabled"
+ ],
+ "type": "string"
+ },
+ "ParsedCommand": {
+ "oneOf": [
+ {
+ "properties": {
+ "cmd": {
+ "type": "string"
+ },
+ "name": {
+ "type": "string"
+ },
+ "path": {
+ "description": "(Best effort) Path to the file being read by the command. When possible, this is an absolute path, though when relative, it should be resolved against the `cwd`` that will be used to run the command to derive the absolute path.",
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "read"
+ ],
+ "title": "ReadParsedCommandType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "cmd",
+ "name",
+ "path",
+ "type"
+ ],
+ "title": "ReadParsedCommand",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "cmd": {
+ "type": "string"
+ },
+ "path": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "list_files"
+ ],
+ "title": "ListFilesParsedCommandType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "cmd",
+ "type"
+ ],
+ "title": "ListFilesParsedCommand",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "cmd": {
+ "type": "string"
+ },
+ "path": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "query": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "search"
+ ],
+ "title": "SearchParsedCommandType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "cmd",
+ "type"
+ ],
+ "title": "SearchParsedCommand",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "cmd": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "unknown"
+ ],
+ "title": "UnknownParsedCommandType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "cmd",
+ "type"
+ ],
+ "title": "UnknownParsedCommand",
+ "type": "object"
+ }
+ ]
+ },
+ "PlanItemArg": {
+ "additionalProperties": false,
+ "properties": {
+ "status": {
+ "$ref": "#/definitions/StepStatus"
+ },
+ "step": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "status",
+ "step"
+ ],
+ "type": "object"
+ },
+ "PlanType": {
+ "enum": [
+ "free",
+ "go",
+ "plus",
+ "pro",
+ "team",
+ "business",
+ "enterprise",
+ "edu",
+ "unknown"
+ ],
+ "type": "string"
+ },
+ "RateLimitSnapshot": {
+ "properties": {
+ "credits": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/CreditsSnapshot"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "plan_type": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/PlanType"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "primary": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/RateLimitWindow"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "secondary": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/RateLimitWindow"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "RateLimitWindow": {
+ "properties": {
+ "resets_at": {
+ "description": "Unix timestamp (seconds since epoch) when the window resets.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "used_percent": {
+ "description": "Percentage (0-100) of the window that has been consumed.",
+ "format": "double",
+ "type": "number"
+ },
+ "window_minutes": {
+ "description": "Rolling window duration, in minutes.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "used_percent"
+ ],
+ "type": "object"
+ },
+ "ReasoningEffort": {
+ "description": "See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#get-started-with-reasoning",
+ "enum": [
+ "none",
+ "minimal",
+ "low",
+ "medium",
+ "high",
+ "xhigh"
+ ],
+ "type": "string"
+ },
+ "ReasoningItemContent": {
+ "oneOf": [
+ {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "reasoning_text"
+ ],
+ "title": "ReasoningTextReasoningItemContentType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "ReasoningTextReasoningItemContent",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "text"
+ ],
+ "title": "TextReasoningItemContentType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "TextReasoningItemContent",
+ "type": "object"
+ }
+ ]
+ },
+ "ReasoningItemReasoningSummary": {
+ "oneOf": [
+ {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "summary_text"
+ ],
+ "title": "SummaryTextReasoningItemReasoningSummaryType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "SummaryTextReasoningItemReasoningSummary",
+ "type": "object"
+ }
+ ]
+ },
+ "RequestId": {
+ "anyOf": [
+ {
+ "type": "string"
+ },
+ {
+ "format": "int64",
+ "type": "integer"
+ }
+ ]
+ },
+ "RequestUserInputQuestion": {
+ "properties": {
+ "header": {
+ "type": "string"
+ },
+ "id": {
+ "type": "string"
+ },
+ "isOther": {
+ "default": false,
+ "type": "boolean"
+ },
+ "isSecret": {
+ "default": false,
+ "type": "boolean"
+ },
+ "options": {
+ "items": {
+ "$ref": "#/definitions/RequestUserInputQuestionOption"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "question": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "header",
+ "id",
+ "question"
+ ],
+ "type": "object"
+ },
+ "RequestUserInputQuestionOption": {
+ "properties": {
+ "description": {
+ "type": "string"
+ },
+ "label": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "description",
+ "label"
+ ],
+ "type": "object"
+ },
+ "Resource": {
+ "description": "A known resource that the server is capable of reading.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "description": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "mimeType": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "name": {
+ "type": "string"
+ },
+ "size": {
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "title": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "uri": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "uri"
+ ],
+ "type": "object"
+ },
+ "ResourceLink": {
+ "description": "A resource that the server is capable of reading, included in a prompt or tool call result.\n\nNote: resource links returned by tools are not guaranteed to appear in the results of `resources/list` requests.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "description": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "mimeType": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "name": {
+ "type": "string"
+ },
+ "size": {
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "title": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "type": "string"
+ },
+ "uri": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "type",
+ "uri"
+ ],
+ "type": "object"
+ },
+ "ResourceTemplate": {
+ "description": "A template description for resources available on the server.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "description": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "mimeType": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "name": {
+ "type": "string"
+ },
+ "title": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "uriTemplate": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "uriTemplate"
+ ],
+ "type": "object"
+ },
+ "ResponseItem": {
+ "oneOf": [
+ {
+ "properties": {
+ "content": {
+ "items": {
+ "$ref": "#/definitions/ContentItem"
+ },
+ "type": "array"
+ },
+ "end_turn": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "id": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "writeOnly": true
+ },
+ "role": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "message"
+ ],
+ "title": "MessageResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "content",
+ "role",
+ "type"
+ ],
+ "title": "MessageResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "content": {
+ "default": null,
+ "items": {
+ "$ref": "#/definitions/ReasoningItemContent"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "encrypted_content": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "id": {
+ "type": "string",
+ "writeOnly": true
+ },
+ "summary": {
+ "items": {
+ "$ref": "#/definitions/ReasoningItemReasoningSummary"
+ },
+ "type": "array"
+ },
+ "type": {
+ "enum": [
+ "reasoning"
+ ],
+ "title": "ReasoningResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "summary",
+ "type"
+ ],
+ "title": "ReasoningResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "action": {
+ "$ref": "#/definitions/LocalShellAction"
+ },
+ "call_id": {
+ "description": "Set when using the Responses API.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "id": {
+ "description": "Set when using the chat completions API.",
+ "type": [
+ "string",
+ "null"
+ ],
+ "writeOnly": true
+ },
+ "status": {
+ "$ref": "#/definitions/LocalShellStatus"
+ },
+ "type": {
+ "enum": [
+ "local_shell_call"
+ ],
+ "title": "LocalShellCallResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "action",
+ "status",
+ "type"
+ ],
+ "title": "LocalShellCallResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "arguments": {
+ "type": "string"
+ },
+ "call_id": {
+ "type": "string"
+ },
+ "id": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "writeOnly": true
+ },
+ "name": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "function_call"
+ ],
+ "title": "FunctionCallResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "arguments",
+ "call_id",
+ "name",
+ "type"
+ ],
+ "title": "FunctionCallResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "call_id": {
+ "type": "string"
+ },
+ "output": {
+ "$ref": "#/definitions/FunctionCallOutputPayload"
+ },
+ "type": {
+ "enum": [
+ "function_call_output"
+ ],
+ "title": "FunctionCallOutputResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "output",
+ "type"
+ ],
+ "title": "FunctionCallOutputResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "call_id": {
+ "type": "string"
+ },
+ "id": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "writeOnly": true
+ },
+ "input": {
+ "type": "string"
+ },
+ "name": {
+ "type": "string"
+ },
+ "status": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "custom_tool_call"
+ ],
+ "title": "CustomToolCallResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "input",
+ "name",
+ "type"
+ ],
+ "title": "CustomToolCallResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "call_id": {
+ "type": "string"
+ },
+ "output": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "custom_tool_call_output"
+ ],
+ "title": "CustomToolCallOutputResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "output",
+ "type"
+ ],
+ "title": "CustomToolCallOutputResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "action": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/WebSearchAction"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "id": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "writeOnly": true
+ },
+ "status": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "web_search_call"
+ ],
+ "title": "WebSearchCallResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "WebSearchCallResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "ghost_commit": {
+ "$ref": "#/definitions/GhostCommit"
+ },
+ "type": {
+ "enum": [
+ "ghost_snapshot"
+ ],
+ "title": "GhostSnapshotResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "ghost_commit",
+ "type"
+ ],
+ "title": "GhostSnapshotResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "encrypted_content": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "compaction"
+ ],
+ "title": "CompactionResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "encrypted_content",
+ "type"
+ ],
+ "title": "CompactionResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "other"
+ ],
+ "title": "OtherResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "OtherResponseItem",
+ "type": "object"
+ }
+ ]
+ },
+ "Result_of_CallToolResult_or_String": {
+ "oneOf": [
+ {
+ "properties": {
+ "Ok": {
+ "$ref": "#/definitions/CallToolResult"
+ }
+ },
+ "required": [
+ "Ok"
+ ],
+ "title": "OkResult_of_CallToolResult_or_String",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "Err": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "Err"
+ ],
+ "title": "ErrResult_of_CallToolResult_or_String",
+ "type": "object"
+ }
+ ]
+ },
+ "ReviewCodeLocation": {
+ "description": "Location of the code related to a review finding.",
+ "properties": {
+ "absolute_file_path": {
+ "type": "string"
+ },
+ "line_range": {
+ "$ref": "#/definitions/ReviewLineRange"
+ }
+ },
+ "required": [
+ "absolute_file_path",
+ "line_range"
+ ],
+ "type": "object"
+ },
+ "ReviewFinding": {
+ "description": "A single review finding describing an observed issue or recommendation.",
+ "properties": {
+ "body": {
+ "type": "string"
+ },
+ "code_location": {
+ "$ref": "#/definitions/ReviewCodeLocation"
+ },
+ "confidence_score": {
+ "format": "float",
+ "type": "number"
+ },
+ "priority": {
+ "format": "int32",
+ "type": "integer"
+ },
+ "title": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "body",
+ "code_location",
+ "confidence_score",
+ "priority",
+ "title"
+ ],
+ "type": "object"
+ },
+ "ReviewLineRange": {
+ "description": "Inclusive line range in a file associated with the finding.",
+ "properties": {
+ "end": {
+ "format": "uint32",
+ "minimum": 0.0,
+ "type": "integer"
+ },
+ "start": {
+ "format": "uint32",
+ "minimum": 0.0,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "end",
+ "start"
+ ],
+ "type": "object"
+ },
+ "ReviewOutputEvent": {
+ "description": "Structured review result produced by a child review session.",
+ "properties": {
+ "findings": {
+ "items": {
+ "$ref": "#/definitions/ReviewFinding"
+ },
+ "type": "array"
+ },
+ "overall_confidence_score": {
+ "format": "float",
+ "type": "number"
+ },
+ "overall_correctness": {
+ "type": "string"
+ },
+ "overall_explanation": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "findings",
+ "overall_confidence_score",
+ "overall_correctness",
+ "overall_explanation"
+ ],
+ "type": "object"
+ },
+ "ReviewTarget": {
+ "oneOf": [
+ {
+ "description": "Review the working tree: staged, unstaged, and untracked files.",
+ "properties": {
+ "type": {
+ "enum": [
+ "uncommittedChanges"
+ ],
+ "title": "UncommittedChangesReviewTargetType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "UncommittedChangesReviewTarget",
+ "type": "object"
+ },
+ {
+ "description": "Review changes between the current branch and the given base branch.",
+ "properties": {
+ "branch": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "baseBranch"
+ ],
+ "title": "BaseBranchReviewTargetType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "branch",
+ "type"
+ ],
+ "title": "BaseBranchReviewTarget",
+ "type": "object"
+ },
+ {
+ "description": "Review the changes introduced by a specific commit.",
+ "properties": {
+ "sha": {
+ "type": "string"
+ },
+ "title": {
+ "description": "Optional human-readable label (e.g., commit subject) for UIs.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "commit"
+ ],
+ "title": "CommitReviewTargetType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "sha",
+ "type"
+ ],
+ "title": "CommitReviewTarget",
+ "type": "object"
+ },
+ {
+ "description": "Arbitrary instructions provided by the user.",
+ "properties": {
+ "instructions": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "custom"
+ ],
+ "title": "CustomReviewTargetType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "instructions",
+ "type"
+ ],
+ "title": "CustomReviewTarget",
+ "type": "object"
+ }
+ ]
+ },
+ "Role": {
+ "description": "The sender or recipient of messages and data in a conversation.",
+ "enum": [
+ "assistant",
+ "user"
+ ],
+ "type": "string"
+ },
+ "SandboxPolicy": {
+ "description": "Determines execution restrictions for model shell commands.",
+ "oneOf": [
+ {
+ "description": "No restrictions whatsoever. Use with caution.",
+ "properties": {
+ "type": {
+ "enum": [
+ "danger-full-access"
+ ],
+ "title": "DangerFullAccessSandboxPolicyType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "DangerFullAccessSandboxPolicy",
+ "type": "object"
+ },
+ {
+ "description": "Read-only access to the entire file-system.",
+ "properties": {
+ "type": {
+ "enum": [
+ "read-only"
+ ],
+ "title": "ReadOnlySandboxPolicyType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "ReadOnlySandboxPolicy",
+ "type": "object"
+ },
+ {
+ "description": "Indicates the process is already in an external sandbox. Allows full disk access while honoring the provided network setting.",
+ "properties": {
+ "network_access": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/NetworkAccess"
+ }
+ ],
+ "default": "restricted",
+ "description": "Whether the external sandbox permits outbound network traffic."
+ },
+ "type": {
+ "enum": [
+ "external-sandbox"
+ ],
+ "title": "ExternalSandboxSandboxPolicyType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "ExternalSandboxSandboxPolicy",
+ "type": "object"
+ },
+ {
+ "description": "Same as `ReadOnly` but additionally grants write access to the current working directory (\"workspace\").",
+ "properties": {
+ "exclude_slash_tmp": {
+ "default": false,
+ "description": "When set to `true`, will NOT include the `/tmp` among the default writable roots on UNIX. Defaults to `false`.",
+ "type": "boolean"
+ },
+ "exclude_tmpdir_env_var": {
+ "default": false,
+ "description": "When set to `true`, will NOT include the per-user `TMPDIR` environment variable among the default writable roots. Defaults to `false`.",
+ "type": "boolean"
+ },
+ "network_access": {
+ "default": false,
+ "description": "When set to `true`, outbound network access is allowed. `false` by default.",
+ "type": "boolean"
+ },
+ "type": {
+ "enum": [
+ "workspace-write"
+ ],
+ "title": "WorkspaceWriteSandboxPolicyType",
+ "type": "string"
+ },
+ "writable_roots": {
+ "description": "Additional folders (beyond cwd and possibly TMPDIR) that should be writable from within the sandbox.",
+ "items": {
+ "$ref": "#/definitions/AbsolutePathBuf"
+ },
+ "type": "array"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "WorkspaceWriteSandboxPolicy",
+ "type": "object"
+ }
+ ]
+ },
+ "SkillDependencies": {
+ "properties": {
+ "tools": {
+ "items": {
+ "$ref": "#/definitions/SkillToolDependency"
+ },
+ "type": "array"
+ }
+ },
+ "required": [
+ "tools"
+ ],
+ "type": "object"
+ },
+ "SkillErrorInfo": {
+ "properties": {
+ "message": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "message",
+ "path"
+ ],
+ "type": "object"
+ },
+ "SkillInterface": {
+ "properties": {
+ "brand_color": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "default_prompt": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "display_name": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "icon_large": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "icon_small": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "short_description": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "SkillMetadata": {
+ "properties": {
+ "dependencies": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/SkillDependencies"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "description": {
+ "type": "string"
+ },
+ "enabled": {
+ "type": "boolean"
+ },
+ "interface": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/SkillInterface"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "name": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "scope": {
+ "$ref": "#/definitions/SkillScope"
+ },
+ "short_description": {
+ "description": "Legacy short_description from SKILL.md. Prefer SKILL.json interface.short_description.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "description",
+ "enabled",
+ "name",
+ "path",
+ "scope"
+ ],
+ "type": "object"
+ },
+ "SkillScope": {
+ "enum": [
+ "user",
+ "repo",
+ "system",
+ "admin"
+ ],
+ "type": "string"
+ },
+ "SkillToolDependency": {
+ "properties": {
+ "command": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "description": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "transport": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "type": "string"
+ },
+ "url": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "value": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "value"
+ ],
+ "type": "object"
+ },
+ "SkillsListEntry": {
+ "properties": {
+ "cwd": {
+ "type": "string"
+ },
+ "errors": {
+ "items": {
+ "$ref": "#/definitions/SkillErrorInfo"
+ },
+ "type": "array"
+ },
+ "skills": {
+ "items": {
+ "$ref": "#/definitions/SkillMetadata"
+ },
+ "type": "array"
+ }
+ },
+ "required": [
+ "cwd",
+ "errors",
+ "skills"
+ ],
+ "type": "object"
+ },
+ "StepStatus": {
+ "enum": [
+ "pending",
+ "in_progress",
+ "completed"
+ ],
+ "type": "string"
+ },
+ "TextContent": {
+ "description": "Text provided to or from an LLM.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "type": "object"
+ },
+ "TextElement": {
+ "properties": {
+ "byte_range": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ByteRange"
+ }
+ ],
+ "description": "Byte range in the parent `text` buffer that this element occupies."
+ },
+ "placeholder": {
+ "description": "Optional human-readable placeholder for the element, displayed in the UI.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "byte_range"
+ ],
+ "type": "object"
+ },
+ "TextResourceContents": {
+ "properties": {
+ "mimeType": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "text": {
+ "type": "string"
+ },
+ "uri": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "uri"
+ ],
+ "type": "object"
+ },
+ "ThreadId": {
+ "type": "string"
+ },
+ "TokenUsage": {
+ "properties": {
+ "cached_input_tokens": {
+ "format": "int64",
+ "type": "integer"
+ },
+ "input_tokens": {
+ "format": "int64",
+ "type": "integer"
+ },
+ "output_tokens": {
+ "format": "int64",
+ "type": "integer"
+ },
+ "reasoning_output_tokens": {
+ "format": "int64",
+ "type": "integer"
+ },
+ "total_tokens": {
+ "format": "int64",
+ "type": "integer"
+ }
+ },
+ "required": [
+ "cached_input_tokens",
+ "input_tokens",
+ "output_tokens",
+ "reasoning_output_tokens",
+ "total_tokens"
+ ],
+ "type": "object"
+ },
+ "TokenUsageInfo": {
+ "properties": {
+ "last_token_usage": {
+ "$ref": "#/definitions/TokenUsage"
+ },
+ "model_context_window": {
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "total_token_usage": {
+ "$ref": "#/definitions/TokenUsage"
+ }
+ },
+ "required": [
+ "last_token_usage",
+ "total_token_usage"
+ ],
+ "type": "object"
+ },
+ "Tool": {
+ "description": "Definition for a tool the client can call.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ToolAnnotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "description": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "inputSchema": {
+ "$ref": "#/definitions/ToolInputSchema"
+ },
+ "name": {
+ "type": "string"
+ },
+ "outputSchema": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ToolOutputSchema"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "title": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "inputSchema",
+ "name"
+ ],
+ "type": "object"
+ },
+ "ToolAnnotations": {
+ "description": "Additional properties describing a Tool to clients.\n\nNOTE: all properties in ToolAnnotations are **hints**. They are not guaranteed to provide a faithful description of tool behavior (including descriptive properties like `title`).\n\nClients should never make tool use decisions based on ToolAnnotations received from untrusted servers.",
+ "properties": {
+ "destructiveHint": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "idempotentHint": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "openWorldHint": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "readOnlyHint": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "title": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "ToolInputSchema": {
+ "description": "A JSON Schema object defining the expected parameters for the tool.",
+ "properties": {
+ "properties": true,
+ "required": {
+ "items": {
+ "type": "string"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "type": {
+ "default": "object",
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "ToolOutputSchema": {
+ "description": "An optional JSON Schema object defining the structure of the tool's output returned in the structuredContent field of a CallToolResult.",
+ "properties": {
+ "properties": true,
+ "required": {
+ "items": {
+ "type": "string"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "type": {
+ "default": "object",
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "TurnAbortReason": {
+ "enum": [
+ "interrupted",
+ "replaced",
+ "review_ended"
+ ],
+ "type": "string"
+ },
+ "TurnItem": {
+ "oneOf": [
+ {
+ "properties": {
+ "content": {
+ "items": {
+ "$ref": "#/definitions/UserInput"
+ },
+ "type": "array"
+ },
+ "id": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "UserMessage"
+ ],
+ "title": "UserMessageTurnItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "content",
+ "id",
+ "type"
+ ],
+ "title": "UserMessageTurnItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "content": {
+ "items": {
+ "$ref": "#/definitions/AgentMessageContent"
+ },
+ "type": "array"
+ },
+ "id": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "AgentMessage"
+ ],
+ "title": "AgentMessageTurnItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "content",
+ "id",
+ "type"
+ ],
+ "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": {
+ "type": "string"
+ },
+ "raw_content": {
+ "default": [],
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "summary_text": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "type": {
+ "enum": [
+ "Reasoning"
+ ],
+ "title": "ReasoningTurnItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "summary_text",
+ "type"
+ ],
+ "title": "ReasoningTurnItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "action": {
+ "$ref": "#/definitions/WebSearchAction"
+ },
+ "id": {
+ "type": "string"
+ },
+ "query": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "WebSearch"
+ ],
+ "title": "WebSearchTurnItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "action",
+ "id",
+ "query",
+ "type"
+ ],
+ "title": "WebSearchTurnItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "ContextCompaction"
+ ],
+ "title": "ContextCompactionTurnItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "type"
+ ],
+ "title": "ContextCompactionTurnItem",
+ "type": "object"
+ }
+ ]
+ },
+ "UserInput": {
+ "description": "User input",
+ "oneOf": [
+ {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "text_elements": {
+ "default": [],
+ "description": "UI-defined spans within `text` that should be treated as special elements. These are byte ranges into the UTF-8 `text` buffer and are used to render or persist rich input markers (e.g., image placeholders) across history and resume without mutating the literal text.",
+ "items": {
+ "$ref": "#/definitions/TextElement"
+ },
+ "type": "array"
+ },
+ "type": {
+ "enum": [
+ "text"
+ ],
+ "title": "TextUserInputType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "TextUserInput",
+ "type": "object"
+ },
+ {
+ "description": "Pre‑encoded data: URI image.",
+ "properties": {
+ "image_url": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "image"
+ ],
+ "title": "ImageUserInputType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "image_url",
+ "type"
+ ],
+ "title": "ImageUserInput",
+ "type": "object"
+ },
+ {
+ "description": "Local image path provided by the user. This will be converted to an `Image` variant (base64 data URL) during request serialization.",
+ "properties": {
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "local_image"
+ ],
+ "title": "LocalImageUserInputType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "path",
+ "type"
+ ],
+ "title": "LocalImageUserInput",
+ "type": "object"
+ },
+ {
+ "description": "Skill selected by the user (name + path to SKILL.md).",
+ "properties": {
+ "name": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "skill"
+ ],
+ "title": "SkillUserInputType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "path",
+ "type"
+ ],
+ "title": "SkillUserInput",
+ "type": "object"
+ },
+ {
+ "description": "Explicit mention selected by the user (name + app://connector id).",
+ "properties": {
+ "name": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "mention"
+ ],
+ "title": "MentionUserInputType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "path",
+ "type"
+ ],
+ "title": "MentionUserInput",
+ "type": "object"
+ }
+ ]
+ },
+ "WebSearchAction": {
+ "oneOf": [
+ {
+ "properties": {
+ "queries": {
+ "items": {
+ "type": "string"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "query": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "search"
+ ],
+ "title": "SearchWebSearchActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "SearchWebSearchAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "open_page"
+ ],
+ "title": "OpenPageWebSearchActionType",
+ "type": "string"
+ },
+ "url": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "OpenPageWebSearchAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "pattern": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "find_in_page"
+ ],
+ "title": "FindInPageWebSearchActionType",
+ "type": "string"
+ },
+ "url": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "FindInPageWebSearchAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "other"
+ ],
+ "title": "OtherWebSearchActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "OtherWebSearchAction",
+ "type": "object"
+ }
+ ]
+ }
+ },
+ "description": "Response event from the agent NOTE: Make sure none of these values have optional types, as it will mess up the extension code-gen.",
+ "oneOf": [
+ {
+ "description": "Error while executing a submission",
+ "properties": {
+ "codex_error_info": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/CodexErrorInfo"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "default": null
+ },
+ "message": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "error"
+ ],
+ "title": "ErrorEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "message",
+ "type"
+ ],
+ "title": "ErrorEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Warning issued while processing a submission. Unlike `Error`, this indicates the turn continued but the user should still be notified.",
+ "properties": {
+ "message": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "warning"
+ ],
+ "title": "WarningEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "message",
+ "type"
+ ],
+ "title": "WarningEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Conversation history was compacted (either automatically or manually).",
+ "properties": {
+ "type": {
+ "enum": [
+ "context_compacted"
+ ],
+ "title": "ContextCompactedEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "ContextCompactedEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Conversation history was rolled back by dropping the last N user turns.",
+ "properties": {
+ "num_turns": {
+ "description": "Number of user turns that were removed from context.",
+ "format": "uint32",
+ "minimum": 0.0,
+ "type": "integer"
+ },
+ "type": {
+ "enum": [
+ "thread_rolled_back"
+ ],
+ "title": "ThreadRolledBackEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "num_turns",
+ "type"
+ ],
+ "title": "ThreadRolledBackEventMsg",
+ "type": "object"
+ },
+ {
+ "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": "code"
+ },
+ "model_context_window": {
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "task_started"
+ ],
+ "title": "TaskStartedEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "TaskStartedEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Agent has completed all actions. v1 wire format uses `task_complete`; accept `turn_complete` for v2 interop.",
+ "properties": {
+ "last_agent_message": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "task_complete"
+ ],
+ "title": "TaskCompleteEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "TaskCompleteEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Usage update for the current session, including totals and last turn. Optional means unknown — UIs should not display when `None`.",
+ "properties": {
+ "info": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/TokenUsageInfo"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "rate_limits": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/RateLimitSnapshot"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "type": {
+ "enum": [
+ "token_count"
+ ],
+ "title": "TokenCountEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "TokenCountEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Agent text output message",
+ "properties": {
+ "message": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "agent_message"
+ ],
+ "title": "AgentMessageEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "message",
+ "type"
+ ],
+ "title": "AgentMessageEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "User/system input message (what was sent to the model)",
+ "properties": {
+ "images": {
+ "description": "Image URLs sourced from `UserInput::Image`. These are safe to replay in legacy UI history events and correspond to images sent to the model.",
+ "items": {
+ "type": "string"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "local_images": {
+ "default": [],
+ "description": "Local file paths sourced from `UserInput::LocalImage`. These are kept so the UI can reattach images when editing history, and should not be sent to the model or treated as API-ready URLs.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "message": {
+ "type": "string"
+ },
+ "text_elements": {
+ "default": [],
+ "description": "UI-defined spans within `message` used to render or persist special elements.",
+ "items": {
+ "$ref": "#/definitions/TextElement"
+ },
+ "type": "array"
+ },
+ "type": {
+ "enum": [
+ "user_message"
+ ],
+ "title": "UserMessageEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "message",
+ "type"
+ ],
+ "title": "UserMessageEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Agent text output delta message",
+ "properties": {
+ "delta": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "agent_message_delta"
+ ],
+ "title": "AgentMessageDeltaEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "delta",
+ "type"
+ ],
+ "title": "AgentMessageDeltaEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Reasoning event from agent.",
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "agent_reasoning"
+ ],
+ "title": "AgentReasoningEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "AgentReasoningEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Agent reasoning delta event from agent.",
+ "properties": {
+ "delta": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "agent_reasoning_delta"
+ ],
+ "title": "AgentReasoningDeltaEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "delta",
+ "type"
+ ],
+ "title": "AgentReasoningDeltaEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Raw chain-of-thought from agent.",
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "agent_reasoning_raw_content"
+ ],
+ "title": "AgentReasoningRawContentEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "AgentReasoningRawContentEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Agent reasoning content delta event from agent.",
+ "properties": {
+ "delta": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "agent_reasoning_raw_content_delta"
+ ],
+ "title": "AgentReasoningRawContentDeltaEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "delta",
+ "type"
+ ],
+ "title": "AgentReasoningRawContentDeltaEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Signaled when the model begins a new reasoning summary section (e.g., a new titled block).",
+ "properties": {
+ "item_id": {
+ "default": "",
+ "type": "string"
+ },
+ "summary_index": {
+ "default": 0,
+ "format": "int64",
+ "type": "integer"
+ },
+ "type": {
+ "enum": [
+ "agent_reasoning_section_break"
+ ],
+ "title": "AgentReasoningSectionBreakEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "AgentReasoningSectionBreakEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Ack the client's configure message.",
+ "properties": {
+ "approval_policy": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/AskForApproval"
+ }
+ ],
+ "description": "When to escalate for approval for execution"
+ },
+ "cwd": {
+ "description": "Working directory that should be treated as the *root* of the session.",
+ "type": "string"
+ },
+ "forked_from_id": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ThreadId"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "history_entry_count": {
+ "description": "Current number of entries in the history log.",
+ "format": "uint",
+ "minimum": 0.0,
+ "type": "integer"
+ },
+ "history_log_id": {
+ "description": "Identifier of the history log file (inode on Unix, 0 otherwise).",
+ "format": "uint64",
+ "minimum": 0.0,
+ "type": "integer"
+ },
+ "initial_messages": {
+ "description": "Optional initial messages (as events) for resumed sessions. When present, UIs can use these to seed the history.",
+ "items": {
+ "$ref": "#/definitions/EventMsg"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "model": {
+ "description": "Tell the client what model is being queried.",
+ "type": "string"
+ },
+ "model_provider_id": {
+ "type": "string"
+ },
+ "reasoning_effort": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ReasoningEffort"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "The effort the model is putting into reasoning about the user's request."
+ },
+ "rollout_path": {
+ "description": "Path in which the rollout is stored. Can be `None` for ephemeral threads",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "sandbox_policy": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/SandboxPolicy"
+ }
+ ],
+ "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"
+ ]
+ },
+ "type": {
+ "enum": [
+ "session_configured"
+ ],
+ "title": "SessionConfiguredEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "approval_policy",
+ "cwd",
+ "history_entry_count",
+ "history_log_id",
+ "model",
+ "model_provider_id",
+ "sandbox_policy",
+ "session_id",
+ "type"
+ ],
+ "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": {
+ "server": {
+ "description": "Server name being started.",
+ "type": "string"
+ },
+ "status": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/McpStartupStatus"
+ }
+ ],
+ "description": "Current startup status."
+ },
+ "type": {
+ "enum": [
+ "mcp_startup_update"
+ ],
+ "title": "McpStartupUpdateEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "server",
+ "status",
+ "type"
+ ],
+ "title": "McpStartupUpdateEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Aggregate MCP startup completion summary.",
+ "properties": {
+ "cancelled": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "failed": {
+ "items": {
+ "$ref": "#/definitions/McpStartupFailure"
+ },
+ "type": "array"
+ },
+ "ready": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "type": {
+ "enum": [
+ "mcp_startup_complete"
+ ],
+ "title": "McpStartupCompleteEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "cancelled",
+ "failed",
+ "ready",
+ "type"
+ ],
+ "title": "McpStartupCompleteEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "call_id": {
+ "description": "Identifier so this can be paired with the McpToolCallEnd event.",
+ "type": "string"
+ },
+ "invocation": {
+ "$ref": "#/definitions/McpInvocation"
+ },
+ "type": {
+ "enum": [
+ "mcp_tool_call_begin"
+ ],
+ "title": "McpToolCallBeginEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "invocation",
+ "type"
+ ],
+ "title": "McpToolCallBeginEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "call_id": {
+ "description": "Identifier for the corresponding McpToolCallBegin that finished.",
+ "type": "string"
+ },
+ "duration": {
+ "$ref": "#/definitions/Duration"
+ },
+ "invocation": {
+ "$ref": "#/definitions/McpInvocation"
+ },
+ "result": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/Result_of_CallToolResult_or_String"
+ }
+ ],
+ "description": "Result of the tool call. Note this could be an error."
+ },
+ "type": {
+ "enum": [
+ "mcp_tool_call_end"
+ ],
+ "title": "McpToolCallEndEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "duration",
+ "invocation",
+ "result",
+ "type"
+ ],
+ "title": "McpToolCallEndEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "call_id": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "web_search_begin"
+ ],
+ "title": "WebSearchBeginEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "type"
+ ],
+ "title": "WebSearchBeginEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "action": {
+ "$ref": "#/definitions/WebSearchAction"
+ },
+ "call_id": {
+ "type": "string"
+ },
+ "query": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "web_search_end"
+ ],
+ "title": "WebSearchEndEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "action",
+ "call_id",
+ "query",
+ "type"
+ ],
+ "title": "WebSearchEndEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Notification that the server is about to execute a command.",
+ "properties": {
+ "call_id": {
+ "description": "Identifier so this can be paired with the ExecCommandEnd event.",
+ "type": "string"
+ },
+ "command": {
+ "description": "The command to be executed.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "cwd": {
+ "description": "The command's working directory if not the default cwd for the agent.",
+ "type": "string"
+ },
+ "interaction_input": {
+ "description": "Raw input sent to a unified exec session (if this is an interaction event).",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "parsed_cmd": {
+ "items": {
+ "$ref": "#/definitions/ParsedCommand"
+ },
+ "type": "array"
+ },
+ "process_id": {
+ "description": "Identifier for the underlying PTY process (when available).",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "source": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ExecCommandSource"
+ }
+ ],
+ "default": "agent",
+ "description": "Where the command originated. Defaults to Agent for backward compatibility."
+ },
+ "turn_id": {
+ "description": "Turn ID that this command belongs to.",
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "exec_command_begin"
+ ],
+ "title": "ExecCommandBeginEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "command",
+ "cwd",
+ "parsed_cmd",
+ "turn_id",
+ "type"
+ ],
+ "title": "ExecCommandBeginEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Incremental chunk of output from a running command.",
+ "properties": {
+ "call_id": {
+ "description": "Identifier for the ExecCommandBegin that produced this chunk.",
+ "type": "string"
+ },
+ "chunk": {
+ "description": "Raw bytes from the stream (may not be valid UTF-8).",
+ "type": "string"
+ },
+ "stream": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ExecOutputStream"
+ }
+ ],
+ "description": "Which stream produced this chunk."
+ },
+ "type": {
+ "enum": [
+ "exec_command_output_delta"
+ ],
+ "title": "ExecCommandOutputDeltaEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "chunk",
+ "stream",
+ "type"
+ ],
+ "title": "ExecCommandOutputDeltaEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Terminal interaction for an in-progress command (stdin sent and stdout observed).",
+ "properties": {
+ "call_id": {
+ "description": "Identifier for the ExecCommandBegin that produced this chunk.",
+ "type": "string"
+ },
+ "process_id": {
+ "description": "Process id associated with the running command.",
+ "type": "string"
+ },
+ "stdin": {
+ "description": "Stdin sent to the running session.",
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "terminal_interaction"
+ ],
+ "title": "TerminalInteractionEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "process_id",
+ "stdin",
+ "type"
+ ],
+ "title": "TerminalInteractionEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "aggregated_output": {
+ "default": "",
+ "description": "Captured aggregated output",
+ "type": "string"
+ },
+ "call_id": {
+ "description": "Identifier for the ExecCommandBegin that finished.",
+ "type": "string"
+ },
+ "command": {
+ "description": "The command that was executed.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "cwd": {
+ "description": "The command's working directory if not the default cwd for the agent.",
+ "type": "string"
+ },
+ "duration": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/Duration"
+ }
+ ],
+ "description": "The duration of the command execution."
+ },
+ "exit_code": {
+ "description": "The command's exit code.",
+ "format": "int32",
+ "type": "integer"
+ },
+ "formatted_output": {
+ "description": "Formatted output from the command, as seen by the model.",
+ "type": "string"
+ },
+ "interaction_input": {
+ "description": "Raw input sent to a unified exec session (if this is an interaction event).",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "parsed_cmd": {
+ "items": {
+ "$ref": "#/definitions/ParsedCommand"
+ },
+ "type": "array"
+ },
+ "process_id": {
+ "description": "Identifier for the underlying PTY process (when available).",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "source": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ExecCommandSource"
+ }
+ ],
+ "default": "agent",
+ "description": "Where the command originated. Defaults to Agent for backward compatibility."
+ },
+ "stderr": {
+ "description": "Captured stderr",
+ "type": "string"
+ },
+ "stdout": {
+ "description": "Captured stdout",
+ "type": "string"
+ },
+ "turn_id": {
+ "description": "Turn ID that this command belongs to.",
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "exec_command_end"
+ ],
+ "title": "ExecCommandEndEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "command",
+ "cwd",
+ "duration",
+ "exit_code",
+ "formatted_output",
+ "parsed_cmd",
+ "stderr",
+ "stdout",
+ "turn_id",
+ "type"
+ ],
+ "title": "ExecCommandEndEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Notification that the agent attached a local image via the view_image tool.",
+ "properties": {
+ "call_id": {
+ "description": "Identifier for the originating tool call.",
+ "type": "string"
+ },
+ "path": {
+ "description": "Local filesystem path provided to the tool.",
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "view_image_tool_call"
+ ],
+ "title": "ViewImageToolCallEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "path",
+ "type"
+ ],
+ "title": "ViewImageToolCallEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "call_id": {
+ "description": "Identifier for the associated exec call, if available.",
+ "type": "string"
+ },
+ "command": {
+ "description": "The command to be executed.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "cwd": {
+ "description": "The command's working directory.",
+ "type": "string"
+ },
+ "parsed_cmd": {
+ "items": {
+ "$ref": "#/definitions/ParsedCommand"
+ },
+ "type": "array"
+ },
+ "proposed_execpolicy_amendment": {
+ "description": "Proposed execpolicy amendment that can be applied to allow future runs.",
+ "items": {
+ "type": "string"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "reason": {
+ "description": "Optional human-readable reason for the approval (e.g. retry without sandbox).",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "turn_id": {
+ "default": "",
+ "description": "Turn ID that this command belongs to. Uses `#[serde(default)]` for backwards compatibility.",
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "exec_approval_request"
+ ],
+ "title": "ExecApprovalRequestEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "command",
+ "cwd",
+ "parsed_cmd",
+ "type"
+ ],
+ "title": "ExecApprovalRequestEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "call_id": {
+ "description": "Responses API call id for the associated tool call, if available.",
+ "type": "string"
+ },
+ "questions": {
+ "items": {
+ "$ref": "#/definitions/RequestUserInputQuestion"
+ },
+ "type": "array"
+ },
+ "turn_id": {
+ "default": "",
+ "description": "Turn ID that this request belongs to. Uses `#[serde(default)]` for backwards compatibility.",
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "request_user_input"
+ ],
+ "title": "RequestUserInputEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "questions",
+ "type"
+ ],
+ "title": "RequestUserInputEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "arguments": true,
+ "callId": {
+ "type": "string"
+ },
+ "tool": {
+ "type": "string"
+ },
+ "turnId": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "dynamic_tool_call_request"
+ ],
+ "title": "DynamicToolCallRequestEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "arguments",
+ "callId",
+ "tool",
+ "turnId",
+ "type"
+ ],
+ "title": "DynamicToolCallRequestEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "message": {
+ "type": "string"
+ },
+ "server_name": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "elicitation_request"
+ ],
+ "title": "ElicitationRequestEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "message",
+ "server_name",
+ "type"
+ ],
+ "title": "ElicitationRequestEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "call_id": {
+ "description": "Responses API call id for the associated patch apply call, if available.",
+ "type": "string"
+ },
+ "changes": {
+ "additionalProperties": {
+ "$ref": "#/definitions/FileChange"
+ },
+ "type": "object"
+ },
+ "grant_root": {
+ "description": "When set, the agent is asking the user to allow writes under this root for the remainder of the session.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "reason": {
+ "description": "Optional explanatory reason (e.g. request for extra write access).",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "turn_id": {
+ "default": "",
+ "description": "Turn ID that this patch belongs to. Uses `#[serde(default)]` for backwards compatibility with older senders.",
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "apply_patch_approval_request"
+ ],
+ "title": "ApplyPatchApprovalRequestEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "changes",
+ "type"
+ ],
+ "title": "ApplyPatchApprovalRequestEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Notification advising the user that something they are using has been deprecated and should be phased out.",
+ "properties": {
+ "details": {
+ "description": "Optional extra guidance, such as migration steps or rationale.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "summary": {
+ "description": "Concise summary of what is deprecated.",
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "deprecation_notice"
+ ],
+ "title": "DeprecationNoticeEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "summary",
+ "type"
+ ],
+ "title": "DeprecationNoticeEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "message": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "background_event"
+ ],
+ "title": "BackgroundEventEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "message",
+ "type"
+ ],
+ "title": "BackgroundEventEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "message": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "undo_started"
+ ],
+ "title": "UndoStartedEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "UndoStartedEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "message": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "success": {
+ "type": "boolean"
+ },
+ "type": {
+ "enum": [
+ "undo_completed"
+ ],
+ "title": "UndoCompletedEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "success",
+ "type"
+ ],
+ "title": "UndoCompletedEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Notification that a model stream experienced an error or disconnect and the system is handling it (e.g., retrying with backoff).",
+ "properties": {
+ "additional_details": {
+ "default": null,
+ "description": "Optional details about the underlying stream failure (often the same human-readable message that is surfaced as the terminal error if retries are exhausted).",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "codex_error_info": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/CodexErrorInfo"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "default": null
+ },
+ "message": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "stream_error"
+ ],
+ "title": "StreamErrorEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "message",
+ "type"
+ ],
+ "title": "StreamErrorEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Notification that the agent is about to apply a code patch. Mirrors `ExecCommandBegin` so front‑ends can show progress indicators.",
+ "properties": {
+ "auto_approved": {
+ "description": "If true, there was no ApplyPatchApprovalRequest for this patch.",
+ "type": "boolean"
+ },
+ "call_id": {
+ "description": "Identifier so this can be paired with the PatchApplyEnd event.",
+ "type": "string"
+ },
+ "changes": {
+ "additionalProperties": {
+ "$ref": "#/definitions/FileChange"
+ },
+ "description": "The changes to be applied.",
+ "type": "object"
+ },
+ "turn_id": {
+ "default": "",
+ "description": "Turn ID that this patch belongs to. Uses `#[serde(default)]` for backwards compatibility.",
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "patch_apply_begin"
+ ],
+ "title": "PatchApplyBeginEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "auto_approved",
+ "call_id",
+ "changes",
+ "type"
+ ],
+ "title": "PatchApplyBeginEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Notification that a patch application has finished.",
+ "properties": {
+ "call_id": {
+ "description": "Identifier for the PatchApplyBegin that finished.",
+ "type": "string"
+ },
+ "changes": {
+ "additionalProperties": {
+ "$ref": "#/definitions/FileChange"
+ },
+ "default": {},
+ "description": "The changes that were applied (mirrors PatchApplyBeginEvent::changes).",
+ "type": "object"
+ },
+ "stderr": {
+ "description": "Captured stderr (parser errors, IO failures, etc.).",
+ "type": "string"
+ },
+ "stdout": {
+ "description": "Captured stdout (summary printed by apply_patch).",
+ "type": "string"
+ },
+ "success": {
+ "description": "Whether the patch was applied successfully.",
+ "type": "boolean"
+ },
+ "turn_id": {
+ "default": "",
+ "description": "Turn ID that this patch belongs to. Uses `#[serde(default)]` for backwards compatibility.",
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "patch_apply_end"
+ ],
+ "title": "PatchApplyEndEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "stderr",
+ "stdout",
+ "success",
+ "type"
+ ],
+ "title": "PatchApplyEndEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "turn_diff"
+ ],
+ "title": "TurnDiffEventMsgType",
+ "type": "string"
+ },
+ "unified_diff": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "unified_diff"
+ ],
+ "title": "TurnDiffEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Response to GetHistoryEntryRequest.",
+ "properties": {
+ "entry": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/HistoryEntry"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "The entry at the requested offset, if available and parseable."
+ },
+ "log_id": {
+ "format": "uint64",
+ "minimum": 0.0,
+ "type": "integer"
+ },
+ "offset": {
+ "format": "uint",
+ "minimum": 0.0,
+ "type": "integer"
+ },
+ "type": {
+ "enum": [
+ "get_history_entry_response"
+ ],
+ "title": "GetHistoryEntryResponseEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "log_id",
+ "offset",
+ "type"
+ ],
+ "title": "GetHistoryEntryResponseEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "List of MCP tools available to the agent.",
+ "properties": {
+ "auth_statuses": {
+ "additionalProperties": {
+ "$ref": "#/definitions/McpAuthStatus"
+ },
+ "description": "Authentication status for each configured MCP server.",
+ "type": "object"
+ },
+ "resource_templates": {
+ "additionalProperties": {
+ "items": {
+ "$ref": "#/definitions/ResourceTemplate"
+ },
+ "type": "array"
+ },
+ "description": "Known resource templates grouped by server name.",
+ "type": "object"
+ },
+ "resources": {
+ "additionalProperties": {
+ "items": {
+ "$ref": "#/definitions/Resource"
+ },
+ "type": "array"
+ },
+ "description": "Known resources grouped by server name.",
+ "type": "object"
+ },
+ "tools": {
+ "additionalProperties": {
+ "$ref": "#/definitions/Tool"
+ },
+ "description": "Fully qualified tool name -> tool definition.",
+ "type": "object"
+ },
+ "type": {
+ "enum": [
+ "mcp_list_tools_response"
+ ],
+ "title": "McpListToolsResponseEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "auth_statuses",
+ "resource_templates",
+ "resources",
+ "tools",
+ "type"
+ ],
+ "title": "McpListToolsResponseEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "List of custom prompts available to the agent.",
+ "properties": {
+ "custom_prompts": {
+ "items": {
+ "$ref": "#/definitions/CustomPrompt"
+ },
+ "type": "array"
+ },
+ "type": {
+ "enum": [
+ "list_custom_prompts_response"
+ ],
+ "title": "ListCustomPromptsResponseEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "custom_prompts",
+ "type"
+ ],
+ "title": "ListCustomPromptsResponseEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "List of skills available to the agent.",
+ "properties": {
+ "skills": {
+ "items": {
+ "$ref": "#/definitions/SkillsListEntry"
+ },
+ "type": "array"
+ },
+ "type": {
+ "enum": [
+ "list_skills_response"
+ ],
+ "title": "ListSkillsResponseEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "skills",
+ "type"
+ ],
+ "title": "ListSkillsResponseEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Notification that skill data may have been updated and clients may want to reload.",
+ "properties": {
+ "type": {
+ "enum": [
+ "skills_update_available"
+ ],
+ "title": "SkillsUpdateAvailableEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "SkillsUpdateAvailableEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "explanation": {
+ "default": null,
+ "description": "Arguments for the `update_plan` todo/checklist tool (not plan mode).",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "plan": {
+ "items": {
+ "$ref": "#/definitions/PlanItemArg"
+ },
+ "type": "array"
+ },
+ "type": {
+ "enum": [
+ "plan_update"
+ ],
+ "title": "PlanUpdateEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "plan",
+ "type"
+ ],
+ "title": "PlanUpdateEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "reason": {
+ "$ref": "#/definitions/TurnAbortReason"
+ },
+ "type": {
+ "enum": [
+ "turn_aborted"
+ ],
+ "title": "TurnAbortedEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "reason",
+ "type"
+ ],
+ "title": "TurnAbortedEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Notification that the agent is shutting down.",
+ "properties": {
+ "type": {
+ "enum": [
+ "shutdown_complete"
+ ],
+ "title": "ShutdownCompleteEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "ShutdownCompleteEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Entered review mode.",
+ "properties": {
+ "target": {
+ "$ref": "#/definitions/ReviewTarget"
+ },
+ "type": {
+ "enum": [
+ "entered_review_mode"
+ ],
+ "title": "EnteredReviewModeEventMsgType",
+ "type": "string"
+ },
+ "user_facing_hint": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "target",
+ "type"
+ ],
+ "title": "EnteredReviewModeEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Exited review mode with an optional final result to apply.",
+ "properties": {
+ "review_output": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ReviewOutputEvent"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "type": {
+ "enum": [
+ "exited_review_mode"
+ ],
+ "title": "ExitedReviewModeEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "ExitedReviewModeEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "item": {
+ "$ref": "#/definitions/ResponseItem"
+ },
+ "type": {
+ "enum": [
+ "raw_response_item"
+ ],
+ "title": "RawResponseItemEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "item",
+ "type"
+ ],
+ "title": "RawResponseItemEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "item": {
+ "$ref": "#/definitions/TurnItem"
+ },
+ "thread_id": {
+ "$ref": "#/definitions/ThreadId"
+ },
+ "turn_id": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "item_started"
+ ],
+ "title": "ItemStartedEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "item",
+ "thread_id",
+ "turn_id",
+ "type"
+ ],
+ "title": "ItemStartedEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "item": {
+ "$ref": "#/definitions/TurnItem"
+ },
+ "thread_id": {
+ "$ref": "#/definitions/ThreadId"
+ },
+ "turn_id": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "item_completed"
+ ],
+ "title": "ItemCompletedEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "item",
+ "thread_id",
+ "turn_id",
+ "type"
+ ],
+ "title": "ItemCompletedEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "delta": {
+ "type": "string"
+ },
+ "item_id": {
+ "type": "string"
+ },
+ "thread_id": {
+ "type": "string"
+ },
+ "turn_id": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "agent_message_content_delta"
+ ],
+ "title": "AgentMessageContentDeltaEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "delta",
+ "item_id",
+ "thread_id",
+ "turn_id",
+ "type"
+ ],
+ "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": {
+ "type": "string"
+ },
+ "item_id": {
+ "type": "string"
+ },
+ "summary_index": {
+ "default": 0,
+ "format": "int64",
+ "type": "integer"
+ },
+ "thread_id": {
+ "type": "string"
+ },
+ "turn_id": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "reasoning_content_delta"
+ ],
+ "title": "ReasoningContentDeltaEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "delta",
+ "item_id",
+ "thread_id",
+ "turn_id",
+ "type"
+ ],
+ "title": "ReasoningContentDeltaEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "content_index": {
+ "default": 0,
+ "format": "int64",
+ "type": "integer"
+ },
+ "delta": {
+ "type": "string"
+ },
+ "item_id": {
+ "type": "string"
+ },
+ "thread_id": {
+ "type": "string"
+ },
+ "turn_id": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "reasoning_raw_content_delta"
+ ],
+ "title": "ReasoningRawContentDeltaEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "delta",
+ "item_id",
+ "thread_id",
+ "turn_id",
+ "type"
+ ],
+ "title": "ReasoningRawContentDeltaEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Collab interaction: agent spawn begin.",
+ "properties": {
+ "call_id": {
+ "description": "Identifier for the collab tool call.",
+ "type": "string"
+ },
+ "prompt": {
+ "description": "Initial prompt sent to the agent. Can be empty to prevent CoT leaking at the beginning.",
+ "type": "string"
+ },
+ "sender_thread_id": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ThreadId"
+ }
+ ],
+ "description": "Thread ID of the sender."
+ },
+ "type": {
+ "enum": [
+ "collab_agent_spawn_begin"
+ ],
+ "title": "CollabAgentSpawnBeginEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "prompt",
+ "sender_thread_id",
+ "type"
+ ],
+ "title": "CollabAgentSpawnBeginEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Collab interaction: agent spawn end.",
+ "properties": {
+ "call_id": {
+ "description": "Identifier for the collab tool call.",
+ "type": "string"
+ },
+ "new_thread_id": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ThreadId"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Thread ID of the newly spawned agent, if it was created."
+ },
+ "prompt": {
+ "description": "Initial prompt sent to the agent. Can be empty to prevent CoT leaking at the beginning.",
+ "type": "string"
+ },
+ "sender_thread_id": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ThreadId"
+ }
+ ],
+ "description": "Thread ID of the sender."
+ },
+ "status": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/AgentStatus"
+ }
+ ],
+ "description": "Last known status of the new agent reported to the sender agent."
+ },
+ "type": {
+ "enum": [
+ "collab_agent_spawn_end"
+ ],
+ "title": "CollabAgentSpawnEndEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "prompt",
+ "sender_thread_id",
+ "status",
+ "type"
+ ],
+ "title": "CollabAgentSpawnEndEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Collab interaction: agent interaction begin.",
+ "properties": {
+ "call_id": {
+ "description": "Identifier for the collab tool call.",
+ "type": "string"
+ },
+ "prompt": {
+ "description": "Prompt sent from the sender to the receiver. Can be empty to prevent CoT leaking at the beginning.",
+ "type": "string"
+ },
+ "receiver_thread_id": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ThreadId"
+ }
+ ],
+ "description": "Thread ID of the receiver."
+ },
+ "sender_thread_id": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ThreadId"
+ }
+ ],
+ "description": "Thread ID of the sender."
+ },
+ "type": {
+ "enum": [
+ "collab_agent_interaction_begin"
+ ],
+ "title": "CollabAgentInteractionBeginEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "prompt",
+ "receiver_thread_id",
+ "sender_thread_id",
+ "type"
+ ],
+ "title": "CollabAgentInteractionBeginEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Collab interaction: agent interaction end.",
+ "properties": {
+ "call_id": {
+ "description": "Identifier for the collab tool call.",
+ "type": "string"
+ },
+ "prompt": {
+ "description": "Prompt sent from the sender to the receiver. Can be empty to prevent CoT leaking at the beginning.",
+ "type": "string"
+ },
+ "receiver_thread_id": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ThreadId"
+ }
+ ],
+ "description": "Thread ID of the receiver."
+ },
+ "sender_thread_id": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ThreadId"
+ }
+ ],
+ "description": "Thread ID of the sender."
+ },
+ "status": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/AgentStatus"
+ }
+ ],
+ "description": "Last known status of the receiver agent reported to the sender agent."
+ },
+ "type": {
+ "enum": [
+ "collab_agent_interaction_end"
+ ],
+ "title": "CollabAgentInteractionEndEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "prompt",
+ "receiver_thread_id",
+ "sender_thread_id",
+ "status",
+ "type"
+ ],
+ "title": "CollabAgentInteractionEndEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Collab interaction: waiting begin.",
+ "properties": {
+ "call_id": {
+ "description": "ID of the waiting call.",
+ "type": "string"
+ },
+ "receiver_thread_ids": {
+ "description": "Thread ID of the receivers.",
+ "items": {
+ "$ref": "#/definitions/ThreadId"
+ },
+ "type": "array"
+ },
+ "sender_thread_id": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ThreadId"
+ }
+ ],
+ "description": "Thread ID of the sender."
+ },
+ "type": {
+ "enum": [
+ "collab_waiting_begin"
+ ],
+ "title": "CollabWaitingBeginEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "receiver_thread_ids",
+ "sender_thread_id",
+ "type"
+ ],
+ "title": "CollabWaitingBeginEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Collab interaction: waiting end.",
+ "properties": {
+ "call_id": {
+ "description": "ID of the waiting call.",
+ "type": "string"
+ },
+ "sender_thread_id": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ThreadId"
+ }
+ ],
+ "description": "Thread ID of the sender."
+ },
+ "statuses": {
+ "additionalProperties": {
+ "$ref": "#/definitions/AgentStatus"
+ },
+ "description": "Last known status of the receiver agents reported to the sender agent.",
+ "type": "object"
+ },
+ "type": {
+ "enum": [
+ "collab_waiting_end"
+ ],
+ "title": "CollabWaitingEndEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "sender_thread_id",
+ "statuses",
+ "type"
+ ],
+ "title": "CollabWaitingEndEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Collab interaction: close begin.",
+ "properties": {
+ "call_id": {
+ "description": "Identifier for the collab tool call.",
+ "type": "string"
+ },
+ "receiver_thread_id": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ThreadId"
+ }
+ ],
+ "description": "Thread ID of the receiver."
+ },
+ "sender_thread_id": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ThreadId"
+ }
+ ],
+ "description": "Thread ID of the sender."
+ },
+ "type": {
+ "enum": [
+ "collab_close_begin"
+ ],
+ "title": "CollabCloseBeginEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "receiver_thread_id",
+ "sender_thread_id",
+ "type"
+ ],
+ "title": "CollabCloseBeginEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Collab interaction: close end.",
+ "properties": {
+ "call_id": {
+ "description": "Identifier for the collab tool call.",
+ "type": "string"
+ },
+ "receiver_thread_id": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ThreadId"
+ }
+ ],
+ "description": "Thread ID of the receiver."
+ },
+ "sender_thread_id": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ThreadId"
+ }
+ ],
+ "description": "Thread ID of the sender."
+ },
+ "status": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/AgentStatus"
+ }
+ ],
+ "description": "Last known status of the receiver agent reported to the sender agent before the close."
+ },
+ "type": {
+ "enum": [
+ "collab_close_end"
+ ],
+ "title": "CollabCloseEndEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "receiver_thread_id",
+ "sender_thread_id",
+ "status",
+ "type"
+ ],
+ "title": "CollabCloseEndEventMsg",
+ "type": "object"
+ }
+ ],
+ "title": "EventMsg"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/ExecCommandApprovalParams.json b/codex-rs/app-server-protocol/schema/json/ExecCommandApprovalParams.json
new file mode 100644
index 0000000000..977b1626a0
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/ExecCommandApprovalParams.json
@@ -0,0 +1,158 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "definitions": {
+ "ParsedCommand": {
+ "oneOf": [
+ {
+ "properties": {
+ "cmd": {
+ "type": "string"
+ },
+ "name": {
+ "type": "string"
+ },
+ "path": {
+ "description": "(Best effort) Path to the file being read by the command. When possible, this is an absolute path, though when relative, it should be resolved against the `cwd`` that will be used to run the command to derive the absolute path.",
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "read"
+ ],
+ "title": "ReadParsedCommandType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "cmd",
+ "name",
+ "path",
+ "type"
+ ],
+ "title": "ReadParsedCommand",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "cmd": {
+ "type": "string"
+ },
+ "path": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "list_files"
+ ],
+ "title": "ListFilesParsedCommandType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "cmd",
+ "type"
+ ],
+ "title": "ListFilesParsedCommand",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "cmd": {
+ "type": "string"
+ },
+ "path": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "query": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "search"
+ ],
+ "title": "SearchParsedCommandType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "cmd",
+ "type"
+ ],
+ "title": "SearchParsedCommand",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "cmd": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "unknown"
+ ],
+ "title": "UnknownParsedCommandType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "cmd",
+ "type"
+ ],
+ "title": "UnknownParsedCommand",
+ "type": "object"
+ }
+ ]
+ },
+ "ThreadId": {
+ "type": "string"
+ }
+ },
+ "properties": {
+ "callId": {
+ "description": "Use to correlate this with [codex_core::protocol::ExecCommandBeginEvent] and [codex_core::protocol::ExecCommandEndEvent].",
+ "type": "string"
+ },
+ "command": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "conversationId": {
+ "$ref": "#/definitions/ThreadId"
+ },
+ "cwd": {
+ "type": "string"
+ },
+ "parsedCmd": {
+ "items": {
+ "$ref": "#/definitions/ParsedCommand"
+ },
+ "type": "array"
+ },
+ "reason": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "callId",
+ "command",
+ "conversationId",
+ "cwd",
+ "parsedCmd"
+ ],
+ "title": "ExecCommandApprovalParams",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/ExecCommandApprovalResponse.json b/codex-rs/app-server-protocol/schema/json/ExecCommandApprovalResponse.json
new file mode 100644
index 0000000000..1f278291a2
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/ExecCommandApprovalResponse.json
@@ -0,0 +1,73 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "definitions": {
+ "ReviewDecision": {
+ "description": "User's decision in response to an ExecApprovalRequest.",
+ "oneOf": [
+ {
+ "description": "User has approved this command and the agent should execute it.",
+ "enum": [
+ "approved"
+ ],
+ "type": "string"
+ },
+ {
+ "additionalProperties": false,
+ "description": "User has approved this command and wants to apply the proposed execpolicy amendment so future matching commands are permitted.",
+ "properties": {
+ "approved_execpolicy_amendment": {
+ "properties": {
+ "proposed_execpolicy_amendment": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ }
+ },
+ "required": [
+ "proposed_execpolicy_amendment"
+ ],
+ "type": "object"
+ }
+ },
+ "required": [
+ "approved_execpolicy_amendment"
+ ],
+ "title": "ApprovedExecpolicyAmendmentReviewDecision",
+ "type": "object"
+ },
+ {
+ "description": "User has approved this command and wants to automatically approve any future identical instances (`command` and `cwd` match exactly) for the remainder of the session.",
+ "enum": [
+ "approved_for_session"
+ ],
+ "type": "string"
+ },
+ {
+ "description": "User has denied this command and the agent should not execute it, but it should continue the session and try something else.",
+ "enum": [
+ "denied"
+ ],
+ "type": "string"
+ },
+ {
+ "description": "User has denied this command and the agent should not do anything until the user's next command.",
+ "enum": [
+ "abort"
+ ],
+ "type": "string"
+ }
+ ]
+ }
+ },
+ "properties": {
+ "decision": {
+ "$ref": "#/definitions/ReviewDecision"
+ }
+ },
+ "required": [
+ "decision"
+ ],
+ "title": "ExecCommandApprovalResponse",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/FileChangeRequestApprovalParams.json b/codex-rs/app-server-protocol/schema/json/FileChangeRequestApprovalParams.json
new file mode 100644
index 0000000000..f52e98cd0d
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/FileChangeRequestApprovalParams.json
@@ -0,0 +1,35 @@
+{
+ "$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"
+ },
+ "reason": {
+ "description": "Optional explanatory reason (e.g. request for extra write access).",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "threadId": {
+ "type": "string"
+ },
+ "turnId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "itemId",
+ "threadId",
+ "turnId"
+ ],
+ "title": "FileChangeRequestApprovalParams",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/FileChangeRequestApprovalResponse.json b/codex-rs/app-server-protocol/schema/json/FileChangeRequestApprovalResponse.json
new file mode 100644
index 0000000000..f20035e3d7
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/FileChangeRequestApprovalResponse.json
@@ -0,0 +1,47 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "definitions": {
+ "FileChangeApprovalDecision": {
+ "oneOf": [
+ {
+ "description": "User approved the file changes.",
+ "enum": [
+ "accept"
+ ],
+ "type": "string"
+ },
+ {
+ "description": "User approved the file changes and future changes to the same files should run without prompting.",
+ "enum": [
+ "acceptForSession"
+ ],
+ "type": "string"
+ },
+ {
+ "description": "User denied the file changes. The agent will continue the turn.",
+ "enum": [
+ "decline"
+ ],
+ "type": "string"
+ },
+ {
+ "description": "User denied the file changes. The turn will also be immediately interrupted.",
+ "enum": [
+ "cancel"
+ ],
+ "type": "string"
+ }
+ ]
+ }
+ },
+ "properties": {
+ "decision": {
+ "$ref": "#/definitions/FileChangeApprovalDecision"
+ }
+ },
+ "required": [
+ "decision"
+ ],
+ "title": "FileChangeRequestApprovalResponse",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/FuzzyFileSearchParams.json b/codex-rs/app-server-protocol/schema/json/FuzzyFileSearchParams.json
new file mode 100644
index 0000000000..3a72939de4
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/FuzzyFileSearchParams.json
@@ -0,0 +1,26 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "cancellationToken": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "query": {
+ "type": "string"
+ },
+ "roots": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ }
+ },
+ "required": [
+ "query",
+ "roots"
+ ],
+ "title": "FuzzyFileSearchParams",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/FuzzyFileSearchResponse.json b/codex-rs/app-server-protocol/schema/json/FuzzyFileSearchResponse.json
new file mode 100644
index 0000000000..3309b9fb5d
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/FuzzyFileSearchResponse.json
@@ -0,0 +1,55 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "definitions": {
+ "FuzzyFileSearchResult": {
+ "description": "Superset of [`codex_file_search::FileMatch`]",
+ "properties": {
+ "file_name": {
+ "type": "string"
+ },
+ "indices": {
+ "items": {
+ "format": "uint32",
+ "minimum": 0.0,
+ "type": "integer"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "path": {
+ "type": "string"
+ },
+ "root": {
+ "type": "string"
+ },
+ "score": {
+ "format": "uint32",
+ "minimum": 0.0,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "file_name",
+ "path",
+ "root",
+ "score"
+ ],
+ "type": "object"
+ }
+ },
+ "properties": {
+ "files": {
+ "items": {
+ "$ref": "#/definitions/FuzzyFileSearchResult"
+ },
+ "type": "array"
+ }
+ },
+ "required": [
+ "files"
+ ],
+ "title": "FuzzyFileSearchResponse",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/JSONRPCError.json b/codex-rs/app-server-protocol/schema/json/JSONRPCError.json
new file mode 100644
index 0000000000..6db5d1a7fa
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/JSONRPCError.json
@@ -0,0 +1,48 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "definitions": {
+ "JSONRPCErrorError": {
+ "properties": {
+ "code": {
+ "format": "int64",
+ "type": "integer"
+ },
+ "data": true,
+ "message": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "code",
+ "message"
+ ],
+ "type": "object"
+ },
+ "RequestId": {
+ "anyOf": [
+ {
+ "type": "string"
+ },
+ {
+ "format": "int64",
+ "type": "integer"
+ }
+ ]
+ }
+ },
+ "description": "A response to a request that indicates an error occurred.",
+ "properties": {
+ "error": {
+ "$ref": "#/definitions/JSONRPCErrorError"
+ },
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ }
+ },
+ "required": [
+ "error",
+ "id"
+ ],
+ "title": "JSONRPCError",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/JSONRPCErrorError.json b/codex-rs/app-server-protocol/schema/json/JSONRPCErrorError.json
new file mode 100644
index 0000000000..932ef33c9a
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/JSONRPCErrorError.json
@@ -0,0 +1,19 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "code": {
+ "format": "int64",
+ "type": "integer"
+ },
+ "data": true,
+ "message": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "code",
+ "message"
+ ],
+ "title": "JSONRPCErrorError",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/JSONRPCMessage.json b/codex-rs/app-server-protocol/schema/json/JSONRPCMessage.json
new file mode 100644
index 0000000000..b2f6c31011
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/JSONRPCMessage.json
@@ -0,0 +1,109 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/JSONRPCRequest"
+ },
+ {
+ "$ref": "#/definitions/JSONRPCNotification"
+ },
+ {
+ "$ref": "#/definitions/JSONRPCResponse"
+ },
+ {
+ "$ref": "#/definitions/JSONRPCError"
+ }
+ ],
+ "definitions": {
+ "JSONRPCError": {
+ "description": "A response to a request that indicates an error occurred.",
+ "properties": {
+ "error": {
+ "$ref": "#/definitions/JSONRPCErrorError"
+ },
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ }
+ },
+ "required": [
+ "error",
+ "id"
+ ],
+ "type": "object"
+ },
+ "JSONRPCErrorError": {
+ "properties": {
+ "code": {
+ "format": "int64",
+ "type": "integer"
+ },
+ "data": true,
+ "message": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "code",
+ "message"
+ ],
+ "type": "object"
+ },
+ "JSONRPCNotification": {
+ "description": "A notification which does not expect a response.",
+ "properties": {
+ "method": {
+ "type": "string"
+ },
+ "params": true
+ },
+ "required": [
+ "method"
+ ],
+ "type": "object"
+ },
+ "JSONRPCRequest": {
+ "description": "A request that expects a response.",
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "type": "string"
+ },
+ "params": true
+ },
+ "required": [
+ "id",
+ "method"
+ ],
+ "type": "object"
+ },
+ "JSONRPCResponse": {
+ "description": "A successful (non-error) response to a request.",
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "result": true
+ },
+ "required": [
+ "id",
+ "result"
+ ],
+ "type": "object"
+ },
+ "RequestId": {
+ "anyOf": [
+ {
+ "type": "string"
+ },
+ {
+ "format": "int64",
+ "type": "integer"
+ }
+ ]
+ }
+ },
+ "description": "Refers to any valid JSON-RPC object that can be decoded off the wire, or encoded to be sent.",
+ "title": "JSONRPCMessage"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/JSONRPCNotification.json b/codex-rs/app-server-protocol/schema/json/JSONRPCNotification.json
new file mode 100644
index 0000000000..2ddd61a8ca
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/JSONRPCNotification.json
@@ -0,0 +1,15 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "description": "A notification which does not expect a response.",
+ "properties": {
+ "method": {
+ "type": "string"
+ },
+ "params": true
+ },
+ "required": [
+ "method"
+ ],
+ "title": "JSONRPCNotification",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/JSONRPCRequest.json b/codex-rs/app-server-protocol/schema/json/JSONRPCRequest.json
new file mode 100644
index 0000000000..cc7a16f1ba
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/JSONRPCRequest.json
@@ -0,0 +1,32 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "definitions": {
+ "RequestId": {
+ "anyOf": [
+ {
+ "type": "string"
+ },
+ {
+ "format": "int64",
+ "type": "integer"
+ }
+ ]
+ }
+ },
+ "description": "A request that expects a response.",
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "type": "string"
+ },
+ "params": true
+ },
+ "required": [
+ "id",
+ "method"
+ ],
+ "title": "JSONRPCRequest",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/JSONRPCResponse.json b/codex-rs/app-server-protocol/schema/json/JSONRPCResponse.json
new file mode 100644
index 0000000000..9f1ec29548
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/JSONRPCResponse.json
@@ -0,0 +1,29 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "definitions": {
+ "RequestId": {
+ "anyOf": [
+ {
+ "type": "string"
+ },
+ {
+ "format": "int64",
+ "type": "integer"
+ }
+ ]
+ }
+ },
+ "description": "A successful (non-error) response to a request.",
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "result": true
+ },
+ "required": [
+ "id",
+ "result"
+ ],
+ "title": "JSONRPCResponse",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/RequestId.json b/codex-rs/app-server-protocol/schema/json/RequestId.json
new file mode 100644
index 0000000000..d0fa43db82
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/RequestId.json
@@ -0,0 +1,13 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "anyOf": [
+ {
+ "type": "string"
+ },
+ {
+ "format": "int64",
+ "type": "integer"
+ }
+ ],
+ "title": "RequestId"
+}
\ 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
new file mode 100644
index 0000000000..b6777d5c8b
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/ServerNotification.json
@@ -0,0 +1,8285 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "definitions": {
+ "AbsolutePathBuf": {
+ "description": "A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem).\n\nIMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set, the deserialization will fail unless the path being deserialized is already absolute.",
+ "type": "string"
+ },
+ "AccountLoginCompletedNotification": {
+ "properties": {
+ "error": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "loginId": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "success": {
+ "type": "boolean"
+ }
+ },
+ "required": [
+ "success"
+ ],
+ "type": "object"
+ },
+ "AccountRateLimitsUpdatedNotification": {
+ "properties": {
+ "rateLimits": {
+ "$ref": "#/definitions/RateLimitSnapshot"
+ }
+ },
+ "required": [
+ "rateLimits"
+ ],
+ "type": "object"
+ },
+ "AccountUpdatedNotification": {
+ "properties": {
+ "authMode": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/AuthMode"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "AgentMessageContent": {
+ "oneOf": [
+ {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "Text"
+ ],
+ "title": "TextAgentMessageContentType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "TextAgentMessageContent",
+ "type": "object"
+ }
+ ]
+ },
+ "AgentMessageDeltaNotification": {
+ "properties": {
+ "delta": {
+ "type": "string"
+ },
+ "itemId": {
+ "type": "string"
+ },
+ "threadId": {
+ "type": "string"
+ },
+ "turnId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "delta",
+ "itemId",
+ "threadId",
+ "turnId"
+ ],
+ "type": "object"
+ },
+ "AgentStatus": {
+ "description": "Agent lifecycle status, derived from emitted events.",
+ "oneOf": [
+ {
+ "description": "Agent is waiting for initialization.",
+ "enum": [
+ "pending_init"
+ ],
+ "type": "string"
+ },
+ {
+ "description": "Agent is currently running.",
+ "enum": [
+ "running"
+ ],
+ "type": "string"
+ },
+ {
+ "additionalProperties": false,
+ "description": "Agent is done. Contains the final assistant message.",
+ "properties": {
+ "completed": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "completed"
+ ],
+ "title": "CompletedAgentStatus",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "Agent encountered an error.",
+ "properties": {
+ "errored": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "errored"
+ ],
+ "title": "ErroredAgentStatus",
+ "type": "object"
+ },
+ {
+ "description": "Agent has been shutdown.",
+ "enum": [
+ "shutdown"
+ ],
+ "type": "string"
+ },
+ {
+ "description": "Agent is not found.",
+ "enum": [
+ "not_found"
+ ],
+ "type": "string"
+ }
+ ]
+ },
+ "Annotations": {
+ "description": "Optional annotations for the client. The client can use annotations to inform how objects are used or displayed",
+ "properties": {
+ "audience": {
+ "items": {
+ "$ref": "#/definitions/Role"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "lastModified": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "priority": {
+ "format": "double",
+ "type": [
+ "number",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "AskForApproval": {
+ "description": "Determines the conditions under which the user is consulted to approve running the command proposed by Codex.",
+ "oneOf": [
+ {
+ "description": "Under this policy, only \"known safe\" commands—as determined by `is_safe_command()`—that **only read files** are auto‑approved. Everything else will ask the user to approve.",
+ "enum": [
+ "untrusted"
+ ],
+ "type": "string"
+ },
+ {
+ "description": "*All* commands are auto‑approved, but they are expected to run inside a sandbox where network access is disabled and writes are confined to a specific set of paths. If the command fails, it will be escalated to the user to approve execution without a sandbox.",
+ "enum": [
+ "on-failure"
+ ],
+ "type": "string"
+ },
+ {
+ "description": "The model decides when to ask the user for approval.",
+ "enum": [
+ "on-request"
+ ],
+ "type": "string"
+ },
+ {
+ "description": "Never ask the user to approve commands. Failures are immediately returned to the model, and never escalated to the user for approval.",
+ "enum": [
+ "never"
+ ],
+ "type": "string"
+ }
+ ]
+ },
+ "AudioContent": {
+ "description": "Audio provided to or from an LLM.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "data": {
+ "type": "string"
+ },
+ "mimeType": {
+ "type": "string"
+ },
+ "type": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "data",
+ "mimeType",
+ "type"
+ ],
+ "type": "object"
+ },
+ "AuthMode": {
+ "description": "Authentication mode for OpenAI-backed providers.",
+ "oneOf": [
+ {
+ "description": "OpenAI API key provided by the caller and stored by Codex.",
+ "enum": [
+ "apikey"
+ ],
+ "type": "string"
+ },
+ {
+ "description": "ChatGPT OAuth managed by Codex (tokens persisted and refreshed by Codex).",
+ "enum": [
+ "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"
+ }
+ ]
+ },
+ "AuthStatusChangeNotification": {
+ "description": "Deprecated notification. Use AccountUpdatedNotification instead.",
+ "properties": {
+ "authMethod": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/AuthMode"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "BlobResourceContents": {
+ "properties": {
+ "blob": {
+ "type": "string"
+ },
+ "mimeType": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "uri": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "blob",
+ "uri"
+ ],
+ "type": "object"
+ },
+ "ByteRange": {
+ "properties": {
+ "end": {
+ "format": "uint",
+ "minimum": 0.0,
+ "type": "integer"
+ },
+ "start": {
+ "format": "uint",
+ "minimum": 0.0,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "end",
+ "start"
+ ],
+ "type": "object"
+ },
+ "ByteRange2": {
+ "properties": {
+ "end": {
+ "description": "End byte offset (exclusive) within the UTF-8 text buffer.",
+ "format": "uint",
+ "minimum": 0.0,
+ "type": "integer"
+ },
+ "start": {
+ "description": "Start byte offset (inclusive) within the UTF-8 text buffer.",
+ "format": "uint",
+ "minimum": 0.0,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "end",
+ "start"
+ ],
+ "type": "object"
+ },
+ "CallToolResult": {
+ "description": "The server's response to a tool call.",
+ "properties": {
+ "content": {
+ "items": {
+ "$ref": "#/definitions/ContentBlock"
+ },
+ "type": "array"
+ },
+ "isError": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "structuredContent": true
+ },
+ "required": [
+ "content"
+ ],
+ "type": "object"
+ },
+ "CodexErrorInfo": {
+ "description": "This translation layer make sure that we expose codex error code in camel case.\n\nWhen an upstream HTTP status is available (for example, from the Responses API or a provider), it is forwarded in `httpStatusCode` on the relevant `codexErrorInfo` variant.",
+ "oneOf": [
+ {
+ "enum": [
+ "contextWindowExceeded",
+ "usageLimitExceeded",
+ "internalServerError",
+ "unauthorized",
+ "badRequest",
+ "threadRollbackFailed",
+ "sandboxError",
+ "other"
+ ],
+ "type": "string"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "modelCap": {
+ "properties": {
+ "model": {
+ "type": "string"
+ },
+ "reset_after_seconds": {
+ "format": "uint64",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "model"
+ ],
+ "type": "object"
+ }
+ },
+ "required": [
+ "modelCap"
+ ],
+ "title": "ModelCapCodexErrorInfo",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "httpConnectionFailed": {
+ "properties": {
+ "httpStatusCode": {
+ "format": "uint16",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "httpConnectionFailed"
+ ],
+ "title": "HttpConnectionFailedCodexErrorInfo",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "Failed to connect to the response SSE stream.",
+ "properties": {
+ "responseStreamConnectionFailed": {
+ "properties": {
+ "httpStatusCode": {
+ "format": "uint16",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "responseStreamConnectionFailed"
+ ],
+ "title": "ResponseStreamConnectionFailedCodexErrorInfo",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "The response SSE stream disconnected in the middle of a turn before completion.",
+ "properties": {
+ "responseStreamDisconnected": {
+ "properties": {
+ "httpStatusCode": {
+ "format": "uint16",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "responseStreamDisconnected"
+ ],
+ "title": "ResponseStreamDisconnectedCodexErrorInfo",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "Reached the retry limit for responses.",
+ "properties": {
+ "responseTooManyFailedAttempts": {
+ "properties": {
+ "httpStatusCode": {
+ "format": "uint16",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "responseTooManyFailedAttempts"
+ ],
+ "title": "ResponseTooManyFailedAttemptsCodexErrorInfo",
+ "type": "object"
+ }
+ ]
+ },
+ "CodexErrorInfo2": {
+ "description": "Codex errors that we expose to clients.",
+ "oneOf": [
+ {
+ "enum": [
+ "context_window_exceeded",
+ "usage_limit_exceeded",
+ "internal_server_error",
+ "unauthorized",
+ "bad_request",
+ "sandbox_error",
+ "thread_rollback_failed",
+ "other"
+ ],
+ "type": "string"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "model_cap": {
+ "properties": {
+ "model": {
+ "type": "string"
+ },
+ "reset_after_seconds": {
+ "format": "uint64",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "model"
+ ],
+ "type": "object"
+ }
+ },
+ "required": [
+ "model_cap"
+ ],
+ "title": "ModelCapCodexErrorInfo2",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "http_connection_failed": {
+ "properties": {
+ "http_status_code": {
+ "format": "uint16",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "http_connection_failed"
+ ],
+ "title": "HttpConnectionFailedCodexErrorInfo2",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "Failed to connect to the response SSE stream.",
+ "properties": {
+ "response_stream_connection_failed": {
+ "properties": {
+ "http_status_code": {
+ "format": "uint16",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "response_stream_connection_failed"
+ ],
+ "title": "ResponseStreamConnectionFailedCodexErrorInfo2",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "The response SSE stream disconnected in the middle of a turnbefore completion.",
+ "properties": {
+ "response_stream_disconnected": {
+ "properties": {
+ "http_status_code": {
+ "format": "uint16",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "response_stream_disconnected"
+ ],
+ "title": "ResponseStreamDisconnectedCodexErrorInfo2",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "Reached the retry limit for responses.",
+ "properties": {
+ "response_too_many_failed_attempts": {
+ "properties": {
+ "http_status_code": {
+ "format": "uint16",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "response_too_many_failed_attempts"
+ ],
+ "title": "ResponseTooManyFailedAttemptsCodexErrorInfo2",
+ "type": "object"
+ }
+ ]
+ },
+ "CollabAgentState": {
+ "properties": {
+ "message": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "status": {
+ "$ref": "#/definitions/CollabAgentStatus"
+ }
+ },
+ "required": [
+ "status"
+ ],
+ "type": "object"
+ },
+ "CollabAgentStatus": {
+ "enum": [
+ "pendingInit",
+ "running",
+ "completed",
+ "errored",
+ "shutdown",
+ "notFound"
+ ],
+ "type": "string"
+ },
+ "CollabAgentTool": {
+ "enum": [
+ "spawnAgent",
+ "sendInput",
+ "wait",
+ "closeAgent"
+ ],
+ "type": "string"
+ },
+ "CollabAgentToolCallStatus": {
+ "enum": [
+ "inProgress",
+ "completed",
+ "failed"
+ ],
+ "type": "string"
+ },
+ "CommandAction": {
+ "oneOf": [
+ {
+ "properties": {
+ "command": {
+ "type": "string"
+ },
+ "name": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "read"
+ ],
+ "title": "ReadCommandActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "command",
+ "name",
+ "path",
+ "type"
+ ],
+ "title": "ReadCommandAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "command": {
+ "type": "string"
+ },
+ "path": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "listFiles"
+ ],
+ "title": "ListFilesCommandActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "command",
+ "type"
+ ],
+ "title": "ListFilesCommandAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "command": {
+ "type": "string"
+ },
+ "path": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "query": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "search"
+ ],
+ "title": "SearchCommandActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "command",
+ "type"
+ ],
+ "title": "SearchCommandAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "command": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "unknown"
+ ],
+ "title": "UnknownCommandActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "command",
+ "type"
+ ],
+ "title": "UnknownCommandAction",
+ "type": "object"
+ }
+ ]
+ },
+ "CommandExecutionOutputDeltaNotification": {
+ "properties": {
+ "delta": {
+ "type": "string"
+ },
+ "itemId": {
+ "type": "string"
+ },
+ "threadId": {
+ "type": "string"
+ },
+ "turnId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "delta",
+ "itemId",
+ "threadId",
+ "turnId"
+ ],
+ "type": "object"
+ },
+ "CommandExecutionStatus": {
+ "enum": [
+ "inProgress",
+ "completed",
+ "failed",
+ "declined"
+ ],
+ "type": "string"
+ },
+ "ConfigWarningNotification": {
+ "properties": {
+ "details": {
+ "description": "Optional extra guidance or error details.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "path": {
+ "description": "Optional path to the config file that triggered the warning.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "range": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/TextRange"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Optional range for the error location inside the config file."
+ },
+ "summary": {
+ "description": "Concise summary of the warning.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "summary"
+ ],
+ "type": "object"
+ },
+ "ContentBlock": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/TextContent"
+ },
+ {
+ "$ref": "#/definitions/ImageContent"
+ },
+ {
+ "$ref": "#/definitions/AudioContent"
+ },
+ {
+ "$ref": "#/definitions/ResourceLink"
+ },
+ {
+ "$ref": "#/definitions/EmbeddedResource"
+ }
+ ]
+ },
+ "ContentItem": {
+ "oneOf": [
+ {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "input_text"
+ ],
+ "title": "InputTextContentItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "InputTextContentItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "image_url": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "input_image"
+ ],
+ "title": "InputImageContentItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "image_url",
+ "type"
+ ],
+ "title": "InputImageContentItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "output_text"
+ ],
+ "title": "OutputTextContentItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "OutputTextContentItem",
+ "type": "object"
+ }
+ ]
+ },
+ "ContextCompactedNotification": {
+ "description": "Deprecated: Use `ContextCompaction` item type instead.",
+ "properties": {
+ "threadId": {
+ "type": "string"
+ },
+ "turnId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "threadId",
+ "turnId"
+ ],
+ "type": "object"
+ },
+ "CreditsSnapshot": {
+ "properties": {
+ "balance": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "hasCredits": {
+ "type": "boolean"
+ },
+ "unlimited": {
+ "type": "boolean"
+ }
+ },
+ "required": [
+ "hasCredits",
+ "unlimited"
+ ],
+ "type": "object"
+ },
+ "CreditsSnapshot2": {
+ "properties": {
+ "balance": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "has_credits": {
+ "type": "boolean"
+ },
+ "unlimited": {
+ "type": "boolean"
+ }
+ },
+ "required": [
+ "has_credits",
+ "unlimited"
+ ],
+ "type": "object"
+ },
+ "CustomPrompt": {
+ "properties": {
+ "argument_hint": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "content": {
+ "type": "string"
+ },
+ "description": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "name": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "content",
+ "name",
+ "path"
+ ],
+ "type": "object"
+ },
+ "DeprecationNoticeNotification": {
+ "properties": {
+ "details": {
+ "description": "Optional extra guidance, such as migration steps or rationale.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "summary": {
+ "description": "Concise summary of what is deprecated.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "summary"
+ ],
+ "type": "object"
+ },
+ "Duration": {
+ "properties": {
+ "nanos": {
+ "format": "uint32",
+ "minimum": 0.0,
+ "type": "integer"
+ },
+ "secs": {
+ "format": "uint64",
+ "minimum": 0.0,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "nanos",
+ "secs"
+ ],
+ "type": "object"
+ },
+ "EmbeddedResource": {
+ "description": "The contents of a resource, embedded into a prompt or tool call result.\n\nIt is up to the client how best to render embedded resources for the benefit of the LLM and/or the user.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "resource": {
+ "$ref": "#/definitions/EmbeddedResourceResource"
+ },
+ "type": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "resource",
+ "type"
+ ],
+ "type": "object"
+ },
+ "EmbeddedResourceResource": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/TextResourceContents"
+ },
+ {
+ "$ref": "#/definitions/BlobResourceContents"
+ }
+ ]
+ },
+ "ErrorNotification": {
+ "properties": {
+ "error": {
+ "$ref": "#/definitions/TurnError"
+ },
+ "threadId": {
+ "type": "string"
+ },
+ "turnId": {
+ "type": "string"
+ },
+ "willRetry": {
+ "type": "boolean"
+ }
+ },
+ "required": [
+ "error",
+ "threadId",
+ "turnId",
+ "willRetry"
+ ],
+ "type": "object"
+ },
+ "EventMsg": {
+ "description": "Response event from the agent NOTE: Make sure none of these values have optional types, as it will mess up the extension code-gen.",
+ "oneOf": [
+ {
+ "description": "Error while executing a submission",
+ "properties": {
+ "codex_error_info": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/CodexErrorInfo2"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "default": null
+ },
+ "message": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "error"
+ ],
+ "title": "ErrorEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "message",
+ "type"
+ ],
+ "title": "ErrorEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Warning issued while processing a submission. Unlike `Error`, this indicates the turn continued but the user should still be notified.",
+ "properties": {
+ "message": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "warning"
+ ],
+ "title": "WarningEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "message",
+ "type"
+ ],
+ "title": "WarningEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Conversation history was compacted (either automatically or manually).",
+ "properties": {
+ "type": {
+ "enum": [
+ "context_compacted"
+ ],
+ "title": "ContextCompactedEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "ContextCompactedEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Conversation history was rolled back by dropping the last N user turns.",
+ "properties": {
+ "num_turns": {
+ "description": "Number of user turns that were removed from context.",
+ "format": "uint32",
+ "minimum": 0.0,
+ "type": "integer"
+ },
+ "type": {
+ "enum": [
+ "thread_rolled_back"
+ ],
+ "title": "ThreadRolledBackEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "num_turns",
+ "type"
+ ],
+ "title": "ThreadRolledBackEventMsg",
+ "type": "object"
+ },
+ {
+ "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": "code"
+ },
+ "model_context_window": {
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "task_started"
+ ],
+ "title": "TaskStartedEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "TaskStartedEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Agent has completed all actions. v1 wire format uses `task_complete`; accept `turn_complete` for v2 interop.",
+ "properties": {
+ "last_agent_message": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "task_complete"
+ ],
+ "title": "TaskCompleteEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "TaskCompleteEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Usage update for the current session, including totals and last turn. Optional means unknown — UIs should not display when `None`.",
+ "properties": {
+ "info": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/TokenUsageInfo"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "rate_limits": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/RateLimitSnapshot2"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "type": {
+ "enum": [
+ "token_count"
+ ],
+ "title": "TokenCountEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "TokenCountEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Agent text output message",
+ "properties": {
+ "message": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "agent_message"
+ ],
+ "title": "AgentMessageEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "message",
+ "type"
+ ],
+ "title": "AgentMessageEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "User/system input message (what was sent to the model)",
+ "properties": {
+ "images": {
+ "description": "Image URLs sourced from `UserInput::Image`. These are safe to replay in legacy UI history events and correspond to images sent to the model.",
+ "items": {
+ "type": "string"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "local_images": {
+ "default": [],
+ "description": "Local file paths sourced from `UserInput::LocalImage`. These are kept so the UI can reattach images when editing history, and should not be sent to the model or treated as API-ready URLs.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "message": {
+ "type": "string"
+ },
+ "text_elements": {
+ "default": [],
+ "description": "UI-defined spans within `message` used to render or persist special elements.",
+ "items": {
+ "$ref": "#/definitions/TextElement2"
+ },
+ "type": "array"
+ },
+ "type": {
+ "enum": [
+ "user_message"
+ ],
+ "title": "UserMessageEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "message",
+ "type"
+ ],
+ "title": "UserMessageEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Agent text output delta message",
+ "properties": {
+ "delta": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "agent_message_delta"
+ ],
+ "title": "AgentMessageDeltaEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "delta",
+ "type"
+ ],
+ "title": "AgentMessageDeltaEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Reasoning event from agent.",
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "agent_reasoning"
+ ],
+ "title": "AgentReasoningEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "AgentReasoningEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Agent reasoning delta event from agent.",
+ "properties": {
+ "delta": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "agent_reasoning_delta"
+ ],
+ "title": "AgentReasoningDeltaEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "delta",
+ "type"
+ ],
+ "title": "AgentReasoningDeltaEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Raw chain-of-thought from agent.",
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "agent_reasoning_raw_content"
+ ],
+ "title": "AgentReasoningRawContentEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "AgentReasoningRawContentEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Agent reasoning content delta event from agent.",
+ "properties": {
+ "delta": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "agent_reasoning_raw_content_delta"
+ ],
+ "title": "AgentReasoningRawContentDeltaEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "delta",
+ "type"
+ ],
+ "title": "AgentReasoningRawContentDeltaEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Signaled when the model begins a new reasoning summary section (e.g., a new titled block).",
+ "properties": {
+ "item_id": {
+ "default": "",
+ "type": "string"
+ },
+ "summary_index": {
+ "default": 0,
+ "format": "int64",
+ "type": "integer"
+ },
+ "type": {
+ "enum": [
+ "agent_reasoning_section_break"
+ ],
+ "title": "AgentReasoningSectionBreakEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "AgentReasoningSectionBreakEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Ack the client's configure message.",
+ "properties": {
+ "approval_policy": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/AskForApproval"
+ }
+ ],
+ "description": "When to escalate for approval for execution"
+ },
+ "cwd": {
+ "description": "Working directory that should be treated as the *root* of the session.",
+ "type": "string"
+ },
+ "forked_from_id": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ThreadId"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "history_entry_count": {
+ "description": "Current number of entries in the history log.",
+ "format": "uint",
+ "minimum": 0.0,
+ "type": "integer"
+ },
+ "history_log_id": {
+ "description": "Identifier of the history log file (inode on Unix, 0 otherwise).",
+ "format": "uint64",
+ "minimum": 0.0,
+ "type": "integer"
+ },
+ "initial_messages": {
+ "description": "Optional initial messages (as events) for resumed sessions. When present, UIs can use these to seed the history.",
+ "items": {
+ "$ref": "#/definitions/EventMsg"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "model": {
+ "description": "Tell the client what model is being queried.",
+ "type": "string"
+ },
+ "model_provider_id": {
+ "type": "string"
+ },
+ "reasoning_effort": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ReasoningEffort"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "The effort the model is putting into reasoning about the user's request."
+ },
+ "rollout_path": {
+ "description": "Path in which the rollout is stored. Can be `None` for ephemeral threads",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "sandbox_policy": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/SandboxPolicy"
+ }
+ ],
+ "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"
+ ]
+ },
+ "type": {
+ "enum": [
+ "session_configured"
+ ],
+ "title": "SessionConfiguredEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "approval_policy",
+ "cwd",
+ "history_entry_count",
+ "history_log_id",
+ "model",
+ "model_provider_id",
+ "sandbox_policy",
+ "session_id",
+ "type"
+ ],
+ "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": {
+ "server": {
+ "description": "Server name being started.",
+ "type": "string"
+ },
+ "status": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/McpStartupStatus"
+ }
+ ],
+ "description": "Current startup status."
+ },
+ "type": {
+ "enum": [
+ "mcp_startup_update"
+ ],
+ "title": "McpStartupUpdateEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "server",
+ "status",
+ "type"
+ ],
+ "title": "McpStartupUpdateEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Aggregate MCP startup completion summary.",
+ "properties": {
+ "cancelled": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "failed": {
+ "items": {
+ "$ref": "#/definitions/McpStartupFailure"
+ },
+ "type": "array"
+ },
+ "ready": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "type": {
+ "enum": [
+ "mcp_startup_complete"
+ ],
+ "title": "McpStartupCompleteEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "cancelled",
+ "failed",
+ "ready",
+ "type"
+ ],
+ "title": "McpStartupCompleteEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "call_id": {
+ "description": "Identifier so this can be paired with the McpToolCallEnd event.",
+ "type": "string"
+ },
+ "invocation": {
+ "$ref": "#/definitions/McpInvocation"
+ },
+ "type": {
+ "enum": [
+ "mcp_tool_call_begin"
+ ],
+ "title": "McpToolCallBeginEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "invocation",
+ "type"
+ ],
+ "title": "McpToolCallBeginEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "call_id": {
+ "description": "Identifier for the corresponding McpToolCallBegin that finished.",
+ "type": "string"
+ },
+ "duration": {
+ "$ref": "#/definitions/Duration"
+ },
+ "invocation": {
+ "$ref": "#/definitions/McpInvocation"
+ },
+ "result": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/Result_of_CallToolResult_or_String"
+ }
+ ],
+ "description": "Result of the tool call. Note this could be an error."
+ },
+ "type": {
+ "enum": [
+ "mcp_tool_call_end"
+ ],
+ "title": "McpToolCallEndEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "duration",
+ "invocation",
+ "result",
+ "type"
+ ],
+ "title": "McpToolCallEndEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "call_id": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "web_search_begin"
+ ],
+ "title": "WebSearchBeginEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "type"
+ ],
+ "title": "WebSearchBeginEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "action": {
+ "$ref": "#/definitions/WebSearchAction2"
+ },
+ "call_id": {
+ "type": "string"
+ },
+ "query": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "web_search_end"
+ ],
+ "title": "WebSearchEndEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "action",
+ "call_id",
+ "query",
+ "type"
+ ],
+ "title": "WebSearchEndEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Notification that the server is about to execute a command.",
+ "properties": {
+ "call_id": {
+ "description": "Identifier so this can be paired with the ExecCommandEnd event.",
+ "type": "string"
+ },
+ "command": {
+ "description": "The command to be executed.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "cwd": {
+ "description": "The command's working directory if not the default cwd for the agent.",
+ "type": "string"
+ },
+ "interaction_input": {
+ "description": "Raw input sent to a unified exec session (if this is an interaction event).",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "parsed_cmd": {
+ "items": {
+ "$ref": "#/definitions/ParsedCommand"
+ },
+ "type": "array"
+ },
+ "process_id": {
+ "description": "Identifier for the underlying PTY process (when available).",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "source": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ExecCommandSource"
+ }
+ ],
+ "default": "agent",
+ "description": "Where the command originated. Defaults to Agent for backward compatibility."
+ },
+ "turn_id": {
+ "description": "Turn ID that this command belongs to.",
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "exec_command_begin"
+ ],
+ "title": "ExecCommandBeginEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "command",
+ "cwd",
+ "parsed_cmd",
+ "turn_id",
+ "type"
+ ],
+ "title": "ExecCommandBeginEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Incremental chunk of output from a running command.",
+ "properties": {
+ "call_id": {
+ "description": "Identifier for the ExecCommandBegin that produced this chunk.",
+ "type": "string"
+ },
+ "chunk": {
+ "description": "Raw bytes from the stream (may not be valid UTF-8).",
+ "type": "string"
+ },
+ "stream": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ExecOutputStream"
+ }
+ ],
+ "description": "Which stream produced this chunk."
+ },
+ "type": {
+ "enum": [
+ "exec_command_output_delta"
+ ],
+ "title": "ExecCommandOutputDeltaEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "chunk",
+ "stream",
+ "type"
+ ],
+ "title": "ExecCommandOutputDeltaEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Terminal interaction for an in-progress command (stdin sent and stdout observed).",
+ "properties": {
+ "call_id": {
+ "description": "Identifier for the ExecCommandBegin that produced this chunk.",
+ "type": "string"
+ },
+ "process_id": {
+ "description": "Process id associated with the running command.",
+ "type": "string"
+ },
+ "stdin": {
+ "description": "Stdin sent to the running session.",
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "terminal_interaction"
+ ],
+ "title": "TerminalInteractionEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "process_id",
+ "stdin",
+ "type"
+ ],
+ "title": "TerminalInteractionEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "aggregated_output": {
+ "default": "",
+ "description": "Captured aggregated output",
+ "type": "string"
+ },
+ "call_id": {
+ "description": "Identifier for the ExecCommandBegin that finished.",
+ "type": "string"
+ },
+ "command": {
+ "description": "The command that was executed.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "cwd": {
+ "description": "The command's working directory if not the default cwd for the agent.",
+ "type": "string"
+ },
+ "duration": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/Duration"
+ }
+ ],
+ "description": "The duration of the command execution."
+ },
+ "exit_code": {
+ "description": "The command's exit code.",
+ "format": "int32",
+ "type": "integer"
+ },
+ "formatted_output": {
+ "description": "Formatted output from the command, as seen by the model.",
+ "type": "string"
+ },
+ "interaction_input": {
+ "description": "Raw input sent to a unified exec session (if this is an interaction event).",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "parsed_cmd": {
+ "items": {
+ "$ref": "#/definitions/ParsedCommand"
+ },
+ "type": "array"
+ },
+ "process_id": {
+ "description": "Identifier for the underlying PTY process (when available).",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "source": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ExecCommandSource"
+ }
+ ],
+ "default": "agent",
+ "description": "Where the command originated. Defaults to Agent for backward compatibility."
+ },
+ "stderr": {
+ "description": "Captured stderr",
+ "type": "string"
+ },
+ "stdout": {
+ "description": "Captured stdout",
+ "type": "string"
+ },
+ "turn_id": {
+ "description": "Turn ID that this command belongs to.",
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "exec_command_end"
+ ],
+ "title": "ExecCommandEndEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "command",
+ "cwd",
+ "duration",
+ "exit_code",
+ "formatted_output",
+ "parsed_cmd",
+ "stderr",
+ "stdout",
+ "turn_id",
+ "type"
+ ],
+ "title": "ExecCommandEndEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Notification that the agent attached a local image via the view_image tool.",
+ "properties": {
+ "call_id": {
+ "description": "Identifier for the originating tool call.",
+ "type": "string"
+ },
+ "path": {
+ "description": "Local filesystem path provided to the tool.",
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "view_image_tool_call"
+ ],
+ "title": "ViewImageToolCallEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "path",
+ "type"
+ ],
+ "title": "ViewImageToolCallEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "call_id": {
+ "description": "Identifier for the associated exec call, if available.",
+ "type": "string"
+ },
+ "command": {
+ "description": "The command to be executed.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "cwd": {
+ "description": "The command's working directory.",
+ "type": "string"
+ },
+ "parsed_cmd": {
+ "items": {
+ "$ref": "#/definitions/ParsedCommand"
+ },
+ "type": "array"
+ },
+ "proposed_execpolicy_amendment": {
+ "description": "Proposed execpolicy amendment that can be applied to allow future runs.",
+ "items": {
+ "type": "string"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "reason": {
+ "description": "Optional human-readable reason for the approval (e.g. retry without sandbox).",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "turn_id": {
+ "default": "",
+ "description": "Turn ID that this command belongs to. Uses `#[serde(default)]` for backwards compatibility.",
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "exec_approval_request"
+ ],
+ "title": "ExecApprovalRequestEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "command",
+ "cwd",
+ "parsed_cmd",
+ "type"
+ ],
+ "title": "ExecApprovalRequestEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "call_id": {
+ "description": "Responses API call id for the associated tool call, if available.",
+ "type": "string"
+ },
+ "questions": {
+ "items": {
+ "$ref": "#/definitions/RequestUserInputQuestion"
+ },
+ "type": "array"
+ },
+ "turn_id": {
+ "default": "",
+ "description": "Turn ID that this request belongs to. Uses `#[serde(default)]` for backwards compatibility.",
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "request_user_input"
+ ],
+ "title": "RequestUserInputEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "questions",
+ "type"
+ ],
+ "title": "RequestUserInputEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "arguments": true,
+ "callId": {
+ "type": "string"
+ },
+ "tool": {
+ "type": "string"
+ },
+ "turnId": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "dynamic_tool_call_request"
+ ],
+ "title": "DynamicToolCallRequestEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "arguments",
+ "callId",
+ "tool",
+ "turnId",
+ "type"
+ ],
+ "title": "DynamicToolCallRequestEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "message": {
+ "type": "string"
+ },
+ "server_name": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "elicitation_request"
+ ],
+ "title": "ElicitationRequestEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "message",
+ "server_name",
+ "type"
+ ],
+ "title": "ElicitationRequestEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "call_id": {
+ "description": "Responses API call id for the associated patch apply call, if available.",
+ "type": "string"
+ },
+ "changes": {
+ "additionalProperties": {
+ "$ref": "#/definitions/FileChange"
+ },
+ "type": "object"
+ },
+ "grant_root": {
+ "description": "When set, the agent is asking the user to allow writes under this root for the remainder of the session.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "reason": {
+ "description": "Optional explanatory reason (e.g. request for extra write access).",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "turn_id": {
+ "default": "",
+ "description": "Turn ID that this patch belongs to. Uses `#[serde(default)]` for backwards compatibility with older senders.",
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "apply_patch_approval_request"
+ ],
+ "title": "ApplyPatchApprovalRequestEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "changes",
+ "type"
+ ],
+ "title": "ApplyPatchApprovalRequestEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Notification advising the user that something they are using has been deprecated and should be phased out.",
+ "properties": {
+ "details": {
+ "description": "Optional extra guidance, such as migration steps or rationale.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "summary": {
+ "description": "Concise summary of what is deprecated.",
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "deprecation_notice"
+ ],
+ "title": "DeprecationNoticeEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "summary",
+ "type"
+ ],
+ "title": "DeprecationNoticeEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "message": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "background_event"
+ ],
+ "title": "BackgroundEventEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "message",
+ "type"
+ ],
+ "title": "BackgroundEventEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "message": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "undo_started"
+ ],
+ "title": "UndoStartedEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "UndoStartedEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "message": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "success": {
+ "type": "boolean"
+ },
+ "type": {
+ "enum": [
+ "undo_completed"
+ ],
+ "title": "UndoCompletedEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "success",
+ "type"
+ ],
+ "title": "UndoCompletedEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Notification that a model stream experienced an error or disconnect and the system is handling it (e.g., retrying with backoff).",
+ "properties": {
+ "additional_details": {
+ "default": null,
+ "description": "Optional details about the underlying stream failure (often the same human-readable message that is surfaced as the terminal error if retries are exhausted).",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "codex_error_info": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/CodexErrorInfo2"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "default": null
+ },
+ "message": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "stream_error"
+ ],
+ "title": "StreamErrorEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "message",
+ "type"
+ ],
+ "title": "StreamErrorEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Notification that the agent is about to apply a code patch. Mirrors `ExecCommandBegin` so front‑ends can show progress indicators.",
+ "properties": {
+ "auto_approved": {
+ "description": "If true, there was no ApplyPatchApprovalRequest for this patch.",
+ "type": "boolean"
+ },
+ "call_id": {
+ "description": "Identifier so this can be paired with the PatchApplyEnd event.",
+ "type": "string"
+ },
+ "changes": {
+ "additionalProperties": {
+ "$ref": "#/definitions/FileChange"
+ },
+ "description": "The changes to be applied.",
+ "type": "object"
+ },
+ "turn_id": {
+ "default": "",
+ "description": "Turn ID that this patch belongs to. Uses `#[serde(default)]` for backwards compatibility.",
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "patch_apply_begin"
+ ],
+ "title": "PatchApplyBeginEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "auto_approved",
+ "call_id",
+ "changes",
+ "type"
+ ],
+ "title": "PatchApplyBeginEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Notification that a patch application has finished.",
+ "properties": {
+ "call_id": {
+ "description": "Identifier for the PatchApplyBegin that finished.",
+ "type": "string"
+ },
+ "changes": {
+ "additionalProperties": {
+ "$ref": "#/definitions/FileChange"
+ },
+ "default": {},
+ "description": "The changes that were applied (mirrors PatchApplyBeginEvent::changes).",
+ "type": "object"
+ },
+ "stderr": {
+ "description": "Captured stderr (parser errors, IO failures, etc.).",
+ "type": "string"
+ },
+ "stdout": {
+ "description": "Captured stdout (summary printed by apply_patch).",
+ "type": "string"
+ },
+ "success": {
+ "description": "Whether the patch was applied successfully.",
+ "type": "boolean"
+ },
+ "turn_id": {
+ "default": "",
+ "description": "Turn ID that this patch belongs to. Uses `#[serde(default)]` for backwards compatibility.",
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "patch_apply_end"
+ ],
+ "title": "PatchApplyEndEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "stderr",
+ "stdout",
+ "success",
+ "type"
+ ],
+ "title": "PatchApplyEndEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "turn_diff"
+ ],
+ "title": "TurnDiffEventMsgType",
+ "type": "string"
+ },
+ "unified_diff": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "unified_diff"
+ ],
+ "title": "TurnDiffEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Response to GetHistoryEntryRequest.",
+ "properties": {
+ "entry": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/HistoryEntry"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "The entry at the requested offset, if available and parseable."
+ },
+ "log_id": {
+ "format": "uint64",
+ "minimum": 0.0,
+ "type": "integer"
+ },
+ "offset": {
+ "format": "uint",
+ "minimum": 0.0,
+ "type": "integer"
+ },
+ "type": {
+ "enum": [
+ "get_history_entry_response"
+ ],
+ "title": "GetHistoryEntryResponseEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "log_id",
+ "offset",
+ "type"
+ ],
+ "title": "GetHistoryEntryResponseEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "List of MCP tools available to the agent.",
+ "properties": {
+ "auth_statuses": {
+ "additionalProperties": {
+ "$ref": "#/definitions/McpAuthStatus"
+ },
+ "description": "Authentication status for each configured MCP server.",
+ "type": "object"
+ },
+ "resource_templates": {
+ "additionalProperties": {
+ "items": {
+ "$ref": "#/definitions/ResourceTemplate"
+ },
+ "type": "array"
+ },
+ "description": "Known resource templates grouped by server name.",
+ "type": "object"
+ },
+ "resources": {
+ "additionalProperties": {
+ "items": {
+ "$ref": "#/definitions/Resource"
+ },
+ "type": "array"
+ },
+ "description": "Known resources grouped by server name.",
+ "type": "object"
+ },
+ "tools": {
+ "additionalProperties": {
+ "$ref": "#/definitions/Tool"
+ },
+ "description": "Fully qualified tool name -> tool definition.",
+ "type": "object"
+ },
+ "type": {
+ "enum": [
+ "mcp_list_tools_response"
+ ],
+ "title": "McpListToolsResponseEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "auth_statuses",
+ "resource_templates",
+ "resources",
+ "tools",
+ "type"
+ ],
+ "title": "McpListToolsResponseEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "List of custom prompts available to the agent.",
+ "properties": {
+ "custom_prompts": {
+ "items": {
+ "$ref": "#/definitions/CustomPrompt"
+ },
+ "type": "array"
+ },
+ "type": {
+ "enum": [
+ "list_custom_prompts_response"
+ ],
+ "title": "ListCustomPromptsResponseEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "custom_prompts",
+ "type"
+ ],
+ "title": "ListCustomPromptsResponseEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "List of skills available to the agent.",
+ "properties": {
+ "skills": {
+ "items": {
+ "$ref": "#/definitions/SkillsListEntry"
+ },
+ "type": "array"
+ },
+ "type": {
+ "enum": [
+ "list_skills_response"
+ ],
+ "title": "ListSkillsResponseEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "skills",
+ "type"
+ ],
+ "title": "ListSkillsResponseEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Notification that skill data may have been updated and clients may want to reload.",
+ "properties": {
+ "type": {
+ "enum": [
+ "skills_update_available"
+ ],
+ "title": "SkillsUpdateAvailableEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "SkillsUpdateAvailableEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "explanation": {
+ "default": null,
+ "description": "Arguments for the `update_plan` todo/checklist tool (not plan mode).",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "plan": {
+ "items": {
+ "$ref": "#/definitions/PlanItemArg"
+ },
+ "type": "array"
+ },
+ "type": {
+ "enum": [
+ "plan_update"
+ ],
+ "title": "PlanUpdateEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "plan",
+ "type"
+ ],
+ "title": "PlanUpdateEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "reason": {
+ "$ref": "#/definitions/TurnAbortReason"
+ },
+ "type": {
+ "enum": [
+ "turn_aborted"
+ ],
+ "title": "TurnAbortedEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "reason",
+ "type"
+ ],
+ "title": "TurnAbortedEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Notification that the agent is shutting down.",
+ "properties": {
+ "type": {
+ "enum": [
+ "shutdown_complete"
+ ],
+ "title": "ShutdownCompleteEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "ShutdownCompleteEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Entered review mode.",
+ "properties": {
+ "target": {
+ "$ref": "#/definitions/ReviewTarget"
+ },
+ "type": {
+ "enum": [
+ "entered_review_mode"
+ ],
+ "title": "EnteredReviewModeEventMsgType",
+ "type": "string"
+ },
+ "user_facing_hint": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "target",
+ "type"
+ ],
+ "title": "EnteredReviewModeEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Exited review mode with an optional final result to apply.",
+ "properties": {
+ "review_output": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ReviewOutputEvent"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "type": {
+ "enum": [
+ "exited_review_mode"
+ ],
+ "title": "ExitedReviewModeEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "ExitedReviewModeEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "item": {
+ "$ref": "#/definitions/ResponseItem"
+ },
+ "type": {
+ "enum": [
+ "raw_response_item"
+ ],
+ "title": "RawResponseItemEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "item",
+ "type"
+ ],
+ "title": "RawResponseItemEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "item": {
+ "$ref": "#/definitions/TurnItem"
+ },
+ "thread_id": {
+ "$ref": "#/definitions/ThreadId"
+ },
+ "turn_id": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "item_started"
+ ],
+ "title": "ItemStartedEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "item",
+ "thread_id",
+ "turn_id",
+ "type"
+ ],
+ "title": "ItemStartedEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "item": {
+ "$ref": "#/definitions/TurnItem"
+ },
+ "thread_id": {
+ "$ref": "#/definitions/ThreadId"
+ },
+ "turn_id": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "item_completed"
+ ],
+ "title": "ItemCompletedEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "item",
+ "thread_id",
+ "turn_id",
+ "type"
+ ],
+ "title": "ItemCompletedEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "delta": {
+ "type": "string"
+ },
+ "item_id": {
+ "type": "string"
+ },
+ "thread_id": {
+ "type": "string"
+ },
+ "turn_id": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "agent_message_content_delta"
+ ],
+ "title": "AgentMessageContentDeltaEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "delta",
+ "item_id",
+ "thread_id",
+ "turn_id",
+ "type"
+ ],
+ "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": {
+ "type": "string"
+ },
+ "item_id": {
+ "type": "string"
+ },
+ "summary_index": {
+ "default": 0,
+ "format": "int64",
+ "type": "integer"
+ },
+ "thread_id": {
+ "type": "string"
+ },
+ "turn_id": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "reasoning_content_delta"
+ ],
+ "title": "ReasoningContentDeltaEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "delta",
+ "item_id",
+ "thread_id",
+ "turn_id",
+ "type"
+ ],
+ "title": "ReasoningContentDeltaEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "content_index": {
+ "default": 0,
+ "format": "int64",
+ "type": "integer"
+ },
+ "delta": {
+ "type": "string"
+ },
+ "item_id": {
+ "type": "string"
+ },
+ "thread_id": {
+ "type": "string"
+ },
+ "turn_id": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "reasoning_raw_content_delta"
+ ],
+ "title": "ReasoningRawContentDeltaEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "delta",
+ "item_id",
+ "thread_id",
+ "turn_id",
+ "type"
+ ],
+ "title": "ReasoningRawContentDeltaEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Collab interaction: agent spawn begin.",
+ "properties": {
+ "call_id": {
+ "description": "Identifier for the collab tool call.",
+ "type": "string"
+ },
+ "prompt": {
+ "description": "Initial prompt sent to the agent. Can be empty to prevent CoT leaking at the beginning.",
+ "type": "string"
+ },
+ "sender_thread_id": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ThreadId"
+ }
+ ],
+ "description": "Thread ID of the sender."
+ },
+ "type": {
+ "enum": [
+ "collab_agent_spawn_begin"
+ ],
+ "title": "CollabAgentSpawnBeginEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "prompt",
+ "sender_thread_id",
+ "type"
+ ],
+ "title": "CollabAgentSpawnBeginEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Collab interaction: agent spawn end.",
+ "properties": {
+ "call_id": {
+ "description": "Identifier for the collab tool call.",
+ "type": "string"
+ },
+ "new_thread_id": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ThreadId"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Thread ID of the newly spawned agent, if it was created."
+ },
+ "prompt": {
+ "description": "Initial prompt sent to the agent. Can be empty to prevent CoT leaking at the beginning.",
+ "type": "string"
+ },
+ "sender_thread_id": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ThreadId"
+ }
+ ],
+ "description": "Thread ID of the sender."
+ },
+ "status": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/AgentStatus"
+ }
+ ],
+ "description": "Last known status of the new agent reported to the sender agent."
+ },
+ "type": {
+ "enum": [
+ "collab_agent_spawn_end"
+ ],
+ "title": "CollabAgentSpawnEndEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "prompt",
+ "sender_thread_id",
+ "status",
+ "type"
+ ],
+ "title": "CollabAgentSpawnEndEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Collab interaction: agent interaction begin.",
+ "properties": {
+ "call_id": {
+ "description": "Identifier for the collab tool call.",
+ "type": "string"
+ },
+ "prompt": {
+ "description": "Prompt sent from the sender to the receiver. Can be empty to prevent CoT leaking at the beginning.",
+ "type": "string"
+ },
+ "receiver_thread_id": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ThreadId"
+ }
+ ],
+ "description": "Thread ID of the receiver."
+ },
+ "sender_thread_id": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ThreadId"
+ }
+ ],
+ "description": "Thread ID of the sender."
+ },
+ "type": {
+ "enum": [
+ "collab_agent_interaction_begin"
+ ],
+ "title": "CollabAgentInteractionBeginEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "prompt",
+ "receiver_thread_id",
+ "sender_thread_id",
+ "type"
+ ],
+ "title": "CollabAgentInteractionBeginEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Collab interaction: agent interaction end.",
+ "properties": {
+ "call_id": {
+ "description": "Identifier for the collab tool call.",
+ "type": "string"
+ },
+ "prompt": {
+ "description": "Prompt sent from the sender to the receiver. Can be empty to prevent CoT leaking at the beginning.",
+ "type": "string"
+ },
+ "receiver_thread_id": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ThreadId"
+ }
+ ],
+ "description": "Thread ID of the receiver."
+ },
+ "sender_thread_id": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ThreadId"
+ }
+ ],
+ "description": "Thread ID of the sender."
+ },
+ "status": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/AgentStatus"
+ }
+ ],
+ "description": "Last known status of the receiver agent reported to the sender agent."
+ },
+ "type": {
+ "enum": [
+ "collab_agent_interaction_end"
+ ],
+ "title": "CollabAgentInteractionEndEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "prompt",
+ "receiver_thread_id",
+ "sender_thread_id",
+ "status",
+ "type"
+ ],
+ "title": "CollabAgentInteractionEndEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Collab interaction: waiting begin.",
+ "properties": {
+ "call_id": {
+ "description": "ID of the waiting call.",
+ "type": "string"
+ },
+ "receiver_thread_ids": {
+ "description": "Thread ID of the receivers.",
+ "items": {
+ "$ref": "#/definitions/ThreadId"
+ },
+ "type": "array"
+ },
+ "sender_thread_id": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ThreadId"
+ }
+ ],
+ "description": "Thread ID of the sender."
+ },
+ "type": {
+ "enum": [
+ "collab_waiting_begin"
+ ],
+ "title": "CollabWaitingBeginEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "receiver_thread_ids",
+ "sender_thread_id",
+ "type"
+ ],
+ "title": "CollabWaitingBeginEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Collab interaction: waiting end.",
+ "properties": {
+ "call_id": {
+ "description": "ID of the waiting call.",
+ "type": "string"
+ },
+ "sender_thread_id": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ThreadId"
+ }
+ ],
+ "description": "Thread ID of the sender."
+ },
+ "statuses": {
+ "additionalProperties": {
+ "$ref": "#/definitions/AgentStatus"
+ },
+ "description": "Last known status of the receiver agents reported to the sender agent.",
+ "type": "object"
+ },
+ "type": {
+ "enum": [
+ "collab_waiting_end"
+ ],
+ "title": "CollabWaitingEndEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "sender_thread_id",
+ "statuses",
+ "type"
+ ],
+ "title": "CollabWaitingEndEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Collab interaction: close begin.",
+ "properties": {
+ "call_id": {
+ "description": "Identifier for the collab tool call.",
+ "type": "string"
+ },
+ "receiver_thread_id": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ThreadId"
+ }
+ ],
+ "description": "Thread ID of the receiver."
+ },
+ "sender_thread_id": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ThreadId"
+ }
+ ],
+ "description": "Thread ID of the sender."
+ },
+ "type": {
+ "enum": [
+ "collab_close_begin"
+ ],
+ "title": "CollabCloseBeginEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "receiver_thread_id",
+ "sender_thread_id",
+ "type"
+ ],
+ "title": "CollabCloseBeginEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Collab interaction: close end.",
+ "properties": {
+ "call_id": {
+ "description": "Identifier for the collab tool call.",
+ "type": "string"
+ },
+ "receiver_thread_id": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ThreadId"
+ }
+ ],
+ "description": "Thread ID of the receiver."
+ },
+ "sender_thread_id": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ThreadId"
+ }
+ ],
+ "description": "Thread ID of the sender."
+ },
+ "status": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/AgentStatus"
+ }
+ ],
+ "description": "Last known status of the receiver agent reported to the sender agent before the close."
+ },
+ "type": {
+ "enum": [
+ "collab_close_end"
+ ],
+ "title": "CollabCloseEndEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "receiver_thread_id",
+ "sender_thread_id",
+ "status",
+ "type"
+ ],
+ "title": "CollabCloseEndEventMsg",
+ "type": "object"
+ }
+ ]
+ },
+ "ExecCommandSource": {
+ "enum": [
+ "agent",
+ "user_shell",
+ "unified_exec_startup",
+ "unified_exec_interaction"
+ ],
+ "type": "string"
+ },
+ "ExecOutputStream": {
+ "enum": [
+ "stdout",
+ "stderr"
+ ],
+ "type": "string"
+ },
+ "FileChange": {
+ "oneOf": [
+ {
+ "properties": {
+ "content": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "add"
+ ],
+ "title": "AddFileChangeType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "content",
+ "type"
+ ],
+ "title": "AddFileChange",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "content": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "delete"
+ ],
+ "title": "DeleteFileChangeType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "content",
+ "type"
+ ],
+ "title": "DeleteFileChange",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "move_path": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "update"
+ ],
+ "title": "UpdateFileChangeType",
+ "type": "string"
+ },
+ "unified_diff": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "unified_diff"
+ ],
+ "title": "UpdateFileChange",
+ "type": "object"
+ }
+ ]
+ },
+ "FileChangeOutputDeltaNotification": {
+ "properties": {
+ "delta": {
+ "type": "string"
+ },
+ "itemId": {
+ "type": "string"
+ },
+ "threadId": {
+ "type": "string"
+ },
+ "turnId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "delta",
+ "itemId",
+ "threadId",
+ "turnId"
+ ],
+ "type": "object"
+ },
+ "FileUpdateChange": {
+ "properties": {
+ "diff": {
+ "type": "string"
+ },
+ "kind": {
+ "$ref": "#/definitions/PatchChangeKind"
+ },
+ "path": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "diff",
+ "kind",
+ "path"
+ ],
+ "type": "object"
+ },
+ "FunctionCallOutputContentItem": {
+ "description": "Responses API compatible content items that can be returned by a tool call. This is a subset of ContentItem with the types we support as function call outputs.",
+ "oneOf": [
+ {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "input_text"
+ ],
+ "title": "InputTextFunctionCallOutputContentItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "InputTextFunctionCallOutputContentItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "image_url": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "input_image"
+ ],
+ "title": "InputImageFunctionCallOutputContentItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "image_url",
+ "type"
+ ],
+ "title": "InputImageFunctionCallOutputContentItem",
+ "type": "object"
+ }
+ ]
+ },
+ "FunctionCallOutputPayload": {
+ "description": "The payload we send back to OpenAI when reporting a tool call result.\n\n`content` preserves the historical plain-string payload so downstream integrations (tests, logging, etc.) can keep treating tool output as `String`. When an MCP server returns richer data we additionally populate `content_items` with the structured form that the Responses/Chat Completions APIs understand.",
+ "properties": {
+ "content": {
+ "type": "string"
+ },
+ "content_items": {
+ "items": {
+ "$ref": "#/definitions/FunctionCallOutputContentItem"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "success": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "content"
+ ],
+ "type": "object"
+ },
+ "GhostCommit": {
+ "description": "Details of a ghost commit created from a repository state.",
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "parent": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "preexisting_untracked_dirs": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "preexisting_untracked_files": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ }
+ },
+ "required": [
+ "id",
+ "preexisting_untracked_dirs",
+ "preexisting_untracked_files"
+ ],
+ "type": "object"
+ },
+ "GitInfo": {
+ "properties": {
+ "branch": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "originUrl": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "sha": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "HistoryEntry": {
+ "properties": {
+ "conversation_id": {
+ "type": "string"
+ },
+ "text": {
+ "type": "string"
+ },
+ "ts": {
+ "format": "uint64",
+ "minimum": 0.0,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "conversation_id",
+ "text",
+ "ts"
+ ],
+ "type": "object"
+ },
+ "ImageContent": {
+ "description": "An image provided to or from an LLM.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "data": {
+ "type": "string"
+ },
+ "mimeType": {
+ "type": "string"
+ },
+ "type": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "data",
+ "mimeType",
+ "type"
+ ],
+ "type": "object"
+ },
+ "ItemCompletedNotification": {
+ "properties": {
+ "item": {
+ "$ref": "#/definitions/ThreadItem"
+ },
+ "threadId": {
+ "type": "string"
+ },
+ "turnId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "item",
+ "threadId",
+ "turnId"
+ ],
+ "type": "object"
+ },
+ "ItemStartedNotification": {
+ "properties": {
+ "item": {
+ "$ref": "#/definitions/ThreadItem"
+ },
+ "threadId": {
+ "type": "string"
+ },
+ "turnId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "item",
+ "threadId",
+ "turnId"
+ ],
+ "type": "object"
+ },
+ "LocalShellAction": {
+ "oneOf": [
+ {
+ "properties": {
+ "command": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "env": {
+ "additionalProperties": {
+ "type": "string"
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "timeout_ms": {
+ "format": "uint64",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "exec"
+ ],
+ "title": "ExecLocalShellActionType",
+ "type": "string"
+ },
+ "user": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "working_directory": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "command",
+ "type"
+ ],
+ "title": "ExecLocalShellAction",
+ "type": "object"
+ }
+ ]
+ },
+ "LocalShellStatus": {
+ "enum": [
+ "completed",
+ "in_progress",
+ "incomplete"
+ ],
+ "type": "string"
+ },
+ "LoginChatGptCompleteNotification": {
+ "description": "Deprecated in favor of AccountLoginCompletedNotification.",
+ "properties": {
+ "error": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "loginId": {
+ "type": "string"
+ },
+ "success": {
+ "type": "boolean"
+ }
+ },
+ "required": [
+ "loginId",
+ "success"
+ ],
+ "type": "object"
+ },
+ "McpAuthStatus": {
+ "enum": [
+ "unsupported",
+ "not_logged_in",
+ "bearer_token",
+ "o_auth"
+ ],
+ "type": "string"
+ },
+ "McpInvocation": {
+ "properties": {
+ "arguments": {
+ "description": "Arguments to the tool call."
+ },
+ "server": {
+ "description": "Name of the MCP server as defined in the config.",
+ "type": "string"
+ },
+ "tool": {
+ "description": "Name of the tool as given by the MCP server.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "server",
+ "tool"
+ ],
+ "type": "object"
+ },
+ "McpServerOauthLoginCompletedNotification": {
+ "properties": {
+ "error": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "name": {
+ "type": "string"
+ },
+ "success": {
+ "type": "boolean"
+ }
+ },
+ "required": [
+ "name",
+ "success"
+ ],
+ "type": "object"
+ },
+ "McpStartupFailure": {
+ "properties": {
+ "error": {
+ "type": "string"
+ },
+ "server": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "error",
+ "server"
+ ],
+ "type": "object"
+ },
+ "McpStartupStatus": {
+ "oneOf": [
+ {
+ "properties": {
+ "state": {
+ "enum": [
+ "starting"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "state"
+ ],
+ "title": "StateMcpStartupStatus",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "state": {
+ "enum": [
+ "ready"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "state"
+ ],
+ "title": "StateMcpStartupStatus2",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "error": {
+ "type": "string"
+ },
+ "state": {
+ "enum": [
+ "failed"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "error",
+ "state"
+ ],
+ "type": "object"
+ },
+ {
+ "properties": {
+ "state": {
+ "enum": [
+ "cancelled"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "state"
+ ],
+ "title": "StateMcpStartupStatus3",
+ "type": "object"
+ }
+ ]
+ },
+ "McpToolCallError": {
+ "properties": {
+ "message": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "message"
+ ],
+ "type": "object"
+ },
+ "McpToolCallProgressNotification": {
+ "properties": {
+ "itemId": {
+ "type": "string"
+ },
+ "message": {
+ "type": "string"
+ },
+ "threadId": {
+ "type": "string"
+ },
+ "turnId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "itemId",
+ "message",
+ "threadId",
+ "turnId"
+ ],
+ "type": "object"
+ },
+ "McpToolCallResult": {
+ "properties": {
+ "content": {
+ "items": {
+ "$ref": "#/definitions/ContentBlock"
+ },
+ "type": "array"
+ },
+ "structuredContent": true
+ },
+ "required": [
+ "content"
+ ],
+ "type": "object"
+ },
+ "McpToolCallStatus": {
+ "enum": [
+ "inProgress",
+ "completed",
+ "failed"
+ ],
+ "type": "string"
+ },
+ "ModeKind": {
+ "description": "Initial collaboration mode to use when the TUI starts.",
+ "enum": [
+ "plan",
+ "code",
+ "pair_programming",
+ "execute",
+ "custom"
+ ],
+ "type": "string"
+ },
+ "NetworkAccess": {
+ "description": "Represents whether outbound network access is available to the agent.",
+ "enum": [
+ "restricted",
+ "enabled"
+ ],
+ "type": "string"
+ },
+ "ParsedCommand": {
+ "oneOf": [
+ {
+ "properties": {
+ "cmd": {
+ "type": "string"
+ },
+ "name": {
+ "type": "string"
+ },
+ "path": {
+ "description": "(Best effort) Path to the file being read by the command. When possible, this is an absolute path, though when relative, it should be resolved against the `cwd`` that will be used to run the command to derive the absolute path.",
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "read"
+ ],
+ "title": "ReadParsedCommandType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "cmd",
+ "name",
+ "path",
+ "type"
+ ],
+ "title": "ReadParsedCommand",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "cmd": {
+ "type": "string"
+ },
+ "path": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "list_files"
+ ],
+ "title": "ListFilesParsedCommandType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "cmd",
+ "type"
+ ],
+ "title": "ListFilesParsedCommand",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "cmd": {
+ "type": "string"
+ },
+ "path": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "query": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "search"
+ ],
+ "title": "SearchParsedCommandType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "cmd",
+ "type"
+ ],
+ "title": "SearchParsedCommand",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "cmd": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "unknown"
+ ],
+ "title": "UnknownParsedCommandType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "cmd",
+ "type"
+ ],
+ "title": "UnknownParsedCommand",
+ "type": "object"
+ }
+ ]
+ },
+ "PatchApplyStatus": {
+ "enum": [
+ "inProgress",
+ "completed",
+ "failed",
+ "declined"
+ ],
+ "type": "string"
+ },
+ "PatchChangeKind": {
+ "oneOf": [
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "add"
+ ],
+ "title": "AddPatchChangeKindType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "AddPatchChangeKind",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "delete"
+ ],
+ "title": "DeletePatchChangeKindType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "DeletePatchChangeKind",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "move_path": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "update"
+ ],
+ "title": "UpdatePatchChangeKindType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "UpdatePatchChangeKind",
+ "type": "object"
+ }
+ ]
+ },
+ "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": {
+ "status": {
+ "$ref": "#/definitions/StepStatus"
+ },
+ "step": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "status",
+ "step"
+ ],
+ "type": "object"
+ },
+ "PlanType": {
+ "enum": [
+ "free",
+ "go",
+ "plus",
+ "pro",
+ "team",
+ "business",
+ "enterprise",
+ "edu",
+ "unknown"
+ ],
+ "type": "string"
+ },
+ "RateLimitSnapshot": {
+ "properties": {
+ "credits": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/CreditsSnapshot"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "planType": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/PlanType"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "primary": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/RateLimitWindow"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "secondary": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/RateLimitWindow"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "RateLimitSnapshot2": {
+ "properties": {
+ "credits": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/CreditsSnapshot2"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "plan_type": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/PlanType"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "primary": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/RateLimitWindow2"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "secondary": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/RateLimitWindow2"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "RateLimitWindow": {
+ "properties": {
+ "resetsAt": {
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "usedPercent": {
+ "format": "int32",
+ "type": "integer"
+ },
+ "windowDurationMins": {
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "usedPercent"
+ ],
+ "type": "object"
+ },
+ "RateLimitWindow2": {
+ "properties": {
+ "resets_at": {
+ "description": "Unix timestamp (seconds since epoch) when the window resets.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "used_percent": {
+ "description": "Percentage (0-100) of the window that has been consumed.",
+ "format": "double",
+ "type": "number"
+ },
+ "window_minutes": {
+ "description": "Rolling window duration, in minutes.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "used_percent"
+ ],
+ "type": "object"
+ },
+ "RawResponseItemCompletedNotification": {
+ "properties": {
+ "item": {
+ "$ref": "#/definitions/ResponseItem"
+ },
+ "threadId": {
+ "type": "string"
+ },
+ "turnId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "item",
+ "threadId",
+ "turnId"
+ ],
+ "type": "object"
+ },
+ "ReasoningEffort": {
+ "description": "See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#get-started-with-reasoning",
+ "enum": [
+ "none",
+ "minimal",
+ "low",
+ "medium",
+ "high",
+ "xhigh"
+ ],
+ "type": "string"
+ },
+ "ReasoningItemContent": {
+ "oneOf": [
+ {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "reasoning_text"
+ ],
+ "title": "ReasoningTextReasoningItemContentType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "ReasoningTextReasoningItemContent",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "text"
+ ],
+ "title": "TextReasoningItemContentType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "TextReasoningItemContent",
+ "type": "object"
+ }
+ ]
+ },
+ "ReasoningItemReasoningSummary": {
+ "oneOf": [
+ {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "summary_text"
+ ],
+ "title": "SummaryTextReasoningItemReasoningSummaryType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "SummaryTextReasoningItemReasoningSummary",
+ "type": "object"
+ }
+ ]
+ },
+ "ReasoningSummaryPartAddedNotification": {
+ "properties": {
+ "itemId": {
+ "type": "string"
+ },
+ "summaryIndex": {
+ "format": "int64",
+ "type": "integer"
+ },
+ "threadId": {
+ "type": "string"
+ },
+ "turnId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "itemId",
+ "summaryIndex",
+ "threadId",
+ "turnId"
+ ],
+ "type": "object"
+ },
+ "ReasoningSummaryTextDeltaNotification": {
+ "properties": {
+ "delta": {
+ "type": "string"
+ },
+ "itemId": {
+ "type": "string"
+ },
+ "summaryIndex": {
+ "format": "int64",
+ "type": "integer"
+ },
+ "threadId": {
+ "type": "string"
+ },
+ "turnId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "delta",
+ "itemId",
+ "summaryIndex",
+ "threadId",
+ "turnId"
+ ],
+ "type": "object"
+ },
+ "ReasoningTextDeltaNotification": {
+ "properties": {
+ "contentIndex": {
+ "format": "int64",
+ "type": "integer"
+ },
+ "delta": {
+ "type": "string"
+ },
+ "itemId": {
+ "type": "string"
+ },
+ "threadId": {
+ "type": "string"
+ },
+ "turnId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "contentIndex",
+ "delta",
+ "itemId",
+ "threadId",
+ "turnId"
+ ],
+ "type": "object"
+ },
+ "RequestId": {
+ "anyOf": [
+ {
+ "type": "string"
+ },
+ {
+ "format": "int64",
+ "type": "integer"
+ }
+ ]
+ },
+ "RequestUserInputQuestion": {
+ "properties": {
+ "header": {
+ "type": "string"
+ },
+ "id": {
+ "type": "string"
+ },
+ "isOther": {
+ "default": false,
+ "type": "boolean"
+ },
+ "isSecret": {
+ "default": false,
+ "type": "boolean"
+ },
+ "options": {
+ "items": {
+ "$ref": "#/definitions/RequestUserInputQuestionOption"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "question": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "header",
+ "id",
+ "question"
+ ],
+ "type": "object"
+ },
+ "RequestUserInputQuestionOption": {
+ "properties": {
+ "description": {
+ "type": "string"
+ },
+ "label": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "description",
+ "label"
+ ],
+ "type": "object"
+ },
+ "Resource": {
+ "description": "A known resource that the server is capable of reading.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "description": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "mimeType": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "name": {
+ "type": "string"
+ },
+ "size": {
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "title": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "uri": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "uri"
+ ],
+ "type": "object"
+ },
+ "ResourceLink": {
+ "description": "A resource that the server is capable of reading, included in a prompt or tool call result.\n\nNote: resource links returned by tools are not guaranteed to appear in the results of `resources/list` requests.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "description": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "mimeType": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "name": {
+ "type": "string"
+ },
+ "size": {
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "title": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "type": "string"
+ },
+ "uri": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "type",
+ "uri"
+ ],
+ "type": "object"
+ },
+ "ResourceTemplate": {
+ "description": "A template description for resources available on the server.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "description": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "mimeType": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "name": {
+ "type": "string"
+ },
+ "title": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "uriTemplate": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "uriTemplate"
+ ],
+ "type": "object"
+ },
+ "ResponseItem": {
+ "oneOf": [
+ {
+ "properties": {
+ "content": {
+ "items": {
+ "$ref": "#/definitions/ContentItem"
+ },
+ "type": "array"
+ },
+ "end_turn": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "id": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "writeOnly": true
+ },
+ "role": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "message"
+ ],
+ "title": "MessageResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "content",
+ "role",
+ "type"
+ ],
+ "title": "MessageResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "content": {
+ "default": null,
+ "items": {
+ "$ref": "#/definitions/ReasoningItemContent"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "encrypted_content": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "id": {
+ "type": "string",
+ "writeOnly": true
+ },
+ "summary": {
+ "items": {
+ "$ref": "#/definitions/ReasoningItemReasoningSummary"
+ },
+ "type": "array"
+ },
+ "type": {
+ "enum": [
+ "reasoning"
+ ],
+ "title": "ReasoningResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "summary",
+ "type"
+ ],
+ "title": "ReasoningResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "action": {
+ "$ref": "#/definitions/LocalShellAction"
+ },
+ "call_id": {
+ "description": "Set when using the Responses API.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "id": {
+ "description": "Set when using the chat completions API.",
+ "type": [
+ "string",
+ "null"
+ ],
+ "writeOnly": true
+ },
+ "status": {
+ "$ref": "#/definitions/LocalShellStatus"
+ },
+ "type": {
+ "enum": [
+ "local_shell_call"
+ ],
+ "title": "LocalShellCallResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "action",
+ "status",
+ "type"
+ ],
+ "title": "LocalShellCallResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "arguments": {
+ "type": "string"
+ },
+ "call_id": {
+ "type": "string"
+ },
+ "id": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "writeOnly": true
+ },
+ "name": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "function_call"
+ ],
+ "title": "FunctionCallResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "arguments",
+ "call_id",
+ "name",
+ "type"
+ ],
+ "title": "FunctionCallResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "call_id": {
+ "type": "string"
+ },
+ "output": {
+ "$ref": "#/definitions/FunctionCallOutputPayload"
+ },
+ "type": {
+ "enum": [
+ "function_call_output"
+ ],
+ "title": "FunctionCallOutputResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "output",
+ "type"
+ ],
+ "title": "FunctionCallOutputResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "call_id": {
+ "type": "string"
+ },
+ "id": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "writeOnly": true
+ },
+ "input": {
+ "type": "string"
+ },
+ "name": {
+ "type": "string"
+ },
+ "status": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "custom_tool_call"
+ ],
+ "title": "CustomToolCallResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "input",
+ "name",
+ "type"
+ ],
+ "title": "CustomToolCallResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "call_id": {
+ "type": "string"
+ },
+ "output": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "custom_tool_call_output"
+ ],
+ "title": "CustomToolCallOutputResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "output",
+ "type"
+ ],
+ "title": "CustomToolCallOutputResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "action": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/WebSearchAction2"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "id": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "writeOnly": true
+ },
+ "status": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "web_search_call"
+ ],
+ "title": "WebSearchCallResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "WebSearchCallResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "ghost_commit": {
+ "$ref": "#/definitions/GhostCommit"
+ },
+ "type": {
+ "enum": [
+ "ghost_snapshot"
+ ],
+ "title": "GhostSnapshotResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "ghost_commit",
+ "type"
+ ],
+ "title": "GhostSnapshotResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "encrypted_content": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "compaction"
+ ],
+ "title": "CompactionResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "encrypted_content",
+ "type"
+ ],
+ "title": "CompactionResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "other"
+ ],
+ "title": "OtherResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "OtherResponseItem",
+ "type": "object"
+ }
+ ]
+ },
+ "Result_of_CallToolResult_or_String": {
+ "oneOf": [
+ {
+ "properties": {
+ "Ok": {
+ "$ref": "#/definitions/CallToolResult"
+ }
+ },
+ "required": [
+ "Ok"
+ ],
+ "title": "OkResult_of_CallToolResult_or_String",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "Err": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "Err"
+ ],
+ "title": "ErrResult_of_CallToolResult_or_String",
+ "type": "object"
+ }
+ ]
+ },
+ "ReviewCodeLocation": {
+ "description": "Location of the code related to a review finding.",
+ "properties": {
+ "absolute_file_path": {
+ "type": "string"
+ },
+ "line_range": {
+ "$ref": "#/definitions/ReviewLineRange"
+ }
+ },
+ "required": [
+ "absolute_file_path",
+ "line_range"
+ ],
+ "type": "object"
+ },
+ "ReviewFinding": {
+ "description": "A single review finding describing an observed issue or recommendation.",
+ "properties": {
+ "body": {
+ "type": "string"
+ },
+ "code_location": {
+ "$ref": "#/definitions/ReviewCodeLocation"
+ },
+ "confidence_score": {
+ "format": "float",
+ "type": "number"
+ },
+ "priority": {
+ "format": "int32",
+ "type": "integer"
+ },
+ "title": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "body",
+ "code_location",
+ "confidence_score",
+ "priority",
+ "title"
+ ],
+ "type": "object"
+ },
+ "ReviewLineRange": {
+ "description": "Inclusive line range in a file associated with the finding.",
+ "properties": {
+ "end": {
+ "format": "uint32",
+ "minimum": 0.0,
+ "type": "integer"
+ },
+ "start": {
+ "format": "uint32",
+ "minimum": 0.0,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "end",
+ "start"
+ ],
+ "type": "object"
+ },
+ "ReviewOutputEvent": {
+ "description": "Structured review result produced by a child review session.",
+ "properties": {
+ "findings": {
+ "items": {
+ "$ref": "#/definitions/ReviewFinding"
+ },
+ "type": "array"
+ },
+ "overall_confidence_score": {
+ "format": "float",
+ "type": "number"
+ },
+ "overall_correctness": {
+ "type": "string"
+ },
+ "overall_explanation": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "findings",
+ "overall_confidence_score",
+ "overall_correctness",
+ "overall_explanation"
+ ],
+ "type": "object"
+ },
+ "ReviewTarget": {
+ "oneOf": [
+ {
+ "description": "Review the working tree: staged, unstaged, and untracked files.",
+ "properties": {
+ "type": {
+ "enum": [
+ "uncommittedChanges"
+ ],
+ "title": "UncommittedChangesReviewTargetType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "UncommittedChangesReviewTarget",
+ "type": "object"
+ },
+ {
+ "description": "Review changes between the current branch and the given base branch.",
+ "properties": {
+ "branch": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "baseBranch"
+ ],
+ "title": "BaseBranchReviewTargetType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "branch",
+ "type"
+ ],
+ "title": "BaseBranchReviewTarget",
+ "type": "object"
+ },
+ {
+ "description": "Review the changes introduced by a specific commit.",
+ "properties": {
+ "sha": {
+ "type": "string"
+ },
+ "title": {
+ "description": "Optional human-readable label (e.g., commit subject) for UIs.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "commit"
+ ],
+ "title": "CommitReviewTargetType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "sha",
+ "type"
+ ],
+ "title": "CommitReviewTarget",
+ "type": "object"
+ },
+ {
+ "description": "Arbitrary instructions provided by the user.",
+ "properties": {
+ "instructions": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "custom"
+ ],
+ "title": "CustomReviewTargetType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "instructions",
+ "type"
+ ],
+ "title": "CustomReviewTarget",
+ "type": "object"
+ }
+ ]
+ },
+ "Role": {
+ "description": "The sender or recipient of messages and data in a conversation.",
+ "enum": [
+ "assistant",
+ "user"
+ ],
+ "type": "string"
+ },
+ "SandboxPolicy": {
+ "description": "Determines execution restrictions for model shell commands.",
+ "oneOf": [
+ {
+ "description": "No restrictions whatsoever. Use with caution.",
+ "properties": {
+ "type": {
+ "enum": [
+ "danger-full-access"
+ ],
+ "title": "DangerFullAccessSandboxPolicyType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "DangerFullAccessSandboxPolicy",
+ "type": "object"
+ },
+ {
+ "description": "Read-only access to the entire file-system.",
+ "properties": {
+ "type": {
+ "enum": [
+ "read-only"
+ ],
+ "title": "ReadOnlySandboxPolicyType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "ReadOnlySandboxPolicy",
+ "type": "object"
+ },
+ {
+ "description": "Indicates the process is already in an external sandbox. Allows full disk access while honoring the provided network setting.",
+ "properties": {
+ "network_access": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/NetworkAccess"
+ }
+ ],
+ "default": "restricted",
+ "description": "Whether the external sandbox permits outbound network traffic."
+ },
+ "type": {
+ "enum": [
+ "external-sandbox"
+ ],
+ "title": "ExternalSandboxSandboxPolicyType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "ExternalSandboxSandboxPolicy",
+ "type": "object"
+ },
+ {
+ "description": "Same as `ReadOnly` but additionally grants write access to the current working directory (\"workspace\").",
+ "properties": {
+ "exclude_slash_tmp": {
+ "default": false,
+ "description": "When set to `true`, will NOT include the `/tmp` among the default writable roots on UNIX. Defaults to `false`.",
+ "type": "boolean"
+ },
+ "exclude_tmpdir_env_var": {
+ "default": false,
+ "description": "When set to `true`, will NOT include the per-user `TMPDIR` environment variable among the default writable roots. Defaults to `false`.",
+ "type": "boolean"
+ },
+ "network_access": {
+ "default": false,
+ "description": "When set to `true`, outbound network access is allowed. `false` by default.",
+ "type": "boolean"
+ },
+ "type": {
+ "enum": [
+ "workspace-write"
+ ],
+ "title": "WorkspaceWriteSandboxPolicyType",
+ "type": "string"
+ },
+ "writable_roots": {
+ "description": "Additional folders (beyond cwd and possibly TMPDIR) that should be writable from within the sandbox.",
+ "items": {
+ "$ref": "#/definitions/AbsolutePathBuf"
+ },
+ "type": "array"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "WorkspaceWriteSandboxPolicy",
+ "type": "object"
+ }
+ ]
+ },
+ "SessionConfiguredNotification": {
+ "properties": {
+ "historyEntryCount": {
+ "format": "uint",
+ "minimum": 0.0,
+ "type": "integer"
+ },
+ "historyLogId": {
+ "format": "uint64",
+ "minimum": 0.0,
+ "type": "integer"
+ },
+ "initialMessages": {
+ "items": {
+ "$ref": "#/definitions/EventMsg"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "model": {
+ "type": "string"
+ },
+ "reasoningEffort": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ReasoningEffort"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "rolloutPath": {
+ "type": "string"
+ },
+ "sessionId": {
+ "$ref": "#/definitions/ThreadId"
+ }
+ },
+ "required": [
+ "historyEntryCount",
+ "historyLogId",
+ "model",
+ "rolloutPath",
+ "sessionId"
+ ],
+ "type": "object"
+ },
+ "SessionSource": {
+ "oneOf": [
+ {
+ "enum": [
+ "cli",
+ "vscode",
+ "exec",
+ "appServer",
+ "unknown"
+ ],
+ "type": "string"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "subAgent": {
+ "$ref": "#/definitions/SubAgentSource"
+ }
+ },
+ "required": [
+ "subAgent"
+ ],
+ "title": "SubAgentSessionSource",
+ "type": "object"
+ }
+ ]
+ },
+ "SkillDependencies": {
+ "properties": {
+ "tools": {
+ "items": {
+ "$ref": "#/definitions/SkillToolDependency"
+ },
+ "type": "array"
+ }
+ },
+ "required": [
+ "tools"
+ ],
+ "type": "object"
+ },
+ "SkillErrorInfo": {
+ "properties": {
+ "message": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "message",
+ "path"
+ ],
+ "type": "object"
+ },
+ "SkillInterface": {
+ "properties": {
+ "brand_color": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "default_prompt": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "display_name": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "icon_large": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "icon_small": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "short_description": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "SkillMetadata": {
+ "properties": {
+ "dependencies": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/SkillDependencies"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "description": {
+ "type": "string"
+ },
+ "enabled": {
+ "type": "boolean"
+ },
+ "interface": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/SkillInterface"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "name": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "scope": {
+ "$ref": "#/definitions/SkillScope"
+ },
+ "short_description": {
+ "description": "Legacy short_description from SKILL.md. Prefer SKILL.json interface.short_description.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "description",
+ "enabled",
+ "name",
+ "path",
+ "scope"
+ ],
+ "type": "object"
+ },
+ "SkillScope": {
+ "enum": [
+ "user",
+ "repo",
+ "system",
+ "admin"
+ ],
+ "type": "string"
+ },
+ "SkillToolDependency": {
+ "properties": {
+ "command": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "description": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "transport": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "type": "string"
+ },
+ "url": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "value": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "value"
+ ],
+ "type": "object"
+ },
+ "SkillsListEntry": {
+ "properties": {
+ "cwd": {
+ "type": "string"
+ },
+ "errors": {
+ "items": {
+ "$ref": "#/definitions/SkillErrorInfo"
+ },
+ "type": "array"
+ },
+ "skills": {
+ "items": {
+ "$ref": "#/definitions/SkillMetadata"
+ },
+ "type": "array"
+ }
+ },
+ "required": [
+ "cwd",
+ "errors",
+ "skills"
+ ],
+ "type": "object"
+ },
+ "StepStatus": {
+ "enum": [
+ "pending",
+ "in_progress",
+ "completed"
+ ],
+ "type": "string"
+ },
+ "SubAgentSource": {
+ "oneOf": [
+ {
+ "enum": [
+ "review",
+ "compact"
+ ],
+ "type": "string"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "thread_spawn": {
+ "properties": {
+ "depth": {
+ "format": "int32",
+ "type": "integer"
+ },
+ "parent_thread_id": {
+ "$ref": "#/definitions/ThreadId"
+ }
+ },
+ "required": [
+ "depth",
+ "parent_thread_id"
+ ],
+ "type": "object"
+ }
+ },
+ "required": [
+ "thread_spawn"
+ ],
+ "title": "ThreadSpawnSubAgentSource",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "other": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "other"
+ ],
+ "title": "OtherSubAgentSource",
+ "type": "object"
+ }
+ ]
+ },
+ "TerminalInteractionNotification": {
+ "properties": {
+ "itemId": {
+ "type": "string"
+ },
+ "processId": {
+ "type": "string"
+ },
+ "stdin": {
+ "type": "string"
+ },
+ "threadId": {
+ "type": "string"
+ },
+ "turnId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "itemId",
+ "processId",
+ "stdin",
+ "threadId",
+ "turnId"
+ ],
+ "type": "object"
+ },
+ "TextContent": {
+ "description": "Text provided to or from an LLM.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "type": "object"
+ },
+ "TextElement": {
+ "properties": {
+ "byteRange": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ByteRange"
+ }
+ ],
+ "description": "Byte range in the parent `text` buffer that this element occupies."
+ },
+ "placeholder": {
+ "description": "Optional human-readable placeholder for the element, displayed in the UI.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "byteRange"
+ ],
+ "type": "object"
+ },
+ "TextElement2": {
+ "properties": {
+ "byte_range": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ByteRange2"
+ }
+ ],
+ "description": "Byte range in the parent `text` buffer that this element occupies."
+ },
+ "placeholder": {
+ "description": "Optional human-readable placeholder for the element, displayed in the UI.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "byte_range"
+ ],
+ "type": "object"
+ },
+ "TextPosition": {
+ "properties": {
+ "column": {
+ "description": "1-based column number (in Unicode scalar values).",
+ "format": "uint",
+ "minimum": 0.0,
+ "type": "integer"
+ },
+ "line": {
+ "description": "1-based line number.",
+ "format": "uint",
+ "minimum": 0.0,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "column",
+ "line"
+ ],
+ "type": "object"
+ },
+ "TextRange": {
+ "properties": {
+ "end": {
+ "$ref": "#/definitions/TextPosition"
+ },
+ "start": {
+ "$ref": "#/definitions/TextPosition"
+ }
+ },
+ "required": [
+ "end",
+ "start"
+ ],
+ "type": "object"
+ },
+ "TextResourceContents": {
+ "properties": {
+ "mimeType": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "text": {
+ "type": "string"
+ },
+ "uri": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "uri"
+ ],
+ "type": "object"
+ },
+ "Thread": {
+ "properties": {
+ "cliVersion": {
+ "description": "Version of the CLI that created the thread.",
+ "type": "string"
+ },
+ "createdAt": {
+ "description": "Unix timestamp (in seconds) when the thread was created.",
+ "format": "int64",
+ "type": "integer"
+ },
+ "cwd": {
+ "description": "Working directory captured for the thread.",
+ "type": "string"
+ },
+ "gitInfo": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/GitInfo"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Optional Git metadata captured when the thread was created."
+ },
+ "id": {
+ "type": "string"
+ },
+ "modelProvider": {
+ "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"
+ },
+ "source": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/SessionSource"
+ }
+ ],
+ "description": "Origin of the thread (CLI, VSCode, codex exec, codex app-server, etc.)."
+ },
+ "turns": {
+ "description": "Only populated on `thread/resume`, `thread/rollback`, `thread/fork`, and `thread/read` (when `includeTurns` is true) responses. For all other responses and notifications returning a Thread, the turns field will be an empty list.",
+ "items": {
+ "$ref": "#/definitions/Turn"
+ },
+ "type": "array"
+ },
+ "updatedAt": {
+ "description": "Unix timestamp (in seconds) when the thread was last updated.",
+ "format": "int64",
+ "type": "integer"
+ }
+ },
+ "required": [
+ "cliVersion",
+ "createdAt",
+ "cwd",
+ "id",
+ "modelProvider",
+ "preview",
+ "source",
+ "turns",
+ "updatedAt"
+ ],
+ "type": "object"
+ },
+ "ThreadId": {
+ "type": "string"
+ },
+ "ThreadItem": {
+ "oneOf": [
+ {
+ "properties": {
+ "content": {
+ "items": {
+ "$ref": "#/definitions/UserInput"
+ },
+ "type": "array"
+ },
+ "id": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "userMessage"
+ ],
+ "title": "UserMessageThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "content",
+ "id",
+ "type"
+ ],
+ "title": "UserMessageThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "agentMessage"
+ ],
+ "title": "AgentMessageThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "text",
+ "type"
+ ],
+ "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": {
+ "default": [],
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "id": {
+ "type": "string"
+ },
+ "summary": {
+ "default": [],
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "type": {
+ "enum": [
+ "reasoning"
+ ],
+ "title": "ReasoningThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "type"
+ ],
+ "title": "ReasoningThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "aggregatedOutput": {
+ "description": "The command's output, aggregated from stdout and stderr.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "command": {
+ "description": "The command to be executed.",
+ "type": "string"
+ },
+ "commandActions": {
+ "description": "A best-effort parsing of the command to understand the action(s) it will perform. This returns a list of CommandAction objects because a single shell command may be composed of many commands piped together.",
+ "items": {
+ "$ref": "#/definitions/CommandAction"
+ },
+ "type": "array"
+ },
+ "cwd": {
+ "description": "The command's working directory.",
+ "type": "string"
+ },
+ "durationMs": {
+ "description": "The duration of the command execution in milliseconds.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "exitCode": {
+ "description": "The command's exit code.",
+ "format": "int32",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "id": {
+ "type": "string"
+ },
+ "processId": {
+ "description": "Identifier for the underlying PTY process (when available).",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "status": {
+ "$ref": "#/definitions/CommandExecutionStatus"
+ },
+ "type": {
+ "enum": [
+ "commandExecution"
+ ],
+ "title": "CommandExecutionThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "command",
+ "commandActions",
+ "cwd",
+ "id",
+ "status",
+ "type"
+ ],
+ "title": "CommandExecutionThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "changes": {
+ "items": {
+ "$ref": "#/definitions/FileUpdateChange"
+ },
+ "type": "array"
+ },
+ "id": {
+ "type": "string"
+ },
+ "status": {
+ "$ref": "#/definitions/PatchApplyStatus"
+ },
+ "type": {
+ "enum": [
+ "fileChange"
+ ],
+ "title": "FileChangeThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "changes",
+ "id",
+ "status",
+ "type"
+ ],
+ "title": "FileChangeThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "arguments": true,
+ "durationMs": {
+ "description": "The duration of the MCP tool call in milliseconds.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "error": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/McpToolCallError"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "id": {
+ "type": "string"
+ },
+ "result": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/McpToolCallResult"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "server": {
+ "type": "string"
+ },
+ "status": {
+ "$ref": "#/definitions/McpToolCallStatus"
+ },
+ "tool": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "mcpToolCall"
+ ],
+ "title": "McpToolCallThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "arguments",
+ "id",
+ "server",
+ "status",
+ "tool",
+ "type"
+ ],
+ "title": "McpToolCallThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "agentsStates": {
+ "additionalProperties": {
+ "$ref": "#/definitions/CollabAgentState"
+ },
+ "description": "Last known status of the target agents, when available.",
+ "type": "object"
+ },
+ "id": {
+ "description": "Unique identifier for this collab tool call.",
+ "type": "string"
+ },
+ "prompt": {
+ "description": "Prompt text sent as part of the collab tool call, when available.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "receiverThreadIds": {
+ "description": "Thread ID of the receiving agent, when applicable. In case of spawn operation, this corresponds to the newly spawned agent.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "senderThreadId": {
+ "description": "Thread ID of the agent issuing the collab request.",
+ "type": "string"
+ },
+ "status": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/CollabAgentToolCallStatus"
+ }
+ ],
+ "description": "Current status of the collab tool call."
+ },
+ "tool": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/CollabAgentTool"
+ }
+ ],
+ "description": "Name of the collab tool that was invoked."
+ },
+ "type": {
+ "enum": [
+ "collabAgentToolCall"
+ ],
+ "title": "CollabAgentToolCallThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "agentsStates",
+ "id",
+ "receiverThreadIds",
+ "senderThreadId",
+ "status",
+ "tool",
+ "type"
+ ],
+ "title": "CollabAgentToolCallThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "action": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/WebSearchAction"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "id": {
+ "type": "string"
+ },
+ "query": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "webSearch"
+ ],
+ "title": "WebSearchThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "query",
+ "type"
+ ],
+ "title": "WebSearchThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "imageView"
+ ],
+ "title": "ImageViewThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "path",
+ "type"
+ ],
+ "title": "ImageViewThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "review": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "enteredReviewMode"
+ ],
+ "title": "EnteredReviewModeThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "review",
+ "type"
+ ],
+ "title": "EnteredReviewModeThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "review": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "exitedReviewMode"
+ ],
+ "title": "ExitedReviewModeThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "review",
+ "type"
+ ],
+ "title": "ExitedReviewModeThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "contextCompaction"
+ ],
+ "title": "ContextCompactionThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "type"
+ ],
+ "title": "ContextCompactionThreadItem",
+ "type": "object"
+ }
+ ]
+ },
+ "ThreadNameUpdatedNotification": {
+ "properties": {
+ "threadId": {
+ "type": "string"
+ },
+ "threadName": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "threadId"
+ ],
+ "type": "object"
+ },
+ "ThreadStartedNotification": {
+ "properties": {
+ "thread": {
+ "$ref": "#/definitions/Thread"
+ }
+ },
+ "required": [
+ "thread"
+ ],
+ "type": "object"
+ },
+ "ThreadTokenUsage": {
+ "properties": {
+ "last": {
+ "$ref": "#/definitions/TokenUsageBreakdown"
+ },
+ "modelContextWindow": {
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "total": {
+ "$ref": "#/definitions/TokenUsageBreakdown"
+ }
+ },
+ "required": [
+ "last",
+ "total"
+ ],
+ "type": "object"
+ },
+ "ThreadTokenUsageUpdatedNotification": {
+ "properties": {
+ "threadId": {
+ "type": "string"
+ },
+ "tokenUsage": {
+ "$ref": "#/definitions/ThreadTokenUsage"
+ },
+ "turnId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "threadId",
+ "tokenUsage",
+ "turnId"
+ ],
+ "type": "object"
+ },
+ "TokenUsage": {
+ "properties": {
+ "cached_input_tokens": {
+ "format": "int64",
+ "type": "integer"
+ },
+ "input_tokens": {
+ "format": "int64",
+ "type": "integer"
+ },
+ "output_tokens": {
+ "format": "int64",
+ "type": "integer"
+ },
+ "reasoning_output_tokens": {
+ "format": "int64",
+ "type": "integer"
+ },
+ "total_tokens": {
+ "format": "int64",
+ "type": "integer"
+ }
+ },
+ "required": [
+ "cached_input_tokens",
+ "input_tokens",
+ "output_tokens",
+ "reasoning_output_tokens",
+ "total_tokens"
+ ],
+ "type": "object"
+ },
+ "TokenUsageBreakdown": {
+ "properties": {
+ "cachedInputTokens": {
+ "format": "int64",
+ "type": "integer"
+ },
+ "inputTokens": {
+ "format": "int64",
+ "type": "integer"
+ },
+ "outputTokens": {
+ "format": "int64",
+ "type": "integer"
+ },
+ "reasoningOutputTokens": {
+ "format": "int64",
+ "type": "integer"
+ },
+ "totalTokens": {
+ "format": "int64",
+ "type": "integer"
+ }
+ },
+ "required": [
+ "cachedInputTokens",
+ "inputTokens",
+ "outputTokens",
+ "reasoningOutputTokens",
+ "totalTokens"
+ ],
+ "type": "object"
+ },
+ "TokenUsageInfo": {
+ "properties": {
+ "last_token_usage": {
+ "$ref": "#/definitions/TokenUsage"
+ },
+ "model_context_window": {
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "total_token_usage": {
+ "$ref": "#/definitions/TokenUsage"
+ }
+ },
+ "required": [
+ "last_token_usage",
+ "total_token_usage"
+ ],
+ "type": "object"
+ },
+ "Tool": {
+ "description": "Definition for a tool the client can call.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ToolAnnotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "description": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "inputSchema": {
+ "$ref": "#/definitions/ToolInputSchema"
+ },
+ "name": {
+ "type": "string"
+ },
+ "outputSchema": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ToolOutputSchema"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "title": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "inputSchema",
+ "name"
+ ],
+ "type": "object"
+ },
+ "ToolAnnotations": {
+ "description": "Additional properties describing a Tool to clients.\n\nNOTE: all properties in ToolAnnotations are **hints**. They are not guaranteed to provide a faithful description of tool behavior (including descriptive properties like `title`).\n\nClients should never make tool use decisions based on ToolAnnotations received from untrusted servers.",
+ "properties": {
+ "destructiveHint": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "idempotentHint": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "openWorldHint": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "readOnlyHint": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "title": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "ToolInputSchema": {
+ "description": "A JSON Schema object defining the expected parameters for the tool.",
+ "properties": {
+ "properties": true,
+ "required": {
+ "items": {
+ "type": "string"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "type": {
+ "default": "object",
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "ToolOutputSchema": {
+ "description": "An optional JSON Schema object defining the structure of the tool's output returned in the structuredContent field of a CallToolResult.",
+ "properties": {
+ "properties": true,
+ "required": {
+ "items": {
+ "type": "string"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "type": {
+ "default": "object",
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "Turn": {
+ "properties": {
+ "error": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/TurnError"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Only populated when the Turn's status is failed."
+ },
+ "id": {
+ "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.",
+ "items": {
+ "$ref": "#/definitions/ThreadItem"
+ },
+ "type": "array"
+ },
+ "status": {
+ "$ref": "#/definitions/TurnStatus"
+ }
+ },
+ "required": [
+ "id",
+ "items",
+ "status"
+ ],
+ "type": "object"
+ },
+ "TurnAbortReason": {
+ "enum": [
+ "interrupted",
+ "replaced",
+ "review_ended"
+ ],
+ "type": "string"
+ },
+ "TurnCompletedNotification": {
+ "properties": {
+ "threadId": {
+ "type": "string"
+ },
+ "turn": {
+ "$ref": "#/definitions/Turn"
+ }
+ },
+ "required": [
+ "threadId",
+ "turn"
+ ],
+ "type": "object"
+ },
+ "TurnDiffUpdatedNotification": {
+ "description": "Notification that the turn-level unified diff has changed. Contains the latest aggregated diff across all file changes in the turn.",
+ "properties": {
+ "diff": {
+ "type": "string"
+ },
+ "threadId": {
+ "type": "string"
+ },
+ "turnId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "diff",
+ "threadId",
+ "turnId"
+ ],
+ "type": "object"
+ },
+ "TurnError": {
+ "properties": {
+ "additionalDetails": {
+ "default": null,
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "codexErrorInfo": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/CodexErrorInfo"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "message": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "message"
+ ],
+ "type": "object"
+ },
+ "TurnItem": {
+ "oneOf": [
+ {
+ "properties": {
+ "content": {
+ "items": {
+ "$ref": "#/definitions/UserInput2"
+ },
+ "type": "array"
+ },
+ "id": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "UserMessage"
+ ],
+ "title": "UserMessageTurnItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "content",
+ "id",
+ "type"
+ ],
+ "title": "UserMessageTurnItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "content": {
+ "items": {
+ "$ref": "#/definitions/AgentMessageContent"
+ },
+ "type": "array"
+ },
+ "id": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "AgentMessage"
+ ],
+ "title": "AgentMessageTurnItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "content",
+ "id",
+ "type"
+ ],
+ "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": {
+ "type": "string"
+ },
+ "raw_content": {
+ "default": [],
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "summary_text": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "type": {
+ "enum": [
+ "Reasoning"
+ ],
+ "title": "ReasoningTurnItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "summary_text",
+ "type"
+ ],
+ "title": "ReasoningTurnItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "action": {
+ "$ref": "#/definitions/WebSearchAction2"
+ },
+ "id": {
+ "type": "string"
+ },
+ "query": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "WebSearch"
+ ],
+ "title": "WebSearchTurnItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "action",
+ "id",
+ "query",
+ "type"
+ ],
+ "title": "WebSearchTurnItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "ContextCompaction"
+ ],
+ "title": "ContextCompactionTurnItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "type"
+ ],
+ "title": "ContextCompactionTurnItem",
+ "type": "object"
+ }
+ ]
+ },
+ "TurnPlanStep": {
+ "properties": {
+ "status": {
+ "$ref": "#/definitions/TurnPlanStepStatus"
+ },
+ "step": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "status",
+ "step"
+ ],
+ "type": "object"
+ },
+ "TurnPlanStepStatus": {
+ "enum": [
+ "pending",
+ "inProgress",
+ "completed"
+ ],
+ "type": "string"
+ },
+ "TurnPlanUpdatedNotification": {
+ "properties": {
+ "explanation": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "plan": {
+ "items": {
+ "$ref": "#/definitions/TurnPlanStep"
+ },
+ "type": "array"
+ },
+ "threadId": {
+ "type": "string"
+ },
+ "turnId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "plan",
+ "threadId",
+ "turnId"
+ ],
+ "type": "object"
+ },
+ "TurnStartedNotification": {
+ "properties": {
+ "threadId": {
+ "type": "string"
+ },
+ "turn": {
+ "$ref": "#/definitions/Turn"
+ }
+ },
+ "required": [
+ "threadId",
+ "turn"
+ ],
+ "type": "object"
+ },
+ "TurnStatus": {
+ "enum": [
+ "completed",
+ "interrupted",
+ "failed",
+ "inProgress"
+ ],
+ "type": "string"
+ },
+ "UserInput": {
+ "oneOf": [
+ {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "text_elements": {
+ "default": [],
+ "description": "UI-defined spans within `text` used to render or persist special elements.",
+ "items": {
+ "$ref": "#/definitions/TextElement"
+ },
+ "type": "array"
+ },
+ "type": {
+ "enum": [
+ "text"
+ ],
+ "title": "TextUserInputType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "TextUserInput",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "image"
+ ],
+ "title": "ImageUserInputType",
+ "type": "string"
+ },
+ "url": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "url"
+ ],
+ "title": "ImageUserInput",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "localImage"
+ ],
+ "title": "LocalImageUserInputType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "path",
+ "type"
+ ],
+ "title": "LocalImageUserInput",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "name": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "skill"
+ ],
+ "title": "SkillUserInputType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "path",
+ "type"
+ ],
+ "title": "SkillUserInput",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "name": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "mention"
+ ],
+ "title": "MentionUserInputType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "path",
+ "type"
+ ],
+ "title": "MentionUserInput",
+ "type": "object"
+ }
+ ]
+ },
+ "UserInput2": {
+ "description": "User input",
+ "oneOf": [
+ {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "text_elements": {
+ "default": [],
+ "description": "UI-defined spans within `text` that should be treated as special elements. These are byte ranges into the UTF-8 `text` buffer and are used to render or persist rich input markers (e.g., image placeholders) across history and resume without mutating the literal text.",
+ "items": {
+ "$ref": "#/definitions/TextElement2"
+ },
+ "type": "array"
+ },
+ "type": {
+ "enum": [
+ "text"
+ ],
+ "title": "TextUserInput2Type",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "TextUserInput2",
+ "type": "object"
+ },
+ {
+ "description": "Pre‑encoded data: URI image.",
+ "properties": {
+ "image_url": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "image"
+ ],
+ "title": "ImageUserInput2Type",
+ "type": "string"
+ }
+ },
+ "required": [
+ "image_url",
+ "type"
+ ],
+ "title": "ImageUserInput2",
+ "type": "object"
+ },
+ {
+ "description": "Local image path provided by the user. This will be converted to an `Image` variant (base64 data URL) during request serialization.",
+ "properties": {
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "local_image"
+ ],
+ "title": "LocalImageUserInput2Type",
+ "type": "string"
+ }
+ },
+ "required": [
+ "path",
+ "type"
+ ],
+ "title": "LocalImageUserInput2",
+ "type": "object"
+ },
+ {
+ "description": "Skill selected by the user (name + path to SKILL.md).",
+ "properties": {
+ "name": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "skill"
+ ],
+ "title": "SkillUserInput2Type",
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "path",
+ "type"
+ ],
+ "title": "SkillUserInput2",
+ "type": "object"
+ },
+ {
+ "description": "Explicit mention selected by the user (name + app://connector id).",
+ "properties": {
+ "name": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "mention"
+ ],
+ "title": "MentionUserInput2Type",
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "path",
+ "type"
+ ],
+ "title": "MentionUserInput2",
+ "type": "object"
+ }
+ ]
+ },
+ "WebSearchAction": {
+ "oneOf": [
+ {
+ "properties": {
+ "queries": {
+ "items": {
+ "type": "string"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "query": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "search"
+ ],
+ "title": "SearchWebSearchActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "SearchWebSearchAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "openPage"
+ ],
+ "title": "OpenPageWebSearchActionType",
+ "type": "string"
+ },
+ "url": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "OpenPageWebSearchAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "pattern": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "findInPage"
+ ],
+ "title": "FindInPageWebSearchActionType",
+ "type": "string"
+ },
+ "url": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "FindInPageWebSearchAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "other"
+ ],
+ "title": "OtherWebSearchActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "OtherWebSearchAction",
+ "type": "object"
+ }
+ ]
+ },
+ "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": {
+ "format": "uint",
+ "minimum": 0.0,
+ "type": "integer"
+ },
+ "failedScan": {
+ "type": "boolean"
+ },
+ "samplePaths": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ }
+ },
+ "required": [
+ "extraCount",
+ "failedScan",
+ "samplePaths"
+ ],
+ "type": "object"
+ }
+ },
+ "description": "Notification sent from the server to the client.",
+ "oneOf": [
+ {
+ "description": "NEW NOTIFICATIONS",
+ "properties": {
+ "method": {
+ "enum": [
+ "error"
+ ],
+ "title": "ErrorNotificationMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/ErrorNotification"
+ }
+ },
+ "required": [
+ "method",
+ "params"
+ ],
+ "title": "ErrorNotification",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "method": {
+ "enum": [
+ "thread/started"
+ ],
+ "title": "Thread/startedNotificationMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/ThreadStartedNotification"
+ }
+ },
+ "required": [
+ "method",
+ "params"
+ ],
+ "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": {
+ "enum": [
+ "thread/tokenUsage/updated"
+ ],
+ "title": "Thread/tokenUsage/updatedNotificationMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/ThreadTokenUsageUpdatedNotification"
+ }
+ },
+ "required": [
+ "method",
+ "params"
+ ],
+ "title": "Thread/tokenUsage/updatedNotification",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "method": {
+ "enum": [
+ "turn/started"
+ ],
+ "title": "Turn/startedNotificationMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/TurnStartedNotification"
+ }
+ },
+ "required": [
+ "method",
+ "params"
+ ],
+ "title": "Turn/startedNotification",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "method": {
+ "enum": [
+ "turn/completed"
+ ],
+ "title": "Turn/completedNotificationMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/TurnCompletedNotification"
+ }
+ },
+ "required": [
+ "method",
+ "params"
+ ],
+ "title": "Turn/completedNotification",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "method": {
+ "enum": [
+ "turn/diff/updated"
+ ],
+ "title": "Turn/diff/updatedNotificationMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/TurnDiffUpdatedNotification"
+ }
+ },
+ "required": [
+ "method",
+ "params"
+ ],
+ "title": "Turn/diff/updatedNotification",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "method": {
+ "enum": [
+ "turn/plan/updated"
+ ],
+ "title": "Turn/plan/updatedNotificationMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/TurnPlanUpdatedNotification"
+ }
+ },
+ "required": [
+ "method",
+ "params"
+ ],
+ "title": "Turn/plan/updatedNotification",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "method": {
+ "enum": [
+ "item/started"
+ ],
+ "title": "Item/startedNotificationMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/ItemStartedNotification"
+ }
+ },
+ "required": [
+ "method",
+ "params"
+ ],
+ "title": "Item/startedNotification",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "method": {
+ "enum": [
+ "item/completed"
+ ],
+ "title": "Item/completedNotificationMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/ItemCompletedNotification"
+ }
+ },
+ "required": [
+ "method",
+ "params"
+ ],
+ "title": "Item/completedNotification",
+ "type": "object"
+ },
+ {
+ "description": "This event is internal-only. Used by Codex Cloud.",
+ "properties": {
+ "method": {
+ "enum": [
+ "rawResponseItem/completed"
+ ],
+ "title": "RawResponseItem/completedNotificationMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/RawResponseItemCompletedNotification"
+ }
+ },
+ "required": [
+ "method",
+ "params"
+ ],
+ "title": "RawResponseItem/completedNotification",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "method": {
+ "enum": [
+ "item/agentMessage/delta"
+ ],
+ "title": "Item/agentMessage/deltaNotificationMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/AgentMessageDeltaNotification"
+ }
+ },
+ "required": [
+ "method",
+ "params"
+ ],
+ "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": {
+ "enum": [
+ "item/commandExecution/outputDelta"
+ ],
+ "title": "Item/commandExecution/outputDeltaNotificationMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/CommandExecutionOutputDeltaNotification"
+ }
+ },
+ "required": [
+ "method",
+ "params"
+ ],
+ "title": "Item/commandExecution/outputDeltaNotification",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "method": {
+ "enum": [
+ "item/commandExecution/terminalInteraction"
+ ],
+ "title": "Item/commandExecution/terminalInteractionNotificationMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/TerminalInteractionNotification"
+ }
+ },
+ "required": [
+ "method",
+ "params"
+ ],
+ "title": "Item/commandExecution/terminalInteractionNotification",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "method": {
+ "enum": [
+ "item/fileChange/outputDelta"
+ ],
+ "title": "Item/fileChange/outputDeltaNotificationMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/FileChangeOutputDeltaNotification"
+ }
+ },
+ "required": [
+ "method",
+ "params"
+ ],
+ "title": "Item/fileChange/outputDeltaNotification",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "method": {
+ "enum": [
+ "item/mcpToolCall/progress"
+ ],
+ "title": "Item/mcpToolCall/progressNotificationMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/McpToolCallProgressNotification"
+ }
+ },
+ "required": [
+ "method",
+ "params"
+ ],
+ "title": "Item/mcpToolCall/progressNotification",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "method": {
+ "enum": [
+ "mcpServer/oauthLogin/completed"
+ ],
+ "title": "McpServer/oauthLogin/completedNotificationMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/McpServerOauthLoginCompletedNotification"
+ }
+ },
+ "required": [
+ "method",
+ "params"
+ ],
+ "title": "McpServer/oauthLogin/completedNotification",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "method": {
+ "enum": [
+ "account/updated"
+ ],
+ "title": "Account/updatedNotificationMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/AccountUpdatedNotification"
+ }
+ },
+ "required": [
+ "method",
+ "params"
+ ],
+ "title": "Account/updatedNotification",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "method": {
+ "enum": [
+ "account/rateLimits/updated"
+ ],
+ "title": "Account/rateLimits/updatedNotificationMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/AccountRateLimitsUpdatedNotification"
+ }
+ },
+ "required": [
+ "method",
+ "params"
+ ],
+ "title": "Account/rateLimits/updatedNotification",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "method": {
+ "enum": [
+ "item/reasoning/summaryTextDelta"
+ ],
+ "title": "Item/reasoning/summaryTextDeltaNotificationMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/ReasoningSummaryTextDeltaNotification"
+ }
+ },
+ "required": [
+ "method",
+ "params"
+ ],
+ "title": "Item/reasoning/summaryTextDeltaNotification",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "method": {
+ "enum": [
+ "item/reasoning/summaryPartAdded"
+ ],
+ "title": "Item/reasoning/summaryPartAddedNotificationMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/ReasoningSummaryPartAddedNotification"
+ }
+ },
+ "required": [
+ "method",
+ "params"
+ ],
+ "title": "Item/reasoning/summaryPartAddedNotification",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "method": {
+ "enum": [
+ "item/reasoning/textDelta"
+ ],
+ "title": "Item/reasoning/textDeltaNotificationMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/ReasoningTextDeltaNotification"
+ }
+ },
+ "required": [
+ "method",
+ "params"
+ ],
+ "title": "Item/reasoning/textDeltaNotification",
+ "type": "object"
+ },
+ {
+ "description": "Deprecated: Use `ContextCompaction` item type instead.",
+ "properties": {
+ "method": {
+ "enum": [
+ "thread/compacted"
+ ],
+ "title": "Thread/compactedNotificationMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/ContextCompactedNotification"
+ }
+ },
+ "required": [
+ "method",
+ "params"
+ ],
+ "title": "Thread/compactedNotification",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "method": {
+ "enum": [
+ "deprecationNotice"
+ ],
+ "title": "DeprecationNoticeNotificationMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/DeprecationNoticeNotification"
+ }
+ },
+ "required": [
+ "method",
+ "params"
+ ],
+ "title": "DeprecationNoticeNotification",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "method": {
+ "enum": [
+ "configWarning"
+ ],
+ "title": "ConfigWarningNotificationMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/ConfigWarningNotification"
+ }
+ },
+ "required": [
+ "method",
+ "params"
+ ],
+ "title": "ConfigWarningNotification",
+ "type": "object"
+ },
+ {
+ "description": "Notifies the user of world-writable directories on Windows, which cannot be protected by the sandbox.",
+ "properties": {
+ "method": {
+ "enum": [
+ "windows/worldWritableWarning"
+ ],
+ "title": "Windows/worldWritableWarningNotificationMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/WindowsWorldWritableWarningNotification"
+ }
+ },
+ "required": [
+ "method",
+ "params"
+ ],
+ "title": "Windows/worldWritableWarningNotification",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "method": {
+ "enum": [
+ "account/login/completed"
+ ],
+ "title": "Account/login/completedNotificationMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/AccountLoginCompletedNotification"
+ }
+ },
+ "required": [
+ "method",
+ "params"
+ ],
+ "title": "Account/login/completedNotification",
+ "type": "object"
+ },
+ {
+ "description": "DEPRECATED NOTIFICATIONS below",
+ "properties": {
+ "method": {
+ "enum": [
+ "authStatusChange"
+ ],
+ "title": "AuthStatusChangeNotificationMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/AuthStatusChangeNotification"
+ }
+ },
+ "required": [
+ "method",
+ "params"
+ ],
+ "title": "AuthStatusChangeNotification",
+ "type": "object"
+ },
+ {
+ "description": "Deprecated: use `account/login/completed` instead.",
+ "properties": {
+ "method": {
+ "enum": [
+ "loginChatGptComplete"
+ ],
+ "title": "LoginChatGptCompleteNotificationMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/LoginChatGptCompleteNotification"
+ }
+ },
+ "required": [
+ "method",
+ "params"
+ ],
+ "title": "LoginChatGptCompleteNotification",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "method": {
+ "enum": [
+ "sessionConfigured"
+ ],
+ "title": "SessionConfiguredNotificationMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/SessionConfiguredNotification"
+ }
+ },
+ "required": [
+ "method",
+ "params"
+ ],
+ "title": "SessionConfiguredNotification",
+ "type": "object"
+ }
+ ],
+ "title": "ServerNotification"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/ServerRequest.json b/codex-rs/app-server-protocol/schema/json/ServerRequest.json
new file mode 100644
index 0000000000..ad0c2e3542
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/ServerRequest.json
@@ -0,0 +1,792 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "definitions": {
+ "ApplyPatchApprovalParams": {
+ "properties": {
+ "callId": {
+ "description": "Use to correlate this with [codex_core::protocol::PatchApplyBeginEvent] and [codex_core::protocol::PatchApplyEndEvent].",
+ "type": "string"
+ },
+ "conversationId": {
+ "$ref": "#/definitions/ThreadId"
+ },
+ "fileChanges": {
+ "additionalProperties": {
+ "$ref": "#/definitions/FileChange"
+ },
+ "type": "object"
+ },
+ "grantRoot": {
+ "description": "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"
+ ]
+ },
+ "reason": {
+ "description": "Optional explanatory reason (e.g. request for extra write access).",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "callId",
+ "conversationId",
+ "fileChanges"
+ ],
+ "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": [
+ {
+ "properties": {
+ "command": {
+ "type": "string"
+ },
+ "name": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "read"
+ ],
+ "title": "ReadCommandActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "command",
+ "name",
+ "path",
+ "type"
+ ],
+ "title": "ReadCommandAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "command": {
+ "type": "string"
+ },
+ "path": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "listFiles"
+ ],
+ "title": "ListFilesCommandActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "command",
+ "type"
+ ],
+ "title": "ListFilesCommandAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "command": {
+ "type": "string"
+ },
+ "path": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "query": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "search"
+ ],
+ "title": "SearchCommandActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "command",
+ "type"
+ ],
+ "title": "SearchCommandAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "command": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "unknown"
+ ],
+ "title": "UnknownCommandActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "command",
+ "type"
+ ],
+ "title": "UnknownCommandAction",
+ "type": "object"
+ }
+ ]
+ },
+ "CommandExecutionRequestApprovalParams": {
+ "properties": {
+ "command": {
+ "description": "The command to be executed.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "commandActions": {
+ "description": "Best-effort parsed command actions for friendly display.",
+ "items": {
+ "$ref": "#/definitions/CommandAction"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "cwd": {
+ "description": "The command's working directory.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "itemId": {
+ "type": "string"
+ },
+ "proposedExecpolicyAmendment": {
+ "description": "Optional proposed execpolicy amendment to allow similar commands without prompting.",
+ "items": {
+ "type": "string"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "reason": {
+ "description": "Optional explanatory reason (e.g. request for network access).",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "threadId": {
+ "type": "string"
+ },
+ "turnId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "itemId",
+ "threadId",
+ "turnId"
+ ],
+ "type": "object"
+ },
+ "DynamicToolCallParams": {
+ "properties": {
+ "arguments": true,
+ "callId": {
+ "type": "string"
+ },
+ "threadId": {
+ "type": "string"
+ },
+ "tool": {
+ "type": "string"
+ },
+ "turnId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "arguments",
+ "callId",
+ "threadId",
+ "tool",
+ "turnId"
+ ],
+ "type": "object"
+ },
+ "ExecCommandApprovalParams": {
+ "properties": {
+ "callId": {
+ "description": "Use to correlate this with [codex_core::protocol::ExecCommandBeginEvent] and [codex_core::protocol::ExecCommandEndEvent].",
+ "type": "string"
+ },
+ "command": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "conversationId": {
+ "$ref": "#/definitions/ThreadId"
+ },
+ "cwd": {
+ "type": "string"
+ },
+ "parsedCmd": {
+ "items": {
+ "$ref": "#/definitions/ParsedCommand"
+ },
+ "type": "array"
+ },
+ "reason": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "callId",
+ "command",
+ "conversationId",
+ "cwd",
+ "parsedCmd"
+ ],
+ "type": "object"
+ },
+ "FileChange": {
+ "oneOf": [
+ {
+ "properties": {
+ "content": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "add"
+ ],
+ "title": "AddFileChangeType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "content",
+ "type"
+ ],
+ "title": "AddFileChange",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "content": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "delete"
+ ],
+ "title": "DeleteFileChangeType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "content",
+ "type"
+ ],
+ "title": "DeleteFileChange",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "move_path": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "update"
+ ],
+ "title": "UpdateFileChangeType",
+ "type": "string"
+ },
+ "unified_diff": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "unified_diff"
+ ],
+ "title": "UpdateFileChange",
+ "type": "object"
+ }
+ ]
+ },
+ "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"
+ },
+ "reason": {
+ "description": "Optional explanatory reason (e.g. request for extra write access).",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "threadId": {
+ "type": "string"
+ },
+ "turnId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "itemId",
+ "threadId",
+ "turnId"
+ ],
+ "type": "object"
+ },
+ "ParsedCommand": {
+ "oneOf": [
+ {
+ "properties": {
+ "cmd": {
+ "type": "string"
+ },
+ "name": {
+ "type": "string"
+ },
+ "path": {
+ "description": "(Best effort) Path to the file being read by the command. When possible, this is an absolute path, though when relative, it should be resolved against the `cwd`` that will be used to run the command to derive the absolute path.",
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "read"
+ ],
+ "title": "ReadParsedCommandType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "cmd",
+ "name",
+ "path",
+ "type"
+ ],
+ "title": "ReadParsedCommand",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "cmd": {
+ "type": "string"
+ },
+ "path": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "list_files"
+ ],
+ "title": "ListFilesParsedCommandType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "cmd",
+ "type"
+ ],
+ "title": "ListFilesParsedCommand",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "cmd": {
+ "type": "string"
+ },
+ "path": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "query": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "search"
+ ],
+ "title": "SearchParsedCommandType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "cmd",
+ "type"
+ ],
+ "title": "SearchParsedCommand",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "cmd": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "unknown"
+ ],
+ "title": "UnknownParsedCommandType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "cmd",
+ "type"
+ ],
+ "title": "UnknownParsedCommand",
+ "type": "object"
+ }
+ ]
+ },
+ "RequestId": {
+ "anyOf": [
+ {
+ "type": "string"
+ },
+ {
+ "format": "int64",
+ "type": "integer"
+ }
+ ]
+ },
+ "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.",
+ "oneOf": [
+ {
+ "description": "NEW APIs Sent when approval is requested for a specific command execution. This request is used for Turns started via turn/start.",
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "item/commandExecution/requestApproval"
+ ],
+ "title": "Item/commandExecution/requestApprovalRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/CommandExecutionRequestApprovalParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "title": "Item/commandExecution/requestApprovalRequest",
+ "type": "object"
+ },
+ {
+ "description": "Sent when approval is requested for a specific file change. This request is used for Turns started via turn/start.",
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "item/fileChange/requestApproval"
+ ],
+ "title": "Item/fileChange/requestApprovalRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/FileChangeRequestApprovalParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "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": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "item/tool/call"
+ ],
+ "title": "Item/tool/callRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/DynamicToolCallParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "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": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "applyPatchApproval"
+ ],
+ "title": "ApplyPatchApprovalRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/ApplyPatchApprovalParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "title": "ApplyPatchApprovalRequest",
+ "type": "object"
+ },
+ {
+ "description": "Request to exec a command. This request is used for Turns started via the legacy APIs (i.e. SendUserTurn, SendUserMessage).",
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "execCommandApproval"
+ ],
+ "title": "ExecCommandApprovalRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/ExecCommandApprovalParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "title": "ExecCommandApprovalRequest",
+ "type": "object"
+ }
+ ],
+ "title": "ServerRequest"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/ToolRequestUserInputParams.json b/codex-rs/app-server-protocol/schema/json/ToolRequestUserInputParams.json
new file mode 100644
index 0000000000..153d3bad67
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/ToolRequestUserInputParams.json
@@ -0,0 +1,84 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "definitions": {
+ "ToolRequestUserInputOption": {
+ "description": "EXPERIMENTAL. Defines a single selectable option for request_user_input.",
+ "properties": {
+ "description": {
+ "type": "string"
+ },
+ "label": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "description",
+ "label"
+ ],
+ "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": "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"
+ ],
+ "title": "ToolRequestUserInputParams",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/ToolRequestUserInputResponse.json b/codex-rs/app-server-protocol/schema/json/ToolRequestUserInputResponse.json
new file mode 100644
index 0000000000..3fd6fbc335
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/ToolRequestUserInputResponse.json
@@ -0,0 +1,34 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "definitions": {
+ "ToolRequestUserInputAnswer": {
+ "description": "EXPERIMENTAL. Captures a user's answer to a request_user_input question.",
+ "properties": {
+ "answers": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ }
+ },
+ "required": [
+ "answers"
+ ],
+ "type": "object"
+ }
+ },
+ "description": "EXPERIMENTAL. Response payload mapping question ids to answers.",
+ "properties": {
+ "answers": {
+ "additionalProperties": {
+ "$ref": "#/definitions/ToolRequestUserInputAnswer"
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "answers"
+ ],
+ "title": "ToolRequestUserInputResponse",
+ "type": "object"
+}
\ No newline at end of file
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
new file mode 100644
index 0000000000..aca840f6cb
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/codex_app_server_protocol.schemas.json
@@ -0,0 +1,16233 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "definitions": {
+ "AbsolutePathBuf": {
+ "description": "A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem).\n\nIMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set, the deserialization will fail unless the path being deserialized is already absolute.",
+ "type": "string"
+ },
+ "AddConversationListenerParams": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "conversationId": {
+ "$ref": "#/definitions/ThreadId"
+ },
+ "experimentalRawEvents": {
+ "default": false,
+ "type": "boolean"
+ }
+ },
+ "required": [
+ "conversationId"
+ ],
+ "title": "AddConversationListenerParams",
+ "type": "object"
+ },
+ "AddConversationSubscriptionResponse": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "subscriptionId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "subscriptionId"
+ ],
+ "title": "AddConversationSubscriptionResponse",
+ "type": "object"
+ },
+ "AgentMessageContent": {
+ "oneOf": [
+ {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "Text"
+ ],
+ "title": "TextAgentMessageContentType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "TextAgentMessageContent",
+ "type": "object"
+ }
+ ]
+ },
+ "AgentStatus": {
+ "description": "Agent lifecycle status, derived from emitted events.",
+ "oneOf": [
+ {
+ "description": "Agent is waiting for initialization.",
+ "enum": [
+ "pending_init"
+ ],
+ "type": "string"
+ },
+ {
+ "description": "Agent is currently running.",
+ "enum": [
+ "running"
+ ],
+ "type": "string"
+ },
+ {
+ "additionalProperties": false,
+ "description": "Agent is done. Contains the final assistant message.",
+ "properties": {
+ "completed": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "completed"
+ ],
+ "title": "CompletedAgentStatus",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "Agent encountered an error.",
+ "properties": {
+ "errored": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "errored"
+ ],
+ "title": "ErroredAgentStatus",
+ "type": "object"
+ },
+ {
+ "description": "Agent has been shutdown.",
+ "enum": [
+ "shutdown"
+ ],
+ "type": "string"
+ },
+ {
+ "description": "Agent is not found.",
+ "enum": [
+ "not_found"
+ ],
+ "type": "string"
+ }
+ ]
+ },
+ "Annotations": {
+ "description": "Optional annotations for the client. The client can use annotations to inform how objects are used or displayed",
+ "properties": {
+ "audience": {
+ "items": {
+ "$ref": "#/definitions/Role"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "lastModified": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "priority": {
+ "format": "double",
+ "type": [
+ "number",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "ApplyPatchApprovalParams": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "callId": {
+ "description": "Use to correlate this with [codex_core::protocol::PatchApplyBeginEvent] and [codex_core::protocol::PatchApplyEndEvent].",
+ "type": "string"
+ },
+ "conversationId": {
+ "$ref": "#/definitions/v2/ThreadId"
+ },
+ "fileChanges": {
+ "additionalProperties": {
+ "$ref": "#/definitions/FileChange"
+ },
+ "type": "object"
+ },
+ "grantRoot": {
+ "description": "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"
+ ]
+ },
+ "reason": {
+ "description": "Optional explanatory reason (e.g. request for extra write access).",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "callId",
+ "conversationId",
+ "fileChanges"
+ ],
+ "title": "ApplyPatchApprovalParams",
+ "type": "object"
+ },
+ "ApplyPatchApprovalResponse": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "decision": {
+ "$ref": "#/definitions/ReviewDecision"
+ }
+ },
+ "required": [
+ "decision"
+ ],
+ "title": "ApplyPatchApprovalResponse",
+ "type": "object"
+ },
+ "ArchiveConversationParams": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "conversationId": {
+ "$ref": "#/definitions/ThreadId"
+ },
+ "rolloutPath": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "conversationId",
+ "rolloutPath"
+ ],
+ "title": "ArchiveConversationParams",
+ "type": "object"
+ },
+ "ArchiveConversationResponse": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "title": "ArchiveConversationResponse",
+ "type": "object"
+ },
+ "AskForApproval": {
+ "description": "Determines the conditions under which the user is consulted to approve running the command proposed by Codex.",
+ "oneOf": [
+ {
+ "description": "Under this policy, only \"known safe\" commands—as determined by `is_safe_command()`—that **only read files** are auto‑approved. Everything else will ask the user to approve.",
+ "enum": [
+ "untrusted"
+ ],
+ "type": "string"
+ },
+ {
+ "description": "*All* commands are auto‑approved, but they are expected to run inside a sandbox where network access is disabled and writes are confined to a specific set of paths. If the command fails, it will be escalated to the user to approve execution without a sandbox.",
+ "enum": [
+ "on-failure"
+ ],
+ "type": "string"
+ },
+ {
+ "description": "The model decides when to ask the user for approval.",
+ "enum": [
+ "on-request"
+ ],
+ "type": "string"
+ },
+ {
+ "description": "Never ask the user to approve commands. Failures are immediately returned to the model, and never escalated to the user for approval.",
+ "enum": [
+ "never"
+ ],
+ "type": "string"
+ }
+ ]
+ },
+ "AudioContent": {
+ "description": "Audio provided to or from an LLM.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "data": {
+ "type": "string"
+ },
+ "mimeType": {
+ "type": "string"
+ },
+ "type": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "data",
+ "mimeType",
+ "type"
+ ],
+ "type": "object"
+ },
+ "AuthMode": {
+ "description": "Authentication mode for OpenAI-backed providers.",
+ "oneOf": [
+ {
+ "description": "OpenAI API key provided by the caller and stored by Codex.",
+ "enum": [
+ "apikey"
+ ],
+ "type": "string"
+ },
+ {
+ "description": "ChatGPT OAuth managed by Codex (tokens persisted and refreshed by Codex).",
+ "enum": [
+ "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"
+ }
+ ]
+ },
+ "AuthStatusChangeNotification": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "description": "Deprecated notification. Use AccountUpdatedNotification instead.",
+ "properties": {
+ "authMethod": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/AuthMode"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ }
+ },
+ "title": "AuthStatusChangeNotification",
+ "type": "object"
+ },
+ "BlobResourceContents": {
+ "properties": {
+ "blob": {
+ "type": "string"
+ },
+ "mimeType": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "uri": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "blob",
+ "uri"
+ ],
+ "type": "object"
+ },
+ "ByteRange": {
+ "properties": {
+ "end": {
+ "description": "End byte offset (exclusive) within the UTF-8 text buffer.",
+ "format": "uint",
+ "minimum": 0.0,
+ "type": "integer"
+ },
+ "start": {
+ "description": "Start byte offset (inclusive) within the UTF-8 text buffer.",
+ "format": "uint",
+ "minimum": 0.0,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "end",
+ "start"
+ ],
+ "type": "object"
+ },
+ "CallToolResult": {
+ "description": "The server's response to a tool call.",
+ "properties": {
+ "content": {
+ "items": {
+ "$ref": "#/definitions/ContentBlock"
+ },
+ "type": "array"
+ },
+ "isError": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "structuredContent": true
+ },
+ "required": [
+ "content"
+ ],
+ "type": "object"
+ },
+ "CancelLoginChatGptParams": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "loginId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "loginId"
+ ],
+ "title": "CancelLoginChatGptParams",
+ "type": "object"
+ },
+ "CancelLoginChatGptResponse": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "title": "CancelLoginChatGptResponse",
+ "type": "object"
+ },
+ "ChatgptAuthTokensRefreshParams": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "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"
+ ],
+ "title": "ChatgptAuthTokensRefreshParams",
+ "type": "object"
+ },
+ "ChatgptAuthTokensRefreshReason": {
+ "oneOf": [
+ {
+ "description": "Codex attempted a backend request and received `401 Unauthorized`.",
+ "enum": [
+ "unauthorized"
+ ],
+ "type": "string"
+ }
+ ]
+ },
+ "ChatgptAuthTokensRefreshResponse": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "accessToken": {
+ "type": "string"
+ },
+ "idToken": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "accessToken",
+ "idToken"
+ ],
+ "title": "ChatgptAuthTokensRefreshResponse",
+ "type": "object"
+ },
+ "ClientInfo": {
+ "properties": {
+ "name": {
+ "type": "string"
+ },
+ "title": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "version": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "version"
+ ],
+ "type": "object"
+ },
+ "ClientNotification": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "oneOf": [
+ {
+ "properties": {
+ "method": {
+ "enum": [
+ "initialized"
+ ],
+ "title": "InitializedNotificationMethod",
+ "type": "string"
+ }
+ },
+ "required": [
+ "method"
+ ],
+ "title": "InitializedNotification",
+ "type": "object"
+ }
+ ],
+ "title": "ClientNotification"
+ },
+ "ClientRequest": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "description": "Request from the client to the server.",
+ "oneOf": [
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "initialize"
+ ],
+ "title": "InitializeRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/InitializeParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "title": "InitializeRequest",
+ "type": "object"
+ },
+ {
+ "description": "NEW APIs",
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "thread/start"
+ ],
+ "title": "Thread/startRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/v2/ThreadStartParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "title": "Thread/startRequest",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "thread/resume"
+ ],
+ "title": "Thread/resumeRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/v2/ThreadResumeParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "title": "Thread/resumeRequest",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "thread/fork"
+ ],
+ "title": "Thread/forkRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/v2/ThreadForkParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "title": "Thread/forkRequest",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "thread/archive"
+ ],
+ "title": "Thread/archiveRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/v2/ThreadArchiveParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "title": "Thread/archiveRequest",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "thread/name/set"
+ ],
+ "title": "Thread/name/setRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/v2/ThreadSetNameParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "title": "Thread/name/setRequest",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "thread/unarchive"
+ ],
+ "title": "Thread/unarchiveRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/v2/ThreadUnarchiveParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "title": "Thread/unarchiveRequest",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "thread/rollback"
+ ],
+ "title": "Thread/rollbackRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/v2/ThreadRollbackParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "title": "Thread/rollbackRequest",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "thread/list"
+ ],
+ "title": "Thread/listRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/v2/ThreadListParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "title": "Thread/listRequest",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "thread/loaded/list"
+ ],
+ "title": "Thread/loaded/listRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/v2/ThreadLoadedListParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "title": "Thread/loaded/listRequest",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "thread/read"
+ ],
+ "title": "Thread/readRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/v2/ThreadReadParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "title": "Thread/readRequest",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "skills/list"
+ ],
+ "title": "Skills/listRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/v2/SkillsListParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "title": "Skills/listRequest",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "app/list"
+ ],
+ "title": "App/listRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/v2/AppsListParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "title": "App/listRequest",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "skills/config/write"
+ ],
+ "title": "Skills/config/writeRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/v2/SkillsConfigWriteParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "title": "Skills/config/writeRequest",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "turn/start"
+ ],
+ "title": "Turn/startRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/v2/TurnStartParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "title": "Turn/startRequest",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "turn/interrupt"
+ ],
+ "title": "Turn/interruptRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/v2/TurnInterruptParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "title": "Turn/interruptRequest",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "review/start"
+ ],
+ "title": "Review/startRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/v2/ReviewStartParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "title": "Review/startRequest",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "model/list"
+ ],
+ "title": "Model/listRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/v2/ModelListParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "title": "Model/listRequest",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "mcpServer/oauth/login"
+ ],
+ "title": "McpServer/oauth/loginRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/v2/McpServerOauthLoginParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "title": "McpServer/oauth/loginRequest",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "config/mcpServer/reload"
+ ],
+ "title": "Config/mcpServer/reloadRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "type": "null"
+ }
+ },
+ "required": [
+ "id",
+ "method"
+ ],
+ "title": "Config/mcpServer/reloadRequest",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "mcpServerStatus/list"
+ ],
+ "title": "McpServerStatus/listRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/v2/ListMcpServerStatusParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "title": "McpServerStatus/listRequest",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "account/login/start"
+ ],
+ "title": "Account/login/startRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/v2/LoginAccountParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "title": "Account/login/startRequest",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "account/login/cancel"
+ ],
+ "title": "Account/login/cancelRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/v2/CancelLoginAccountParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "title": "Account/login/cancelRequest",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "account/logout"
+ ],
+ "title": "Account/logoutRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "type": "null"
+ }
+ },
+ "required": [
+ "id",
+ "method"
+ ],
+ "title": "Account/logoutRequest",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "account/rateLimits/read"
+ ],
+ "title": "Account/rateLimits/readRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "type": "null"
+ }
+ },
+ "required": [
+ "id",
+ "method"
+ ],
+ "title": "Account/rateLimits/readRequest",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "feedback/upload"
+ ],
+ "title": "Feedback/uploadRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/v2/FeedbackUploadParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "title": "Feedback/uploadRequest",
+ "type": "object"
+ },
+ {
+ "description": "Execute a command (argv vector) under the server's sandbox.",
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "command/exec"
+ ],
+ "title": "Command/execRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/v2/CommandExecParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "title": "Command/execRequest",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "config/read"
+ ],
+ "title": "Config/readRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/v2/ConfigReadParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "title": "Config/readRequest",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "config/value/write"
+ ],
+ "title": "Config/value/writeRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/v2/ConfigValueWriteParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "title": "Config/value/writeRequest",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "config/batchWrite"
+ ],
+ "title": "Config/batchWriteRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/v2/ConfigBatchWriteParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "title": "Config/batchWriteRequest",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "configRequirements/read"
+ ],
+ "title": "ConfigRequirements/readRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "type": "null"
+ }
+ },
+ "required": [
+ "id",
+ "method"
+ ],
+ "title": "ConfigRequirements/readRequest",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "account/read"
+ ],
+ "title": "Account/readRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/v2/GetAccountParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "title": "Account/readRequest",
+ "type": "object"
+ },
+ {
+ "description": "DEPRECATED APIs below",
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "newConversation"
+ ],
+ "title": "NewConversationRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/NewConversationParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "title": "NewConversationRequest",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "getConversationSummary"
+ ],
+ "title": "GetConversationSummaryRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/GetConversationSummaryParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "title": "GetConversationSummaryRequest",
+ "type": "object"
+ },
+ {
+ "description": "List recorded Codex conversations (rollouts) with optional pagination and search.",
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "listConversations"
+ ],
+ "title": "ListConversationsRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/ListConversationsParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "title": "ListConversationsRequest",
+ "type": "object"
+ },
+ {
+ "description": "Resume a recorded Codex conversation from a rollout file.",
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "resumeConversation"
+ ],
+ "title": "ResumeConversationRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/ResumeConversationParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "title": "ResumeConversationRequest",
+ "type": "object"
+ },
+ {
+ "description": "Fork a recorded Codex conversation into a new session.",
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "forkConversation"
+ ],
+ "title": "ForkConversationRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/ForkConversationParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "title": "ForkConversationRequest",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "archiveConversation"
+ ],
+ "title": "ArchiveConversationRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/ArchiveConversationParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "title": "ArchiveConversationRequest",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "sendUserMessage"
+ ],
+ "title": "SendUserMessageRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/SendUserMessageParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "title": "SendUserMessageRequest",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "sendUserTurn"
+ ],
+ "title": "SendUserTurnRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/SendUserTurnParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "title": "SendUserTurnRequest",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "interruptConversation"
+ ],
+ "title": "InterruptConversationRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/InterruptConversationParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "title": "InterruptConversationRequest",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "addConversationListener"
+ ],
+ "title": "AddConversationListenerRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/AddConversationListenerParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "title": "AddConversationListenerRequest",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "removeConversationListener"
+ ],
+ "title": "RemoveConversationListenerRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/RemoveConversationListenerParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "title": "RemoveConversationListenerRequest",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "gitDiffToRemote"
+ ],
+ "title": "GitDiffToRemoteRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/GitDiffToRemoteParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "title": "GitDiffToRemoteRequest",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "loginApiKey"
+ ],
+ "title": "LoginApiKeyRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/LoginApiKeyParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "title": "LoginApiKeyRequest",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "loginChatGpt"
+ ],
+ "title": "LoginChatGptRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "type": "null"
+ }
+ },
+ "required": [
+ "id",
+ "method"
+ ],
+ "title": "LoginChatGptRequest",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "cancelLoginChatGpt"
+ ],
+ "title": "CancelLoginChatGptRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/CancelLoginChatGptParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "title": "CancelLoginChatGptRequest",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "logoutChatGpt"
+ ],
+ "title": "LogoutChatGptRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "type": "null"
+ }
+ },
+ "required": [
+ "id",
+ "method"
+ ],
+ "title": "LogoutChatGptRequest",
+ "type": "object"
+ },
+ {
+ "description": "DEPRECATED in favor of GetAccount",
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "getAuthStatus"
+ ],
+ "title": "GetAuthStatusRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/GetAuthStatusParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "title": "GetAuthStatusRequest",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "getUserSavedConfig"
+ ],
+ "title": "GetUserSavedConfigRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "type": "null"
+ }
+ },
+ "required": [
+ "id",
+ "method"
+ ],
+ "title": "GetUserSavedConfigRequest",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "setDefaultModel"
+ ],
+ "title": "SetDefaultModelRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/SetDefaultModelParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "title": "SetDefaultModelRequest",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "getUserAgent"
+ ],
+ "title": "GetUserAgentRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "type": "null"
+ }
+ },
+ "required": [
+ "id",
+ "method"
+ ],
+ "title": "GetUserAgentRequest",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "userInfo"
+ ],
+ "title": "UserInfoRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "type": "null"
+ }
+ },
+ "required": [
+ "id",
+ "method"
+ ],
+ "title": "UserInfoRequest",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "fuzzyFileSearch"
+ ],
+ "title": "FuzzyFileSearchRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/FuzzyFileSearchParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "title": "FuzzyFileSearchRequest",
+ "type": "object"
+ },
+ {
+ "description": "Execute a command (argv vector) under the server's sandbox.",
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "execOneOffCommand"
+ ],
+ "title": "ExecOneOffCommandRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/ExecOneOffCommandParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "title": "ExecOneOffCommandRequest",
+ "type": "object"
+ }
+ ],
+ "title": "ClientRequest"
+ },
+ "CodexErrorInfo": {
+ "description": "Codex errors that we expose to clients.",
+ "oneOf": [
+ {
+ "enum": [
+ "context_window_exceeded",
+ "usage_limit_exceeded",
+ "internal_server_error",
+ "unauthorized",
+ "bad_request",
+ "sandbox_error",
+ "thread_rollback_failed",
+ "other"
+ ],
+ "type": "string"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "model_cap": {
+ "properties": {
+ "model": {
+ "type": "string"
+ },
+ "reset_after_seconds": {
+ "format": "uint64",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "model"
+ ],
+ "type": "object"
+ }
+ },
+ "required": [
+ "model_cap"
+ ],
+ "title": "ModelCapCodexErrorInfo",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "http_connection_failed": {
+ "properties": {
+ "http_status_code": {
+ "format": "uint16",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "http_connection_failed"
+ ],
+ "title": "HttpConnectionFailedCodexErrorInfo",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "Failed to connect to the response SSE stream.",
+ "properties": {
+ "response_stream_connection_failed": {
+ "properties": {
+ "http_status_code": {
+ "format": "uint16",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "response_stream_connection_failed"
+ ],
+ "title": "ResponseStreamConnectionFailedCodexErrorInfo",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "The response SSE stream disconnected in the middle of a turnbefore completion.",
+ "properties": {
+ "response_stream_disconnected": {
+ "properties": {
+ "http_status_code": {
+ "format": "uint16",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "response_stream_disconnected"
+ ],
+ "title": "ResponseStreamDisconnectedCodexErrorInfo",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "Reached the retry limit for responses.",
+ "properties": {
+ "response_too_many_failed_attempts": {
+ "properties": {
+ "http_status_code": {
+ "format": "uint16",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "response_too_many_failed_attempts"
+ ],
+ "title": "ResponseTooManyFailedAttemptsCodexErrorInfo",
+ "type": "object"
+ }
+ ]
+ },
+ "CommandExecutionApprovalDecision": {
+ "oneOf": [
+ {
+ "description": "User approved the command.",
+ "enum": [
+ "accept"
+ ],
+ "type": "string"
+ },
+ {
+ "description": "User approved the command and future identical commands should run without prompting.",
+ "enum": [
+ "acceptForSession"
+ ],
+ "type": "string"
+ },
+ {
+ "additionalProperties": false,
+ "description": "User approved the command, and wants to apply the proposed execpolicy amendment so future matching commands can run without prompting.",
+ "properties": {
+ "acceptWithExecpolicyAmendment": {
+ "properties": {
+ "execpolicy_amendment": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ }
+ },
+ "required": [
+ "execpolicy_amendment"
+ ],
+ "type": "object"
+ }
+ },
+ "required": [
+ "acceptWithExecpolicyAmendment"
+ ],
+ "title": "AcceptWithExecpolicyAmendmentCommandExecutionApprovalDecision",
+ "type": "object"
+ },
+ {
+ "description": "User denied the command. The agent will continue the turn.",
+ "enum": [
+ "decline"
+ ],
+ "type": "string"
+ },
+ {
+ "description": "User denied the command. The turn will also be immediately interrupted.",
+ "enum": [
+ "cancel"
+ ],
+ "type": "string"
+ }
+ ]
+ },
+ "CommandExecutionRequestApprovalParams": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "command": {
+ "description": "The command to be executed.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "commandActions": {
+ "description": "Best-effort parsed command actions for friendly display.",
+ "items": {
+ "$ref": "#/definitions/v2/CommandAction"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "cwd": {
+ "description": "The command's working directory.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "itemId": {
+ "type": "string"
+ },
+ "proposedExecpolicyAmendment": {
+ "description": "Optional proposed execpolicy amendment to allow similar commands without prompting.",
+ "items": {
+ "type": "string"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "reason": {
+ "description": "Optional explanatory reason (e.g. request for network access).",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "threadId": {
+ "type": "string"
+ },
+ "turnId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "itemId",
+ "threadId",
+ "turnId"
+ ],
+ "title": "CommandExecutionRequestApprovalParams",
+ "type": "object"
+ },
+ "CommandExecutionRequestApprovalResponse": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "decision": {
+ "$ref": "#/definitions/CommandExecutionApprovalDecision"
+ }
+ },
+ "required": [
+ "decision"
+ ],
+ "title": "CommandExecutionRequestApprovalResponse",
+ "type": "object"
+ },
+ "ContentBlock": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/TextContent"
+ },
+ {
+ "$ref": "#/definitions/ImageContent"
+ },
+ {
+ "$ref": "#/definitions/AudioContent"
+ },
+ {
+ "$ref": "#/definitions/ResourceLink"
+ },
+ {
+ "$ref": "#/definitions/EmbeddedResource"
+ }
+ ]
+ },
+ "ContentItem": {
+ "oneOf": [
+ {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "input_text"
+ ],
+ "title": "InputTextContentItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "InputTextContentItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "image_url": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "input_image"
+ ],
+ "title": "InputImageContentItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "image_url",
+ "type"
+ ],
+ "title": "InputImageContentItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "output_text"
+ ],
+ "title": "OutputTextContentItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "OutputTextContentItem",
+ "type": "object"
+ }
+ ]
+ },
+ "ConversationGitInfo": {
+ "properties": {
+ "branch": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "origin_url": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "sha": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "ConversationSummary": {
+ "properties": {
+ "cliVersion": {
+ "type": "string"
+ },
+ "conversationId": {
+ "$ref": "#/definitions/ThreadId"
+ },
+ "cwd": {
+ "type": "string"
+ },
+ "gitInfo": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ConversationGitInfo"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "modelProvider": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "preview": {
+ "type": "string"
+ },
+ "source": {
+ "$ref": "#/definitions/SessionSource"
+ },
+ "timestamp": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "updatedAt": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "cliVersion",
+ "conversationId",
+ "cwd",
+ "modelProvider",
+ "path",
+ "preview",
+ "source"
+ ],
+ "type": "object"
+ },
+ "CreditsSnapshot": {
+ "properties": {
+ "balance": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "has_credits": {
+ "type": "boolean"
+ },
+ "unlimited": {
+ "type": "boolean"
+ }
+ },
+ "required": [
+ "has_credits",
+ "unlimited"
+ ],
+ "type": "object"
+ },
+ "CustomPrompt": {
+ "properties": {
+ "argument_hint": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "content": {
+ "type": "string"
+ },
+ "description": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "name": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "content",
+ "name",
+ "path"
+ ],
+ "type": "object"
+ },
+ "Duration": {
+ "properties": {
+ "nanos": {
+ "format": "uint32",
+ "minimum": 0.0,
+ "type": "integer"
+ },
+ "secs": {
+ "format": "uint64",
+ "minimum": 0.0,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "nanos",
+ "secs"
+ ],
+ "type": "object"
+ },
+ "DynamicToolCallParams": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "arguments": true,
+ "callId": {
+ "type": "string"
+ },
+ "threadId": {
+ "type": "string"
+ },
+ "tool": {
+ "type": "string"
+ },
+ "turnId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "arguments",
+ "callId",
+ "threadId",
+ "tool",
+ "turnId"
+ ],
+ "title": "DynamicToolCallParams",
+ "type": "object"
+ },
+ "DynamicToolCallResponse": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "output": {
+ "type": "string"
+ },
+ "success": {
+ "type": "boolean"
+ }
+ },
+ "required": [
+ "output",
+ "success"
+ ],
+ "title": "DynamicToolCallResponse",
+ "type": "object"
+ },
+ "EmbeddedResource": {
+ "description": "The contents of a resource, embedded into a prompt or tool call result.\n\nIt is up to the client how best to render embedded resources for the benefit of the LLM and/or the user.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "resource": {
+ "$ref": "#/definitions/EmbeddedResourceResource"
+ },
+ "type": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "resource",
+ "type"
+ ],
+ "type": "object"
+ },
+ "EmbeddedResourceResource": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/TextResourceContents"
+ },
+ {
+ "$ref": "#/definitions/BlobResourceContents"
+ }
+ ]
+ },
+ "EventMsg": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "description": "Response event from the agent NOTE: Make sure none of these values have optional types, as it will mess up the extension code-gen.",
+ "oneOf": [
+ {
+ "description": "Error while executing a submission",
+ "properties": {
+ "codex_error_info": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/v2/CodexErrorInfo"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "default": null
+ },
+ "message": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "error"
+ ],
+ "title": "ErrorEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "message",
+ "type"
+ ],
+ "title": "ErrorEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Warning issued while processing a submission. Unlike `Error`, this indicates the turn continued but the user should still be notified.",
+ "properties": {
+ "message": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "warning"
+ ],
+ "title": "WarningEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "message",
+ "type"
+ ],
+ "title": "WarningEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Conversation history was compacted (either automatically or manually).",
+ "properties": {
+ "type": {
+ "enum": [
+ "context_compacted"
+ ],
+ "title": "ContextCompactedEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "ContextCompactedEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Conversation history was rolled back by dropping the last N user turns.",
+ "properties": {
+ "num_turns": {
+ "description": "Number of user turns that were removed from context.",
+ "format": "uint32",
+ "minimum": 0.0,
+ "type": "integer"
+ },
+ "type": {
+ "enum": [
+ "thread_rolled_back"
+ ],
+ "title": "ThreadRolledBackEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "num_turns",
+ "type"
+ ],
+ "title": "ThreadRolledBackEventMsg",
+ "type": "object"
+ },
+ {
+ "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/v2/ModeKind"
+ }
+ ],
+ "default": "code"
+ },
+ "model_context_window": {
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "task_started"
+ ],
+ "title": "TaskStartedEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "TaskStartedEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Agent has completed all actions. v1 wire format uses `task_complete`; accept `turn_complete` for v2 interop.",
+ "properties": {
+ "last_agent_message": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "task_complete"
+ ],
+ "title": "TaskCompleteEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "TaskCompleteEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Usage update for the current session, including totals and last turn. Optional means unknown — UIs should not display when `None`.",
+ "properties": {
+ "info": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/TokenUsageInfo"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "rate_limits": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/v2/RateLimitSnapshot"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "type": {
+ "enum": [
+ "token_count"
+ ],
+ "title": "TokenCountEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "TokenCountEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Agent text output message",
+ "properties": {
+ "message": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "agent_message"
+ ],
+ "title": "AgentMessageEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "message",
+ "type"
+ ],
+ "title": "AgentMessageEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "User/system input message (what was sent to the model)",
+ "properties": {
+ "images": {
+ "description": "Image URLs sourced from `UserInput::Image`. These are safe to replay in legacy UI history events and correspond to images sent to the model.",
+ "items": {
+ "type": "string"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "local_images": {
+ "default": [],
+ "description": "Local file paths sourced from `UserInput::LocalImage`. These are kept so the UI can reattach images when editing history, and should not be sent to the model or treated as API-ready URLs.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "message": {
+ "type": "string"
+ },
+ "text_elements": {
+ "default": [],
+ "description": "UI-defined spans within `message` used to render or persist special elements.",
+ "items": {
+ "$ref": "#/definitions/v2/TextElement"
+ },
+ "type": "array"
+ },
+ "type": {
+ "enum": [
+ "user_message"
+ ],
+ "title": "UserMessageEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "message",
+ "type"
+ ],
+ "title": "UserMessageEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Agent text output delta message",
+ "properties": {
+ "delta": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "agent_message_delta"
+ ],
+ "title": "AgentMessageDeltaEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "delta",
+ "type"
+ ],
+ "title": "AgentMessageDeltaEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Reasoning event from agent.",
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "agent_reasoning"
+ ],
+ "title": "AgentReasoningEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "AgentReasoningEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Agent reasoning delta event from agent.",
+ "properties": {
+ "delta": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "agent_reasoning_delta"
+ ],
+ "title": "AgentReasoningDeltaEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "delta",
+ "type"
+ ],
+ "title": "AgentReasoningDeltaEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Raw chain-of-thought from agent.",
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "agent_reasoning_raw_content"
+ ],
+ "title": "AgentReasoningRawContentEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "AgentReasoningRawContentEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Agent reasoning content delta event from agent.",
+ "properties": {
+ "delta": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "agent_reasoning_raw_content_delta"
+ ],
+ "title": "AgentReasoningRawContentDeltaEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "delta",
+ "type"
+ ],
+ "title": "AgentReasoningRawContentDeltaEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Signaled when the model begins a new reasoning summary section (e.g., a new titled block).",
+ "properties": {
+ "item_id": {
+ "default": "",
+ "type": "string"
+ },
+ "summary_index": {
+ "default": 0,
+ "format": "int64",
+ "type": "integer"
+ },
+ "type": {
+ "enum": [
+ "agent_reasoning_section_break"
+ ],
+ "title": "AgentReasoningSectionBreakEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "AgentReasoningSectionBreakEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Ack the client's configure message.",
+ "properties": {
+ "approval_policy": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/v2/AskForApproval"
+ }
+ ],
+ "description": "When to escalate for approval for execution"
+ },
+ "cwd": {
+ "description": "Working directory that should be treated as the *root* of the session.",
+ "type": "string"
+ },
+ "forked_from_id": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/v2/ThreadId"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "history_entry_count": {
+ "description": "Current number of entries in the history log.",
+ "format": "uint",
+ "minimum": 0.0,
+ "type": "integer"
+ },
+ "history_log_id": {
+ "description": "Identifier of the history log file (inode on Unix, 0 otherwise).",
+ "format": "uint64",
+ "minimum": 0.0,
+ "type": "integer"
+ },
+ "initial_messages": {
+ "description": "Optional initial messages (as events) for resumed sessions. When present, UIs can use these to seed the history.",
+ "items": {
+ "$ref": "#/definitions/EventMsg"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "model": {
+ "description": "Tell the client what model is being queried.",
+ "type": "string"
+ },
+ "model_provider_id": {
+ "type": "string"
+ },
+ "reasoning_effort": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/v2/ReasoningEffort"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "The effort the model is putting into reasoning about the user's request."
+ },
+ "rollout_path": {
+ "description": "Path in which the rollout is stored. Can be `None` for ephemeral threads",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "sandbox_policy": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/v2/SandboxPolicy"
+ }
+ ],
+ "description": "How to sandbox commands executed in the system"
+ },
+ "session_id": {
+ "$ref": "#/definitions/v2/ThreadId"
+ },
+ "thread_name": {
+ "description": "Optional user-facing thread name (may be unset).",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "session_configured"
+ ],
+ "title": "SessionConfiguredEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "approval_policy",
+ "cwd",
+ "history_entry_count",
+ "history_log_id",
+ "model",
+ "model_provider_id",
+ "sandbox_policy",
+ "session_id",
+ "type"
+ ],
+ "title": "SessionConfiguredEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Updated session metadata (e.g., thread name changes).",
+ "properties": {
+ "thread_id": {
+ "$ref": "#/definitions/v2/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": {
+ "server": {
+ "description": "Server name being started.",
+ "type": "string"
+ },
+ "status": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/McpStartupStatus"
+ }
+ ],
+ "description": "Current startup status."
+ },
+ "type": {
+ "enum": [
+ "mcp_startup_update"
+ ],
+ "title": "McpStartupUpdateEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "server",
+ "status",
+ "type"
+ ],
+ "title": "McpStartupUpdateEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Aggregate MCP startup completion summary.",
+ "properties": {
+ "cancelled": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "failed": {
+ "items": {
+ "$ref": "#/definitions/McpStartupFailure"
+ },
+ "type": "array"
+ },
+ "ready": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "type": {
+ "enum": [
+ "mcp_startup_complete"
+ ],
+ "title": "McpStartupCompleteEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "cancelled",
+ "failed",
+ "ready",
+ "type"
+ ],
+ "title": "McpStartupCompleteEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "call_id": {
+ "description": "Identifier so this can be paired with the McpToolCallEnd event.",
+ "type": "string"
+ },
+ "invocation": {
+ "$ref": "#/definitions/McpInvocation"
+ },
+ "type": {
+ "enum": [
+ "mcp_tool_call_begin"
+ ],
+ "title": "McpToolCallBeginEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "invocation",
+ "type"
+ ],
+ "title": "McpToolCallBeginEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "call_id": {
+ "description": "Identifier for the corresponding McpToolCallBegin that finished.",
+ "type": "string"
+ },
+ "duration": {
+ "$ref": "#/definitions/Duration"
+ },
+ "invocation": {
+ "$ref": "#/definitions/McpInvocation"
+ },
+ "result": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/Result_of_CallToolResult_or_String"
+ }
+ ],
+ "description": "Result of the tool call. Note this could be an error."
+ },
+ "type": {
+ "enum": [
+ "mcp_tool_call_end"
+ ],
+ "title": "McpToolCallEndEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "duration",
+ "invocation",
+ "result",
+ "type"
+ ],
+ "title": "McpToolCallEndEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "call_id": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "web_search_begin"
+ ],
+ "title": "WebSearchBeginEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "type"
+ ],
+ "title": "WebSearchBeginEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "action": {
+ "$ref": "#/definitions/v2/WebSearchAction"
+ },
+ "call_id": {
+ "type": "string"
+ },
+ "query": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "web_search_end"
+ ],
+ "title": "WebSearchEndEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "action",
+ "call_id",
+ "query",
+ "type"
+ ],
+ "title": "WebSearchEndEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Notification that the server is about to execute a command.",
+ "properties": {
+ "call_id": {
+ "description": "Identifier so this can be paired with the ExecCommandEnd event.",
+ "type": "string"
+ },
+ "command": {
+ "description": "The command to be executed.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "cwd": {
+ "description": "The command's working directory if not the default cwd for the agent.",
+ "type": "string"
+ },
+ "interaction_input": {
+ "description": "Raw input sent to a unified exec session (if this is an interaction event).",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "parsed_cmd": {
+ "items": {
+ "$ref": "#/definitions/ParsedCommand"
+ },
+ "type": "array"
+ },
+ "process_id": {
+ "description": "Identifier for the underlying PTY process (when available).",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "source": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ExecCommandSource"
+ }
+ ],
+ "default": "agent",
+ "description": "Where the command originated. Defaults to Agent for backward compatibility."
+ },
+ "turn_id": {
+ "description": "Turn ID that this command belongs to.",
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "exec_command_begin"
+ ],
+ "title": "ExecCommandBeginEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "command",
+ "cwd",
+ "parsed_cmd",
+ "turn_id",
+ "type"
+ ],
+ "title": "ExecCommandBeginEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Incremental chunk of output from a running command.",
+ "properties": {
+ "call_id": {
+ "description": "Identifier for the ExecCommandBegin that produced this chunk.",
+ "type": "string"
+ },
+ "chunk": {
+ "description": "Raw bytes from the stream (may not be valid UTF-8).",
+ "type": "string"
+ },
+ "stream": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ExecOutputStream"
+ }
+ ],
+ "description": "Which stream produced this chunk."
+ },
+ "type": {
+ "enum": [
+ "exec_command_output_delta"
+ ],
+ "title": "ExecCommandOutputDeltaEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "chunk",
+ "stream",
+ "type"
+ ],
+ "title": "ExecCommandOutputDeltaEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Terminal interaction for an in-progress command (stdin sent and stdout observed).",
+ "properties": {
+ "call_id": {
+ "description": "Identifier for the ExecCommandBegin that produced this chunk.",
+ "type": "string"
+ },
+ "process_id": {
+ "description": "Process id associated with the running command.",
+ "type": "string"
+ },
+ "stdin": {
+ "description": "Stdin sent to the running session.",
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "terminal_interaction"
+ ],
+ "title": "TerminalInteractionEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "process_id",
+ "stdin",
+ "type"
+ ],
+ "title": "TerminalInteractionEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "aggregated_output": {
+ "default": "",
+ "description": "Captured aggregated output",
+ "type": "string"
+ },
+ "call_id": {
+ "description": "Identifier for the ExecCommandBegin that finished.",
+ "type": "string"
+ },
+ "command": {
+ "description": "The command that was executed.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "cwd": {
+ "description": "The command's working directory if not the default cwd for the agent.",
+ "type": "string"
+ },
+ "duration": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/Duration"
+ }
+ ],
+ "description": "The duration of the command execution."
+ },
+ "exit_code": {
+ "description": "The command's exit code.",
+ "format": "int32",
+ "type": "integer"
+ },
+ "formatted_output": {
+ "description": "Formatted output from the command, as seen by the model.",
+ "type": "string"
+ },
+ "interaction_input": {
+ "description": "Raw input sent to a unified exec session (if this is an interaction event).",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "parsed_cmd": {
+ "items": {
+ "$ref": "#/definitions/ParsedCommand"
+ },
+ "type": "array"
+ },
+ "process_id": {
+ "description": "Identifier for the underlying PTY process (when available).",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "source": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ExecCommandSource"
+ }
+ ],
+ "default": "agent",
+ "description": "Where the command originated. Defaults to Agent for backward compatibility."
+ },
+ "stderr": {
+ "description": "Captured stderr",
+ "type": "string"
+ },
+ "stdout": {
+ "description": "Captured stdout",
+ "type": "string"
+ },
+ "turn_id": {
+ "description": "Turn ID that this command belongs to.",
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "exec_command_end"
+ ],
+ "title": "ExecCommandEndEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "command",
+ "cwd",
+ "duration",
+ "exit_code",
+ "formatted_output",
+ "parsed_cmd",
+ "stderr",
+ "stdout",
+ "turn_id",
+ "type"
+ ],
+ "title": "ExecCommandEndEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Notification that the agent attached a local image via the view_image tool.",
+ "properties": {
+ "call_id": {
+ "description": "Identifier for the originating tool call.",
+ "type": "string"
+ },
+ "path": {
+ "description": "Local filesystem path provided to the tool.",
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "view_image_tool_call"
+ ],
+ "title": "ViewImageToolCallEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "path",
+ "type"
+ ],
+ "title": "ViewImageToolCallEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "call_id": {
+ "description": "Identifier for the associated exec call, if available.",
+ "type": "string"
+ },
+ "command": {
+ "description": "The command to be executed.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "cwd": {
+ "description": "The command's working directory.",
+ "type": "string"
+ },
+ "parsed_cmd": {
+ "items": {
+ "$ref": "#/definitions/ParsedCommand"
+ },
+ "type": "array"
+ },
+ "proposed_execpolicy_amendment": {
+ "description": "Proposed execpolicy amendment that can be applied to allow future runs.",
+ "items": {
+ "type": "string"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "reason": {
+ "description": "Optional human-readable reason for the approval (e.g. retry without sandbox).",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "turn_id": {
+ "default": "",
+ "description": "Turn ID that this command belongs to. Uses `#[serde(default)]` for backwards compatibility.",
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "exec_approval_request"
+ ],
+ "title": "ExecApprovalRequestEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "command",
+ "cwd",
+ "parsed_cmd",
+ "type"
+ ],
+ "title": "ExecApprovalRequestEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "call_id": {
+ "description": "Responses API call id for the associated tool call, if available.",
+ "type": "string"
+ },
+ "questions": {
+ "items": {
+ "$ref": "#/definitions/RequestUserInputQuestion"
+ },
+ "type": "array"
+ },
+ "turn_id": {
+ "default": "",
+ "description": "Turn ID that this request belongs to. Uses `#[serde(default)]` for backwards compatibility.",
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "request_user_input"
+ ],
+ "title": "RequestUserInputEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "questions",
+ "type"
+ ],
+ "title": "RequestUserInputEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "arguments": true,
+ "callId": {
+ "type": "string"
+ },
+ "tool": {
+ "type": "string"
+ },
+ "turnId": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "dynamic_tool_call_request"
+ ],
+ "title": "DynamicToolCallRequestEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "arguments",
+ "callId",
+ "tool",
+ "turnId",
+ "type"
+ ],
+ "title": "DynamicToolCallRequestEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "message": {
+ "type": "string"
+ },
+ "server_name": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "elicitation_request"
+ ],
+ "title": "ElicitationRequestEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "message",
+ "server_name",
+ "type"
+ ],
+ "title": "ElicitationRequestEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "call_id": {
+ "description": "Responses API call id for the associated patch apply call, if available.",
+ "type": "string"
+ },
+ "changes": {
+ "additionalProperties": {
+ "$ref": "#/definitions/FileChange"
+ },
+ "type": "object"
+ },
+ "grant_root": {
+ "description": "When set, the agent is asking the user to allow writes under this root for the remainder of the session.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "reason": {
+ "description": "Optional explanatory reason (e.g. request for extra write access).",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "turn_id": {
+ "default": "",
+ "description": "Turn ID that this patch belongs to. Uses `#[serde(default)]` for backwards compatibility with older senders.",
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "apply_patch_approval_request"
+ ],
+ "title": "ApplyPatchApprovalRequestEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "changes",
+ "type"
+ ],
+ "title": "ApplyPatchApprovalRequestEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Notification advising the user that something they are using has been deprecated and should be phased out.",
+ "properties": {
+ "details": {
+ "description": "Optional extra guidance, such as migration steps or rationale.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "summary": {
+ "description": "Concise summary of what is deprecated.",
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "deprecation_notice"
+ ],
+ "title": "DeprecationNoticeEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "summary",
+ "type"
+ ],
+ "title": "DeprecationNoticeEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "message": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "background_event"
+ ],
+ "title": "BackgroundEventEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "message",
+ "type"
+ ],
+ "title": "BackgroundEventEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "message": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "undo_started"
+ ],
+ "title": "UndoStartedEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "UndoStartedEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "message": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "success": {
+ "type": "boolean"
+ },
+ "type": {
+ "enum": [
+ "undo_completed"
+ ],
+ "title": "UndoCompletedEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "success",
+ "type"
+ ],
+ "title": "UndoCompletedEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Notification that a model stream experienced an error or disconnect and the system is handling it (e.g., retrying with backoff).",
+ "properties": {
+ "additional_details": {
+ "default": null,
+ "description": "Optional details about the underlying stream failure (often the same human-readable message that is surfaced as the terminal error if retries are exhausted).",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "codex_error_info": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/v2/CodexErrorInfo"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "default": null
+ },
+ "message": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "stream_error"
+ ],
+ "title": "StreamErrorEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "message",
+ "type"
+ ],
+ "title": "StreamErrorEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Notification that the agent is about to apply a code patch. Mirrors `ExecCommandBegin` so front‑ends can show progress indicators.",
+ "properties": {
+ "auto_approved": {
+ "description": "If true, there was no ApplyPatchApprovalRequest for this patch.",
+ "type": "boolean"
+ },
+ "call_id": {
+ "description": "Identifier so this can be paired with the PatchApplyEnd event.",
+ "type": "string"
+ },
+ "changes": {
+ "additionalProperties": {
+ "$ref": "#/definitions/FileChange"
+ },
+ "description": "The changes to be applied.",
+ "type": "object"
+ },
+ "turn_id": {
+ "default": "",
+ "description": "Turn ID that this patch belongs to. Uses `#[serde(default)]` for backwards compatibility.",
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "patch_apply_begin"
+ ],
+ "title": "PatchApplyBeginEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "auto_approved",
+ "call_id",
+ "changes",
+ "type"
+ ],
+ "title": "PatchApplyBeginEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Notification that a patch application has finished.",
+ "properties": {
+ "call_id": {
+ "description": "Identifier for the PatchApplyBegin that finished.",
+ "type": "string"
+ },
+ "changes": {
+ "additionalProperties": {
+ "$ref": "#/definitions/FileChange"
+ },
+ "default": {},
+ "description": "The changes that were applied (mirrors PatchApplyBeginEvent::changes).",
+ "type": "object"
+ },
+ "stderr": {
+ "description": "Captured stderr (parser errors, IO failures, etc.).",
+ "type": "string"
+ },
+ "stdout": {
+ "description": "Captured stdout (summary printed by apply_patch).",
+ "type": "string"
+ },
+ "success": {
+ "description": "Whether the patch was applied successfully.",
+ "type": "boolean"
+ },
+ "turn_id": {
+ "default": "",
+ "description": "Turn ID that this patch belongs to. Uses `#[serde(default)]` for backwards compatibility.",
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "patch_apply_end"
+ ],
+ "title": "PatchApplyEndEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "stderr",
+ "stdout",
+ "success",
+ "type"
+ ],
+ "title": "PatchApplyEndEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "turn_diff"
+ ],
+ "title": "TurnDiffEventMsgType",
+ "type": "string"
+ },
+ "unified_diff": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "unified_diff"
+ ],
+ "title": "TurnDiffEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Response to GetHistoryEntryRequest.",
+ "properties": {
+ "entry": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/HistoryEntry"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "The entry at the requested offset, if available and parseable."
+ },
+ "log_id": {
+ "format": "uint64",
+ "minimum": 0.0,
+ "type": "integer"
+ },
+ "offset": {
+ "format": "uint",
+ "minimum": 0.0,
+ "type": "integer"
+ },
+ "type": {
+ "enum": [
+ "get_history_entry_response"
+ ],
+ "title": "GetHistoryEntryResponseEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "log_id",
+ "offset",
+ "type"
+ ],
+ "title": "GetHistoryEntryResponseEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "List of MCP tools available to the agent.",
+ "properties": {
+ "auth_statuses": {
+ "additionalProperties": {
+ "$ref": "#/definitions/v2/McpAuthStatus"
+ },
+ "description": "Authentication status for each configured MCP server.",
+ "type": "object"
+ },
+ "resource_templates": {
+ "additionalProperties": {
+ "items": {
+ "$ref": "#/definitions/v2/ResourceTemplate"
+ },
+ "type": "array"
+ },
+ "description": "Known resource templates grouped by server name.",
+ "type": "object"
+ },
+ "resources": {
+ "additionalProperties": {
+ "items": {
+ "$ref": "#/definitions/v2/Resource"
+ },
+ "type": "array"
+ },
+ "description": "Known resources grouped by server name.",
+ "type": "object"
+ },
+ "tools": {
+ "additionalProperties": {
+ "$ref": "#/definitions/v2/Tool"
+ },
+ "description": "Fully qualified tool name -> tool definition.",
+ "type": "object"
+ },
+ "type": {
+ "enum": [
+ "mcp_list_tools_response"
+ ],
+ "title": "McpListToolsResponseEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "auth_statuses",
+ "resource_templates",
+ "resources",
+ "tools",
+ "type"
+ ],
+ "title": "McpListToolsResponseEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "List of custom prompts available to the agent.",
+ "properties": {
+ "custom_prompts": {
+ "items": {
+ "$ref": "#/definitions/CustomPrompt"
+ },
+ "type": "array"
+ },
+ "type": {
+ "enum": [
+ "list_custom_prompts_response"
+ ],
+ "title": "ListCustomPromptsResponseEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "custom_prompts",
+ "type"
+ ],
+ "title": "ListCustomPromptsResponseEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "List of skills available to the agent.",
+ "properties": {
+ "skills": {
+ "items": {
+ "$ref": "#/definitions/v2/SkillsListEntry"
+ },
+ "type": "array"
+ },
+ "type": {
+ "enum": [
+ "list_skills_response"
+ ],
+ "title": "ListSkillsResponseEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "skills",
+ "type"
+ ],
+ "title": "ListSkillsResponseEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Notification that skill data may have been updated and clients may want to reload.",
+ "properties": {
+ "type": {
+ "enum": [
+ "skills_update_available"
+ ],
+ "title": "SkillsUpdateAvailableEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "SkillsUpdateAvailableEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "explanation": {
+ "default": null,
+ "description": "Arguments for the `update_plan` todo/checklist tool (not plan mode).",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "plan": {
+ "items": {
+ "$ref": "#/definitions/PlanItemArg"
+ },
+ "type": "array"
+ },
+ "type": {
+ "enum": [
+ "plan_update"
+ ],
+ "title": "PlanUpdateEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "plan",
+ "type"
+ ],
+ "title": "PlanUpdateEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "reason": {
+ "$ref": "#/definitions/TurnAbortReason"
+ },
+ "type": {
+ "enum": [
+ "turn_aborted"
+ ],
+ "title": "TurnAbortedEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "reason",
+ "type"
+ ],
+ "title": "TurnAbortedEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Notification that the agent is shutting down.",
+ "properties": {
+ "type": {
+ "enum": [
+ "shutdown_complete"
+ ],
+ "title": "ShutdownCompleteEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "ShutdownCompleteEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Entered review mode.",
+ "properties": {
+ "target": {
+ "$ref": "#/definitions/v2/ReviewTarget"
+ },
+ "type": {
+ "enum": [
+ "entered_review_mode"
+ ],
+ "title": "EnteredReviewModeEventMsgType",
+ "type": "string"
+ },
+ "user_facing_hint": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "target",
+ "type"
+ ],
+ "title": "EnteredReviewModeEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Exited review mode with an optional final result to apply.",
+ "properties": {
+ "review_output": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ReviewOutputEvent"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "type": {
+ "enum": [
+ "exited_review_mode"
+ ],
+ "title": "ExitedReviewModeEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "ExitedReviewModeEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "item": {
+ "$ref": "#/definitions/v2/ResponseItem"
+ },
+ "type": {
+ "enum": [
+ "raw_response_item"
+ ],
+ "title": "RawResponseItemEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "item",
+ "type"
+ ],
+ "title": "RawResponseItemEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "item": {
+ "$ref": "#/definitions/TurnItem"
+ },
+ "thread_id": {
+ "$ref": "#/definitions/v2/ThreadId"
+ },
+ "turn_id": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "item_started"
+ ],
+ "title": "ItemStartedEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "item",
+ "thread_id",
+ "turn_id",
+ "type"
+ ],
+ "title": "ItemStartedEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "item": {
+ "$ref": "#/definitions/TurnItem"
+ },
+ "thread_id": {
+ "$ref": "#/definitions/v2/ThreadId"
+ },
+ "turn_id": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "item_completed"
+ ],
+ "title": "ItemCompletedEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "item",
+ "thread_id",
+ "turn_id",
+ "type"
+ ],
+ "title": "ItemCompletedEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "delta": {
+ "type": "string"
+ },
+ "item_id": {
+ "type": "string"
+ },
+ "thread_id": {
+ "type": "string"
+ },
+ "turn_id": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "agent_message_content_delta"
+ ],
+ "title": "AgentMessageContentDeltaEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "delta",
+ "item_id",
+ "thread_id",
+ "turn_id",
+ "type"
+ ],
+ "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": {
+ "type": "string"
+ },
+ "item_id": {
+ "type": "string"
+ },
+ "summary_index": {
+ "default": 0,
+ "format": "int64",
+ "type": "integer"
+ },
+ "thread_id": {
+ "type": "string"
+ },
+ "turn_id": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "reasoning_content_delta"
+ ],
+ "title": "ReasoningContentDeltaEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "delta",
+ "item_id",
+ "thread_id",
+ "turn_id",
+ "type"
+ ],
+ "title": "ReasoningContentDeltaEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "content_index": {
+ "default": 0,
+ "format": "int64",
+ "type": "integer"
+ },
+ "delta": {
+ "type": "string"
+ },
+ "item_id": {
+ "type": "string"
+ },
+ "thread_id": {
+ "type": "string"
+ },
+ "turn_id": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "reasoning_raw_content_delta"
+ ],
+ "title": "ReasoningRawContentDeltaEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "delta",
+ "item_id",
+ "thread_id",
+ "turn_id",
+ "type"
+ ],
+ "title": "ReasoningRawContentDeltaEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Collab interaction: agent spawn begin.",
+ "properties": {
+ "call_id": {
+ "description": "Identifier for the collab tool call.",
+ "type": "string"
+ },
+ "prompt": {
+ "description": "Initial prompt sent to the agent. Can be empty to prevent CoT leaking at the beginning.",
+ "type": "string"
+ },
+ "sender_thread_id": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/v2/ThreadId"
+ }
+ ],
+ "description": "Thread ID of the sender."
+ },
+ "type": {
+ "enum": [
+ "collab_agent_spawn_begin"
+ ],
+ "title": "CollabAgentSpawnBeginEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "prompt",
+ "sender_thread_id",
+ "type"
+ ],
+ "title": "CollabAgentSpawnBeginEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Collab interaction: agent spawn end.",
+ "properties": {
+ "call_id": {
+ "description": "Identifier for the collab tool call.",
+ "type": "string"
+ },
+ "new_thread_id": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/v2/ThreadId"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Thread ID of the newly spawned agent, if it was created."
+ },
+ "prompt": {
+ "description": "Initial prompt sent to the agent. Can be empty to prevent CoT leaking at the beginning.",
+ "type": "string"
+ },
+ "sender_thread_id": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/v2/ThreadId"
+ }
+ ],
+ "description": "Thread ID of the sender."
+ },
+ "status": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/AgentStatus"
+ }
+ ],
+ "description": "Last known status of the new agent reported to the sender agent."
+ },
+ "type": {
+ "enum": [
+ "collab_agent_spawn_end"
+ ],
+ "title": "CollabAgentSpawnEndEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "prompt",
+ "sender_thread_id",
+ "status",
+ "type"
+ ],
+ "title": "CollabAgentSpawnEndEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Collab interaction: agent interaction begin.",
+ "properties": {
+ "call_id": {
+ "description": "Identifier for the collab tool call.",
+ "type": "string"
+ },
+ "prompt": {
+ "description": "Prompt sent from the sender to the receiver. Can be empty to prevent CoT leaking at the beginning.",
+ "type": "string"
+ },
+ "receiver_thread_id": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/v2/ThreadId"
+ }
+ ],
+ "description": "Thread ID of the receiver."
+ },
+ "sender_thread_id": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/v2/ThreadId"
+ }
+ ],
+ "description": "Thread ID of the sender."
+ },
+ "type": {
+ "enum": [
+ "collab_agent_interaction_begin"
+ ],
+ "title": "CollabAgentInteractionBeginEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "prompt",
+ "receiver_thread_id",
+ "sender_thread_id",
+ "type"
+ ],
+ "title": "CollabAgentInteractionBeginEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Collab interaction: agent interaction end.",
+ "properties": {
+ "call_id": {
+ "description": "Identifier for the collab tool call.",
+ "type": "string"
+ },
+ "prompt": {
+ "description": "Prompt sent from the sender to the receiver. Can be empty to prevent CoT leaking at the beginning.",
+ "type": "string"
+ },
+ "receiver_thread_id": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/v2/ThreadId"
+ }
+ ],
+ "description": "Thread ID of the receiver."
+ },
+ "sender_thread_id": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/v2/ThreadId"
+ }
+ ],
+ "description": "Thread ID of the sender."
+ },
+ "status": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/AgentStatus"
+ }
+ ],
+ "description": "Last known status of the receiver agent reported to the sender agent."
+ },
+ "type": {
+ "enum": [
+ "collab_agent_interaction_end"
+ ],
+ "title": "CollabAgentInteractionEndEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "prompt",
+ "receiver_thread_id",
+ "sender_thread_id",
+ "status",
+ "type"
+ ],
+ "title": "CollabAgentInteractionEndEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Collab interaction: waiting begin.",
+ "properties": {
+ "call_id": {
+ "description": "ID of the waiting call.",
+ "type": "string"
+ },
+ "receiver_thread_ids": {
+ "description": "Thread ID of the receivers.",
+ "items": {
+ "$ref": "#/definitions/v2/ThreadId"
+ },
+ "type": "array"
+ },
+ "sender_thread_id": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/v2/ThreadId"
+ }
+ ],
+ "description": "Thread ID of the sender."
+ },
+ "type": {
+ "enum": [
+ "collab_waiting_begin"
+ ],
+ "title": "CollabWaitingBeginEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "receiver_thread_ids",
+ "sender_thread_id",
+ "type"
+ ],
+ "title": "CollabWaitingBeginEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Collab interaction: waiting end.",
+ "properties": {
+ "call_id": {
+ "description": "ID of the waiting call.",
+ "type": "string"
+ },
+ "sender_thread_id": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/v2/ThreadId"
+ }
+ ],
+ "description": "Thread ID of the sender."
+ },
+ "statuses": {
+ "additionalProperties": {
+ "$ref": "#/definitions/AgentStatus"
+ },
+ "description": "Last known status of the receiver agents reported to the sender agent.",
+ "type": "object"
+ },
+ "type": {
+ "enum": [
+ "collab_waiting_end"
+ ],
+ "title": "CollabWaitingEndEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "sender_thread_id",
+ "statuses",
+ "type"
+ ],
+ "title": "CollabWaitingEndEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Collab interaction: close begin.",
+ "properties": {
+ "call_id": {
+ "description": "Identifier for the collab tool call.",
+ "type": "string"
+ },
+ "receiver_thread_id": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/v2/ThreadId"
+ }
+ ],
+ "description": "Thread ID of the receiver."
+ },
+ "sender_thread_id": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/v2/ThreadId"
+ }
+ ],
+ "description": "Thread ID of the sender."
+ },
+ "type": {
+ "enum": [
+ "collab_close_begin"
+ ],
+ "title": "CollabCloseBeginEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "receiver_thread_id",
+ "sender_thread_id",
+ "type"
+ ],
+ "title": "CollabCloseBeginEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Collab interaction: close end.",
+ "properties": {
+ "call_id": {
+ "description": "Identifier for the collab tool call.",
+ "type": "string"
+ },
+ "receiver_thread_id": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/v2/ThreadId"
+ }
+ ],
+ "description": "Thread ID of the receiver."
+ },
+ "sender_thread_id": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/v2/ThreadId"
+ }
+ ],
+ "description": "Thread ID of the sender."
+ },
+ "status": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/AgentStatus"
+ }
+ ],
+ "description": "Last known status of the receiver agent reported to the sender agent before the close."
+ },
+ "type": {
+ "enum": [
+ "collab_close_end"
+ ],
+ "title": "CollabCloseEndEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "receiver_thread_id",
+ "sender_thread_id",
+ "status",
+ "type"
+ ],
+ "title": "CollabCloseEndEventMsg",
+ "type": "object"
+ }
+ ],
+ "title": "EventMsg"
+ },
+ "ExecCommandApprovalParams": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "callId": {
+ "description": "Use to correlate this with [codex_core::protocol::ExecCommandBeginEvent] and [codex_core::protocol::ExecCommandEndEvent].",
+ "type": "string"
+ },
+ "command": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "conversationId": {
+ "$ref": "#/definitions/v2/ThreadId"
+ },
+ "cwd": {
+ "type": "string"
+ },
+ "parsedCmd": {
+ "items": {
+ "$ref": "#/definitions/ParsedCommand"
+ },
+ "type": "array"
+ },
+ "reason": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "callId",
+ "command",
+ "conversationId",
+ "cwd",
+ "parsedCmd"
+ ],
+ "title": "ExecCommandApprovalParams",
+ "type": "object"
+ },
+ "ExecCommandApprovalResponse": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "decision": {
+ "$ref": "#/definitions/ReviewDecision"
+ }
+ },
+ "required": [
+ "decision"
+ ],
+ "title": "ExecCommandApprovalResponse",
+ "type": "object"
+ },
+ "ExecCommandSource": {
+ "enum": [
+ "agent",
+ "user_shell",
+ "unified_exec_startup",
+ "unified_exec_interaction"
+ ],
+ "type": "string"
+ },
+ "ExecOneOffCommandParams": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "command": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "cwd": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "sandboxPolicy": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/SandboxPolicy"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "timeoutMs": {
+ "format": "uint64",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "command"
+ ],
+ "title": "ExecOneOffCommandParams",
+ "type": "object"
+ },
+ "ExecOneOffCommandResponse": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "exitCode": {
+ "format": "int32",
+ "type": "integer"
+ },
+ "stderr": {
+ "type": "string"
+ },
+ "stdout": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "exitCode",
+ "stderr",
+ "stdout"
+ ],
+ "title": "ExecOneOffCommandResponse",
+ "type": "object"
+ },
+ "ExecOutputStream": {
+ "enum": [
+ "stdout",
+ "stderr"
+ ],
+ "type": "string"
+ },
+ "FileChange": {
+ "oneOf": [
+ {
+ "properties": {
+ "content": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "add"
+ ],
+ "title": "AddFileChangeType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "content",
+ "type"
+ ],
+ "title": "AddFileChange",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "content": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "delete"
+ ],
+ "title": "DeleteFileChangeType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "content",
+ "type"
+ ],
+ "title": "DeleteFileChange",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "move_path": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "update"
+ ],
+ "title": "UpdateFileChangeType",
+ "type": "string"
+ },
+ "unified_diff": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "unified_diff"
+ ],
+ "title": "UpdateFileChange",
+ "type": "object"
+ }
+ ]
+ },
+ "FileChangeApprovalDecision": {
+ "oneOf": [
+ {
+ "description": "User approved the file changes.",
+ "enum": [
+ "accept"
+ ],
+ "type": "string"
+ },
+ {
+ "description": "User approved the file changes and future changes to the same files should run without prompting.",
+ "enum": [
+ "acceptForSession"
+ ],
+ "type": "string"
+ },
+ {
+ "description": "User denied the file changes. The agent will continue the turn.",
+ "enum": [
+ "decline"
+ ],
+ "type": "string"
+ },
+ {
+ "description": "User denied the file changes. The turn will also be immediately interrupted.",
+ "enum": [
+ "cancel"
+ ],
+ "type": "string"
+ }
+ ]
+ },
+ "FileChangeRequestApprovalParams": {
+ "$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"
+ },
+ "reason": {
+ "description": "Optional explanatory reason (e.g. request for extra write access).",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "threadId": {
+ "type": "string"
+ },
+ "turnId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "itemId",
+ "threadId",
+ "turnId"
+ ],
+ "title": "FileChangeRequestApprovalParams",
+ "type": "object"
+ },
+ "FileChangeRequestApprovalResponse": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "decision": {
+ "$ref": "#/definitions/FileChangeApprovalDecision"
+ }
+ },
+ "required": [
+ "decision"
+ ],
+ "title": "FileChangeRequestApprovalResponse",
+ "type": "object"
+ },
+ "ForcedLoginMethod": {
+ "enum": [
+ "chatgpt",
+ "api"
+ ],
+ "type": "string"
+ },
+ "ForkConversationParams": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "conversationId": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ThreadId"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "overrides": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/NewConversationParams"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "path": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "title": "ForkConversationParams",
+ "type": "object"
+ },
+ "ForkConversationResponse": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "conversationId": {
+ "$ref": "#/definitions/ThreadId"
+ },
+ "initialMessages": {
+ "items": {
+ "$ref": "#/definitions/EventMsg"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "model": {
+ "type": "string"
+ },
+ "rolloutPath": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "conversationId",
+ "model",
+ "rolloutPath"
+ ],
+ "title": "ForkConversationResponse",
+ "type": "object"
+ },
+ "FunctionCallOutputContentItem": {
+ "description": "Responses API compatible content items that can be returned by a tool call. This is a subset of ContentItem with the types we support as function call outputs.",
+ "oneOf": [
+ {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "input_text"
+ ],
+ "title": "InputTextFunctionCallOutputContentItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "InputTextFunctionCallOutputContentItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "image_url": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "input_image"
+ ],
+ "title": "InputImageFunctionCallOutputContentItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "image_url",
+ "type"
+ ],
+ "title": "InputImageFunctionCallOutputContentItem",
+ "type": "object"
+ }
+ ]
+ },
+ "FunctionCallOutputPayload": {
+ "description": "The payload we send back to OpenAI when reporting a tool call result.\n\n`content` preserves the historical plain-string payload so downstream integrations (tests, logging, etc.) can keep treating tool output as `String`. When an MCP server returns richer data we additionally populate `content_items` with the structured form that the Responses/Chat Completions APIs understand.",
+ "properties": {
+ "content": {
+ "type": "string"
+ },
+ "content_items": {
+ "items": {
+ "$ref": "#/definitions/FunctionCallOutputContentItem"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "success": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "content"
+ ],
+ "type": "object"
+ },
+ "FuzzyFileSearchParams": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "cancellationToken": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "query": {
+ "type": "string"
+ },
+ "roots": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ }
+ },
+ "required": [
+ "query",
+ "roots"
+ ],
+ "title": "FuzzyFileSearchParams",
+ "type": "object"
+ },
+ "FuzzyFileSearchResponse": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "files": {
+ "items": {
+ "$ref": "#/definitions/FuzzyFileSearchResult"
+ },
+ "type": "array"
+ }
+ },
+ "required": [
+ "files"
+ ],
+ "title": "FuzzyFileSearchResponse",
+ "type": "object"
+ },
+ "FuzzyFileSearchResult": {
+ "description": "Superset of [`codex_file_search::FileMatch`]",
+ "properties": {
+ "file_name": {
+ "type": "string"
+ },
+ "indices": {
+ "items": {
+ "format": "uint32",
+ "minimum": 0.0,
+ "type": "integer"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "path": {
+ "type": "string"
+ },
+ "root": {
+ "type": "string"
+ },
+ "score": {
+ "format": "uint32",
+ "minimum": 0.0,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "file_name",
+ "path",
+ "root",
+ "score"
+ ],
+ "type": "object"
+ },
+ "GetAuthStatusParams": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "includeToken": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "refreshToken": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ }
+ },
+ "title": "GetAuthStatusParams",
+ "type": "object"
+ },
+ "GetAuthStatusResponse": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "authMethod": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/AuthMode"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "authToken": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "requiresOpenaiAuth": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ }
+ },
+ "title": "GetAuthStatusResponse",
+ "type": "object"
+ },
+ "GetConversationSummaryParams": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "anyOf": [
+ {
+ "properties": {
+ "rolloutPath": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "rolloutPath"
+ ],
+ "title": "RolloutPathv1::GetConversationSummaryParams",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "conversationId": {
+ "$ref": "#/definitions/ThreadId"
+ }
+ },
+ "required": [
+ "conversationId"
+ ],
+ "title": "ConversationIdv1::GetConversationSummaryParams",
+ "type": "object"
+ }
+ ],
+ "title": "GetConversationSummaryParams"
+ },
+ "GetConversationSummaryResponse": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "summary": {
+ "$ref": "#/definitions/ConversationSummary"
+ }
+ },
+ "required": [
+ "summary"
+ ],
+ "title": "GetConversationSummaryResponse",
+ "type": "object"
+ },
+ "GetUserAgentResponse": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "userAgent": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "userAgent"
+ ],
+ "title": "GetUserAgentResponse",
+ "type": "object"
+ },
+ "GetUserSavedConfigResponse": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "config": {
+ "$ref": "#/definitions/UserSavedConfig"
+ }
+ },
+ "required": [
+ "config"
+ ],
+ "title": "GetUserSavedConfigResponse",
+ "type": "object"
+ },
+ "GhostCommit": {
+ "description": "Details of a ghost commit created from a repository state.",
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "parent": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "preexisting_untracked_dirs": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "preexisting_untracked_files": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ }
+ },
+ "required": [
+ "id",
+ "preexisting_untracked_dirs",
+ "preexisting_untracked_files"
+ ],
+ "type": "object"
+ },
+ "GitDiffToRemoteParams": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "cwd": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "cwd"
+ ],
+ "title": "GitDiffToRemoteParams",
+ "type": "object"
+ },
+ "GitDiffToRemoteResponse": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "diff": {
+ "type": "string"
+ },
+ "sha": {
+ "$ref": "#/definitions/GitSha"
+ }
+ },
+ "required": [
+ "diff",
+ "sha"
+ ],
+ "title": "GitDiffToRemoteResponse",
+ "type": "object"
+ },
+ "GitSha": {
+ "type": "string"
+ },
+ "HistoryEntry": {
+ "properties": {
+ "conversation_id": {
+ "type": "string"
+ },
+ "text": {
+ "type": "string"
+ },
+ "ts": {
+ "format": "uint64",
+ "minimum": 0.0,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "conversation_id",
+ "text",
+ "ts"
+ ],
+ "type": "object"
+ },
+ "ImageContent": {
+ "description": "An image provided to or from an LLM.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "data": {
+ "type": "string"
+ },
+ "mimeType": {
+ "type": "string"
+ },
+ "type": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "data",
+ "mimeType",
+ "type"
+ ],
+ "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": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "capabilities": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/InitializeCapabilities"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "clientInfo": {
+ "$ref": "#/definitions/ClientInfo"
+ }
+ },
+ "required": [
+ "clientInfo"
+ ],
+ "title": "InitializeParams",
+ "type": "object"
+ },
+ "InitializeResponse": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "userAgent": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "userAgent"
+ ],
+ "title": "InitializeResponse",
+ "type": "object"
+ },
+ "InputItem": {
+ "oneOf": [
+ {
+ "properties": {
+ "data": {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "text_elements": {
+ "default": [],
+ "description": "UI-defined spans within `text` used to render or persist special elements.",
+ "items": {
+ "$ref": "#/definitions/V1TextElement"
+ },
+ "type": "array"
+ }
+ },
+ "required": [
+ "text"
+ ],
+ "type": "object"
+ },
+ "type": {
+ "enum": [
+ "text"
+ ],
+ "title": "TextInputItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "data",
+ "type"
+ ],
+ "title": "TextInputItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "data": {
+ "properties": {
+ "image_url": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "image_url"
+ ],
+ "type": "object"
+ },
+ "type": {
+ "enum": [
+ "image"
+ ],
+ "title": "ImageInputItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "data",
+ "type"
+ ],
+ "title": "ImageInputItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "data": {
+ "properties": {
+ "path": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "path"
+ ],
+ "type": "object"
+ },
+ "type": {
+ "enum": [
+ "localImage"
+ ],
+ "title": "LocalImageInputItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "data",
+ "type"
+ ],
+ "title": "LocalImageInputItem",
+ "type": "object"
+ }
+ ]
+ },
+ "InterruptConversationParams": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "conversationId": {
+ "$ref": "#/definitions/ThreadId"
+ }
+ },
+ "required": [
+ "conversationId"
+ ],
+ "title": "InterruptConversationParams",
+ "type": "object"
+ },
+ "InterruptConversationResponse": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "abortReason": {
+ "$ref": "#/definitions/TurnAbortReason"
+ }
+ },
+ "required": [
+ "abortReason"
+ ],
+ "title": "InterruptConversationResponse",
+ "type": "object"
+ },
+ "JSONRPCError": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "description": "A response to a request that indicates an error occurred.",
+ "properties": {
+ "error": {
+ "$ref": "#/definitions/JSONRPCErrorError"
+ },
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ }
+ },
+ "required": [
+ "error",
+ "id"
+ ],
+ "title": "JSONRPCError",
+ "type": "object"
+ },
+ "JSONRPCErrorError": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "code": {
+ "format": "int64",
+ "type": "integer"
+ },
+ "data": true,
+ "message": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "code",
+ "message"
+ ],
+ "title": "JSONRPCErrorError",
+ "type": "object"
+ },
+ "JSONRPCMessage": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/JSONRPCRequest"
+ },
+ {
+ "$ref": "#/definitions/JSONRPCNotification"
+ },
+ {
+ "$ref": "#/definitions/JSONRPCResponse"
+ },
+ {
+ "$ref": "#/definitions/JSONRPCError"
+ }
+ ],
+ "description": "Refers to any valid JSON-RPC object that can be decoded off the wire, or encoded to be sent.",
+ "title": "JSONRPCMessage"
+ },
+ "JSONRPCNotification": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "description": "A notification which does not expect a response.",
+ "properties": {
+ "method": {
+ "type": "string"
+ },
+ "params": true
+ },
+ "required": [
+ "method"
+ ],
+ "title": "JSONRPCNotification",
+ "type": "object"
+ },
+ "JSONRPCRequest": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "description": "A request that expects a response.",
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "type": "string"
+ },
+ "params": true
+ },
+ "required": [
+ "id",
+ "method"
+ ],
+ "title": "JSONRPCRequest",
+ "type": "object"
+ },
+ "JSONRPCResponse": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "description": "A successful (non-error) response to a request.",
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "result": true
+ },
+ "required": [
+ "id",
+ "result"
+ ],
+ "title": "JSONRPCResponse",
+ "type": "object"
+ },
+ "ListConversationsParams": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "cursor": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "modelProviders": {
+ "items": {
+ "type": "string"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "pageSize": {
+ "format": "uint",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "title": "ListConversationsParams",
+ "type": "object"
+ },
+ "ListConversationsResponse": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "items": {
+ "items": {
+ "$ref": "#/definitions/ConversationSummary"
+ },
+ "type": "array"
+ },
+ "nextCursor": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "items"
+ ],
+ "title": "ListConversationsResponse",
+ "type": "object"
+ },
+ "LocalShellAction": {
+ "oneOf": [
+ {
+ "properties": {
+ "command": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "env": {
+ "additionalProperties": {
+ "type": "string"
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "timeout_ms": {
+ "format": "uint64",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "exec"
+ ],
+ "title": "ExecLocalShellActionType",
+ "type": "string"
+ },
+ "user": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "working_directory": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "command",
+ "type"
+ ],
+ "title": "ExecLocalShellAction",
+ "type": "object"
+ }
+ ]
+ },
+ "LocalShellStatus": {
+ "enum": [
+ "completed",
+ "in_progress",
+ "incomplete"
+ ],
+ "type": "string"
+ },
+ "LoginApiKeyParams": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "apiKey": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "apiKey"
+ ],
+ "title": "LoginApiKeyParams",
+ "type": "object"
+ },
+ "LoginApiKeyResponse": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "title": "LoginApiKeyResponse",
+ "type": "object"
+ },
+ "LoginChatGptCompleteNotification": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "description": "Deprecated in favor of AccountLoginCompletedNotification.",
+ "properties": {
+ "error": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "loginId": {
+ "type": "string"
+ },
+ "success": {
+ "type": "boolean"
+ }
+ },
+ "required": [
+ "loginId",
+ "success"
+ ],
+ "title": "LoginChatGptCompleteNotification",
+ "type": "object"
+ },
+ "LoginChatGptResponse": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "authUrl": {
+ "type": "string"
+ },
+ "loginId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "authUrl",
+ "loginId"
+ ],
+ "title": "LoginChatGptResponse",
+ "type": "object"
+ },
+ "LogoutChatGptResponse": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "title": "LogoutChatGptResponse",
+ "type": "object"
+ },
+ "McpAuthStatus": {
+ "enum": [
+ "unsupported",
+ "not_logged_in",
+ "bearer_token",
+ "o_auth"
+ ],
+ "type": "string"
+ },
+ "McpInvocation": {
+ "properties": {
+ "arguments": {
+ "description": "Arguments to the tool call."
+ },
+ "server": {
+ "description": "Name of the MCP server as defined in the config.",
+ "type": "string"
+ },
+ "tool": {
+ "description": "Name of the tool as given by the MCP server.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "server",
+ "tool"
+ ],
+ "type": "object"
+ },
+ "McpStartupFailure": {
+ "properties": {
+ "error": {
+ "type": "string"
+ },
+ "server": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "error",
+ "server"
+ ],
+ "type": "object"
+ },
+ "McpStartupStatus": {
+ "oneOf": [
+ {
+ "properties": {
+ "state": {
+ "enum": [
+ "starting"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "state"
+ ],
+ "title": "StateMcpStartupStatus",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "state": {
+ "enum": [
+ "ready"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "state"
+ ],
+ "title": "StateMcpStartupStatus2",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "error": {
+ "type": "string"
+ },
+ "state": {
+ "enum": [
+ "failed"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "error",
+ "state"
+ ],
+ "type": "object"
+ },
+ {
+ "properties": {
+ "state": {
+ "enum": [
+ "cancelled"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "state"
+ ],
+ "title": "StateMcpStartupStatus3",
+ "type": "object"
+ }
+ ]
+ },
+ "ModeKind": {
+ "description": "Initial collaboration mode to use when the TUI starts.",
+ "enum": [
+ "plan",
+ "code",
+ "pair_programming",
+ "execute",
+ "custom"
+ ],
+ "type": "string"
+ },
+ "NetworkAccess": {
+ "description": "Represents whether outbound network access is available to the agent.",
+ "enum": [
+ "restricted",
+ "enabled"
+ ],
+ "type": "string"
+ },
+ "NewConversationParams": {
+ "properties": {
+ "approvalPolicy": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/AskForApproval"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "baseInstructions": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "compactPrompt": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "config": {
+ "additionalProperties": true,
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "cwd": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "developerInstructions": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "includeApplyPatchTool": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "model": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "modelProvider": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "profile": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "sandbox": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/SandboxMode"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "NewConversationResponse": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "conversationId": {
+ "$ref": "#/definitions/ThreadId"
+ },
+ "model": {
+ "type": "string"
+ },
+ "reasoningEffort": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ReasoningEffort"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "rolloutPath": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "conversationId",
+ "model",
+ "rolloutPath"
+ ],
+ "title": "NewConversationResponse",
+ "type": "object"
+ },
+ "ParsedCommand": {
+ "oneOf": [
+ {
+ "properties": {
+ "cmd": {
+ "type": "string"
+ },
+ "name": {
+ "type": "string"
+ },
+ "path": {
+ "description": "(Best effort) Path to the file being read by the command. When possible, this is an absolute path, though when relative, it should be resolved against the `cwd`` that will be used to run the command to derive the absolute path.",
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "read"
+ ],
+ "title": "ReadParsedCommandType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "cmd",
+ "name",
+ "path",
+ "type"
+ ],
+ "title": "ReadParsedCommand",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "cmd": {
+ "type": "string"
+ },
+ "path": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "list_files"
+ ],
+ "title": "ListFilesParsedCommandType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "cmd",
+ "type"
+ ],
+ "title": "ListFilesParsedCommand",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "cmd": {
+ "type": "string"
+ },
+ "path": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "query": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "search"
+ ],
+ "title": "SearchParsedCommandType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "cmd",
+ "type"
+ ],
+ "title": "SearchParsedCommand",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "cmd": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "unknown"
+ ],
+ "title": "UnknownParsedCommandType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "cmd",
+ "type"
+ ],
+ "title": "UnknownParsedCommand",
+ "type": "object"
+ }
+ ]
+ },
+ "PlanItemArg": {
+ "additionalProperties": false,
+ "properties": {
+ "status": {
+ "$ref": "#/definitions/StepStatus"
+ },
+ "step": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "status",
+ "step"
+ ],
+ "type": "object"
+ },
+ "PlanType": {
+ "enum": [
+ "free",
+ "go",
+ "plus",
+ "pro",
+ "team",
+ "business",
+ "enterprise",
+ "edu",
+ "unknown"
+ ],
+ "type": "string"
+ },
+ "Profile": {
+ "properties": {
+ "approvalPolicy": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/AskForApproval"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "chatgptBaseUrl": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "model": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "modelProvider": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "modelReasoningEffort": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ReasoningEffort"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "modelReasoningSummary": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ReasoningSummary"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "modelVerbosity": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Verbosity"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "RateLimitSnapshot": {
+ "properties": {
+ "credits": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/CreditsSnapshot"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "plan_type": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/PlanType"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "primary": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/RateLimitWindow"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "secondary": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/RateLimitWindow"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "RateLimitWindow": {
+ "properties": {
+ "resets_at": {
+ "description": "Unix timestamp (seconds since epoch) when the window resets.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "used_percent": {
+ "description": "Percentage (0-100) of the window that has been consumed.",
+ "format": "double",
+ "type": "number"
+ },
+ "window_minutes": {
+ "description": "Rolling window duration, in minutes.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "used_percent"
+ ],
+ "type": "object"
+ },
+ "ReasoningEffort": {
+ "description": "See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#get-started-with-reasoning",
+ "enum": [
+ "none",
+ "minimal",
+ "low",
+ "medium",
+ "high",
+ "xhigh"
+ ],
+ "type": "string"
+ },
+ "ReasoningItemContent": {
+ "oneOf": [
+ {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "reasoning_text"
+ ],
+ "title": "ReasoningTextReasoningItemContentType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "ReasoningTextReasoningItemContent",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "text"
+ ],
+ "title": "TextReasoningItemContentType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "TextReasoningItemContent",
+ "type": "object"
+ }
+ ]
+ },
+ "ReasoningItemReasoningSummary": {
+ "oneOf": [
+ {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "summary_text"
+ ],
+ "title": "SummaryTextReasoningItemReasoningSummaryType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "SummaryTextReasoningItemReasoningSummary",
+ "type": "object"
+ }
+ ]
+ },
+ "ReasoningSummary": {
+ "description": "A summary of the reasoning performed by the model. This can be useful for debugging and understanding the model's reasoning process. See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#reasoning-summaries",
+ "oneOf": [
+ {
+ "enum": [
+ "auto",
+ "concise",
+ "detailed"
+ ],
+ "type": "string"
+ },
+ {
+ "description": "Option to disable reasoning summaries.",
+ "enum": [
+ "none"
+ ],
+ "type": "string"
+ }
+ ]
+ },
+ "RemoveConversationListenerParams": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "subscriptionId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "subscriptionId"
+ ],
+ "title": "RemoveConversationListenerParams",
+ "type": "object"
+ },
+ "RemoveConversationSubscriptionResponse": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "title": "RemoveConversationSubscriptionResponse",
+ "type": "object"
+ },
+ "RequestId": {
+ "anyOf": [
+ {
+ "type": "string"
+ },
+ {
+ "format": "int64",
+ "type": "integer"
+ }
+ ]
+ },
+ "RequestUserInputQuestion": {
+ "properties": {
+ "header": {
+ "type": "string"
+ },
+ "id": {
+ "type": "string"
+ },
+ "isOther": {
+ "default": false,
+ "type": "boolean"
+ },
+ "isSecret": {
+ "default": false,
+ "type": "boolean"
+ },
+ "options": {
+ "items": {
+ "$ref": "#/definitions/RequestUserInputQuestionOption"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "question": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "header",
+ "id",
+ "question"
+ ],
+ "type": "object"
+ },
+ "RequestUserInputQuestionOption": {
+ "properties": {
+ "description": {
+ "type": "string"
+ },
+ "label": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "description",
+ "label"
+ ],
+ "type": "object"
+ },
+ "Resource": {
+ "description": "A known resource that the server is capable of reading.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "description": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "mimeType": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "name": {
+ "type": "string"
+ },
+ "size": {
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "title": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "uri": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "uri"
+ ],
+ "type": "object"
+ },
+ "ResourceLink": {
+ "description": "A resource that the server is capable of reading, included in a prompt or tool call result.\n\nNote: resource links returned by tools are not guaranteed to appear in the results of `resources/list` requests.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "description": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "mimeType": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "name": {
+ "type": "string"
+ },
+ "size": {
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "title": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "type": "string"
+ },
+ "uri": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "type",
+ "uri"
+ ],
+ "type": "object"
+ },
+ "ResourceTemplate": {
+ "description": "A template description for resources available on the server.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "description": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "mimeType": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "name": {
+ "type": "string"
+ },
+ "title": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "uriTemplate": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "uriTemplate"
+ ],
+ "type": "object"
+ },
+ "ResponseItem": {
+ "oneOf": [
+ {
+ "properties": {
+ "content": {
+ "items": {
+ "$ref": "#/definitions/ContentItem"
+ },
+ "type": "array"
+ },
+ "end_turn": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "id": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "writeOnly": true
+ },
+ "role": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "message"
+ ],
+ "title": "MessageResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "content",
+ "role",
+ "type"
+ ],
+ "title": "MessageResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "content": {
+ "default": null,
+ "items": {
+ "$ref": "#/definitions/ReasoningItemContent"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "encrypted_content": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "id": {
+ "type": "string",
+ "writeOnly": true
+ },
+ "summary": {
+ "items": {
+ "$ref": "#/definitions/ReasoningItemReasoningSummary"
+ },
+ "type": "array"
+ },
+ "type": {
+ "enum": [
+ "reasoning"
+ ],
+ "title": "ReasoningResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "summary",
+ "type"
+ ],
+ "title": "ReasoningResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "action": {
+ "$ref": "#/definitions/LocalShellAction"
+ },
+ "call_id": {
+ "description": "Set when using the Responses API.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "id": {
+ "description": "Set when using the chat completions API.",
+ "type": [
+ "string",
+ "null"
+ ],
+ "writeOnly": true
+ },
+ "status": {
+ "$ref": "#/definitions/LocalShellStatus"
+ },
+ "type": {
+ "enum": [
+ "local_shell_call"
+ ],
+ "title": "LocalShellCallResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "action",
+ "status",
+ "type"
+ ],
+ "title": "LocalShellCallResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "arguments": {
+ "type": "string"
+ },
+ "call_id": {
+ "type": "string"
+ },
+ "id": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "writeOnly": true
+ },
+ "name": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "function_call"
+ ],
+ "title": "FunctionCallResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "arguments",
+ "call_id",
+ "name",
+ "type"
+ ],
+ "title": "FunctionCallResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "call_id": {
+ "type": "string"
+ },
+ "output": {
+ "$ref": "#/definitions/FunctionCallOutputPayload"
+ },
+ "type": {
+ "enum": [
+ "function_call_output"
+ ],
+ "title": "FunctionCallOutputResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "output",
+ "type"
+ ],
+ "title": "FunctionCallOutputResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "call_id": {
+ "type": "string"
+ },
+ "id": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "writeOnly": true
+ },
+ "input": {
+ "type": "string"
+ },
+ "name": {
+ "type": "string"
+ },
+ "status": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "custom_tool_call"
+ ],
+ "title": "CustomToolCallResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "input",
+ "name",
+ "type"
+ ],
+ "title": "CustomToolCallResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "call_id": {
+ "type": "string"
+ },
+ "output": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "custom_tool_call_output"
+ ],
+ "title": "CustomToolCallOutputResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "output",
+ "type"
+ ],
+ "title": "CustomToolCallOutputResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "action": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/WebSearchAction"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "id": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "writeOnly": true
+ },
+ "status": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "web_search_call"
+ ],
+ "title": "WebSearchCallResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "WebSearchCallResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "ghost_commit": {
+ "$ref": "#/definitions/GhostCommit"
+ },
+ "type": {
+ "enum": [
+ "ghost_snapshot"
+ ],
+ "title": "GhostSnapshotResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "ghost_commit",
+ "type"
+ ],
+ "title": "GhostSnapshotResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "encrypted_content": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "compaction"
+ ],
+ "title": "CompactionResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "encrypted_content",
+ "type"
+ ],
+ "title": "CompactionResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "other"
+ ],
+ "title": "OtherResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "OtherResponseItem",
+ "type": "object"
+ }
+ ]
+ },
+ "Result_of_CallToolResult_or_String": {
+ "oneOf": [
+ {
+ "properties": {
+ "Ok": {
+ "$ref": "#/definitions/CallToolResult"
+ }
+ },
+ "required": [
+ "Ok"
+ ],
+ "title": "OkResult_of_CallToolResult_or_String",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "Err": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "Err"
+ ],
+ "title": "ErrResult_of_CallToolResult_or_String",
+ "type": "object"
+ }
+ ]
+ },
+ "ResumeConversationParams": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "conversationId": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ThreadId"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "history": {
+ "items": {
+ "$ref": "#/definitions/ResponseItem"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "overrides": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/NewConversationParams"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "path": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "title": "ResumeConversationParams",
+ "type": "object"
+ },
+ "ResumeConversationResponse": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "conversationId": {
+ "$ref": "#/definitions/ThreadId"
+ },
+ "initialMessages": {
+ "items": {
+ "$ref": "#/definitions/EventMsg"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "model": {
+ "type": "string"
+ },
+ "rolloutPath": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "conversationId",
+ "model",
+ "rolloutPath"
+ ],
+ "title": "ResumeConversationResponse",
+ "type": "object"
+ },
+ "ReviewCodeLocation": {
+ "description": "Location of the code related to a review finding.",
+ "properties": {
+ "absolute_file_path": {
+ "type": "string"
+ },
+ "line_range": {
+ "$ref": "#/definitions/ReviewLineRange"
+ }
+ },
+ "required": [
+ "absolute_file_path",
+ "line_range"
+ ],
+ "type": "object"
+ },
+ "ReviewDecision": {
+ "description": "User's decision in response to an ExecApprovalRequest.",
+ "oneOf": [
+ {
+ "description": "User has approved this command and the agent should execute it.",
+ "enum": [
+ "approved"
+ ],
+ "type": "string"
+ },
+ {
+ "additionalProperties": false,
+ "description": "User has approved this command and wants to apply the proposed execpolicy amendment so future matching commands are permitted.",
+ "properties": {
+ "approved_execpolicy_amendment": {
+ "properties": {
+ "proposed_execpolicy_amendment": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ }
+ },
+ "required": [
+ "proposed_execpolicy_amendment"
+ ],
+ "type": "object"
+ }
+ },
+ "required": [
+ "approved_execpolicy_amendment"
+ ],
+ "title": "ApprovedExecpolicyAmendmentReviewDecision",
+ "type": "object"
+ },
+ {
+ "description": "User has approved this command and wants to automatically approve any future identical instances (`command` and `cwd` match exactly) for the remainder of the session.",
+ "enum": [
+ "approved_for_session"
+ ],
+ "type": "string"
+ },
+ {
+ "description": "User has denied this command and the agent should not execute it, but it should continue the session and try something else.",
+ "enum": [
+ "denied"
+ ],
+ "type": "string"
+ },
+ {
+ "description": "User has denied this command and the agent should not do anything until the user's next command.",
+ "enum": [
+ "abort"
+ ],
+ "type": "string"
+ }
+ ]
+ },
+ "ReviewFinding": {
+ "description": "A single review finding describing an observed issue or recommendation.",
+ "properties": {
+ "body": {
+ "type": "string"
+ },
+ "code_location": {
+ "$ref": "#/definitions/ReviewCodeLocation"
+ },
+ "confidence_score": {
+ "format": "float",
+ "type": "number"
+ },
+ "priority": {
+ "format": "int32",
+ "type": "integer"
+ },
+ "title": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "body",
+ "code_location",
+ "confidence_score",
+ "priority",
+ "title"
+ ],
+ "type": "object"
+ },
+ "ReviewLineRange": {
+ "description": "Inclusive line range in a file associated with the finding.",
+ "properties": {
+ "end": {
+ "format": "uint32",
+ "minimum": 0.0,
+ "type": "integer"
+ },
+ "start": {
+ "format": "uint32",
+ "minimum": 0.0,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "end",
+ "start"
+ ],
+ "type": "object"
+ },
+ "ReviewOutputEvent": {
+ "description": "Structured review result produced by a child review session.",
+ "properties": {
+ "findings": {
+ "items": {
+ "$ref": "#/definitions/ReviewFinding"
+ },
+ "type": "array"
+ },
+ "overall_confidence_score": {
+ "format": "float",
+ "type": "number"
+ },
+ "overall_correctness": {
+ "type": "string"
+ },
+ "overall_explanation": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "findings",
+ "overall_confidence_score",
+ "overall_correctness",
+ "overall_explanation"
+ ],
+ "type": "object"
+ },
+ "ReviewTarget": {
+ "oneOf": [
+ {
+ "description": "Review the working tree: staged, unstaged, and untracked files.",
+ "properties": {
+ "type": {
+ "enum": [
+ "uncommittedChanges"
+ ],
+ "title": "UncommittedChangesReviewTargetType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "UncommittedChangesReviewTarget",
+ "type": "object"
+ },
+ {
+ "description": "Review changes between the current branch and the given base branch.",
+ "properties": {
+ "branch": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "baseBranch"
+ ],
+ "title": "BaseBranchReviewTargetType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "branch",
+ "type"
+ ],
+ "title": "BaseBranchReviewTarget",
+ "type": "object"
+ },
+ {
+ "description": "Review the changes introduced by a specific commit.",
+ "properties": {
+ "sha": {
+ "type": "string"
+ },
+ "title": {
+ "description": "Optional human-readable label (e.g., commit subject) for UIs.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "commit"
+ ],
+ "title": "CommitReviewTargetType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "sha",
+ "type"
+ ],
+ "title": "CommitReviewTarget",
+ "type": "object"
+ },
+ {
+ "description": "Arbitrary instructions provided by the user.",
+ "properties": {
+ "instructions": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "custom"
+ ],
+ "title": "CustomReviewTargetType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "instructions",
+ "type"
+ ],
+ "title": "CustomReviewTarget",
+ "type": "object"
+ }
+ ]
+ },
+ "Role": {
+ "description": "The sender or recipient of messages and data in a conversation.",
+ "enum": [
+ "assistant",
+ "user"
+ ],
+ "type": "string"
+ },
+ "SandboxMode": {
+ "enum": [
+ "read-only",
+ "workspace-write",
+ "danger-full-access"
+ ],
+ "type": "string"
+ },
+ "SandboxPolicy": {
+ "description": "Determines execution restrictions for model shell commands.",
+ "oneOf": [
+ {
+ "description": "No restrictions whatsoever. Use with caution.",
+ "properties": {
+ "type": {
+ "enum": [
+ "danger-full-access"
+ ],
+ "title": "DangerFullAccessSandboxPolicyType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "DangerFullAccessSandboxPolicy",
+ "type": "object"
+ },
+ {
+ "description": "Read-only access to the entire file-system.",
+ "properties": {
+ "type": {
+ "enum": [
+ "read-only"
+ ],
+ "title": "ReadOnlySandboxPolicyType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "ReadOnlySandboxPolicy",
+ "type": "object"
+ },
+ {
+ "description": "Indicates the process is already in an external sandbox. Allows full disk access while honoring the provided network setting.",
+ "properties": {
+ "network_access": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/NetworkAccess"
+ }
+ ],
+ "default": "restricted",
+ "description": "Whether the external sandbox permits outbound network traffic."
+ },
+ "type": {
+ "enum": [
+ "external-sandbox"
+ ],
+ "title": "ExternalSandboxSandboxPolicyType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "ExternalSandboxSandboxPolicy",
+ "type": "object"
+ },
+ {
+ "description": "Same as `ReadOnly` but additionally grants write access to the current working directory (\"workspace\").",
+ "properties": {
+ "exclude_slash_tmp": {
+ "default": false,
+ "description": "When set to `true`, will NOT include the `/tmp` among the default writable roots on UNIX. Defaults to `false`.",
+ "type": "boolean"
+ },
+ "exclude_tmpdir_env_var": {
+ "default": false,
+ "description": "When set to `true`, will NOT include the per-user `TMPDIR` environment variable among the default writable roots. Defaults to `false`.",
+ "type": "boolean"
+ },
+ "network_access": {
+ "default": false,
+ "description": "When set to `true`, outbound network access is allowed. `false` by default.",
+ "type": "boolean"
+ },
+ "type": {
+ "enum": [
+ "workspace-write"
+ ],
+ "title": "WorkspaceWriteSandboxPolicyType",
+ "type": "string"
+ },
+ "writable_roots": {
+ "description": "Additional folders (beyond cwd and possibly TMPDIR) that should be writable from within the sandbox.",
+ "items": {
+ "$ref": "#/definitions/AbsolutePathBuf"
+ },
+ "type": "array"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "WorkspaceWriteSandboxPolicy",
+ "type": "object"
+ }
+ ]
+ },
+ "SandboxSettings": {
+ "properties": {
+ "excludeSlashTmp": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "excludeTmpdirEnvVar": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "networkAccess": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "writableRoots": {
+ "default": [],
+ "items": {
+ "$ref": "#/definitions/AbsolutePathBuf"
+ },
+ "type": "array"
+ }
+ },
+ "type": "object"
+ },
+ "SendUserMessageParams": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "conversationId": {
+ "$ref": "#/definitions/ThreadId"
+ },
+ "items": {
+ "items": {
+ "$ref": "#/definitions/InputItem"
+ },
+ "type": "array"
+ }
+ },
+ "required": [
+ "conversationId",
+ "items"
+ ],
+ "title": "SendUserMessageParams",
+ "type": "object"
+ },
+ "SendUserMessageResponse": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "title": "SendUserMessageResponse",
+ "type": "object"
+ },
+ "SendUserTurnParams": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "approvalPolicy": {
+ "$ref": "#/definitions/AskForApproval"
+ },
+ "conversationId": {
+ "$ref": "#/definitions/ThreadId"
+ },
+ "cwd": {
+ "type": "string"
+ },
+ "effort": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ReasoningEffort"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "items": {
+ "items": {
+ "$ref": "#/definitions/InputItem"
+ },
+ "type": "array"
+ },
+ "model": {
+ "type": "string"
+ },
+ "outputSchema": {
+ "description": "Optional JSON Schema used to constrain the final assistant message for this turn."
+ },
+ "sandboxPolicy": {
+ "$ref": "#/definitions/SandboxPolicy"
+ },
+ "summary": {
+ "$ref": "#/definitions/ReasoningSummary"
+ }
+ },
+ "required": [
+ "approvalPolicy",
+ "conversationId",
+ "cwd",
+ "items",
+ "model",
+ "sandboxPolicy",
+ "summary"
+ ],
+ "title": "SendUserTurnParams",
+ "type": "object"
+ },
+ "SendUserTurnResponse": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "title": "SendUserTurnResponse",
+ "type": "object"
+ },
+ "ServerNotification": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "description": "Notification sent from the server to the client.",
+ "oneOf": [
+ {
+ "description": "NEW NOTIFICATIONS",
+ "properties": {
+ "method": {
+ "enum": [
+ "error"
+ ],
+ "title": "ErrorNotificationMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/v2/ErrorNotification"
+ }
+ },
+ "required": [
+ "method",
+ "params"
+ ],
+ "title": "ErrorNotification",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "method": {
+ "enum": [
+ "thread/started"
+ ],
+ "title": "Thread/startedNotificationMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/v2/ThreadStartedNotification"
+ }
+ },
+ "required": [
+ "method",
+ "params"
+ ],
+ "title": "Thread/startedNotification",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "method": {
+ "enum": [
+ "thread/name/updated"
+ ],
+ "title": "Thread/name/updatedNotificationMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/v2/ThreadNameUpdatedNotification"
+ }
+ },
+ "required": [
+ "method",
+ "params"
+ ],
+ "title": "Thread/name/updatedNotification",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "method": {
+ "enum": [
+ "thread/tokenUsage/updated"
+ ],
+ "title": "Thread/tokenUsage/updatedNotificationMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/v2/ThreadTokenUsageUpdatedNotification"
+ }
+ },
+ "required": [
+ "method",
+ "params"
+ ],
+ "title": "Thread/tokenUsage/updatedNotification",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "method": {
+ "enum": [
+ "turn/started"
+ ],
+ "title": "Turn/startedNotificationMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/v2/TurnStartedNotification"
+ }
+ },
+ "required": [
+ "method",
+ "params"
+ ],
+ "title": "Turn/startedNotification",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "method": {
+ "enum": [
+ "turn/completed"
+ ],
+ "title": "Turn/completedNotificationMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/v2/TurnCompletedNotification"
+ }
+ },
+ "required": [
+ "method",
+ "params"
+ ],
+ "title": "Turn/completedNotification",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "method": {
+ "enum": [
+ "turn/diff/updated"
+ ],
+ "title": "Turn/diff/updatedNotificationMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/v2/TurnDiffUpdatedNotification"
+ }
+ },
+ "required": [
+ "method",
+ "params"
+ ],
+ "title": "Turn/diff/updatedNotification",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "method": {
+ "enum": [
+ "turn/plan/updated"
+ ],
+ "title": "Turn/plan/updatedNotificationMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/v2/TurnPlanUpdatedNotification"
+ }
+ },
+ "required": [
+ "method",
+ "params"
+ ],
+ "title": "Turn/plan/updatedNotification",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "method": {
+ "enum": [
+ "item/started"
+ ],
+ "title": "Item/startedNotificationMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/v2/ItemStartedNotification"
+ }
+ },
+ "required": [
+ "method",
+ "params"
+ ],
+ "title": "Item/startedNotification",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "method": {
+ "enum": [
+ "item/completed"
+ ],
+ "title": "Item/completedNotificationMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/v2/ItemCompletedNotification"
+ }
+ },
+ "required": [
+ "method",
+ "params"
+ ],
+ "title": "Item/completedNotification",
+ "type": "object"
+ },
+ {
+ "description": "This event is internal-only. Used by Codex Cloud.",
+ "properties": {
+ "method": {
+ "enum": [
+ "rawResponseItem/completed"
+ ],
+ "title": "RawResponseItem/completedNotificationMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/v2/RawResponseItemCompletedNotification"
+ }
+ },
+ "required": [
+ "method",
+ "params"
+ ],
+ "title": "RawResponseItem/completedNotification",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "method": {
+ "enum": [
+ "item/agentMessage/delta"
+ ],
+ "title": "Item/agentMessage/deltaNotificationMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/v2/AgentMessageDeltaNotification"
+ }
+ },
+ "required": [
+ "method",
+ "params"
+ ],
+ "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/v2/PlanDeltaNotification"
+ }
+ },
+ "required": [
+ "method",
+ "params"
+ ],
+ "title": "Item/plan/deltaNotification",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "method": {
+ "enum": [
+ "item/commandExecution/outputDelta"
+ ],
+ "title": "Item/commandExecution/outputDeltaNotificationMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/v2/CommandExecutionOutputDeltaNotification"
+ }
+ },
+ "required": [
+ "method",
+ "params"
+ ],
+ "title": "Item/commandExecution/outputDeltaNotification",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "method": {
+ "enum": [
+ "item/commandExecution/terminalInteraction"
+ ],
+ "title": "Item/commandExecution/terminalInteractionNotificationMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/v2/TerminalInteractionNotification"
+ }
+ },
+ "required": [
+ "method",
+ "params"
+ ],
+ "title": "Item/commandExecution/terminalInteractionNotification",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "method": {
+ "enum": [
+ "item/fileChange/outputDelta"
+ ],
+ "title": "Item/fileChange/outputDeltaNotificationMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/v2/FileChangeOutputDeltaNotification"
+ }
+ },
+ "required": [
+ "method",
+ "params"
+ ],
+ "title": "Item/fileChange/outputDeltaNotification",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "method": {
+ "enum": [
+ "item/mcpToolCall/progress"
+ ],
+ "title": "Item/mcpToolCall/progressNotificationMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/v2/McpToolCallProgressNotification"
+ }
+ },
+ "required": [
+ "method",
+ "params"
+ ],
+ "title": "Item/mcpToolCall/progressNotification",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "method": {
+ "enum": [
+ "mcpServer/oauthLogin/completed"
+ ],
+ "title": "McpServer/oauthLogin/completedNotificationMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/v2/McpServerOauthLoginCompletedNotification"
+ }
+ },
+ "required": [
+ "method",
+ "params"
+ ],
+ "title": "McpServer/oauthLogin/completedNotification",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "method": {
+ "enum": [
+ "account/updated"
+ ],
+ "title": "Account/updatedNotificationMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/v2/AccountUpdatedNotification"
+ }
+ },
+ "required": [
+ "method",
+ "params"
+ ],
+ "title": "Account/updatedNotification",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "method": {
+ "enum": [
+ "account/rateLimits/updated"
+ ],
+ "title": "Account/rateLimits/updatedNotificationMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/v2/AccountRateLimitsUpdatedNotification"
+ }
+ },
+ "required": [
+ "method",
+ "params"
+ ],
+ "title": "Account/rateLimits/updatedNotification",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "method": {
+ "enum": [
+ "item/reasoning/summaryTextDelta"
+ ],
+ "title": "Item/reasoning/summaryTextDeltaNotificationMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/v2/ReasoningSummaryTextDeltaNotification"
+ }
+ },
+ "required": [
+ "method",
+ "params"
+ ],
+ "title": "Item/reasoning/summaryTextDeltaNotification",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "method": {
+ "enum": [
+ "item/reasoning/summaryPartAdded"
+ ],
+ "title": "Item/reasoning/summaryPartAddedNotificationMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/v2/ReasoningSummaryPartAddedNotification"
+ }
+ },
+ "required": [
+ "method",
+ "params"
+ ],
+ "title": "Item/reasoning/summaryPartAddedNotification",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "method": {
+ "enum": [
+ "item/reasoning/textDelta"
+ ],
+ "title": "Item/reasoning/textDeltaNotificationMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/v2/ReasoningTextDeltaNotification"
+ }
+ },
+ "required": [
+ "method",
+ "params"
+ ],
+ "title": "Item/reasoning/textDeltaNotification",
+ "type": "object"
+ },
+ {
+ "description": "Deprecated: Use `ContextCompaction` item type instead.",
+ "properties": {
+ "method": {
+ "enum": [
+ "thread/compacted"
+ ],
+ "title": "Thread/compactedNotificationMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/v2/ContextCompactedNotification"
+ }
+ },
+ "required": [
+ "method",
+ "params"
+ ],
+ "title": "Thread/compactedNotification",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "method": {
+ "enum": [
+ "deprecationNotice"
+ ],
+ "title": "DeprecationNoticeNotificationMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/v2/DeprecationNoticeNotification"
+ }
+ },
+ "required": [
+ "method",
+ "params"
+ ],
+ "title": "DeprecationNoticeNotification",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "method": {
+ "enum": [
+ "configWarning"
+ ],
+ "title": "ConfigWarningNotificationMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/v2/ConfigWarningNotification"
+ }
+ },
+ "required": [
+ "method",
+ "params"
+ ],
+ "title": "ConfigWarningNotification",
+ "type": "object"
+ },
+ {
+ "description": "Notifies the user of world-writable directories on Windows, which cannot be protected by the sandbox.",
+ "properties": {
+ "method": {
+ "enum": [
+ "windows/worldWritableWarning"
+ ],
+ "title": "Windows/worldWritableWarningNotificationMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/v2/WindowsWorldWritableWarningNotification"
+ }
+ },
+ "required": [
+ "method",
+ "params"
+ ],
+ "title": "Windows/worldWritableWarningNotification",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "method": {
+ "enum": [
+ "account/login/completed"
+ ],
+ "title": "Account/login/completedNotificationMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/v2/AccountLoginCompletedNotification"
+ }
+ },
+ "required": [
+ "method",
+ "params"
+ ],
+ "title": "Account/login/completedNotification",
+ "type": "object"
+ },
+ {
+ "description": "DEPRECATED NOTIFICATIONS below",
+ "properties": {
+ "method": {
+ "enum": [
+ "authStatusChange"
+ ],
+ "title": "AuthStatusChangeNotificationMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/AuthStatusChangeNotification"
+ }
+ },
+ "required": [
+ "method",
+ "params"
+ ],
+ "title": "AuthStatusChangeNotification",
+ "type": "object"
+ },
+ {
+ "description": "Deprecated: use `account/login/completed` instead.",
+ "properties": {
+ "method": {
+ "enum": [
+ "loginChatGptComplete"
+ ],
+ "title": "LoginChatGptCompleteNotificationMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/LoginChatGptCompleteNotification"
+ }
+ },
+ "required": [
+ "method",
+ "params"
+ ],
+ "title": "LoginChatGptCompleteNotification",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "method": {
+ "enum": [
+ "sessionConfigured"
+ ],
+ "title": "SessionConfiguredNotificationMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/SessionConfiguredNotification"
+ }
+ },
+ "required": [
+ "method",
+ "params"
+ ],
+ "title": "SessionConfiguredNotification",
+ "type": "object"
+ }
+ ],
+ "title": "ServerNotification"
+ },
+ "ServerRequest": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "description": "Request initiated from the server and sent to the client.",
+ "oneOf": [
+ {
+ "description": "NEW APIs Sent when approval is requested for a specific command execution. This request is used for Turns started via turn/start.",
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "item/commandExecution/requestApproval"
+ ],
+ "title": "Item/commandExecution/requestApprovalRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/CommandExecutionRequestApprovalParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "title": "Item/commandExecution/requestApprovalRequest",
+ "type": "object"
+ },
+ {
+ "description": "Sent when approval is requested for a specific file change. This request is used for Turns started via turn/start.",
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "item/fileChange/requestApproval"
+ ],
+ "title": "Item/fileChange/requestApprovalRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/FileChangeRequestApprovalParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "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": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "item/tool/call"
+ ],
+ "title": "Item/tool/callRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/DynamicToolCallParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "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": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "applyPatchApproval"
+ ],
+ "title": "ApplyPatchApprovalRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/ApplyPatchApprovalParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "title": "ApplyPatchApprovalRequest",
+ "type": "object"
+ },
+ {
+ "description": "Request to exec a command. This request is used for Turns started via the legacy APIs (i.e. SendUserTurn, SendUserMessage).",
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "method": {
+ "enum": [
+ "execCommandApproval"
+ ],
+ "title": "ExecCommandApprovalRequestMethod",
+ "type": "string"
+ },
+ "params": {
+ "$ref": "#/definitions/ExecCommandApprovalParams"
+ }
+ },
+ "required": [
+ "id",
+ "method",
+ "params"
+ ],
+ "title": "ExecCommandApprovalRequest",
+ "type": "object"
+ }
+ ],
+ "title": "ServerRequest"
+ },
+ "SessionConfiguredNotification": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "historyEntryCount": {
+ "format": "uint",
+ "minimum": 0.0,
+ "type": "integer"
+ },
+ "historyLogId": {
+ "format": "uint64",
+ "minimum": 0.0,
+ "type": "integer"
+ },
+ "initialMessages": {
+ "items": {
+ "$ref": "#/definitions/EventMsg"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "model": {
+ "type": "string"
+ },
+ "reasoningEffort": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ReasoningEffort"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "rolloutPath": {
+ "type": "string"
+ },
+ "sessionId": {
+ "$ref": "#/definitions/ThreadId"
+ }
+ },
+ "required": [
+ "historyEntryCount",
+ "historyLogId",
+ "model",
+ "rolloutPath",
+ "sessionId"
+ ],
+ "title": "SessionConfiguredNotification",
+ "type": "object"
+ },
+ "SessionSource": {
+ "oneOf": [
+ {
+ "enum": [
+ "cli",
+ "vscode",
+ "exec",
+ "mcp",
+ "unknown"
+ ],
+ "type": "string"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "subagent": {
+ "$ref": "#/definitions/SubAgentSource"
+ }
+ },
+ "required": [
+ "subagent"
+ ],
+ "title": "SubagentSessionSource",
+ "type": "object"
+ }
+ ]
+ },
+ "SetDefaultModelParams": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "model": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "reasoningEffort": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ReasoningEffort"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ }
+ },
+ "title": "SetDefaultModelParams",
+ "type": "object"
+ },
+ "SetDefaultModelResponse": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "title": "SetDefaultModelResponse",
+ "type": "object"
+ },
+ "SkillDependencies": {
+ "properties": {
+ "tools": {
+ "items": {
+ "$ref": "#/definitions/SkillToolDependency"
+ },
+ "type": "array"
+ }
+ },
+ "required": [
+ "tools"
+ ],
+ "type": "object"
+ },
+ "SkillErrorInfo": {
+ "properties": {
+ "message": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "message",
+ "path"
+ ],
+ "type": "object"
+ },
+ "SkillInterface": {
+ "properties": {
+ "brand_color": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "default_prompt": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "display_name": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "icon_large": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "icon_small": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "short_description": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "SkillMetadata": {
+ "properties": {
+ "dependencies": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/SkillDependencies"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "description": {
+ "type": "string"
+ },
+ "enabled": {
+ "type": "boolean"
+ },
+ "interface": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/SkillInterface"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "name": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "scope": {
+ "$ref": "#/definitions/SkillScope"
+ },
+ "short_description": {
+ "description": "Legacy short_description from SKILL.md. Prefer SKILL.json interface.short_description.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "description",
+ "enabled",
+ "name",
+ "path",
+ "scope"
+ ],
+ "type": "object"
+ },
+ "SkillScope": {
+ "enum": [
+ "user",
+ "repo",
+ "system",
+ "admin"
+ ],
+ "type": "string"
+ },
+ "SkillToolDependency": {
+ "properties": {
+ "command": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "description": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "transport": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "type": "string"
+ },
+ "url": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "value": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "value"
+ ],
+ "type": "object"
+ },
+ "SkillsListEntry": {
+ "properties": {
+ "cwd": {
+ "type": "string"
+ },
+ "errors": {
+ "items": {
+ "$ref": "#/definitions/SkillErrorInfo"
+ },
+ "type": "array"
+ },
+ "skills": {
+ "items": {
+ "$ref": "#/definitions/SkillMetadata"
+ },
+ "type": "array"
+ }
+ },
+ "required": [
+ "cwd",
+ "errors",
+ "skills"
+ ],
+ "type": "object"
+ },
+ "StepStatus": {
+ "enum": [
+ "pending",
+ "in_progress",
+ "completed"
+ ],
+ "type": "string"
+ },
+ "SubAgentSource": {
+ "oneOf": [
+ {
+ "enum": [
+ "review",
+ "compact"
+ ],
+ "type": "string"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "thread_spawn": {
+ "properties": {
+ "depth": {
+ "format": "int32",
+ "type": "integer"
+ },
+ "parent_thread_id": {
+ "$ref": "#/definitions/ThreadId"
+ }
+ },
+ "required": [
+ "depth",
+ "parent_thread_id"
+ ],
+ "type": "object"
+ }
+ },
+ "required": [
+ "thread_spawn"
+ ],
+ "title": "ThreadSpawnSubAgentSource",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "other": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "other"
+ ],
+ "title": "OtherSubAgentSource",
+ "type": "object"
+ }
+ ]
+ },
+ "TextContent": {
+ "description": "Text provided to or from an LLM.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "type": "object"
+ },
+ "TextElement": {
+ "properties": {
+ "byte_range": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ByteRange"
+ }
+ ],
+ "description": "Byte range in the parent `text` buffer that this element occupies."
+ },
+ "placeholder": {
+ "description": "Optional human-readable placeholder for the element, displayed in the UI.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "byte_range"
+ ],
+ "type": "object"
+ },
+ "TextResourceContents": {
+ "properties": {
+ "mimeType": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "text": {
+ "type": "string"
+ },
+ "uri": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "uri"
+ ],
+ "type": "object"
+ },
+ "ThreadId": {
+ "type": "string"
+ },
+ "TokenUsage": {
+ "properties": {
+ "cached_input_tokens": {
+ "format": "int64",
+ "type": "integer"
+ },
+ "input_tokens": {
+ "format": "int64",
+ "type": "integer"
+ },
+ "output_tokens": {
+ "format": "int64",
+ "type": "integer"
+ },
+ "reasoning_output_tokens": {
+ "format": "int64",
+ "type": "integer"
+ },
+ "total_tokens": {
+ "format": "int64",
+ "type": "integer"
+ }
+ },
+ "required": [
+ "cached_input_tokens",
+ "input_tokens",
+ "output_tokens",
+ "reasoning_output_tokens",
+ "total_tokens"
+ ],
+ "type": "object"
+ },
+ "TokenUsageInfo": {
+ "properties": {
+ "last_token_usage": {
+ "$ref": "#/definitions/TokenUsage"
+ },
+ "model_context_window": {
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "total_token_usage": {
+ "$ref": "#/definitions/TokenUsage"
+ }
+ },
+ "required": [
+ "last_token_usage",
+ "total_token_usage"
+ ],
+ "type": "object"
+ },
+ "Tool": {
+ "description": "Definition for a tool the client can call.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ToolAnnotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "description": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "inputSchema": {
+ "$ref": "#/definitions/ToolInputSchema"
+ },
+ "name": {
+ "type": "string"
+ },
+ "outputSchema": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ToolOutputSchema"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "title": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "inputSchema",
+ "name"
+ ],
+ "type": "object"
+ },
+ "ToolAnnotations": {
+ "description": "Additional properties describing a Tool to clients.\n\nNOTE: all properties in ToolAnnotations are **hints**. They are not guaranteed to provide a faithful description of tool behavior (including descriptive properties like `title`).\n\nClients should never make tool use decisions based on ToolAnnotations received from untrusted servers.",
+ "properties": {
+ "destructiveHint": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "idempotentHint": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "openWorldHint": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "readOnlyHint": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "title": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "ToolInputSchema": {
+ "description": "A JSON Schema object defining the expected parameters for the tool.",
+ "properties": {
+ "properties": true,
+ "required": {
+ "items": {
+ "type": "string"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "type": {
+ "default": "object",
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "ToolOutputSchema": {
+ "description": "An optional JSON Schema object defining the structure of the tool's output returned in the structuredContent field of a CallToolResult.",
+ "properties": {
+ "properties": true,
+ "required": {
+ "items": {
+ "type": "string"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "type": {
+ "default": "object",
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "ToolRequestUserInputAnswer": {
+ "description": "EXPERIMENTAL. Captures a user's answer to a request_user_input question.",
+ "properties": {
+ "answers": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ }
+ },
+ "required": [
+ "answers"
+ ],
+ "type": "object"
+ },
+ "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": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "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"
+ ],
+ "title": "ToolRequestUserInputParams",
+ "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"
+ },
+ "ToolRequestUserInputResponse": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "description": "EXPERIMENTAL. Response payload mapping question ids to answers.",
+ "properties": {
+ "answers": {
+ "additionalProperties": {
+ "$ref": "#/definitions/ToolRequestUserInputAnswer"
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "answers"
+ ],
+ "title": "ToolRequestUserInputResponse",
+ "type": "object"
+ },
+ "Tools": {
+ "properties": {
+ "viewImage": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "webSearch": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "TurnAbortReason": {
+ "enum": [
+ "interrupted",
+ "replaced",
+ "review_ended"
+ ],
+ "type": "string"
+ },
+ "TurnItem": {
+ "oneOf": [
+ {
+ "properties": {
+ "content": {
+ "items": {
+ "$ref": "#/definitions/UserInput"
+ },
+ "type": "array"
+ },
+ "id": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "UserMessage"
+ ],
+ "title": "UserMessageTurnItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "content",
+ "id",
+ "type"
+ ],
+ "title": "UserMessageTurnItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "content": {
+ "items": {
+ "$ref": "#/definitions/AgentMessageContent"
+ },
+ "type": "array"
+ },
+ "id": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "AgentMessage"
+ ],
+ "title": "AgentMessageTurnItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "content",
+ "id",
+ "type"
+ ],
+ "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": {
+ "type": "string"
+ },
+ "raw_content": {
+ "default": [],
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "summary_text": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "type": {
+ "enum": [
+ "Reasoning"
+ ],
+ "title": "ReasoningTurnItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "summary_text",
+ "type"
+ ],
+ "title": "ReasoningTurnItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "action": {
+ "$ref": "#/definitions/WebSearchAction"
+ },
+ "id": {
+ "type": "string"
+ },
+ "query": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "WebSearch"
+ ],
+ "title": "WebSearchTurnItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "action",
+ "id",
+ "query",
+ "type"
+ ],
+ "title": "WebSearchTurnItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "ContextCompaction"
+ ],
+ "title": "ContextCompactionTurnItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "type"
+ ],
+ "title": "ContextCompactionTurnItem",
+ "type": "object"
+ }
+ ]
+ },
+ "UserInfoResponse": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "allegedUserEmail": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "title": "UserInfoResponse",
+ "type": "object"
+ },
+ "UserInput": {
+ "description": "User input",
+ "oneOf": [
+ {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "text_elements": {
+ "default": [],
+ "description": "UI-defined spans within `text` that should be treated as special elements. These are byte ranges into the UTF-8 `text` buffer and are used to render or persist rich input markers (e.g., image placeholders) across history and resume without mutating the literal text.",
+ "items": {
+ "$ref": "#/definitions/TextElement"
+ },
+ "type": "array"
+ },
+ "type": {
+ "enum": [
+ "text"
+ ],
+ "title": "TextUserInputType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "TextUserInput",
+ "type": "object"
+ },
+ {
+ "description": "Pre‑encoded data: URI image.",
+ "properties": {
+ "image_url": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "image"
+ ],
+ "title": "ImageUserInputType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "image_url",
+ "type"
+ ],
+ "title": "ImageUserInput",
+ "type": "object"
+ },
+ {
+ "description": "Local image path provided by the user. This will be converted to an `Image` variant (base64 data URL) during request serialization.",
+ "properties": {
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "local_image"
+ ],
+ "title": "LocalImageUserInputType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "path",
+ "type"
+ ],
+ "title": "LocalImageUserInput",
+ "type": "object"
+ },
+ {
+ "description": "Skill selected by the user (name + path to SKILL.md).",
+ "properties": {
+ "name": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "skill"
+ ],
+ "title": "SkillUserInputType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "path",
+ "type"
+ ],
+ "title": "SkillUserInput",
+ "type": "object"
+ },
+ {
+ "description": "Explicit mention selected by the user (name + app://connector id).",
+ "properties": {
+ "name": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "mention"
+ ],
+ "title": "MentionUserInputType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "path",
+ "type"
+ ],
+ "title": "MentionUserInput",
+ "type": "object"
+ }
+ ]
+ },
+ "UserSavedConfig": {
+ "properties": {
+ "approvalPolicy": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/AskForApproval"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "forcedChatgptWorkspaceId": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "forcedLoginMethod": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ForcedLoginMethod"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "model": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "modelReasoningEffort": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ReasoningEffort"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "modelReasoningSummary": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ReasoningSummary"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "modelVerbosity": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Verbosity"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "profile": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "profiles": {
+ "additionalProperties": {
+ "$ref": "#/definitions/Profile"
+ },
+ "type": "object"
+ },
+ "sandboxMode": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/SandboxMode"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "sandboxSettings": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/SandboxSettings"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "tools": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Tools"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ }
+ },
+ "required": [
+ "profiles"
+ ],
+ "type": "object"
+ },
+ "V1ByteRange": {
+ "properties": {
+ "end": {
+ "description": "End byte offset (exclusive) within the UTF-8 text buffer.",
+ "format": "uint",
+ "minimum": 0.0,
+ "type": "integer"
+ },
+ "start": {
+ "description": "Start byte offset (inclusive) within the UTF-8 text buffer.",
+ "format": "uint",
+ "minimum": 0.0,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "end",
+ "start"
+ ],
+ "type": "object"
+ },
+ "V1TextElement": {
+ "properties": {
+ "byteRange": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/V1ByteRange"
+ }
+ ],
+ "description": "Byte range in the parent `text` buffer that this element occupies."
+ },
+ "placeholder": {
+ "description": "Optional human-readable placeholder for the element, displayed in the UI.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "byteRange"
+ ],
+ "type": "object"
+ },
+ "Verbosity": {
+ "description": "Controls output length/detail on GPT-5 models via the Responses API. Serialized with lowercase values to match the OpenAI API.",
+ "enum": [
+ "low",
+ "medium",
+ "high"
+ ],
+ "type": "string"
+ },
+ "WebSearchAction": {
+ "oneOf": [
+ {
+ "properties": {
+ "queries": {
+ "items": {
+ "type": "string"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "query": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "search"
+ ],
+ "title": "SearchWebSearchActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "SearchWebSearchAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "open_page"
+ ],
+ "title": "OpenPageWebSearchActionType",
+ "type": "string"
+ },
+ "url": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "OpenPageWebSearchAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "pattern": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "find_in_page"
+ ],
+ "title": "FindInPageWebSearchActionType",
+ "type": "string"
+ },
+ "url": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "FindInPageWebSearchAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "other"
+ ],
+ "title": "OtherWebSearchActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "OtherWebSearchAction",
+ "type": "object"
+ }
+ ]
+ },
+ "v2": {
+ "AbsolutePathBuf": {
+ "description": "A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem).\n\nIMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set, the deserialization will fail unless the path being deserialized is already absolute.",
+ "type": "string"
+ },
+ "Account": {
+ "oneOf": [
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "apiKey"
+ ],
+ "title": "ApiKeyAccountType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "ApiKeyAccount",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "email": {
+ "type": "string"
+ },
+ "planType": {
+ "$ref": "#/definitions/v2/PlanType"
+ },
+ "type": {
+ "enum": [
+ "chatgpt"
+ ],
+ "title": "ChatgptAccountType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "email",
+ "planType",
+ "type"
+ ],
+ "title": "ChatgptAccount",
+ "type": "object"
+ }
+ ]
+ },
+ "AccountLoginCompletedNotification": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "error": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "loginId": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "success": {
+ "type": "boolean"
+ }
+ },
+ "required": [
+ "success"
+ ],
+ "title": "AccountLoginCompletedNotification",
+ "type": "object"
+ },
+ "AccountRateLimitsUpdatedNotification": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "rateLimits": {
+ "$ref": "#/definitions/v2/RateLimitSnapshot"
+ }
+ },
+ "required": [
+ "rateLimits"
+ ],
+ "title": "AccountRateLimitsUpdatedNotification",
+ "type": "object"
+ },
+ "AccountUpdatedNotification": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "authMode": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/v2/AuthMode"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ }
+ },
+ "title": "AccountUpdatedNotification",
+ "type": "object"
+ },
+ "AgentMessageDeltaNotification": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "delta": {
+ "type": "string"
+ },
+ "itemId": {
+ "type": "string"
+ },
+ "threadId": {
+ "type": "string"
+ },
+ "turnId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "delta",
+ "itemId",
+ "threadId",
+ "turnId"
+ ],
+ "title": "AgentMessageDeltaNotification",
+ "type": "object"
+ },
+ "AnalyticsConfig": {
+ "additionalProperties": true,
+ "properties": {
+ "enabled": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "Annotations": {
+ "description": "Optional annotations for the client. The client can use annotations to inform how objects are used or displayed",
+ "properties": {
+ "audience": {
+ "items": {
+ "$ref": "#/definitions/v2/Role"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "lastModified": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "priority": {
+ "format": "double",
+ "type": [
+ "number",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "AppInfo": {
+ "properties": {
+ "description": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "distributionChannel": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "id": {
+ "type": "string"
+ },
+ "installUrl": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "isAccessible": {
+ "default": false,
+ "type": "boolean"
+ },
+ "logoUrl": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "logoUrlDark": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "name": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "name"
+ ],
+ "type": "object"
+ },
+ "AppsListParams": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "cursor": {
+ "description": "Opaque pagination cursor returned by a previous call.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "limit": {
+ "description": "Optional page size; defaults to a reasonable server-side value.",
+ "format": "uint32",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "title": "AppsListParams",
+ "type": "object"
+ },
+ "AppsListResponse": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "data": {
+ "items": {
+ "$ref": "#/definitions/v2/AppInfo"
+ },
+ "type": "array"
+ },
+ "nextCursor": {
+ "description": "Opaque cursor to pass to the next call to continue after the last item. If None, there are no more items to return.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "data"
+ ],
+ "title": "AppsListResponse",
+ "type": "object"
+ },
+ "AskForApproval": {
+ "enum": [
+ "untrusted",
+ "on-failure",
+ "on-request",
+ "never"
+ ],
+ "type": "string"
+ },
+ "AudioContent": {
+ "description": "Audio provided to or from an LLM.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/v2/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "data": {
+ "type": "string"
+ },
+ "mimeType": {
+ "type": "string"
+ },
+ "type": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "data",
+ "mimeType",
+ "type"
+ ],
+ "type": "object"
+ },
+ "AuthMode": {
+ "description": "Authentication mode for OpenAI-backed providers.",
+ "oneOf": [
+ {
+ "description": "OpenAI API key provided by the caller and stored by Codex.",
+ "enum": [
+ "apikey"
+ ],
+ "type": "string"
+ },
+ {
+ "description": "ChatGPT OAuth managed by Codex (tokens persisted and refreshed by Codex).",
+ "enum": [
+ "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"
+ }
+ ]
+ },
+ "BlobResourceContents": {
+ "properties": {
+ "blob": {
+ "type": "string"
+ },
+ "mimeType": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "uri": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "blob",
+ "uri"
+ ],
+ "type": "object"
+ },
+ "ByteRange": {
+ "properties": {
+ "end": {
+ "format": "uint",
+ "minimum": 0.0,
+ "type": "integer"
+ },
+ "start": {
+ "format": "uint",
+ "minimum": 0.0,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "end",
+ "start"
+ ],
+ "type": "object"
+ },
+ "CancelLoginAccountParams": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "loginId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "loginId"
+ ],
+ "title": "CancelLoginAccountParams",
+ "type": "object"
+ },
+ "CancelLoginAccountResponse": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "status": {
+ "$ref": "#/definitions/v2/CancelLoginAccountStatus"
+ }
+ },
+ "required": [
+ "status"
+ ],
+ "title": "CancelLoginAccountResponse",
+ "type": "object"
+ },
+ "CancelLoginAccountStatus": {
+ "enum": [
+ "canceled",
+ "notFound"
+ ],
+ "type": "string"
+ },
+ "CodexErrorInfo": {
+ "description": "This translation layer make sure that we expose codex error code in camel case.\n\nWhen an upstream HTTP status is available (for example, from the Responses API or a provider), it is forwarded in `httpStatusCode` on the relevant `codexErrorInfo` variant.",
+ "oneOf": [
+ {
+ "enum": [
+ "contextWindowExceeded",
+ "usageLimitExceeded",
+ "internalServerError",
+ "unauthorized",
+ "badRequest",
+ "threadRollbackFailed",
+ "sandboxError",
+ "other"
+ ],
+ "type": "string"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "modelCap": {
+ "properties": {
+ "model": {
+ "type": "string"
+ },
+ "reset_after_seconds": {
+ "format": "uint64",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "model"
+ ],
+ "type": "object"
+ }
+ },
+ "required": [
+ "modelCap"
+ ],
+ "title": "ModelCapCodexErrorInfo",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "httpConnectionFailed": {
+ "properties": {
+ "httpStatusCode": {
+ "format": "uint16",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "httpConnectionFailed"
+ ],
+ "title": "HttpConnectionFailedCodexErrorInfo",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "Failed to connect to the response SSE stream.",
+ "properties": {
+ "responseStreamConnectionFailed": {
+ "properties": {
+ "httpStatusCode": {
+ "format": "uint16",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "responseStreamConnectionFailed"
+ ],
+ "title": "ResponseStreamConnectionFailedCodexErrorInfo",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "The response SSE stream disconnected in the middle of a turn before completion.",
+ "properties": {
+ "responseStreamDisconnected": {
+ "properties": {
+ "httpStatusCode": {
+ "format": "uint16",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "responseStreamDisconnected"
+ ],
+ "title": "ResponseStreamDisconnectedCodexErrorInfo",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "Reached the retry limit for responses.",
+ "properties": {
+ "responseTooManyFailedAttempts": {
+ "properties": {
+ "httpStatusCode": {
+ "format": "uint16",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "responseTooManyFailedAttempts"
+ ],
+ "title": "ResponseTooManyFailedAttemptsCodexErrorInfo",
+ "type": "object"
+ }
+ ]
+ },
+ "CollabAgentState": {
+ "properties": {
+ "message": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "status": {
+ "$ref": "#/definitions/v2/CollabAgentStatus"
+ }
+ },
+ "required": [
+ "status"
+ ],
+ "type": "object"
+ },
+ "CollabAgentStatus": {
+ "enum": [
+ "pendingInit",
+ "running",
+ "completed",
+ "errored",
+ "shutdown",
+ "notFound"
+ ],
+ "type": "string"
+ },
+ "CollabAgentTool": {
+ "enum": [
+ "spawnAgent",
+ "sendInput",
+ "wait",
+ "closeAgent"
+ ],
+ "type": "string"
+ },
+ "CollabAgentToolCallStatus": {
+ "enum": [
+ "inProgress",
+ "completed",
+ "failed"
+ ],
+ "type": "string"
+ },
+ "CollaborationMode": {
+ "description": "Collaboration mode for a Codex session.",
+ "properties": {
+ "mode": {
+ "$ref": "#/definitions/v2/ModeKind"
+ },
+ "settings": {
+ "$ref": "#/definitions/v2/Settings"
+ }
+ },
+ "required": [
+ "mode",
+ "settings"
+ ],
+ "type": "object"
+ },
+ "CollaborationModeMask": {
+ "description": "A mask for collaboration mode settings, allowing partial updates. All fields except `name` are optional, enabling selective updates.",
+ "properties": {
+ "developer_instructions": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "mode": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/v2/ModeKind"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "model": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "name": {
+ "type": "string"
+ },
+ "reasoning_effort": {
+ "anyOf": [
+ {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/v2/ReasoningEffort"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ {
+ "type": "null"
+ }
+ ]
+ }
+ },
+ "required": [
+ "name"
+ ],
+ "type": "object"
+ },
+ "CommandAction": {
+ "oneOf": [
+ {
+ "properties": {
+ "command": {
+ "type": "string"
+ },
+ "name": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "read"
+ ],
+ "title": "ReadCommandActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "command",
+ "name",
+ "path",
+ "type"
+ ],
+ "title": "ReadCommandAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "command": {
+ "type": "string"
+ },
+ "path": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "listFiles"
+ ],
+ "title": "ListFilesCommandActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "command",
+ "type"
+ ],
+ "title": "ListFilesCommandAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "command": {
+ "type": "string"
+ },
+ "path": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "query": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "search"
+ ],
+ "title": "SearchCommandActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "command",
+ "type"
+ ],
+ "title": "SearchCommandAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "command": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "unknown"
+ ],
+ "title": "UnknownCommandActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "command",
+ "type"
+ ],
+ "title": "UnknownCommandAction",
+ "type": "object"
+ }
+ ]
+ },
+ "CommandExecParams": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "command": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "cwd": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "sandboxPolicy": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/v2/SandboxPolicy"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "timeoutMs": {
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "command"
+ ],
+ "title": "CommandExecParams",
+ "type": "object"
+ },
+ "CommandExecResponse": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "exitCode": {
+ "format": "int32",
+ "type": "integer"
+ },
+ "stderr": {
+ "type": "string"
+ },
+ "stdout": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "exitCode",
+ "stderr",
+ "stdout"
+ ],
+ "title": "CommandExecResponse",
+ "type": "object"
+ },
+ "CommandExecutionOutputDeltaNotification": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "delta": {
+ "type": "string"
+ },
+ "itemId": {
+ "type": "string"
+ },
+ "threadId": {
+ "type": "string"
+ },
+ "turnId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "delta",
+ "itemId",
+ "threadId",
+ "turnId"
+ ],
+ "title": "CommandExecutionOutputDeltaNotification",
+ "type": "object"
+ },
+ "CommandExecutionStatus": {
+ "enum": [
+ "inProgress",
+ "completed",
+ "failed",
+ "declined"
+ ],
+ "type": "string"
+ },
+ "Config": {
+ "additionalProperties": true,
+ "properties": {
+ "analytics": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/v2/AnalyticsConfig"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "approval_policy": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/v2/AskForApproval"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "compact_prompt": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "developer_instructions": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "forced_chatgpt_workspace_id": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "forced_login_method": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/v2/ForcedLoginMethod"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "instructions": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "model": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "model_auto_compact_token_limit": {
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "model_context_window": {
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "model_provider": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "model_reasoning_effort": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/v2/ReasoningEffort"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "model_reasoning_summary": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/v2/ReasoningSummary"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "model_verbosity": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/v2/Verbosity"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "profile": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "profiles": {
+ "additionalProperties": {
+ "$ref": "#/definitions/v2/ProfileV2"
+ },
+ "default": {},
+ "type": "object"
+ },
+ "review_model": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "sandbox_mode": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/v2/SandboxMode"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "sandbox_workspace_write": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/v2/SandboxWorkspaceWrite"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "tools": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/v2/ToolsV2"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "web_search": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/v2/WebSearchMode"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "ConfigBatchWriteParams": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "edits": {
+ "items": {
+ "$ref": "#/definitions/v2/ConfigEdit"
+ },
+ "type": "array"
+ },
+ "expectedVersion": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "filePath": {
+ "description": "Path to the config file to write; defaults to the user's `config.toml` when omitted.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "edits"
+ ],
+ "title": "ConfigBatchWriteParams",
+ "type": "object"
+ },
+ "ConfigEdit": {
+ "properties": {
+ "keyPath": {
+ "type": "string"
+ },
+ "mergeStrategy": {
+ "$ref": "#/definitions/v2/MergeStrategy"
+ },
+ "value": true
+ },
+ "required": [
+ "keyPath",
+ "mergeStrategy",
+ "value"
+ ],
+ "type": "object"
+ },
+ "ConfigLayer": {
+ "properties": {
+ "config": true,
+ "disabledReason": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "name": {
+ "$ref": "#/definitions/v2/ConfigLayerSource"
+ },
+ "version": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "config",
+ "name",
+ "version"
+ ],
+ "type": "object"
+ },
+ "ConfigLayerMetadata": {
+ "properties": {
+ "name": {
+ "$ref": "#/definitions/v2/ConfigLayerSource"
+ },
+ "version": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "version"
+ ],
+ "type": "object"
+ },
+ "ConfigLayerSource": {
+ "oneOf": [
+ {
+ "description": "Managed preferences layer delivered by MDM (macOS only).",
+ "properties": {
+ "domain": {
+ "type": "string"
+ },
+ "key": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "mdm"
+ ],
+ "title": "MdmConfigLayerSourceType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "domain",
+ "key",
+ "type"
+ ],
+ "title": "MdmConfigLayerSource",
+ "type": "object"
+ },
+ {
+ "description": "Managed config layer from a file (usually `managed_config.toml`).",
+ "properties": {
+ "file": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/v2/AbsolutePathBuf"
+ }
+ ],
+ "description": "This is the path to the system config.toml file, though it is not guaranteed to exist."
+ },
+ "type": {
+ "enum": [
+ "system"
+ ],
+ "title": "SystemConfigLayerSourceType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "file",
+ "type"
+ ],
+ "title": "SystemConfigLayerSource",
+ "type": "object"
+ },
+ {
+ "description": "User config layer from $CODEX_HOME/config.toml. This layer is special in that it is expected to be: - writable by the user - generally outside the workspace directory",
+ "properties": {
+ "file": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/v2/AbsolutePathBuf"
+ }
+ ],
+ "description": "This is the path to the user's config.toml file, though it is not guaranteed to exist."
+ },
+ "type": {
+ "enum": [
+ "user"
+ ],
+ "title": "UserConfigLayerSourceType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "file",
+ "type"
+ ],
+ "title": "UserConfigLayerSource",
+ "type": "object"
+ },
+ {
+ "description": "Path to a .codex/ folder within a project. There could be multiple of these between `cwd` and the project/repo root.",
+ "properties": {
+ "dotCodexFolder": {
+ "$ref": "#/definitions/v2/AbsolutePathBuf"
+ },
+ "type": {
+ "enum": [
+ "project"
+ ],
+ "title": "ProjectConfigLayerSourceType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "dotCodexFolder",
+ "type"
+ ],
+ "title": "ProjectConfigLayerSource",
+ "type": "object"
+ },
+ {
+ "description": "Session-layer overrides supplied via `-c`/`--config`.",
+ "properties": {
+ "type": {
+ "enum": [
+ "sessionFlags"
+ ],
+ "title": "SessionFlagsConfigLayerSourceType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "SessionFlagsConfigLayerSource",
+ "type": "object"
+ },
+ {
+ "description": "`managed_config.toml` was designed to be a config that was loaded as the last layer on top of everything else. This scheme did not quite work out as intended, but we keep this variant as a \"best effort\" while we phase out `managed_config.toml` in favor of `requirements.toml`.",
+ "properties": {
+ "file": {
+ "$ref": "#/definitions/v2/AbsolutePathBuf"
+ },
+ "type": {
+ "enum": [
+ "legacyManagedConfigTomlFromFile"
+ ],
+ "title": "LegacyManagedConfigTomlFromFileConfigLayerSourceType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "file",
+ "type"
+ ],
+ "title": "LegacyManagedConfigTomlFromFileConfigLayerSource",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "legacyManagedConfigTomlFromMdm"
+ ],
+ "title": "LegacyManagedConfigTomlFromMdmConfigLayerSourceType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "LegacyManagedConfigTomlFromMdmConfigLayerSource",
+ "type": "object"
+ }
+ ]
+ },
+ "ConfigReadParams": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "cwd": {
+ "description": "Optional working directory to resolve project config layers. If specified, return the effective config as seen from that directory (i.e., including any project layers between `cwd` and the project/repo root).",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "includeLayers": {
+ "default": false,
+ "type": "boolean"
+ }
+ },
+ "title": "ConfigReadParams",
+ "type": "object"
+ },
+ "ConfigReadResponse": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "config": {
+ "$ref": "#/definitions/v2/Config"
+ },
+ "layers": {
+ "items": {
+ "$ref": "#/definitions/v2/ConfigLayer"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "origins": {
+ "additionalProperties": {
+ "$ref": "#/definitions/v2/ConfigLayerMetadata"
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "config",
+ "origins"
+ ],
+ "title": "ConfigReadResponse",
+ "type": "object"
+ },
+ "ConfigRequirements": {
+ "properties": {
+ "allowedApprovalPolicies": {
+ "items": {
+ "$ref": "#/definitions/v2/AskForApproval"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "allowedSandboxModes": {
+ "items": {
+ "$ref": "#/definitions/v2/SandboxMode"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "enforceResidency": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/v2/ResidencyRequirement"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "ConfigRequirementsReadResponse": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "requirements": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/v2/ConfigRequirements"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Null if no requirements are configured (e.g. no requirements.toml/MDM entries)."
+ }
+ },
+ "title": "ConfigRequirementsReadResponse",
+ "type": "object"
+ },
+ "ConfigValueWriteParams": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "expectedVersion": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "filePath": {
+ "description": "Path to the config file to write; defaults to the user's `config.toml` when omitted.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "keyPath": {
+ "type": "string"
+ },
+ "mergeStrategy": {
+ "$ref": "#/definitions/v2/MergeStrategy"
+ },
+ "value": true
+ },
+ "required": [
+ "keyPath",
+ "mergeStrategy",
+ "value"
+ ],
+ "title": "ConfigValueWriteParams",
+ "type": "object"
+ },
+ "ConfigWarningNotification": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "details": {
+ "description": "Optional extra guidance or error details.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "path": {
+ "description": "Optional path to the config file that triggered the warning.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "range": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/v2/TextRange"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Optional range for the error location inside the config file."
+ },
+ "summary": {
+ "description": "Concise summary of the warning.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "summary"
+ ],
+ "title": "ConfigWarningNotification",
+ "type": "object"
+ },
+ "ConfigWriteResponse": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "filePath": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/v2/AbsolutePathBuf"
+ }
+ ],
+ "description": "Canonical path to the config file that was written."
+ },
+ "overriddenMetadata": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/v2/OverriddenMetadata"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "status": {
+ "$ref": "#/definitions/v2/WriteStatus"
+ },
+ "version": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "filePath",
+ "status",
+ "version"
+ ],
+ "title": "ConfigWriteResponse",
+ "type": "object"
+ },
+ "ContentBlock": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/v2/TextContent"
+ },
+ {
+ "$ref": "#/definitions/v2/ImageContent"
+ },
+ {
+ "$ref": "#/definitions/v2/AudioContent"
+ },
+ {
+ "$ref": "#/definitions/v2/ResourceLink"
+ },
+ {
+ "$ref": "#/definitions/v2/EmbeddedResource"
+ }
+ ]
+ },
+ "ContentItem": {
+ "oneOf": [
+ {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "input_text"
+ ],
+ "title": "InputTextContentItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "InputTextContentItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "image_url": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "input_image"
+ ],
+ "title": "InputImageContentItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "image_url",
+ "type"
+ ],
+ "title": "InputImageContentItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "output_text"
+ ],
+ "title": "OutputTextContentItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "OutputTextContentItem",
+ "type": "object"
+ }
+ ]
+ },
+ "ContextCompactedNotification": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "description": "Deprecated: Use `ContextCompaction` item type instead.",
+ "properties": {
+ "threadId": {
+ "type": "string"
+ },
+ "turnId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "threadId",
+ "turnId"
+ ],
+ "title": "ContextCompactedNotification",
+ "type": "object"
+ },
+ "CreditsSnapshot": {
+ "properties": {
+ "balance": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "hasCredits": {
+ "type": "boolean"
+ },
+ "unlimited": {
+ "type": "boolean"
+ }
+ },
+ "required": [
+ "hasCredits",
+ "unlimited"
+ ],
+ "type": "object"
+ },
+ "DeprecationNoticeNotification": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "details": {
+ "description": "Optional extra guidance, such as migration steps or rationale.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "summary": {
+ "description": "Concise summary of what is deprecated.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "summary"
+ ],
+ "title": "DeprecationNoticeNotification",
+ "type": "object"
+ },
+ "DynamicToolSpec": {
+ "properties": {
+ "description": {
+ "type": "string"
+ },
+ "inputSchema": true,
+ "name": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "description",
+ "inputSchema",
+ "name"
+ ],
+ "type": "object"
+ },
+ "EmbeddedResource": {
+ "description": "The contents of a resource, embedded into a prompt or tool call result.\n\nIt is up to the client how best to render embedded resources for the benefit of the LLM and/or the user.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/v2/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "resource": {
+ "$ref": "#/definitions/v2/EmbeddedResourceResource"
+ },
+ "type": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "resource",
+ "type"
+ ],
+ "type": "object"
+ },
+ "EmbeddedResourceResource": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/v2/TextResourceContents"
+ },
+ {
+ "$ref": "#/definitions/v2/BlobResourceContents"
+ }
+ ]
+ },
+ "ErrorNotification": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "error": {
+ "$ref": "#/definitions/v2/TurnError"
+ },
+ "threadId": {
+ "type": "string"
+ },
+ "turnId": {
+ "type": "string"
+ },
+ "willRetry": {
+ "type": "boolean"
+ }
+ },
+ "required": [
+ "error",
+ "threadId",
+ "turnId",
+ "willRetry"
+ ],
+ "title": "ErrorNotification",
+ "type": "object"
+ },
+ "FeedbackUploadParams": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "classification": {
+ "type": "string"
+ },
+ "includeLogs": {
+ "type": "boolean"
+ },
+ "reason": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "threadId": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "classification",
+ "includeLogs"
+ ],
+ "title": "FeedbackUploadParams",
+ "type": "object"
+ },
+ "FeedbackUploadResponse": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "threadId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "threadId"
+ ],
+ "title": "FeedbackUploadResponse",
+ "type": "object"
+ },
+ "FileChangeOutputDeltaNotification": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "delta": {
+ "type": "string"
+ },
+ "itemId": {
+ "type": "string"
+ },
+ "threadId": {
+ "type": "string"
+ },
+ "turnId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "delta",
+ "itemId",
+ "threadId",
+ "turnId"
+ ],
+ "title": "FileChangeOutputDeltaNotification",
+ "type": "object"
+ },
+ "FileUpdateChange": {
+ "properties": {
+ "diff": {
+ "type": "string"
+ },
+ "kind": {
+ "$ref": "#/definitions/v2/PatchChangeKind"
+ },
+ "path": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "diff",
+ "kind",
+ "path"
+ ],
+ "type": "object"
+ },
+ "ForcedLoginMethod": {
+ "enum": [
+ "chatgpt",
+ "api"
+ ],
+ "type": "string"
+ },
+ "FunctionCallOutputContentItem": {
+ "description": "Responses API compatible content items that can be returned by a tool call. This is a subset of ContentItem with the types we support as function call outputs.",
+ "oneOf": [
+ {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "input_text"
+ ],
+ "title": "InputTextFunctionCallOutputContentItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "InputTextFunctionCallOutputContentItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "image_url": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "input_image"
+ ],
+ "title": "InputImageFunctionCallOutputContentItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "image_url",
+ "type"
+ ],
+ "title": "InputImageFunctionCallOutputContentItem",
+ "type": "object"
+ }
+ ]
+ },
+ "FunctionCallOutputPayload": {
+ "description": "The payload we send back to OpenAI when reporting a tool call result.\n\n`content` preserves the historical plain-string payload so downstream integrations (tests, logging, etc.) can keep treating tool output as `String`. When an MCP server returns richer data we additionally populate `content_items` with the structured form that the Responses/Chat Completions APIs understand.",
+ "properties": {
+ "content": {
+ "type": "string"
+ },
+ "content_items": {
+ "items": {
+ "$ref": "#/definitions/v2/FunctionCallOutputContentItem"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "success": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "content"
+ ],
+ "type": "object"
+ },
+ "GetAccountParams": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "refreshToken": {
+ "default": false,
+ "description": "When `true`, requests a proactive token refresh before returning.\n\nIn managed auth mode this triggers the normal refresh-token flow. In external auth mode this flag is ignored. Clients should refresh tokens themselves and call `account/login/start` with `chatgptAuthTokens`.",
+ "type": "boolean"
+ }
+ },
+ "title": "GetAccountParams",
+ "type": "object"
+ },
+ "GetAccountRateLimitsResponse": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "rateLimits": {
+ "$ref": "#/definitions/v2/RateLimitSnapshot"
+ }
+ },
+ "required": [
+ "rateLimits"
+ ],
+ "title": "GetAccountRateLimitsResponse",
+ "type": "object"
+ },
+ "GetAccountResponse": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "account": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/v2/Account"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "requiresOpenaiAuth": {
+ "type": "boolean"
+ }
+ },
+ "required": [
+ "requiresOpenaiAuth"
+ ],
+ "title": "GetAccountResponse",
+ "type": "object"
+ },
+ "GhostCommit": {
+ "description": "Details of a ghost commit created from a repository state.",
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "parent": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "preexisting_untracked_dirs": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "preexisting_untracked_files": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ }
+ },
+ "required": [
+ "id",
+ "preexisting_untracked_dirs",
+ "preexisting_untracked_files"
+ ],
+ "type": "object"
+ },
+ "GitInfo": {
+ "properties": {
+ "branch": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "originUrl": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "sha": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "ImageContent": {
+ "description": "An image provided to or from an LLM.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/v2/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "data": {
+ "type": "string"
+ },
+ "mimeType": {
+ "type": "string"
+ },
+ "type": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "data",
+ "mimeType",
+ "type"
+ ],
+ "type": "object"
+ },
+ "ItemCompletedNotification": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "item": {
+ "$ref": "#/definitions/v2/ThreadItem"
+ },
+ "threadId": {
+ "type": "string"
+ },
+ "turnId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "item",
+ "threadId",
+ "turnId"
+ ],
+ "title": "ItemCompletedNotification",
+ "type": "object"
+ },
+ "ItemStartedNotification": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "item": {
+ "$ref": "#/definitions/v2/ThreadItem"
+ },
+ "threadId": {
+ "type": "string"
+ },
+ "turnId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "item",
+ "threadId",
+ "turnId"
+ ],
+ "title": "ItemStartedNotification",
+ "type": "object"
+ },
+ "ListMcpServerStatusParams": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "cursor": {
+ "description": "Opaque pagination cursor returned by a previous call.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "limit": {
+ "description": "Optional page size; defaults to a server-defined value.",
+ "format": "uint32",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "title": "ListMcpServerStatusParams",
+ "type": "object"
+ },
+ "ListMcpServerStatusResponse": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "data": {
+ "items": {
+ "$ref": "#/definitions/v2/McpServerStatus"
+ },
+ "type": "array"
+ },
+ "nextCursor": {
+ "description": "Opaque cursor to pass to the next call to continue after the last item. If None, there are no more items to return.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "data"
+ ],
+ "title": "ListMcpServerStatusResponse",
+ "type": "object"
+ },
+ "LocalShellAction": {
+ "oneOf": [
+ {
+ "properties": {
+ "command": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "env": {
+ "additionalProperties": {
+ "type": "string"
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "timeout_ms": {
+ "format": "uint64",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "exec"
+ ],
+ "title": "ExecLocalShellActionType",
+ "type": "string"
+ },
+ "user": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "working_directory": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "command",
+ "type"
+ ],
+ "title": "ExecLocalShellAction",
+ "type": "object"
+ }
+ ]
+ },
+ "LocalShellStatus": {
+ "enum": [
+ "completed",
+ "in_progress",
+ "incomplete"
+ ],
+ "type": "string"
+ },
+ "LoginAccountParams": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "oneOf": [
+ {
+ "properties": {
+ "apiKey": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "apiKey"
+ ],
+ "title": "ApiKeyv2::LoginAccountParamsType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "apiKey",
+ "type"
+ ],
+ "title": "ApiKeyv2::LoginAccountParams",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "chatgpt"
+ ],
+ "title": "Chatgptv2::LoginAccountParamsType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "Chatgptv2::LoginAccountParams",
+ "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": "ChatgptAuthTokensv2::LoginAccountParamsType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "accessToken",
+ "idToken",
+ "type"
+ ],
+ "title": "ChatgptAuthTokensv2::LoginAccountParams",
+ "type": "object"
+ }
+ ],
+ "title": "LoginAccountParams"
+ },
+ "LoginAccountResponse": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "oneOf": [
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "apiKey"
+ ],
+ "title": "ApiKeyv2::LoginAccountResponseType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "ApiKeyv2::LoginAccountResponse",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "authUrl": {
+ "description": "URL the client should open in a browser to initiate the OAuth flow.",
+ "type": "string"
+ },
+ "loginId": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "chatgpt"
+ ],
+ "title": "Chatgptv2::LoginAccountResponseType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "authUrl",
+ "loginId",
+ "type"
+ ],
+ "title": "Chatgptv2::LoginAccountResponse",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "chatgptAuthTokens"
+ ],
+ "title": "ChatgptAuthTokensv2::LoginAccountResponseType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "ChatgptAuthTokensv2::LoginAccountResponse",
+ "type": "object"
+ }
+ ],
+ "title": "LoginAccountResponse"
+ },
+ "LogoutAccountResponse": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "title": "LogoutAccountResponse",
+ "type": "object"
+ },
+ "McpAuthStatus": {
+ "enum": [
+ "unsupported",
+ "notLoggedIn",
+ "bearerToken",
+ "oAuth"
+ ],
+ "type": "string"
+ },
+ "McpServerOauthLoginCompletedNotification": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "error": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "name": {
+ "type": "string"
+ },
+ "success": {
+ "type": "boolean"
+ }
+ },
+ "required": [
+ "name",
+ "success"
+ ],
+ "title": "McpServerOauthLoginCompletedNotification",
+ "type": "object"
+ },
+ "McpServerOauthLoginParams": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "name": {
+ "type": "string"
+ },
+ "scopes": {
+ "items": {
+ "type": "string"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "timeoutSecs": {
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "name"
+ ],
+ "title": "McpServerOauthLoginParams",
+ "type": "object"
+ },
+ "McpServerOauthLoginResponse": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "authorizationUrl": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "authorizationUrl"
+ ],
+ "title": "McpServerOauthLoginResponse",
+ "type": "object"
+ },
+ "McpServerRefreshResponse": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "title": "McpServerRefreshResponse",
+ "type": "object"
+ },
+ "McpServerStatus": {
+ "properties": {
+ "authStatus": {
+ "$ref": "#/definitions/v2/McpAuthStatus"
+ },
+ "name": {
+ "type": "string"
+ },
+ "resourceTemplates": {
+ "items": {
+ "$ref": "#/definitions/v2/ResourceTemplate"
+ },
+ "type": "array"
+ },
+ "resources": {
+ "items": {
+ "$ref": "#/definitions/v2/Resource"
+ },
+ "type": "array"
+ },
+ "tools": {
+ "additionalProperties": {
+ "$ref": "#/definitions/v2/Tool"
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "authStatus",
+ "name",
+ "resourceTemplates",
+ "resources",
+ "tools"
+ ],
+ "type": "object"
+ },
+ "McpToolCallError": {
+ "properties": {
+ "message": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "message"
+ ],
+ "type": "object"
+ },
+ "McpToolCallProgressNotification": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "itemId": {
+ "type": "string"
+ },
+ "message": {
+ "type": "string"
+ },
+ "threadId": {
+ "type": "string"
+ },
+ "turnId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "itemId",
+ "message",
+ "threadId",
+ "turnId"
+ ],
+ "title": "McpToolCallProgressNotification",
+ "type": "object"
+ },
+ "McpToolCallResult": {
+ "properties": {
+ "content": {
+ "items": {
+ "$ref": "#/definitions/v2/ContentBlock"
+ },
+ "type": "array"
+ },
+ "structuredContent": true
+ },
+ "required": [
+ "content"
+ ],
+ "type": "object"
+ },
+ "McpToolCallStatus": {
+ "enum": [
+ "inProgress",
+ "completed",
+ "failed"
+ ],
+ "type": "string"
+ },
+ "MergeStrategy": {
+ "enum": [
+ "replace",
+ "upsert"
+ ],
+ "type": "string"
+ },
+ "ModeKind": {
+ "description": "Initial collaboration mode to use when the TUI starts.",
+ "enum": [
+ "plan",
+ "code",
+ "pair_programming",
+ "execute",
+ "custom"
+ ],
+ "type": "string"
+ },
+ "Model": {
+ "properties": {
+ "defaultReasoningEffort": {
+ "$ref": "#/definitions/v2/ReasoningEffort"
+ },
+ "description": {
+ "type": "string"
+ },
+ "displayName": {
+ "type": "string"
+ },
+ "id": {
+ "type": "string"
+ },
+ "isDefault": {
+ "type": "boolean"
+ },
+ "model": {
+ "type": "string"
+ },
+ "supportedReasoningEfforts": {
+ "items": {
+ "$ref": "#/definitions/v2/ReasoningEffortOption"
+ },
+ "type": "array"
+ },
+ "supportsPersonality": {
+ "default": false,
+ "type": "boolean"
+ }
+ },
+ "required": [
+ "defaultReasoningEffort",
+ "description",
+ "displayName",
+ "id",
+ "isDefault",
+ "model",
+ "supportedReasoningEfforts"
+ ],
+ "type": "object"
+ },
+ "ModelListParams": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "cursor": {
+ "description": "Opaque pagination cursor returned by a previous call.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "limit": {
+ "description": "Optional page size; defaults to a reasonable server-side value.",
+ "format": "uint32",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "title": "ModelListParams",
+ "type": "object"
+ },
+ "ModelListResponse": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "data": {
+ "items": {
+ "$ref": "#/definitions/v2/Model"
+ },
+ "type": "array"
+ },
+ "nextCursor": {
+ "description": "Opaque cursor to pass to the next call to continue after the last item. If None, there are no more items to return.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "data"
+ ],
+ "title": "ModelListResponse",
+ "type": "object"
+ },
+ "NetworkAccess": {
+ "enum": [
+ "restricted",
+ "enabled"
+ ],
+ "type": "string"
+ },
+ "OverriddenMetadata": {
+ "properties": {
+ "effectiveValue": true,
+ "message": {
+ "type": "string"
+ },
+ "overridingLayer": {
+ "$ref": "#/definitions/v2/ConfigLayerMetadata"
+ }
+ },
+ "required": [
+ "effectiveValue",
+ "message",
+ "overridingLayer"
+ ],
+ "type": "object"
+ },
+ "PatchApplyStatus": {
+ "enum": [
+ "inProgress",
+ "completed",
+ "failed",
+ "declined"
+ ],
+ "type": "string"
+ },
+ "PatchChangeKind": {
+ "oneOf": [
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "add"
+ ],
+ "title": "AddPatchChangeKindType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "AddPatchChangeKind",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "delete"
+ ],
+ "title": "DeletePatchChangeKindType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "DeletePatchChangeKind",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "move_path": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "update"
+ ],
+ "title": "UpdatePatchChangeKindType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "UpdatePatchChangeKind",
+ "type": "object"
+ }
+ ]
+ },
+ "Personality": {
+ "enum": [
+ "friendly",
+ "pragmatic"
+ ],
+ "type": "string"
+ },
+ "PlanDeltaNotification": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "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"
+ ],
+ "title": "PlanDeltaNotification",
+ "type": "object"
+ },
+ "PlanType": {
+ "enum": [
+ "free",
+ "go",
+ "plus",
+ "pro",
+ "team",
+ "business",
+ "enterprise",
+ "edu",
+ "unknown"
+ ],
+ "type": "string"
+ },
+ "ProfileV2": {
+ "additionalProperties": true,
+ "properties": {
+ "approval_policy": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/v2/AskForApproval"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "chatgpt_base_url": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "model": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "model_provider": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "model_reasoning_effort": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/v2/ReasoningEffort"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "model_reasoning_summary": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/v2/ReasoningSummary"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "model_verbosity": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/v2/Verbosity"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "web_search": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/v2/WebSearchMode"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "RateLimitSnapshot": {
+ "properties": {
+ "credits": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/v2/CreditsSnapshot"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "planType": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/v2/PlanType"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "primary": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/v2/RateLimitWindow"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "secondary": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/v2/RateLimitWindow"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "RateLimitWindow": {
+ "properties": {
+ "resetsAt": {
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "usedPercent": {
+ "format": "int32",
+ "type": "integer"
+ },
+ "windowDurationMins": {
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "usedPercent"
+ ],
+ "type": "object"
+ },
+ "RawResponseItemCompletedNotification": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "item": {
+ "$ref": "#/definitions/v2/ResponseItem"
+ },
+ "threadId": {
+ "type": "string"
+ },
+ "turnId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "item",
+ "threadId",
+ "turnId"
+ ],
+ "title": "RawResponseItemCompletedNotification",
+ "type": "object"
+ },
+ "ReasoningEffort": {
+ "description": "See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#get-started-with-reasoning",
+ "enum": [
+ "none",
+ "minimal",
+ "low",
+ "medium",
+ "high",
+ "xhigh"
+ ],
+ "type": "string"
+ },
+ "ReasoningEffortOption": {
+ "properties": {
+ "description": {
+ "type": "string"
+ },
+ "reasoningEffort": {
+ "$ref": "#/definitions/v2/ReasoningEffort"
+ }
+ },
+ "required": [
+ "description",
+ "reasoningEffort"
+ ],
+ "type": "object"
+ },
+ "ReasoningItemContent": {
+ "oneOf": [
+ {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "reasoning_text"
+ ],
+ "title": "ReasoningTextReasoningItemContentType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "ReasoningTextReasoningItemContent",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "text"
+ ],
+ "title": "TextReasoningItemContentType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "TextReasoningItemContent",
+ "type": "object"
+ }
+ ]
+ },
+ "ReasoningItemReasoningSummary": {
+ "oneOf": [
+ {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "summary_text"
+ ],
+ "title": "SummaryTextReasoningItemReasoningSummaryType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "SummaryTextReasoningItemReasoningSummary",
+ "type": "object"
+ }
+ ]
+ },
+ "ReasoningSummary": {
+ "description": "A summary of the reasoning performed by the model. This can be useful for debugging and understanding the model's reasoning process. See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#reasoning-summaries",
+ "oneOf": [
+ {
+ "enum": [
+ "auto",
+ "concise",
+ "detailed"
+ ],
+ "type": "string"
+ },
+ {
+ "description": "Option to disable reasoning summaries.",
+ "enum": [
+ "none"
+ ],
+ "type": "string"
+ }
+ ]
+ },
+ "ReasoningSummaryPartAddedNotification": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "itemId": {
+ "type": "string"
+ },
+ "summaryIndex": {
+ "format": "int64",
+ "type": "integer"
+ },
+ "threadId": {
+ "type": "string"
+ },
+ "turnId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "itemId",
+ "summaryIndex",
+ "threadId",
+ "turnId"
+ ],
+ "title": "ReasoningSummaryPartAddedNotification",
+ "type": "object"
+ },
+ "ReasoningSummaryTextDeltaNotification": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "delta": {
+ "type": "string"
+ },
+ "itemId": {
+ "type": "string"
+ },
+ "summaryIndex": {
+ "format": "int64",
+ "type": "integer"
+ },
+ "threadId": {
+ "type": "string"
+ },
+ "turnId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "delta",
+ "itemId",
+ "summaryIndex",
+ "threadId",
+ "turnId"
+ ],
+ "title": "ReasoningSummaryTextDeltaNotification",
+ "type": "object"
+ },
+ "ReasoningTextDeltaNotification": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "contentIndex": {
+ "format": "int64",
+ "type": "integer"
+ },
+ "delta": {
+ "type": "string"
+ },
+ "itemId": {
+ "type": "string"
+ },
+ "threadId": {
+ "type": "string"
+ },
+ "turnId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "contentIndex",
+ "delta",
+ "itemId",
+ "threadId",
+ "turnId"
+ ],
+ "title": "ReasoningTextDeltaNotification",
+ "type": "object"
+ },
+ "ResidencyRequirement": {
+ "enum": [
+ "us"
+ ],
+ "type": "string"
+ },
+ "Resource": {
+ "description": "A known resource that the server is capable of reading.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/v2/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "description": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "mimeType": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "name": {
+ "type": "string"
+ },
+ "size": {
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "title": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "uri": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "uri"
+ ],
+ "type": "object"
+ },
+ "ResourceLink": {
+ "description": "A resource that the server is capable of reading, included in a prompt or tool call result.\n\nNote: resource links returned by tools are not guaranteed to appear in the results of `resources/list` requests.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/v2/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "description": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "mimeType": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "name": {
+ "type": "string"
+ },
+ "size": {
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "title": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "type": "string"
+ },
+ "uri": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "type",
+ "uri"
+ ],
+ "type": "object"
+ },
+ "ResourceTemplate": {
+ "description": "A template description for resources available on the server.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/v2/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "description": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "mimeType": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "name": {
+ "type": "string"
+ },
+ "title": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "uriTemplate": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "uriTemplate"
+ ],
+ "type": "object"
+ },
+ "ResponseItem": {
+ "oneOf": [
+ {
+ "properties": {
+ "content": {
+ "items": {
+ "$ref": "#/definitions/v2/ContentItem"
+ },
+ "type": "array"
+ },
+ "end_turn": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "id": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "writeOnly": true
+ },
+ "role": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "message"
+ ],
+ "title": "MessageResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "content",
+ "role",
+ "type"
+ ],
+ "title": "MessageResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "content": {
+ "default": null,
+ "items": {
+ "$ref": "#/definitions/v2/ReasoningItemContent"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "encrypted_content": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "id": {
+ "type": "string",
+ "writeOnly": true
+ },
+ "summary": {
+ "items": {
+ "$ref": "#/definitions/v2/ReasoningItemReasoningSummary"
+ },
+ "type": "array"
+ },
+ "type": {
+ "enum": [
+ "reasoning"
+ ],
+ "title": "ReasoningResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "summary",
+ "type"
+ ],
+ "title": "ReasoningResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "action": {
+ "$ref": "#/definitions/v2/LocalShellAction"
+ },
+ "call_id": {
+ "description": "Set when using the Responses API.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "id": {
+ "description": "Set when using the chat completions API.",
+ "type": [
+ "string",
+ "null"
+ ],
+ "writeOnly": true
+ },
+ "status": {
+ "$ref": "#/definitions/v2/LocalShellStatus"
+ },
+ "type": {
+ "enum": [
+ "local_shell_call"
+ ],
+ "title": "LocalShellCallResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "action",
+ "status",
+ "type"
+ ],
+ "title": "LocalShellCallResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "arguments": {
+ "type": "string"
+ },
+ "call_id": {
+ "type": "string"
+ },
+ "id": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "writeOnly": true
+ },
+ "name": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "function_call"
+ ],
+ "title": "FunctionCallResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "arguments",
+ "call_id",
+ "name",
+ "type"
+ ],
+ "title": "FunctionCallResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "call_id": {
+ "type": "string"
+ },
+ "output": {
+ "$ref": "#/definitions/v2/FunctionCallOutputPayload"
+ },
+ "type": {
+ "enum": [
+ "function_call_output"
+ ],
+ "title": "FunctionCallOutputResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "output",
+ "type"
+ ],
+ "title": "FunctionCallOutputResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "call_id": {
+ "type": "string"
+ },
+ "id": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "writeOnly": true
+ },
+ "input": {
+ "type": "string"
+ },
+ "name": {
+ "type": "string"
+ },
+ "status": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "custom_tool_call"
+ ],
+ "title": "CustomToolCallResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "input",
+ "name",
+ "type"
+ ],
+ "title": "CustomToolCallResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "call_id": {
+ "type": "string"
+ },
+ "output": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "custom_tool_call_output"
+ ],
+ "title": "CustomToolCallOutputResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "output",
+ "type"
+ ],
+ "title": "CustomToolCallOutputResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "action": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/v2/WebSearchAction"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "id": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "writeOnly": true
+ },
+ "status": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "web_search_call"
+ ],
+ "title": "WebSearchCallResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "WebSearchCallResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "ghost_commit": {
+ "$ref": "#/definitions/v2/GhostCommit"
+ },
+ "type": {
+ "enum": [
+ "ghost_snapshot"
+ ],
+ "title": "GhostSnapshotResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "ghost_commit",
+ "type"
+ ],
+ "title": "GhostSnapshotResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "encrypted_content": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "compaction"
+ ],
+ "title": "CompactionResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "encrypted_content",
+ "type"
+ ],
+ "title": "CompactionResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "other"
+ ],
+ "title": "OtherResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "OtherResponseItem",
+ "type": "object"
+ }
+ ]
+ },
+ "ReviewDelivery": {
+ "enum": [
+ "inline",
+ "detached"
+ ],
+ "type": "string"
+ },
+ "ReviewStartParams": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "delivery": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/v2/ReviewDelivery"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "default": null,
+ "description": "Where to run the review: inline (default) on the current thread or detached on a new thread (returned in `reviewThreadId`)."
+ },
+ "target": {
+ "$ref": "#/definitions/v2/ReviewTarget"
+ },
+ "threadId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "target",
+ "threadId"
+ ],
+ "title": "ReviewStartParams",
+ "type": "object"
+ },
+ "ReviewStartResponse": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "reviewThreadId": {
+ "description": "Identifies the thread where the review runs.\n\nFor inline reviews, this is the original thread id. For detached reviews, this is the id of the new review thread.",
+ "type": "string"
+ },
+ "turn": {
+ "$ref": "#/definitions/v2/Turn"
+ }
+ },
+ "required": [
+ "reviewThreadId",
+ "turn"
+ ],
+ "title": "ReviewStartResponse",
+ "type": "object"
+ },
+ "ReviewTarget": {
+ "oneOf": [
+ {
+ "description": "Review the working tree: staged, unstaged, and untracked files.",
+ "properties": {
+ "type": {
+ "enum": [
+ "uncommittedChanges"
+ ],
+ "title": "UncommittedChangesReviewTargetType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "UncommittedChangesReviewTarget",
+ "type": "object"
+ },
+ {
+ "description": "Review changes between the current branch and the given base branch.",
+ "properties": {
+ "branch": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "baseBranch"
+ ],
+ "title": "BaseBranchReviewTargetType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "branch",
+ "type"
+ ],
+ "title": "BaseBranchReviewTarget",
+ "type": "object"
+ },
+ {
+ "description": "Review the changes introduced by a specific commit.",
+ "properties": {
+ "sha": {
+ "type": "string"
+ },
+ "title": {
+ "description": "Optional human-readable label (e.g., commit subject) for UIs.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "commit"
+ ],
+ "title": "CommitReviewTargetType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "sha",
+ "type"
+ ],
+ "title": "CommitReviewTarget",
+ "type": "object"
+ },
+ {
+ "description": "Arbitrary instructions, equivalent to the old free-form prompt.",
+ "properties": {
+ "instructions": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "custom"
+ ],
+ "title": "CustomReviewTargetType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "instructions",
+ "type"
+ ],
+ "title": "CustomReviewTarget",
+ "type": "object"
+ }
+ ]
+ },
+ "Role": {
+ "description": "The sender or recipient of messages and data in a conversation.",
+ "enum": [
+ "assistant",
+ "user"
+ ],
+ "type": "string"
+ },
+ "SandboxMode": {
+ "enum": [
+ "read-only",
+ "workspace-write",
+ "danger-full-access"
+ ],
+ "type": "string"
+ },
+ "SandboxPolicy": {
+ "oneOf": [
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "dangerFullAccess"
+ ],
+ "title": "DangerFullAccessSandboxPolicyType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "DangerFullAccessSandboxPolicy",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "readOnly"
+ ],
+ "title": "ReadOnlySandboxPolicyType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "ReadOnlySandboxPolicy",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "networkAccess": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/v2/NetworkAccess"
+ }
+ ],
+ "default": "restricted"
+ },
+ "type": {
+ "enum": [
+ "externalSandbox"
+ ],
+ "title": "ExternalSandboxSandboxPolicyType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "ExternalSandboxSandboxPolicy",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "excludeSlashTmp": {
+ "default": false,
+ "type": "boolean"
+ },
+ "excludeTmpdirEnvVar": {
+ "default": false,
+ "type": "boolean"
+ },
+ "networkAccess": {
+ "default": false,
+ "type": "boolean"
+ },
+ "type": {
+ "enum": [
+ "workspaceWrite"
+ ],
+ "title": "WorkspaceWriteSandboxPolicyType",
+ "type": "string"
+ },
+ "writableRoots": {
+ "default": [],
+ "items": {
+ "$ref": "#/definitions/v2/AbsolutePathBuf"
+ },
+ "type": "array"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "WorkspaceWriteSandboxPolicy",
+ "type": "object"
+ }
+ ]
+ },
+ "SandboxWorkspaceWrite": {
+ "properties": {
+ "exclude_slash_tmp": {
+ "default": false,
+ "type": "boolean"
+ },
+ "exclude_tmpdir_env_var": {
+ "default": false,
+ "type": "boolean"
+ },
+ "network_access": {
+ "default": false,
+ "type": "boolean"
+ },
+ "writable_roots": {
+ "default": [],
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ }
+ },
+ "type": "object"
+ },
+ "SessionSource": {
+ "oneOf": [
+ {
+ "enum": [
+ "cli",
+ "vscode",
+ "exec",
+ "appServer",
+ "unknown"
+ ],
+ "type": "string"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "subAgent": {
+ "$ref": "#/definitions/v2/SubAgentSource"
+ }
+ },
+ "required": [
+ "subAgent"
+ ],
+ "title": "SubAgentSessionSource",
+ "type": "object"
+ }
+ ]
+ },
+ "Settings": {
+ "description": "Settings for a collaboration mode.",
+ "properties": {
+ "developer_instructions": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "model": {
+ "type": "string"
+ },
+ "reasoning_effort": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/v2/ReasoningEffort"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ }
+ },
+ "required": [
+ "model"
+ ],
+ "type": "object"
+ },
+ "SkillDependencies": {
+ "properties": {
+ "tools": {
+ "items": {
+ "$ref": "#/definitions/v2/SkillToolDependency"
+ },
+ "type": "array"
+ }
+ },
+ "required": [
+ "tools"
+ ],
+ "type": "object"
+ },
+ "SkillErrorInfo": {
+ "properties": {
+ "message": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "message",
+ "path"
+ ],
+ "type": "object"
+ },
+ "SkillInterface": {
+ "properties": {
+ "brandColor": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "defaultPrompt": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "displayName": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "iconLarge": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "iconSmall": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "shortDescription": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "SkillMetadata": {
+ "properties": {
+ "dependencies": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/v2/SkillDependencies"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "description": {
+ "type": "string"
+ },
+ "enabled": {
+ "type": "boolean"
+ },
+ "interface": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/v2/SkillInterface"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "name": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "scope": {
+ "$ref": "#/definitions/v2/SkillScope"
+ },
+ "shortDescription": {
+ "description": "Legacy short_description from SKILL.md. Prefer SKILL.json interface.short_description.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "description",
+ "enabled",
+ "name",
+ "path",
+ "scope"
+ ],
+ "type": "object"
+ },
+ "SkillScope": {
+ "enum": [
+ "user",
+ "repo",
+ "system",
+ "admin"
+ ],
+ "type": "string"
+ },
+ "SkillToolDependency": {
+ "properties": {
+ "command": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "description": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "transport": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "type": "string"
+ },
+ "url": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "value": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "value"
+ ],
+ "type": "object"
+ },
+ "SkillsConfigWriteParams": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "enabled": {
+ "type": "boolean"
+ },
+ "path": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "enabled",
+ "path"
+ ],
+ "title": "SkillsConfigWriteParams",
+ "type": "object"
+ },
+ "SkillsConfigWriteResponse": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "effectiveEnabled": {
+ "type": "boolean"
+ }
+ },
+ "required": [
+ "effectiveEnabled"
+ ],
+ "title": "SkillsConfigWriteResponse",
+ "type": "object"
+ },
+ "SkillsListEntry": {
+ "properties": {
+ "cwd": {
+ "type": "string"
+ },
+ "errors": {
+ "items": {
+ "$ref": "#/definitions/v2/SkillErrorInfo"
+ },
+ "type": "array"
+ },
+ "skills": {
+ "items": {
+ "$ref": "#/definitions/v2/SkillMetadata"
+ },
+ "type": "array"
+ }
+ },
+ "required": [
+ "cwd",
+ "errors",
+ "skills"
+ ],
+ "type": "object"
+ },
+ "SkillsListParams": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "cwds": {
+ "description": "When empty, defaults to the current session working directory.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "forceReload": {
+ "description": "When true, bypass the skills cache and re-scan skills from disk.",
+ "type": "boolean"
+ }
+ },
+ "title": "SkillsListParams",
+ "type": "object"
+ },
+ "SkillsListResponse": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "data": {
+ "items": {
+ "$ref": "#/definitions/v2/SkillsListEntry"
+ },
+ "type": "array"
+ }
+ },
+ "required": [
+ "data"
+ ],
+ "title": "SkillsListResponse",
+ "type": "object"
+ },
+ "SubAgentSource": {
+ "oneOf": [
+ {
+ "enum": [
+ "review",
+ "compact"
+ ],
+ "type": "string"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "thread_spawn": {
+ "properties": {
+ "depth": {
+ "format": "int32",
+ "type": "integer"
+ },
+ "parent_thread_id": {
+ "$ref": "#/definitions/v2/ThreadId"
+ }
+ },
+ "required": [
+ "depth",
+ "parent_thread_id"
+ ],
+ "type": "object"
+ }
+ },
+ "required": [
+ "thread_spawn"
+ ],
+ "title": "ThreadSpawnSubAgentSource",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "other": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "other"
+ ],
+ "title": "OtherSubAgentSource",
+ "type": "object"
+ }
+ ]
+ },
+ "TerminalInteractionNotification": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "itemId": {
+ "type": "string"
+ },
+ "processId": {
+ "type": "string"
+ },
+ "stdin": {
+ "type": "string"
+ },
+ "threadId": {
+ "type": "string"
+ },
+ "turnId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "itemId",
+ "processId",
+ "stdin",
+ "threadId",
+ "turnId"
+ ],
+ "title": "TerminalInteractionNotification",
+ "type": "object"
+ },
+ "TextContent": {
+ "description": "Text provided to or from an LLM.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/v2/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "type": "object"
+ },
+ "TextElement": {
+ "properties": {
+ "byteRange": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/v2/ByteRange"
+ }
+ ],
+ "description": "Byte range in the parent `text` buffer that this element occupies."
+ },
+ "placeholder": {
+ "description": "Optional human-readable placeholder for the element, displayed in the UI.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "byteRange"
+ ],
+ "type": "object"
+ },
+ "TextPosition": {
+ "properties": {
+ "column": {
+ "description": "1-based column number (in Unicode scalar values).",
+ "format": "uint",
+ "minimum": 0.0,
+ "type": "integer"
+ },
+ "line": {
+ "description": "1-based line number.",
+ "format": "uint",
+ "minimum": 0.0,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "column",
+ "line"
+ ],
+ "type": "object"
+ },
+ "TextRange": {
+ "properties": {
+ "end": {
+ "$ref": "#/definitions/v2/TextPosition"
+ },
+ "start": {
+ "$ref": "#/definitions/v2/TextPosition"
+ }
+ },
+ "required": [
+ "end",
+ "start"
+ ],
+ "type": "object"
+ },
+ "TextResourceContents": {
+ "properties": {
+ "mimeType": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "text": {
+ "type": "string"
+ },
+ "uri": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "uri"
+ ],
+ "type": "object"
+ },
+ "Thread": {
+ "properties": {
+ "cliVersion": {
+ "description": "Version of the CLI that created the thread.",
+ "type": "string"
+ },
+ "createdAt": {
+ "description": "Unix timestamp (in seconds) when the thread was created.",
+ "format": "int64",
+ "type": "integer"
+ },
+ "cwd": {
+ "description": "Working directory captured for the thread.",
+ "type": "string"
+ },
+ "gitInfo": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/v2/GitInfo"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Optional Git metadata captured when the thread was created."
+ },
+ "id": {
+ "type": "string"
+ },
+ "modelProvider": {
+ "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"
+ },
+ "source": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/v2/SessionSource"
+ }
+ ],
+ "description": "Origin of the thread (CLI, VSCode, codex exec, codex app-server, etc.)."
+ },
+ "turns": {
+ "description": "Only populated on `thread/resume`, `thread/rollback`, `thread/fork`, and `thread/read` (when `includeTurns` is true) responses. For all other responses and notifications returning a Thread, the turns field will be an empty list.",
+ "items": {
+ "$ref": "#/definitions/v2/Turn"
+ },
+ "type": "array"
+ },
+ "updatedAt": {
+ "description": "Unix timestamp (in seconds) when the thread was last updated.",
+ "format": "int64",
+ "type": "integer"
+ }
+ },
+ "required": [
+ "cliVersion",
+ "createdAt",
+ "cwd",
+ "id",
+ "modelProvider",
+ "preview",
+ "source",
+ "turns",
+ "updatedAt"
+ ],
+ "type": "object"
+ },
+ "ThreadArchiveParams": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "threadId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "threadId"
+ ],
+ "title": "ThreadArchiveParams",
+ "type": "object"
+ },
+ "ThreadArchiveResponse": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "title": "ThreadArchiveResponse",
+ "type": "object"
+ },
+ "ThreadForkParams": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "description": "There are two ways to fork a thread: 1. By thread_id: load the thread from disk by thread_id and fork it into a new thread. 2. By path: load the thread from disk by path and fork it into a new thread.\n\nIf using path, the thread_id param will be ignored.\n\nPrefer using thread_id whenever possible.",
+ "properties": {
+ "approvalPolicy": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/v2/AskForApproval"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "baseInstructions": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "config": {
+ "additionalProperties": true,
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "cwd": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "developerInstructions": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "model": {
+ "description": "Configuration overrides for the forked thread, if any.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "modelProvider": {
+ "type": [
+ "string",
+ "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": [
+ {
+ "$ref": "#/definitions/v2/SandboxMode"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "threadId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "threadId"
+ ],
+ "title": "ThreadForkParams",
+ "type": "object"
+ },
+ "ThreadForkResponse": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "approvalPolicy": {
+ "$ref": "#/definitions/v2/AskForApproval"
+ },
+ "cwd": {
+ "type": "string"
+ },
+ "model": {
+ "type": "string"
+ },
+ "modelProvider": {
+ "type": "string"
+ },
+ "reasoningEffort": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/v2/ReasoningEffort"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "sandbox": {
+ "$ref": "#/definitions/v2/SandboxPolicy"
+ },
+ "thread": {
+ "$ref": "#/definitions/v2/Thread"
+ }
+ },
+ "required": [
+ "approvalPolicy",
+ "cwd",
+ "model",
+ "modelProvider",
+ "sandbox",
+ "thread"
+ ],
+ "title": "ThreadForkResponse",
+ "type": "object"
+ },
+ "ThreadId": {
+ "type": "string"
+ },
+ "ThreadItem": {
+ "oneOf": [
+ {
+ "properties": {
+ "content": {
+ "items": {
+ "$ref": "#/definitions/v2/UserInput"
+ },
+ "type": "array"
+ },
+ "id": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "userMessage"
+ ],
+ "title": "UserMessageThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "content",
+ "id",
+ "type"
+ ],
+ "title": "UserMessageThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "agentMessage"
+ ],
+ "title": "AgentMessageThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "text",
+ "type"
+ ],
+ "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": {
+ "default": [],
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "id": {
+ "type": "string"
+ },
+ "summary": {
+ "default": [],
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "type": {
+ "enum": [
+ "reasoning"
+ ],
+ "title": "ReasoningThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "type"
+ ],
+ "title": "ReasoningThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "aggregatedOutput": {
+ "description": "The command's output, aggregated from stdout and stderr.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "command": {
+ "description": "The command to be executed.",
+ "type": "string"
+ },
+ "commandActions": {
+ "description": "A best-effort parsing of the command to understand the action(s) it will perform. This returns a list of CommandAction objects because a single shell command may be composed of many commands piped together.",
+ "items": {
+ "$ref": "#/definitions/v2/CommandAction"
+ },
+ "type": "array"
+ },
+ "cwd": {
+ "description": "The command's working directory.",
+ "type": "string"
+ },
+ "durationMs": {
+ "description": "The duration of the command execution in milliseconds.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "exitCode": {
+ "description": "The command's exit code.",
+ "format": "int32",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "id": {
+ "type": "string"
+ },
+ "processId": {
+ "description": "Identifier for the underlying PTY process (when available).",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "status": {
+ "$ref": "#/definitions/v2/CommandExecutionStatus"
+ },
+ "type": {
+ "enum": [
+ "commandExecution"
+ ],
+ "title": "CommandExecutionThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "command",
+ "commandActions",
+ "cwd",
+ "id",
+ "status",
+ "type"
+ ],
+ "title": "CommandExecutionThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "changes": {
+ "items": {
+ "$ref": "#/definitions/v2/FileUpdateChange"
+ },
+ "type": "array"
+ },
+ "id": {
+ "type": "string"
+ },
+ "status": {
+ "$ref": "#/definitions/v2/PatchApplyStatus"
+ },
+ "type": {
+ "enum": [
+ "fileChange"
+ ],
+ "title": "FileChangeThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "changes",
+ "id",
+ "status",
+ "type"
+ ],
+ "title": "FileChangeThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "arguments": true,
+ "durationMs": {
+ "description": "The duration of the MCP tool call in milliseconds.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "error": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/v2/McpToolCallError"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "id": {
+ "type": "string"
+ },
+ "result": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/v2/McpToolCallResult"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "server": {
+ "type": "string"
+ },
+ "status": {
+ "$ref": "#/definitions/v2/McpToolCallStatus"
+ },
+ "tool": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "mcpToolCall"
+ ],
+ "title": "McpToolCallThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "arguments",
+ "id",
+ "server",
+ "status",
+ "tool",
+ "type"
+ ],
+ "title": "McpToolCallThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "agentsStates": {
+ "additionalProperties": {
+ "$ref": "#/definitions/v2/CollabAgentState"
+ },
+ "description": "Last known status of the target agents, when available.",
+ "type": "object"
+ },
+ "id": {
+ "description": "Unique identifier for this collab tool call.",
+ "type": "string"
+ },
+ "prompt": {
+ "description": "Prompt text sent as part of the collab tool call, when available.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "receiverThreadIds": {
+ "description": "Thread ID of the receiving agent, when applicable. In case of spawn operation, this corresponds to the newly spawned agent.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "senderThreadId": {
+ "description": "Thread ID of the agent issuing the collab request.",
+ "type": "string"
+ },
+ "status": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/v2/CollabAgentToolCallStatus"
+ }
+ ],
+ "description": "Current status of the collab tool call."
+ },
+ "tool": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/v2/CollabAgentTool"
+ }
+ ],
+ "description": "Name of the collab tool that was invoked."
+ },
+ "type": {
+ "enum": [
+ "collabAgentToolCall"
+ ],
+ "title": "CollabAgentToolCallThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "agentsStates",
+ "id",
+ "receiverThreadIds",
+ "senderThreadId",
+ "status",
+ "tool",
+ "type"
+ ],
+ "title": "CollabAgentToolCallThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "action": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/v2/WebSearchAction"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "id": {
+ "type": "string"
+ },
+ "query": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "webSearch"
+ ],
+ "title": "WebSearchThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "query",
+ "type"
+ ],
+ "title": "WebSearchThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "imageView"
+ ],
+ "title": "ImageViewThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "path",
+ "type"
+ ],
+ "title": "ImageViewThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "review": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "enteredReviewMode"
+ ],
+ "title": "EnteredReviewModeThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "review",
+ "type"
+ ],
+ "title": "EnteredReviewModeThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "review": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "exitedReviewMode"
+ ],
+ "title": "ExitedReviewModeThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "review",
+ "type"
+ ],
+ "title": "ExitedReviewModeThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "contextCompaction"
+ ],
+ "title": "ContextCompactionThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "type"
+ ],
+ "title": "ContextCompactionThreadItem",
+ "type": "object"
+ }
+ ]
+ },
+ "ThreadListParams": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "archived": {
+ "description": "Optional archived filter; when set to true, only archived threads are returned. If false or null, only non-archived threads are returned.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "cursor": {
+ "description": "Opaque pagination cursor returned by a previous call.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "limit": {
+ "description": "Optional page size; defaults to a reasonable server-side value.",
+ "format": "uint32",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "modelProviders": {
+ "description": "Optional provider filter; when set, only sessions recorded under these providers are returned. When present but empty, includes all providers.",
+ "items": {
+ "type": "string"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "sortKey": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/v2/ThreadSortKey"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Optional sort key; defaults to created_at."
+ },
+ "sourceKinds": {
+ "description": "Optional source filter; when set, only sessions from these source kinds are returned. When omitted or empty, defaults to interactive sources.",
+ "items": {
+ "$ref": "#/definitions/v2/ThreadSourceKind"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ }
+ },
+ "title": "ThreadListParams",
+ "type": "object"
+ },
+ "ThreadListResponse": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "data": {
+ "items": {
+ "$ref": "#/definitions/v2/Thread"
+ },
+ "type": "array"
+ },
+ "nextCursor": {
+ "description": "Opaque cursor to pass to the next call to continue after the last item. if None, there are no more items to return.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "data"
+ ],
+ "title": "ThreadListResponse",
+ "type": "object"
+ },
+ "ThreadLoadedListParams": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "cursor": {
+ "description": "Opaque pagination cursor returned by a previous call.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "limit": {
+ "description": "Optional page size; defaults to no limit.",
+ "format": "uint32",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "title": "ThreadLoadedListParams",
+ "type": "object"
+ },
+ "ThreadLoadedListResponse": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "data": {
+ "description": "Thread ids for sessions currently loaded in memory.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "nextCursor": {
+ "description": "Opaque cursor to pass to the next call to continue after the last item. if None, there are no more items to return.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "data"
+ ],
+ "title": "ThreadLoadedListResponse",
+ "type": "object"
+ },
+ "ThreadNameUpdatedNotification": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "threadId": {
+ "type": "string"
+ },
+ "threadName": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "threadId"
+ ],
+ "title": "ThreadNameUpdatedNotification",
+ "type": "object"
+ },
+ "ThreadReadParams": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "includeTurns": {
+ "default": false,
+ "description": "When true, include turns and their items from rollout history.",
+ "type": "boolean"
+ },
+ "threadId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "threadId"
+ ],
+ "title": "ThreadReadParams",
+ "type": "object"
+ },
+ "ThreadReadResponse": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "thread": {
+ "$ref": "#/definitions/v2/Thread"
+ }
+ },
+ "required": [
+ "thread"
+ ],
+ "title": "ThreadReadResponse",
+ "type": "object"
+ },
+ "ThreadResumeParams": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "description": "There are three ways to resume a thread: 1. By thread_id: load the thread from disk by thread_id and resume it. 2. By history: instantiate the thread from memory and resume it. 3. By path: load the thread from disk by path and resume it.\n\nThe precedence is: history > path > thread_id. If using history or path, the thread_id param will be ignored.\n\nPrefer using thread_id whenever possible.",
+ "properties": {
+ "approvalPolicy": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/v2/AskForApproval"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "baseInstructions": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "config": {
+ "additionalProperties": true,
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "cwd": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "developerInstructions": {
+ "type": [
+ "string",
+ "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/v2/ResponseItem"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "model": {
+ "description": "Configuration overrides for the resumed thread, if any.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "modelProvider": {
+ "type": [
+ "string",
+ "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": [
+ {
+ "$ref": "#/definitions/v2/Personality"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "sandbox": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/v2/SandboxMode"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "threadId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "threadId"
+ ],
+ "title": "ThreadResumeParams",
+ "type": "object"
+ },
+ "ThreadResumeResponse": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "approvalPolicy": {
+ "$ref": "#/definitions/v2/AskForApproval"
+ },
+ "cwd": {
+ "type": "string"
+ },
+ "model": {
+ "type": "string"
+ },
+ "modelProvider": {
+ "type": "string"
+ },
+ "reasoningEffort": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/v2/ReasoningEffort"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "sandbox": {
+ "$ref": "#/definitions/v2/SandboxPolicy"
+ },
+ "thread": {
+ "$ref": "#/definitions/v2/Thread"
+ }
+ },
+ "required": [
+ "approvalPolicy",
+ "cwd",
+ "model",
+ "modelProvider",
+ "sandbox",
+ "thread"
+ ],
+ "title": "ThreadResumeResponse",
+ "type": "object"
+ },
+ "ThreadRollbackParams": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "numTurns": {
+ "description": "The number of turns to drop from the end of the thread. Must be >= 1.\n\nThis only modifies the thread's history and does not revert local file changes that have been made by the agent. Clients are responsible for reverting these changes.",
+ "format": "uint32",
+ "minimum": 0.0,
+ "type": "integer"
+ },
+ "threadId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "numTurns",
+ "threadId"
+ ],
+ "title": "ThreadRollbackParams",
+ "type": "object"
+ },
+ "ThreadRollbackResponse": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "thread": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/v2/Thread"
+ }
+ ],
+ "description": "The updated thread after applying the rollback, with `turns` populated.\n\nThe ThreadItems stored in each Turn are lossy since we explicitly do not persist all agent interactions, such as command executions. This is the same behavior as `thread/resume`."
+ }
+ },
+ "required": [
+ "thread"
+ ],
+ "title": "ThreadRollbackResponse",
+ "type": "object"
+ },
+ "ThreadSetNameParams": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "name": {
+ "type": "string"
+ },
+ "threadId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "threadId"
+ ],
+ "title": "ThreadSetNameParams",
+ "type": "object"
+ },
+ "ThreadSetNameResponse": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "title": "ThreadSetNameResponse",
+ "type": "object"
+ },
+ "ThreadSortKey": {
+ "enum": [
+ "created_at",
+ "updated_at"
+ ],
+ "type": "string"
+ },
+ "ThreadSourceKind": {
+ "enum": [
+ "cli",
+ "vscode",
+ "exec",
+ "appServer",
+ "subAgent",
+ "subAgentReview",
+ "subAgentCompact",
+ "subAgentThreadSpawn",
+ "subAgentOther",
+ "unknown"
+ ],
+ "type": "string"
+ },
+ "ThreadStartParams": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "approvalPolicy": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/v2/AskForApproval"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "baseInstructions": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "config": {
+ "additionalProperties": true,
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "cwd": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "developerInstructions": {
+ "type": [
+ "string",
+ "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",
+ "null"
+ ]
+ },
+ "modelProvider": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "personality": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/v2/Personality"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "sandbox": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/v2/SandboxMode"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ }
+ },
+ "title": "ThreadStartParams",
+ "type": "object"
+ },
+ "ThreadStartResponse": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "approvalPolicy": {
+ "$ref": "#/definitions/v2/AskForApproval"
+ },
+ "cwd": {
+ "type": "string"
+ },
+ "model": {
+ "type": "string"
+ },
+ "modelProvider": {
+ "type": "string"
+ },
+ "reasoningEffort": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/v2/ReasoningEffort"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "sandbox": {
+ "$ref": "#/definitions/v2/SandboxPolicy"
+ },
+ "thread": {
+ "$ref": "#/definitions/v2/Thread"
+ }
+ },
+ "required": [
+ "approvalPolicy",
+ "cwd",
+ "model",
+ "modelProvider",
+ "sandbox",
+ "thread"
+ ],
+ "title": "ThreadStartResponse",
+ "type": "object"
+ },
+ "ThreadStartedNotification": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "thread": {
+ "$ref": "#/definitions/v2/Thread"
+ }
+ },
+ "required": [
+ "thread"
+ ],
+ "title": "ThreadStartedNotification",
+ "type": "object"
+ },
+ "ThreadTokenUsage": {
+ "properties": {
+ "last": {
+ "$ref": "#/definitions/v2/TokenUsageBreakdown"
+ },
+ "modelContextWindow": {
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "total": {
+ "$ref": "#/definitions/v2/TokenUsageBreakdown"
+ }
+ },
+ "required": [
+ "last",
+ "total"
+ ],
+ "type": "object"
+ },
+ "ThreadTokenUsageUpdatedNotification": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "threadId": {
+ "type": "string"
+ },
+ "tokenUsage": {
+ "$ref": "#/definitions/v2/ThreadTokenUsage"
+ },
+ "turnId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "threadId",
+ "tokenUsage",
+ "turnId"
+ ],
+ "title": "ThreadTokenUsageUpdatedNotification",
+ "type": "object"
+ },
+ "ThreadUnarchiveParams": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "threadId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "threadId"
+ ],
+ "title": "ThreadUnarchiveParams",
+ "type": "object"
+ },
+ "ThreadUnarchiveResponse": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "thread": {
+ "$ref": "#/definitions/v2/Thread"
+ }
+ },
+ "required": [
+ "thread"
+ ],
+ "title": "ThreadUnarchiveResponse",
+ "type": "object"
+ },
+ "TokenUsageBreakdown": {
+ "properties": {
+ "cachedInputTokens": {
+ "format": "int64",
+ "type": "integer"
+ },
+ "inputTokens": {
+ "format": "int64",
+ "type": "integer"
+ },
+ "outputTokens": {
+ "format": "int64",
+ "type": "integer"
+ },
+ "reasoningOutputTokens": {
+ "format": "int64",
+ "type": "integer"
+ },
+ "totalTokens": {
+ "format": "int64",
+ "type": "integer"
+ }
+ },
+ "required": [
+ "cachedInputTokens",
+ "inputTokens",
+ "outputTokens",
+ "reasoningOutputTokens",
+ "totalTokens"
+ ],
+ "type": "object"
+ },
+ "Tool": {
+ "description": "Definition for a tool the client can call.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/v2/ToolAnnotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "description": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "inputSchema": {
+ "$ref": "#/definitions/v2/ToolInputSchema"
+ },
+ "name": {
+ "type": "string"
+ },
+ "outputSchema": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/v2/ToolOutputSchema"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "title": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "inputSchema",
+ "name"
+ ],
+ "type": "object"
+ },
+ "ToolAnnotations": {
+ "description": "Additional properties describing a Tool to clients.\n\nNOTE: all properties in ToolAnnotations are **hints**. They are not guaranteed to provide a faithful description of tool behavior (including descriptive properties like `title`).\n\nClients should never make tool use decisions based on ToolAnnotations received from untrusted servers.",
+ "properties": {
+ "destructiveHint": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "idempotentHint": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "openWorldHint": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "readOnlyHint": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "title": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "ToolInputSchema": {
+ "description": "A JSON Schema object defining the expected parameters for the tool.",
+ "properties": {
+ "properties": true,
+ "required": {
+ "items": {
+ "type": "string"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "type": {
+ "default": "object",
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "ToolOutputSchema": {
+ "description": "An optional JSON Schema object defining the structure of the tool's output returned in the structuredContent field of a CallToolResult.",
+ "properties": {
+ "properties": true,
+ "required": {
+ "items": {
+ "type": "string"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "type": {
+ "default": "object",
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "ToolsV2": {
+ "properties": {
+ "view_image": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "web_search": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "Turn": {
+ "properties": {
+ "error": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/v2/TurnError"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Only populated when the Turn's status is failed."
+ },
+ "id": {
+ "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.",
+ "items": {
+ "$ref": "#/definitions/v2/ThreadItem"
+ },
+ "type": "array"
+ },
+ "status": {
+ "$ref": "#/definitions/v2/TurnStatus"
+ }
+ },
+ "required": [
+ "id",
+ "items",
+ "status"
+ ],
+ "type": "object"
+ },
+ "TurnCompletedNotification": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "threadId": {
+ "type": "string"
+ },
+ "turn": {
+ "$ref": "#/definitions/v2/Turn"
+ }
+ },
+ "required": [
+ "threadId",
+ "turn"
+ ],
+ "title": "TurnCompletedNotification",
+ "type": "object"
+ },
+ "TurnDiffUpdatedNotification": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "description": "Notification that the turn-level unified diff has changed. Contains the latest aggregated diff across all file changes in the turn.",
+ "properties": {
+ "diff": {
+ "type": "string"
+ },
+ "threadId": {
+ "type": "string"
+ },
+ "turnId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "diff",
+ "threadId",
+ "turnId"
+ ],
+ "title": "TurnDiffUpdatedNotification",
+ "type": "object"
+ },
+ "TurnError": {
+ "properties": {
+ "additionalDetails": {
+ "default": null,
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "codexErrorInfo": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/v2/CodexErrorInfo"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "message": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "message"
+ ],
+ "type": "object"
+ },
+ "TurnInterruptParams": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "threadId": {
+ "type": "string"
+ },
+ "turnId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "threadId",
+ "turnId"
+ ],
+ "title": "TurnInterruptParams",
+ "type": "object"
+ },
+ "TurnInterruptResponse": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "title": "TurnInterruptResponse",
+ "type": "object"
+ },
+ "TurnPlanStep": {
+ "properties": {
+ "status": {
+ "$ref": "#/definitions/v2/TurnPlanStepStatus"
+ },
+ "step": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "status",
+ "step"
+ ],
+ "type": "object"
+ },
+ "TurnPlanStepStatus": {
+ "enum": [
+ "pending",
+ "inProgress",
+ "completed"
+ ],
+ "type": "string"
+ },
+ "TurnPlanUpdatedNotification": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "explanation": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "plan": {
+ "items": {
+ "$ref": "#/definitions/v2/TurnPlanStep"
+ },
+ "type": "array"
+ },
+ "threadId": {
+ "type": "string"
+ },
+ "turnId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "plan",
+ "threadId",
+ "turnId"
+ ],
+ "title": "TurnPlanUpdatedNotification",
+ "type": "object"
+ },
+ "TurnStartParams": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "approvalPolicy": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/v2/AskForApproval"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Override the approval policy for this turn and subsequent turns."
+ },
+ "collaborationMode": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/v2/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": [
+ "string",
+ "null"
+ ]
+ },
+ "effort": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/v2/ReasoningEffort"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Override the reasoning effort for this turn and subsequent turns."
+ },
+ "input": {
+ "items": {
+ "$ref": "#/definitions/v2/UserInput"
+ },
+ "type": "array"
+ },
+ "model": {
+ "description": "Override the model for this turn and subsequent turns.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "outputSchema": {
+ "description": "Optional JSON Schema used to constrain the final assistant message for this turn."
+ },
+ "personality": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/v2/Personality"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Override the personality for this turn and subsequent turns."
+ },
+ "sandboxPolicy": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/v2/SandboxPolicy"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Override the sandbox policy for this turn and subsequent turns."
+ },
+ "summary": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/v2/ReasoningSummary"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Override the reasoning summary for this turn and subsequent turns."
+ },
+ "threadId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "input",
+ "threadId"
+ ],
+ "title": "TurnStartParams",
+ "type": "object"
+ },
+ "TurnStartResponse": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "turn": {
+ "$ref": "#/definitions/v2/Turn"
+ }
+ },
+ "required": [
+ "turn"
+ ],
+ "title": "TurnStartResponse",
+ "type": "object"
+ },
+ "TurnStartedNotification": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "threadId": {
+ "type": "string"
+ },
+ "turn": {
+ "$ref": "#/definitions/v2/Turn"
+ }
+ },
+ "required": [
+ "threadId",
+ "turn"
+ ],
+ "title": "TurnStartedNotification",
+ "type": "object"
+ },
+ "TurnStatus": {
+ "enum": [
+ "completed",
+ "interrupted",
+ "failed",
+ "inProgress"
+ ],
+ "type": "string"
+ },
+ "UserInput": {
+ "oneOf": [
+ {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "text_elements": {
+ "default": [],
+ "description": "UI-defined spans within `text` used to render or persist special elements.",
+ "items": {
+ "$ref": "#/definitions/v2/TextElement"
+ },
+ "type": "array"
+ },
+ "type": {
+ "enum": [
+ "text"
+ ],
+ "title": "TextUserInputType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "TextUserInput",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "image"
+ ],
+ "title": "ImageUserInputType",
+ "type": "string"
+ },
+ "url": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "url"
+ ],
+ "title": "ImageUserInput",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "localImage"
+ ],
+ "title": "LocalImageUserInputType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "path",
+ "type"
+ ],
+ "title": "LocalImageUserInput",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "name": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "skill"
+ ],
+ "title": "SkillUserInputType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "path",
+ "type"
+ ],
+ "title": "SkillUserInput",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "name": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "mention"
+ ],
+ "title": "MentionUserInputType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "path",
+ "type"
+ ],
+ "title": "MentionUserInput",
+ "type": "object"
+ }
+ ]
+ },
+ "Verbosity": {
+ "description": "Controls output length/detail on GPT-5 models via the Responses API. Serialized with lowercase values to match the OpenAI API.",
+ "enum": [
+ "low",
+ "medium",
+ "high"
+ ],
+ "type": "string"
+ },
+ "WebSearchAction": {
+ "oneOf": [
+ {
+ "properties": {
+ "queries": {
+ "items": {
+ "type": "string"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "query": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "search"
+ ],
+ "title": "SearchWebSearchActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "SearchWebSearchAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "open_page"
+ ],
+ "title": "OpenPageWebSearchActionType",
+ "type": "string"
+ },
+ "url": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "OpenPageWebSearchAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "pattern": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "find_in_page"
+ ],
+ "title": "FindInPageWebSearchActionType",
+ "type": "string"
+ },
+ "url": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "FindInPageWebSearchAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "other"
+ ],
+ "title": "OtherWebSearchActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "OtherWebSearchAction",
+ "type": "object"
+ }
+ ]
+ },
+ "WebSearchMode": {
+ "enum": [
+ "disabled",
+ "cached",
+ "live"
+ ],
+ "type": "string"
+ },
+ "WindowsWorldWritableWarningNotification": {
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "extraCount": {
+ "format": "uint",
+ "minimum": 0.0,
+ "type": "integer"
+ },
+ "failedScan": {
+ "type": "boolean"
+ },
+ "samplePaths": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ }
+ },
+ "required": [
+ "extraCount",
+ "failedScan",
+ "samplePaths"
+ ],
+ "title": "WindowsWorldWritableWarningNotification",
+ "type": "object"
+ },
+ "WriteStatus": {
+ "enum": [
+ "ok",
+ "okOverridden"
+ ],
+ "type": "string"
+ }
+ }
+ },
+ "title": "CodexAppServerProtocol",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v1/AddConversationListenerParams.json b/codex-rs/app-server-protocol/schema/json/v1/AddConversationListenerParams.json
new file mode 100644
index 0000000000..67b8bd7d81
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v1/AddConversationListenerParams.json
@@ -0,0 +1,22 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "definitions": {
+ "ThreadId": {
+ "type": "string"
+ }
+ },
+ "properties": {
+ "conversationId": {
+ "$ref": "#/definitions/ThreadId"
+ },
+ "experimentalRawEvents": {
+ "default": false,
+ "type": "boolean"
+ }
+ },
+ "required": [
+ "conversationId"
+ ],
+ "title": "AddConversationListenerParams",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v1/AddConversationSubscriptionResponse.json b/codex-rs/app-server-protocol/schema/json/v1/AddConversationSubscriptionResponse.json
new file mode 100644
index 0000000000..8bd1bcf016
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v1/AddConversationSubscriptionResponse.json
@@ -0,0 +1,13 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "subscriptionId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "subscriptionId"
+ ],
+ "title": "AddConversationSubscriptionResponse",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v1/ArchiveConversationParams.json b/codex-rs/app-server-protocol/schema/json/v1/ArchiveConversationParams.json
new file mode 100644
index 0000000000..7ee5b16b3b
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v1/ArchiveConversationParams.json
@@ -0,0 +1,22 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "definitions": {
+ "ThreadId": {
+ "type": "string"
+ }
+ },
+ "properties": {
+ "conversationId": {
+ "$ref": "#/definitions/ThreadId"
+ },
+ "rolloutPath": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "conversationId",
+ "rolloutPath"
+ ],
+ "title": "ArchiveConversationParams",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v1/ArchiveConversationResponse.json b/codex-rs/app-server-protocol/schema/json/v1/ArchiveConversationResponse.json
new file mode 100644
index 0000000000..253d15cc0d
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v1/ArchiveConversationResponse.json
@@ -0,0 +1,5 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "title": "ArchiveConversationResponse",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v1/AuthStatusChangeNotification.json b/codex-rs/app-server-protocol/schema/json/v1/AuthStatusChangeNotification.json
new file mode 100644
index 0000000000..2aee28ba9c
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v1/AuthStatusChangeNotification.json
@@ -0,0 +1,46 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "definitions": {
+ "AuthMode": {
+ "description": "Authentication mode for OpenAI-backed providers.",
+ "oneOf": [
+ {
+ "description": "OpenAI API key provided by the caller and stored by Codex.",
+ "enum": [
+ "apikey"
+ ],
+ "type": "string"
+ },
+ {
+ "description": "ChatGPT OAuth managed by Codex (tokens persisted and refreshed by Codex).",
+ "enum": [
+ "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"
+ }
+ ]
+ }
+ },
+ "description": "Deprecated notification. Use AccountUpdatedNotification instead.",
+ "properties": {
+ "authMethod": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/AuthMode"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ }
+ },
+ "title": "AuthStatusChangeNotification",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v1/CancelLoginChatGptParams.json b/codex-rs/app-server-protocol/schema/json/v1/CancelLoginChatGptParams.json
new file mode 100644
index 0000000000..8367dac087
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v1/CancelLoginChatGptParams.json
@@ -0,0 +1,13 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "loginId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "loginId"
+ ],
+ "title": "CancelLoginChatGptParams",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v1/CancelLoginChatGptResponse.json b/codex-rs/app-server-protocol/schema/json/v1/CancelLoginChatGptResponse.json
new file mode 100644
index 0000000000..a4e1c333c4
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v1/CancelLoginChatGptResponse.json
@@ -0,0 +1,5 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "title": "CancelLoginChatGptResponse",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v1/ExecOneOffCommandParams.json b/codex-rs/app-server-protocol/schema/json/v1/ExecOneOffCommandParams.json
new file mode 100644
index 0000000000..a325704be4
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v1/ExecOneOffCommandParams.json
@@ -0,0 +1,158 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "definitions": {
+ "AbsolutePathBuf": {
+ "description": "A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem).\n\nIMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set, the deserialization will fail unless the path being deserialized is already absolute.",
+ "type": "string"
+ },
+ "NetworkAccess": {
+ "description": "Represents whether outbound network access is available to the agent.",
+ "enum": [
+ "restricted",
+ "enabled"
+ ],
+ "type": "string"
+ },
+ "SandboxPolicy": {
+ "description": "Determines execution restrictions for model shell commands.",
+ "oneOf": [
+ {
+ "description": "No restrictions whatsoever. Use with caution.",
+ "properties": {
+ "type": {
+ "enum": [
+ "danger-full-access"
+ ],
+ "title": "DangerFullAccessSandboxPolicyType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "DangerFullAccessSandboxPolicy",
+ "type": "object"
+ },
+ {
+ "description": "Read-only access to the entire file-system.",
+ "properties": {
+ "type": {
+ "enum": [
+ "read-only"
+ ],
+ "title": "ReadOnlySandboxPolicyType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "ReadOnlySandboxPolicy",
+ "type": "object"
+ },
+ {
+ "description": "Indicates the process is already in an external sandbox. Allows full disk access while honoring the provided network setting.",
+ "properties": {
+ "network_access": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/NetworkAccess"
+ }
+ ],
+ "default": "restricted",
+ "description": "Whether the external sandbox permits outbound network traffic."
+ },
+ "type": {
+ "enum": [
+ "external-sandbox"
+ ],
+ "title": "ExternalSandboxSandboxPolicyType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "ExternalSandboxSandboxPolicy",
+ "type": "object"
+ },
+ {
+ "description": "Same as `ReadOnly` but additionally grants write access to the current working directory (\"workspace\").",
+ "properties": {
+ "exclude_slash_tmp": {
+ "default": false,
+ "description": "When set to `true`, will NOT include the `/tmp` among the default writable roots on UNIX. Defaults to `false`.",
+ "type": "boolean"
+ },
+ "exclude_tmpdir_env_var": {
+ "default": false,
+ "description": "When set to `true`, will NOT include the per-user `TMPDIR` environment variable among the default writable roots. Defaults to `false`.",
+ "type": "boolean"
+ },
+ "network_access": {
+ "default": false,
+ "description": "When set to `true`, outbound network access is allowed. `false` by default.",
+ "type": "boolean"
+ },
+ "type": {
+ "enum": [
+ "workspace-write"
+ ],
+ "title": "WorkspaceWriteSandboxPolicyType",
+ "type": "string"
+ },
+ "writable_roots": {
+ "description": "Additional folders (beyond cwd and possibly TMPDIR) that should be writable from within the sandbox.",
+ "items": {
+ "$ref": "#/definitions/AbsolutePathBuf"
+ },
+ "type": "array"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "WorkspaceWriteSandboxPolicy",
+ "type": "object"
+ }
+ ]
+ }
+ },
+ "properties": {
+ "command": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "cwd": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "sandboxPolicy": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/SandboxPolicy"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "timeoutMs": {
+ "format": "uint64",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "command"
+ ],
+ "title": "ExecOneOffCommandParams",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v1/ExecOneOffCommandResponse.json b/codex-rs/app-server-protocol/schema/json/v1/ExecOneOffCommandResponse.json
new file mode 100644
index 0000000000..121ed648ff
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v1/ExecOneOffCommandResponse.json
@@ -0,0 +1,22 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "exitCode": {
+ "format": "int32",
+ "type": "integer"
+ },
+ "stderr": {
+ "type": "string"
+ },
+ "stdout": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "exitCode",
+ "stderr",
+ "stdout"
+ ],
+ "title": "ExecOneOffCommandResponse",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v1/ForkConversationParams.json b/codex-rs/app-server-protocol/schema/json/v1/ForkConversationParams.json
new file mode 100644
index 0000000000..bc84249516
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v1/ForkConversationParams.json
@@ -0,0 +1,159 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "definitions": {
+ "AskForApproval": {
+ "description": "Determines the conditions under which the user is consulted to approve running the command proposed by Codex.",
+ "oneOf": [
+ {
+ "description": "Under this policy, only \"known safe\" commands—as determined by `is_safe_command()`—that **only read files** are auto‑approved. Everything else will ask the user to approve.",
+ "enum": [
+ "untrusted"
+ ],
+ "type": "string"
+ },
+ {
+ "description": "*All* commands are auto‑approved, but they are expected to run inside a sandbox where network access is disabled and writes are confined to a specific set of paths. If the command fails, it will be escalated to the user to approve execution without a sandbox.",
+ "enum": [
+ "on-failure"
+ ],
+ "type": "string"
+ },
+ {
+ "description": "The model decides when to ask the user for approval.",
+ "enum": [
+ "on-request"
+ ],
+ "type": "string"
+ },
+ {
+ "description": "Never ask the user to approve commands. Failures are immediately returned to the model, and never escalated to the user for approval.",
+ "enum": [
+ "never"
+ ],
+ "type": "string"
+ }
+ ]
+ },
+ "NewConversationParams": {
+ "properties": {
+ "approvalPolicy": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/AskForApproval"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "baseInstructions": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "compactPrompt": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "config": {
+ "additionalProperties": true,
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "cwd": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "developerInstructions": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "includeApplyPatchTool": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "model": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "modelProvider": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "profile": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "sandbox": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/SandboxMode"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "SandboxMode": {
+ "enum": [
+ "read-only",
+ "workspace-write",
+ "danger-full-access"
+ ],
+ "type": "string"
+ },
+ "ThreadId": {
+ "type": "string"
+ }
+ },
+ "properties": {
+ "conversationId": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ThreadId"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "overrides": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/NewConversationParams"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "path": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "title": "ForkConversationParams",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v1/ForkConversationResponse.json b/codex-rs/app-server-protocol/schema/json/v1/ForkConversationResponse.json
new file mode 100644
index 0000000000..f4c68a9f9d
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v1/ForkConversationResponse.json
@@ -0,0 +1,5358 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "definitions": {
+ "AbsolutePathBuf": {
+ "description": "A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem).\n\nIMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set, the deserialization will fail unless the path being deserialized is already absolute.",
+ "type": "string"
+ },
+ "AgentMessageContent": {
+ "oneOf": [
+ {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "Text"
+ ],
+ "title": "TextAgentMessageContentType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "TextAgentMessageContent",
+ "type": "object"
+ }
+ ]
+ },
+ "AgentStatus": {
+ "description": "Agent lifecycle status, derived from emitted events.",
+ "oneOf": [
+ {
+ "description": "Agent is waiting for initialization.",
+ "enum": [
+ "pending_init"
+ ],
+ "type": "string"
+ },
+ {
+ "description": "Agent is currently running.",
+ "enum": [
+ "running"
+ ],
+ "type": "string"
+ },
+ {
+ "additionalProperties": false,
+ "description": "Agent is done. Contains the final assistant message.",
+ "properties": {
+ "completed": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "completed"
+ ],
+ "title": "CompletedAgentStatus",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "Agent encountered an error.",
+ "properties": {
+ "errored": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "errored"
+ ],
+ "title": "ErroredAgentStatus",
+ "type": "object"
+ },
+ {
+ "description": "Agent has been shutdown.",
+ "enum": [
+ "shutdown"
+ ],
+ "type": "string"
+ },
+ {
+ "description": "Agent is not found.",
+ "enum": [
+ "not_found"
+ ],
+ "type": "string"
+ }
+ ]
+ },
+ "Annotations": {
+ "description": "Optional annotations for the client. The client can use annotations to inform how objects are used or displayed",
+ "properties": {
+ "audience": {
+ "items": {
+ "$ref": "#/definitions/Role"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "lastModified": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "priority": {
+ "format": "double",
+ "type": [
+ "number",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "AskForApproval": {
+ "description": "Determines the conditions under which the user is consulted to approve running the command proposed by Codex.",
+ "oneOf": [
+ {
+ "description": "Under this policy, only \"known safe\" commands—as determined by `is_safe_command()`—that **only read files** are auto‑approved. Everything else will ask the user to approve.",
+ "enum": [
+ "untrusted"
+ ],
+ "type": "string"
+ },
+ {
+ "description": "*All* commands are auto‑approved, but they are expected to run inside a sandbox where network access is disabled and writes are confined to a specific set of paths. If the command fails, it will be escalated to the user to approve execution without a sandbox.",
+ "enum": [
+ "on-failure"
+ ],
+ "type": "string"
+ },
+ {
+ "description": "The model decides when to ask the user for approval.",
+ "enum": [
+ "on-request"
+ ],
+ "type": "string"
+ },
+ {
+ "description": "Never ask the user to approve commands. Failures are immediately returned to the model, and never escalated to the user for approval.",
+ "enum": [
+ "never"
+ ],
+ "type": "string"
+ }
+ ]
+ },
+ "AudioContent": {
+ "description": "Audio provided to or from an LLM.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "data": {
+ "type": "string"
+ },
+ "mimeType": {
+ "type": "string"
+ },
+ "type": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "data",
+ "mimeType",
+ "type"
+ ],
+ "type": "object"
+ },
+ "BlobResourceContents": {
+ "properties": {
+ "blob": {
+ "type": "string"
+ },
+ "mimeType": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "uri": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "blob",
+ "uri"
+ ],
+ "type": "object"
+ },
+ "ByteRange": {
+ "properties": {
+ "end": {
+ "description": "End byte offset (exclusive) within the UTF-8 text buffer.",
+ "format": "uint",
+ "minimum": 0.0,
+ "type": "integer"
+ },
+ "start": {
+ "description": "Start byte offset (inclusive) within the UTF-8 text buffer.",
+ "format": "uint",
+ "minimum": 0.0,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "end",
+ "start"
+ ],
+ "type": "object"
+ },
+ "CallToolResult": {
+ "description": "The server's response to a tool call.",
+ "properties": {
+ "content": {
+ "items": {
+ "$ref": "#/definitions/ContentBlock"
+ },
+ "type": "array"
+ },
+ "isError": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "structuredContent": true
+ },
+ "required": [
+ "content"
+ ],
+ "type": "object"
+ },
+ "CodexErrorInfo": {
+ "description": "Codex errors that we expose to clients.",
+ "oneOf": [
+ {
+ "enum": [
+ "context_window_exceeded",
+ "usage_limit_exceeded",
+ "internal_server_error",
+ "unauthorized",
+ "bad_request",
+ "sandbox_error",
+ "thread_rollback_failed",
+ "other"
+ ],
+ "type": "string"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "model_cap": {
+ "properties": {
+ "model": {
+ "type": "string"
+ },
+ "reset_after_seconds": {
+ "format": "uint64",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "model"
+ ],
+ "type": "object"
+ }
+ },
+ "required": [
+ "model_cap"
+ ],
+ "title": "ModelCapCodexErrorInfo",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "http_connection_failed": {
+ "properties": {
+ "http_status_code": {
+ "format": "uint16",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "http_connection_failed"
+ ],
+ "title": "HttpConnectionFailedCodexErrorInfo",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "Failed to connect to the response SSE stream.",
+ "properties": {
+ "response_stream_connection_failed": {
+ "properties": {
+ "http_status_code": {
+ "format": "uint16",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "response_stream_connection_failed"
+ ],
+ "title": "ResponseStreamConnectionFailedCodexErrorInfo",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "The response SSE stream disconnected in the middle of a turnbefore completion.",
+ "properties": {
+ "response_stream_disconnected": {
+ "properties": {
+ "http_status_code": {
+ "format": "uint16",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "response_stream_disconnected"
+ ],
+ "title": "ResponseStreamDisconnectedCodexErrorInfo",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "Reached the retry limit for responses.",
+ "properties": {
+ "response_too_many_failed_attempts": {
+ "properties": {
+ "http_status_code": {
+ "format": "uint16",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "response_too_many_failed_attempts"
+ ],
+ "title": "ResponseTooManyFailedAttemptsCodexErrorInfo",
+ "type": "object"
+ }
+ ]
+ },
+ "ContentBlock": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/TextContent"
+ },
+ {
+ "$ref": "#/definitions/ImageContent"
+ },
+ {
+ "$ref": "#/definitions/AudioContent"
+ },
+ {
+ "$ref": "#/definitions/ResourceLink"
+ },
+ {
+ "$ref": "#/definitions/EmbeddedResource"
+ }
+ ]
+ },
+ "ContentItem": {
+ "oneOf": [
+ {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "input_text"
+ ],
+ "title": "InputTextContentItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "InputTextContentItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "image_url": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "input_image"
+ ],
+ "title": "InputImageContentItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "image_url",
+ "type"
+ ],
+ "title": "InputImageContentItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "output_text"
+ ],
+ "title": "OutputTextContentItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "OutputTextContentItem",
+ "type": "object"
+ }
+ ]
+ },
+ "CreditsSnapshot": {
+ "properties": {
+ "balance": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "has_credits": {
+ "type": "boolean"
+ },
+ "unlimited": {
+ "type": "boolean"
+ }
+ },
+ "required": [
+ "has_credits",
+ "unlimited"
+ ],
+ "type": "object"
+ },
+ "CustomPrompt": {
+ "properties": {
+ "argument_hint": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "content": {
+ "type": "string"
+ },
+ "description": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "name": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "content",
+ "name",
+ "path"
+ ],
+ "type": "object"
+ },
+ "Duration": {
+ "properties": {
+ "nanos": {
+ "format": "uint32",
+ "minimum": 0.0,
+ "type": "integer"
+ },
+ "secs": {
+ "format": "uint64",
+ "minimum": 0.0,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "nanos",
+ "secs"
+ ],
+ "type": "object"
+ },
+ "EmbeddedResource": {
+ "description": "The contents of a resource, embedded into a prompt or tool call result.\n\nIt is up to the client how best to render embedded resources for the benefit of the LLM and/or the user.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "resource": {
+ "$ref": "#/definitions/EmbeddedResourceResource"
+ },
+ "type": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "resource",
+ "type"
+ ],
+ "type": "object"
+ },
+ "EmbeddedResourceResource": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/TextResourceContents"
+ },
+ {
+ "$ref": "#/definitions/BlobResourceContents"
+ }
+ ]
+ },
+ "EventMsg": {
+ "description": "Response event from the agent NOTE: Make sure none of these values have optional types, as it will mess up the extension code-gen.",
+ "oneOf": [
+ {
+ "description": "Error while executing a submission",
+ "properties": {
+ "codex_error_info": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/CodexErrorInfo"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "default": null
+ },
+ "message": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "error"
+ ],
+ "title": "ErrorEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "message",
+ "type"
+ ],
+ "title": "ErrorEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Warning issued while processing a submission. Unlike `Error`, this indicates the turn continued but the user should still be notified.",
+ "properties": {
+ "message": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "warning"
+ ],
+ "title": "WarningEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "message",
+ "type"
+ ],
+ "title": "WarningEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Conversation history was compacted (either automatically or manually).",
+ "properties": {
+ "type": {
+ "enum": [
+ "context_compacted"
+ ],
+ "title": "ContextCompactedEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "ContextCompactedEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Conversation history was rolled back by dropping the last N user turns.",
+ "properties": {
+ "num_turns": {
+ "description": "Number of user turns that were removed from context.",
+ "format": "uint32",
+ "minimum": 0.0,
+ "type": "integer"
+ },
+ "type": {
+ "enum": [
+ "thread_rolled_back"
+ ],
+ "title": "ThreadRolledBackEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "num_turns",
+ "type"
+ ],
+ "title": "ThreadRolledBackEventMsg",
+ "type": "object"
+ },
+ {
+ "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": "code"
+ },
+ "model_context_window": {
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "task_started"
+ ],
+ "title": "TaskStartedEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "TaskStartedEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Agent has completed all actions. v1 wire format uses `task_complete`; accept `turn_complete` for v2 interop.",
+ "properties": {
+ "last_agent_message": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "task_complete"
+ ],
+ "title": "TaskCompleteEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "TaskCompleteEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Usage update for the current session, including totals and last turn. Optional means unknown — UIs should not display when `None`.",
+ "properties": {
+ "info": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/TokenUsageInfo"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "rate_limits": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/RateLimitSnapshot"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "type": {
+ "enum": [
+ "token_count"
+ ],
+ "title": "TokenCountEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "TokenCountEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Agent text output message",
+ "properties": {
+ "message": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "agent_message"
+ ],
+ "title": "AgentMessageEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "message",
+ "type"
+ ],
+ "title": "AgentMessageEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "User/system input message (what was sent to the model)",
+ "properties": {
+ "images": {
+ "description": "Image URLs sourced from `UserInput::Image`. These are safe to replay in legacy UI history events and correspond to images sent to the model.",
+ "items": {
+ "type": "string"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "local_images": {
+ "default": [],
+ "description": "Local file paths sourced from `UserInput::LocalImage`. These are kept so the UI can reattach images when editing history, and should not be sent to the model or treated as API-ready URLs.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "message": {
+ "type": "string"
+ },
+ "text_elements": {
+ "default": [],
+ "description": "UI-defined spans within `message` used to render or persist special elements.",
+ "items": {
+ "$ref": "#/definitions/TextElement"
+ },
+ "type": "array"
+ },
+ "type": {
+ "enum": [
+ "user_message"
+ ],
+ "title": "UserMessageEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "message",
+ "type"
+ ],
+ "title": "UserMessageEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Agent text output delta message",
+ "properties": {
+ "delta": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "agent_message_delta"
+ ],
+ "title": "AgentMessageDeltaEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "delta",
+ "type"
+ ],
+ "title": "AgentMessageDeltaEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Reasoning event from agent.",
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "agent_reasoning"
+ ],
+ "title": "AgentReasoningEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "AgentReasoningEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Agent reasoning delta event from agent.",
+ "properties": {
+ "delta": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "agent_reasoning_delta"
+ ],
+ "title": "AgentReasoningDeltaEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "delta",
+ "type"
+ ],
+ "title": "AgentReasoningDeltaEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Raw chain-of-thought from agent.",
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "agent_reasoning_raw_content"
+ ],
+ "title": "AgentReasoningRawContentEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "AgentReasoningRawContentEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Agent reasoning content delta event from agent.",
+ "properties": {
+ "delta": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "agent_reasoning_raw_content_delta"
+ ],
+ "title": "AgentReasoningRawContentDeltaEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "delta",
+ "type"
+ ],
+ "title": "AgentReasoningRawContentDeltaEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Signaled when the model begins a new reasoning summary section (e.g., a new titled block).",
+ "properties": {
+ "item_id": {
+ "default": "",
+ "type": "string"
+ },
+ "summary_index": {
+ "default": 0,
+ "format": "int64",
+ "type": "integer"
+ },
+ "type": {
+ "enum": [
+ "agent_reasoning_section_break"
+ ],
+ "title": "AgentReasoningSectionBreakEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "AgentReasoningSectionBreakEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Ack the client's configure message.",
+ "properties": {
+ "approval_policy": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/AskForApproval"
+ }
+ ],
+ "description": "When to escalate for approval for execution"
+ },
+ "cwd": {
+ "description": "Working directory that should be treated as the *root* of the session.",
+ "type": "string"
+ },
+ "forked_from_id": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ThreadId"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "history_entry_count": {
+ "description": "Current number of entries in the history log.",
+ "format": "uint",
+ "minimum": 0.0,
+ "type": "integer"
+ },
+ "history_log_id": {
+ "description": "Identifier of the history log file (inode on Unix, 0 otherwise).",
+ "format": "uint64",
+ "minimum": 0.0,
+ "type": "integer"
+ },
+ "initial_messages": {
+ "description": "Optional initial messages (as events) for resumed sessions. When present, UIs can use these to seed the history.",
+ "items": {
+ "$ref": "#/definitions/EventMsg"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "model": {
+ "description": "Tell the client what model is being queried.",
+ "type": "string"
+ },
+ "model_provider_id": {
+ "type": "string"
+ },
+ "reasoning_effort": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ReasoningEffort"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "The effort the model is putting into reasoning about the user's request."
+ },
+ "rollout_path": {
+ "description": "Path in which the rollout is stored. Can be `None` for ephemeral threads",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "sandbox_policy": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/SandboxPolicy"
+ }
+ ],
+ "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"
+ ]
+ },
+ "type": {
+ "enum": [
+ "session_configured"
+ ],
+ "title": "SessionConfiguredEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "approval_policy",
+ "cwd",
+ "history_entry_count",
+ "history_log_id",
+ "model",
+ "model_provider_id",
+ "sandbox_policy",
+ "session_id",
+ "type"
+ ],
+ "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": {
+ "server": {
+ "description": "Server name being started.",
+ "type": "string"
+ },
+ "status": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/McpStartupStatus"
+ }
+ ],
+ "description": "Current startup status."
+ },
+ "type": {
+ "enum": [
+ "mcp_startup_update"
+ ],
+ "title": "McpStartupUpdateEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "server",
+ "status",
+ "type"
+ ],
+ "title": "McpStartupUpdateEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Aggregate MCP startup completion summary.",
+ "properties": {
+ "cancelled": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "failed": {
+ "items": {
+ "$ref": "#/definitions/McpStartupFailure"
+ },
+ "type": "array"
+ },
+ "ready": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "type": {
+ "enum": [
+ "mcp_startup_complete"
+ ],
+ "title": "McpStartupCompleteEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "cancelled",
+ "failed",
+ "ready",
+ "type"
+ ],
+ "title": "McpStartupCompleteEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "call_id": {
+ "description": "Identifier so this can be paired with the McpToolCallEnd event.",
+ "type": "string"
+ },
+ "invocation": {
+ "$ref": "#/definitions/McpInvocation"
+ },
+ "type": {
+ "enum": [
+ "mcp_tool_call_begin"
+ ],
+ "title": "McpToolCallBeginEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "invocation",
+ "type"
+ ],
+ "title": "McpToolCallBeginEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "call_id": {
+ "description": "Identifier for the corresponding McpToolCallBegin that finished.",
+ "type": "string"
+ },
+ "duration": {
+ "$ref": "#/definitions/Duration"
+ },
+ "invocation": {
+ "$ref": "#/definitions/McpInvocation"
+ },
+ "result": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/Result_of_CallToolResult_or_String"
+ }
+ ],
+ "description": "Result of the tool call. Note this could be an error."
+ },
+ "type": {
+ "enum": [
+ "mcp_tool_call_end"
+ ],
+ "title": "McpToolCallEndEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "duration",
+ "invocation",
+ "result",
+ "type"
+ ],
+ "title": "McpToolCallEndEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "call_id": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "web_search_begin"
+ ],
+ "title": "WebSearchBeginEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "type"
+ ],
+ "title": "WebSearchBeginEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "action": {
+ "$ref": "#/definitions/WebSearchAction"
+ },
+ "call_id": {
+ "type": "string"
+ },
+ "query": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "web_search_end"
+ ],
+ "title": "WebSearchEndEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "action",
+ "call_id",
+ "query",
+ "type"
+ ],
+ "title": "WebSearchEndEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Notification that the server is about to execute a command.",
+ "properties": {
+ "call_id": {
+ "description": "Identifier so this can be paired with the ExecCommandEnd event.",
+ "type": "string"
+ },
+ "command": {
+ "description": "The command to be executed.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "cwd": {
+ "description": "The command's working directory if not the default cwd for the agent.",
+ "type": "string"
+ },
+ "interaction_input": {
+ "description": "Raw input sent to a unified exec session (if this is an interaction event).",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "parsed_cmd": {
+ "items": {
+ "$ref": "#/definitions/ParsedCommand"
+ },
+ "type": "array"
+ },
+ "process_id": {
+ "description": "Identifier for the underlying PTY process (when available).",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "source": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ExecCommandSource"
+ }
+ ],
+ "default": "agent",
+ "description": "Where the command originated. Defaults to Agent for backward compatibility."
+ },
+ "turn_id": {
+ "description": "Turn ID that this command belongs to.",
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "exec_command_begin"
+ ],
+ "title": "ExecCommandBeginEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "command",
+ "cwd",
+ "parsed_cmd",
+ "turn_id",
+ "type"
+ ],
+ "title": "ExecCommandBeginEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Incremental chunk of output from a running command.",
+ "properties": {
+ "call_id": {
+ "description": "Identifier for the ExecCommandBegin that produced this chunk.",
+ "type": "string"
+ },
+ "chunk": {
+ "description": "Raw bytes from the stream (may not be valid UTF-8).",
+ "type": "string"
+ },
+ "stream": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ExecOutputStream"
+ }
+ ],
+ "description": "Which stream produced this chunk."
+ },
+ "type": {
+ "enum": [
+ "exec_command_output_delta"
+ ],
+ "title": "ExecCommandOutputDeltaEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "chunk",
+ "stream",
+ "type"
+ ],
+ "title": "ExecCommandOutputDeltaEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Terminal interaction for an in-progress command (stdin sent and stdout observed).",
+ "properties": {
+ "call_id": {
+ "description": "Identifier for the ExecCommandBegin that produced this chunk.",
+ "type": "string"
+ },
+ "process_id": {
+ "description": "Process id associated with the running command.",
+ "type": "string"
+ },
+ "stdin": {
+ "description": "Stdin sent to the running session.",
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "terminal_interaction"
+ ],
+ "title": "TerminalInteractionEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "process_id",
+ "stdin",
+ "type"
+ ],
+ "title": "TerminalInteractionEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "aggregated_output": {
+ "default": "",
+ "description": "Captured aggregated output",
+ "type": "string"
+ },
+ "call_id": {
+ "description": "Identifier for the ExecCommandBegin that finished.",
+ "type": "string"
+ },
+ "command": {
+ "description": "The command that was executed.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "cwd": {
+ "description": "The command's working directory if not the default cwd for the agent.",
+ "type": "string"
+ },
+ "duration": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/Duration"
+ }
+ ],
+ "description": "The duration of the command execution."
+ },
+ "exit_code": {
+ "description": "The command's exit code.",
+ "format": "int32",
+ "type": "integer"
+ },
+ "formatted_output": {
+ "description": "Formatted output from the command, as seen by the model.",
+ "type": "string"
+ },
+ "interaction_input": {
+ "description": "Raw input sent to a unified exec session (if this is an interaction event).",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "parsed_cmd": {
+ "items": {
+ "$ref": "#/definitions/ParsedCommand"
+ },
+ "type": "array"
+ },
+ "process_id": {
+ "description": "Identifier for the underlying PTY process (when available).",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "source": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ExecCommandSource"
+ }
+ ],
+ "default": "agent",
+ "description": "Where the command originated. Defaults to Agent for backward compatibility."
+ },
+ "stderr": {
+ "description": "Captured stderr",
+ "type": "string"
+ },
+ "stdout": {
+ "description": "Captured stdout",
+ "type": "string"
+ },
+ "turn_id": {
+ "description": "Turn ID that this command belongs to.",
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "exec_command_end"
+ ],
+ "title": "ExecCommandEndEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "command",
+ "cwd",
+ "duration",
+ "exit_code",
+ "formatted_output",
+ "parsed_cmd",
+ "stderr",
+ "stdout",
+ "turn_id",
+ "type"
+ ],
+ "title": "ExecCommandEndEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Notification that the agent attached a local image via the view_image tool.",
+ "properties": {
+ "call_id": {
+ "description": "Identifier for the originating tool call.",
+ "type": "string"
+ },
+ "path": {
+ "description": "Local filesystem path provided to the tool.",
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "view_image_tool_call"
+ ],
+ "title": "ViewImageToolCallEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "path",
+ "type"
+ ],
+ "title": "ViewImageToolCallEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "call_id": {
+ "description": "Identifier for the associated exec call, if available.",
+ "type": "string"
+ },
+ "command": {
+ "description": "The command to be executed.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "cwd": {
+ "description": "The command's working directory.",
+ "type": "string"
+ },
+ "parsed_cmd": {
+ "items": {
+ "$ref": "#/definitions/ParsedCommand"
+ },
+ "type": "array"
+ },
+ "proposed_execpolicy_amendment": {
+ "description": "Proposed execpolicy amendment that can be applied to allow future runs.",
+ "items": {
+ "type": "string"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "reason": {
+ "description": "Optional human-readable reason for the approval (e.g. retry without sandbox).",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "turn_id": {
+ "default": "",
+ "description": "Turn ID that this command belongs to. Uses `#[serde(default)]` for backwards compatibility.",
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "exec_approval_request"
+ ],
+ "title": "ExecApprovalRequestEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "command",
+ "cwd",
+ "parsed_cmd",
+ "type"
+ ],
+ "title": "ExecApprovalRequestEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "call_id": {
+ "description": "Responses API call id for the associated tool call, if available.",
+ "type": "string"
+ },
+ "questions": {
+ "items": {
+ "$ref": "#/definitions/RequestUserInputQuestion"
+ },
+ "type": "array"
+ },
+ "turn_id": {
+ "default": "",
+ "description": "Turn ID that this request belongs to. Uses `#[serde(default)]` for backwards compatibility.",
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "request_user_input"
+ ],
+ "title": "RequestUserInputEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "questions",
+ "type"
+ ],
+ "title": "RequestUserInputEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "arguments": true,
+ "callId": {
+ "type": "string"
+ },
+ "tool": {
+ "type": "string"
+ },
+ "turnId": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "dynamic_tool_call_request"
+ ],
+ "title": "DynamicToolCallRequestEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "arguments",
+ "callId",
+ "tool",
+ "turnId",
+ "type"
+ ],
+ "title": "DynamicToolCallRequestEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "message": {
+ "type": "string"
+ },
+ "server_name": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "elicitation_request"
+ ],
+ "title": "ElicitationRequestEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "message",
+ "server_name",
+ "type"
+ ],
+ "title": "ElicitationRequestEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "call_id": {
+ "description": "Responses API call id for the associated patch apply call, if available.",
+ "type": "string"
+ },
+ "changes": {
+ "additionalProperties": {
+ "$ref": "#/definitions/FileChange"
+ },
+ "type": "object"
+ },
+ "grant_root": {
+ "description": "When set, the agent is asking the user to allow writes under this root for the remainder of the session.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "reason": {
+ "description": "Optional explanatory reason (e.g. request for extra write access).",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "turn_id": {
+ "default": "",
+ "description": "Turn ID that this patch belongs to. Uses `#[serde(default)]` for backwards compatibility with older senders.",
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "apply_patch_approval_request"
+ ],
+ "title": "ApplyPatchApprovalRequestEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "changes",
+ "type"
+ ],
+ "title": "ApplyPatchApprovalRequestEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Notification advising the user that something they are using has been deprecated and should be phased out.",
+ "properties": {
+ "details": {
+ "description": "Optional extra guidance, such as migration steps or rationale.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "summary": {
+ "description": "Concise summary of what is deprecated.",
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "deprecation_notice"
+ ],
+ "title": "DeprecationNoticeEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "summary",
+ "type"
+ ],
+ "title": "DeprecationNoticeEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "message": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "background_event"
+ ],
+ "title": "BackgroundEventEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "message",
+ "type"
+ ],
+ "title": "BackgroundEventEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "message": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "undo_started"
+ ],
+ "title": "UndoStartedEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "UndoStartedEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "message": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "success": {
+ "type": "boolean"
+ },
+ "type": {
+ "enum": [
+ "undo_completed"
+ ],
+ "title": "UndoCompletedEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "success",
+ "type"
+ ],
+ "title": "UndoCompletedEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Notification that a model stream experienced an error or disconnect and the system is handling it (e.g., retrying with backoff).",
+ "properties": {
+ "additional_details": {
+ "default": null,
+ "description": "Optional details about the underlying stream failure (often the same human-readable message that is surfaced as the terminal error if retries are exhausted).",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "codex_error_info": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/CodexErrorInfo"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "default": null
+ },
+ "message": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "stream_error"
+ ],
+ "title": "StreamErrorEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "message",
+ "type"
+ ],
+ "title": "StreamErrorEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Notification that the agent is about to apply a code patch. Mirrors `ExecCommandBegin` so front‑ends can show progress indicators.",
+ "properties": {
+ "auto_approved": {
+ "description": "If true, there was no ApplyPatchApprovalRequest for this patch.",
+ "type": "boolean"
+ },
+ "call_id": {
+ "description": "Identifier so this can be paired with the PatchApplyEnd event.",
+ "type": "string"
+ },
+ "changes": {
+ "additionalProperties": {
+ "$ref": "#/definitions/FileChange"
+ },
+ "description": "The changes to be applied.",
+ "type": "object"
+ },
+ "turn_id": {
+ "default": "",
+ "description": "Turn ID that this patch belongs to. Uses `#[serde(default)]` for backwards compatibility.",
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "patch_apply_begin"
+ ],
+ "title": "PatchApplyBeginEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "auto_approved",
+ "call_id",
+ "changes",
+ "type"
+ ],
+ "title": "PatchApplyBeginEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Notification that a patch application has finished.",
+ "properties": {
+ "call_id": {
+ "description": "Identifier for the PatchApplyBegin that finished.",
+ "type": "string"
+ },
+ "changes": {
+ "additionalProperties": {
+ "$ref": "#/definitions/FileChange"
+ },
+ "default": {},
+ "description": "The changes that were applied (mirrors PatchApplyBeginEvent::changes).",
+ "type": "object"
+ },
+ "stderr": {
+ "description": "Captured stderr (parser errors, IO failures, etc.).",
+ "type": "string"
+ },
+ "stdout": {
+ "description": "Captured stdout (summary printed by apply_patch).",
+ "type": "string"
+ },
+ "success": {
+ "description": "Whether the patch was applied successfully.",
+ "type": "boolean"
+ },
+ "turn_id": {
+ "default": "",
+ "description": "Turn ID that this patch belongs to. Uses `#[serde(default)]` for backwards compatibility.",
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "patch_apply_end"
+ ],
+ "title": "PatchApplyEndEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "stderr",
+ "stdout",
+ "success",
+ "type"
+ ],
+ "title": "PatchApplyEndEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "turn_diff"
+ ],
+ "title": "TurnDiffEventMsgType",
+ "type": "string"
+ },
+ "unified_diff": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "unified_diff"
+ ],
+ "title": "TurnDiffEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Response to GetHistoryEntryRequest.",
+ "properties": {
+ "entry": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/HistoryEntry"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "The entry at the requested offset, if available and parseable."
+ },
+ "log_id": {
+ "format": "uint64",
+ "minimum": 0.0,
+ "type": "integer"
+ },
+ "offset": {
+ "format": "uint",
+ "minimum": 0.0,
+ "type": "integer"
+ },
+ "type": {
+ "enum": [
+ "get_history_entry_response"
+ ],
+ "title": "GetHistoryEntryResponseEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "log_id",
+ "offset",
+ "type"
+ ],
+ "title": "GetHistoryEntryResponseEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "List of MCP tools available to the agent.",
+ "properties": {
+ "auth_statuses": {
+ "additionalProperties": {
+ "$ref": "#/definitions/McpAuthStatus"
+ },
+ "description": "Authentication status for each configured MCP server.",
+ "type": "object"
+ },
+ "resource_templates": {
+ "additionalProperties": {
+ "items": {
+ "$ref": "#/definitions/ResourceTemplate"
+ },
+ "type": "array"
+ },
+ "description": "Known resource templates grouped by server name.",
+ "type": "object"
+ },
+ "resources": {
+ "additionalProperties": {
+ "items": {
+ "$ref": "#/definitions/Resource"
+ },
+ "type": "array"
+ },
+ "description": "Known resources grouped by server name.",
+ "type": "object"
+ },
+ "tools": {
+ "additionalProperties": {
+ "$ref": "#/definitions/Tool"
+ },
+ "description": "Fully qualified tool name -> tool definition.",
+ "type": "object"
+ },
+ "type": {
+ "enum": [
+ "mcp_list_tools_response"
+ ],
+ "title": "McpListToolsResponseEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "auth_statuses",
+ "resource_templates",
+ "resources",
+ "tools",
+ "type"
+ ],
+ "title": "McpListToolsResponseEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "List of custom prompts available to the agent.",
+ "properties": {
+ "custom_prompts": {
+ "items": {
+ "$ref": "#/definitions/CustomPrompt"
+ },
+ "type": "array"
+ },
+ "type": {
+ "enum": [
+ "list_custom_prompts_response"
+ ],
+ "title": "ListCustomPromptsResponseEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "custom_prompts",
+ "type"
+ ],
+ "title": "ListCustomPromptsResponseEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "List of skills available to the agent.",
+ "properties": {
+ "skills": {
+ "items": {
+ "$ref": "#/definitions/SkillsListEntry"
+ },
+ "type": "array"
+ },
+ "type": {
+ "enum": [
+ "list_skills_response"
+ ],
+ "title": "ListSkillsResponseEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "skills",
+ "type"
+ ],
+ "title": "ListSkillsResponseEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Notification that skill data may have been updated and clients may want to reload.",
+ "properties": {
+ "type": {
+ "enum": [
+ "skills_update_available"
+ ],
+ "title": "SkillsUpdateAvailableEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "SkillsUpdateAvailableEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "explanation": {
+ "default": null,
+ "description": "Arguments for the `update_plan` todo/checklist tool (not plan mode).",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "plan": {
+ "items": {
+ "$ref": "#/definitions/PlanItemArg"
+ },
+ "type": "array"
+ },
+ "type": {
+ "enum": [
+ "plan_update"
+ ],
+ "title": "PlanUpdateEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "plan",
+ "type"
+ ],
+ "title": "PlanUpdateEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "reason": {
+ "$ref": "#/definitions/TurnAbortReason"
+ },
+ "type": {
+ "enum": [
+ "turn_aborted"
+ ],
+ "title": "TurnAbortedEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "reason",
+ "type"
+ ],
+ "title": "TurnAbortedEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Notification that the agent is shutting down.",
+ "properties": {
+ "type": {
+ "enum": [
+ "shutdown_complete"
+ ],
+ "title": "ShutdownCompleteEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "ShutdownCompleteEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Entered review mode.",
+ "properties": {
+ "target": {
+ "$ref": "#/definitions/ReviewTarget"
+ },
+ "type": {
+ "enum": [
+ "entered_review_mode"
+ ],
+ "title": "EnteredReviewModeEventMsgType",
+ "type": "string"
+ },
+ "user_facing_hint": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "target",
+ "type"
+ ],
+ "title": "EnteredReviewModeEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Exited review mode with an optional final result to apply.",
+ "properties": {
+ "review_output": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ReviewOutputEvent"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "type": {
+ "enum": [
+ "exited_review_mode"
+ ],
+ "title": "ExitedReviewModeEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "ExitedReviewModeEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "item": {
+ "$ref": "#/definitions/ResponseItem"
+ },
+ "type": {
+ "enum": [
+ "raw_response_item"
+ ],
+ "title": "RawResponseItemEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "item",
+ "type"
+ ],
+ "title": "RawResponseItemEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "item": {
+ "$ref": "#/definitions/TurnItem"
+ },
+ "thread_id": {
+ "$ref": "#/definitions/ThreadId"
+ },
+ "turn_id": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "item_started"
+ ],
+ "title": "ItemStartedEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "item",
+ "thread_id",
+ "turn_id",
+ "type"
+ ],
+ "title": "ItemStartedEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "item": {
+ "$ref": "#/definitions/TurnItem"
+ },
+ "thread_id": {
+ "$ref": "#/definitions/ThreadId"
+ },
+ "turn_id": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "item_completed"
+ ],
+ "title": "ItemCompletedEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "item",
+ "thread_id",
+ "turn_id",
+ "type"
+ ],
+ "title": "ItemCompletedEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "delta": {
+ "type": "string"
+ },
+ "item_id": {
+ "type": "string"
+ },
+ "thread_id": {
+ "type": "string"
+ },
+ "turn_id": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "agent_message_content_delta"
+ ],
+ "title": "AgentMessageContentDeltaEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "delta",
+ "item_id",
+ "thread_id",
+ "turn_id",
+ "type"
+ ],
+ "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": {
+ "type": "string"
+ },
+ "item_id": {
+ "type": "string"
+ },
+ "summary_index": {
+ "default": 0,
+ "format": "int64",
+ "type": "integer"
+ },
+ "thread_id": {
+ "type": "string"
+ },
+ "turn_id": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "reasoning_content_delta"
+ ],
+ "title": "ReasoningContentDeltaEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "delta",
+ "item_id",
+ "thread_id",
+ "turn_id",
+ "type"
+ ],
+ "title": "ReasoningContentDeltaEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "content_index": {
+ "default": 0,
+ "format": "int64",
+ "type": "integer"
+ },
+ "delta": {
+ "type": "string"
+ },
+ "item_id": {
+ "type": "string"
+ },
+ "thread_id": {
+ "type": "string"
+ },
+ "turn_id": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "reasoning_raw_content_delta"
+ ],
+ "title": "ReasoningRawContentDeltaEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "delta",
+ "item_id",
+ "thread_id",
+ "turn_id",
+ "type"
+ ],
+ "title": "ReasoningRawContentDeltaEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Collab interaction: agent spawn begin.",
+ "properties": {
+ "call_id": {
+ "description": "Identifier for the collab tool call.",
+ "type": "string"
+ },
+ "prompt": {
+ "description": "Initial prompt sent to the agent. Can be empty to prevent CoT leaking at the beginning.",
+ "type": "string"
+ },
+ "sender_thread_id": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ThreadId"
+ }
+ ],
+ "description": "Thread ID of the sender."
+ },
+ "type": {
+ "enum": [
+ "collab_agent_spawn_begin"
+ ],
+ "title": "CollabAgentSpawnBeginEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "prompt",
+ "sender_thread_id",
+ "type"
+ ],
+ "title": "CollabAgentSpawnBeginEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Collab interaction: agent spawn end.",
+ "properties": {
+ "call_id": {
+ "description": "Identifier for the collab tool call.",
+ "type": "string"
+ },
+ "new_thread_id": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ThreadId"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Thread ID of the newly spawned agent, if it was created."
+ },
+ "prompt": {
+ "description": "Initial prompt sent to the agent. Can be empty to prevent CoT leaking at the beginning.",
+ "type": "string"
+ },
+ "sender_thread_id": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ThreadId"
+ }
+ ],
+ "description": "Thread ID of the sender."
+ },
+ "status": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/AgentStatus"
+ }
+ ],
+ "description": "Last known status of the new agent reported to the sender agent."
+ },
+ "type": {
+ "enum": [
+ "collab_agent_spawn_end"
+ ],
+ "title": "CollabAgentSpawnEndEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "prompt",
+ "sender_thread_id",
+ "status",
+ "type"
+ ],
+ "title": "CollabAgentSpawnEndEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Collab interaction: agent interaction begin.",
+ "properties": {
+ "call_id": {
+ "description": "Identifier for the collab tool call.",
+ "type": "string"
+ },
+ "prompt": {
+ "description": "Prompt sent from the sender to the receiver. Can be empty to prevent CoT leaking at the beginning.",
+ "type": "string"
+ },
+ "receiver_thread_id": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ThreadId"
+ }
+ ],
+ "description": "Thread ID of the receiver."
+ },
+ "sender_thread_id": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ThreadId"
+ }
+ ],
+ "description": "Thread ID of the sender."
+ },
+ "type": {
+ "enum": [
+ "collab_agent_interaction_begin"
+ ],
+ "title": "CollabAgentInteractionBeginEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "prompt",
+ "receiver_thread_id",
+ "sender_thread_id",
+ "type"
+ ],
+ "title": "CollabAgentInteractionBeginEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Collab interaction: agent interaction end.",
+ "properties": {
+ "call_id": {
+ "description": "Identifier for the collab tool call.",
+ "type": "string"
+ },
+ "prompt": {
+ "description": "Prompt sent from the sender to the receiver. Can be empty to prevent CoT leaking at the beginning.",
+ "type": "string"
+ },
+ "receiver_thread_id": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ThreadId"
+ }
+ ],
+ "description": "Thread ID of the receiver."
+ },
+ "sender_thread_id": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ThreadId"
+ }
+ ],
+ "description": "Thread ID of the sender."
+ },
+ "status": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/AgentStatus"
+ }
+ ],
+ "description": "Last known status of the receiver agent reported to the sender agent."
+ },
+ "type": {
+ "enum": [
+ "collab_agent_interaction_end"
+ ],
+ "title": "CollabAgentInteractionEndEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "prompt",
+ "receiver_thread_id",
+ "sender_thread_id",
+ "status",
+ "type"
+ ],
+ "title": "CollabAgentInteractionEndEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Collab interaction: waiting begin.",
+ "properties": {
+ "call_id": {
+ "description": "ID of the waiting call.",
+ "type": "string"
+ },
+ "receiver_thread_ids": {
+ "description": "Thread ID of the receivers.",
+ "items": {
+ "$ref": "#/definitions/ThreadId"
+ },
+ "type": "array"
+ },
+ "sender_thread_id": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ThreadId"
+ }
+ ],
+ "description": "Thread ID of the sender."
+ },
+ "type": {
+ "enum": [
+ "collab_waiting_begin"
+ ],
+ "title": "CollabWaitingBeginEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "receiver_thread_ids",
+ "sender_thread_id",
+ "type"
+ ],
+ "title": "CollabWaitingBeginEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Collab interaction: waiting end.",
+ "properties": {
+ "call_id": {
+ "description": "ID of the waiting call.",
+ "type": "string"
+ },
+ "sender_thread_id": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ThreadId"
+ }
+ ],
+ "description": "Thread ID of the sender."
+ },
+ "statuses": {
+ "additionalProperties": {
+ "$ref": "#/definitions/AgentStatus"
+ },
+ "description": "Last known status of the receiver agents reported to the sender agent.",
+ "type": "object"
+ },
+ "type": {
+ "enum": [
+ "collab_waiting_end"
+ ],
+ "title": "CollabWaitingEndEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "sender_thread_id",
+ "statuses",
+ "type"
+ ],
+ "title": "CollabWaitingEndEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Collab interaction: close begin.",
+ "properties": {
+ "call_id": {
+ "description": "Identifier for the collab tool call.",
+ "type": "string"
+ },
+ "receiver_thread_id": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ThreadId"
+ }
+ ],
+ "description": "Thread ID of the receiver."
+ },
+ "sender_thread_id": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ThreadId"
+ }
+ ],
+ "description": "Thread ID of the sender."
+ },
+ "type": {
+ "enum": [
+ "collab_close_begin"
+ ],
+ "title": "CollabCloseBeginEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "receiver_thread_id",
+ "sender_thread_id",
+ "type"
+ ],
+ "title": "CollabCloseBeginEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Collab interaction: close end.",
+ "properties": {
+ "call_id": {
+ "description": "Identifier for the collab tool call.",
+ "type": "string"
+ },
+ "receiver_thread_id": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ThreadId"
+ }
+ ],
+ "description": "Thread ID of the receiver."
+ },
+ "sender_thread_id": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ThreadId"
+ }
+ ],
+ "description": "Thread ID of the sender."
+ },
+ "status": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/AgentStatus"
+ }
+ ],
+ "description": "Last known status of the receiver agent reported to the sender agent before the close."
+ },
+ "type": {
+ "enum": [
+ "collab_close_end"
+ ],
+ "title": "CollabCloseEndEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "receiver_thread_id",
+ "sender_thread_id",
+ "status",
+ "type"
+ ],
+ "title": "CollabCloseEndEventMsg",
+ "type": "object"
+ }
+ ]
+ },
+ "ExecCommandSource": {
+ "enum": [
+ "agent",
+ "user_shell",
+ "unified_exec_startup",
+ "unified_exec_interaction"
+ ],
+ "type": "string"
+ },
+ "ExecOutputStream": {
+ "enum": [
+ "stdout",
+ "stderr"
+ ],
+ "type": "string"
+ },
+ "FileChange": {
+ "oneOf": [
+ {
+ "properties": {
+ "content": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "add"
+ ],
+ "title": "AddFileChangeType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "content",
+ "type"
+ ],
+ "title": "AddFileChange",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "content": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "delete"
+ ],
+ "title": "DeleteFileChangeType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "content",
+ "type"
+ ],
+ "title": "DeleteFileChange",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "move_path": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "update"
+ ],
+ "title": "UpdateFileChangeType",
+ "type": "string"
+ },
+ "unified_diff": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "unified_diff"
+ ],
+ "title": "UpdateFileChange",
+ "type": "object"
+ }
+ ]
+ },
+ "FunctionCallOutputContentItem": {
+ "description": "Responses API compatible content items that can be returned by a tool call. This is a subset of ContentItem with the types we support as function call outputs.",
+ "oneOf": [
+ {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "input_text"
+ ],
+ "title": "InputTextFunctionCallOutputContentItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "InputTextFunctionCallOutputContentItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "image_url": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "input_image"
+ ],
+ "title": "InputImageFunctionCallOutputContentItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "image_url",
+ "type"
+ ],
+ "title": "InputImageFunctionCallOutputContentItem",
+ "type": "object"
+ }
+ ]
+ },
+ "FunctionCallOutputPayload": {
+ "description": "The payload we send back to OpenAI when reporting a tool call result.\n\n`content` preserves the historical plain-string payload so downstream integrations (tests, logging, etc.) can keep treating tool output as `String`. When an MCP server returns richer data we additionally populate `content_items` with the structured form that the Responses/Chat Completions APIs understand.",
+ "properties": {
+ "content": {
+ "type": "string"
+ },
+ "content_items": {
+ "items": {
+ "$ref": "#/definitions/FunctionCallOutputContentItem"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "success": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "content"
+ ],
+ "type": "object"
+ },
+ "GhostCommit": {
+ "description": "Details of a ghost commit created from a repository state.",
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "parent": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "preexisting_untracked_dirs": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "preexisting_untracked_files": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ }
+ },
+ "required": [
+ "id",
+ "preexisting_untracked_dirs",
+ "preexisting_untracked_files"
+ ],
+ "type": "object"
+ },
+ "HistoryEntry": {
+ "properties": {
+ "conversation_id": {
+ "type": "string"
+ },
+ "text": {
+ "type": "string"
+ },
+ "ts": {
+ "format": "uint64",
+ "minimum": 0.0,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "conversation_id",
+ "text",
+ "ts"
+ ],
+ "type": "object"
+ },
+ "ImageContent": {
+ "description": "An image provided to or from an LLM.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "data": {
+ "type": "string"
+ },
+ "mimeType": {
+ "type": "string"
+ },
+ "type": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "data",
+ "mimeType",
+ "type"
+ ],
+ "type": "object"
+ },
+ "LocalShellAction": {
+ "oneOf": [
+ {
+ "properties": {
+ "command": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "env": {
+ "additionalProperties": {
+ "type": "string"
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "timeout_ms": {
+ "format": "uint64",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "exec"
+ ],
+ "title": "ExecLocalShellActionType",
+ "type": "string"
+ },
+ "user": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "working_directory": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "command",
+ "type"
+ ],
+ "title": "ExecLocalShellAction",
+ "type": "object"
+ }
+ ]
+ },
+ "LocalShellStatus": {
+ "enum": [
+ "completed",
+ "in_progress",
+ "incomplete"
+ ],
+ "type": "string"
+ },
+ "McpAuthStatus": {
+ "enum": [
+ "unsupported",
+ "not_logged_in",
+ "bearer_token",
+ "o_auth"
+ ],
+ "type": "string"
+ },
+ "McpInvocation": {
+ "properties": {
+ "arguments": {
+ "description": "Arguments to the tool call."
+ },
+ "server": {
+ "description": "Name of the MCP server as defined in the config.",
+ "type": "string"
+ },
+ "tool": {
+ "description": "Name of the tool as given by the MCP server.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "server",
+ "tool"
+ ],
+ "type": "object"
+ },
+ "McpStartupFailure": {
+ "properties": {
+ "error": {
+ "type": "string"
+ },
+ "server": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "error",
+ "server"
+ ],
+ "type": "object"
+ },
+ "McpStartupStatus": {
+ "oneOf": [
+ {
+ "properties": {
+ "state": {
+ "enum": [
+ "starting"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "state"
+ ],
+ "title": "StateMcpStartupStatus",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "state": {
+ "enum": [
+ "ready"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "state"
+ ],
+ "title": "StateMcpStartupStatus2",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "error": {
+ "type": "string"
+ },
+ "state": {
+ "enum": [
+ "failed"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "error",
+ "state"
+ ],
+ "type": "object"
+ },
+ {
+ "properties": {
+ "state": {
+ "enum": [
+ "cancelled"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "state"
+ ],
+ "title": "StateMcpStartupStatus3",
+ "type": "object"
+ }
+ ]
+ },
+ "ModeKind": {
+ "description": "Initial collaboration mode to use when the TUI starts.",
+ "enum": [
+ "plan",
+ "code",
+ "pair_programming",
+ "execute",
+ "custom"
+ ],
+ "type": "string"
+ },
+ "NetworkAccess": {
+ "description": "Represents whether outbound network access is available to the agent.",
+ "enum": [
+ "restricted",
+ "enabled"
+ ],
+ "type": "string"
+ },
+ "ParsedCommand": {
+ "oneOf": [
+ {
+ "properties": {
+ "cmd": {
+ "type": "string"
+ },
+ "name": {
+ "type": "string"
+ },
+ "path": {
+ "description": "(Best effort) Path to the file being read by the command. When possible, this is an absolute path, though when relative, it should be resolved against the `cwd`` that will be used to run the command to derive the absolute path.",
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "read"
+ ],
+ "title": "ReadParsedCommandType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "cmd",
+ "name",
+ "path",
+ "type"
+ ],
+ "title": "ReadParsedCommand",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "cmd": {
+ "type": "string"
+ },
+ "path": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "list_files"
+ ],
+ "title": "ListFilesParsedCommandType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "cmd",
+ "type"
+ ],
+ "title": "ListFilesParsedCommand",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "cmd": {
+ "type": "string"
+ },
+ "path": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "query": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "search"
+ ],
+ "title": "SearchParsedCommandType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "cmd",
+ "type"
+ ],
+ "title": "SearchParsedCommand",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "cmd": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "unknown"
+ ],
+ "title": "UnknownParsedCommandType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "cmd",
+ "type"
+ ],
+ "title": "UnknownParsedCommand",
+ "type": "object"
+ }
+ ]
+ },
+ "PlanItemArg": {
+ "additionalProperties": false,
+ "properties": {
+ "status": {
+ "$ref": "#/definitions/StepStatus"
+ },
+ "step": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "status",
+ "step"
+ ],
+ "type": "object"
+ },
+ "PlanType": {
+ "enum": [
+ "free",
+ "go",
+ "plus",
+ "pro",
+ "team",
+ "business",
+ "enterprise",
+ "edu",
+ "unknown"
+ ],
+ "type": "string"
+ },
+ "RateLimitSnapshot": {
+ "properties": {
+ "credits": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/CreditsSnapshot"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "plan_type": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/PlanType"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "primary": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/RateLimitWindow"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "secondary": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/RateLimitWindow"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "RateLimitWindow": {
+ "properties": {
+ "resets_at": {
+ "description": "Unix timestamp (seconds since epoch) when the window resets.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "used_percent": {
+ "description": "Percentage (0-100) of the window that has been consumed.",
+ "format": "double",
+ "type": "number"
+ },
+ "window_minutes": {
+ "description": "Rolling window duration, in minutes.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "used_percent"
+ ],
+ "type": "object"
+ },
+ "ReasoningEffort": {
+ "description": "See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#get-started-with-reasoning",
+ "enum": [
+ "none",
+ "minimal",
+ "low",
+ "medium",
+ "high",
+ "xhigh"
+ ],
+ "type": "string"
+ },
+ "ReasoningItemContent": {
+ "oneOf": [
+ {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "reasoning_text"
+ ],
+ "title": "ReasoningTextReasoningItemContentType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "ReasoningTextReasoningItemContent",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "text"
+ ],
+ "title": "TextReasoningItemContentType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "TextReasoningItemContent",
+ "type": "object"
+ }
+ ]
+ },
+ "ReasoningItemReasoningSummary": {
+ "oneOf": [
+ {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "summary_text"
+ ],
+ "title": "SummaryTextReasoningItemReasoningSummaryType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "SummaryTextReasoningItemReasoningSummary",
+ "type": "object"
+ }
+ ]
+ },
+ "RequestId": {
+ "anyOf": [
+ {
+ "type": "string"
+ },
+ {
+ "format": "int64",
+ "type": "integer"
+ }
+ ]
+ },
+ "RequestUserInputQuestion": {
+ "properties": {
+ "header": {
+ "type": "string"
+ },
+ "id": {
+ "type": "string"
+ },
+ "isOther": {
+ "default": false,
+ "type": "boolean"
+ },
+ "isSecret": {
+ "default": false,
+ "type": "boolean"
+ },
+ "options": {
+ "items": {
+ "$ref": "#/definitions/RequestUserInputQuestionOption"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "question": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "header",
+ "id",
+ "question"
+ ],
+ "type": "object"
+ },
+ "RequestUserInputQuestionOption": {
+ "properties": {
+ "description": {
+ "type": "string"
+ },
+ "label": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "description",
+ "label"
+ ],
+ "type": "object"
+ },
+ "Resource": {
+ "description": "A known resource that the server is capable of reading.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "description": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "mimeType": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "name": {
+ "type": "string"
+ },
+ "size": {
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "title": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "uri": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "uri"
+ ],
+ "type": "object"
+ },
+ "ResourceLink": {
+ "description": "A resource that the server is capable of reading, included in a prompt or tool call result.\n\nNote: resource links returned by tools are not guaranteed to appear in the results of `resources/list` requests.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "description": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "mimeType": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "name": {
+ "type": "string"
+ },
+ "size": {
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "title": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "type": "string"
+ },
+ "uri": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "type",
+ "uri"
+ ],
+ "type": "object"
+ },
+ "ResourceTemplate": {
+ "description": "A template description for resources available on the server.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "description": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "mimeType": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "name": {
+ "type": "string"
+ },
+ "title": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "uriTemplate": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "uriTemplate"
+ ],
+ "type": "object"
+ },
+ "ResponseItem": {
+ "oneOf": [
+ {
+ "properties": {
+ "content": {
+ "items": {
+ "$ref": "#/definitions/ContentItem"
+ },
+ "type": "array"
+ },
+ "end_turn": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "id": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "writeOnly": true
+ },
+ "role": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "message"
+ ],
+ "title": "MessageResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "content",
+ "role",
+ "type"
+ ],
+ "title": "MessageResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "content": {
+ "default": null,
+ "items": {
+ "$ref": "#/definitions/ReasoningItemContent"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "encrypted_content": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "id": {
+ "type": "string",
+ "writeOnly": true
+ },
+ "summary": {
+ "items": {
+ "$ref": "#/definitions/ReasoningItemReasoningSummary"
+ },
+ "type": "array"
+ },
+ "type": {
+ "enum": [
+ "reasoning"
+ ],
+ "title": "ReasoningResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "summary",
+ "type"
+ ],
+ "title": "ReasoningResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "action": {
+ "$ref": "#/definitions/LocalShellAction"
+ },
+ "call_id": {
+ "description": "Set when using the Responses API.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "id": {
+ "description": "Set when using the chat completions API.",
+ "type": [
+ "string",
+ "null"
+ ],
+ "writeOnly": true
+ },
+ "status": {
+ "$ref": "#/definitions/LocalShellStatus"
+ },
+ "type": {
+ "enum": [
+ "local_shell_call"
+ ],
+ "title": "LocalShellCallResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "action",
+ "status",
+ "type"
+ ],
+ "title": "LocalShellCallResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "arguments": {
+ "type": "string"
+ },
+ "call_id": {
+ "type": "string"
+ },
+ "id": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "writeOnly": true
+ },
+ "name": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "function_call"
+ ],
+ "title": "FunctionCallResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "arguments",
+ "call_id",
+ "name",
+ "type"
+ ],
+ "title": "FunctionCallResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "call_id": {
+ "type": "string"
+ },
+ "output": {
+ "$ref": "#/definitions/FunctionCallOutputPayload"
+ },
+ "type": {
+ "enum": [
+ "function_call_output"
+ ],
+ "title": "FunctionCallOutputResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "output",
+ "type"
+ ],
+ "title": "FunctionCallOutputResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "call_id": {
+ "type": "string"
+ },
+ "id": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "writeOnly": true
+ },
+ "input": {
+ "type": "string"
+ },
+ "name": {
+ "type": "string"
+ },
+ "status": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "custom_tool_call"
+ ],
+ "title": "CustomToolCallResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "input",
+ "name",
+ "type"
+ ],
+ "title": "CustomToolCallResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "call_id": {
+ "type": "string"
+ },
+ "output": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "custom_tool_call_output"
+ ],
+ "title": "CustomToolCallOutputResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "output",
+ "type"
+ ],
+ "title": "CustomToolCallOutputResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "action": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/WebSearchAction"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "id": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "writeOnly": true
+ },
+ "status": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "web_search_call"
+ ],
+ "title": "WebSearchCallResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "WebSearchCallResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "ghost_commit": {
+ "$ref": "#/definitions/GhostCommit"
+ },
+ "type": {
+ "enum": [
+ "ghost_snapshot"
+ ],
+ "title": "GhostSnapshotResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "ghost_commit",
+ "type"
+ ],
+ "title": "GhostSnapshotResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "encrypted_content": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "compaction"
+ ],
+ "title": "CompactionResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "encrypted_content",
+ "type"
+ ],
+ "title": "CompactionResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "other"
+ ],
+ "title": "OtherResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "OtherResponseItem",
+ "type": "object"
+ }
+ ]
+ },
+ "Result_of_CallToolResult_or_String": {
+ "oneOf": [
+ {
+ "properties": {
+ "Ok": {
+ "$ref": "#/definitions/CallToolResult"
+ }
+ },
+ "required": [
+ "Ok"
+ ],
+ "title": "OkResult_of_CallToolResult_or_String",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "Err": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "Err"
+ ],
+ "title": "ErrResult_of_CallToolResult_or_String",
+ "type": "object"
+ }
+ ]
+ },
+ "ReviewCodeLocation": {
+ "description": "Location of the code related to a review finding.",
+ "properties": {
+ "absolute_file_path": {
+ "type": "string"
+ },
+ "line_range": {
+ "$ref": "#/definitions/ReviewLineRange"
+ }
+ },
+ "required": [
+ "absolute_file_path",
+ "line_range"
+ ],
+ "type": "object"
+ },
+ "ReviewFinding": {
+ "description": "A single review finding describing an observed issue or recommendation.",
+ "properties": {
+ "body": {
+ "type": "string"
+ },
+ "code_location": {
+ "$ref": "#/definitions/ReviewCodeLocation"
+ },
+ "confidence_score": {
+ "format": "float",
+ "type": "number"
+ },
+ "priority": {
+ "format": "int32",
+ "type": "integer"
+ },
+ "title": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "body",
+ "code_location",
+ "confidence_score",
+ "priority",
+ "title"
+ ],
+ "type": "object"
+ },
+ "ReviewLineRange": {
+ "description": "Inclusive line range in a file associated with the finding.",
+ "properties": {
+ "end": {
+ "format": "uint32",
+ "minimum": 0.0,
+ "type": "integer"
+ },
+ "start": {
+ "format": "uint32",
+ "minimum": 0.0,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "end",
+ "start"
+ ],
+ "type": "object"
+ },
+ "ReviewOutputEvent": {
+ "description": "Structured review result produced by a child review session.",
+ "properties": {
+ "findings": {
+ "items": {
+ "$ref": "#/definitions/ReviewFinding"
+ },
+ "type": "array"
+ },
+ "overall_confidence_score": {
+ "format": "float",
+ "type": "number"
+ },
+ "overall_correctness": {
+ "type": "string"
+ },
+ "overall_explanation": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "findings",
+ "overall_confidence_score",
+ "overall_correctness",
+ "overall_explanation"
+ ],
+ "type": "object"
+ },
+ "ReviewTarget": {
+ "oneOf": [
+ {
+ "description": "Review the working tree: staged, unstaged, and untracked files.",
+ "properties": {
+ "type": {
+ "enum": [
+ "uncommittedChanges"
+ ],
+ "title": "UncommittedChangesReviewTargetType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "UncommittedChangesReviewTarget",
+ "type": "object"
+ },
+ {
+ "description": "Review changes between the current branch and the given base branch.",
+ "properties": {
+ "branch": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "baseBranch"
+ ],
+ "title": "BaseBranchReviewTargetType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "branch",
+ "type"
+ ],
+ "title": "BaseBranchReviewTarget",
+ "type": "object"
+ },
+ {
+ "description": "Review the changes introduced by a specific commit.",
+ "properties": {
+ "sha": {
+ "type": "string"
+ },
+ "title": {
+ "description": "Optional human-readable label (e.g., commit subject) for UIs.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "commit"
+ ],
+ "title": "CommitReviewTargetType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "sha",
+ "type"
+ ],
+ "title": "CommitReviewTarget",
+ "type": "object"
+ },
+ {
+ "description": "Arbitrary instructions provided by the user.",
+ "properties": {
+ "instructions": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "custom"
+ ],
+ "title": "CustomReviewTargetType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "instructions",
+ "type"
+ ],
+ "title": "CustomReviewTarget",
+ "type": "object"
+ }
+ ]
+ },
+ "Role": {
+ "description": "The sender or recipient of messages and data in a conversation.",
+ "enum": [
+ "assistant",
+ "user"
+ ],
+ "type": "string"
+ },
+ "SandboxPolicy": {
+ "description": "Determines execution restrictions for model shell commands.",
+ "oneOf": [
+ {
+ "description": "No restrictions whatsoever. Use with caution.",
+ "properties": {
+ "type": {
+ "enum": [
+ "danger-full-access"
+ ],
+ "title": "DangerFullAccessSandboxPolicyType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "DangerFullAccessSandboxPolicy",
+ "type": "object"
+ },
+ {
+ "description": "Read-only access to the entire file-system.",
+ "properties": {
+ "type": {
+ "enum": [
+ "read-only"
+ ],
+ "title": "ReadOnlySandboxPolicyType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "ReadOnlySandboxPolicy",
+ "type": "object"
+ },
+ {
+ "description": "Indicates the process is already in an external sandbox. Allows full disk access while honoring the provided network setting.",
+ "properties": {
+ "network_access": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/NetworkAccess"
+ }
+ ],
+ "default": "restricted",
+ "description": "Whether the external sandbox permits outbound network traffic."
+ },
+ "type": {
+ "enum": [
+ "external-sandbox"
+ ],
+ "title": "ExternalSandboxSandboxPolicyType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "ExternalSandboxSandboxPolicy",
+ "type": "object"
+ },
+ {
+ "description": "Same as `ReadOnly` but additionally grants write access to the current working directory (\"workspace\").",
+ "properties": {
+ "exclude_slash_tmp": {
+ "default": false,
+ "description": "When set to `true`, will NOT include the `/tmp` among the default writable roots on UNIX. Defaults to `false`.",
+ "type": "boolean"
+ },
+ "exclude_tmpdir_env_var": {
+ "default": false,
+ "description": "When set to `true`, will NOT include the per-user `TMPDIR` environment variable among the default writable roots. Defaults to `false`.",
+ "type": "boolean"
+ },
+ "network_access": {
+ "default": false,
+ "description": "When set to `true`, outbound network access is allowed. `false` by default.",
+ "type": "boolean"
+ },
+ "type": {
+ "enum": [
+ "workspace-write"
+ ],
+ "title": "WorkspaceWriteSandboxPolicyType",
+ "type": "string"
+ },
+ "writable_roots": {
+ "description": "Additional folders (beyond cwd and possibly TMPDIR) that should be writable from within the sandbox.",
+ "items": {
+ "$ref": "#/definitions/AbsolutePathBuf"
+ },
+ "type": "array"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "WorkspaceWriteSandboxPolicy",
+ "type": "object"
+ }
+ ]
+ },
+ "SkillDependencies": {
+ "properties": {
+ "tools": {
+ "items": {
+ "$ref": "#/definitions/SkillToolDependency"
+ },
+ "type": "array"
+ }
+ },
+ "required": [
+ "tools"
+ ],
+ "type": "object"
+ },
+ "SkillErrorInfo": {
+ "properties": {
+ "message": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "message",
+ "path"
+ ],
+ "type": "object"
+ },
+ "SkillInterface": {
+ "properties": {
+ "brand_color": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "default_prompt": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "display_name": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "icon_large": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "icon_small": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "short_description": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "SkillMetadata": {
+ "properties": {
+ "dependencies": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/SkillDependencies"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "description": {
+ "type": "string"
+ },
+ "enabled": {
+ "type": "boolean"
+ },
+ "interface": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/SkillInterface"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "name": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "scope": {
+ "$ref": "#/definitions/SkillScope"
+ },
+ "short_description": {
+ "description": "Legacy short_description from SKILL.md. Prefer SKILL.json interface.short_description.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "description",
+ "enabled",
+ "name",
+ "path",
+ "scope"
+ ],
+ "type": "object"
+ },
+ "SkillScope": {
+ "enum": [
+ "user",
+ "repo",
+ "system",
+ "admin"
+ ],
+ "type": "string"
+ },
+ "SkillToolDependency": {
+ "properties": {
+ "command": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "description": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "transport": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "type": "string"
+ },
+ "url": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "value": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "value"
+ ],
+ "type": "object"
+ },
+ "SkillsListEntry": {
+ "properties": {
+ "cwd": {
+ "type": "string"
+ },
+ "errors": {
+ "items": {
+ "$ref": "#/definitions/SkillErrorInfo"
+ },
+ "type": "array"
+ },
+ "skills": {
+ "items": {
+ "$ref": "#/definitions/SkillMetadata"
+ },
+ "type": "array"
+ }
+ },
+ "required": [
+ "cwd",
+ "errors",
+ "skills"
+ ],
+ "type": "object"
+ },
+ "StepStatus": {
+ "enum": [
+ "pending",
+ "in_progress",
+ "completed"
+ ],
+ "type": "string"
+ },
+ "TextContent": {
+ "description": "Text provided to or from an LLM.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "type": "object"
+ },
+ "TextElement": {
+ "properties": {
+ "byte_range": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ByteRange"
+ }
+ ],
+ "description": "Byte range in the parent `text` buffer that this element occupies."
+ },
+ "placeholder": {
+ "description": "Optional human-readable placeholder for the element, displayed in the UI.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "byte_range"
+ ],
+ "type": "object"
+ },
+ "TextResourceContents": {
+ "properties": {
+ "mimeType": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "text": {
+ "type": "string"
+ },
+ "uri": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "uri"
+ ],
+ "type": "object"
+ },
+ "ThreadId": {
+ "type": "string"
+ },
+ "TokenUsage": {
+ "properties": {
+ "cached_input_tokens": {
+ "format": "int64",
+ "type": "integer"
+ },
+ "input_tokens": {
+ "format": "int64",
+ "type": "integer"
+ },
+ "output_tokens": {
+ "format": "int64",
+ "type": "integer"
+ },
+ "reasoning_output_tokens": {
+ "format": "int64",
+ "type": "integer"
+ },
+ "total_tokens": {
+ "format": "int64",
+ "type": "integer"
+ }
+ },
+ "required": [
+ "cached_input_tokens",
+ "input_tokens",
+ "output_tokens",
+ "reasoning_output_tokens",
+ "total_tokens"
+ ],
+ "type": "object"
+ },
+ "TokenUsageInfo": {
+ "properties": {
+ "last_token_usage": {
+ "$ref": "#/definitions/TokenUsage"
+ },
+ "model_context_window": {
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "total_token_usage": {
+ "$ref": "#/definitions/TokenUsage"
+ }
+ },
+ "required": [
+ "last_token_usage",
+ "total_token_usage"
+ ],
+ "type": "object"
+ },
+ "Tool": {
+ "description": "Definition for a tool the client can call.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ToolAnnotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "description": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "inputSchema": {
+ "$ref": "#/definitions/ToolInputSchema"
+ },
+ "name": {
+ "type": "string"
+ },
+ "outputSchema": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ToolOutputSchema"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "title": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "inputSchema",
+ "name"
+ ],
+ "type": "object"
+ },
+ "ToolAnnotations": {
+ "description": "Additional properties describing a Tool to clients.\n\nNOTE: all properties in ToolAnnotations are **hints**. They are not guaranteed to provide a faithful description of tool behavior (including descriptive properties like `title`).\n\nClients should never make tool use decisions based on ToolAnnotations received from untrusted servers.",
+ "properties": {
+ "destructiveHint": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "idempotentHint": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "openWorldHint": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "readOnlyHint": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "title": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "ToolInputSchema": {
+ "description": "A JSON Schema object defining the expected parameters for the tool.",
+ "properties": {
+ "properties": true,
+ "required": {
+ "items": {
+ "type": "string"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "type": {
+ "default": "object",
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "ToolOutputSchema": {
+ "description": "An optional JSON Schema object defining the structure of the tool's output returned in the structuredContent field of a CallToolResult.",
+ "properties": {
+ "properties": true,
+ "required": {
+ "items": {
+ "type": "string"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "type": {
+ "default": "object",
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "TurnAbortReason": {
+ "enum": [
+ "interrupted",
+ "replaced",
+ "review_ended"
+ ],
+ "type": "string"
+ },
+ "TurnItem": {
+ "oneOf": [
+ {
+ "properties": {
+ "content": {
+ "items": {
+ "$ref": "#/definitions/UserInput"
+ },
+ "type": "array"
+ },
+ "id": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "UserMessage"
+ ],
+ "title": "UserMessageTurnItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "content",
+ "id",
+ "type"
+ ],
+ "title": "UserMessageTurnItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "content": {
+ "items": {
+ "$ref": "#/definitions/AgentMessageContent"
+ },
+ "type": "array"
+ },
+ "id": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "AgentMessage"
+ ],
+ "title": "AgentMessageTurnItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "content",
+ "id",
+ "type"
+ ],
+ "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": {
+ "type": "string"
+ },
+ "raw_content": {
+ "default": [],
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "summary_text": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "type": {
+ "enum": [
+ "Reasoning"
+ ],
+ "title": "ReasoningTurnItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "summary_text",
+ "type"
+ ],
+ "title": "ReasoningTurnItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "action": {
+ "$ref": "#/definitions/WebSearchAction"
+ },
+ "id": {
+ "type": "string"
+ },
+ "query": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "WebSearch"
+ ],
+ "title": "WebSearchTurnItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "action",
+ "id",
+ "query",
+ "type"
+ ],
+ "title": "WebSearchTurnItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "ContextCompaction"
+ ],
+ "title": "ContextCompactionTurnItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "type"
+ ],
+ "title": "ContextCompactionTurnItem",
+ "type": "object"
+ }
+ ]
+ },
+ "UserInput": {
+ "description": "User input",
+ "oneOf": [
+ {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "text_elements": {
+ "default": [],
+ "description": "UI-defined spans within `text` that should be treated as special elements. These are byte ranges into the UTF-8 `text` buffer and are used to render or persist rich input markers (e.g., image placeholders) across history and resume without mutating the literal text.",
+ "items": {
+ "$ref": "#/definitions/TextElement"
+ },
+ "type": "array"
+ },
+ "type": {
+ "enum": [
+ "text"
+ ],
+ "title": "TextUserInputType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "TextUserInput",
+ "type": "object"
+ },
+ {
+ "description": "Pre‑encoded data: URI image.",
+ "properties": {
+ "image_url": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "image"
+ ],
+ "title": "ImageUserInputType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "image_url",
+ "type"
+ ],
+ "title": "ImageUserInput",
+ "type": "object"
+ },
+ {
+ "description": "Local image path provided by the user. This will be converted to an `Image` variant (base64 data URL) during request serialization.",
+ "properties": {
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "local_image"
+ ],
+ "title": "LocalImageUserInputType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "path",
+ "type"
+ ],
+ "title": "LocalImageUserInput",
+ "type": "object"
+ },
+ {
+ "description": "Skill selected by the user (name + path to SKILL.md).",
+ "properties": {
+ "name": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "skill"
+ ],
+ "title": "SkillUserInputType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "path",
+ "type"
+ ],
+ "title": "SkillUserInput",
+ "type": "object"
+ },
+ {
+ "description": "Explicit mention selected by the user (name + app://connector id).",
+ "properties": {
+ "name": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "mention"
+ ],
+ "title": "MentionUserInputType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "path",
+ "type"
+ ],
+ "title": "MentionUserInput",
+ "type": "object"
+ }
+ ]
+ },
+ "WebSearchAction": {
+ "oneOf": [
+ {
+ "properties": {
+ "queries": {
+ "items": {
+ "type": "string"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "query": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "search"
+ ],
+ "title": "SearchWebSearchActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "SearchWebSearchAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "open_page"
+ ],
+ "title": "OpenPageWebSearchActionType",
+ "type": "string"
+ },
+ "url": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "OpenPageWebSearchAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "pattern": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "find_in_page"
+ ],
+ "title": "FindInPageWebSearchActionType",
+ "type": "string"
+ },
+ "url": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "FindInPageWebSearchAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "other"
+ ],
+ "title": "OtherWebSearchActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "OtherWebSearchAction",
+ "type": "object"
+ }
+ ]
+ }
+ },
+ "properties": {
+ "conversationId": {
+ "$ref": "#/definitions/ThreadId"
+ },
+ "initialMessages": {
+ "items": {
+ "$ref": "#/definitions/EventMsg"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "model": {
+ "type": "string"
+ },
+ "rolloutPath": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "conversationId",
+ "model",
+ "rolloutPath"
+ ],
+ "title": "ForkConversationResponse",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v1/GetAuthStatusParams.json b/codex-rs/app-server-protocol/schema/json/v1/GetAuthStatusParams.json
new file mode 100644
index 0000000000..0b21fd765d
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v1/GetAuthStatusParams.json
@@ -0,0 +1,19 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "includeToken": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "refreshToken": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ }
+ },
+ "title": "GetAuthStatusParams",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v1/GetAuthStatusResponse.json b/codex-rs/app-server-protocol/schema/json/v1/GetAuthStatusResponse.json
new file mode 100644
index 0000000000..7a605453d4
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v1/GetAuthStatusResponse.json
@@ -0,0 +1,57 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "definitions": {
+ "AuthMode": {
+ "description": "Authentication mode for OpenAI-backed providers.",
+ "oneOf": [
+ {
+ "description": "OpenAI API key provided by the caller and stored by Codex.",
+ "enum": [
+ "apikey"
+ ],
+ "type": "string"
+ },
+ {
+ "description": "ChatGPT OAuth managed by Codex (tokens persisted and refreshed by Codex).",
+ "enum": [
+ "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"
+ }
+ ]
+ }
+ },
+ "properties": {
+ "authMethod": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/AuthMode"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "authToken": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "requiresOpenaiAuth": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ }
+ },
+ "title": "GetAuthStatusResponse",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v1/GetConversationSummaryParams.json b/codex-rs/app-server-protocol/schema/json/v1/GetConversationSummaryParams.json
new file mode 100644
index 0000000000..aa6726cded
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v1/GetConversationSummaryParams.json
@@ -0,0 +1,35 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "anyOf": [
+ {
+ "properties": {
+ "rolloutPath": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "rolloutPath"
+ ],
+ "title": "RolloutPathv1::GetConversationSummaryParams",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "conversationId": {
+ "$ref": "#/definitions/ThreadId"
+ }
+ },
+ "required": [
+ "conversationId"
+ ],
+ "title": "ConversationIdv1::GetConversationSummaryParams",
+ "type": "object"
+ }
+ ],
+ "definitions": {
+ "ThreadId": {
+ "type": "string"
+ }
+ },
+ "title": "GetConversationSummaryParams"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v1/GetConversationSummaryResponse.json b/codex-rs/app-server-protocol/schema/json/v1/GetConversationSummaryResponse.json
new file mode 100644
index 0000000000..954ac28ed1
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v1/GetConversationSummaryResponse.json
@@ -0,0 +1,175 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "definitions": {
+ "ConversationGitInfo": {
+ "properties": {
+ "branch": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "origin_url": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "sha": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "ConversationSummary": {
+ "properties": {
+ "cliVersion": {
+ "type": "string"
+ },
+ "conversationId": {
+ "$ref": "#/definitions/ThreadId"
+ },
+ "cwd": {
+ "type": "string"
+ },
+ "gitInfo": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ConversationGitInfo"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "modelProvider": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "preview": {
+ "type": "string"
+ },
+ "source": {
+ "$ref": "#/definitions/SessionSource"
+ },
+ "timestamp": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "updatedAt": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "cliVersion",
+ "conversationId",
+ "cwd",
+ "modelProvider",
+ "path",
+ "preview",
+ "source"
+ ],
+ "type": "object"
+ },
+ "SessionSource": {
+ "oneOf": [
+ {
+ "enum": [
+ "cli",
+ "vscode",
+ "exec",
+ "mcp",
+ "unknown"
+ ],
+ "type": "string"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "subagent": {
+ "$ref": "#/definitions/SubAgentSource"
+ }
+ },
+ "required": [
+ "subagent"
+ ],
+ "title": "SubagentSessionSource",
+ "type": "object"
+ }
+ ]
+ },
+ "SubAgentSource": {
+ "oneOf": [
+ {
+ "enum": [
+ "review",
+ "compact"
+ ],
+ "type": "string"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "thread_spawn": {
+ "properties": {
+ "depth": {
+ "format": "int32",
+ "type": "integer"
+ },
+ "parent_thread_id": {
+ "$ref": "#/definitions/ThreadId"
+ }
+ },
+ "required": [
+ "depth",
+ "parent_thread_id"
+ ],
+ "type": "object"
+ }
+ },
+ "required": [
+ "thread_spawn"
+ ],
+ "title": "ThreadSpawnSubAgentSource",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "other": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "other"
+ ],
+ "title": "OtherSubAgentSource",
+ "type": "object"
+ }
+ ]
+ },
+ "ThreadId": {
+ "type": "string"
+ }
+ },
+ "properties": {
+ "summary": {
+ "$ref": "#/definitions/ConversationSummary"
+ }
+ },
+ "required": [
+ "summary"
+ ],
+ "title": "GetConversationSummaryResponse",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v1/GetUserAgentResponse.json b/codex-rs/app-server-protocol/schema/json/v1/GetUserAgentResponse.json
new file mode 100644
index 0000000000..c041282c8f
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v1/GetUserAgentResponse.json
@@ -0,0 +1,13 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "userAgent": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "userAgent"
+ ],
+ "title": "GetUserAgentResponse",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v1/GetUserSavedConfigResponse.json b/codex-rs/app-server-protocol/schema/json/v1/GetUserSavedConfigResponse.json
new file mode 100644
index 0000000000..b5e472b6ce
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v1/GetUserSavedConfigResponse.json
@@ -0,0 +1,330 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "definitions": {
+ "AbsolutePathBuf": {
+ "description": "A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem).\n\nIMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set, the deserialization will fail unless the path being deserialized is already absolute.",
+ "type": "string"
+ },
+ "AskForApproval": {
+ "description": "Determines the conditions under which the user is consulted to approve running the command proposed by Codex.",
+ "oneOf": [
+ {
+ "description": "Under this policy, only \"known safe\" commands—as determined by `is_safe_command()`—that **only read files** are auto‑approved. Everything else will ask the user to approve.",
+ "enum": [
+ "untrusted"
+ ],
+ "type": "string"
+ },
+ {
+ "description": "*All* commands are auto‑approved, but they are expected to run inside a sandbox where network access is disabled and writes are confined to a specific set of paths. If the command fails, it will be escalated to the user to approve execution without a sandbox.",
+ "enum": [
+ "on-failure"
+ ],
+ "type": "string"
+ },
+ {
+ "description": "The model decides when to ask the user for approval.",
+ "enum": [
+ "on-request"
+ ],
+ "type": "string"
+ },
+ {
+ "description": "Never ask the user to approve commands. Failures are immediately returned to the model, and never escalated to the user for approval.",
+ "enum": [
+ "never"
+ ],
+ "type": "string"
+ }
+ ]
+ },
+ "ForcedLoginMethod": {
+ "enum": [
+ "chatgpt",
+ "api"
+ ],
+ "type": "string"
+ },
+ "Profile": {
+ "properties": {
+ "approvalPolicy": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/AskForApproval"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "chatgptBaseUrl": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "model": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "modelProvider": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "modelReasoningEffort": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ReasoningEffort"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "modelReasoningSummary": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ReasoningSummary"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "modelVerbosity": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Verbosity"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "ReasoningEffort": {
+ "description": "See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#get-started-with-reasoning",
+ "enum": [
+ "none",
+ "minimal",
+ "low",
+ "medium",
+ "high",
+ "xhigh"
+ ],
+ "type": "string"
+ },
+ "ReasoningSummary": {
+ "description": "A summary of the reasoning performed by the model. This can be useful for debugging and understanding the model's reasoning process. See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#reasoning-summaries",
+ "oneOf": [
+ {
+ "enum": [
+ "auto",
+ "concise",
+ "detailed"
+ ],
+ "type": "string"
+ },
+ {
+ "description": "Option to disable reasoning summaries.",
+ "enum": [
+ "none"
+ ],
+ "type": "string"
+ }
+ ]
+ },
+ "SandboxMode": {
+ "enum": [
+ "read-only",
+ "workspace-write",
+ "danger-full-access"
+ ],
+ "type": "string"
+ },
+ "SandboxSettings": {
+ "properties": {
+ "excludeSlashTmp": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "excludeTmpdirEnvVar": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "networkAccess": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "writableRoots": {
+ "default": [],
+ "items": {
+ "$ref": "#/definitions/AbsolutePathBuf"
+ },
+ "type": "array"
+ }
+ },
+ "type": "object"
+ },
+ "Tools": {
+ "properties": {
+ "viewImage": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "webSearch": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "UserSavedConfig": {
+ "properties": {
+ "approvalPolicy": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/AskForApproval"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "forcedChatgptWorkspaceId": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "forcedLoginMethod": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ForcedLoginMethod"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "model": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "modelReasoningEffort": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ReasoningEffort"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "modelReasoningSummary": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ReasoningSummary"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "modelVerbosity": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Verbosity"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "profile": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "profiles": {
+ "additionalProperties": {
+ "$ref": "#/definitions/Profile"
+ },
+ "type": "object"
+ },
+ "sandboxMode": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/SandboxMode"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "sandboxSettings": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/SandboxSettings"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "tools": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Tools"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ }
+ },
+ "required": [
+ "profiles"
+ ],
+ "type": "object"
+ },
+ "Verbosity": {
+ "description": "Controls output length/detail on GPT-5 models via the Responses API. Serialized with lowercase values to match the OpenAI API.",
+ "enum": [
+ "low",
+ "medium",
+ "high"
+ ],
+ "type": "string"
+ }
+ },
+ "properties": {
+ "config": {
+ "$ref": "#/definitions/UserSavedConfig"
+ }
+ },
+ "required": [
+ "config"
+ ],
+ "title": "GetUserSavedConfigResponse",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v1/GitDiffToRemoteParams.json b/codex-rs/app-server-protocol/schema/json/v1/GitDiffToRemoteParams.json
new file mode 100644
index 0000000000..51640965ca
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v1/GitDiffToRemoteParams.json
@@ -0,0 +1,13 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "cwd": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "cwd"
+ ],
+ "title": "GitDiffToRemoteParams",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v1/GitDiffToRemoteResponse.json b/codex-rs/app-server-protocol/schema/json/v1/GitDiffToRemoteResponse.json
new file mode 100644
index 0000000000..fd59b80e94
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v1/GitDiffToRemoteResponse.json
@@ -0,0 +1,22 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "definitions": {
+ "GitSha": {
+ "type": "string"
+ }
+ },
+ "properties": {
+ "diff": {
+ "type": "string"
+ },
+ "sha": {
+ "$ref": "#/definitions/GitSha"
+ }
+ },
+ "required": [
+ "diff",
+ "sha"
+ ],
+ "title": "GitDiffToRemoteResponse",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v1/InitializeParams.json b/codex-rs/app-server-protocol/schema/json/v1/InitializeParams.json
new file mode 100644
index 0000000000..dd71c717f1
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v1/InitializeParams.json
@@ -0,0 +1,57 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "definitions": {
+ "ClientInfo": {
+ "properties": {
+ "name": {
+ "type": "string"
+ },
+ "title": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "version": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "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"
+ }
+ },
+ "required": [
+ "clientInfo"
+ ],
+ "title": "InitializeParams",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v1/InitializeResponse.json b/codex-rs/app-server-protocol/schema/json/v1/InitializeResponse.json
new file mode 100644
index 0000000000..6ace3177ba
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v1/InitializeResponse.json
@@ -0,0 +1,13 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "userAgent": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "userAgent"
+ ],
+ "title": "InitializeResponse",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v1/InterruptConversationParams.json b/codex-rs/app-server-protocol/schema/json/v1/InterruptConversationParams.json
new file mode 100644
index 0000000000..4fdd221fca
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v1/InterruptConversationParams.json
@@ -0,0 +1,18 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "definitions": {
+ "ThreadId": {
+ "type": "string"
+ }
+ },
+ "properties": {
+ "conversationId": {
+ "$ref": "#/definitions/ThreadId"
+ }
+ },
+ "required": [
+ "conversationId"
+ ],
+ "title": "InterruptConversationParams",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v1/InterruptConversationResponse.json b/codex-rs/app-server-protocol/schema/json/v1/InterruptConversationResponse.json
new file mode 100644
index 0000000000..5d2ddf3e40
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v1/InterruptConversationResponse.json
@@ -0,0 +1,23 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "definitions": {
+ "TurnAbortReason": {
+ "enum": [
+ "interrupted",
+ "replaced",
+ "review_ended"
+ ],
+ "type": "string"
+ }
+ },
+ "properties": {
+ "abortReason": {
+ "$ref": "#/definitions/TurnAbortReason"
+ }
+ },
+ "required": [
+ "abortReason"
+ ],
+ "title": "InterruptConversationResponse",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v1/ListConversationsParams.json b/codex-rs/app-server-protocol/schema/json/v1/ListConversationsParams.json
new file mode 100644
index 0000000000..9ac05602c4
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v1/ListConversationsParams.json
@@ -0,0 +1,30 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "cursor": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "modelProviders": {
+ "items": {
+ "type": "string"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "pageSize": {
+ "format": "uint",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "title": "ListConversationsParams",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v1/ListConversationsResponse.json b/codex-rs/app-server-protocol/schema/json/v1/ListConversationsResponse.json
new file mode 100644
index 0000000000..b7e3b8f8f1
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v1/ListConversationsResponse.json
@@ -0,0 +1,184 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "definitions": {
+ "ConversationGitInfo": {
+ "properties": {
+ "branch": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "origin_url": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "sha": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "ConversationSummary": {
+ "properties": {
+ "cliVersion": {
+ "type": "string"
+ },
+ "conversationId": {
+ "$ref": "#/definitions/ThreadId"
+ },
+ "cwd": {
+ "type": "string"
+ },
+ "gitInfo": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ConversationGitInfo"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "modelProvider": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "preview": {
+ "type": "string"
+ },
+ "source": {
+ "$ref": "#/definitions/SessionSource"
+ },
+ "timestamp": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "updatedAt": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "cliVersion",
+ "conversationId",
+ "cwd",
+ "modelProvider",
+ "path",
+ "preview",
+ "source"
+ ],
+ "type": "object"
+ },
+ "SessionSource": {
+ "oneOf": [
+ {
+ "enum": [
+ "cli",
+ "vscode",
+ "exec",
+ "mcp",
+ "unknown"
+ ],
+ "type": "string"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "subagent": {
+ "$ref": "#/definitions/SubAgentSource"
+ }
+ },
+ "required": [
+ "subagent"
+ ],
+ "title": "SubagentSessionSource",
+ "type": "object"
+ }
+ ]
+ },
+ "SubAgentSource": {
+ "oneOf": [
+ {
+ "enum": [
+ "review",
+ "compact"
+ ],
+ "type": "string"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "thread_spawn": {
+ "properties": {
+ "depth": {
+ "format": "int32",
+ "type": "integer"
+ },
+ "parent_thread_id": {
+ "$ref": "#/definitions/ThreadId"
+ }
+ },
+ "required": [
+ "depth",
+ "parent_thread_id"
+ ],
+ "type": "object"
+ }
+ },
+ "required": [
+ "thread_spawn"
+ ],
+ "title": "ThreadSpawnSubAgentSource",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "other": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "other"
+ ],
+ "title": "OtherSubAgentSource",
+ "type": "object"
+ }
+ ]
+ },
+ "ThreadId": {
+ "type": "string"
+ }
+ },
+ "properties": {
+ "items": {
+ "items": {
+ "$ref": "#/definitions/ConversationSummary"
+ },
+ "type": "array"
+ },
+ "nextCursor": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "items"
+ ],
+ "title": "ListConversationsResponse",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v1/LoginApiKeyParams.json b/codex-rs/app-server-protocol/schema/json/v1/LoginApiKeyParams.json
new file mode 100644
index 0000000000..b23ce5548f
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v1/LoginApiKeyParams.json
@@ -0,0 +1,13 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "apiKey": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "apiKey"
+ ],
+ "title": "LoginApiKeyParams",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v1/LoginApiKeyResponse.json b/codex-rs/app-server-protocol/schema/json/v1/LoginApiKeyResponse.json
new file mode 100644
index 0000000000..cba1fe3c40
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v1/LoginApiKeyResponse.json
@@ -0,0 +1,5 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "title": "LoginApiKeyResponse",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v1/LoginChatGptCompleteNotification.json b/codex-rs/app-server-protocol/schema/json/v1/LoginChatGptCompleteNotification.json
new file mode 100644
index 0000000000..ae34de2f42
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v1/LoginChatGptCompleteNotification.json
@@ -0,0 +1,24 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "description": "Deprecated in favor of AccountLoginCompletedNotification.",
+ "properties": {
+ "error": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "loginId": {
+ "type": "string"
+ },
+ "success": {
+ "type": "boolean"
+ }
+ },
+ "required": [
+ "loginId",
+ "success"
+ ],
+ "title": "LoginChatGptCompleteNotification",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v1/LoginChatGptResponse.json b/codex-rs/app-server-protocol/schema/json/v1/LoginChatGptResponse.json
new file mode 100644
index 0000000000..9ecf3cdbb9
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v1/LoginChatGptResponse.json
@@ -0,0 +1,17 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "authUrl": {
+ "type": "string"
+ },
+ "loginId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "authUrl",
+ "loginId"
+ ],
+ "title": "LoginChatGptResponse",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v1/LogoutChatGptResponse.json b/codex-rs/app-server-protocol/schema/json/v1/LogoutChatGptResponse.json
new file mode 100644
index 0000000000..449cfc5fab
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v1/LogoutChatGptResponse.json
@@ -0,0 +1,5 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "title": "LogoutChatGptResponse",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v1/NewConversationParams.json b/codex-rs/app-server-protocol/schema/json/v1/NewConversationParams.json
new file mode 100644
index 0000000000..167aee56e9
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v1/NewConversationParams.json
@@ -0,0 +1,125 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "definitions": {
+ "AskForApproval": {
+ "description": "Determines the conditions under which the user is consulted to approve running the command proposed by Codex.",
+ "oneOf": [
+ {
+ "description": "Under this policy, only \"known safe\" commands—as determined by `is_safe_command()`—that **only read files** are auto‑approved. Everything else will ask the user to approve.",
+ "enum": [
+ "untrusted"
+ ],
+ "type": "string"
+ },
+ {
+ "description": "*All* commands are auto‑approved, but they are expected to run inside a sandbox where network access is disabled and writes are confined to a specific set of paths. If the command fails, it will be escalated to the user to approve execution without a sandbox.",
+ "enum": [
+ "on-failure"
+ ],
+ "type": "string"
+ },
+ {
+ "description": "The model decides when to ask the user for approval.",
+ "enum": [
+ "on-request"
+ ],
+ "type": "string"
+ },
+ {
+ "description": "Never ask the user to approve commands. Failures are immediately returned to the model, and never escalated to the user for approval.",
+ "enum": [
+ "never"
+ ],
+ "type": "string"
+ }
+ ]
+ },
+ "SandboxMode": {
+ "enum": [
+ "read-only",
+ "workspace-write",
+ "danger-full-access"
+ ],
+ "type": "string"
+ }
+ },
+ "properties": {
+ "approvalPolicy": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/AskForApproval"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "baseInstructions": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "compactPrompt": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "config": {
+ "additionalProperties": true,
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "cwd": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "developerInstructions": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "includeApplyPatchTool": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "model": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "modelProvider": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "profile": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "sandbox": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/SandboxMode"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ }
+ },
+ "title": "NewConversationParams",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v1/NewConversationResponse.json b/codex-rs/app-server-protocol/schema/json/v1/NewConversationResponse.json
new file mode 100644
index 0000000000..8030d8113f
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v1/NewConversationResponse.json
@@ -0,0 +1,48 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "definitions": {
+ "ReasoningEffort": {
+ "description": "See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#get-started-with-reasoning",
+ "enum": [
+ "none",
+ "minimal",
+ "low",
+ "medium",
+ "high",
+ "xhigh"
+ ],
+ "type": "string"
+ },
+ "ThreadId": {
+ "type": "string"
+ }
+ },
+ "properties": {
+ "conversationId": {
+ "$ref": "#/definitions/ThreadId"
+ },
+ "model": {
+ "type": "string"
+ },
+ "reasoningEffort": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ReasoningEffort"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "rolloutPath": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "conversationId",
+ "model",
+ "rolloutPath"
+ ],
+ "title": "NewConversationResponse",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v1/RemoveConversationListenerParams.json b/codex-rs/app-server-protocol/schema/json/v1/RemoveConversationListenerParams.json
new file mode 100644
index 0000000000..990b8ff0c4
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v1/RemoveConversationListenerParams.json
@@ -0,0 +1,13 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "subscriptionId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "subscriptionId"
+ ],
+ "title": "RemoveConversationListenerParams",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v1/RemoveConversationSubscriptionResponse.json b/codex-rs/app-server-protocol/schema/json/v1/RemoveConversationSubscriptionResponse.json
new file mode 100644
index 0000000000..8efe40d430
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v1/RemoveConversationSubscriptionResponse.json
@@ -0,0 +1,5 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "title": "RemoveConversationSubscriptionResponse",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v1/ResumeConversationParams.json b/codex-rs/app-server-protocol/schema/json/v1/ResumeConversationParams.json
new file mode 100644
index 0000000000..e1cc626cc8
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v1/ResumeConversationParams.json
@@ -0,0 +1,915 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "definitions": {
+ "AskForApproval": {
+ "description": "Determines the conditions under which the user is consulted to approve running the command proposed by Codex.",
+ "oneOf": [
+ {
+ "description": "Under this policy, only \"known safe\" commands—as determined by `is_safe_command()`—that **only read files** are auto‑approved. Everything else will ask the user to approve.",
+ "enum": [
+ "untrusted"
+ ],
+ "type": "string"
+ },
+ {
+ "description": "*All* commands are auto‑approved, but they are expected to run inside a sandbox where network access is disabled and writes are confined to a specific set of paths. If the command fails, it will be escalated to the user to approve execution without a sandbox.",
+ "enum": [
+ "on-failure"
+ ],
+ "type": "string"
+ },
+ {
+ "description": "The model decides when to ask the user for approval.",
+ "enum": [
+ "on-request"
+ ],
+ "type": "string"
+ },
+ {
+ "description": "Never ask the user to approve commands. Failures are immediately returned to the model, and never escalated to the user for approval.",
+ "enum": [
+ "never"
+ ],
+ "type": "string"
+ }
+ ]
+ },
+ "ContentItem": {
+ "oneOf": [
+ {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "input_text"
+ ],
+ "title": "InputTextContentItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "InputTextContentItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "image_url": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "input_image"
+ ],
+ "title": "InputImageContentItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "image_url",
+ "type"
+ ],
+ "title": "InputImageContentItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "output_text"
+ ],
+ "title": "OutputTextContentItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "OutputTextContentItem",
+ "type": "object"
+ }
+ ]
+ },
+ "FunctionCallOutputContentItem": {
+ "description": "Responses API compatible content items that can be returned by a tool call. This is a subset of ContentItem with the types we support as function call outputs.",
+ "oneOf": [
+ {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "input_text"
+ ],
+ "title": "InputTextFunctionCallOutputContentItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "InputTextFunctionCallOutputContentItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "image_url": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "input_image"
+ ],
+ "title": "InputImageFunctionCallOutputContentItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "image_url",
+ "type"
+ ],
+ "title": "InputImageFunctionCallOutputContentItem",
+ "type": "object"
+ }
+ ]
+ },
+ "FunctionCallOutputPayload": {
+ "description": "The payload we send back to OpenAI when reporting a tool call result.\n\n`content` preserves the historical plain-string payload so downstream integrations (tests, logging, etc.) can keep treating tool output as `String`. When an MCP server returns richer data we additionally populate `content_items` with the structured form that the Responses/Chat Completions APIs understand.",
+ "properties": {
+ "content": {
+ "type": "string"
+ },
+ "content_items": {
+ "items": {
+ "$ref": "#/definitions/FunctionCallOutputContentItem"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "success": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "content"
+ ],
+ "type": "object"
+ },
+ "GhostCommit": {
+ "description": "Details of a ghost commit created from a repository state.",
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "parent": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "preexisting_untracked_dirs": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "preexisting_untracked_files": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ }
+ },
+ "required": [
+ "id",
+ "preexisting_untracked_dirs",
+ "preexisting_untracked_files"
+ ],
+ "type": "object"
+ },
+ "LocalShellAction": {
+ "oneOf": [
+ {
+ "properties": {
+ "command": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "env": {
+ "additionalProperties": {
+ "type": "string"
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "timeout_ms": {
+ "format": "uint64",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "exec"
+ ],
+ "title": "ExecLocalShellActionType",
+ "type": "string"
+ },
+ "user": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "working_directory": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "command",
+ "type"
+ ],
+ "title": "ExecLocalShellAction",
+ "type": "object"
+ }
+ ]
+ },
+ "LocalShellStatus": {
+ "enum": [
+ "completed",
+ "in_progress",
+ "incomplete"
+ ],
+ "type": "string"
+ },
+ "NewConversationParams": {
+ "properties": {
+ "approvalPolicy": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/AskForApproval"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "baseInstructions": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "compactPrompt": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "config": {
+ "additionalProperties": true,
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "cwd": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "developerInstructions": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "includeApplyPatchTool": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "model": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "modelProvider": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "profile": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "sandbox": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/SandboxMode"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "ReasoningItemContent": {
+ "oneOf": [
+ {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "reasoning_text"
+ ],
+ "title": "ReasoningTextReasoningItemContentType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "ReasoningTextReasoningItemContent",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "text"
+ ],
+ "title": "TextReasoningItemContentType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "TextReasoningItemContent",
+ "type": "object"
+ }
+ ]
+ },
+ "ReasoningItemReasoningSummary": {
+ "oneOf": [
+ {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "summary_text"
+ ],
+ "title": "SummaryTextReasoningItemReasoningSummaryType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "SummaryTextReasoningItemReasoningSummary",
+ "type": "object"
+ }
+ ]
+ },
+ "ResponseItem": {
+ "oneOf": [
+ {
+ "properties": {
+ "content": {
+ "items": {
+ "$ref": "#/definitions/ContentItem"
+ },
+ "type": "array"
+ },
+ "end_turn": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "id": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "writeOnly": true
+ },
+ "role": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "message"
+ ],
+ "title": "MessageResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "content",
+ "role",
+ "type"
+ ],
+ "title": "MessageResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "content": {
+ "default": null,
+ "items": {
+ "$ref": "#/definitions/ReasoningItemContent"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "encrypted_content": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "id": {
+ "type": "string",
+ "writeOnly": true
+ },
+ "summary": {
+ "items": {
+ "$ref": "#/definitions/ReasoningItemReasoningSummary"
+ },
+ "type": "array"
+ },
+ "type": {
+ "enum": [
+ "reasoning"
+ ],
+ "title": "ReasoningResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "summary",
+ "type"
+ ],
+ "title": "ReasoningResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "action": {
+ "$ref": "#/definitions/LocalShellAction"
+ },
+ "call_id": {
+ "description": "Set when using the Responses API.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "id": {
+ "description": "Set when using the chat completions API.",
+ "type": [
+ "string",
+ "null"
+ ],
+ "writeOnly": true
+ },
+ "status": {
+ "$ref": "#/definitions/LocalShellStatus"
+ },
+ "type": {
+ "enum": [
+ "local_shell_call"
+ ],
+ "title": "LocalShellCallResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "action",
+ "status",
+ "type"
+ ],
+ "title": "LocalShellCallResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "arguments": {
+ "type": "string"
+ },
+ "call_id": {
+ "type": "string"
+ },
+ "id": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "writeOnly": true
+ },
+ "name": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "function_call"
+ ],
+ "title": "FunctionCallResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "arguments",
+ "call_id",
+ "name",
+ "type"
+ ],
+ "title": "FunctionCallResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "call_id": {
+ "type": "string"
+ },
+ "output": {
+ "$ref": "#/definitions/FunctionCallOutputPayload"
+ },
+ "type": {
+ "enum": [
+ "function_call_output"
+ ],
+ "title": "FunctionCallOutputResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "output",
+ "type"
+ ],
+ "title": "FunctionCallOutputResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "call_id": {
+ "type": "string"
+ },
+ "id": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "writeOnly": true
+ },
+ "input": {
+ "type": "string"
+ },
+ "name": {
+ "type": "string"
+ },
+ "status": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "custom_tool_call"
+ ],
+ "title": "CustomToolCallResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "input",
+ "name",
+ "type"
+ ],
+ "title": "CustomToolCallResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "call_id": {
+ "type": "string"
+ },
+ "output": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "custom_tool_call_output"
+ ],
+ "title": "CustomToolCallOutputResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "output",
+ "type"
+ ],
+ "title": "CustomToolCallOutputResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "action": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/WebSearchAction"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "id": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "writeOnly": true
+ },
+ "status": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "web_search_call"
+ ],
+ "title": "WebSearchCallResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "WebSearchCallResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "ghost_commit": {
+ "$ref": "#/definitions/GhostCommit"
+ },
+ "type": {
+ "enum": [
+ "ghost_snapshot"
+ ],
+ "title": "GhostSnapshotResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "ghost_commit",
+ "type"
+ ],
+ "title": "GhostSnapshotResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "encrypted_content": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "compaction"
+ ],
+ "title": "CompactionResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "encrypted_content",
+ "type"
+ ],
+ "title": "CompactionResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "other"
+ ],
+ "title": "OtherResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "OtherResponseItem",
+ "type": "object"
+ }
+ ]
+ },
+ "SandboxMode": {
+ "enum": [
+ "read-only",
+ "workspace-write",
+ "danger-full-access"
+ ],
+ "type": "string"
+ },
+ "ThreadId": {
+ "type": "string"
+ },
+ "WebSearchAction": {
+ "oneOf": [
+ {
+ "properties": {
+ "queries": {
+ "items": {
+ "type": "string"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "query": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "search"
+ ],
+ "title": "SearchWebSearchActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "SearchWebSearchAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "open_page"
+ ],
+ "title": "OpenPageWebSearchActionType",
+ "type": "string"
+ },
+ "url": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "OpenPageWebSearchAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "pattern": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "find_in_page"
+ ],
+ "title": "FindInPageWebSearchActionType",
+ "type": "string"
+ },
+ "url": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "FindInPageWebSearchAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "other"
+ ],
+ "title": "OtherWebSearchActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "OtherWebSearchAction",
+ "type": "object"
+ }
+ ]
+ }
+ },
+ "properties": {
+ "conversationId": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ThreadId"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "history": {
+ "items": {
+ "$ref": "#/definitions/ResponseItem"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "overrides": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/NewConversationParams"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "path": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "title": "ResumeConversationParams",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v1/ResumeConversationResponse.json b/codex-rs/app-server-protocol/schema/json/v1/ResumeConversationResponse.json
new file mode 100644
index 0000000000..fcb39cd05c
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v1/ResumeConversationResponse.json
@@ -0,0 +1,5358 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "definitions": {
+ "AbsolutePathBuf": {
+ "description": "A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem).\n\nIMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set, the deserialization will fail unless the path being deserialized is already absolute.",
+ "type": "string"
+ },
+ "AgentMessageContent": {
+ "oneOf": [
+ {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "Text"
+ ],
+ "title": "TextAgentMessageContentType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "TextAgentMessageContent",
+ "type": "object"
+ }
+ ]
+ },
+ "AgentStatus": {
+ "description": "Agent lifecycle status, derived from emitted events.",
+ "oneOf": [
+ {
+ "description": "Agent is waiting for initialization.",
+ "enum": [
+ "pending_init"
+ ],
+ "type": "string"
+ },
+ {
+ "description": "Agent is currently running.",
+ "enum": [
+ "running"
+ ],
+ "type": "string"
+ },
+ {
+ "additionalProperties": false,
+ "description": "Agent is done. Contains the final assistant message.",
+ "properties": {
+ "completed": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "completed"
+ ],
+ "title": "CompletedAgentStatus",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "Agent encountered an error.",
+ "properties": {
+ "errored": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "errored"
+ ],
+ "title": "ErroredAgentStatus",
+ "type": "object"
+ },
+ {
+ "description": "Agent has been shutdown.",
+ "enum": [
+ "shutdown"
+ ],
+ "type": "string"
+ },
+ {
+ "description": "Agent is not found.",
+ "enum": [
+ "not_found"
+ ],
+ "type": "string"
+ }
+ ]
+ },
+ "Annotations": {
+ "description": "Optional annotations for the client. The client can use annotations to inform how objects are used or displayed",
+ "properties": {
+ "audience": {
+ "items": {
+ "$ref": "#/definitions/Role"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "lastModified": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "priority": {
+ "format": "double",
+ "type": [
+ "number",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "AskForApproval": {
+ "description": "Determines the conditions under which the user is consulted to approve running the command proposed by Codex.",
+ "oneOf": [
+ {
+ "description": "Under this policy, only \"known safe\" commands—as determined by `is_safe_command()`—that **only read files** are auto‑approved. Everything else will ask the user to approve.",
+ "enum": [
+ "untrusted"
+ ],
+ "type": "string"
+ },
+ {
+ "description": "*All* commands are auto‑approved, but they are expected to run inside a sandbox where network access is disabled and writes are confined to a specific set of paths. If the command fails, it will be escalated to the user to approve execution without a sandbox.",
+ "enum": [
+ "on-failure"
+ ],
+ "type": "string"
+ },
+ {
+ "description": "The model decides when to ask the user for approval.",
+ "enum": [
+ "on-request"
+ ],
+ "type": "string"
+ },
+ {
+ "description": "Never ask the user to approve commands. Failures are immediately returned to the model, and never escalated to the user for approval.",
+ "enum": [
+ "never"
+ ],
+ "type": "string"
+ }
+ ]
+ },
+ "AudioContent": {
+ "description": "Audio provided to or from an LLM.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "data": {
+ "type": "string"
+ },
+ "mimeType": {
+ "type": "string"
+ },
+ "type": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "data",
+ "mimeType",
+ "type"
+ ],
+ "type": "object"
+ },
+ "BlobResourceContents": {
+ "properties": {
+ "blob": {
+ "type": "string"
+ },
+ "mimeType": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "uri": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "blob",
+ "uri"
+ ],
+ "type": "object"
+ },
+ "ByteRange": {
+ "properties": {
+ "end": {
+ "description": "End byte offset (exclusive) within the UTF-8 text buffer.",
+ "format": "uint",
+ "minimum": 0.0,
+ "type": "integer"
+ },
+ "start": {
+ "description": "Start byte offset (inclusive) within the UTF-8 text buffer.",
+ "format": "uint",
+ "minimum": 0.0,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "end",
+ "start"
+ ],
+ "type": "object"
+ },
+ "CallToolResult": {
+ "description": "The server's response to a tool call.",
+ "properties": {
+ "content": {
+ "items": {
+ "$ref": "#/definitions/ContentBlock"
+ },
+ "type": "array"
+ },
+ "isError": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "structuredContent": true
+ },
+ "required": [
+ "content"
+ ],
+ "type": "object"
+ },
+ "CodexErrorInfo": {
+ "description": "Codex errors that we expose to clients.",
+ "oneOf": [
+ {
+ "enum": [
+ "context_window_exceeded",
+ "usage_limit_exceeded",
+ "internal_server_error",
+ "unauthorized",
+ "bad_request",
+ "sandbox_error",
+ "thread_rollback_failed",
+ "other"
+ ],
+ "type": "string"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "model_cap": {
+ "properties": {
+ "model": {
+ "type": "string"
+ },
+ "reset_after_seconds": {
+ "format": "uint64",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "model"
+ ],
+ "type": "object"
+ }
+ },
+ "required": [
+ "model_cap"
+ ],
+ "title": "ModelCapCodexErrorInfo",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "http_connection_failed": {
+ "properties": {
+ "http_status_code": {
+ "format": "uint16",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "http_connection_failed"
+ ],
+ "title": "HttpConnectionFailedCodexErrorInfo",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "Failed to connect to the response SSE stream.",
+ "properties": {
+ "response_stream_connection_failed": {
+ "properties": {
+ "http_status_code": {
+ "format": "uint16",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "response_stream_connection_failed"
+ ],
+ "title": "ResponseStreamConnectionFailedCodexErrorInfo",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "The response SSE stream disconnected in the middle of a turnbefore completion.",
+ "properties": {
+ "response_stream_disconnected": {
+ "properties": {
+ "http_status_code": {
+ "format": "uint16",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "response_stream_disconnected"
+ ],
+ "title": "ResponseStreamDisconnectedCodexErrorInfo",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "Reached the retry limit for responses.",
+ "properties": {
+ "response_too_many_failed_attempts": {
+ "properties": {
+ "http_status_code": {
+ "format": "uint16",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "response_too_many_failed_attempts"
+ ],
+ "title": "ResponseTooManyFailedAttemptsCodexErrorInfo",
+ "type": "object"
+ }
+ ]
+ },
+ "ContentBlock": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/TextContent"
+ },
+ {
+ "$ref": "#/definitions/ImageContent"
+ },
+ {
+ "$ref": "#/definitions/AudioContent"
+ },
+ {
+ "$ref": "#/definitions/ResourceLink"
+ },
+ {
+ "$ref": "#/definitions/EmbeddedResource"
+ }
+ ]
+ },
+ "ContentItem": {
+ "oneOf": [
+ {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "input_text"
+ ],
+ "title": "InputTextContentItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "InputTextContentItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "image_url": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "input_image"
+ ],
+ "title": "InputImageContentItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "image_url",
+ "type"
+ ],
+ "title": "InputImageContentItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "output_text"
+ ],
+ "title": "OutputTextContentItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "OutputTextContentItem",
+ "type": "object"
+ }
+ ]
+ },
+ "CreditsSnapshot": {
+ "properties": {
+ "balance": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "has_credits": {
+ "type": "boolean"
+ },
+ "unlimited": {
+ "type": "boolean"
+ }
+ },
+ "required": [
+ "has_credits",
+ "unlimited"
+ ],
+ "type": "object"
+ },
+ "CustomPrompt": {
+ "properties": {
+ "argument_hint": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "content": {
+ "type": "string"
+ },
+ "description": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "name": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "content",
+ "name",
+ "path"
+ ],
+ "type": "object"
+ },
+ "Duration": {
+ "properties": {
+ "nanos": {
+ "format": "uint32",
+ "minimum": 0.0,
+ "type": "integer"
+ },
+ "secs": {
+ "format": "uint64",
+ "minimum": 0.0,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "nanos",
+ "secs"
+ ],
+ "type": "object"
+ },
+ "EmbeddedResource": {
+ "description": "The contents of a resource, embedded into a prompt or tool call result.\n\nIt is up to the client how best to render embedded resources for the benefit of the LLM and/or the user.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "resource": {
+ "$ref": "#/definitions/EmbeddedResourceResource"
+ },
+ "type": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "resource",
+ "type"
+ ],
+ "type": "object"
+ },
+ "EmbeddedResourceResource": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/TextResourceContents"
+ },
+ {
+ "$ref": "#/definitions/BlobResourceContents"
+ }
+ ]
+ },
+ "EventMsg": {
+ "description": "Response event from the agent NOTE: Make sure none of these values have optional types, as it will mess up the extension code-gen.",
+ "oneOf": [
+ {
+ "description": "Error while executing a submission",
+ "properties": {
+ "codex_error_info": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/CodexErrorInfo"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "default": null
+ },
+ "message": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "error"
+ ],
+ "title": "ErrorEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "message",
+ "type"
+ ],
+ "title": "ErrorEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Warning issued while processing a submission. Unlike `Error`, this indicates the turn continued but the user should still be notified.",
+ "properties": {
+ "message": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "warning"
+ ],
+ "title": "WarningEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "message",
+ "type"
+ ],
+ "title": "WarningEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Conversation history was compacted (either automatically or manually).",
+ "properties": {
+ "type": {
+ "enum": [
+ "context_compacted"
+ ],
+ "title": "ContextCompactedEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "ContextCompactedEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Conversation history was rolled back by dropping the last N user turns.",
+ "properties": {
+ "num_turns": {
+ "description": "Number of user turns that were removed from context.",
+ "format": "uint32",
+ "minimum": 0.0,
+ "type": "integer"
+ },
+ "type": {
+ "enum": [
+ "thread_rolled_back"
+ ],
+ "title": "ThreadRolledBackEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "num_turns",
+ "type"
+ ],
+ "title": "ThreadRolledBackEventMsg",
+ "type": "object"
+ },
+ {
+ "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": "code"
+ },
+ "model_context_window": {
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "task_started"
+ ],
+ "title": "TaskStartedEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "TaskStartedEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Agent has completed all actions. v1 wire format uses `task_complete`; accept `turn_complete` for v2 interop.",
+ "properties": {
+ "last_agent_message": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "task_complete"
+ ],
+ "title": "TaskCompleteEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "TaskCompleteEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Usage update for the current session, including totals and last turn. Optional means unknown — UIs should not display when `None`.",
+ "properties": {
+ "info": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/TokenUsageInfo"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "rate_limits": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/RateLimitSnapshot"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "type": {
+ "enum": [
+ "token_count"
+ ],
+ "title": "TokenCountEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "TokenCountEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Agent text output message",
+ "properties": {
+ "message": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "agent_message"
+ ],
+ "title": "AgentMessageEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "message",
+ "type"
+ ],
+ "title": "AgentMessageEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "User/system input message (what was sent to the model)",
+ "properties": {
+ "images": {
+ "description": "Image URLs sourced from `UserInput::Image`. These are safe to replay in legacy UI history events and correspond to images sent to the model.",
+ "items": {
+ "type": "string"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "local_images": {
+ "default": [],
+ "description": "Local file paths sourced from `UserInput::LocalImage`. These are kept so the UI can reattach images when editing history, and should not be sent to the model or treated as API-ready URLs.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "message": {
+ "type": "string"
+ },
+ "text_elements": {
+ "default": [],
+ "description": "UI-defined spans within `message` used to render or persist special elements.",
+ "items": {
+ "$ref": "#/definitions/TextElement"
+ },
+ "type": "array"
+ },
+ "type": {
+ "enum": [
+ "user_message"
+ ],
+ "title": "UserMessageEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "message",
+ "type"
+ ],
+ "title": "UserMessageEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Agent text output delta message",
+ "properties": {
+ "delta": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "agent_message_delta"
+ ],
+ "title": "AgentMessageDeltaEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "delta",
+ "type"
+ ],
+ "title": "AgentMessageDeltaEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Reasoning event from agent.",
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "agent_reasoning"
+ ],
+ "title": "AgentReasoningEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "AgentReasoningEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Agent reasoning delta event from agent.",
+ "properties": {
+ "delta": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "agent_reasoning_delta"
+ ],
+ "title": "AgentReasoningDeltaEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "delta",
+ "type"
+ ],
+ "title": "AgentReasoningDeltaEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Raw chain-of-thought from agent.",
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "agent_reasoning_raw_content"
+ ],
+ "title": "AgentReasoningRawContentEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "AgentReasoningRawContentEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Agent reasoning content delta event from agent.",
+ "properties": {
+ "delta": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "agent_reasoning_raw_content_delta"
+ ],
+ "title": "AgentReasoningRawContentDeltaEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "delta",
+ "type"
+ ],
+ "title": "AgentReasoningRawContentDeltaEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Signaled when the model begins a new reasoning summary section (e.g., a new titled block).",
+ "properties": {
+ "item_id": {
+ "default": "",
+ "type": "string"
+ },
+ "summary_index": {
+ "default": 0,
+ "format": "int64",
+ "type": "integer"
+ },
+ "type": {
+ "enum": [
+ "agent_reasoning_section_break"
+ ],
+ "title": "AgentReasoningSectionBreakEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "AgentReasoningSectionBreakEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Ack the client's configure message.",
+ "properties": {
+ "approval_policy": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/AskForApproval"
+ }
+ ],
+ "description": "When to escalate for approval for execution"
+ },
+ "cwd": {
+ "description": "Working directory that should be treated as the *root* of the session.",
+ "type": "string"
+ },
+ "forked_from_id": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ThreadId"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "history_entry_count": {
+ "description": "Current number of entries in the history log.",
+ "format": "uint",
+ "minimum": 0.0,
+ "type": "integer"
+ },
+ "history_log_id": {
+ "description": "Identifier of the history log file (inode on Unix, 0 otherwise).",
+ "format": "uint64",
+ "minimum": 0.0,
+ "type": "integer"
+ },
+ "initial_messages": {
+ "description": "Optional initial messages (as events) for resumed sessions. When present, UIs can use these to seed the history.",
+ "items": {
+ "$ref": "#/definitions/EventMsg"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "model": {
+ "description": "Tell the client what model is being queried.",
+ "type": "string"
+ },
+ "model_provider_id": {
+ "type": "string"
+ },
+ "reasoning_effort": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ReasoningEffort"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "The effort the model is putting into reasoning about the user's request."
+ },
+ "rollout_path": {
+ "description": "Path in which the rollout is stored. Can be `None` for ephemeral threads",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "sandbox_policy": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/SandboxPolicy"
+ }
+ ],
+ "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"
+ ]
+ },
+ "type": {
+ "enum": [
+ "session_configured"
+ ],
+ "title": "SessionConfiguredEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "approval_policy",
+ "cwd",
+ "history_entry_count",
+ "history_log_id",
+ "model",
+ "model_provider_id",
+ "sandbox_policy",
+ "session_id",
+ "type"
+ ],
+ "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": {
+ "server": {
+ "description": "Server name being started.",
+ "type": "string"
+ },
+ "status": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/McpStartupStatus"
+ }
+ ],
+ "description": "Current startup status."
+ },
+ "type": {
+ "enum": [
+ "mcp_startup_update"
+ ],
+ "title": "McpStartupUpdateEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "server",
+ "status",
+ "type"
+ ],
+ "title": "McpStartupUpdateEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Aggregate MCP startup completion summary.",
+ "properties": {
+ "cancelled": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "failed": {
+ "items": {
+ "$ref": "#/definitions/McpStartupFailure"
+ },
+ "type": "array"
+ },
+ "ready": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "type": {
+ "enum": [
+ "mcp_startup_complete"
+ ],
+ "title": "McpStartupCompleteEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "cancelled",
+ "failed",
+ "ready",
+ "type"
+ ],
+ "title": "McpStartupCompleteEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "call_id": {
+ "description": "Identifier so this can be paired with the McpToolCallEnd event.",
+ "type": "string"
+ },
+ "invocation": {
+ "$ref": "#/definitions/McpInvocation"
+ },
+ "type": {
+ "enum": [
+ "mcp_tool_call_begin"
+ ],
+ "title": "McpToolCallBeginEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "invocation",
+ "type"
+ ],
+ "title": "McpToolCallBeginEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "call_id": {
+ "description": "Identifier for the corresponding McpToolCallBegin that finished.",
+ "type": "string"
+ },
+ "duration": {
+ "$ref": "#/definitions/Duration"
+ },
+ "invocation": {
+ "$ref": "#/definitions/McpInvocation"
+ },
+ "result": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/Result_of_CallToolResult_or_String"
+ }
+ ],
+ "description": "Result of the tool call. Note this could be an error."
+ },
+ "type": {
+ "enum": [
+ "mcp_tool_call_end"
+ ],
+ "title": "McpToolCallEndEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "duration",
+ "invocation",
+ "result",
+ "type"
+ ],
+ "title": "McpToolCallEndEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "call_id": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "web_search_begin"
+ ],
+ "title": "WebSearchBeginEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "type"
+ ],
+ "title": "WebSearchBeginEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "action": {
+ "$ref": "#/definitions/WebSearchAction"
+ },
+ "call_id": {
+ "type": "string"
+ },
+ "query": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "web_search_end"
+ ],
+ "title": "WebSearchEndEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "action",
+ "call_id",
+ "query",
+ "type"
+ ],
+ "title": "WebSearchEndEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Notification that the server is about to execute a command.",
+ "properties": {
+ "call_id": {
+ "description": "Identifier so this can be paired with the ExecCommandEnd event.",
+ "type": "string"
+ },
+ "command": {
+ "description": "The command to be executed.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "cwd": {
+ "description": "The command's working directory if not the default cwd for the agent.",
+ "type": "string"
+ },
+ "interaction_input": {
+ "description": "Raw input sent to a unified exec session (if this is an interaction event).",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "parsed_cmd": {
+ "items": {
+ "$ref": "#/definitions/ParsedCommand"
+ },
+ "type": "array"
+ },
+ "process_id": {
+ "description": "Identifier for the underlying PTY process (when available).",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "source": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ExecCommandSource"
+ }
+ ],
+ "default": "agent",
+ "description": "Where the command originated. Defaults to Agent for backward compatibility."
+ },
+ "turn_id": {
+ "description": "Turn ID that this command belongs to.",
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "exec_command_begin"
+ ],
+ "title": "ExecCommandBeginEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "command",
+ "cwd",
+ "parsed_cmd",
+ "turn_id",
+ "type"
+ ],
+ "title": "ExecCommandBeginEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Incremental chunk of output from a running command.",
+ "properties": {
+ "call_id": {
+ "description": "Identifier for the ExecCommandBegin that produced this chunk.",
+ "type": "string"
+ },
+ "chunk": {
+ "description": "Raw bytes from the stream (may not be valid UTF-8).",
+ "type": "string"
+ },
+ "stream": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ExecOutputStream"
+ }
+ ],
+ "description": "Which stream produced this chunk."
+ },
+ "type": {
+ "enum": [
+ "exec_command_output_delta"
+ ],
+ "title": "ExecCommandOutputDeltaEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "chunk",
+ "stream",
+ "type"
+ ],
+ "title": "ExecCommandOutputDeltaEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Terminal interaction for an in-progress command (stdin sent and stdout observed).",
+ "properties": {
+ "call_id": {
+ "description": "Identifier for the ExecCommandBegin that produced this chunk.",
+ "type": "string"
+ },
+ "process_id": {
+ "description": "Process id associated with the running command.",
+ "type": "string"
+ },
+ "stdin": {
+ "description": "Stdin sent to the running session.",
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "terminal_interaction"
+ ],
+ "title": "TerminalInteractionEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "process_id",
+ "stdin",
+ "type"
+ ],
+ "title": "TerminalInteractionEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "aggregated_output": {
+ "default": "",
+ "description": "Captured aggregated output",
+ "type": "string"
+ },
+ "call_id": {
+ "description": "Identifier for the ExecCommandBegin that finished.",
+ "type": "string"
+ },
+ "command": {
+ "description": "The command that was executed.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "cwd": {
+ "description": "The command's working directory if not the default cwd for the agent.",
+ "type": "string"
+ },
+ "duration": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/Duration"
+ }
+ ],
+ "description": "The duration of the command execution."
+ },
+ "exit_code": {
+ "description": "The command's exit code.",
+ "format": "int32",
+ "type": "integer"
+ },
+ "formatted_output": {
+ "description": "Formatted output from the command, as seen by the model.",
+ "type": "string"
+ },
+ "interaction_input": {
+ "description": "Raw input sent to a unified exec session (if this is an interaction event).",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "parsed_cmd": {
+ "items": {
+ "$ref": "#/definitions/ParsedCommand"
+ },
+ "type": "array"
+ },
+ "process_id": {
+ "description": "Identifier for the underlying PTY process (when available).",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "source": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ExecCommandSource"
+ }
+ ],
+ "default": "agent",
+ "description": "Where the command originated. Defaults to Agent for backward compatibility."
+ },
+ "stderr": {
+ "description": "Captured stderr",
+ "type": "string"
+ },
+ "stdout": {
+ "description": "Captured stdout",
+ "type": "string"
+ },
+ "turn_id": {
+ "description": "Turn ID that this command belongs to.",
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "exec_command_end"
+ ],
+ "title": "ExecCommandEndEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "command",
+ "cwd",
+ "duration",
+ "exit_code",
+ "formatted_output",
+ "parsed_cmd",
+ "stderr",
+ "stdout",
+ "turn_id",
+ "type"
+ ],
+ "title": "ExecCommandEndEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Notification that the agent attached a local image via the view_image tool.",
+ "properties": {
+ "call_id": {
+ "description": "Identifier for the originating tool call.",
+ "type": "string"
+ },
+ "path": {
+ "description": "Local filesystem path provided to the tool.",
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "view_image_tool_call"
+ ],
+ "title": "ViewImageToolCallEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "path",
+ "type"
+ ],
+ "title": "ViewImageToolCallEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "call_id": {
+ "description": "Identifier for the associated exec call, if available.",
+ "type": "string"
+ },
+ "command": {
+ "description": "The command to be executed.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "cwd": {
+ "description": "The command's working directory.",
+ "type": "string"
+ },
+ "parsed_cmd": {
+ "items": {
+ "$ref": "#/definitions/ParsedCommand"
+ },
+ "type": "array"
+ },
+ "proposed_execpolicy_amendment": {
+ "description": "Proposed execpolicy amendment that can be applied to allow future runs.",
+ "items": {
+ "type": "string"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "reason": {
+ "description": "Optional human-readable reason for the approval (e.g. retry without sandbox).",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "turn_id": {
+ "default": "",
+ "description": "Turn ID that this command belongs to. Uses `#[serde(default)]` for backwards compatibility.",
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "exec_approval_request"
+ ],
+ "title": "ExecApprovalRequestEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "command",
+ "cwd",
+ "parsed_cmd",
+ "type"
+ ],
+ "title": "ExecApprovalRequestEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "call_id": {
+ "description": "Responses API call id for the associated tool call, if available.",
+ "type": "string"
+ },
+ "questions": {
+ "items": {
+ "$ref": "#/definitions/RequestUserInputQuestion"
+ },
+ "type": "array"
+ },
+ "turn_id": {
+ "default": "",
+ "description": "Turn ID that this request belongs to. Uses `#[serde(default)]` for backwards compatibility.",
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "request_user_input"
+ ],
+ "title": "RequestUserInputEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "questions",
+ "type"
+ ],
+ "title": "RequestUserInputEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "arguments": true,
+ "callId": {
+ "type": "string"
+ },
+ "tool": {
+ "type": "string"
+ },
+ "turnId": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "dynamic_tool_call_request"
+ ],
+ "title": "DynamicToolCallRequestEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "arguments",
+ "callId",
+ "tool",
+ "turnId",
+ "type"
+ ],
+ "title": "DynamicToolCallRequestEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "message": {
+ "type": "string"
+ },
+ "server_name": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "elicitation_request"
+ ],
+ "title": "ElicitationRequestEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "message",
+ "server_name",
+ "type"
+ ],
+ "title": "ElicitationRequestEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "call_id": {
+ "description": "Responses API call id for the associated patch apply call, if available.",
+ "type": "string"
+ },
+ "changes": {
+ "additionalProperties": {
+ "$ref": "#/definitions/FileChange"
+ },
+ "type": "object"
+ },
+ "grant_root": {
+ "description": "When set, the agent is asking the user to allow writes under this root for the remainder of the session.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "reason": {
+ "description": "Optional explanatory reason (e.g. request for extra write access).",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "turn_id": {
+ "default": "",
+ "description": "Turn ID that this patch belongs to. Uses `#[serde(default)]` for backwards compatibility with older senders.",
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "apply_patch_approval_request"
+ ],
+ "title": "ApplyPatchApprovalRequestEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "changes",
+ "type"
+ ],
+ "title": "ApplyPatchApprovalRequestEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Notification advising the user that something they are using has been deprecated and should be phased out.",
+ "properties": {
+ "details": {
+ "description": "Optional extra guidance, such as migration steps or rationale.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "summary": {
+ "description": "Concise summary of what is deprecated.",
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "deprecation_notice"
+ ],
+ "title": "DeprecationNoticeEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "summary",
+ "type"
+ ],
+ "title": "DeprecationNoticeEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "message": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "background_event"
+ ],
+ "title": "BackgroundEventEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "message",
+ "type"
+ ],
+ "title": "BackgroundEventEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "message": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "undo_started"
+ ],
+ "title": "UndoStartedEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "UndoStartedEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "message": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "success": {
+ "type": "boolean"
+ },
+ "type": {
+ "enum": [
+ "undo_completed"
+ ],
+ "title": "UndoCompletedEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "success",
+ "type"
+ ],
+ "title": "UndoCompletedEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Notification that a model stream experienced an error or disconnect and the system is handling it (e.g., retrying with backoff).",
+ "properties": {
+ "additional_details": {
+ "default": null,
+ "description": "Optional details about the underlying stream failure (often the same human-readable message that is surfaced as the terminal error if retries are exhausted).",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "codex_error_info": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/CodexErrorInfo"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "default": null
+ },
+ "message": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "stream_error"
+ ],
+ "title": "StreamErrorEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "message",
+ "type"
+ ],
+ "title": "StreamErrorEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Notification that the agent is about to apply a code patch. Mirrors `ExecCommandBegin` so front‑ends can show progress indicators.",
+ "properties": {
+ "auto_approved": {
+ "description": "If true, there was no ApplyPatchApprovalRequest for this patch.",
+ "type": "boolean"
+ },
+ "call_id": {
+ "description": "Identifier so this can be paired with the PatchApplyEnd event.",
+ "type": "string"
+ },
+ "changes": {
+ "additionalProperties": {
+ "$ref": "#/definitions/FileChange"
+ },
+ "description": "The changes to be applied.",
+ "type": "object"
+ },
+ "turn_id": {
+ "default": "",
+ "description": "Turn ID that this patch belongs to. Uses `#[serde(default)]` for backwards compatibility.",
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "patch_apply_begin"
+ ],
+ "title": "PatchApplyBeginEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "auto_approved",
+ "call_id",
+ "changes",
+ "type"
+ ],
+ "title": "PatchApplyBeginEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Notification that a patch application has finished.",
+ "properties": {
+ "call_id": {
+ "description": "Identifier for the PatchApplyBegin that finished.",
+ "type": "string"
+ },
+ "changes": {
+ "additionalProperties": {
+ "$ref": "#/definitions/FileChange"
+ },
+ "default": {},
+ "description": "The changes that were applied (mirrors PatchApplyBeginEvent::changes).",
+ "type": "object"
+ },
+ "stderr": {
+ "description": "Captured stderr (parser errors, IO failures, etc.).",
+ "type": "string"
+ },
+ "stdout": {
+ "description": "Captured stdout (summary printed by apply_patch).",
+ "type": "string"
+ },
+ "success": {
+ "description": "Whether the patch was applied successfully.",
+ "type": "boolean"
+ },
+ "turn_id": {
+ "default": "",
+ "description": "Turn ID that this patch belongs to. Uses `#[serde(default)]` for backwards compatibility.",
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "patch_apply_end"
+ ],
+ "title": "PatchApplyEndEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "stderr",
+ "stdout",
+ "success",
+ "type"
+ ],
+ "title": "PatchApplyEndEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "turn_diff"
+ ],
+ "title": "TurnDiffEventMsgType",
+ "type": "string"
+ },
+ "unified_diff": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "unified_diff"
+ ],
+ "title": "TurnDiffEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Response to GetHistoryEntryRequest.",
+ "properties": {
+ "entry": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/HistoryEntry"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "The entry at the requested offset, if available and parseable."
+ },
+ "log_id": {
+ "format": "uint64",
+ "minimum": 0.0,
+ "type": "integer"
+ },
+ "offset": {
+ "format": "uint",
+ "minimum": 0.0,
+ "type": "integer"
+ },
+ "type": {
+ "enum": [
+ "get_history_entry_response"
+ ],
+ "title": "GetHistoryEntryResponseEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "log_id",
+ "offset",
+ "type"
+ ],
+ "title": "GetHistoryEntryResponseEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "List of MCP tools available to the agent.",
+ "properties": {
+ "auth_statuses": {
+ "additionalProperties": {
+ "$ref": "#/definitions/McpAuthStatus"
+ },
+ "description": "Authentication status for each configured MCP server.",
+ "type": "object"
+ },
+ "resource_templates": {
+ "additionalProperties": {
+ "items": {
+ "$ref": "#/definitions/ResourceTemplate"
+ },
+ "type": "array"
+ },
+ "description": "Known resource templates grouped by server name.",
+ "type": "object"
+ },
+ "resources": {
+ "additionalProperties": {
+ "items": {
+ "$ref": "#/definitions/Resource"
+ },
+ "type": "array"
+ },
+ "description": "Known resources grouped by server name.",
+ "type": "object"
+ },
+ "tools": {
+ "additionalProperties": {
+ "$ref": "#/definitions/Tool"
+ },
+ "description": "Fully qualified tool name -> tool definition.",
+ "type": "object"
+ },
+ "type": {
+ "enum": [
+ "mcp_list_tools_response"
+ ],
+ "title": "McpListToolsResponseEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "auth_statuses",
+ "resource_templates",
+ "resources",
+ "tools",
+ "type"
+ ],
+ "title": "McpListToolsResponseEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "List of custom prompts available to the agent.",
+ "properties": {
+ "custom_prompts": {
+ "items": {
+ "$ref": "#/definitions/CustomPrompt"
+ },
+ "type": "array"
+ },
+ "type": {
+ "enum": [
+ "list_custom_prompts_response"
+ ],
+ "title": "ListCustomPromptsResponseEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "custom_prompts",
+ "type"
+ ],
+ "title": "ListCustomPromptsResponseEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "List of skills available to the agent.",
+ "properties": {
+ "skills": {
+ "items": {
+ "$ref": "#/definitions/SkillsListEntry"
+ },
+ "type": "array"
+ },
+ "type": {
+ "enum": [
+ "list_skills_response"
+ ],
+ "title": "ListSkillsResponseEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "skills",
+ "type"
+ ],
+ "title": "ListSkillsResponseEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Notification that skill data may have been updated and clients may want to reload.",
+ "properties": {
+ "type": {
+ "enum": [
+ "skills_update_available"
+ ],
+ "title": "SkillsUpdateAvailableEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "SkillsUpdateAvailableEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "explanation": {
+ "default": null,
+ "description": "Arguments for the `update_plan` todo/checklist tool (not plan mode).",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "plan": {
+ "items": {
+ "$ref": "#/definitions/PlanItemArg"
+ },
+ "type": "array"
+ },
+ "type": {
+ "enum": [
+ "plan_update"
+ ],
+ "title": "PlanUpdateEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "plan",
+ "type"
+ ],
+ "title": "PlanUpdateEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "reason": {
+ "$ref": "#/definitions/TurnAbortReason"
+ },
+ "type": {
+ "enum": [
+ "turn_aborted"
+ ],
+ "title": "TurnAbortedEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "reason",
+ "type"
+ ],
+ "title": "TurnAbortedEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Notification that the agent is shutting down.",
+ "properties": {
+ "type": {
+ "enum": [
+ "shutdown_complete"
+ ],
+ "title": "ShutdownCompleteEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "ShutdownCompleteEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Entered review mode.",
+ "properties": {
+ "target": {
+ "$ref": "#/definitions/ReviewTarget"
+ },
+ "type": {
+ "enum": [
+ "entered_review_mode"
+ ],
+ "title": "EnteredReviewModeEventMsgType",
+ "type": "string"
+ },
+ "user_facing_hint": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "target",
+ "type"
+ ],
+ "title": "EnteredReviewModeEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Exited review mode with an optional final result to apply.",
+ "properties": {
+ "review_output": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ReviewOutputEvent"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "type": {
+ "enum": [
+ "exited_review_mode"
+ ],
+ "title": "ExitedReviewModeEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "ExitedReviewModeEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "item": {
+ "$ref": "#/definitions/ResponseItem"
+ },
+ "type": {
+ "enum": [
+ "raw_response_item"
+ ],
+ "title": "RawResponseItemEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "item",
+ "type"
+ ],
+ "title": "RawResponseItemEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "item": {
+ "$ref": "#/definitions/TurnItem"
+ },
+ "thread_id": {
+ "$ref": "#/definitions/ThreadId"
+ },
+ "turn_id": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "item_started"
+ ],
+ "title": "ItemStartedEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "item",
+ "thread_id",
+ "turn_id",
+ "type"
+ ],
+ "title": "ItemStartedEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "item": {
+ "$ref": "#/definitions/TurnItem"
+ },
+ "thread_id": {
+ "$ref": "#/definitions/ThreadId"
+ },
+ "turn_id": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "item_completed"
+ ],
+ "title": "ItemCompletedEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "item",
+ "thread_id",
+ "turn_id",
+ "type"
+ ],
+ "title": "ItemCompletedEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "delta": {
+ "type": "string"
+ },
+ "item_id": {
+ "type": "string"
+ },
+ "thread_id": {
+ "type": "string"
+ },
+ "turn_id": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "agent_message_content_delta"
+ ],
+ "title": "AgentMessageContentDeltaEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "delta",
+ "item_id",
+ "thread_id",
+ "turn_id",
+ "type"
+ ],
+ "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": {
+ "type": "string"
+ },
+ "item_id": {
+ "type": "string"
+ },
+ "summary_index": {
+ "default": 0,
+ "format": "int64",
+ "type": "integer"
+ },
+ "thread_id": {
+ "type": "string"
+ },
+ "turn_id": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "reasoning_content_delta"
+ ],
+ "title": "ReasoningContentDeltaEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "delta",
+ "item_id",
+ "thread_id",
+ "turn_id",
+ "type"
+ ],
+ "title": "ReasoningContentDeltaEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "content_index": {
+ "default": 0,
+ "format": "int64",
+ "type": "integer"
+ },
+ "delta": {
+ "type": "string"
+ },
+ "item_id": {
+ "type": "string"
+ },
+ "thread_id": {
+ "type": "string"
+ },
+ "turn_id": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "reasoning_raw_content_delta"
+ ],
+ "title": "ReasoningRawContentDeltaEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "delta",
+ "item_id",
+ "thread_id",
+ "turn_id",
+ "type"
+ ],
+ "title": "ReasoningRawContentDeltaEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Collab interaction: agent spawn begin.",
+ "properties": {
+ "call_id": {
+ "description": "Identifier for the collab tool call.",
+ "type": "string"
+ },
+ "prompt": {
+ "description": "Initial prompt sent to the agent. Can be empty to prevent CoT leaking at the beginning.",
+ "type": "string"
+ },
+ "sender_thread_id": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ThreadId"
+ }
+ ],
+ "description": "Thread ID of the sender."
+ },
+ "type": {
+ "enum": [
+ "collab_agent_spawn_begin"
+ ],
+ "title": "CollabAgentSpawnBeginEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "prompt",
+ "sender_thread_id",
+ "type"
+ ],
+ "title": "CollabAgentSpawnBeginEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Collab interaction: agent spawn end.",
+ "properties": {
+ "call_id": {
+ "description": "Identifier for the collab tool call.",
+ "type": "string"
+ },
+ "new_thread_id": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ThreadId"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Thread ID of the newly spawned agent, if it was created."
+ },
+ "prompt": {
+ "description": "Initial prompt sent to the agent. Can be empty to prevent CoT leaking at the beginning.",
+ "type": "string"
+ },
+ "sender_thread_id": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ThreadId"
+ }
+ ],
+ "description": "Thread ID of the sender."
+ },
+ "status": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/AgentStatus"
+ }
+ ],
+ "description": "Last known status of the new agent reported to the sender agent."
+ },
+ "type": {
+ "enum": [
+ "collab_agent_spawn_end"
+ ],
+ "title": "CollabAgentSpawnEndEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "prompt",
+ "sender_thread_id",
+ "status",
+ "type"
+ ],
+ "title": "CollabAgentSpawnEndEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Collab interaction: agent interaction begin.",
+ "properties": {
+ "call_id": {
+ "description": "Identifier for the collab tool call.",
+ "type": "string"
+ },
+ "prompt": {
+ "description": "Prompt sent from the sender to the receiver. Can be empty to prevent CoT leaking at the beginning.",
+ "type": "string"
+ },
+ "receiver_thread_id": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ThreadId"
+ }
+ ],
+ "description": "Thread ID of the receiver."
+ },
+ "sender_thread_id": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ThreadId"
+ }
+ ],
+ "description": "Thread ID of the sender."
+ },
+ "type": {
+ "enum": [
+ "collab_agent_interaction_begin"
+ ],
+ "title": "CollabAgentInteractionBeginEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "prompt",
+ "receiver_thread_id",
+ "sender_thread_id",
+ "type"
+ ],
+ "title": "CollabAgentInteractionBeginEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Collab interaction: agent interaction end.",
+ "properties": {
+ "call_id": {
+ "description": "Identifier for the collab tool call.",
+ "type": "string"
+ },
+ "prompt": {
+ "description": "Prompt sent from the sender to the receiver. Can be empty to prevent CoT leaking at the beginning.",
+ "type": "string"
+ },
+ "receiver_thread_id": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ThreadId"
+ }
+ ],
+ "description": "Thread ID of the receiver."
+ },
+ "sender_thread_id": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ThreadId"
+ }
+ ],
+ "description": "Thread ID of the sender."
+ },
+ "status": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/AgentStatus"
+ }
+ ],
+ "description": "Last known status of the receiver agent reported to the sender agent."
+ },
+ "type": {
+ "enum": [
+ "collab_agent_interaction_end"
+ ],
+ "title": "CollabAgentInteractionEndEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "prompt",
+ "receiver_thread_id",
+ "sender_thread_id",
+ "status",
+ "type"
+ ],
+ "title": "CollabAgentInteractionEndEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Collab interaction: waiting begin.",
+ "properties": {
+ "call_id": {
+ "description": "ID of the waiting call.",
+ "type": "string"
+ },
+ "receiver_thread_ids": {
+ "description": "Thread ID of the receivers.",
+ "items": {
+ "$ref": "#/definitions/ThreadId"
+ },
+ "type": "array"
+ },
+ "sender_thread_id": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ThreadId"
+ }
+ ],
+ "description": "Thread ID of the sender."
+ },
+ "type": {
+ "enum": [
+ "collab_waiting_begin"
+ ],
+ "title": "CollabWaitingBeginEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "receiver_thread_ids",
+ "sender_thread_id",
+ "type"
+ ],
+ "title": "CollabWaitingBeginEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Collab interaction: waiting end.",
+ "properties": {
+ "call_id": {
+ "description": "ID of the waiting call.",
+ "type": "string"
+ },
+ "sender_thread_id": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ThreadId"
+ }
+ ],
+ "description": "Thread ID of the sender."
+ },
+ "statuses": {
+ "additionalProperties": {
+ "$ref": "#/definitions/AgentStatus"
+ },
+ "description": "Last known status of the receiver agents reported to the sender agent.",
+ "type": "object"
+ },
+ "type": {
+ "enum": [
+ "collab_waiting_end"
+ ],
+ "title": "CollabWaitingEndEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "sender_thread_id",
+ "statuses",
+ "type"
+ ],
+ "title": "CollabWaitingEndEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Collab interaction: close begin.",
+ "properties": {
+ "call_id": {
+ "description": "Identifier for the collab tool call.",
+ "type": "string"
+ },
+ "receiver_thread_id": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ThreadId"
+ }
+ ],
+ "description": "Thread ID of the receiver."
+ },
+ "sender_thread_id": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ThreadId"
+ }
+ ],
+ "description": "Thread ID of the sender."
+ },
+ "type": {
+ "enum": [
+ "collab_close_begin"
+ ],
+ "title": "CollabCloseBeginEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "receiver_thread_id",
+ "sender_thread_id",
+ "type"
+ ],
+ "title": "CollabCloseBeginEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Collab interaction: close end.",
+ "properties": {
+ "call_id": {
+ "description": "Identifier for the collab tool call.",
+ "type": "string"
+ },
+ "receiver_thread_id": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ThreadId"
+ }
+ ],
+ "description": "Thread ID of the receiver."
+ },
+ "sender_thread_id": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ThreadId"
+ }
+ ],
+ "description": "Thread ID of the sender."
+ },
+ "status": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/AgentStatus"
+ }
+ ],
+ "description": "Last known status of the receiver agent reported to the sender agent before the close."
+ },
+ "type": {
+ "enum": [
+ "collab_close_end"
+ ],
+ "title": "CollabCloseEndEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "receiver_thread_id",
+ "sender_thread_id",
+ "status",
+ "type"
+ ],
+ "title": "CollabCloseEndEventMsg",
+ "type": "object"
+ }
+ ]
+ },
+ "ExecCommandSource": {
+ "enum": [
+ "agent",
+ "user_shell",
+ "unified_exec_startup",
+ "unified_exec_interaction"
+ ],
+ "type": "string"
+ },
+ "ExecOutputStream": {
+ "enum": [
+ "stdout",
+ "stderr"
+ ],
+ "type": "string"
+ },
+ "FileChange": {
+ "oneOf": [
+ {
+ "properties": {
+ "content": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "add"
+ ],
+ "title": "AddFileChangeType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "content",
+ "type"
+ ],
+ "title": "AddFileChange",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "content": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "delete"
+ ],
+ "title": "DeleteFileChangeType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "content",
+ "type"
+ ],
+ "title": "DeleteFileChange",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "move_path": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "update"
+ ],
+ "title": "UpdateFileChangeType",
+ "type": "string"
+ },
+ "unified_diff": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "unified_diff"
+ ],
+ "title": "UpdateFileChange",
+ "type": "object"
+ }
+ ]
+ },
+ "FunctionCallOutputContentItem": {
+ "description": "Responses API compatible content items that can be returned by a tool call. This is a subset of ContentItem with the types we support as function call outputs.",
+ "oneOf": [
+ {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "input_text"
+ ],
+ "title": "InputTextFunctionCallOutputContentItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "InputTextFunctionCallOutputContentItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "image_url": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "input_image"
+ ],
+ "title": "InputImageFunctionCallOutputContentItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "image_url",
+ "type"
+ ],
+ "title": "InputImageFunctionCallOutputContentItem",
+ "type": "object"
+ }
+ ]
+ },
+ "FunctionCallOutputPayload": {
+ "description": "The payload we send back to OpenAI when reporting a tool call result.\n\n`content` preserves the historical plain-string payload so downstream integrations (tests, logging, etc.) can keep treating tool output as `String`. When an MCP server returns richer data we additionally populate `content_items` with the structured form that the Responses/Chat Completions APIs understand.",
+ "properties": {
+ "content": {
+ "type": "string"
+ },
+ "content_items": {
+ "items": {
+ "$ref": "#/definitions/FunctionCallOutputContentItem"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "success": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "content"
+ ],
+ "type": "object"
+ },
+ "GhostCommit": {
+ "description": "Details of a ghost commit created from a repository state.",
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "parent": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "preexisting_untracked_dirs": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "preexisting_untracked_files": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ }
+ },
+ "required": [
+ "id",
+ "preexisting_untracked_dirs",
+ "preexisting_untracked_files"
+ ],
+ "type": "object"
+ },
+ "HistoryEntry": {
+ "properties": {
+ "conversation_id": {
+ "type": "string"
+ },
+ "text": {
+ "type": "string"
+ },
+ "ts": {
+ "format": "uint64",
+ "minimum": 0.0,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "conversation_id",
+ "text",
+ "ts"
+ ],
+ "type": "object"
+ },
+ "ImageContent": {
+ "description": "An image provided to or from an LLM.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "data": {
+ "type": "string"
+ },
+ "mimeType": {
+ "type": "string"
+ },
+ "type": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "data",
+ "mimeType",
+ "type"
+ ],
+ "type": "object"
+ },
+ "LocalShellAction": {
+ "oneOf": [
+ {
+ "properties": {
+ "command": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "env": {
+ "additionalProperties": {
+ "type": "string"
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "timeout_ms": {
+ "format": "uint64",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "exec"
+ ],
+ "title": "ExecLocalShellActionType",
+ "type": "string"
+ },
+ "user": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "working_directory": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "command",
+ "type"
+ ],
+ "title": "ExecLocalShellAction",
+ "type": "object"
+ }
+ ]
+ },
+ "LocalShellStatus": {
+ "enum": [
+ "completed",
+ "in_progress",
+ "incomplete"
+ ],
+ "type": "string"
+ },
+ "McpAuthStatus": {
+ "enum": [
+ "unsupported",
+ "not_logged_in",
+ "bearer_token",
+ "o_auth"
+ ],
+ "type": "string"
+ },
+ "McpInvocation": {
+ "properties": {
+ "arguments": {
+ "description": "Arguments to the tool call."
+ },
+ "server": {
+ "description": "Name of the MCP server as defined in the config.",
+ "type": "string"
+ },
+ "tool": {
+ "description": "Name of the tool as given by the MCP server.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "server",
+ "tool"
+ ],
+ "type": "object"
+ },
+ "McpStartupFailure": {
+ "properties": {
+ "error": {
+ "type": "string"
+ },
+ "server": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "error",
+ "server"
+ ],
+ "type": "object"
+ },
+ "McpStartupStatus": {
+ "oneOf": [
+ {
+ "properties": {
+ "state": {
+ "enum": [
+ "starting"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "state"
+ ],
+ "title": "StateMcpStartupStatus",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "state": {
+ "enum": [
+ "ready"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "state"
+ ],
+ "title": "StateMcpStartupStatus2",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "error": {
+ "type": "string"
+ },
+ "state": {
+ "enum": [
+ "failed"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "error",
+ "state"
+ ],
+ "type": "object"
+ },
+ {
+ "properties": {
+ "state": {
+ "enum": [
+ "cancelled"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "state"
+ ],
+ "title": "StateMcpStartupStatus3",
+ "type": "object"
+ }
+ ]
+ },
+ "ModeKind": {
+ "description": "Initial collaboration mode to use when the TUI starts.",
+ "enum": [
+ "plan",
+ "code",
+ "pair_programming",
+ "execute",
+ "custom"
+ ],
+ "type": "string"
+ },
+ "NetworkAccess": {
+ "description": "Represents whether outbound network access is available to the agent.",
+ "enum": [
+ "restricted",
+ "enabled"
+ ],
+ "type": "string"
+ },
+ "ParsedCommand": {
+ "oneOf": [
+ {
+ "properties": {
+ "cmd": {
+ "type": "string"
+ },
+ "name": {
+ "type": "string"
+ },
+ "path": {
+ "description": "(Best effort) Path to the file being read by the command. When possible, this is an absolute path, though when relative, it should be resolved against the `cwd`` that will be used to run the command to derive the absolute path.",
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "read"
+ ],
+ "title": "ReadParsedCommandType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "cmd",
+ "name",
+ "path",
+ "type"
+ ],
+ "title": "ReadParsedCommand",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "cmd": {
+ "type": "string"
+ },
+ "path": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "list_files"
+ ],
+ "title": "ListFilesParsedCommandType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "cmd",
+ "type"
+ ],
+ "title": "ListFilesParsedCommand",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "cmd": {
+ "type": "string"
+ },
+ "path": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "query": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "search"
+ ],
+ "title": "SearchParsedCommandType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "cmd",
+ "type"
+ ],
+ "title": "SearchParsedCommand",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "cmd": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "unknown"
+ ],
+ "title": "UnknownParsedCommandType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "cmd",
+ "type"
+ ],
+ "title": "UnknownParsedCommand",
+ "type": "object"
+ }
+ ]
+ },
+ "PlanItemArg": {
+ "additionalProperties": false,
+ "properties": {
+ "status": {
+ "$ref": "#/definitions/StepStatus"
+ },
+ "step": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "status",
+ "step"
+ ],
+ "type": "object"
+ },
+ "PlanType": {
+ "enum": [
+ "free",
+ "go",
+ "plus",
+ "pro",
+ "team",
+ "business",
+ "enterprise",
+ "edu",
+ "unknown"
+ ],
+ "type": "string"
+ },
+ "RateLimitSnapshot": {
+ "properties": {
+ "credits": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/CreditsSnapshot"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "plan_type": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/PlanType"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "primary": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/RateLimitWindow"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "secondary": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/RateLimitWindow"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "RateLimitWindow": {
+ "properties": {
+ "resets_at": {
+ "description": "Unix timestamp (seconds since epoch) when the window resets.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "used_percent": {
+ "description": "Percentage (0-100) of the window that has been consumed.",
+ "format": "double",
+ "type": "number"
+ },
+ "window_minutes": {
+ "description": "Rolling window duration, in minutes.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "used_percent"
+ ],
+ "type": "object"
+ },
+ "ReasoningEffort": {
+ "description": "See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#get-started-with-reasoning",
+ "enum": [
+ "none",
+ "minimal",
+ "low",
+ "medium",
+ "high",
+ "xhigh"
+ ],
+ "type": "string"
+ },
+ "ReasoningItemContent": {
+ "oneOf": [
+ {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "reasoning_text"
+ ],
+ "title": "ReasoningTextReasoningItemContentType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "ReasoningTextReasoningItemContent",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "text"
+ ],
+ "title": "TextReasoningItemContentType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "TextReasoningItemContent",
+ "type": "object"
+ }
+ ]
+ },
+ "ReasoningItemReasoningSummary": {
+ "oneOf": [
+ {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "summary_text"
+ ],
+ "title": "SummaryTextReasoningItemReasoningSummaryType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "SummaryTextReasoningItemReasoningSummary",
+ "type": "object"
+ }
+ ]
+ },
+ "RequestId": {
+ "anyOf": [
+ {
+ "type": "string"
+ },
+ {
+ "format": "int64",
+ "type": "integer"
+ }
+ ]
+ },
+ "RequestUserInputQuestion": {
+ "properties": {
+ "header": {
+ "type": "string"
+ },
+ "id": {
+ "type": "string"
+ },
+ "isOther": {
+ "default": false,
+ "type": "boolean"
+ },
+ "isSecret": {
+ "default": false,
+ "type": "boolean"
+ },
+ "options": {
+ "items": {
+ "$ref": "#/definitions/RequestUserInputQuestionOption"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "question": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "header",
+ "id",
+ "question"
+ ],
+ "type": "object"
+ },
+ "RequestUserInputQuestionOption": {
+ "properties": {
+ "description": {
+ "type": "string"
+ },
+ "label": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "description",
+ "label"
+ ],
+ "type": "object"
+ },
+ "Resource": {
+ "description": "A known resource that the server is capable of reading.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "description": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "mimeType": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "name": {
+ "type": "string"
+ },
+ "size": {
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "title": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "uri": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "uri"
+ ],
+ "type": "object"
+ },
+ "ResourceLink": {
+ "description": "A resource that the server is capable of reading, included in a prompt or tool call result.\n\nNote: resource links returned by tools are not guaranteed to appear in the results of `resources/list` requests.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "description": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "mimeType": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "name": {
+ "type": "string"
+ },
+ "size": {
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "title": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "type": "string"
+ },
+ "uri": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "type",
+ "uri"
+ ],
+ "type": "object"
+ },
+ "ResourceTemplate": {
+ "description": "A template description for resources available on the server.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "description": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "mimeType": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "name": {
+ "type": "string"
+ },
+ "title": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "uriTemplate": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "uriTemplate"
+ ],
+ "type": "object"
+ },
+ "ResponseItem": {
+ "oneOf": [
+ {
+ "properties": {
+ "content": {
+ "items": {
+ "$ref": "#/definitions/ContentItem"
+ },
+ "type": "array"
+ },
+ "end_turn": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "id": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "writeOnly": true
+ },
+ "role": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "message"
+ ],
+ "title": "MessageResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "content",
+ "role",
+ "type"
+ ],
+ "title": "MessageResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "content": {
+ "default": null,
+ "items": {
+ "$ref": "#/definitions/ReasoningItemContent"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "encrypted_content": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "id": {
+ "type": "string",
+ "writeOnly": true
+ },
+ "summary": {
+ "items": {
+ "$ref": "#/definitions/ReasoningItemReasoningSummary"
+ },
+ "type": "array"
+ },
+ "type": {
+ "enum": [
+ "reasoning"
+ ],
+ "title": "ReasoningResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "summary",
+ "type"
+ ],
+ "title": "ReasoningResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "action": {
+ "$ref": "#/definitions/LocalShellAction"
+ },
+ "call_id": {
+ "description": "Set when using the Responses API.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "id": {
+ "description": "Set when using the chat completions API.",
+ "type": [
+ "string",
+ "null"
+ ],
+ "writeOnly": true
+ },
+ "status": {
+ "$ref": "#/definitions/LocalShellStatus"
+ },
+ "type": {
+ "enum": [
+ "local_shell_call"
+ ],
+ "title": "LocalShellCallResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "action",
+ "status",
+ "type"
+ ],
+ "title": "LocalShellCallResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "arguments": {
+ "type": "string"
+ },
+ "call_id": {
+ "type": "string"
+ },
+ "id": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "writeOnly": true
+ },
+ "name": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "function_call"
+ ],
+ "title": "FunctionCallResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "arguments",
+ "call_id",
+ "name",
+ "type"
+ ],
+ "title": "FunctionCallResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "call_id": {
+ "type": "string"
+ },
+ "output": {
+ "$ref": "#/definitions/FunctionCallOutputPayload"
+ },
+ "type": {
+ "enum": [
+ "function_call_output"
+ ],
+ "title": "FunctionCallOutputResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "output",
+ "type"
+ ],
+ "title": "FunctionCallOutputResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "call_id": {
+ "type": "string"
+ },
+ "id": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "writeOnly": true
+ },
+ "input": {
+ "type": "string"
+ },
+ "name": {
+ "type": "string"
+ },
+ "status": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "custom_tool_call"
+ ],
+ "title": "CustomToolCallResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "input",
+ "name",
+ "type"
+ ],
+ "title": "CustomToolCallResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "call_id": {
+ "type": "string"
+ },
+ "output": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "custom_tool_call_output"
+ ],
+ "title": "CustomToolCallOutputResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "output",
+ "type"
+ ],
+ "title": "CustomToolCallOutputResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "action": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/WebSearchAction"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "id": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "writeOnly": true
+ },
+ "status": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "web_search_call"
+ ],
+ "title": "WebSearchCallResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "WebSearchCallResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "ghost_commit": {
+ "$ref": "#/definitions/GhostCommit"
+ },
+ "type": {
+ "enum": [
+ "ghost_snapshot"
+ ],
+ "title": "GhostSnapshotResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "ghost_commit",
+ "type"
+ ],
+ "title": "GhostSnapshotResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "encrypted_content": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "compaction"
+ ],
+ "title": "CompactionResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "encrypted_content",
+ "type"
+ ],
+ "title": "CompactionResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "other"
+ ],
+ "title": "OtherResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "OtherResponseItem",
+ "type": "object"
+ }
+ ]
+ },
+ "Result_of_CallToolResult_or_String": {
+ "oneOf": [
+ {
+ "properties": {
+ "Ok": {
+ "$ref": "#/definitions/CallToolResult"
+ }
+ },
+ "required": [
+ "Ok"
+ ],
+ "title": "OkResult_of_CallToolResult_or_String",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "Err": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "Err"
+ ],
+ "title": "ErrResult_of_CallToolResult_or_String",
+ "type": "object"
+ }
+ ]
+ },
+ "ReviewCodeLocation": {
+ "description": "Location of the code related to a review finding.",
+ "properties": {
+ "absolute_file_path": {
+ "type": "string"
+ },
+ "line_range": {
+ "$ref": "#/definitions/ReviewLineRange"
+ }
+ },
+ "required": [
+ "absolute_file_path",
+ "line_range"
+ ],
+ "type": "object"
+ },
+ "ReviewFinding": {
+ "description": "A single review finding describing an observed issue or recommendation.",
+ "properties": {
+ "body": {
+ "type": "string"
+ },
+ "code_location": {
+ "$ref": "#/definitions/ReviewCodeLocation"
+ },
+ "confidence_score": {
+ "format": "float",
+ "type": "number"
+ },
+ "priority": {
+ "format": "int32",
+ "type": "integer"
+ },
+ "title": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "body",
+ "code_location",
+ "confidence_score",
+ "priority",
+ "title"
+ ],
+ "type": "object"
+ },
+ "ReviewLineRange": {
+ "description": "Inclusive line range in a file associated with the finding.",
+ "properties": {
+ "end": {
+ "format": "uint32",
+ "minimum": 0.0,
+ "type": "integer"
+ },
+ "start": {
+ "format": "uint32",
+ "minimum": 0.0,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "end",
+ "start"
+ ],
+ "type": "object"
+ },
+ "ReviewOutputEvent": {
+ "description": "Structured review result produced by a child review session.",
+ "properties": {
+ "findings": {
+ "items": {
+ "$ref": "#/definitions/ReviewFinding"
+ },
+ "type": "array"
+ },
+ "overall_confidence_score": {
+ "format": "float",
+ "type": "number"
+ },
+ "overall_correctness": {
+ "type": "string"
+ },
+ "overall_explanation": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "findings",
+ "overall_confidence_score",
+ "overall_correctness",
+ "overall_explanation"
+ ],
+ "type": "object"
+ },
+ "ReviewTarget": {
+ "oneOf": [
+ {
+ "description": "Review the working tree: staged, unstaged, and untracked files.",
+ "properties": {
+ "type": {
+ "enum": [
+ "uncommittedChanges"
+ ],
+ "title": "UncommittedChangesReviewTargetType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "UncommittedChangesReviewTarget",
+ "type": "object"
+ },
+ {
+ "description": "Review changes between the current branch and the given base branch.",
+ "properties": {
+ "branch": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "baseBranch"
+ ],
+ "title": "BaseBranchReviewTargetType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "branch",
+ "type"
+ ],
+ "title": "BaseBranchReviewTarget",
+ "type": "object"
+ },
+ {
+ "description": "Review the changes introduced by a specific commit.",
+ "properties": {
+ "sha": {
+ "type": "string"
+ },
+ "title": {
+ "description": "Optional human-readable label (e.g., commit subject) for UIs.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "commit"
+ ],
+ "title": "CommitReviewTargetType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "sha",
+ "type"
+ ],
+ "title": "CommitReviewTarget",
+ "type": "object"
+ },
+ {
+ "description": "Arbitrary instructions provided by the user.",
+ "properties": {
+ "instructions": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "custom"
+ ],
+ "title": "CustomReviewTargetType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "instructions",
+ "type"
+ ],
+ "title": "CustomReviewTarget",
+ "type": "object"
+ }
+ ]
+ },
+ "Role": {
+ "description": "The sender or recipient of messages and data in a conversation.",
+ "enum": [
+ "assistant",
+ "user"
+ ],
+ "type": "string"
+ },
+ "SandboxPolicy": {
+ "description": "Determines execution restrictions for model shell commands.",
+ "oneOf": [
+ {
+ "description": "No restrictions whatsoever. Use with caution.",
+ "properties": {
+ "type": {
+ "enum": [
+ "danger-full-access"
+ ],
+ "title": "DangerFullAccessSandboxPolicyType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "DangerFullAccessSandboxPolicy",
+ "type": "object"
+ },
+ {
+ "description": "Read-only access to the entire file-system.",
+ "properties": {
+ "type": {
+ "enum": [
+ "read-only"
+ ],
+ "title": "ReadOnlySandboxPolicyType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "ReadOnlySandboxPolicy",
+ "type": "object"
+ },
+ {
+ "description": "Indicates the process is already in an external sandbox. Allows full disk access while honoring the provided network setting.",
+ "properties": {
+ "network_access": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/NetworkAccess"
+ }
+ ],
+ "default": "restricted",
+ "description": "Whether the external sandbox permits outbound network traffic."
+ },
+ "type": {
+ "enum": [
+ "external-sandbox"
+ ],
+ "title": "ExternalSandboxSandboxPolicyType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "ExternalSandboxSandboxPolicy",
+ "type": "object"
+ },
+ {
+ "description": "Same as `ReadOnly` but additionally grants write access to the current working directory (\"workspace\").",
+ "properties": {
+ "exclude_slash_tmp": {
+ "default": false,
+ "description": "When set to `true`, will NOT include the `/tmp` among the default writable roots on UNIX. Defaults to `false`.",
+ "type": "boolean"
+ },
+ "exclude_tmpdir_env_var": {
+ "default": false,
+ "description": "When set to `true`, will NOT include the per-user `TMPDIR` environment variable among the default writable roots. Defaults to `false`.",
+ "type": "boolean"
+ },
+ "network_access": {
+ "default": false,
+ "description": "When set to `true`, outbound network access is allowed. `false` by default.",
+ "type": "boolean"
+ },
+ "type": {
+ "enum": [
+ "workspace-write"
+ ],
+ "title": "WorkspaceWriteSandboxPolicyType",
+ "type": "string"
+ },
+ "writable_roots": {
+ "description": "Additional folders (beyond cwd and possibly TMPDIR) that should be writable from within the sandbox.",
+ "items": {
+ "$ref": "#/definitions/AbsolutePathBuf"
+ },
+ "type": "array"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "WorkspaceWriteSandboxPolicy",
+ "type": "object"
+ }
+ ]
+ },
+ "SkillDependencies": {
+ "properties": {
+ "tools": {
+ "items": {
+ "$ref": "#/definitions/SkillToolDependency"
+ },
+ "type": "array"
+ }
+ },
+ "required": [
+ "tools"
+ ],
+ "type": "object"
+ },
+ "SkillErrorInfo": {
+ "properties": {
+ "message": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "message",
+ "path"
+ ],
+ "type": "object"
+ },
+ "SkillInterface": {
+ "properties": {
+ "brand_color": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "default_prompt": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "display_name": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "icon_large": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "icon_small": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "short_description": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "SkillMetadata": {
+ "properties": {
+ "dependencies": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/SkillDependencies"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "description": {
+ "type": "string"
+ },
+ "enabled": {
+ "type": "boolean"
+ },
+ "interface": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/SkillInterface"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "name": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "scope": {
+ "$ref": "#/definitions/SkillScope"
+ },
+ "short_description": {
+ "description": "Legacy short_description from SKILL.md. Prefer SKILL.json interface.short_description.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "description",
+ "enabled",
+ "name",
+ "path",
+ "scope"
+ ],
+ "type": "object"
+ },
+ "SkillScope": {
+ "enum": [
+ "user",
+ "repo",
+ "system",
+ "admin"
+ ],
+ "type": "string"
+ },
+ "SkillToolDependency": {
+ "properties": {
+ "command": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "description": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "transport": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "type": "string"
+ },
+ "url": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "value": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "value"
+ ],
+ "type": "object"
+ },
+ "SkillsListEntry": {
+ "properties": {
+ "cwd": {
+ "type": "string"
+ },
+ "errors": {
+ "items": {
+ "$ref": "#/definitions/SkillErrorInfo"
+ },
+ "type": "array"
+ },
+ "skills": {
+ "items": {
+ "$ref": "#/definitions/SkillMetadata"
+ },
+ "type": "array"
+ }
+ },
+ "required": [
+ "cwd",
+ "errors",
+ "skills"
+ ],
+ "type": "object"
+ },
+ "StepStatus": {
+ "enum": [
+ "pending",
+ "in_progress",
+ "completed"
+ ],
+ "type": "string"
+ },
+ "TextContent": {
+ "description": "Text provided to or from an LLM.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "type": "object"
+ },
+ "TextElement": {
+ "properties": {
+ "byte_range": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ByteRange"
+ }
+ ],
+ "description": "Byte range in the parent `text` buffer that this element occupies."
+ },
+ "placeholder": {
+ "description": "Optional human-readable placeholder for the element, displayed in the UI.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "byte_range"
+ ],
+ "type": "object"
+ },
+ "TextResourceContents": {
+ "properties": {
+ "mimeType": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "text": {
+ "type": "string"
+ },
+ "uri": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "uri"
+ ],
+ "type": "object"
+ },
+ "ThreadId": {
+ "type": "string"
+ },
+ "TokenUsage": {
+ "properties": {
+ "cached_input_tokens": {
+ "format": "int64",
+ "type": "integer"
+ },
+ "input_tokens": {
+ "format": "int64",
+ "type": "integer"
+ },
+ "output_tokens": {
+ "format": "int64",
+ "type": "integer"
+ },
+ "reasoning_output_tokens": {
+ "format": "int64",
+ "type": "integer"
+ },
+ "total_tokens": {
+ "format": "int64",
+ "type": "integer"
+ }
+ },
+ "required": [
+ "cached_input_tokens",
+ "input_tokens",
+ "output_tokens",
+ "reasoning_output_tokens",
+ "total_tokens"
+ ],
+ "type": "object"
+ },
+ "TokenUsageInfo": {
+ "properties": {
+ "last_token_usage": {
+ "$ref": "#/definitions/TokenUsage"
+ },
+ "model_context_window": {
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "total_token_usage": {
+ "$ref": "#/definitions/TokenUsage"
+ }
+ },
+ "required": [
+ "last_token_usage",
+ "total_token_usage"
+ ],
+ "type": "object"
+ },
+ "Tool": {
+ "description": "Definition for a tool the client can call.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ToolAnnotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "description": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "inputSchema": {
+ "$ref": "#/definitions/ToolInputSchema"
+ },
+ "name": {
+ "type": "string"
+ },
+ "outputSchema": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ToolOutputSchema"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "title": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "inputSchema",
+ "name"
+ ],
+ "type": "object"
+ },
+ "ToolAnnotations": {
+ "description": "Additional properties describing a Tool to clients.\n\nNOTE: all properties in ToolAnnotations are **hints**. They are not guaranteed to provide a faithful description of tool behavior (including descriptive properties like `title`).\n\nClients should never make tool use decisions based on ToolAnnotations received from untrusted servers.",
+ "properties": {
+ "destructiveHint": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "idempotentHint": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "openWorldHint": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "readOnlyHint": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "title": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "ToolInputSchema": {
+ "description": "A JSON Schema object defining the expected parameters for the tool.",
+ "properties": {
+ "properties": true,
+ "required": {
+ "items": {
+ "type": "string"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "type": {
+ "default": "object",
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "ToolOutputSchema": {
+ "description": "An optional JSON Schema object defining the structure of the tool's output returned in the structuredContent field of a CallToolResult.",
+ "properties": {
+ "properties": true,
+ "required": {
+ "items": {
+ "type": "string"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "type": {
+ "default": "object",
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "TurnAbortReason": {
+ "enum": [
+ "interrupted",
+ "replaced",
+ "review_ended"
+ ],
+ "type": "string"
+ },
+ "TurnItem": {
+ "oneOf": [
+ {
+ "properties": {
+ "content": {
+ "items": {
+ "$ref": "#/definitions/UserInput"
+ },
+ "type": "array"
+ },
+ "id": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "UserMessage"
+ ],
+ "title": "UserMessageTurnItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "content",
+ "id",
+ "type"
+ ],
+ "title": "UserMessageTurnItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "content": {
+ "items": {
+ "$ref": "#/definitions/AgentMessageContent"
+ },
+ "type": "array"
+ },
+ "id": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "AgentMessage"
+ ],
+ "title": "AgentMessageTurnItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "content",
+ "id",
+ "type"
+ ],
+ "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": {
+ "type": "string"
+ },
+ "raw_content": {
+ "default": [],
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "summary_text": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "type": {
+ "enum": [
+ "Reasoning"
+ ],
+ "title": "ReasoningTurnItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "summary_text",
+ "type"
+ ],
+ "title": "ReasoningTurnItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "action": {
+ "$ref": "#/definitions/WebSearchAction"
+ },
+ "id": {
+ "type": "string"
+ },
+ "query": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "WebSearch"
+ ],
+ "title": "WebSearchTurnItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "action",
+ "id",
+ "query",
+ "type"
+ ],
+ "title": "WebSearchTurnItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "ContextCompaction"
+ ],
+ "title": "ContextCompactionTurnItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "type"
+ ],
+ "title": "ContextCompactionTurnItem",
+ "type": "object"
+ }
+ ]
+ },
+ "UserInput": {
+ "description": "User input",
+ "oneOf": [
+ {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "text_elements": {
+ "default": [],
+ "description": "UI-defined spans within `text` that should be treated as special elements. These are byte ranges into the UTF-8 `text` buffer and are used to render or persist rich input markers (e.g., image placeholders) across history and resume without mutating the literal text.",
+ "items": {
+ "$ref": "#/definitions/TextElement"
+ },
+ "type": "array"
+ },
+ "type": {
+ "enum": [
+ "text"
+ ],
+ "title": "TextUserInputType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "TextUserInput",
+ "type": "object"
+ },
+ {
+ "description": "Pre‑encoded data: URI image.",
+ "properties": {
+ "image_url": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "image"
+ ],
+ "title": "ImageUserInputType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "image_url",
+ "type"
+ ],
+ "title": "ImageUserInput",
+ "type": "object"
+ },
+ {
+ "description": "Local image path provided by the user. This will be converted to an `Image` variant (base64 data URL) during request serialization.",
+ "properties": {
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "local_image"
+ ],
+ "title": "LocalImageUserInputType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "path",
+ "type"
+ ],
+ "title": "LocalImageUserInput",
+ "type": "object"
+ },
+ {
+ "description": "Skill selected by the user (name + path to SKILL.md).",
+ "properties": {
+ "name": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "skill"
+ ],
+ "title": "SkillUserInputType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "path",
+ "type"
+ ],
+ "title": "SkillUserInput",
+ "type": "object"
+ },
+ {
+ "description": "Explicit mention selected by the user (name + app://connector id).",
+ "properties": {
+ "name": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "mention"
+ ],
+ "title": "MentionUserInputType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "path",
+ "type"
+ ],
+ "title": "MentionUserInput",
+ "type": "object"
+ }
+ ]
+ },
+ "WebSearchAction": {
+ "oneOf": [
+ {
+ "properties": {
+ "queries": {
+ "items": {
+ "type": "string"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "query": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "search"
+ ],
+ "title": "SearchWebSearchActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "SearchWebSearchAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "open_page"
+ ],
+ "title": "OpenPageWebSearchActionType",
+ "type": "string"
+ },
+ "url": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "OpenPageWebSearchAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "pattern": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "find_in_page"
+ ],
+ "title": "FindInPageWebSearchActionType",
+ "type": "string"
+ },
+ "url": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "FindInPageWebSearchAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "other"
+ ],
+ "title": "OtherWebSearchActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "OtherWebSearchAction",
+ "type": "object"
+ }
+ ]
+ }
+ },
+ "properties": {
+ "conversationId": {
+ "$ref": "#/definitions/ThreadId"
+ },
+ "initialMessages": {
+ "items": {
+ "$ref": "#/definitions/EventMsg"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "model": {
+ "type": "string"
+ },
+ "rolloutPath": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "conversationId",
+ "model",
+ "rolloutPath"
+ ],
+ "title": "ResumeConversationResponse",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v1/SendUserMessageParams.json b/codex-rs/app-server-protocol/schema/json/v1/SendUserMessageParams.json
new file mode 100644
index 0000000000..1f53acc006
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v1/SendUserMessageParams.json
@@ -0,0 +1,165 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "definitions": {
+ "InputItem": {
+ "oneOf": [
+ {
+ "properties": {
+ "data": {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "text_elements": {
+ "default": [],
+ "description": "UI-defined spans within `text` used to render or persist special elements.",
+ "items": {
+ "$ref": "#/definitions/V1TextElement"
+ },
+ "type": "array"
+ }
+ },
+ "required": [
+ "text"
+ ],
+ "type": "object"
+ },
+ "type": {
+ "enum": [
+ "text"
+ ],
+ "title": "TextInputItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "data",
+ "type"
+ ],
+ "title": "TextInputItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "data": {
+ "properties": {
+ "image_url": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "image_url"
+ ],
+ "type": "object"
+ },
+ "type": {
+ "enum": [
+ "image"
+ ],
+ "title": "ImageInputItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "data",
+ "type"
+ ],
+ "title": "ImageInputItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "data": {
+ "properties": {
+ "path": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "path"
+ ],
+ "type": "object"
+ },
+ "type": {
+ "enum": [
+ "localImage"
+ ],
+ "title": "LocalImageInputItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "data",
+ "type"
+ ],
+ "title": "LocalImageInputItem",
+ "type": "object"
+ }
+ ]
+ },
+ "ThreadId": {
+ "type": "string"
+ },
+ "V1ByteRange": {
+ "properties": {
+ "end": {
+ "description": "End byte offset (exclusive) within the UTF-8 text buffer.",
+ "format": "uint",
+ "minimum": 0.0,
+ "type": "integer"
+ },
+ "start": {
+ "description": "Start byte offset (inclusive) within the UTF-8 text buffer.",
+ "format": "uint",
+ "minimum": 0.0,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "end",
+ "start"
+ ],
+ "type": "object"
+ },
+ "V1TextElement": {
+ "properties": {
+ "byteRange": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/V1ByteRange"
+ }
+ ],
+ "description": "Byte range in the parent `text` buffer that this element occupies."
+ },
+ "placeholder": {
+ "description": "Optional human-readable placeholder for the element, displayed in the UI.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "byteRange"
+ ],
+ "type": "object"
+ }
+ },
+ "properties": {
+ "conversationId": {
+ "$ref": "#/definitions/ThreadId"
+ },
+ "items": {
+ "items": {
+ "$ref": "#/definitions/InputItem"
+ },
+ "type": "array"
+ }
+ },
+ "required": [
+ "conversationId",
+ "items"
+ ],
+ "title": "SendUserMessageParams",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v1/SendUserMessageResponse.json b/codex-rs/app-server-protocol/schema/json/v1/SendUserMessageResponse.json
new file mode 100644
index 0000000000..df3df37c83
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v1/SendUserMessageResponse.json
@@ -0,0 +1,5 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "title": "SendUserMessageResponse",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v1/SendUserTurnParams.json b/codex-rs/app-server-protocol/schema/json/v1/SendUserTurnParams.json
new file mode 100644
index 0000000000..d56ae933bd
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v1/SendUserTurnParams.json
@@ -0,0 +1,379 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "definitions": {
+ "AbsolutePathBuf": {
+ "description": "A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem).\n\nIMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set, the deserialization will fail unless the path being deserialized is already absolute.",
+ "type": "string"
+ },
+ "AskForApproval": {
+ "description": "Determines the conditions under which the user is consulted to approve running the command proposed by Codex.",
+ "oneOf": [
+ {
+ "description": "Under this policy, only \"known safe\" commands—as determined by `is_safe_command()`—that **only read files** are auto‑approved. Everything else will ask the user to approve.",
+ "enum": [
+ "untrusted"
+ ],
+ "type": "string"
+ },
+ {
+ "description": "*All* commands are auto‑approved, but they are expected to run inside a sandbox where network access is disabled and writes are confined to a specific set of paths. If the command fails, it will be escalated to the user to approve execution without a sandbox.",
+ "enum": [
+ "on-failure"
+ ],
+ "type": "string"
+ },
+ {
+ "description": "The model decides when to ask the user for approval.",
+ "enum": [
+ "on-request"
+ ],
+ "type": "string"
+ },
+ {
+ "description": "Never ask the user to approve commands. Failures are immediately returned to the model, and never escalated to the user for approval.",
+ "enum": [
+ "never"
+ ],
+ "type": "string"
+ }
+ ]
+ },
+ "InputItem": {
+ "oneOf": [
+ {
+ "properties": {
+ "data": {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "text_elements": {
+ "default": [],
+ "description": "UI-defined spans within `text` used to render or persist special elements.",
+ "items": {
+ "$ref": "#/definitions/V1TextElement"
+ },
+ "type": "array"
+ }
+ },
+ "required": [
+ "text"
+ ],
+ "type": "object"
+ },
+ "type": {
+ "enum": [
+ "text"
+ ],
+ "title": "TextInputItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "data",
+ "type"
+ ],
+ "title": "TextInputItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "data": {
+ "properties": {
+ "image_url": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "image_url"
+ ],
+ "type": "object"
+ },
+ "type": {
+ "enum": [
+ "image"
+ ],
+ "title": "ImageInputItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "data",
+ "type"
+ ],
+ "title": "ImageInputItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "data": {
+ "properties": {
+ "path": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "path"
+ ],
+ "type": "object"
+ },
+ "type": {
+ "enum": [
+ "localImage"
+ ],
+ "title": "LocalImageInputItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "data",
+ "type"
+ ],
+ "title": "LocalImageInputItem",
+ "type": "object"
+ }
+ ]
+ },
+ "NetworkAccess": {
+ "description": "Represents whether outbound network access is available to the agent.",
+ "enum": [
+ "restricted",
+ "enabled"
+ ],
+ "type": "string"
+ },
+ "ReasoningEffort": {
+ "description": "See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#get-started-with-reasoning",
+ "enum": [
+ "none",
+ "minimal",
+ "low",
+ "medium",
+ "high",
+ "xhigh"
+ ],
+ "type": "string"
+ },
+ "ReasoningSummary": {
+ "description": "A summary of the reasoning performed by the model. This can be useful for debugging and understanding the model's reasoning process. See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#reasoning-summaries",
+ "oneOf": [
+ {
+ "enum": [
+ "auto",
+ "concise",
+ "detailed"
+ ],
+ "type": "string"
+ },
+ {
+ "description": "Option to disable reasoning summaries.",
+ "enum": [
+ "none"
+ ],
+ "type": "string"
+ }
+ ]
+ },
+ "SandboxPolicy": {
+ "description": "Determines execution restrictions for model shell commands.",
+ "oneOf": [
+ {
+ "description": "No restrictions whatsoever. Use with caution.",
+ "properties": {
+ "type": {
+ "enum": [
+ "danger-full-access"
+ ],
+ "title": "DangerFullAccessSandboxPolicyType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "DangerFullAccessSandboxPolicy",
+ "type": "object"
+ },
+ {
+ "description": "Read-only access to the entire file-system.",
+ "properties": {
+ "type": {
+ "enum": [
+ "read-only"
+ ],
+ "title": "ReadOnlySandboxPolicyType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "ReadOnlySandboxPolicy",
+ "type": "object"
+ },
+ {
+ "description": "Indicates the process is already in an external sandbox. Allows full disk access while honoring the provided network setting.",
+ "properties": {
+ "network_access": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/NetworkAccess"
+ }
+ ],
+ "default": "restricted",
+ "description": "Whether the external sandbox permits outbound network traffic."
+ },
+ "type": {
+ "enum": [
+ "external-sandbox"
+ ],
+ "title": "ExternalSandboxSandboxPolicyType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "ExternalSandboxSandboxPolicy",
+ "type": "object"
+ },
+ {
+ "description": "Same as `ReadOnly` but additionally grants write access to the current working directory (\"workspace\").",
+ "properties": {
+ "exclude_slash_tmp": {
+ "default": false,
+ "description": "When set to `true`, will NOT include the `/tmp` among the default writable roots on UNIX. Defaults to `false`.",
+ "type": "boolean"
+ },
+ "exclude_tmpdir_env_var": {
+ "default": false,
+ "description": "When set to `true`, will NOT include the per-user `TMPDIR` environment variable among the default writable roots. Defaults to `false`.",
+ "type": "boolean"
+ },
+ "network_access": {
+ "default": false,
+ "description": "When set to `true`, outbound network access is allowed. `false` by default.",
+ "type": "boolean"
+ },
+ "type": {
+ "enum": [
+ "workspace-write"
+ ],
+ "title": "WorkspaceWriteSandboxPolicyType",
+ "type": "string"
+ },
+ "writable_roots": {
+ "description": "Additional folders (beyond cwd and possibly TMPDIR) that should be writable from within the sandbox.",
+ "items": {
+ "$ref": "#/definitions/AbsolutePathBuf"
+ },
+ "type": "array"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "WorkspaceWriteSandboxPolicy",
+ "type": "object"
+ }
+ ]
+ },
+ "ThreadId": {
+ "type": "string"
+ },
+ "V1ByteRange": {
+ "properties": {
+ "end": {
+ "description": "End byte offset (exclusive) within the UTF-8 text buffer.",
+ "format": "uint",
+ "minimum": 0.0,
+ "type": "integer"
+ },
+ "start": {
+ "description": "Start byte offset (inclusive) within the UTF-8 text buffer.",
+ "format": "uint",
+ "minimum": 0.0,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "end",
+ "start"
+ ],
+ "type": "object"
+ },
+ "V1TextElement": {
+ "properties": {
+ "byteRange": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/V1ByteRange"
+ }
+ ],
+ "description": "Byte range in the parent `text` buffer that this element occupies."
+ },
+ "placeholder": {
+ "description": "Optional human-readable placeholder for the element, displayed in the UI.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "byteRange"
+ ],
+ "type": "object"
+ }
+ },
+ "properties": {
+ "approvalPolicy": {
+ "$ref": "#/definitions/AskForApproval"
+ },
+ "conversationId": {
+ "$ref": "#/definitions/ThreadId"
+ },
+ "cwd": {
+ "type": "string"
+ },
+ "effort": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ReasoningEffort"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "items": {
+ "items": {
+ "$ref": "#/definitions/InputItem"
+ },
+ "type": "array"
+ },
+ "model": {
+ "type": "string"
+ },
+ "outputSchema": {
+ "description": "Optional JSON Schema used to constrain the final assistant message for this turn."
+ },
+ "sandboxPolicy": {
+ "$ref": "#/definitions/SandboxPolicy"
+ },
+ "summary": {
+ "$ref": "#/definitions/ReasoningSummary"
+ }
+ },
+ "required": [
+ "approvalPolicy",
+ "conversationId",
+ "cwd",
+ "items",
+ "model",
+ "sandboxPolicy",
+ "summary"
+ ],
+ "title": "SendUserTurnParams",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v1/SendUserTurnResponse.json b/codex-rs/app-server-protocol/schema/json/v1/SendUserTurnResponse.json
new file mode 100644
index 0000000000..5dc36098ff
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v1/SendUserTurnResponse.json
@@ -0,0 +1,5 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "title": "SendUserTurnResponse",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v1/SessionConfiguredNotification.json b/codex-rs/app-server-protocol/schema/json/v1/SessionConfiguredNotification.json
new file mode 100644
index 0000000000..24e71bc27a
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v1/SessionConfiguredNotification.json
@@ -0,0 +1,5380 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "definitions": {
+ "AbsolutePathBuf": {
+ "description": "A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem).\n\nIMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set, the deserialization will fail unless the path being deserialized is already absolute.",
+ "type": "string"
+ },
+ "AgentMessageContent": {
+ "oneOf": [
+ {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "Text"
+ ],
+ "title": "TextAgentMessageContentType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "TextAgentMessageContent",
+ "type": "object"
+ }
+ ]
+ },
+ "AgentStatus": {
+ "description": "Agent lifecycle status, derived from emitted events.",
+ "oneOf": [
+ {
+ "description": "Agent is waiting for initialization.",
+ "enum": [
+ "pending_init"
+ ],
+ "type": "string"
+ },
+ {
+ "description": "Agent is currently running.",
+ "enum": [
+ "running"
+ ],
+ "type": "string"
+ },
+ {
+ "additionalProperties": false,
+ "description": "Agent is done. Contains the final assistant message.",
+ "properties": {
+ "completed": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "completed"
+ ],
+ "title": "CompletedAgentStatus",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "Agent encountered an error.",
+ "properties": {
+ "errored": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "errored"
+ ],
+ "title": "ErroredAgentStatus",
+ "type": "object"
+ },
+ {
+ "description": "Agent has been shutdown.",
+ "enum": [
+ "shutdown"
+ ],
+ "type": "string"
+ },
+ {
+ "description": "Agent is not found.",
+ "enum": [
+ "not_found"
+ ],
+ "type": "string"
+ }
+ ]
+ },
+ "Annotations": {
+ "description": "Optional annotations for the client. The client can use annotations to inform how objects are used or displayed",
+ "properties": {
+ "audience": {
+ "items": {
+ "$ref": "#/definitions/Role"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "lastModified": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "priority": {
+ "format": "double",
+ "type": [
+ "number",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "AskForApproval": {
+ "description": "Determines the conditions under which the user is consulted to approve running the command proposed by Codex.",
+ "oneOf": [
+ {
+ "description": "Under this policy, only \"known safe\" commands—as determined by `is_safe_command()`—that **only read files** are auto‑approved. Everything else will ask the user to approve.",
+ "enum": [
+ "untrusted"
+ ],
+ "type": "string"
+ },
+ {
+ "description": "*All* commands are auto‑approved, but they are expected to run inside a sandbox where network access is disabled and writes are confined to a specific set of paths. If the command fails, it will be escalated to the user to approve execution without a sandbox.",
+ "enum": [
+ "on-failure"
+ ],
+ "type": "string"
+ },
+ {
+ "description": "The model decides when to ask the user for approval.",
+ "enum": [
+ "on-request"
+ ],
+ "type": "string"
+ },
+ {
+ "description": "Never ask the user to approve commands. Failures are immediately returned to the model, and never escalated to the user for approval.",
+ "enum": [
+ "never"
+ ],
+ "type": "string"
+ }
+ ]
+ },
+ "AudioContent": {
+ "description": "Audio provided to or from an LLM.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "data": {
+ "type": "string"
+ },
+ "mimeType": {
+ "type": "string"
+ },
+ "type": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "data",
+ "mimeType",
+ "type"
+ ],
+ "type": "object"
+ },
+ "BlobResourceContents": {
+ "properties": {
+ "blob": {
+ "type": "string"
+ },
+ "mimeType": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "uri": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "blob",
+ "uri"
+ ],
+ "type": "object"
+ },
+ "ByteRange": {
+ "properties": {
+ "end": {
+ "description": "End byte offset (exclusive) within the UTF-8 text buffer.",
+ "format": "uint",
+ "minimum": 0.0,
+ "type": "integer"
+ },
+ "start": {
+ "description": "Start byte offset (inclusive) within the UTF-8 text buffer.",
+ "format": "uint",
+ "minimum": 0.0,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "end",
+ "start"
+ ],
+ "type": "object"
+ },
+ "CallToolResult": {
+ "description": "The server's response to a tool call.",
+ "properties": {
+ "content": {
+ "items": {
+ "$ref": "#/definitions/ContentBlock"
+ },
+ "type": "array"
+ },
+ "isError": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "structuredContent": true
+ },
+ "required": [
+ "content"
+ ],
+ "type": "object"
+ },
+ "CodexErrorInfo": {
+ "description": "Codex errors that we expose to clients.",
+ "oneOf": [
+ {
+ "enum": [
+ "context_window_exceeded",
+ "usage_limit_exceeded",
+ "internal_server_error",
+ "unauthorized",
+ "bad_request",
+ "sandbox_error",
+ "thread_rollback_failed",
+ "other"
+ ],
+ "type": "string"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "model_cap": {
+ "properties": {
+ "model": {
+ "type": "string"
+ },
+ "reset_after_seconds": {
+ "format": "uint64",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "model"
+ ],
+ "type": "object"
+ }
+ },
+ "required": [
+ "model_cap"
+ ],
+ "title": "ModelCapCodexErrorInfo",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "http_connection_failed": {
+ "properties": {
+ "http_status_code": {
+ "format": "uint16",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "http_connection_failed"
+ ],
+ "title": "HttpConnectionFailedCodexErrorInfo",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "Failed to connect to the response SSE stream.",
+ "properties": {
+ "response_stream_connection_failed": {
+ "properties": {
+ "http_status_code": {
+ "format": "uint16",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "response_stream_connection_failed"
+ ],
+ "title": "ResponseStreamConnectionFailedCodexErrorInfo",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "The response SSE stream disconnected in the middle of a turnbefore completion.",
+ "properties": {
+ "response_stream_disconnected": {
+ "properties": {
+ "http_status_code": {
+ "format": "uint16",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "response_stream_disconnected"
+ ],
+ "title": "ResponseStreamDisconnectedCodexErrorInfo",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "Reached the retry limit for responses.",
+ "properties": {
+ "response_too_many_failed_attempts": {
+ "properties": {
+ "http_status_code": {
+ "format": "uint16",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "response_too_many_failed_attempts"
+ ],
+ "title": "ResponseTooManyFailedAttemptsCodexErrorInfo",
+ "type": "object"
+ }
+ ]
+ },
+ "ContentBlock": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/TextContent"
+ },
+ {
+ "$ref": "#/definitions/ImageContent"
+ },
+ {
+ "$ref": "#/definitions/AudioContent"
+ },
+ {
+ "$ref": "#/definitions/ResourceLink"
+ },
+ {
+ "$ref": "#/definitions/EmbeddedResource"
+ }
+ ]
+ },
+ "ContentItem": {
+ "oneOf": [
+ {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "input_text"
+ ],
+ "title": "InputTextContentItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "InputTextContentItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "image_url": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "input_image"
+ ],
+ "title": "InputImageContentItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "image_url",
+ "type"
+ ],
+ "title": "InputImageContentItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "output_text"
+ ],
+ "title": "OutputTextContentItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "OutputTextContentItem",
+ "type": "object"
+ }
+ ]
+ },
+ "CreditsSnapshot": {
+ "properties": {
+ "balance": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "has_credits": {
+ "type": "boolean"
+ },
+ "unlimited": {
+ "type": "boolean"
+ }
+ },
+ "required": [
+ "has_credits",
+ "unlimited"
+ ],
+ "type": "object"
+ },
+ "CustomPrompt": {
+ "properties": {
+ "argument_hint": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "content": {
+ "type": "string"
+ },
+ "description": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "name": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "content",
+ "name",
+ "path"
+ ],
+ "type": "object"
+ },
+ "Duration": {
+ "properties": {
+ "nanos": {
+ "format": "uint32",
+ "minimum": 0.0,
+ "type": "integer"
+ },
+ "secs": {
+ "format": "uint64",
+ "minimum": 0.0,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "nanos",
+ "secs"
+ ],
+ "type": "object"
+ },
+ "EmbeddedResource": {
+ "description": "The contents of a resource, embedded into a prompt or tool call result.\n\nIt is up to the client how best to render embedded resources for the benefit of the LLM and/or the user.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "resource": {
+ "$ref": "#/definitions/EmbeddedResourceResource"
+ },
+ "type": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "resource",
+ "type"
+ ],
+ "type": "object"
+ },
+ "EmbeddedResourceResource": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/TextResourceContents"
+ },
+ {
+ "$ref": "#/definitions/BlobResourceContents"
+ }
+ ]
+ },
+ "EventMsg": {
+ "description": "Response event from the agent NOTE: Make sure none of these values have optional types, as it will mess up the extension code-gen.",
+ "oneOf": [
+ {
+ "description": "Error while executing a submission",
+ "properties": {
+ "codex_error_info": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/CodexErrorInfo"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "default": null
+ },
+ "message": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "error"
+ ],
+ "title": "ErrorEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "message",
+ "type"
+ ],
+ "title": "ErrorEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Warning issued while processing a submission. Unlike `Error`, this indicates the turn continued but the user should still be notified.",
+ "properties": {
+ "message": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "warning"
+ ],
+ "title": "WarningEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "message",
+ "type"
+ ],
+ "title": "WarningEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Conversation history was compacted (either automatically or manually).",
+ "properties": {
+ "type": {
+ "enum": [
+ "context_compacted"
+ ],
+ "title": "ContextCompactedEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "ContextCompactedEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Conversation history was rolled back by dropping the last N user turns.",
+ "properties": {
+ "num_turns": {
+ "description": "Number of user turns that were removed from context.",
+ "format": "uint32",
+ "minimum": 0.0,
+ "type": "integer"
+ },
+ "type": {
+ "enum": [
+ "thread_rolled_back"
+ ],
+ "title": "ThreadRolledBackEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "num_turns",
+ "type"
+ ],
+ "title": "ThreadRolledBackEventMsg",
+ "type": "object"
+ },
+ {
+ "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": "code"
+ },
+ "model_context_window": {
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "task_started"
+ ],
+ "title": "TaskStartedEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "TaskStartedEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Agent has completed all actions. v1 wire format uses `task_complete`; accept `turn_complete` for v2 interop.",
+ "properties": {
+ "last_agent_message": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "task_complete"
+ ],
+ "title": "TaskCompleteEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "TaskCompleteEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Usage update for the current session, including totals and last turn. Optional means unknown — UIs should not display when `None`.",
+ "properties": {
+ "info": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/TokenUsageInfo"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "rate_limits": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/RateLimitSnapshot"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "type": {
+ "enum": [
+ "token_count"
+ ],
+ "title": "TokenCountEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "TokenCountEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Agent text output message",
+ "properties": {
+ "message": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "agent_message"
+ ],
+ "title": "AgentMessageEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "message",
+ "type"
+ ],
+ "title": "AgentMessageEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "User/system input message (what was sent to the model)",
+ "properties": {
+ "images": {
+ "description": "Image URLs sourced from `UserInput::Image`. These are safe to replay in legacy UI history events and correspond to images sent to the model.",
+ "items": {
+ "type": "string"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "local_images": {
+ "default": [],
+ "description": "Local file paths sourced from `UserInput::LocalImage`. These are kept so the UI can reattach images when editing history, and should not be sent to the model or treated as API-ready URLs.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "message": {
+ "type": "string"
+ },
+ "text_elements": {
+ "default": [],
+ "description": "UI-defined spans within `message` used to render or persist special elements.",
+ "items": {
+ "$ref": "#/definitions/TextElement"
+ },
+ "type": "array"
+ },
+ "type": {
+ "enum": [
+ "user_message"
+ ],
+ "title": "UserMessageEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "message",
+ "type"
+ ],
+ "title": "UserMessageEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Agent text output delta message",
+ "properties": {
+ "delta": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "agent_message_delta"
+ ],
+ "title": "AgentMessageDeltaEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "delta",
+ "type"
+ ],
+ "title": "AgentMessageDeltaEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Reasoning event from agent.",
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "agent_reasoning"
+ ],
+ "title": "AgentReasoningEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "AgentReasoningEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Agent reasoning delta event from agent.",
+ "properties": {
+ "delta": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "agent_reasoning_delta"
+ ],
+ "title": "AgentReasoningDeltaEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "delta",
+ "type"
+ ],
+ "title": "AgentReasoningDeltaEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Raw chain-of-thought from agent.",
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "agent_reasoning_raw_content"
+ ],
+ "title": "AgentReasoningRawContentEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "AgentReasoningRawContentEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Agent reasoning content delta event from agent.",
+ "properties": {
+ "delta": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "agent_reasoning_raw_content_delta"
+ ],
+ "title": "AgentReasoningRawContentDeltaEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "delta",
+ "type"
+ ],
+ "title": "AgentReasoningRawContentDeltaEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Signaled when the model begins a new reasoning summary section (e.g., a new titled block).",
+ "properties": {
+ "item_id": {
+ "default": "",
+ "type": "string"
+ },
+ "summary_index": {
+ "default": 0,
+ "format": "int64",
+ "type": "integer"
+ },
+ "type": {
+ "enum": [
+ "agent_reasoning_section_break"
+ ],
+ "title": "AgentReasoningSectionBreakEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "AgentReasoningSectionBreakEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Ack the client's configure message.",
+ "properties": {
+ "approval_policy": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/AskForApproval"
+ }
+ ],
+ "description": "When to escalate for approval for execution"
+ },
+ "cwd": {
+ "description": "Working directory that should be treated as the *root* of the session.",
+ "type": "string"
+ },
+ "forked_from_id": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ThreadId"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "history_entry_count": {
+ "description": "Current number of entries in the history log.",
+ "format": "uint",
+ "minimum": 0.0,
+ "type": "integer"
+ },
+ "history_log_id": {
+ "description": "Identifier of the history log file (inode on Unix, 0 otherwise).",
+ "format": "uint64",
+ "minimum": 0.0,
+ "type": "integer"
+ },
+ "initial_messages": {
+ "description": "Optional initial messages (as events) for resumed sessions. When present, UIs can use these to seed the history.",
+ "items": {
+ "$ref": "#/definitions/EventMsg"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "model": {
+ "description": "Tell the client what model is being queried.",
+ "type": "string"
+ },
+ "model_provider_id": {
+ "type": "string"
+ },
+ "reasoning_effort": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ReasoningEffort"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "The effort the model is putting into reasoning about the user's request."
+ },
+ "rollout_path": {
+ "description": "Path in which the rollout is stored. Can be `None` for ephemeral threads",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "sandbox_policy": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/SandboxPolicy"
+ }
+ ],
+ "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"
+ ]
+ },
+ "type": {
+ "enum": [
+ "session_configured"
+ ],
+ "title": "SessionConfiguredEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "approval_policy",
+ "cwd",
+ "history_entry_count",
+ "history_log_id",
+ "model",
+ "model_provider_id",
+ "sandbox_policy",
+ "session_id",
+ "type"
+ ],
+ "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": {
+ "server": {
+ "description": "Server name being started.",
+ "type": "string"
+ },
+ "status": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/McpStartupStatus"
+ }
+ ],
+ "description": "Current startup status."
+ },
+ "type": {
+ "enum": [
+ "mcp_startup_update"
+ ],
+ "title": "McpStartupUpdateEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "server",
+ "status",
+ "type"
+ ],
+ "title": "McpStartupUpdateEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Aggregate MCP startup completion summary.",
+ "properties": {
+ "cancelled": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "failed": {
+ "items": {
+ "$ref": "#/definitions/McpStartupFailure"
+ },
+ "type": "array"
+ },
+ "ready": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "type": {
+ "enum": [
+ "mcp_startup_complete"
+ ],
+ "title": "McpStartupCompleteEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "cancelled",
+ "failed",
+ "ready",
+ "type"
+ ],
+ "title": "McpStartupCompleteEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "call_id": {
+ "description": "Identifier so this can be paired with the McpToolCallEnd event.",
+ "type": "string"
+ },
+ "invocation": {
+ "$ref": "#/definitions/McpInvocation"
+ },
+ "type": {
+ "enum": [
+ "mcp_tool_call_begin"
+ ],
+ "title": "McpToolCallBeginEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "invocation",
+ "type"
+ ],
+ "title": "McpToolCallBeginEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "call_id": {
+ "description": "Identifier for the corresponding McpToolCallBegin that finished.",
+ "type": "string"
+ },
+ "duration": {
+ "$ref": "#/definitions/Duration"
+ },
+ "invocation": {
+ "$ref": "#/definitions/McpInvocation"
+ },
+ "result": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/Result_of_CallToolResult_or_String"
+ }
+ ],
+ "description": "Result of the tool call. Note this could be an error."
+ },
+ "type": {
+ "enum": [
+ "mcp_tool_call_end"
+ ],
+ "title": "McpToolCallEndEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "duration",
+ "invocation",
+ "result",
+ "type"
+ ],
+ "title": "McpToolCallEndEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "call_id": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "web_search_begin"
+ ],
+ "title": "WebSearchBeginEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "type"
+ ],
+ "title": "WebSearchBeginEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "action": {
+ "$ref": "#/definitions/WebSearchAction"
+ },
+ "call_id": {
+ "type": "string"
+ },
+ "query": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "web_search_end"
+ ],
+ "title": "WebSearchEndEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "action",
+ "call_id",
+ "query",
+ "type"
+ ],
+ "title": "WebSearchEndEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Notification that the server is about to execute a command.",
+ "properties": {
+ "call_id": {
+ "description": "Identifier so this can be paired with the ExecCommandEnd event.",
+ "type": "string"
+ },
+ "command": {
+ "description": "The command to be executed.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "cwd": {
+ "description": "The command's working directory if not the default cwd for the agent.",
+ "type": "string"
+ },
+ "interaction_input": {
+ "description": "Raw input sent to a unified exec session (if this is an interaction event).",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "parsed_cmd": {
+ "items": {
+ "$ref": "#/definitions/ParsedCommand"
+ },
+ "type": "array"
+ },
+ "process_id": {
+ "description": "Identifier for the underlying PTY process (when available).",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "source": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ExecCommandSource"
+ }
+ ],
+ "default": "agent",
+ "description": "Where the command originated. Defaults to Agent for backward compatibility."
+ },
+ "turn_id": {
+ "description": "Turn ID that this command belongs to.",
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "exec_command_begin"
+ ],
+ "title": "ExecCommandBeginEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "command",
+ "cwd",
+ "parsed_cmd",
+ "turn_id",
+ "type"
+ ],
+ "title": "ExecCommandBeginEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Incremental chunk of output from a running command.",
+ "properties": {
+ "call_id": {
+ "description": "Identifier for the ExecCommandBegin that produced this chunk.",
+ "type": "string"
+ },
+ "chunk": {
+ "description": "Raw bytes from the stream (may not be valid UTF-8).",
+ "type": "string"
+ },
+ "stream": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ExecOutputStream"
+ }
+ ],
+ "description": "Which stream produced this chunk."
+ },
+ "type": {
+ "enum": [
+ "exec_command_output_delta"
+ ],
+ "title": "ExecCommandOutputDeltaEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "chunk",
+ "stream",
+ "type"
+ ],
+ "title": "ExecCommandOutputDeltaEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Terminal interaction for an in-progress command (stdin sent and stdout observed).",
+ "properties": {
+ "call_id": {
+ "description": "Identifier for the ExecCommandBegin that produced this chunk.",
+ "type": "string"
+ },
+ "process_id": {
+ "description": "Process id associated with the running command.",
+ "type": "string"
+ },
+ "stdin": {
+ "description": "Stdin sent to the running session.",
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "terminal_interaction"
+ ],
+ "title": "TerminalInteractionEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "process_id",
+ "stdin",
+ "type"
+ ],
+ "title": "TerminalInteractionEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "aggregated_output": {
+ "default": "",
+ "description": "Captured aggregated output",
+ "type": "string"
+ },
+ "call_id": {
+ "description": "Identifier for the ExecCommandBegin that finished.",
+ "type": "string"
+ },
+ "command": {
+ "description": "The command that was executed.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "cwd": {
+ "description": "The command's working directory if not the default cwd for the agent.",
+ "type": "string"
+ },
+ "duration": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/Duration"
+ }
+ ],
+ "description": "The duration of the command execution."
+ },
+ "exit_code": {
+ "description": "The command's exit code.",
+ "format": "int32",
+ "type": "integer"
+ },
+ "formatted_output": {
+ "description": "Formatted output from the command, as seen by the model.",
+ "type": "string"
+ },
+ "interaction_input": {
+ "description": "Raw input sent to a unified exec session (if this is an interaction event).",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "parsed_cmd": {
+ "items": {
+ "$ref": "#/definitions/ParsedCommand"
+ },
+ "type": "array"
+ },
+ "process_id": {
+ "description": "Identifier for the underlying PTY process (when available).",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "source": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ExecCommandSource"
+ }
+ ],
+ "default": "agent",
+ "description": "Where the command originated. Defaults to Agent for backward compatibility."
+ },
+ "stderr": {
+ "description": "Captured stderr",
+ "type": "string"
+ },
+ "stdout": {
+ "description": "Captured stdout",
+ "type": "string"
+ },
+ "turn_id": {
+ "description": "Turn ID that this command belongs to.",
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "exec_command_end"
+ ],
+ "title": "ExecCommandEndEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "command",
+ "cwd",
+ "duration",
+ "exit_code",
+ "formatted_output",
+ "parsed_cmd",
+ "stderr",
+ "stdout",
+ "turn_id",
+ "type"
+ ],
+ "title": "ExecCommandEndEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Notification that the agent attached a local image via the view_image tool.",
+ "properties": {
+ "call_id": {
+ "description": "Identifier for the originating tool call.",
+ "type": "string"
+ },
+ "path": {
+ "description": "Local filesystem path provided to the tool.",
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "view_image_tool_call"
+ ],
+ "title": "ViewImageToolCallEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "path",
+ "type"
+ ],
+ "title": "ViewImageToolCallEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "call_id": {
+ "description": "Identifier for the associated exec call, if available.",
+ "type": "string"
+ },
+ "command": {
+ "description": "The command to be executed.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "cwd": {
+ "description": "The command's working directory.",
+ "type": "string"
+ },
+ "parsed_cmd": {
+ "items": {
+ "$ref": "#/definitions/ParsedCommand"
+ },
+ "type": "array"
+ },
+ "proposed_execpolicy_amendment": {
+ "description": "Proposed execpolicy amendment that can be applied to allow future runs.",
+ "items": {
+ "type": "string"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "reason": {
+ "description": "Optional human-readable reason for the approval (e.g. retry without sandbox).",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "turn_id": {
+ "default": "",
+ "description": "Turn ID that this command belongs to. Uses `#[serde(default)]` for backwards compatibility.",
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "exec_approval_request"
+ ],
+ "title": "ExecApprovalRequestEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "command",
+ "cwd",
+ "parsed_cmd",
+ "type"
+ ],
+ "title": "ExecApprovalRequestEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "call_id": {
+ "description": "Responses API call id for the associated tool call, if available.",
+ "type": "string"
+ },
+ "questions": {
+ "items": {
+ "$ref": "#/definitions/RequestUserInputQuestion"
+ },
+ "type": "array"
+ },
+ "turn_id": {
+ "default": "",
+ "description": "Turn ID that this request belongs to. Uses `#[serde(default)]` for backwards compatibility.",
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "request_user_input"
+ ],
+ "title": "RequestUserInputEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "questions",
+ "type"
+ ],
+ "title": "RequestUserInputEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "arguments": true,
+ "callId": {
+ "type": "string"
+ },
+ "tool": {
+ "type": "string"
+ },
+ "turnId": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "dynamic_tool_call_request"
+ ],
+ "title": "DynamicToolCallRequestEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "arguments",
+ "callId",
+ "tool",
+ "turnId",
+ "type"
+ ],
+ "title": "DynamicToolCallRequestEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "$ref": "#/definitions/RequestId"
+ },
+ "message": {
+ "type": "string"
+ },
+ "server_name": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "elicitation_request"
+ ],
+ "title": "ElicitationRequestEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "message",
+ "server_name",
+ "type"
+ ],
+ "title": "ElicitationRequestEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "call_id": {
+ "description": "Responses API call id for the associated patch apply call, if available.",
+ "type": "string"
+ },
+ "changes": {
+ "additionalProperties": {
+ "$ref": "#/definitions/FileChange"
+ },
+ "type": "object"
+ },
+ "grant_root": {
+ "description": "When set, the agent is asking the user to allow writes under this root for the remainder of the session.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "reason": {
+ "description": "Optional explanatory reason (e.g. request for extra write access).",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "turn_id": {
+ "default": "",
+ "description": "Turn ID that this patch belongs to. Uses `#[serde(default)]` for backwards compatibility with older senders.",
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "apply_patch_approval_request"
+ ],
+ "title": "ApplyPatchApprovalRequestEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "changes",
+ "type"
+ ],
+ "title": "ApplyPatchApprovalRequestEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Notification advising the user that something they are using has been deprecated and should be phased out.",
+ "properties": {
+ "details": {
+ "description": "Optional extra guidance, such as migration steps or rationale.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "summary": {
+ "description": "Concise summary of what is deprecated.",
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "deprecation_notice"
+ ],
+ "title": "DeprecationNoticeEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "summary",
+ "type"
+ ],
+ "title": "DeprecationNoticeEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "message": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "background_event"
+ ],
+ "title": "BackgroundEventEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "message",
+ "type"
+ ],
+ "title": "BackgroundEventEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "message": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "undo_started"
+ ],
+ "title": "UndoStartedEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "UndoStartedEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "message": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "success": {
+ "type": "boolean"
+ },
+ "type": {
+ "enum": [
+ "undo_completed"
+ ],
+ "title": "UndoCompletedEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "success",
+ "type"
+ ],
+ "title": "UndoCompletedEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Notification that a model stream experienced an error or disconnect and the system is handling it (e.g., retrying with backoff).",
+ "properties": {
+ "additional_details": {
+ "default": null,
+ "description": "Optional details about the underlying stream failure (often the same human-readable message that is surfaced as the terminal error if retries are exhausted).",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "codex_error_info": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/CodexErrorInfo"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "default": null
+ },
+ "message": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "stream_error"
+ ],
+ "title": "StreamErrorEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "message",
+ "type"
+ ],
+ "title": "StreamErrorEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Notification that the agent is about to apply a code patch. Mirrors `ExecCommandBegin` so front‑ends can show progress indicators.",
+ "properties": {
+ "auto_approved": {
+ "description": "If true, there was no ApplyPatchApprovalRequest for this patch.",
+ "type": "boolean"
+ },
+ "call_id": {
+ "description": "Identifier so this can be paired with the PatchApplyEnd event.",
+ "type": "string"
+ },
+ "changes": {
+ "additionalProperties": {
+ "$ref": "#/definitions/FileChange"
+ },
+ "description": "The changes to be applied.",
+ "type": "object"
+ },
+ "turn_id": {
+ "default": "",
+ "description": "Turn ID that this patch belongs to. Uses `#[serde(default)]` for backwards compatibility.",
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "patch_apply_begin"
+ ],
+ "title": "PatchApplyBeginEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "auto_approved",
+ "call_id",
+ "changes",
+ "type"
+ ],
+ "title": "PatchApplyBeginEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Notification that a patch application has finished.",
+ "properties": {
+ "call_id": {
+ "description": "Identifier for the PatchApplyBegin that finished.",
+ "type": "string"
+ },
+ "changes": {
+ "additionalProperties": {
+ "$ref": "#/definitions/FileChange"
+ },
+ "default": {},
+ "description": "The changes that were applied (mirrors PatchApplyBeginEvent::changes).",
+ "type": "object"
+ },
+ "stderr": {
+ "description": "Captured stderr (parser errors, IO failures, etc.).",
+ "type": "string"
+ },
+ "stdout": {
+ "description": "Captured stdout (summary printed by apply_patch).",
+ "type": "string"
+ },
+ "success": {
+ "description": "Whether the patch was applied successfully.",
+ "type": "boolean"
+ },
+ "turn_id": {
+ "default": "",
+ "description": "Turn ID that this patch belongs to. Uses `#[serde(default)]` for backwards compatibility.",
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "patch_apply_end"
+ ],
+ "title": "PatchApplyEndEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "stderr",
+ "stdout",
+ "success",
+ "type"
+ ],
+ "title": "PatchApplyEndEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "turn_diff"
+ ],
+ "title": "TurnDiffEventMsgType",
+ "type": "string"
+ },
+ "unified_diff": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "unified_diff"
+ ],
+ "title": "TurnDiffEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Response to GetHistoryEntryRequest.",
+ "properties": {
+ "entry": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/HistoryEntry"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "The entry at the requested offset, if available and parseable."
+ },
+ "log_id": {
+ "format": "uint64",
+ "minimum": 0.0,
+ "type": "integer"
+ },
+ "offset": {
+ "format": "uint",
+ "minimum": 0.0,
+ "type": "integer"
+ },
+ "type": {
+ "enum": [
+ "get_history_entry_response"
+ ],
+ "title": "GetHistoryEntryResponseEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "log_id",
+ "offset",
+ "type"
+ ],
+ "title": "GetHistoryEntryResponseEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "List of MCP tools available to the agent.",
+ "properties": {
+ "auth_statuses": {
+ "additionalProperties": {
+ "$ref": "#/definitions/McpAuthStatus"
+ },
+ "description": "Authentication status for each configured MCP server.",
+ "type": "object"
+ },
+ "resource_templates": {
+ "additionalProperties": {
+ "items": {
+ "$ref": "#/definitions/ResourceTemplate"
+ },
+ "type": "array"
+ },
+ "description": "Known resource templates grouped by server name.",
+ "type": "object"
+ },
+ "resources": {
+ "additionalProperties": {
+ "items": {
+ "$ref": "#/definitions/Resource"
+ },
+ "type": "array"
+ },
+ "description": "Known resources grouped by server name.",
+ "type": "object"
+ },
+ "tools": {
+ "additionalProperties": {
+ "$ref": "#/definitions/Tool"
+ },
+ "description": "Fully qualified tool name -> tool definition.",
+ "type": "object"
+ },
+ "type": {
+ "enum": [
+ "mcp_list_tools_response"
+ ],
+ "title": "McpListToolsResponseEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "auth_statuses",
+ "resource_templates",
+ "resources",
+ "tools",
+ "type"
+ ],
+ "title": "McpListToolsResponseEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "List of custom prompts available to the agent.",
+ "properties": {
+ "custom_prompts": {
+ "items": {
+ "$ref": "#/definitions/CustomPrompt"
+ },
+ "type": "array"
+ },
+ "type": {
+ "enum": [
+ "list_custom_prompts_response"
+ ],
+ "title": "ListCustomPromptsResponseEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "custom_prompts",
+ "type"
+ ],
+ "title": "ListCustomPromptsResponseEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "List of skills available to the agent.",
+ "properties": {
+ "skills": {
+ "items": {
+ "$ref": "#/definitions/SkillsListEntry"
+ },
+ "type": "array"
+ },
+ "type": {
+ "enum": [
+ "list_skills_response"
+ ],
+ "title": "ListSkillsResponseEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "skills",
+ "type"
+ ],
+ "title": "ListSkillsResponseEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Notification that skill data may have been updated and clients may want to reload.",
+ "properties": {
+ "type": {
+ "enum": [
+ "skills_update_available"
+ ],
+ "title": "SkillsUpdateAvailableEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "SkillsUpdateAvailableEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "explanation": {
+ "default": null,
+ "description": "Arguments for the `update_plan` todo/checklist tool (not plan mode).",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "plan": {
+ "items": {
+ "$ref": "#/definitions/PlanItemArg"
+ },
+ "type": "array"
+ },
+ "type": {
+ "enum": [
+ "plan_update"
+ ],
+ "title": "PlanUpdateEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "plan",
+ "type"
+ ],
+ "title": "PlanUpdateEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "reason": {
+ "$ref": "#/definitions/TurnAbortReason"
+ },
+ "type": {
+ "enum": [
+ "turn_aborted"
+ ],
+ "title": "TurnAbortedEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "reason",
+ "type"
+ ],
+ "title": "TurnAbortedEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Notification that the agent is shutting down.",
+ "properties": {
+ "type": {
+ "enum": [
+ "shutdown_complete"
+ ],
+ "title": "ShutdownCompleteEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "ShutdownCompleteEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Entered review mode.",
+ "properties": {
+ "target": {
+ "$ref": "#/definitions/ReviewTarget"
+ },
+ "type": {
+ "enum": [
+ "entered_review_mode"
+ ],
+ "title": "EnteredReviewModeEventMsgType",
+ "type": "string"
+ },
+ "user_facing_hint": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "target",
+ "type"
+ ],
+ "title": "EnteredReviewModeEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Exited review mode with an optional final result to apply.",
+ "properties": {
+ "review_output": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ReviewOutputEvent"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "type": {
+ "enum": [
+ "exited_review_mode"
+ ],
+ "title": "ExitedReviewModeEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "ExitedReviewModeEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "item": {
+ "$ref": "#/definitions/ResponseItem"
+ },
+ "type": {
+ "enum": [
+ "raw_response_item"
+ ],
+ "title": "RawResponseItemEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "item",
+ "type"
+ ],
+ "title": "RawResponseItemEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "item": {
+ "$ref": "#/definitions/TurnItem"
+ },
+ "thread_id": {
+ "$ref": "#/definitions/ThreadId"
+ },
+ "turn_id": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "item_started"
+ ],
+ "title": "ItemStartedEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "item",
+ "thread_id",
+ "turn_id",
+ "type"
+ ],
+ "title": "ItemStartedEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "item": {
+ "$ref": "#/definitions/TurnItem"
+ },
+ "thread_id": {
+ "$ref": "#/definitions/ThreadId"
+ },
+ "turn_id": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "item_completed"
+ ],
+ "title": "ItemCompletedEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "item",
+ "thread_id",
+ "turn_id",
+ "type"
+ ],
+ "title": "ItemCompletedEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "delta": {
+ "type": "string"
+ },
+ "item_id": {
+ "type": "string"
+ },
+ "thread_id": {
+ "type": "string"
+ },
+ "turn_id": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "agent_message_content_delta"
+ ],
+ "title": "AgentMessageContentDeltaEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "delta",
+ "item_id",
+ "thread_id",
+ "turn_id",
+ "type"
+ ],
+ "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": {
+ "type": "string"
+ },
+ "item_id": {
+ "type": "string"
+ },
+ "summary_index": {
+ "default": 0,
+ "format": "int64",
+ "type": "integer"
+ },
+ "thread_id": {
+ "type": "string"
+ },
+ "turn_id": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "reasoning_content_delta"
+ ],
+ "title": "ReasoningContentDeltaEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "delta",
+ "item_id",
+ "thread_id",
+ "turn_id",
+ "type"
+ ],
+ "title": "ReasoningContentDeltaEventMsg",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "content_index": {
+ "default": 0,
+ "format": "int64",
+ "type": "integer"
+ },
+ "delta": {
+ "type": "string"
+ },
+ "item_id": {
+ "type": "string"
+ },
+ "thread_id": {
+ "type": "string"
+ },
+ "turn_id": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "reasoning_raw_content_delta"
+ ],
+ "title": "ReasoningRawContentDeltaEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "delta",
+ "item_id",
+ "thread_id",
+ "turn_id",
+ "type"
+ ],
+ "title": "ReasoningRawContentDeltaEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Collab interaction: agent spawn begin.",
+ "properties": {
+ "call_id": {
+ "description": "Identifier for the collab tool call.",
+ "type": "string"
+ },
+ "prompt": {
+ "description": "Initial prompt sent to the agent. Can be empty to prevent CoT leaking at the beginning.",
+ "type": "string"
+ },
+ "sender_thread_id": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ThreadId"
+ }
+ ],
+ "description": "Thread ID of the sender."
+ },
+ "type": {
+ "enum": [
+ "collab_agent_spawn_begin"
+ ],
+ "title": "CollabAgentSpawnBeginEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "prompt",
+ "sender_thread_id",
+ "type"
+ ],
+ "title": "CollabAgentSpawnBeginEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Collab interaction: agent spawn end.",
+ "properties": {
+ "call_id": {
+ "description": "Identifier for the collab tool call.",
+ "type": "string"
+ },
+ "new_thread_id": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ThreadId"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Thread ID of the newly spawned agent, if it was created."
+ },
+ "prompt": {
+ "description": "Initial prompt sent to the agent. Can be empty to prevent CoT leaking at the beginning.",
+ "type": "string"
+ },
+ "sender_thread_id": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ThreadId"
+ }
+ ],
+ "description": "Thread ID of the sender."
+ },
+ "status": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/AgentStatus"
+ }
+ ],
+ "description": "Last known status of the new agent reported to the sender agent."
+ },
+ "type": {
+ "enum": [
+ "collab_agent_spawn_end"
+ ],
+ "title": "CollabAgentSpawnEndEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "prompt",
+ "sender_thread_id",
+ "status",
+ "type"
+ ],
+ "title": "CollabAgentSpawnEndEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Collab interaction: agent interaction begin.",
+ "properties": {
+ "call_id": {
+ "description": "Identifier for the collab tool call.",
+ "type": "string"
+ },
+ "prompt": {
+ "description": "Prompt sent from the sender to the receiver. Can be empty to prevent CoT leaking at the beginning.",
+ "type": "string"
+ },
+ "receiver_thread_id": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ThreadId"
+ }
+ ],
+ "description": "Thread ID of the receiver."
+ },
+ "sender_thread_id": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ThreadId"
+ }
+ ],
+ "description": "Thread ID of the sender."
+ },
+ "type": {
+ "enum": [
+ "collab_agent_interaction_begin"
+ ],
+ "title": "CollabAgentInteractionBeginEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "prompt",
+ "receiver_thread_id",
+ "sender_thread_id",
+ "type"
+ ],
+ "title": "CollabAgentInteractionBeginEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Collab interaction: agent interaction end.",
+ "properties": {
+ "call_id": {
+ "description": "Identifier for the collab tool call.",
+ "type": "string"
+ },
+ "prompt": {
+ "description": "Prompt sent from the sender to the receiver. Can be empty to prevent CoT leaking at the beginning.",
+ "type": "string"
+ },
+ "receiver_thread_id": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ThreadId"
+ }
+ ],
+ "description": "Thread ID of the receiver."
+ },
+ "sender_thread_id": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ThreadId"
+ }
+ ],
+ "description": "Thread ID of the sender."
+ },
+ "status": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/AgentStatus"
+ }
+ ],
+ "description": "Last known status of the receiver agent reported to the sender agent."
+ },
+ "type": {
+ "enum": [
+ "collab_agent_interaction_end"
+ ],
+ "title": "CollabAgentInteractionEndEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "prompt",
+ "receiver_thread_id",
+ "sender_thread_id",
+ "status",
+ "type"
+ ],
+ "title": "CollabAgentInteractionEndEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Collab interaction: waiting begin.",
+ "properties": {
+ "call_id": {
+ "description": "ID of the waiting call.",
+ "type": "string"
+ },
+ "receiver_thread_ids": {
+ "description": "Thread ID of the receivers.",
+ "items": {
+ "$ref": "#/definitions/ThreadId"
+ },
+ "type": "array"
+ },
+ "sender_thread_id": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ThreadId"
+ }
+ ],
+ "description": "Thread ID of the sender."
+ },
+ "type": {
+ "enum": [
+ "collab_waiting_begin"
+ ],
+ "title": "CollabWaitingBeginEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "receiver_thread_ids",
+ "sender_thread_id",
+ "type"
+ ],
+ "title": "CollabWaitingBeginEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Collab interaction: waiting end.",
+ "properties": {
+ "call_id": {
+ "description": "ID of the waiting call.",
+ "type": "string"
+ },
+ "sender_thread_id": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ThreadId"
+ }
+ ],
+ "description": "Thread ID of the sender."
+ },
+ "statuses": {
+ "additionalProperties": {
+ "$ref": "#/definitions/AgentStatus"
+ },
+ "description": "Last known status of the receiver agents reported to the sender agent.",
+ "type": "object"
+ },
+ "type": {
+ "enum": [
+ "collab_waiting_end"
+ ],
+ "title": "CollabWaitingEndEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "sender_thread_id",
+ "statuses",
+ "type"
+ ],
+ "title": "CollabWaitingEndEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Collab interaction: close begin.",
+ "properties": {
+ "call_id": {
+ "description": "Identifier for the collab tool call.",
+ "type": "string"
+ },
+ "receiver_thread_id": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ThreadId"
+ }
+ ],
+ "description": "Thread ID of the receiver."
+ },
+ "sender_thread_id": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ThreadId"
+ }
+ ],
+ "description": "Thread ID of the sender."
+ },
+ "type": {
+ "enum": [
+ "collab_close_begin"
+ ],
+ "title": "CollabCloseBeginEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "receiver_thread_id",
+ "sender_thread_id",
+ "type"
+ ],
+ "title": "CollabCloseBeginEventMsg",
+ "type": "object"
+ },
+ {
+ "description": "Collab interaction: close end.",
+ "properties": {
+ "call_id": {
+ "description": "Identifier for the collab tool call.",
+ "type": "string"
+ },
+ "receiver_thread_id": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ThreadId"
+ }
+ ],
+ "description": "Thread ID of the receiver."
+ },
+ "sender_thread_id": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ThreadId"
+ }
+ ],
+ "description": "Thread ID of the sender."
+ },
+ "status": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/AgentStatus"
+ }
+ ],
+ "description": "Last known status of the receiver agent reported to the sender agent before the close."
+ },
+ "type": {
+ "enum": [
+ "collab_close_end"
+ ],
+ "title": "CollabCloseEndEventMsgType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "receiver_thread_id",
+ "sender_thread_id",
+ "status",
+ "type"
+ ],
+ "title": "CollabCloseEndEventMsg",
+ "type": "object"
+ }
+ ]
+ },
+ "ExecCommandSource": {
+ "enum": [
+ "agent",
+ "user_shell",
+ "unified_exec_startup",
+ "unified_exec_interaction"
+ ],
+ "type": "string"
+ },
+ "ExecOutputStream": {
+ "enum": [
+ "stdout",
+ "stderr"
+ ],
+ "type": "string"
+ },
+ "FileChange": {
+ "oneOf": [
+ {
+ "properties": {
+ "content": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "add"
+ ],
+ "title": "AddFileChangeType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "content",
+ "type"
+ ],
+ "title": "AddFileChange",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "content": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "delete"
+ ],
+ "title": "DeleteFileChangeType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "content",
+ "type"
+ ],
+ "title": "DeleteFileChange",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "move_path": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "update"
+ ],
+ "title": "UpdateFileChangeType",
+ "type": "string"
+ },
+ "unified_diff": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "unified_diff"
+ ],
+ "title": "UpdateFileChange",
+ "type": "object"
+ }
+ ]
+ },
+ "FunctionCallOutputContentItem": {
+ "description": "Responses API compatible content items that can be returned by a tool call. This is a subset of ContentItem with the types we support as function call outputs.",
+ "oneOf": [
+ {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "input_text"
+ ],
+ "title": "InputTextFunctionCallOutputContentItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "InputTextFunctionCallOutputContentItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "image_url": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "input_image"
+ ],
+ "title": "InputImageFunctionCallOutputContentItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "image_url",
+ "type"
+ ],
+ "title": "InputImageFunctionCallOutputContentItem",
+ "type": "object"
+ }
+ ]
+ },
+ "FunctionCallOutputPayload": {
+ "description": "The payload we send back to OpenAI when reporting a tool call result.\n\n`content` preserves the historical plain-string payload so downstream integrations (tests, logging, etc.) can keep treating tool output as `String`. When an MCP server returns richer data we additionally populate `content_items` with the structured form that the Responses/Chat Completions APIs understand.",
+ "properties": {
+ "content": {
+ "type": "string"
+ },
+ "content_items": {
+ "items": {
+ "$ref": "#/definitions/FunctionCallOutputContentItem"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "success": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "content"
+ ],
+ "type": "object"
+ },
+ "GhostCommit": {
+ "description": "Details of a ghost commit created from a repository state.",
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "parent": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "preexisting_untracked_dirs": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "preexisting_untracked_files": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ }
+ },
+ "required": [
+ "id",
+ "preexisting_untracked_dirs",
+ "preexisting_untracked_files"
+ ],
+ "type": "object"
+ },
+ "HistoryEntry": {
+ "properties": {
+ "conversation_id": {
+ "type": "string"
+ },
+ "text": {
+ "type": "string"
+ },
+ "ts": {
+ "format": "uint64",
+ "minimum": 0.0,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "conversation_id",
+ "text",
+ "ts"
+ ],
+ "type": "object"
+ },
+ "ImageContent": {
+ "description": "An image provided to or from an LLM.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "data": {
+ "type": "string"
+ },
+ "mimeType": {
+ "type": "string"
+ },
+ "type": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "data",
+ "mimeType",
+ "type"
+ ],
+ "type": "object"
+ },
+ "LocalShellAction": {
+ "oneOf": [
+ {
+ "properties": {
+ "command": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "env": {
+ "additionalProperties": {
+ "type": "string"
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "timeout_ms": {
+ "format": "uint64",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "exec"
+ ],
+ "title": "ExecLocalShellActionType",
+ "type": "string"
+ },
+ "user": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "working_directory": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "command",
+ "type"
+ ],
+ "title": "ExecLocalShellAction",
+ "type": "object"
+ }
+ ]
+ },
+ "LocalShellStatus": {
+ "enum": [
+ "completed",
+ "in_progress",
+ "incomplete"
+ ],
+ "type": "string"
+ },
+ "McpAuthStatus": {
+ "enum": [
+ "unsupported",
+ "not_logged_in",
+ "bearer_token",
+ "o_auth"
+ ],
+ "type": "string"
+ },
+ "McpInvocation": {
+ "properties": {
+ "arguments": {
+ "description": "Arguments to the tool call."
+ },
+ "server": {
+ "description": "Name of the MCP server as defined in the config.",
+ "type": "string"
+ },
+ "tool": {
+ "description": "Name of the tool as given by the MCP server.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "server",
+ "tool"
+ ],
+ "type": "object"
+ },
+ "McpStartupFailure": {
+ "properties": {
+ "error": {
+ "type": "string"
+ },
+ "server": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "error",
+ "server"
+ ],
+ "type": "object"
+ },
+ "McpStartupStatus": {
+ "oneOf": [
+ {
+ "properties": {
+ "state": {
+ "enum": [
+ "starting"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "state"
+ ],
+ "title": "StateMcpStartupStatus",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "state": {
+ "enum": [
+ "ready"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "state"
+ ],
+ "title": "StateMcpStartupStatus2",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "error": {
+ "type": "string"
+ },
+ "state": {
+ "enum": [
+ "failed"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "error",
+ "state"
+ ],
+ "type": "object"
+ },
+ {
+ "properties": {
+ "state": {
+ "enum": [
+ "cancelled"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "state"
+ ],
+ "title": "StateMcpStartupStatus3",
+ "type": "object"
+ }
+ ]
+ },
+ "ModeKind": {
+ "description": "Initial collaboration mode to use when the TUI starts.",
+ "enum": [
+ "plan",
+ "code",
+ "pair_programming",
+ "execute",
+ "custom"
+ ],
+ "type": "string"
+ },
+ "NetworkAccess": {
+ "description": "Represents whether outbound network access is available to the agent.",
+ "enum": [
+ "restricted",
+ "enabled"
+ ],
+ "type": "string"
+ },
+ "ParsedCommand": {
+ "oneOf": [
+ {
+ "properties": {
+ "cmd": {
+ "type": "string"
+ },
+ "name": {
+ "type": "string"
+ },
+ "path": {
+ "description": "(Best effort) Path to the file being read by the command. When possible, this is an absolute path, though when relative, it should be resolved against the `cwd`` that will be used to run the command to derive the absolute path.",
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "read"
+ ],
+ "title": "ReadParsedCommandType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "cmd",
+ "name",
+ "path",
+ "type"
+ ],
+ "title": "ReadParsedCommand",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "cmd": {
+ "type": "string"
+ },
+ "path": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "list_files"
+ ],
+ "title": "ListFilesParsedCommandType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "cmd",
+ "type"
+ ],
+ "title": "ListFilesParsedCommand",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "cmd": {
+ "type": "string"
+ },
+ "path": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "query": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "search"
+ ],
+ "title": "SearchParsedCommandType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "cmd",
+ "type"
+ ],
+ "title": "SearchParsedCommand",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "cmd": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "unknown"
+ ],
+ "title": "UnknownParsedCommandType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "cmd",
+ "type"
+ ],
+ "title": "UnknownParsedCommand",
+ "type": "object"
+ }
+ ]
+ },
+ "PlanItemArg": {
+ "additionalProperties": false,
+ "properties": {
+ "status": {
+ "$ref": "#/definitions/StepStatus"
+ },
+ "step": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "status",
+ "step"
+ ],
+ "type": "object"
+ },
+ "PlanType": {
+ "enum": [
+ "free",
+ "go",
+ "plus",
+ "pro",
+ "team",
+ "business",
+ "enterprise",
+ "edu",
+ "unknown"
+ ],
+ "type": "string"
+ },
+ "RateLimitSnapshot": {
+ "properties": {
+ "credits": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/CreditsSnapshot"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "plan_type": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/PlanType"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "primary": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/RateLimitWindow"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "secondary": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/RateLimitWindow"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "RateLimitWindow": {
+ "properties": {
+ "resets_at": {
+ "description": "Unix timestamp (seconds since epoch) when the window resets.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "used_percent": {
+ "description": "Percentage (0-100) of the window that has been consumed.",
+ "format": "double",
+ "type": "number"
+ },
+ "window_minutes": {
+ "description": "Rolling window duration, in minutes.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "used_percent"
+ ],
+ "type": "object"
+ },
+ "ReasoningEffort": {
+ "description": "See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#get-started-with-reasoning",
+ "enum": [
+ "none",
+ "minimal",
+ "low",
+ "medium",
+ "high",
+ "xhigh"
+ ],
+ "type": "string"
+ },
+ "ReasoningItemContent": {
+ "oneOf": [
+ {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "reasoning_text"
+ ],
+ "title": "ReasoningTextReasoningItemContentType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "ReasoningTextReasoningItemContent",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "text"
+ ],
+ "title": "TextReasoningItemContentType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "TextReasoningItemContent",
+ "type": "object"
+ }
+ ]
+ },
+ "ReasoningItemReasoningSummary": {
+ "oneOf": [
+ {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "summary_text"
+ ],
+ "title": "SummaryTextReasoningItemReasoningSummaryType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "SummaryTextReasoningItemReasoningSummary",
+ "type": "object"
+ }
+ ]
+ },
+ "RequestId": {
+ "anyOf": [
+ {
+ "type": "string"
+ },
+ {
+ "format": "int64",
+ "type": "integer"
+ }
+ ]
+ },
+ "RequestUserInputQuestion": {
+ "properties": {
+ "header": {
+ "type": "string"
+ },
+ "id": {
+ "type": "string"
+ },
+ "isOther": {
+ "default": false,
+ "type": "boolean"
+ },
+ "isSecret": {
+ "default": false,
+ "type": "boolean"
+ },
+ "options": {
+ "items": {
+ "$ref": "#/definitions/RequestUserInputQuestionOption"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "question": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "header",
+ "id",
+ "question"
+ ],
+ "type": "object"
+ },
+ "RequestUserInputQuestionOption": {
+ "properties": {
+ "description": {
+ "type": "string"
+ },
+ "label": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "description",
+ "label"
+ ],
+ "type": "object"
+ },
+ "Resource": {
+ "description": "A known resource that the server is capable of reading.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "description": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "mimeType": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "name": {
+ "type": "string"
+ },
+ "size": {
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "title": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "uri": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "uri"
+ ],
+ "type": "object"
+ },
+ "ResourceLink": {
+ "description": "A resource that the server is capable of reading, included in a prompt or tool call result.\n\nNote: resource links returned by tools are not guaranteed to appear in the results of `resources/list` requests.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "description": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "mimeType": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "name": {
+ "type": "string"
+ },
+ "size": {
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "title": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "type": "string"
+ },
+ "uri": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "type",
+ "uri"
+ ],
+ "type": "object"
+ },
+ "ResourceTemplate": {
+ "description": "A template description for resources available on the server.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "description": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "mimeType": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "name": {
+ "type": "string"
+ },
+ "title": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "uriTemplate": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "uriTemplate"
+ ],
+ "type": "object"
+ },
+ "ResponseItem": {
+ "oneOf": [
+ {
+ "properties": {
+ "content": {
+ "items": {
+ "$ref": "#/definitions/ContentItem"
+ },
+ "type": "array"
+ },
+ "end_turn": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "id": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "writeOnly": true
+ },
+ "role": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "message"
+ ],
+ "title": "MessageResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "content",
+ "role",
+ "type"
+ ],
+ "title": "MessageResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "content": {
+ "default": null,
+ "items": {
+ "$ref": "#/definitions/ReasoningItemContent"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "encrypted_content": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "id": {
+ "type": "string",
+ "writeOnly": true
+ },
+ "summary": {
+ "items": {
+ "$ref": "#/definitions/ReasoningItemReasoningSummary"
+ },
+ "type": "array"
+ },
+ "type": {
+ "enum": [
+ "reasoning"
+ ],
+ "title": "ReasoningResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "summary",
+ "type"
+ ],
+ "title": "ReasoningResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "action": {
+ "$ref": "#/definitions/LocalShellAction"
+ },
+ "call_id": {
+ "description": "Set when using the Responses API.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "id": {
+ "description": "Set when using the chat completions API.",
+ "type": [
+ "string",
+ "null"
+ ],
+ "writeOnly": true
+ },
+ "status": {
+ "$ref": "#/definitions/LocalShellStatus"
+ },
+ "type": {
+ "enum": [
+ "local_shell_call"
+ ],
+ "title": "LocalShellCallResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "action",
+ "status",
+ "type"
+ ],
+ "title": "LocalShellCallResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "arguments": {
+ "type": "string"
+ },
+ "call_id": {
+ "type": "string"
+ },
+ "id": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "writeOnly": true
+ },
+ "name": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "function_call"
+ ],
+ "title": "FunctionCallResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "arguments",
+ "call_id",
+ "name",
+ "type"
+ ],
+ "title": "FunctionCallResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "call_id": {
+ "type": "string"
+ },
+ "output": {
+ "$ref": "#/definitions/FunctionCallOutputPayload"
+ },
+ "type": {
+ "enum": [
+ "function_call_output"
+ ],
+ "title": "FunctionCallOutputResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "output",
+ "type"
+ ],
+ "title": "FunctionCallOutputResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "call_id": {
+ "type": "string"
+ },
+ "id": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "writeOnly": true
+ },
+ "input": {
+ "type": "string"
+ },
+ "name": {
+ "type": "string"
+ },
+ "status": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "custom_tool_call"
+ ],
+ "title": "CustomToolCallResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "input",
+ "name",
+ "type"
+ ],
+ "title": "CustomToolCallResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "call_id": {
+ "type": "string"
+ },
+ "output": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "custom_tool_call_output"
+ ],
+ "title": "CustomToolCallOutputResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "output",
+ "type"
+ ],
+ "title": "CustomToolCallOutputResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "action": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/WebSearchAction"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "id": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "writeOnly": true
+ },
+ "status": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "web_search_call"
+ ],
+ "title": "WebSearchCallResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "WebSearchCallResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "ghost_commit": {
+ "$ref": "#/definitions/GhostCommit"
+ },
+ "type": {
+ "enum": [
+ "ghost_snapshot"
+ ],
+ "title": "GhostSnapshotResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "ghost_commit",
+ "type"
+ ],
+ "title": "GhostSnapshotResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "encrypted_content": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "compaction"
+ ],
+ "title": "CompactionResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "encrypted_content",
+ "type"
+ ],
+ "title": "CompactionResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "other"
+ ],
+ "title": "OtherResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "OtherResponseItem",
+ "type": "object"
+ }
+ ]
+ },
+ "Result_of_CallToolResult_or_String": {
+ "oneOf": [
+ {
+ "properties": {
+ "Ok": {
+ "$ref": "#/definitions/CallToolResult"
+ }
+ },
+ "required": [
+ "Ok"
+ ],
+ "title": "OkResult_of_CallToolResult_or_String",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "Err": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "Err"
+ ],
+ "title": "ErrResult_of_CallToolResult_or_String",
+ "type": "object"
+ }
+ ]
+ },
+ "ReviewCodeLocation": {
+ "description": "Location of the code related to a review finding.",
+ "properties": {
+ "absolute_file_path": {
+ "type": "string"
+ },
+ "line_range": {
+ "$ref": "#/definitions/ReviewLineRange"
+ }
+ },
+ "required": [
+ "absolute_file_path",
+ "line_range"
+ ],
+ "type": "object"
+ },
+ "ReviewFinding": {
+ "description": "A single review finding describing an observed issue or recommendation.",
+ "properties": {
+ "body": {
+ "type": "string"
+ },
+ "code_location": {
+ "$ref": "#/definitions/ReviewCodeLocation"
+ },
+ "confidence_score": {
+ "format": "float",
+ "type": "number"
+ },
+ "priority": {
+ "format": "int32",
+ "type": "integer"
+ },
+ "title": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "body",
+ "code_location",
+ "confidence_score",
+ "priority",
+ "title"
+ ],
+ "type": "object"
+ },
+ "ReviewLineRange": {
+ "description": "Inclusive line range in a file associated with the finding.",
+ "properties": {
+ "end": {
+ "format": "uint32",
+ "minimum": 0.0,
+ "type": "integer"
+ },
+ "start": {
+ "format": "uint32",
+ "minimum": 0.0,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "end",
+ "start"
+ ],
+ "type": "object"
+ },
+ "ReviewOutputEvent": {
+ "description": "Structured review result produced by a child review session.",
+ "properties": {
+ "findings": {
+ "items": {
+ "$ref": "#/definitions/ReviewFinding"
+ },
+ "type": "array"
+ },
+ "overall_confidence_score": {
+ "format": "float",
+ "type": "number"
+ },
+ "overall_correctness": {
+ "type": "string"
+ },
+ "overall_explanation": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "findings",
+ "overall_confidence_score",
+ "overall_correctness",
+ "overall_explanation"
+ ],
+ "type": "object"
+ },
+ "ReviewTarget": {
+ "oneOf": [
+ {
+ "description": "Review the working tree: staged, unstaged, and untracked files.",
+ "properties": {
+ "type": {
+ "enum": [
+ "uncommittedChanges"
+ ],
+ "title": "UncommittedChangesReviewTargetType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "UncommittedChangesReviewTarget",
+ "type": "object"
+ },
+ {
+ "description": "Review changes between the current branch and the given base branch.",
+ "properties": {
+ "branch": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "baseBranch"
+ ],
+ "title": "BaseBranchReviewTargetType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "branch",
+ "type"
+ ],
+ "title": "BaseBranchReviewTarget",
+ "type": "object"
+ },
+ {
+ "description": "Review the changes introduced by a specific commit.",
+ "properties": {
+ "sha": {
+ "type": "string"
+ },
+ "title": {
+ "description": "Optional human-readable label (e.g., commit subject) for UIs.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "commit"
+ ],
+ "title": "CommitReviewTargetType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "sha",
+ "type"
+ ],
+ "title": "CommitReviewTarget",
+ "type": "object"
+ },
+ {
+ "description": "Arbitrary instructions provided by the user.",
+ "properties": {
+ "instructions": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "custom"
+ ],
+ "title": "CustomReviewTargetType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "instructions",
+ "type"
+ ],
+ "title": "CustomReviewTarget",
+ "type": "object"
+ }
+ ]
+ },
+ "Role": {
+ "description": "The sender or recipient of messages and data in a conversation.",
+ "enum": [
+ "assistant",
+ "user"
+ ],
+ "type": "string"
+ },
+ "SandboxPolicy": {
+ "description": "Determines execution restrictions for model shell commands.",
+ "oneOf": [
+ {
+ "description": "No restrictions whatsoever. Use with caution.",
+ "properties": {
+ "type": {
+ "enum": [
+ "danger-full-access"
+ ],
+ "title": "DangerFullAccessSandboxPolicyType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "DangerFullAccessSandboxPolicy",
+ "type": "object"
+ },
+ {
+ "description": "Read-only access to the entire file-system.",
+ "properties": {
+ "type": {
+ "enum": [
+ "read-only"
+ ],
+ "title": "ReadOnlySandboxPolicyType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "ReadOnlySandboxPolicy",
+ "type": "object"
+ },
+ {
+ "description": "Indicates the process is already in an external sandbox. Allows full disk access while honoring the provided network setting.",
+ "properties": {
+ "network_access": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/NetworkAccess"
+ }
+ ],
+ "default": "restricted",
+ "description": "Whether the external sandbox permits outbound network traffic."
+ },
+ "type": {
+ "enum": [
+ "external-sandbox"
+ ],
+ "title": "ExternalSandboxSandboxPolicyType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "ExternalSandboxSandboxPolicy",
+ "type": "object"
+ },
+ {
+ "description": "Same as `ReadOnly` but additionally grants write access to the current working directory (\"workspace\").",
+ "properties": {
+ "exclude_slash_tmp": {
+ "default": false,
+ "description": "When set to `true`, will NOT include the `/tmp` among the default writable roots on UNIX. Defaults to `false`.",
+ "type": "boolean"
+ },
+ "exclude_tmpdir_env_var": {
+ "default": false,
+ "description": "When set to `true`, will NOT include the per-user `TMPDIR` environment variable among the default writable roots. Defaults to `false`.",
+ "type": "boolean"
+ },
+ "network_access": {
+ "default": false,
+ "description": "When set to `true`, outbound network access is allowed. `false` by default.",
+ "type": "boolean"
+ },
+ "type": {
+ "enum": [
+ "workspace-write"
+ ],
+ "title": "WorkspaceWriteSandboxPolicyType",
+ "type": "string"
+ },
+ "writable_roots": {
+ "description": "Additional folders (beyond cwd and possibly TMPDIR) that should be writable from within the sandbox.",
+ "items": {
+ "$ref": "#/definitions/AbsolutePathBuf"
+ },
+ "type": "array"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "WorkspaceWriteSandboxPolicy",
+ "type": "object"
+ }
+ ]
+ },
+ "SkillDependencies": {
+ "properties": {
+ "tools": {
+ "items": {
+ "$ref": "#/definitions/SkillToolDependency"
+ },
+ "type": "array"
+ }
+ },
+ "required": [
+ "tools"
+ ],
+ "type": "object"
+ },
+ "SkillErrorInfo": {
+ "properties": {
+ "message": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "message",
+ "path"
+ ],
+ "type": "object"
+ },
+ "SkillInterface": {
+ "properties": {
+ "brand_color": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "default_prompt": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "display_name": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "icon_large": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "icon_small": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "short_description": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "SkillMetadata": {
+ "properties": {
+ "dependencies": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/SkillDependencies"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "description": {
+ "type": "string"
+ },
+ "enabled": {
+ "type": "boolean"
+ },
+ "interface": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/SkillInterface"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "name": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "scope": {
+ "$ref": "#/definitions/SkillScope"
+ },
+ "short_description": {
+ "description": "Legacy short_description from SKILL.md. Prefer SKILL.json interface.short_description.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "description",
+ "enabled",
+ "name",
+ "path",
+ "scope"
+ ],
+ "type": "object"
+ },
+ "SkillScope": {
+ "enum": [
+ "user",
+ "repo",
+ "system",
+ "admin"
+ ],
+ "type": "string"
+ },
+ "SkillToolDependency": {
+ "properties": {
+ "command": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "description": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "transport": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "type": "string"
+ },
+ "url": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "value": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "value"
+ ],
+ "type": "object"
+ },
+ "SkillsListEntry": {
+ "properties": {
+ "cwd": {
+ "type": "string"
+ },
+ "errors": {
+ "items": {
+ "$ref": "#/definitions/SkillErrorInfo"
+ },
+ "type": "array"
+ },
+ "skills": {
+ "items": {
+ "$ref": "#/definitions/SkillMetadata"
+ },
+ "type": "array"
+ }
+ },
+ "required": [
+ "cwd",
+ "errors",
+ "skills"
+ ],
+ "type": "object"
+ },
+ "StepStatus": {
+ "enum": [
+ "pending",
+ "in_progress",
+ "completed"
+ ],
+ "type": "string"
+ },
+ "TextContent": {
+ "description": "Text provided to or from an LLM.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "type": "object"
+ },
+ "TextElement": {
+ "properties": {
+ "byte_range": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ByteRange"
+ }
+ ],
+ "description": "Byte range in the parent `text` buffer that this element occupies."
+ },
+ "placeholder": {
+ "description": "Optional human-readable placeholder for the element, displayed in the UI.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "byte_range"
+ ],
+ "type": "object"
+ },
+ "TextResourceContents": {
+ "properties": {
+ "mimeType": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "text": {
+ "type": "string"
+ },
+ "uri": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "uri"
+ ],
+ "type": "object"
+ },
+ "ThreadId": {
+ "type": "string"
+ },
+ "TokenUsage": {
+ "properties": {
+ "cached_input_tokens": {
+ "format": "int64",
+ "type": "integer"
+ },
+ "input_tokens": {
+ "format": "int64",
+ "type": "integer"
+ },
+ "output_tokens": {
+ "format": "int64",
+ "type": "integer"
+ },
+ "reasoning_output_tokens": {
+ "format": "int64",
+ "type": "integer"
+ },
+ "total_tokens": {
+ "format": "int64",
+ "type": "integer"
+ }
+ },
+ "required": [
+ "cached_input_tokens",
+ "input_tokens",
+ "output_tokens",
+ "reasoning_output_tokens",
+ "total_tokens"
+ ],
+ "type": "object"
+ },
+ "TokenUsageInfo": {
+ "properties": {
+ "last_token_usage": {
+ "$ref": "#/definitions/TokenUsage"
+ },
+ "model_context_window": {
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "total_token_usage": {
+ "$ref": "#/definitions/TokenUsage"
+ }
+ },
+ "required": [
+ "last_token_usage",
+ "total_token_usage"
+ ],
+ "type": "object"
+ },
+ "Tool": {
+ "description": "Definition for a tool the client can call.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ToolAnnotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "description": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "inputSchema": {
+ "$ref": "#/definitions/ToolInputSchema"
+ },
+ "name": {
+ "type": "string"
+ },
+ "outputSchema": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ToolOutputSchema"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "title": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "inputSchema",
+ "name"
+ ],
+ "type": "object"
+ },
+ "ToolAnnotations": {
+ "description": "Additional properties describing a Tool to clients.\n\nNOTE: all properties in ToolAnnotations are **hints**. They are not guaranteed to provide a faithful description of tool behavior (including descriptive properties like `title`).\n\nClients should never make tool use decisions based on ToolAnnotations received from untrusted servers.",
+ "properties": {
+ "destructiveHint": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "idempotentHint": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "openWorldHint": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "readOnlyHint": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "title": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "ToolInputSchema": {
+ "description": "A JSON Schema object defining the expected parameters for the tool.",
+ "properties": {
+ "properties": true,
+ "required": {
+ "items": {
+ "type": "string"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "type": {
+ "default": "object",
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "ToolOutputSchema": {
+ "description": "An optional JSON Schema object defining the structure of the tool's output returned in the structuredContent field of a CallToolResult.",
+ "properties": {
+ "properties": true,
+ "required": {
+ "items": {
+ "type": "string"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "type": {
+ "default": "object",
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "TurnAbortReason": {
+ "enum": [
+ "interrupted",
+ "replaced",
+ "review_ended"
+ ],
+ "type": "string"
+ },
+ "TurnItem": {
+ "oneOf": [
+ {
+ "properties": {
+ "content": {
+ "items": {
+ "$ref": "#/definitions/UserInput"
+ },
+ "type": "array"
+ },
+ "id": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "UserMessage"
+ ],
+ "title": "UserMessageTurnItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "content",
+ "id",
+ "type"
+ ],
+ "title": "UserMessageTurnItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "content": {
+ "items": {
+ "$ref": "#/definitions/AgentMessageContent"
+ },
+ "type": "array"
+ },
+ "id": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "AgentMessage"
+ ],
+ "title": "AgentMessageTurnItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "content",
+ "id",
+ "type"
+ ],
+ "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": {
+ "type": "string"
+ },
+ "raw_content": {
+ "default": [],
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "summary_text": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "type": {
+ "enum": [
+ "Reasoning"
+ ],
+ "title": "ReasoningTurnItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "summary_text",
+ "type"
+ ],
+ "title": "ReasoningTurnItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "action": {
+ "$ref": "#/definitions/WebSearchAction"
+ },
+ "id": {
+ "type": "string"
+ },
+ "query": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "WebSearch"
+ ],
+ "title": "WebSearchTurnItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "action",
+ "id",
+ "query",
+ "type"
+ ],
+ "title": "WebSearchTurnItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "ContextCompaction"
+ ],
+ "title": "ContextCompactionTurnItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "type"
+ ],
+ "title": "ContextCompactionTurnItem",
+ "type": "object"
+ }
+ ]
+ },
+ "UserInput": {
+ "description": "User input",
+ "oneOf": [
+ {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "text_elements": {
+ "default": [],
+ "description": "UI-defined spans within `text` that should be treated as special elements. These are byte ranges into the UTF-8 `text` buffer and are used to render or persist rich input markers (e.g., image placeholders) across history and resume without mutating the literal text.",
+ "items": {
+ "$ref": "#/definitions/TextElement"
+ },
+ "type": "array"
+ },
+ "type": {
+ "enum": [
+ "text"
+ ],
+ "title": "TextUserInputType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "TextUserInput",
+ "type": "object"
+ },
+ {
+ "description": "Pre‑encoded data: URI image.",
+ "properties": {
+ "image_url": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "image"
+ ],
+ "title": "ImageUserInputType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "image_url",
+ "type"
+ ],
+ "title": "ImageUserInput",
+ "type": "object"
+ },
+ {
+ "description": "Local image path provided by the user. This will be converted to an `Image` variant (base64 data URL) during request serialization.",
+ "properties": {
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "local_image"
+ ],
+ "title": "LocalImageUserInputType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "path",
+ "type"
+ ],
+ "title": "LocalImageUserInput",
+ "type": "object"
+ },
+ {
+ "description": "Skill selected by the user (name + path to SKILL.md).",
+ "properties": {
+ "name": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "skill"
+ ],
+ "title": "SkillUserInputType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "path",
+ "type"
+ ],
+ "title": "SkillUserInput",
+ "type": "object"
+ },
+ {
+ "description": "Explicit mention selected by the user (name + app://connector id).",
+ "properties": {
+ "name": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "mention"
+ ],
+ "title": "MentionUserInputType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "path",
+ "type"
+ ],
+ "title": "MentionUserInput",
+ "type": "object"
+ }
+ ]
+ },
+ "WebSearchAction": {
+ "oneOf": [
+ {
+ "properties": {
+ "queries": {
+ "items": {
+ "type": "string"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "query": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "search"
+ ],
+ "title": "SearchWebSearchActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "SearchWebSearchAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "open_page"
+ ],
+ "title": "OpenPageWebSearchActionType",
+ "type": "string"
+ },
+ "url": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "OpenPageWebSearchAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "pattern": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "find_in_page"
+ ],
+ "title": "FindInPageWebSearchActionType",
+ "type": "string"
+ },
+ "url": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "FindInPageWebSearchAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "other"
+ ],
+ "title": "OtherWebSearchActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "OtherWebSearchAction",
+ "type": "object"
+ }
+ ]
+ }
+ },
+ "properties": {
+ "historyEntryCount": {
+ "format": "uint",
+ "minimum": 0.0,
+ "type": "integer"
+ },
+ "historyLogId": {
+ "format": "uint64",
+ "minimum": 0.0,
+ "type": "integer"
+ },
+ "initialMessages": {
+ "items": {
+ "$ref": "#/definitions/EventMsg"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "model": {
+ "type": "string"
+ },
+ "reasoningEffort": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ReasoningEffort"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "rolloutPath": {
+ "type": "string"
+ },
+ "sessionId": {
+ "$ref": "#/definitions/ThreadId"
+ }
+ },
+ "required": [
+ "historyEntryCount",
+ "historyLogId",
+ "model",
+ "rolloutPath",
+ "sessionId"
+ ],
+ "title": "SessionConfiguredNotification",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v1/SetDefaultModelParams.json b/codex-rs/app-server-protocol/schema/json/v1/SetDefaultModelParams.json
new file mode 100644
index 0000000000..3027420212
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v1/SetDefaultModelParams.json
@@ -0,0 +1,37 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "definitions": {
+ "ReasoningEffort": {
+ "description": "See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#get-started-with-reasoning",
+ "enum": [
+ "none",
+ "minimal",
+ "low",
+ "medium",
+ "high",
+ "xhigh"
+ ],
+ "type": "string"
+ }
+ },
+ "properties": {
+ "model": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "reasoningEffort": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ReasoningEffort"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ }
+ },
+ "title": "SetDefaultModelParams",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v1/SetDefaultModelResponse.json b/codex-rs/app-server-protocol/schema/json/v1/SetDefaultModelResponse.json
new file mode 100644
index 0000000000..bb61dada65
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v1/SetDefaultModelResponse.json
@@ -0,0 +1,5 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "title": "SetDefaultModelResponse",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v1/UserInfoResponse.json b/codex-rs/app-server-protocol/schema/json/v1/UserInfoResponse.json
new file mode 100644
index 0000000000..617f6b6706
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v1/UserInfoResponse.json
@@ -0,0 +1,13 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "allegedUserEmail": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "title": "UserInfoResponse",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v2/AccountLoginCompletedNotification.json b/codex-rs/app-server-protocol/schema/json/v2/AccountLoginCompletedNotification.json
new file mode 100644
index 0000000000..128cb643ab
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v2/AccountLoginCompletedNotification.json
@@ -0,0 +1,25 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "error": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "loginId": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "success": {
+ "type": "boolean"
+ }
+ },
+ "required": [
+ "success"
+ ],
+ "title": "AccountLoginCompletedNotification",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v2/AccountRateLimitsUpdatedNotification.json b/codex-rs/app-server-protocol/schema/json/v2/AccountRateLimitsUpdatedNotification.json
new file mode 100644
index 0000000000..d168911bdf
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v2/AccountRateLimitsUpdatedNotification.json
@@ -0,0 +1,121 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "definitions": {
+ "CreditsSnapshot": {
+ "properties": {
+ "balance": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "hasCredits": {
+ "type": "boolean"
+ },
+ "unlimited": {
+ "type": "boolean"
+ }
+ },
+ "required": [
+ "hasCredits",
+ "unlimited"
+ ],
+ "type": "object"
+ },
+ "PlanType": {
+ "enum": [
+ "free",
+ "go",
+ "plus",
+ "pro",
+ "team",
+ "business",
+ "enterprise",
+ "edu",
+ "unknown"
+ ],
+ "type": "string"
+ },
+ "RateLimitSnapshot": {
+ "properties": {
+ "credits": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/CreditsSnapshot"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "planType": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/PlanType"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "primary": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/RateLimitWindow"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "secondary": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/RateLimitWindow"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "RateLimitWindow": {
+ "properties": {
+ "resetsAt": {
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "usedPercent": {
+ "format": "int32",
+ "type": "integer"
+ },
+ "windowDurationMins": {
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "usedPercent"
+ ],
+ "type": "object"
+ }
+ },
+ "properties": {
+ "rateLimits": {
+ "$ref": "#/definitions/RateLimitSnapshot"
+ }
+ },
+ "required": [
+ "rateLimits"
+ ],
+ "title": "AccountRateLimitsUpdatedNotification",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v2/AccountUpdatedNotification.json b/codex-rs/app-server-protocol/schema/json/v2/AccountUpdatedNotification.json
new file mode 100644
index 0000000000..d95d737060
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v2/AccountUpdatedNotification.json
@@ -0,0 +1,45 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "definitions": {
+ "AuthMode": {
+ "description": "Authentication mode for OpenAI-backed providers.",
+ "oneOf": [
+ {
+ "description": "OpenAI API key provided by the caller and stored by Codex.",
+ "enum": [
+ "apikey"
+ ],
+ "type": "string"
+ },
+ {
+ "description": "ChatGPT OAuth managed by Codex (tokens persisted and refreshed by Codex).",
+ "enum": [
+ "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"
+ }
+ ]
+ }
+ },
+ "properties": {
+ "authMode": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/AuthMode"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ }
+ },
+ "title": "AccountUpdatedNotification",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v2/AgentMessageDeltaNotification.json b/codex-rs/app-server-protocol/schema/json/v2/AgentMessageDeltaNotification.json
new file mode 100644
index 0000000000..09510d95cf
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v2/AgentMessageDeltaNotification.json
@@ -0,0 +1,25 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "delta": {
+ "type": "string"
+ },
+ "itemId": {
+ "type": "string"
+ },
+ "threadId": {
+ "type": "string"
+ },
+ "turnId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "delta",
+ "itemId",
+ "threadId",
+ "turnId"
+ ],
+ "title": "AgentMessageDeltaNotification",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v2/AppsListParams.json b/codex-rs/app-server-protocol/schema/json/v2/AppsListParams.json
new file mode 100644
index 0000000000..3625f7b30b
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v2/AppsListParams.json
@@ -0,0 +1,23 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "cursor": {
+ "description": "Opaque pagination cursor returned by a previous call.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "limit": {
+ "description": "Optional page size; defaults to a reasonable server-side value.",
+ "format": "uint32",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "title": "AppsListParams",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v2/AppsListResponse.json b/codex-rs/app-server-protocol/schema/json/v2/AppsListResponse.json
new file mode 100644
index 0000000000..f5cac70771
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v2/AppsListResponse.json
@@ -0,0 +1,74 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "definitions": {
+ "AppInfo": {
+ "properties": {
+ "description": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "distributionChannel": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "id": {
+ "type": "string"
+ },
+ "installUrl": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "isAccessible": {
+ "default": false,
+ "type": "boolean"
+ },
+ "logoUrl": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "logoUrlDark": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "name": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "name"
+ ],
+ "type": "object"
+ }
+ },
+ "properties": {
+ "data": {
+ "items": {
+ "$ref": "#/definitions/AppInfo"
+ },
+ "type": "array"
+ },
+ "nextCursor": {
+ "description": "Opaque cursor to pass to the next call to continue after the last item. If None, there are no more items to return.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "data"
+ ],
+ "title": "AppsListResponse",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v2/CancelLoginAccountParams.json b/codex-rs/app-server-protocol/schema/json/v2/CancelLoginAccountParams.json
new file mode 100644
index 0000000000..22c9a2ac3c
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v2/CancelLoginAccountParams.json
@@ -0,0 +1,13 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "loginId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "loginId"
+ ],
+ "title": "CancelLoginAccountParams",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v2/CancelLoginAccountResponse.json b/codex-rs/app-server-protocol/schema/json/v2/CancelLoginAccountResponse.json
new file mode 100644
index 0000000000..23df186da4
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v2/CancelLoginAccountResponse.json
@@ -0,0 +1,22 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "definitions": {
+ "CancelLoginAccountStatus": {
+ "enum": [
+ "canceled",
+ "notFound"
+ ],
+ "type": "string"
+ }
+ },
+ "properties": {
+ "status": {
+ "$ref": "#/definitions/CancelLoginAccountStatus"
+ }
+ },
+ "required": [
+ "status"
+ ],
+ "title": "CancelLoginAccountResponse",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v2/CommandExecParams.json b/codex-rs/app-server-protocol/schema/json/v2/CommandExecParams.json
new file mode 100644
index 0000000000..6dd8fb7bc8
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v2/CommandExecParams.json
@@ -0,0 +1,147 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "definitions": {
+ "AbsolutePathBuf": {
+ "description": "A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem).\n\nIMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set, the deserialization will fail unless the path being deserialized is already absolute.",
+ "type": "string"
+ },
+ "NetworkAccess": {
+ "enum": [
+ "restricted",
+ "enabled"
+ ],
+ "type": "string"
+ },
+ "SandboxPolicy": {
+ "oneOf": [
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "dangerFullAccess"
+ ],
+ "title": "DangerFullAccessSandboxPolicyType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "DangerFullAccessSandboxPolicy",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "readOnly"
+ ],
+ "title": "ReadOnlySandboxPolicyType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "ReadOnlySandboxPolicy",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "networkAccess": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/NetworkAccess"
+ }
+ ],
+ "default": "restricted"
+ },
+ "type": {
+ "enum": [
+ "externalSandbox"
+ ],
+ "title": "ExternalSandboxSandboxPolicyType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "ExternalSandboxSandboxPolicy",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "excludeSlashTmp": {
+ "default": false,
+ "type": "boolean"
+ },
+ "excludeTmpdirEnvVar": {
+ "default": false,
+ "type": "boolean"
+ },
+ "networkAccess": {
+ "default": false,
+ "type": "boolean"
+ },
+ "type": {
+ "enum": [
+ "workspaceWrite"
+ ],
+ "title": "WorkspaceWriteSandboxPolicyType",
+ "type": "string"
+ },
+ "writableRoots": {
+ "default": [],
+ "items": {
+ "$ref": "#/definitions/AbsolutePathBuf"
+ },
+ "type": "array"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "WorkspaceWriteSandboxPolicy",
+ "type": "object"
+ }
+ ]
+ }
+ },
+ "properties": {
+ "command": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "cwd": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "sandboxPolicy": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/SandboxPolicy"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "timeoutMs": {
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "command"
+ ],
+ "title": "CommandExecParams",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v2/CommandExecResponse.json b/codex-rs/app-server-protocol/schema/json/v2/CommandExecResponse.json
new file mode 100644
index 0000000000..8ca0f46b77
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v2/CommandExecResponse.json
@@ -0,0 +1,22 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "exitCode": {
+ "format": "int32",
+ "type": "integer"
+ },
+ "stderr": {
+ "type": "string"
+ },
+ "stdout": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "exitCode",
+ "stderr",
+ "stdout"
+ ],
+ "title": "CommandExecResponse",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v2/CommandExecutionOutputDeltaNotification.json b/codex-rs/app-server-protocol/schema/json/v2/CommandExecutionOutputDeltaNotification.json
new file mode 100644
index 0000000000..e4cb64a9dd
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v2/CommandExecutionOutputDeltaNotification.json
@@ -0,0 +1,25 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "delta": {
+ "type": "string"
+ },
+ "itemId": {
+ "type": "string"
+ },
+ "threadId": {
+ "type": "string"
+ },
+ "turnId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "delta",
+ "itemId",
+ "threadId",
+ "turnId"
+ ],
+ "title": "CommandExecutionOutputDeltaNotification",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v2/ConfigBatchWriteParams.json b/codex-rs/app-server-protocol/schema/json/v2/ConfigBatchWriteParams.json
new file mode 100644
index 0000000000..37b23b2405
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v2/ConfigBatchWriteParams.json
@@ -0,0 +1,55 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "definitions": {
+ "ConfigEdit": {
+ "properties": {
+ "keyPath": {
+ "type": "string"
+ },
+ "mergeStrategy": {
+ "$ref": "#/definitions/MergeStrategy"
+ },
+ "value": true
+ },
+ "required": [
+ "keyPath",
+ "mergeStrategy",
+ "value"
+ ],
+ "type": "object"
+ },
+ "MergeStrategy": {
+ "enum": [
+ "replace",
+ "upsert"
+ ],
+ "type": "string"
+ }
+ },
+ "properties": {
+ "edits": {
+ "items": {
+ "$ref": "#/definitions/ConfigEdit"
+ },
+ "type": "array"
+ },
+ "expectedVersion": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "filePath": {
+ "description": "Path to the config file to write; defaults to the user's `config.toml` when omitted.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "edits"
+ ],
+ "title": "ConfigBatchWriteParams",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v2/ConfigReadParams.json b/codex-rs/app-server-protocol/schema/json/v2/ConfigReadParams.json
new file mode 100644
index 0000000000..b173d2ba95
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v2/ConfigReadParams.json
@@ -0,0 +1,18 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "cwd": {
+ "description": "Optional working directory to resolve project config layers. If specified, return the effective config as seen from that directory (i.e., including any project layers between `cwd` and the project/repo root).",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "includeLayers": {
+ "default": false,
+ "type": "boolean"
+ }
+ },
+ "title": "ConfigReadParams",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v2/ConfigReadResponse.json b/codex-rs/app-server-protocol/schema/json/v2/ConfigReadResponse.json
new file mode 100644
index 0000000000..96ce16be09
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v2/ConfigReadResponse.json
@@ -0,0 +1,604 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "definitions": {
+ "AbsolutePathBuf": {
+ "description": "A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem).\n\nIMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set, the deserialization will fail unless the path being deserialized is already absolute.",
+ "type": "string"
+ },
+ "AnalyticsConfig": {
+ "additionalProperties": true,
+ "properties": {
+ "enabled": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "AskForApproval": {
+ "enum": [
+ "untrusted",
+ "on-failure",
+ "on-request",
+ "never"
+ ],
+ "type": "string"
+ },
+ "Config": {
+ "additionalProperties": true,
+ "properties": {
+ "analytics": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/AnalyticsConfig"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "approval_policy": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/AskForApproval"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "compact_prompt": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "developer_instructions": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "forced_chatgpt_workspace_id": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "forced_login_method": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ForcedLoginMethod"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "instructions": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "model": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "model_auto_compact_token_limit": {
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "model_context_window": {
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "model_provider": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "model_reasoning_effort": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ReasoningEffort"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "model_reasoning_summary": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ReasoningSummary"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "model_verbosity": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Verbosity"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "profile": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "profiles": {
+ "additionalProperties": {
+ "$ref": "#/definitions/ProfileV2"
+ },
+ "default": {},
+ "type": "object"
+ },
+ "review_model": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "sandbox_mode": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/SandboxMode"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "sandbox_workspace_write": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/SandboxWorkspaceWrite"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "tools": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ToolsV2"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "web_search": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/WebSearchMode"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "ConfigLayer": {
+ "properties": {
+ "config": true,
+ "disabledReason": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "name": {
+ "$ref": "#/definitions/ConfigLayerSource"
+ },
+ "version": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "config",
+ "name",
+ "version"
+ ],
+ "type": "object"
+ },
+ "ConfigLayerMetadata": {
+ "properties": {
+ "name": {
+ "$ref": "#/definitions/ConfigLayerSource"
+ },
+ "version": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "version"
+ ],
+ "type": "object"
+ },
+ "ConfigLayerSource": {
+ "oneOf": [
+ {
+ "description": "Managed preferences layer delivered by MDM (macOS only).",
+ "properties": {
+ "domain": {
+ "type": "string"
+ },
+ "key": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "mdm"
+ ],
+ "title": "MdmConfigLayerSourceType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "domain",
+ "key",
+ "type"
+ ],
+ "title": "MdmConfigLayerSource",
+ "type": "object"
+ },
+ {
+ "description": "Managed config layer from a file (usually `managed_config.toml`).",
+ "properties": {
+ "file": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/AbsolutePathBuf"
+ }
+ ],
+ "description": "This is the path to the system config.toml file, though it is not guaranteed to exist."
+ },
+ "type": {
+ "enum": [
+ "system"
+ ],
+ "title": "SystemConfigLayerSourceType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "file",
+ "type"
+ ],
+ "title": "SystemConfigLayerSource",
+ "type": "object"
+ },
+ {
+ "description": "User config layer from $CODEX_HOME/config.toml. This layer is special in that it is expected to be: - writable by the user - generally outside the workspace directory",
+ "properties": {
+ "file": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/AbsolutePathBuf"
+ }
+ ],
+ "description": "This is the path to the user's config.toml file, though it is not guaranteed to exist."
+ },
+ "type": {
+ "enum": [
+ "user"
+ ],
+ "title": "UserConfigLayerSourceType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "file",
+ "type"
+ ],
+ "title": "UserConfigLayerSource",
+ "type": "object"
+ },
+ {
+ "description": "Path to a .codex/ folder within a project. There could be multiple of these between `cwd` and the project/repo root.",
+ "properties": {
+ "dotCodexFolder": {
+ "$ref": "#/definitions/AbsolutePathBuf"
+ },
+ "type": {
+ "enum": [
+ "project"
+ ],
+ "title": "ProjectConfigLayerSourceType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "dotCodexFolder",
+ "type"
+ ],
+ "title": "ProjectConfigLayerSource",
+ "type": "object"
+ },
+ {
+ "description": "Session-layer overrides supplied via `-c`/`--config`.",
+ "properties": {
+ "type": {
+ "enum": [
+ "sessionFlags"
+ ],
+ "title": "SessionFlagsConfigLayerSourceType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "SessionFlagsConfigLayerSource",
+ "type": "object"
+ },
+ {
+ "description": "`managed_config.toml` was designed to be a config that was loaded as the last layer on top of everything else. This scheme did not quite work out as intended, but we keep this variant as a \"best effort\" while we phase out `managed_config.toml` in favor of `requirements.toml`.",
+ "properties": {
+ "file": {
+ "$ref": "#/definitions/AbsolutePathBuf"
+ },
+ "type": {
+ "enum": [
+ "legacyManagedConfigTomlFromFile"
+ ],
+ "title": "LegacyManagedConfigTomlFromFileConfigLayerSourceType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "file",
+ "type"
+ ],
+ "title": "LegacyManagedConfigTomlFromFileConfigLayerSource",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "legacyManagedConfigTomlFromMdm"
+ ],
+ "title": "LegacyManagedConfigTomlFromMdmConfigLayerSourceType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "LegacyManagedConfigTomlFromMdmConfigLayerSource",
+ "type": "object"
+ }
+ ]
+ },
+ "ForcedLoginMethod": {
+ "enum": [
+ "chatgpt",
+ "api"
+ ],
+ "type": "string"
+ },
+ "ProfileV2": {
+ "additionalProperties": true,
+ "properties": {
+ "approval_policy": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/AskForApproval"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "chatgpt_base_url": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "model": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "model_provider": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "model_reasoning_effort": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ReasoningEffort"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "model_reasoning_summary": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ReasoningSummary"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "model_verbosity": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Verbosity"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "web_search": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/WebSearchMode"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "ReasoningEffort": {
+ "description": "See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#get-started-with-reasoning",
+ "enum": [
+ "none",
+ "minimal",
+ "low",
+ "medium",
+ "high",
+ "xhigh"
+ ],
+ "type": "string"
+ },
+ "ReasoningSummary": {
+ "description": "A summary of the reasoning performed by the model. This can be useful for debugging and understanding the model's reasoning process. See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#reasoning-summaries",
+ "oneOf": [
+ {
+ "enum": [
+ "auto",
+ "concise",
+ "detailed"
+ ],
+ "type": "string"
+ },
+ {
+ "description": "Option to disable reasoning summaries.",
+ "enum": [
+ "none"
+ ],
+ "type": "string"
+ }
+ ]
+ },
+ "SandboxMode": {
+ "enum": [
+ "read-only",
+ "workspace-write",
+ "danger-full-access"
+ ],
+ "type": "string"
+ },
+ "SandboxWorkspaceWrite": {
+ "properties": {
+ "exclude_slash_tmp": {
+ "default": false,
+ "type": "boolean"
+ },
+ "exclude_tmpdir_env_var": {
+ "default": false,
+ "type": "boolean"
+ },
+ "network_access": {
+ "default": false,
+ "type": "boolean"
+ },
+ "writable_roots": {
+ "default": [],
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ }
+ },
+ "type": "object"
+ },
+ "ToolsV2": {
+ "properties": {
+ "view_image": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "web_search": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "Verbosity": {
+ "description": "Controls output length/detail on GPT-5 models via the Responses API. Serialized with lowercase values to match the OpenAI API.",
+ "enum": [
+ "low",
+ "medium",
+ "high"
+ ],
+ "type": "string"
+ },
+ "WebSearchMode": {
+ "enum": [
+ "disabled",
+ "cached",
+ "live"
+ ],
+ "type": "string"
+ }
+ },
+ "properties": {
+ "config": {
+ "$ref": "#/definitions/Config"
+ },
+ "layers": {
+ "items": {
+ "$ref": "#/definitions/ConfigLayer"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "origins": {
+ "additionalProperties": {
+ "$ref": "#/definitions/ConfigLayerMetadata"
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "config",
+ "origins"
+ ],
+ "title": "ConfigReadResponse",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v2/ConfigRequirementsReadResponse.json b/codex-rs/app-server-protocol/schema/json/v2/ConfigRequirementsReadResponse.json
new file mode 100644
index 0000000000..9e77238b75
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v2/ConfigRequirementsReadResponse.json
@@ -0,0 +1,76 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "definitions": {
+ "AskForApproval": {
+ "enum": [
+ "untrusted",
+ "on-failure",
+ "on-request",
+ "never"
+ ],
+ "type": "string"
+ },
+ "ConfigRequirements": {
+ "properties": {
+ "allowedApprovalPolicies": {
+ "items": {
+ "$ref": "#/definitions/AskForApproval"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "allowedSandboxModes": {
+ "items": {
+ "$ref": "#/definitions/SandboxMode"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "enforceResidency": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ResidencyRequirement"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "ResidencyRequirement": {
+ "enum": [
+ "us"
+ ],
+ "type": "string"
+ },
+ "SandboxMode": {
+ "enum": [
+ "read-only",
+ "workspace-write",
+ "danger-full-access"
+ ],
+ "type": "string"
+ }
+ },
+ "properties": {
+ "requirements": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ConfigRequirements"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Null if no requirements are configured (e.g. no requirements.toml/MDM entries)."
+ }
+ },
+ "title": "ConfigRequirementsReadResponse",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v2/ConfigValueWriteParams.json b/codex-rs/app-server-protocol/schema/json/v2/ConfigValueWriteParams.json
new file mode 100644
index 0000000000..000c55a830
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v2/ConfigValueWriteParams.json
@@ -0,0 +1,41 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "definitions": {
+ "MergeStrategy": {
+ "enum": [
+ "replace",
+ "upsert"
+ ],
+ "type": "string"
+ }
+ },
+ "properties": {
+ "expectedVersion": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "filePath": {
+ "description": "Path to the config file to write; defaults to the user's `config.toml` when omitted.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "keyPath": {
+ "type": "string"
+ },
+ "mergeStrategy": {
+ "$ref": "#/definitions/MergeStrategy"
+ },
+ "value": true
+ },
+ "required": [
+ "keyPath",
+ "mergeStrategy",
+ "value"
+ ],
+ "title": "ConfigValueWriteParams",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v2/ConfigWarningNotification.json b/codex-rs/app-server-protocol/schema/json/v2/ConfigWarningNotification.json
new file mode 100644
index 0000000000..c89e42a2b4
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v2/ConfigWarningNotification.json
@@ -0,0 +1,77 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "definitions": {
+ "TextPosition": {
+ "properties": {
+ "column": {
+ "description": "1-based column number (in Unicode scalar values).",
+ "format": "uint",
+ "minimum": 0.0,
+ "type": "integer"
+ },
+ "line": {
+ "description": "1-based line number.",
+ "format": "uint",
+ "minimum": 0.0,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "column",
+ "line"
+ ],
+ "type": "object"
+ },
+ "TextRange": {
+ "properties": {
+ "end": {
+ "$ref": "#/definitions/TextPosition"
+ },
+ "start": {
+ "$ref": "#/definitions/TextPosition"
+ }
+ },
+ "required": [
+ "end",
+ "start"
+ ],
+ "type": "object"
+ }
+ },
+ "properties": {
+ "details": {
+ "description": "Optional extra guidance or error details.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "path": {
+ "description": "Optional path to the config file that triggered the warning.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "range": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/TextRange"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Optional range for the error location inside the config file."
+ },
+ "summary": {
+ "description": "Concise summary of the warning.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "summary"
+ ],
+ "title": "ConfigWarningNotification",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v2/ConfigWriteResponse.json b/codex-rs/app-server-protocol/schema/json/v2/ConfigWriteResponse.json
new file mode 100644
index 0000000000..631318a8bd
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v2/ConfigWriteResponse.json
@@ -0,0 +1,237 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "definitions": {
+ "AbsolutePathBuf": {
+ "description": "A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem).\n\nIMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set, the deserialization will fail unless the path being deserialized is already absolute.",
+ "type": "string"
+ },
+ "ConfigLayerMetadata": {
+ "properties": {
+ "name": {
+ "$ref": "#/definitions/ConfigLayerSource"
+ },
+ "version": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "version"
+ ],
+ "type": "object"
+ },
+ "ConfigLayerSource": {
+ "oneOf": [
+ {
+ "description": "Managed preferences layer delivered by MDM (macOS only).",
+ "properties": {
+ "domain": {
+ "type": "string"
+ },
+ "key": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "mdm"
+ ],
+ "title": "MdmConfigLayerSourceType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "domain",
+ "key",
+ "type"
+ ],
+ "title": "MdmConfigLayerSource",
+ "type": "object"
+ },
+ {
+ "description": "Managed config layer from a file (usually `managed_config.toml`).",
+ "properties": {
+ "file": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/AbsolutePathBuf"
+ }
+ ],
+ "description": "This is the path to the system config.toml file, though it is not guaranteed to exist."
+ },
+ "type": {
+ "enum": [
+ "system"
+ ],
+ "title": "SystemConfigLayerSourceType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "file",
+ "type"
+ ],
+ "title": "SystemConfigLayerSource",
+ "type": "object"
+ },
+ {
+ "description": "User config layer from $CODEX_HOME/config.toml. This layer is special in that it is expected to be: - writable by the user - generally outside the workspace directory",
+ "properties": {
+ "file": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/AbsolutePathBuf"
+ }
+ ],
+ "description": "This is the path to the user's config.toml file, though it is not guaranteed to exist."
+ },
+ "type": {
+ "enum": [
+ "user"
+ ],
+ "title": "UserConfigLayerSourceType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "file",
+ "type"
+ ],
+ "title": "UserConfigLayerSource",
+ "type": "object"
+ },
+ {
+ "description": "Path to a .codex/ folder within a project. There could be multiple of these between `cwd` and the project/repo root.",
+ "properties": {
+ "dotCodexFolder": {
+ "$ref": "#/definitions/AbsolutePathBuf"
+ },
+ "type": {
+ "enum": [
+ "project"
+ ],
+ "title": "ProjectConfigLayerSourceType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "dotCodexFolder",
+ "type"
+ ],
+ "title": "ProjectConfigLayerSource",
+ "type": "object"
+ },
+ {
+ "description": "Session-layer overrides supplied via `-c`/`--config`.",
+ "properties": {
+ "type": {
+ "enum": [
+ "sessionFlags"
+ ],
+ "title": "SessionFlagsConfigLayerSourceType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "SessionFlagsConfigLayerSource",
+ "type": "object"
+ },
+ {
+ "description": "`managed_config.toml` was designed to be a config that was loaded as the last layer on top of everything else. This scheme did not quite work out as intended, but we keep this variant as a \"best effort\" while we phase out `managed_config.toml` in favor of `requirements.toml`.",
+ "properties": {
+ "file": {
+ "$ref": "#/definitions/AbsolutePathBuf"
+ },
+ "type": {
+ "enum": [
+ "legacyManagedConfigTomlFromFile"
+ ],
+ "title": "LegacyManagedConfigTomlFromFileConfigLayerSourceType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "file",
+ "type"
+ ],
+ "title": "LegacyManagedConfigTomlFromFileConfigLayerSource",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "legacyManagedConfigTomlFromMdm"
+ ],
+ "title": "LegacyManagedConfigTomlFromMdmConfigLayerSourceType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "LegacyManagedConfigTomlFromMdmConfigLayerSource",
+ "type": "object"
+ }
+ ]
+ },
+ "OverriddenMetadata": {
+ "properties": {
+ "effectiveValue": true,
+ "message": {
+ "type": "string"
+ },
+ "overridingLayer": {
+ "$ref": "#/definitions/ConfigLayerMetadata"
+ }
+ },
+ "required": [
+ "effectiveValue",
+ "message",
+ "overridingLayer"
+ ],
+ "type": "object"
+ },
+ "WriteStatus": {
+ "enum": [
+ "ok",
+ "okOverridden"
+ ],
+ "type": "string"
+ }
+ },
+ "properties": {
+ "filePath": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/AbsolutePathBuf"
+ }
+ ],
+ "description": "Canonical path to the config file that was written."
+ },
+ "overriddenMetadata": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/OverriddenMetadata"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "status": {
+ "$ref": "#/definitions/WriteStatus"
+ },
+ "version": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "filePath",
+ "status",
+ "version"
+ ],
+ "title": "ConfigWriteResponse",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v2/ContextCompactedNotification.json b/codex-rs/app-server-protocol/schema/json/v2/ContextCompactedNotification.json
new file mode 100644
index 0000000000..8d2d4b1261
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v2/ContextCompactedNotification.json
@@ -0,0 +1,18 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "description": "Deprecated: Use `ContextCompaction` item type instead.",
+ "properties": {
+ "threadId": {
+ "type": "string"
+ },
+ "turnId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "threadId",
+ "turnId"
+ ],
+ "title": "ContextCompactedNotification",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v2/DeprecationNoticeNotification.json b/codex-rs/app-server-protocol/schema/json/v2/DeprecationNoticeNotification.json
new file mode 100644
index 0000000000..7e6c73b9c7
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v2/DeprecationNoticeNotification.json
@@ -0,0 +1,21 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "details": {
+ "description": "Optional extra guidance, such as migration steps or rationale.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "summary": {
+ "description": "Concise summary of what is deprecated.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "summary"
+ ],
+ "title": "DeprecationNoticeNotification",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v2/ErrorNotification.json b/codex-rs/app-server-protocol/schema/json/v2/ErrorNotification.json
new file mode 100644
index 0000000000..17991ebaed
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v2/ErrorNotification.json
@@ -0,0 +1,197 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "definitions": {
+ "CodexErrorInfo": {
+ "description": "This translation layer make sure that we expose codex error code in camel case.\n\nWhen an upstream HTTP status is available (for example, from the Responses API or a provider), it is forwarded in `httpStatusCode` on the relevant `codexErrorInfo` variant.",
+ "oneOf": [
+ {
+ "enum": [
+ "contextWindowExceeded",
+ "usageLimitExceeded",
+ "internalServerError",
+ "unauthorized",
+ "badRequest",
+ "threadRollbackFailed",
+ "sandboxError",
+ "other"
+ ],
+ "type": "string"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "modelCap": {
+ "properties": {
+ "model": {
+ "type": "string"
+ },
+ "reset_after_seconds": {
+ "format": "uint64",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "model"
+ ],
+ "type": "object"
+ }
+ },
+ "required": [
+ "modelCap"
+ ],
+ "title": "ModelCapCodexErrorInfo",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "httpConnectionFailed": {
+ "properties": {
+ "httpStatusCode": {
+ "format": "uint16",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "httpConnectionFailed"
+ ],
+ "title": "HttpConnectionFailedCodexErrorInfo",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "Failed to connect to the response SSE stream.",
+ "properties": {
+ "responseStreamConnectionFailed": {
+ "properties": {
+ "httpStatusCode": {
+ "format": "uint16",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "responseStreamConnectionFailed"
+ ],
+ "title": "ResponseStreamConnectionFailedCodexErrorInfo",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "The response SSE stream disconnected in the middle of a turn before completion.",
+ "properties": {
+ "responseStreamDisconnected": {
+ "properties": {
+ "httpStatusCode": {
+ "format": "uint16",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "responseStreamDisconnected"
+ ],
+ "title": "ResponseStreamDisconnectedCodexErrorInfo",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "Reached the retry limit for responses.",
+ "properties": {
+ "responseTooManyFailedAttempts": {
+ "properties": {
+ "httpStatusCode": {
+ "format": "uint16",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "responseTooManyFailedAttempts"
+ ],
+ "title": "ResponseTooManyFailedAttemptsCodexErrorInfo",
+ "type": "object"
+ }
+ ]
+ },
+ "TurnError": {
+ "properties": {
+ "additionalDetails": {
+ "default": null,
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "codexErrorInfo": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/CodexErrorInfo"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "message": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "message"
+ ],
+ "type": "object"
+ }
+ },
+ "properties": {
+ "error": {
+ "$ref": "#/definitions/TurnError"
+ },
+ "threadId": {
+ "type": "string"
+ },
+ "turnId": {
+ "type": "string"
+ },
+ "willRetry": {
+ "type": "boolean"
+ }
+ },
+ "required": [
+ "error",
+ "threadId",
+ "turnId",
+ "willRetry"
+ ],
+ "title": "ErrorNotification",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v2/FeedbackUploadParams.json b/codex-rs/app-server-protocol/schema/json/v2/FeedbackUploadParams.json
new file mode 100644
index 0000000000..e4171b27f4
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v2/FeedbackUploadParams.json
@@ -0,0 +1,29 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "classification": {
+ "type": "string"
+ },
+ "includeLogs": {
+ "type": "boolean"
+ },
+ "reason": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "threadId": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "classification",
+ "includeLogs"
+ ],
+ "title": "FeedbackUploadParams",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v2/FeedbackUploadResponse.json b/codex-rs/app-server-protocol/schema/json/v2/FeedbackUploadResponse.json
new file mode 100644
index 0000000000..647b613f0b
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v2/FeedbackUploadResponse.json
@@ -0,0 +1,13 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "threadId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "threadId"
+ ],
+ "title": "FeedbackUploadResponse",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v2/FileChangeOutputDeltaNotification.json b/codex-rs/app-server-protocol/schema/json/v2/FileChangeOutputDeltaNotification.json
new file mode 100644
index 0000000000..2b3abd67f9
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v2/FileChangeOutputDeltaNotification.json
@@ -0,0 +1,25 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "delta": {
+ "type": "string"
+ },
+ "itemId": {
+ "type": "string"
+ },
+ "threadId": {
+ "type": "string"
+ },
+ "turnId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "delta",
+ "itemId",
+ "threadId",
+ "turnId"
+ ],
+ "title": "FileChangeOutputDeltaNotification",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v2/GetAccountParams.json b/codex-rs/app-server-protocol/schema/json/v2/GetAccountParams.json
new file mode 100644
index 0000000000..ca18a451e9
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v2/GetAccountParams.json
@@ -0,0 +1,12 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "refreshToken": {
+ "default": false,
+ "description": "When `true`, requests a proactive token refresh before returning.\n\nIn managed auth mode this triggers the normal refresh-token flow. In external auth mode this flag is ignored. Clients should refresh tokens themselves and call `account/login/start` with `chatgptAuthTokens`.",
+ "type": "boolean"
+ }
+ },
+ "title": "GetAccountParams",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v2/GetAccountRateLimitsResponse.json b/codex-rs/app-server-protocol/schema/json/v2/GetAccountRateLimitsResponse.json
new file mode 100644
index 0000000000..a7025fbaea
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v2/GetAccountRateLimitsResponse.json
@@ -0,0 +1,121 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "definitions": {
+ "CreditsSnapshot": {
+ "properties": {
+ "balance": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "hasCredits": {
+ "type": "boolean"
+ },
+ "unlimited": {
+ "type": "boolean"
+ }
+ },
+ "required": [
+ "hasCredits",
+ "unlimited"
+ ],
+ "type": "object"
+ },
+ "PlanType": {
+ "enum": [
+ "free",
+ "go",
+ "plus",
+ "pro",
+ "team",
+ "business",
+ "enterprise",
+ "edu",
+ "unknown"
+ ],
+ "type": "string"
+ },
+ "RateLimitSnapshot": {
+ "properties": {
+ "credits": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/CreditsSnapshot"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "planType": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/PlanType"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "primary": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/RateLimitWindow"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "secondary": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/RateLimitWindow"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "RateLimitWindow": {
+ "properties": {
+ "resetsAt": {
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "usedPercent": {
+ "format": "int32",
+ "type": "integer"
+ },
+ "windowDurationMins": {
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "usedPercent"
+ ],
+ "type": "object"
+ }
+ },
+ "properties": {
+ "rateLimits": {
+ "$ref": "#/definitions/RateLimitSnapshot"
+ }
+ },
+ "required": [
+ "rateLimits"
+ ],
+ "title": "GetAccountRateLimitsResponse",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v2/GetAccountResponse.json b/codex-rs/app-server-protocol/schema/json/v2/GetAccountResponse.json
new file mode 100644
index 0000000000..6646bd8c97
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v2/GetAccountResponse.json
@@ -0,0 +1,83 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "definitions": {
+ "Account": {
+ "oneOf": [
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "apiKey"
+ ],
+ "title": "ApiKeyAccountType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "ApiKeyAccount",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "email": {
+ "type": "string"
+ },
+ "planType": {
+ "$ref": "#/definitions/PlanType"
+ },
+ "type": {
+ "enum": [
+ "chatgpt"
+ ],
+ "title": "ChatgptAccountType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "email",
+ "planType",
+ "type"
+ ],
+ "title": "ChatgptAccount",
+ "type": "object"
+ }
+ ]
+ },
+ "PlanType": {
+ "enum": [
+ "free",
+ "go",
+ "plus",
+ "pro",
+ "team",
+ "business",
+ "enterprise",
+ "edu",
+ "unknown"
+ ],
+ "type": "string"
+ }
+ },
+ "properties": {
+ "account": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Account"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "requiresOpenaiAuth": {
+ "type": "boolean"
+ }
+ },
+ "required": [
+ "requiresOpenaiAuth"
+ ],
+ "title": "GetAccountResponse",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v2/ItemCompletedNotification.json b/codex-rs/app-server-protocol/schema/json/v2/ItemCompletedNotification.json
new file mode 100644
index 0000000000..866ce9aa2b
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v2/ItemCompletedNotification.json
@@ -0,0 +1,1316 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "definitions": {
+ "Annotations": {
+ "description": "Optional annotations for the client. The client can use annotations to inform how objects are used or displayed",
+ "properties": {
+ "audience": {
+ "items": {
+ "$ref": "#/definitions/Role"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "lastModified": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "priority": {
+ "format": "double",
+ "type": [
+ "number",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "AudioContent": {
+ "description": "Audio provided to or from an LLM.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "data": {
+ "type": "string"
+ },
+ "mimeType": {
+ "type": "string"
+ },
+ "type": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "data",
+ "mimeType",
+ "type"
+ ],
+ "type": "object"
+ },
+ "BlobResourceContents": {
+ "properties": {
+ "blob": {
+ "type": "string"
+ },
+ "mimeType": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "uri": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "blob",
+ "uri"
+ ],
+ "type": "object"
+ },
+ "ByteRange": {
+ "properties": {
+ "end": {
+ "format": "uint",
+ "minimum": 0.0,
+ "type": "integer"
+ },
+ "start": {
+ "format": "uint",
+ "minimum": 0.0,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "end",
+ "start"
+ ],
+ "type": "object"
+ },
+ "CollabAgentState": {
+ "properties": {
+ "message": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "status": {
+ "$ref": "#/definitions/CollabAgentStatus"
+ }
+ },
+ "required": [
+ "status"
+ ],
+ "type": "object"
+ },
+ "CollabAgentStatus": {
+ "enum": [
+ "pendingInit",
+ "running",
+ "completed",
+ "errored",
+ "shutdown",
+ "notFound"
+ ],
+ "type": "string"
+ },
+ "CollabAgentTool": {
+ "enum": [
+ "spawnAgent",
+ "sendInput",
+ "wait",
+ "closeAgent"
+ ],
+ "type": "string"
+ },
+ "CollabAgentToolCallStatus": {
+ "enum": [
+ "inProgress",
+ "completed",
+ "failed"
+ ],
+ "type": "string"
+ },
+ "CommandAction": {
+ "oneOf": [
+ {
+ "properties": {
+ "command": {
+ "type": "string"
+ },
+ "name": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "read"
+ ],
+ "title": "ReadCommandActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "command",
+ "name",
+ "path",
+ "type"
+ ],
+ "title": "ReadCommandAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "command": {
+ "type": "string"
+ },
+ "path": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "listFiles"
+ ],
+ "title": "ListFilesCommandActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "command",
+ "type"
+ ],
+ "title": "ListFilesCommandAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "command": {
+ "type": "string"
+ },
+ "path": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "query": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "search"
+ ],
+ "title": "SearchCommandActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "command",
+ "type"
+ ],
+ "title": "SearchCommandAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "command": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "unknown"
+ ],
+ "title": "UnknownCommandActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "command",
+ "type"
+ ],
+ "title": "UnknownCommandAction",
+ "type": "object"
+ }
+ ]
+ },
+ "CommandExecutionStatus": {
+ "enum": [
+ "inProgress",
+ "completed",
+ "failed",
+ "declined"
+ ],
+ "type": "string"
+ },
+ "ContentBlock": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/TextContent"
+ },
+ {
+ "$ref": "#/definitions/ImageContent"
+ },
+ {
+ "$ref": "#/definitions/AudioContent"
+ },
+ {
+ "$ref": "#/definitions/ResourceLink"
+ },
+ {
+ "$ref": "#/definitions/EmbeddedResource"
+ }
+ ]
+ },
+ "EmbeddedResource": {
+ "description": "The contents of a resource, embedded into a prompt or tool call result.\n\nIt is up to the client how best to render embedded resources for the benefit of the LLM and/or the user.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "resource": {
+ "$ref": "#/definitions/EmbeddedResourceResource"
+ },
+ "type": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "resource",
+ "type"
+ ],
+ "type": "object"
+ },
+ "EmbeddedResourceResource": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/TextResourceContents"
+ },
+ {
+ "$ref": "#/definitions/BlobResourceContents"
+ }
+ ]
+ },
+ "FileUpdateChange": {
+ "properties": {
+ "diff": {
+ "type": "string"
+ },
+ "kind": {
+ "$ref": "#/definitions/PatchChangeKind"
+ },
+ "path": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "diff",
+ "kind",
+ "path"
+ ],
+ "type": "object"
+ },
+ "ImageContent": {
+ "description": "An image provided to or from an LLM.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "data": {
+ "type": "string"
+ },
+ "mimeType": {
+ "type": "string"
+ },
+ "type": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "data",
+ "mimeType",
+ "type"
+ ],
+ "type": "object"
+ },
+ "McpToolCallError": {
+ "properties": {
+ "message": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "message"
+ ],
+ "type": "object"
+ },
+ "McpToolCallResult": {
+ "properties": {
+ "content": {
+ "items": {
+ "$ref": "#/definitions/ContentBlock"
+ },
+ "type": "array"
+ },
+ "structuredContent": true
+ },
+ "required": [
+ "content"
+ ],
+ "type": "object"
+ },
+ "McpToolCallStatus": {
+ "enum": [
+ "inProgress",
+ "completed",
+ "failed"
+ ],
+ "type": "string"
+ },
+ "PatchApplyStatus": {
+ "enum": [
+ "inProgress",
+ "completed",
+ "failed",
+ "declined"
+ ],
+ "type": "string"
+ },
+ "PatchChangeKind": {
+ "oneOf": [
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "add"
+ ],
+ "title": "AddPatchChangeKindType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "AddPatchChangeKind",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "delete"
+ ],
+ "title": "DeletePatchChangeKindType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "DeletePatchChangeKind",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "move_path": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "update"
+ ],
+ "title": "UpdatePatchChangeKindType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "UpdatePatchChangeKind",
+ "type": "object"
+ }
+ ]
+ },
+ "ResourceLink": {
+ "description": "A resource that the server is capable of reading, included in a prompt or tool call result.\n\nNote: resource links returned by tools are not guaranteed to appear in the results of `resources/list` requests.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "description": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "mimeType": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "name": {
+ "type": "string"
+ },
+ "size": {
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "title": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "type": "string"
+ },
+ "uri": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "type",
+ "uri"
+ ],
+ "type": "object"
+ },
+ "Role": {
+ "description": "The sender or recipient of messages and data in a conversation.",
+ "enum": [
+ "assistant",
+ "user"
+ ],
+ "type": "string"
+ },
+ "TextContent": {
+ "description": "Text provided to or from an LLM.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "type": "object"
+ },
+ "TextElement": {
+ "properties": {
+ "byteRange": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ByteRange"
+ }
+ ],
+ "description": "Byte range in the parent `text` buffer that this element occupies."
+ },
+ "placeholder": {
+ "description": "Optional human-readable placeholder for the element, displayed in the UI.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "byteRange"
+ ],
+ "type": "object"
+ },
+ "TextResourceContents": {
+ "properties": {
+ "mimeType": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "text": {
+ "type": "string"
+ },
+ "uri": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "uri"
+ ],
+ "type": "object"
+ },
+ "ThreadItem": {
+ "oneOf": [
+ {
+ "properties": {
+ "content": {
+ "items": {
+ "$ref": "#/definitions/UserInput"
+ },
+ "type": "array"
+ },
+ "id": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "userMessage"
+ ],
+ "title": "UserMessageThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "content",
+ "id",
+ "type"
+ ],
+ "title": "UserMessageThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "agentMessage"
+ ],
+ "title": "AgentMessageThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "text",
+ "type"
+ ],
+ "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": {
+ "default": [],
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "id": {
+ "type": "string"
+ },
+ "summary": {
+ "default": [],
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "type": {
+ "enum": [
+ "reasoning"
+ ],
+ "title": "ReasoningThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "type"
+ ],
+ "title": "ReasoningThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "aggregatedOutput": {
+ "description": "The command's output, aggregated from stdout and stderr.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "command": {
+ "description": "The command to be executed.",
+ "type": "string"
+ },
+ "commandActions": {
+ "description": "A best-effort parsing of the command to understand the action(s) it will perform. This returns a list of CommandAction objects because a single shell command may be composed of many commands piped together.",
+ "items": {
+ "$ref": "#/definitions/CommandAction"
+ },
+ "type": "array"
+ },
+ "cwd": {
+ "description": "The command's working directory.",
+ "type": "string"
+ },
+ "durationMs": {
+ "description": "The duration of the command execution in milliseconds.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "exitCode": {
+ "description": "The command's exit code.",
+ "format": "int32",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "id": {
+ "type": "string"
+ },
+ "processId": {
+ "description": "Identifier for the underlying PTY process (when available).",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "status": {
+ "$ref": "#/definitions/CommandExecutionStatus"
+ },
+ "type": {
+ "enum": [
+ "commandExecution"
+ ],
+ "title": "CommandExecutionThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "command",
+ "commandActions",
+ "cwd",
+ "id",
+ "status",
+ "type"
+ ],
+ "title": "CommandExecutionThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "changes": {
+ "items": {
+ "$ref": "#/definitions/FileUpdateChange"
+ },
+ "type": "array"
+ },
+ "id": {
+ "type": "string"
+ },
+ "status": {
+ "$ref": "#/definitions/PatchApplyStatus"
+ },
+ "type": {
+ "enum": [
+ "fileChange"
+ ],
+ "title": "FileChangeThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "changes",
+ "id",
+ "status",
+ "type"
+ ],
+ "title": "FileChangeThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "arguments": true,
+ "durationMs": {
+ "description": "The duration of the MCP tool call in milliseconds.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "error": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/McpToolCallError"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "id": {
+ "type": "string"
+ },
+ "result": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/McpToolCallResult"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "server": {
+ "type": "string"
+ },
+ "status": {
+ "$ref": "#/definitions/McpToolCallStatus"
+ },
+ "tool": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "mcpToolCall"
+ ],
+ "title": "McpToolCallThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "arguments",
+ "id",
+ "server",
+ "status",
+ "tool",
+ "type"
+ ],
+ "title": "McpToolCallThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "agentsStates": {
+ "additionalProperties": {
+ "$ref": "#/definitions/CollabAgentState"
+ },
+ "description": "Last known status of the target agents, when available.",
+ "type": "object"
+ },
+ "id": {
+ "description": "Unique identifier for this collab tool call.",
+ "type": "string"
+ },
+ "prompt": {
+ "description": "Prompt text sent as part of the collab tool call, when available.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "receiverThreadIds": {
+ "description": "Thread ID of the receiving agent, when applicable. In case of spawn operation, this corresponds to the newly spawned agent.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "senderThreadId": {
+ "description": "Thread ID of the agent issuing the collab request.",
+ "type": "string"
+ },
+ "status": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/CollabAgentToolCallStatus"
+ }
+ ],
+ "description": "Current status of the collab tool call."
+ },
+ "tool": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/CollabAgentTool"
+ }
+ ],
+ "description": "Name of the collab tool that was invoked."
+ },
+ "type": {
+ "enum": [
+ "collabAgentToolCall"
+ ],
+ "title": "CollabAgentToolCallThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "agentsStates",
+ "id",
+ "receiverThreadIds",
+ "senderThreadId",
+ "status",
+ "tool",
+ "type"
+ ],
+ "title": "CollabAgentToolCallThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "action": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/WebSearchAction"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "id": {
+ "type": "string"
+ },
+ "query": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "webSearch"
+ ],
+ "title": "WebSearchThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "query",
+ "type"
+ ],
+ "title": "WebSearchThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "imageView"
+ ],
+ "title": "ImageViewThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "path",
+ "type"
+ ],
+ "title": "ImageViewThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "review": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "enteredReviewMode"
+ ],
+ "title": "EnteredReviewModeThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "review",
+ "type"
+ ],
+ "title": "EnteredReviewModeThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "review": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "exitedReviewMode"
+ ],
+ "title": "ExitedReviewModeThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "review",
+ "type"
+ ],
+ "title": "ExitedReviewModeThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "contextCompaction"
+ ],
+ "title": "ContextCompactionThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "type"
+ ],
+ "title": "ContextCompactionThreadItem",
+ "type": "object"
+ }
+ ]
+ },
+ "UserInput": {
+ "oneOf": [
+ {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "text_elements": {
+ "default": [],
+ "description": "UI-defined spans within `text` used to render or persist special elements.",
+ "items": {
+ "$ref": "#/definitions/TextElement"
+ },
+ "type": "array"
+ },
+ "type": {
+ "enum": [
+ "text"
+ ],
+ "title": "TextUserInputType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "TextUserInput",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "image"
+ ],
+ "title": "ImageUserInputType",
+ "type": "string"
+ },
+ "url": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "url"
+ ],
+ "title": "ImageUserInput",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "localImage"
+ ],
+ "title": "LocalImageUserInputType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "path",
+ "type"
+ ],
+ "title": "LocalImageUserInput",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "name": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "skill"
+ ],
+ "title": "SkillUserInputType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "path",
+ "type"
+ ],
+ "title": "SkillUserInput",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "name": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "mention"
+ ],
+ "title": "MentionUserInputType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "path",
+ "type"
+ ],
+ "title": "MentionUserInput",
+ "type": "object"
+ }
+ ]
+ },
+ "WebSearchAction": {
+ "oneOf": [
+ {
+ "properties": {
+ "queries": {
+ "items": {
+ "type": "string"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "query": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "search"
+ ],
+ "title": "SearchWebSearchActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "SearchWebSearchAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "openPage"
+ ],
+ "title": "OpenPageWebSearchActionType",
+ "type": "string"
+ },
+ "url": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "OpenPageWebSearchAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "pattern": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "findInPage"
+ ],
+ "title": "FindInPageWebSearchActionType",
+ "type": "string"
+ },
+ "url": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "FindInPageWebSearchAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "other"
+ ],
+ "title": "OtherWebSearchActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "OtherWebSearchAction",
+ "type": "object"
+ }
+ ]
+ }
+ },
+ "properties": {
+ "item": {
+ "$ref": "#/definitions/ThreadItem"
+ },
+ "threadId": {
+ "type": "string"
+ },
+ "turnId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "item",
+ "threadId",
+ "turnId"
+ ],
+ "title": "ItemCompletedNotification",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v2/ItemStartedNotification.json b/codex-rs/app-server-protocol/schema/json/v2/ItemStartedNotification.json
new file mode 100644
index 0000000000..2fd71404f6
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v2/ItemStartedNotification.json
@@ -0,0 +1,1316 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "definitions": {
+ "Annotations": {
+ "description": "Optional annotations for the client. The client can use annotations to inform how objects are used or displayed",
+ "properties": {
+ "audience": {
+ "items": {
+ "$ref": "#/definitions/Role"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "lastModified": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "priority": {
+ "format": "double",
+ "type": [
+ "number",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "AudioContent": {
+ "description": "Audio provided to or from an LLM.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "data": {
+ "type": "string"
+ },
+ "mimeType": {
+ "type": "string"
+ },
+ "type": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "data",
+ "mimeType",
+ "type"
+ ],
+ "type": "object"
+ },
+ "BlobResourceContents": {
+ "properties": {
+ "blob": {
+ "type": "string"
+ },
+ "mimeType": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "uri": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "blob",
+ "uri"
+ ],
+ "type": "object"
+ },
+ "ByteRange": {
+ "properties": {
+ "end": {
+ "format": "uint",
+ "minimum": 0.0,
+ "type": "integer"
+ },
+ "start": {
+ "format": "uint",
+ "minimum": 0.0,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "end",
+ "start"
+ ],
+ "type": "object"
+ },
+ "CollabAgentState": {
+ "properties": {
+ "message": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "status": {
+ "$ref": "#/definitions/CollabAgentStatus"
+ }
+ },
+ "required": [
+ "status"
+ ],
+ "type": "object"
+ },
+ "CollabAgentStatus": {
+ "enum": [
+ "pendingInit",
+ "running",
+ "completed",
+ "errored",
+ "shutdown",
+ "notFound"
+ ],
+ "type": "string"
+ },
+ "CollabAgentTool": {
+ "enum": [
+ "spawnAgent",
+ "sendInput",
+ "wait",
+ "closeAgent"
+ ],
+ "type": "string"
+ },
+ "CollabAgentToolCallStatus": {
+ "enum": [
+ "inProgress",
+ "completed",
+ "failed"
+ ],
+ "type": "string"
+ },
+ "CommandAction": {
+ "oneOf": [
+ {
+ "properties": {
+ "command": {
+ "type": "string"
+ },
+ "name": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "read"
+ ],
+ "title": "ReadCommandActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "command",
+ "name",
+ "path",
+ "type"
+ ],
+ "title": "ReadCommandAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "command": {
+ "type": "string"
+ },
+ "path": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "listFiles"
+ ],
+ "title": "ListFilesCommandActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "command",
+ "type"
+ ],
+ "title": "ListFilesCommandAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "command": {
+ "type": "string"
+ },
+ "path": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "query": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "search"
+ ],
+ "title": "SearchCommandActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "command",
+ "type"
+ ],
+ "title": "SearchCommandAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "command": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "unknown"
+ ],
+ "title": "UnknownCommandActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "command",
+ "type"
+ ],
+ "title": "UnknownCommandAction",
+ "type": "object"
+ }
+ ]
+ },
+ "CommandExecutionStatus": {
+ "enum": [
+ "inProgress",
+ "completed",
+ "failed",
+ "declined"
+ ],
+ "type": "string"
+ },
+ "ContentBlock": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/TextContent"
+ },
+ {
+ "$ref": "#/definitions/ImageContent"
+ },
+ {
+ "$ref": "#/definitions/AudioContent"
+ },
+ {
+ "$ref": "#/definitions/ResourceLink"
+ },
+ {
+ "$ref": "#/definitions/EmbeddedResource"
+ }
+ ]
+ },
+ "EmbeddedResource": {
+ "description": "The contents of a resource, embedded into a prompt or tool call result.\n\nIt is up to the client how best to render embedded resources for the benefit of the LLM and/or the user.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "resource": {
+ "$ref": "#/definitions/EmbeddedResourceResource"
+ },
+ "type": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "resource",
+ "type"
+ ],
+ "type": "object"
+ },
+ "EmbeddedResourceResource": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/TextResourceContents"
+ },
+ {
+ "$ref": "#/definitions/BlobResourceContents"
+ }
+ ]
+ },
+ "FileUpdateChange": {
+ "properties": {
+ "diff": {
+ "type": "string"
+ },
+ "kind": {
+ "$ref": "#/definitions/PatchChangeKind"
+ },
+ "path": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "diff",
+ "kind",
+ "path"
+ ],
+ "type": "object"
+ },
+ "ImageContent": {
+ "description": "An image provided to or from an LLM.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "data": {
+ "type": "string"
+ },
+ "mimeType": {
+ "type": "string"
+ },
+ "type": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "data",
+ "mimeType",
+ "type"
+ ],
+ "type": "object"
+ },
+ "McpToolCallError": {
+ "properties": {
+ "message": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "message"
+ ],
+ "type": "object"
+ },
+ "McpToolCallResult": {
+ "properties": {
+ "content": {
+ "items": {
+ "$ref": "#/definitions/ContentBlock"
+ },
+ "type": "array"
+ },
+ "structuredContent": true
+ },
+ "required": [
+ "content"
+ ],
+ "type": "object"
+ },
+ "McpToolCallStatus": {
+ "enum": [
+ "inProgress",
+ "completed",
+ "failed"
+ ],
+ "type": "string"
+ },
+ "PatchApplyStatus": {
+ "enum": [
+ "inProgress",
+ "completed",
+ "failed",
+ "declined"
+ ],
+ "type": "string"
+ },
+ "PatchChangeKind": {
+ "oneOf": [
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "add"
+ ],
+ "title": "AddPatchChangeKindType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "AddPatchChangeKind",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "delete"
+ ],
+ "title": "DeletePatchChangeKindType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "DeletePatchChangeKind",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "move_path": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "update"
+ ],
+ "title": "UpdatePatchChangeKindType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "UpdatePatchChangeKind",
+ "type": "object"
+ }
+ ]
+ },
+ "ResourceLink": {
+ "description": "A resource that the server is capable of reading, included in a prompt or tool call result.\n\nNote: resource links returned by tools are not guaranteed to appear in the results of `resources/list` requests.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "description": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "mimeType": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "name": {
+ "type": "string"
+ },
+ "size": {
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "title": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "type": "string"
+ },
+ "uri": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "type",
+ "uri"
+ ],
+ "type": "object"
+ },
+ "Role": {
+ "description": "The sender or recipient of messages and data in a conversation.",
+ "enum": [
+ "assistant",
+ "user"
+ ],
+ "type": "string"
+ },
+ "TextContent": {
+ "description": "Text provided to or from an LLM.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "type": "object"
+ },
+ "TextElement": {
+ "properties": {
+ "byteRange": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ByteRange"
+ }
+ ],
+ "description": "Byte range in the parent `text` buffer that this element occupies."
+ },
+ "placeholder": {
+ "description": "Optional human-readable placeholder for the element, displayed in the UI.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "byteRange"
+ ],
+ "type": "object"
+ },
+ "TextResourceContents": {
+ "properties": {
+ "mimeType": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "text": {
+ "type": "string"
+ },
+ "uri": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "uri"
+ ],
+ "type": "object"
+ },
+ "ThreadItem": {
+ "oneOf": [
+ {
+ "properties": {
+ "content": {
+ "items": {
+ "$ref": "#/definitions/UserInput"
+ },
+ "type": "array"
+ },
+ "id": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "userMessage"
+ ],
+ "title": "UserMessageThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "content",
+ "id",
+ "type"
+ ],
+ "title": "UserMessageThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "agentMessage"
+ ],
+ "title": "AgentMessageThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "text",
+ "type"
+ ],
+ "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": {
+ "default": [],
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "id": {
+ "type": "string"
+ },
+ "summary": {
+ "default": [],
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "type": {
+ "enum": [
+ "reasoning"
+ ],
+ "title": "ReasoningThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "type"
+ ],
+ "title": "ReasoningThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "aggregatedOutput": {
+ "description": "The command's output, aggregated from stdout and stderr.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "command": {
+ "description": "The command to be executed.",
+ "type": "string"
+ },
+ "commandActions": {
+ "description": "A best-effort parsing of the command to understand the action(s) it will perform. This returns a list of CommandAction objects because a single shell command may be composed of many commands piped together.",
+ "items": {
+ "$ref": "#/definitions/CommandAction"
+ },
+ "type": "array"
+ },
+ "cwd": {
+ "description": "The command's working directory.",
+ "type": "string"
+ },
+ "durationMs": {
+ "description": "The duration of the command execution in milliseconds.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "exitCode": {
+ "description": "The command's exit code.",
+ "format": "int32",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "id": {
+ "type": "string"
+ },
+ "processId": {
+ "description": "Identifier for the underlying PTY process (when available).",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "status": {
+ "$ref": "#/definitions/CommandExecutionStatus"
+ },
+ "type": {
+ "enum": [
+ "commandExecution"
+ ],
+ "title": "CommandExecutionThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "command",
+ "commandActions",
+ "cwd",
+ "id",
+ "status",
+ "type"
+ ],
+ "title": "CommandExecutionThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "changes": {
+ "items": {
+ "$ref": "#/definitions/FileUpdateChange"
+ },
+ "type": "array"
+ },
+ "id": {
+ "type": "string"
+ },
+ "status": {
+ "$ref": "#/definitions/PatchApplyStatus"
+ },
+ "type": {
+ "enum": [
+ "fileChange"
+ ],
+ "title": "FileChangeThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "changes",
+ "id",
+ "status",
+ "type"
+ ],
+ "title": "FileChangeThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "arguments": true,
+ "durationMs": {
+ "description": "The duration of the MCP tool call in milliseconds.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "error": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/McpToolCallError"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "id": {
+ "type": "string"
+ },
+ "result": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/McpToolCallResult"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "server": {
+ "type": "string"
+ },
+ "status": {
+ "$ref": "#/definitions/McpToolCallStatus"
+ },
+ "tool": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "mcpToolCall"
+ ],
+ "title": "McpToolCallThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "arguments",
+ "id",
+ "server",
+ "status",
+ "tool",
+ "type"
+ ],
+ "title": "McpToolCallThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "agentsStates": {
+ "additionalProperties": {
+ "$ref": "#/definitions/CollabAgentState"
+ },
+ "description": "Last known status of the target agents, when available.",
+ "type": "object"
+ },
+ "id": {
+ "description": "Unique identifier for this collab tool call.",
+ "type": "string"
+ },
+ "prompt": {
+ "description": "Prompt text sent as part of the collab tool call, when available.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "receiverThreadIds": {
+ "description": "Thread ID of the receiving agent, when applicable. In case of spawn operation, this corresponds to the newly spawned agent.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "senderThreadId": {
+ "description": "Thread ID of the agent issuing the collab request.",
+ "type": "string"
+ },
+ "status": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/CollabAgentToolCallStatus"
+ }
+ ],
+ "description": "Current status of the collab tool call."
+ },
+ "tool": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/CollabAgentTool"
+ }
+ ],
+ "description": "Name of the collab tool that was invoked."
+ },
+ "type": {
+ "enum": [
+ "collabAgentToolCall"
+ ],
+ "title": "CollabAgentToolCallThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "agentsStates",
+ "id",
+ "receiverThreadIds",
+ "senderThreadId",
+ "status",
+ "tool",
+ "type"
+ ],
+ "title": "CollabAgentToolCallThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "action": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/WebSearchAction"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "id": {
+ "type": "string"
+ },
+ "query": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "webSearch"
+ ],
+ "title": "WebSearchThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "query",
+ "type"
+ ],
+ "title": "WebSearchThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "imageView"
+ ],
+ "title": "ImageViewThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "path",
+ "type"
+ ],
+ "title": "ImageViewThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "review": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "enteredReviewMode"
+ ],
+ "title": "EnteredReviewModeThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "review",
+ "type"
+ ],
+ "title": "EnteredReviewModeThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "review": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "exitedReviewMode"
+ ],
+ "title": "ExitedReviewModeThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "review",
+ "type"
+ ],
+ "title": "ExitedReviewModeThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "contextCompaction"
+ ],
+ "title": "ContextCompactionThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "type"
+ ],
+ "title": "ContextCompactionThreadItem",
+ "type": "object"
+ }
+ ]
+ },
+ "UserInput": {
+ "oneOf": [
+ {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "text_elements": {
+ "default": [],
+ "description": "UI-defined spans within `text` used to render or persist special elements.",
+ "items": {
+ "$ref": "#/definitions/TextElement"
+ },
+ "type": "array"
+ },
+ "type": {
+ "enum": [
+ "text"
+ ],
+ "title": "TextUserInputType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "TextUserInput",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "image"
+ ],
+ "title": "ImageUserInputType",
+ "type": "string"
+ },
+ "url": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "url"
+ ],
+ "title": "ImageUserInput",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "localImage"
+ ],
+ "title": "LocalImageUserInputType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "path",
+ "type"
+ ],
+ "title": "LocalImageUserInput",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "name": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "skill"
+ ],
+ "title": "SkillUserInputType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "path",
+ "type"
+ ],
+ "title": "SkillUserInput",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "name": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "mention"
+ ],
+ "title": "MentionUserInputType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "path",
+ "type"
+ ],
+ "title": "MentionUserInput",
+ "type": "object"
+ }
+ ]
+ },
+ "WebSearchAction": {
+ "oneOf": [
+ {
+ "properties": {
+ "queries": {
+ "items": {
+ "type": "string"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "query": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "search"
+ ],
+ "title": "SearchWebSearchActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "SearchWebSearchAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "openPage"
+ ],
+ "title": "OpenPageWebSearchActionType",
+ "type": "string"
+ },
+ "url": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "OpenPageWebSearchAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "pattern": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "findInPage"
+ ],
+ "title": "FindInPageWebSearchActionType",
+ "type": "string"
+ },
+ "url": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "FindInPageWebSearchAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "other"
+ ],
+ "title": "OtherWebSearchActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "OtherWebSearchAction",
+ "type": "object"
+ }
+ ]
+ }
+ },
+ "properties": {
+ "item": {
+ "$ref": "#/definitions/ThreadItem"
+ },
+ "threadId": {
+ "type": "string"
+ },
+ "turnId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "item",
+ "threadId",
+ "turnId"
+ ],
+ "title": "ItemStartedNotification",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v2/ListMcpServerStatusParams.json b/codex-rs/app-server-protocol/schema/json/v2/ListMcpServerStatusParams.json
new file mode 100644
index 0000000000..e78dbeac16
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v2/ListMcpServerStatusParams.json
@@ -0,0 +1,23 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "cursor": {
+ "description": "Opaque pagination cursor returned by a previous call.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "limit": {
+ "description": "Optional page size; defaults to a server-defined value.",
+ "format": "uint32",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "title": "ListMcpServerStatusParams",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v2/ListMcpServerStatusResponse.json b/codex-rs/app-server-protocol/schema/json/v2/ListMcpServerStatusResponse.json
new file mode 100644
index 0000000000..2ee4926965
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v2/ListMcpServerStatusResponse.json
@@ -0,0 +1,325 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "definitions": {
+ "Annotations": {
+ "description": "Optional annotations for the client. The client can use annotations to inform how objects are used or displayed",
+ "properties": {
+ "audience": {
+ "items": {
+ "$ref": "#/definitions/Role"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "lastModified": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "priority": {
+ "format": "double",
+ "type": [
+ "number",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "McpAuthStatus": {
+ "enum": [
+ "unsupported",
+ "notLoggedIn",
+ "bearerToken",
+ "oAuth"
+ ],
+ "type": "string"
+ },
+ "McpServerStatus": {
+ "properties": {
+ "authStatus": {
+ "$ref": "#/definitions/McpAuthStatus"
+ },
+ "name": {
+ "type": "string"
+ },
+ "resourceTemplates": {
+ "items": {
+ "$ref": "#/definitions/ResourceTemplate"
+ },
+ "type": "array"
+ },
+ "resources": {
+ "items": {
+ "$ref": "#/definitions/Resource"
+ },
+ "type": "array"
+ },
+ "tools": {
+ "additionalProperties": {
+ "$ref": "#/definitions/Tool"
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "authStatus",
+ "name",
+ "resourceTemplates",
+ "resources",
+ "tools"
+ ],
+ "type": "object"
+ },
+ "Resource": {
+ "description": "A known resource that the server is capable of reading.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "description": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "mimeType": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "name": {
+ "type": "string"
+ },
+ "size": {
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "title": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "uri": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "uri"
+ ],
+ "type": "object"
+ },
+ "ResourceTemplate": {
+ "description": "A template description for resources available on the server.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "description": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "mimeType": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "name": {
+ "type": "string"
+ },
+ "title": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "uriTemplate": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "uriTemplate"
+ ],
+ "type": "object"
+ },
+ "Role": {
+ "description": "The sender or recipient of messages and data in a conversation.",
+ "enum": [
+ "assistant",
+ "user"
+ ],
+ "type": "string"
+ },
+ "Tool": {
+ "description": "Definition for a tool the client can call.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ToolAnnotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "description": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "inputSchema": {
+ "$ref": "#/definitions/ToolInputSchema"
+ },
+ "name": {
+ "type": "string"
+ },
+ "outputSchema": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ToolOutputSchema"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "title": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "inputSchema",
+ "name"
+ ],
+ "type": "object"
+ },
+ "ToolAnnotations": {
+ "description": "Additional properties describing a Tool to clients.\n\nNOTE: all properties in ToolAnnotations are **hints**. They are not guaranteed to provide a faithful description of tool behavior (including descriptive properties like `title`).\n\nClients should never make tool use decisions based on ToolAnnotations received from untrusted servers.",
+ "properties": {
+ "destructiveHint": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "idempotentHint": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "openWorldHint": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "readOnlyHint": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "title": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "ToolInputSchema": {
+ "description": "A JSON Schema object defining the expected parameters for the tool.",
+ "properties": {
+ "properties": true,
+ "required": {
+ "items": {
+ "type": "string"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "type": {
+ "default": "object",
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "ToolOutputSchema": {
+ "description": "An optional JSON Schema object defining the structure of the tool's output returned in the structuredContent field of a CallToolResult.",
+ "properties": {
+ "properties": true,
+ "required": {
+ "items": {
+ "type": "string"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "type": {
+ "default": "object",
+ "type": "string"
+ }
+ },
+ "type": "object"
+ }
+ },
+ "properties": {
+ "data": {
+ "items": {
+ "$ref": "#/definitions/McpServerStatus"
+ },
+ "type": "array"
+ },
+ "nextCursor": {
+ "description": "Opaque cursor to pass to the next call to continue after the last item. If None, there are no more items to return.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "data"
+ ],
+ "title": "ListMcpServerStatusResponse",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v2/LoginAccountParams.json b/codex-rs/app-server-protocol/schema/json/v2/LoginAccountParams.json
new file mode 100644
index 0000000000..66df09435b
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v2/LoginAccountParams.json
@@ -0,0 +1,69 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "oneOf": [
+ {
+ "properties": {
+ "apiKey": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "apiKey"
+ ],
+ "title": "ApiKeyv2::LoginAccountParamsType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "apiKey",
+ "type"
+ ],
+ "title": "ApiKeyv2::LoginAccountParams",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "chatgpt"
+ ],
+ "title": "Chatgptv2::LoginAccountParamsType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "Chatgptv2::LoginAccountParams",
+ "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": "ChatgptAuthTokensv2::LoginAccountParamsType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "accessToken",
+ "idToken",
+ "type"
+ ],
+ "title": "ChatgptAuthTokensv2::LoginAccountParams",
+ "type": "object"
+ }
+ ],
+ "title": "LoginAccountParams"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v2/LoginAccountResponse.json b/codex-rs/app-server-protocol/schema/json/v2/LoginAccountResponse.json
new file mode 100644
index 0000000000..e2697ea44e
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v2/LoginAccountResponse.json
@@ -0,0 +1,63 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "oneOf": [
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "apiKey"
+ ],
+ "title": "ApiKeyv2::LoginAccountResponseType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "ApiKeyv2::LoginAccountResponse",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "authUrl": {
+ "description": "URL the client should open in a browser to initiate the OAuth flow.",
+ "type": "string"
+ },
+ "loginId": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "chatgpt"
+ ],
+ "title": "Chatgptv2::LoginAccountResponseType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "authUrl",
+ "loginId",
+ "type"
+ ],
+ "title": "Chatgptv2::LoginAccountResponse",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "chatgptAuthTokens"
+ ],
+ "title": "ChatgptAuthTokensv2::LoginAccountResponseType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "ChatgptAuthTokensv2::LoginAccountResponse",
+ "type": "object"
+ }
+ ],
+ "title": "LoginAccountResponse"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v2/LogoutAccountResponse.json b/codex-rs/app-server-protocol/schema/json/v2/LogoutAccountResponse.json
new file mode 100644
index 0000000000..56415a0311
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v2/LogoutAccountResponse.json
@@ -0,0 +1,5 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "title": "LogoutAccountResponse",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v2/McpServerOauthLoginCompletedNotification.json b/codex-rs/app-server-protocol/schema/json/v2/McpServerOauthLoginCompletedNotification.json
new file mode 100644
index 0000000000..35efd2baf2
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v2/McpServerOauthLoginCompletedNotification.json
@@ -0,0 +1,23 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "error": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "name": {
+ "type": "string"
+ },
+ "success": {
+ "type": "boolean"
+ }
+ },
+ "required": [
+ "name",
+ "success"
+ ],
+ "title": "McpServerOauthLoginCompletedNotification",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v2/McpServerOauthLoginParams.json b/codex-rs/app-server-protocol/schema/json/v2/McpServerOauthLoginParams.json
new file mode 100644
index 0000000000..4370f444b9
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v2/McpServerOauthLoginParams.json
@@ -0,0 +1,29 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "name": {
+ "type": "string"
+ },
+ "scopes": {
+ "items": {
+ "type": "string"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "timeoutSecs": {
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "name"
+ ],
+ "title": "McpServerOauthLoginParams",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v2/McpServerOauthLoginResponse.json b/codex-rs/app-server-protocol/schema/json/v2/McpServerOauthLoginResponse.json
new file mode 100644
index 0000000000..efeb612dd3
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v2/McpServerOauthLoginResponse.json
@@ -0,0 +1,13 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "authorizationUrl": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "authorizationUrl"
+ ],
+ "title": "McpServerOauthLoginResponse",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v2/McpServerRefreshResponse.json b/codex-rs/app-server-protocol/schema/json/v2/McpServerRefreshResponse.json
new file mode 100644
index 0000000000..779192e779
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v2/McpServerRefreshResponse.json
@@ -0,0 +1,5 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "title": "McpServerRefreshResponse",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v2/McpToolCallProgressNotification.json b/codex-rs/app-server-protocol/schema/json/v2/McpToolCallProgressNotification.json
new file mode 100644
index 0000000000..419cab74a3
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v2/McpToolCallProgressNotification.json
@@ -0,0 +1,25 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "itemId": {
+ "type": "string"
+ },
+ "message": {
+ "type": "string"
+ },
+ "threadId": {
+ "type": "string"
+ },
+ "turnId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "itemId",
+ "message",
+ "threadId",
+ "turnId"
+ ],
+ "title": "McpToolCallProgressNotification",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v2/ModelListParams.json b/codex-rs/app-server-protocol/schema/json/v2/ModelListParams.json
new file mode 100644
index 0000000000..13bb29977e
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v2/ModelListParams.json
@@ -0,0 +1,23 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "cursor": {
+ "description": "Opaque pagination cursor returned by a previous call.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "limit": {
+ "description": "Optional page size; defaults to a reasonable server-side value.",
+ "format": "uint32",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "title": "ModelListParams",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v2/ModelListResponse.json b/codex-rs/app-server-protocol/schema/json/v2/ModelListResponse.json
new file mode 100644
index 0000000000..d41f13a87d
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v2/ModelListResponse.json
@@ -0,0 +1,94 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "definitions": {
+ "Model": {
+ "properties": {
+ "defaultReasoningEffort": {
+ "$ref": "#/definitions/ReasoningEffort"
+ },
+ "description": {
+ "type": "string"
+ },
+ "displayName": {
+ "type": "string"
+ },
+ "id": {
+ "type": "string"
+ },
+ "isDefault": {
+ "type": "boolean"
+ },
+ "model": {
+ "type": "string"
+ },
+ "supportedReasoningEfforts": {
+ "items": {
+ "$ref": "#/definitions/ReasoningEffortOption"
+ },
+ "type": "array"
+ },
+ "supportsPersonality": {
+ "default": false,
+ "type": "boolean"
+ }
+ },
+ "required": [
+ "defaultReasoningEffort",
+ "description",
+ "displayName",
+ "id",
+ "isDefault",
+ "model",
+ "supportedReasoningEfforts"
+ ],
+ "type": "object"
+ },
+ "ReasoningEffort": {
+ "description": "See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#get-started-with-reasoning",
+ "enum": [
+ "none",
+ "minimal",
+ "low",
+ "medium",
+ "high",
+ "xhigh"
+ ],
+ "type": "string"
+ },
+ "ReasoningEffortOption": {
+ "properties": {
+ "description": {
+ "type": "string"
+ },
+ "reasoningEffort": {
+ "$ref": "#/definitions/ReasoningEffort"
+ }
+ },
+ "required": [
+ "description",
+ "reasoningEffort"
+ ],
+ "type": "object"
+ }
+ },
+ "properties": {
+ "data": {
+ "items": {
+ "$ref": "#/definitions/Model"
+ },
+ "type": "array"
+ },
+ "nextCursor": {
+ "description": "Opaque cursor to pass to the next call to continue after the last item. If None, there are no more items to return.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "data"
+ ],
+ "title": "ModelListResponse",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v2/PlanDeltaNotification.json b/codex-rs/app-server-protocol/schema/json/v2/PlanDeltaNotification.json
new file mode 100644
index 0000000000..6446392626
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v2/PlanDeltaNotification.json
@@ -0,0 +1,26 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "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"
+ ],
+ "title": "PlanDeltaNotification",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v2/RawResponseItemCompletedNotification.json b/codex-rs/app-server-protocol/schema/json/v2/RawResponseItemCompletedNotification.json
new file mode 100644
index 0000000000..47039df05b
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v2/RawResponseItemCompletedNotification.json
@@ -0,0 +1,770 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "definitions": {
+ "ContentItem": {
+ "oneOf": [
+ {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "input_text"
+ ],
+ "title": "InputTextContentItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "InputTextContentItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "image_url": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "input_image"
+ ],
+ "title": "InputImageContentItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "image_url",
+ "type"
+ ],
+ "title": "InputImageContentItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "output_text"
+ ],
+ "title": "OutputTextContentItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "OutputTextContentItem",
+ "type": "object"
+ }
+ ]
+ },
+ "FunctionCallOutputContentItem": {
+ "description": "Responses API compatible content items that can be returned by a tool call. This is a subset of ContentItem with the types we support as function call outputs.",
+ "oneOf": [
+ {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "input_text"
+ ],
+ "title": "InputTextFunctionCallOutputContentItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "InputTextFunctionCallOutputContentItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "image_url": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "input_image"
+ ],
+ "title": "InputImageFunctionCallOutputContentItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "image_url",
+ "type"
+ ],
+ "title": "InputImageFunctionCallOutputContentItem",
+ "type": "object"
+ }
+ ]
+ },
+ "FunctionCallOutputPayload": {
+ "description": "The payload we send back to OpenAI when reporting a tool call result.\n\n`content` preserves the historical plain-string payload so downstream integrations (tests, logging, etc.) can keep treating tool output as `String`. When an MCP server returns richer data we additionally populate `content_items` with the structured form that the Responses/Chat Completions APIs understand.",
+ "properties": {
+ "content": {
+ "type": "string"
+ },
+ "content_items": {
+ "items": {
+ "$ref": "#/definitions/FunctionCallOutputContentItem"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "success": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "content"
+ ],
+ "type": "object"
+ },
+ "GhostCommit": {
+ "description": "Details of a ghost commit created from a repository state.",
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "parent": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "preexisting_untracked_dirs": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "preexisting_untracked_files": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ }
+ },
+ "required": [
+ "id",
+ "preexisting_untracked_dirs",
+ "preexisting_untracked_files"
+ ],
+ "type": "object"
+ },
+ "LocalShellAction": {
+ "oneOf": [
+ {
+ "properties": {
+ "command": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "env": {
+ "additionalProperties": {
+ "type": "string"
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "timeout_ms": {
+ "format": "uint64",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "exec"
+ ],
+ "title": "ExecLocalShellActionType",
+ "type": "string"
+ },
+ "user": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "working_directory": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "command",
+ "type"
+ ],
+ "title": "ExecLocalShellAction",
+ "type": "object"
+ }
+ ]
+ },
+ "LocalShellStatus": {
+ "enum": [
+ "completed",
+ "in_progress",
+ "incomplete"
+ ],
+ "type": "string"
+ },
+ "ReasoningItemContent": {
+ "oneOf": [
+ {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "reasoning_text"
+ ],
+ "title": "ReasoningTextReasoningItemContentType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "ReasoningTextReasoningItemContent",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "text"
+ ],
+ "title": "TextReasoningItemContentType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "TextReasoningItemContent",
+ "type": "object"
+ }
+ ]
+ },
+ "ReasoningItemReasoningSummary": {
+ "oneOf": [
+ {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "summary_text"
+ ],
+ "title": "SummaryTextReasoningItemReasoningSummaryType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "SummaryTextReasoningItemReasoningSummary",
+ "type": "object"
+ }
+ ]
+ },
+ "ResponseItem": {
+ "oneOf": [
+ {
+ "properties": {
+ "content": {
+ "items": {
+ "$ref": "#/definitions/ContentItem"
+ },
+ "type": "array"
+ },
+ "end_turn": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "id": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "writeOnly": true
+ },
+ "role": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "message"
+ ],
+ "title": "MessageResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "content",
+ "role",
+ "type"
+ ],
+ "title": "MessageResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "content": {
+ "default": null,
+ "items": {
+ "$ref": "#/definitions/ReasoningItemContent"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "encrypted_content": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "id": {
+ "type": "string",
+ "writeOnly": true
+ },
+ "summary": {
+ "items": {
+ "$ref": "#/definitions/ReasoningItemReasoningSummary"
+ },
+ "type": "array"
+ },
+ "type": {
+ "enum": [
+ "reasoning"
+ ],
+ "title": "ReasoningResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "summary",
+ "type"
+ ],
+ "title": "ReasoningResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "action": {
+ "$ref": "#/definitions/LocalShellAction"
+ },
+ "call_id": {
+ "description": "Set when using the Responses API.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "id": {
+ "description": "Set when using the chat completions API.",
+ "type": [
+ "string",
+ "null"
+ ],
+ "writeOnly": true
+ },
+ "status": {
+ "$ref": "#/definitions/LocalShellStatus"
+ },
+ "type": {
+ "enum": [
+ "local_shell_call"
+ ],
+ "title": "LocalShellCallResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "action",
+ "status",
+ "type"
+ ],
+ "title": "LocalShellCallResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "arguments": {
+ "type": "string"
+ },
+ "call_id": {
+ "type": "string"
+ },
+ "id": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "writeOnly": true
+ },
+ "name": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "function_call"
+ ],
+ "title": "FunctionCallResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "arguments",
+ "call_id",
+ "name",
+ "type"
+ ],
+ "title": "FunctionCallResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "call_id": {
+ "type": "string"
+ },
+ "output": {
+ "$ref": "#/definitions/FunctionCallOutputPayload"
+ },
+ "type": {
+ "enum": [
+ "function_call_output"
+ ],
+ "title": "FunctionCallOutputResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "output",
+ "type"
+ ],
+ "title": "FunctionCallOutputResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "call_id": {
+ "type": "string"
+ },
+ "id": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "writeOnly": true
+ },
+ "input": {
+ "type": "string"
+ },
+ "name": {
+ "type": "string"
+ },
+ "status": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "custom_tool_call"
+ ],
+ "title": "CustomToolCallResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "input",
+ "name",
+ "type"
+ ],
+ "title": "CustomToolCallResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "call_id": {
+ "type": "string"
+ },
+ "output": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "custom_tool_call_output"
+ ],
+ "title": "CustomToolCallOutputResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "output",
+ "type"
+ ],
+ "title": "CustomToolCallOutputResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "action": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/WebSearchAction"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "id": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "writeOnly": true
+ },
+ "status": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "web_search_call"
+ ],
+ "title": "WebSearchCallResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "WebSearchCallResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "ghost_commit": {
+ "$ref": "#/definitions/GhostCommit"
+ },
+ "type": {
+ "enum": [
+ "ghost_snapshot"
+ ],
+ "title": "GhostSnapshotResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "ghost_commit",
+ "type"
+ ],
+ "title": "GhostSnapshotResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "encrypted_content": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "compaction"
+ ],
+ "title": "CompactionResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "encrypted_content",
+ "type"
+ ],
+ "title": "CompactionResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "other"
+ ],
+ "title": "OtherResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "OtherResponseItem",
+ "type": "object"
+ }
+ ]
+ },
+ "WebSearchAction": {
+ "oneOf": [
+ {
+ "properties": {
+ "queries": {
+ "items": {
+ "type": "string"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "query": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "search"
+ ],
+ "title": "SearchWebSearchActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "SearchWebSearchAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "open_page"
+ ],
+ "title": "OpenPageWebSearchActionType",
+ "type": "string"
+ },
+ "url": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "OpenPageWebSearchAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "pattern": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "find_in_page"
+ ],
+ "title": "FindInPageWebSearchActionType",
+ "type": "string"
+ },
+ "url": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "FindInPageWebSearchAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "other"
+ ],
+ "title": "OtherWebSearchActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "OtherWebSearchAction",
+ "type": "object"
+ }
+ ]
+ }
+ },
+ "properties": {
+ "item": {
+ "$ref": "#/definitions/ResponseItem"
+ },
+ "threadId": {
+ "type": "string"
+ },
+ "turnId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "item",
+ "threadId",
+ "turnId"
+ ],
+ "title": "RawResponseItemCompletedNotification",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v2/ReasoningSummaryPartAddedNotification.json b/codex-rs/app-server-protocol/schema/json/v2/ReasoningSummaryPartAddedNotification.json
new file mode 100644
index 0000000000..33debf2a2e
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v2/ReasoningSummaryPartAddedNotification.json
@@ -0,0 +1,26 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "itemId": {
+ "type": "string"
+ },
+ "summaryIndex": {
+ "format": "int64",
+ "type": "integer"
+ },
+ "threadId": {
+ "type": "string"
+ },
+ "turnId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "itemId",
+ "summaryIndex",
+ "threadId",
+ "turnId"
+ ],
+ "title": "ReasoningSummaryPartAddedNotification",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v2/ReasoningSummaryTextDeltaNotification.json b/codex-rs/app-server-protocol/schema/json/v2/ReasoningSummaryTextDeltaNotification.json
new file mode 100644
index 0000000000..6f50a8403a
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v2/ReasoningSummaryTextDeltaNotification.json
@@ -0,0 +1,30 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "delta": {
+ "type": "string"
+ },
+ "itemId": {
+ "type": "string"
+ },
+ "summaryIndex": {
+ "format": "int64",
+ "type": "integer"
+ },
+ "threadId": {
+ "type": "string"
+ },
+ "turnId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "delta",
+ "itemId",
+ "summaryIndex",
+ "threadId",
+ "turnId"
+ ],
+ "title": "ReasoningSummaryTextDeltaNotification",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v2/ReasoningTextDeltaNotification.json b/codex-rs/app-server-protocol/schema/json/v2/ReasoningTextDeltaNotification.json
new file mode 100644
index 0000000000..ebfd5dc854
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v2/ReasoningTextDeltaNotification.json
@@ -0,0 +1,30 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "contentIndex": {
+ "format": "int64",
+ "type": "integer"
+ },
+ "delta": {
+ "type": "string"
+ },
+ "itemId": {
+ "type": "string"
+ },
+ "threadId": {
+ "type": "string"
+ },
+ "turnId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "contentIndex",
+ "delta",
+ "itemId",
+ "threadId",
+ "turnId"
+ ],
+ "title": "ReasoningTextDeltaNotification",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v2/ReviewStartParams.json b/codex-rs/app-server-protocol/schema/json/v2/ReviewStartParams.json
new file mode 100644
index 0000000000..0089d46491
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v2/ReviewStartParams.json
@@ -0,0 +1,129 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "definitions": {
+ "ReviewDelivery": {
+ "enum": [
+ "inline",
+ "detached"
+ ],
+ "type": "string"
+ },
+ "ReviewTarget": {
+ "oneOf": [
+ {
+ "description": "Review the working tree: staged, unstaged, and untracked files.",
+ "properties": {
+ "type": {
+ "enum": [
+ "uncommittedChanges"
+ ],
+ "title": "UncommittedChangesReviewTargetType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "UncommittedChangesReviewTarget",
+ "type": "object"
+ },
+ {
+ "description": "Review changes between the current branch and the given base branch.",
+ "properties": {
+ "branch": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "baseBranch"
+ ],
+ "title": "BaseBranchReviewTargetType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "branch",
+ "type"
+ ],
+ "title": "BaseBranchReviewTarget",
+ "type": "object"
+ },
+ {
+ "description": "Review the changes introduced by a specific commit.",
+ "properties": {
+ "sha": {
+ "type": "string"
+ },
+ "title": {
+ "description": "Optional human-readable label (e.g., commit subject) for UIs.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "commit"
+ ],
+ "title": "CommitReviewTargetType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "sha",
+ "type"
+ ],
+ "title": "CommitReviewTarget",
+ "type": "object"
+ },
+ {
+ "description": "Arbitrary instructions, equivalent to the old free-form prompt.",
+ "properties": {
+ "instructions": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "custom"
+ ],
+ "title": "CustomReviewTargetType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "instructions",
+ "type"
+ ],
+ "title": "CustomReviewTarget",
+ "type": "object"
+ }
+ ]
+ }
+ },
+ "properties": {
+ "delivery": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ReviewDelivery"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "default": null,
+ "description": "Where to run the review: inline (default) on the current thread or detached on a new thread (returned in `reviewThreadId`)."
+ },
+ "target": {
+ "$ref": "#/definitions/ReviewTarget"
+ },
+ "threadId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "target",
+ "threadId"
+ ],
+ "title": "ReviewStartParams",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v2/ReviewStartResponse.json b/codex-rs/app-server-protocol/schema/json/v2/ReviewStartResponse.json
new file mode 100644
index 0000000000..341ff78c0a
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v2/ReviewStartResponse.json
@@ -0,0 +1,1526 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "definitions": {
+ "Annotations": {
+ "description": "Optional annotations for the client. The client can use annotations to inform how objects are used or displayed",
+ "properties": {
+ "audience": {
+ "items": {
+ "$ref": "#/definitions/Role"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "lastModified": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "priority": {
+ "format": "double",
+ "type": [
+ "number",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "AudioContent": {
+ "description": "Audio provided to or from an LLM.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "data": {
+ "type": "string"
+ },
+ "mimeType": {
+ "type": "string"
+ },
+ "type": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "data",
+ "mimeType",
+ "type"
+ ],
+ "type": "object"
+ },
+ "BlobResourceContents": {
+ "properties": {
+ "blob": {
+ "type": "string"
+ },
+ "mimeType": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "uri": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "blob",
+ "uri"
+ ],
+ "type": "object"
+ },
+ "ByteRange": {
+ "properties": {
+ "end": {
+ "format": "uint",
+ "minimum": 0.0,
+ "type": "integer"
+ },
+ "start": {
+ "format": "uint",
+ "minimum": 0.0,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "end",
+ "start"
+ ],
+ "type": "object"
+ },
+ "CodexErrorInfo": {
+ "description": "This translation layer make sure that we expose codex error code in camel case.\n\nWhen an upstream HTTP status is available (for example, from the Responses API or a provider), it is forwarded in `httpStatusCode` on the relevant `codexErrorInfo` variant.",
+ "oneOf": [
+ {
+ "enum": [
+ "contextWindowExceeded",
+ "usageLimitExceeded",
+ "internalServerError",
+ "unauthorized",
+ "badRequest",
+ "threadRollbackFailed",
+ "sandboxError",
+ "other"
+ ],
+ "type": "string"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "modelCap": {
+ "properties": {
+ "model": {
+ "type": "string"
+ },
+ "reset_after_seconds": {
+ "format": "uint64",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "model"
+ ],
+ "type": "object"
+ }
+ },
+ "required": [
+ "modelCap"
+ ],
+ "title": "ModelCapCodexErrorInfo",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "httpConnectionFailed": {
+ "properties": {
+ "httpStatusCode": {
+ "format": "uint16",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "httpConnectionFailed"
+ ],
+ "title": "HttpConnectionFailedCodexErrorInfo",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "Failed to connect to the response SSE stream.",
+ "properties": {
+ "responseStreamConnectionFailed": {
+ "properties": {
+ "httpStatusCode": {
+ "format": "uint16",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "responseStreamConnectionFailed"
+ ],
+ "title": "ResponseStreamConnectionFailedCodexErrorInfo",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "The response SSE stream disconnected in the middle of a turn before completion.",
+ "properties": {
+ "responseStreamDisconnected": {
+ "properties": {
+ "httpStatusCode": {
+ "format": "uint16",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "responseStreamDisconnected"
+ ],
+ "title": "ResponseStreamDisconnectedCodexErrorInfo",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "Reached the retry limit for responses.",
+ "properties": {
+ "responseTooManyFailedAttempts": {
+ "properties": {
+ "httpStatusCode": {
+ "format": "uint16",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "responseTooManyFailedAttempts"
+ ],
+ "title": "ResponseTooManyFailedAttemptsCodexErrorInfo",
+ "type": "object"
+ }
+ ]
+ },
+ "CollabAgentState": {
+ "properties": {
+ "message": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "status": {
+ "$ref": "#/definitions/CollabAgentStatus"
+ }
+ },
+ "required": [
+ "status"
+ ],
+ "type": "object"
+ },
+ "CollabAgentStatus": {
+ "enum": [
+ "pendingInit",
+ "running",
+ "completed",
+ "errored",
+ "shutdown",
+ "notFound"
+ ],
+ "type": "string"
+ },
+ "CollabAgentTool": {
+ "enum": [
+ "spawnAgent",
+ "sendInput",
+ "wait",
+ "closeAgent"
+ ],
+ "type": "string"
+ },
+ "CollabAgentToolCallStatus": {
+ "enum": [
+ "inProgress",
+ "completed",
+ "failed"
+ ],
+ "type": "string"
+ },
+ "CommandAction": {
+ "oneOf": [
+ {
+ "properties": {
+ "command": {
+ "type": "string"
+ },
+ "name": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "read"
+ ],
+ "title": "ReadCommandActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "command",
+ "name",
+ "path",
+ "type"
+ ],
+ "title": "ReadCommandAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "command": {
+ "type": "string"
+ },
+ "path": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "listFiles"
+ ],
+ "title": "ListFilesCommandActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "command",
+ "type"
+ ],
+ "title": "ListFilesCommandAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "command": {
+ "type": "string"
+ },
+ "path": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "query": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "search"
+ ],
+ "title": "SearchCommandActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "command",
+ "type"
+ ],
+ "title": "SearchCommandAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "command": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "unknown"
+ ],
+ "title": "UnknownCommandActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "command",
+ "type"
+ ],
+ "title": "UnknownCommandAction",
+ "type": "object"
+ }
+ ]
+ },
+ "CommandExecutionStatus": {
+ "enum": [
+ "inProgress",
+ "completed",
+ "failed",
+ "declined"
+ ],
+ "type": "string"
+ },
+ "ContentBlock": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/TextContent"
+ },
+ {
+ "$ref": "#/definitions/ImageContent"
+ },
+ {
+ "$ref": "#/definitions/AudioContent"
+ },
+ {
+ "$ref": "#/definitions/ResourceLink"
+ },
+ {
+ "$ref": "#/definitions/EmbeddedResource"
+ }
+ ]
+ },
+ "EmbeddedResource": {
+ "description": "The contents of a resource, embedded into a prompt or tool call result.\n\nIt is up to the client how best to render embedded resources for the benefit of the LLM and/or the user.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "resource": {
+ "$ref": "#/definitions/EmbeddedResourceResource"
+ },
+ "type": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "resource",
+ "type"
+ ],
+ "type": "object"
+ },
+ "EmbeddedResourceResource": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/TextResourceContents"
+ },
+ {
+ "$ref": "#/definitions/BlobResourceContents"
+ }
+ ]
+ },
+ "FileUpdateChange": {
+ "properties": {
+ "diff": {
+ "type": "string"
+ },
+ "kind": {
+ "$ref": "#/definitions/PatchChangeKind"
+ },
+ "path": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "diff",
+ "kind",
+ "path"
+ ],
+ "type": "object"
+ },
+ "ImageContent": {
+ "description": "An image provided to or from an LLM.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "data": {
+ "type": "string"
+ },
+ "mimeType": {
+ "type": "string"
+ },
+ "type": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "data",
+ "mimeType",
+ "type"
+ ],
+ "type": "object"
+ },
+ "McpToolCallError": {
+ "properties": {
+ "message": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "message"
+ ],
+ "type": "object"
+ },
+ "McpToolCallResult": {
+ "properties": {
+ "content": {
+ "items": {
+ "$ref": "#/definitions/ContentBlock"
+ },
+ "type": "array"
+ },
+ "structuredContent": true
+ },
+ "required": [
+ "content"
+ ],
+ "type": "object"
+ },
+ "McpToolCallStatus": {
+ "enum": [
+ "inProgress",
+ "completed",
+ "failed"
+ ],
+ "type": "string"
+ },
+ "PatchApplyStatus": {
+ "enum": [
+ "inProgress",
+ "completed",
+ "failed",
+ "declined"
+ ],
+ "type": "string"
+ },
+ "PatchChangeKind": {
+ "oneOf": [
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "add"
+ ],
+ "title": "AddPatchChangeKindType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "AddPatchChangeKind",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "delete"
+ ],
+ "title": "DeletePatchChangeKindType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "DeletePatchChangeKind",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "move_path": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "update"
+ ],
+ "title": "UpdatePatchChangeKindType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "UpdatePatchChangeKind",
+ "type": "object"
+ }
+ ]
+ },
+ "ResourceLink": {
+ "description": "A resource that the server is capable of reading, included in a prompt or tool call result.\n\nNote: resource links returned by tools are not guaranteed to appear in the results of `resources/list` requests.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "description": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "mimeType": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "name": {
+ "type": "string"
+ },
+ "size": {
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "title": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "type": "string"
+ },
+ "uri": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "type",
+ "uri"
+ ],
+ "type": "object"
+ },
+ "Role": {
+ "description": "The sender or recipient of messages and data in a conversation.",
+ "enum": [
+ "assistant",
+ "user"
+ ],
+ "type": "string"
+ },
+ "TextContent": {
+ "description": "Text provided to or from an LLM.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "type": "object"
+ },
+ "TextElement": {
+ "properties": {
+ "byteRange": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ByteRange"
+ }
+ ],
+ "description": "Byte range in the parent `text` buffer that this element occupies."
+ },
+ "placeholder": {
+ "description": "Optional human-readable placeholder for the element, displayed in the UI.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "byteRange"
+ ],
+ "type": "object"
+ },
+ "TextResourceContents": {
+ "properties": {
+ "mimeType": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "text": {
+ "type": "string"
+ },
+ "uri": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "uri"
+ ],
+ "type": "object"
+ },
+ "ThreadItem": {
+ "oneOf": [
+ {
+ "properties": {
+ "content": {
+ "items": {
+ "$ref": "#/definitions/UserInput"
+ },
+ "type": "array"
+ },
+ "id": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "userMessage"
+ ],
+ "title": "UserMessageThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "content",
+ "id",
+ "type"
+ ],
+ "title": "UserMessageThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "agentMessage"
+ ],
+ "title": "AgentMessageThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "text",
+ "type"
+ ],
+ "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": {
+ "default": [],
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "id": {
+ "type": "string"
+ },
+ "summary": {
+ "default": [],
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "type": {
+ "enum": [
+ "reasoning"
+ ],
+ "title": "ReasoningThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "type"
+ ],
+ "title": "ReasoningThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "aggregatedOutput": {
+ "description": "The command's output, aggregated from stdout and stderr.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "command": {
+ "description": "The command to be executed.",
+ "type": "string"
+ },
+ "commandActions": {
+ "description": "A best-effort parsing of the command to understand the action(s) it will perform. This returns a list of CommandAction objects because a single shell command may be composed of many commands piped together.",
+ "items": {
+ "$ref": "#/definitions/CommandAction"
+ },
+ "type": "array"
+ },
+ "cwd": {
+ "description": "The command's working directory.",
+ "type": "string"
+ },
+ "durationMs": {
+ "description": "The duration of the command execution in milliseconds.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "exitCode": {
+ "description": "The command's exit code.",
+ "format": "int32",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "id": {
+ "type": "string"
+ },
+ "processId": {
+ "description": "Identifier for the underlying PTY process (when available).",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "status": {
+ "$ref": "#/definitions/CommandExecutionStatus"
+ },
+ "type": {
+ "enum": [
+ "commandExecution"
+ ],
+ "title": "CommandExecutionThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "command",
+ "commandActions",
+ "cwd",
+ "id",
+ "status",
+ "type"
+ ],
+ "title": "CommandExecutionThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "changes": {
+ "items": {
+ "$ref": "#/definitions/FileUpdateChange"
+ },
+ "type": "array"
+ },
+ "id": {
+ "type": "string"
+ },
+ "status": {
+ "$ref": "#/definitions/PatchApplyStatus"
+ },
+ "type": {
+ "enum": [
+ "fileChange"
+ ],
+ "title": "FileChangeThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "changes",
+ "id",
+ "status",
+ "type"
+ ],
+ "title": "FileChangeThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "arguments": true,
+ "durationMs": {
+ "description": "The duration of the MCP tool call in milliseconds.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "error": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/McpToolCallError"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "id": {
+ "type": "string"
+ },
+ "result": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/McpToolCallResult"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "server": {
+ "type": "string"
+ },
+ "status": {
+ "$ref": "#/definitions/McpToolCallStatus"
+ },
+ "tool": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "mcpToolCall"
+ ],
+ "title": "McpToolCallThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "arguments",
+ "id",
+ "server",
+ "status",
+ "tool",
+ "type"
+ ],
+ "title": "McpToolCallThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "agentsStates": {
+ "additionalProperties": {
+ "$ref": "#/definitions/CollabAgentState"
+ },
+ "description": "Last known status of the target agents, when available.",
+ "type": "object"
+ },
+ "id": {
+ "description": "Unique identifier for this collab tool call.",
+ "type": "string"
+ },
+ "prompt": {
+ "description": "Prompt text sent as part of the collab tool call, when available.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "receiverThreadIds": {
+ "description": "Thread ID of the receiving agent, when applicable. In case of spawn operation, this corresponds to the newly spawned agent.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "senderThreadId": {
+ "description": "Thread ID of the agent issuing the collab request.",
+ "type": "string"
+ },
+ "status": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/CollabAgentToolCallStatus"
+ }
+ ],
+ "description": "Current status of the collab tool call."
+ },
+ "tool": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/CollabAgentTool"
+ }
+ ],
+ "description": "Name of the collab tool that was invoked."
+ },
+ "type": {
+ "enum": [
+ "collabAgentToolCall"
+ ],
+ "title": "CollabAgentToolCallThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "agentsStates",
+ "id",
+ "receiverThreadIds",
+ "senderThreadId",
+ "status",
+ "tool",
+ "type"
+ ],
+ "title": "CollabAgentToolCallThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "action": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/WebSearchAction"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "id": {
+ "type": "string"
+ },
+ "query": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "webSearch"
+ ],
+ "title": "WebSearchThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "query",
+ "type"
+ ],
+ "title": "WebSearchThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "imageView"
+ ],
+ "title": "ImageViewThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "path",
+ "type"
+ ],
+ "title": "ImageViewThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "review": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "enteredReviewMode"
+ ],
+ "title": "EnteredReviewModeThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "review",
+ "type"
+ ],
+ "title": "EnteredReviewModeThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "review": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "exitedReviewMode"
+ ],
+ "title": "ExitedReviewModeThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "review",
+ "type"
+ ],
+ "title": "ExitedReviewModeThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "contextCompaction"
+ ],
+ "title": "ContextCompactionThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "type"
+ ],
+ "title": "ContextCompactionThreadItem",
+ "type": "object"
+ }
+ ]
+ },
+ "Turn": {
+ "properties": {
+ "error": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/TurnError"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Only populated when the Turn's status is failed."
+ },
+ "id": {
+ "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.",
+ "items": {
+ "$ref": "#/definitions/ThreadItem"
+ },
+ "type": "array"
+ },
+ "status": {
+ "$ref": "#/definitions/TurnStatus"
+ }
+ },
+ "required": [
+ "id",
+ "items",
+ "status"
+ ],
+ "type": "object"
+ },
+ "TurnError": {
+ "properties": {
+ "additionalDetails": {
+ "default": null,
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "codexErrorInfo": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/CodexErrorInfo"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "message": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "message"
+ ],
+ "type": "object"
+ },
+ "TurnStatus": {
+ "enum": [
+ "completed",
+ "interrupted",
+ "failed",
+ "inProgress"
+ ],
+ "type": "string"
+ },
+ "UserInput": {
+ "oneOf": [
+ {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "text_elements": {
+ "default": [],
+ "description": "UI-defined spans within `text` used to render or persist special elements.",
+ "items": {
+ "$ref": "#/definitions/TextElement"
+ },
+ "type": "array"
+ },
+ "type": {
+ "enum": [
+ "text"
+ ],
+ "title": "TextUserInputType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "TextUserInput",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "image"
+ ],
+ "title": "ImageUserInputType",
+ "type": "string"
+ },
+ "url": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "url"
+ ],
+ "title": "ImageUserInput",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "localImage"
+ ],
+ "title": "LocalImageUserInputType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "path",
+ "type"
+ ],
+ "title": "LocalImageUserInput",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "name": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "skill"
+ ],
+ "title": "SkillUserInputType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "path",
+ "type"
+ ],
+ "title": "SkillUserInput",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "name": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "mention"
+ ],
+ "title": "MentionUserInputType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "path",
+ "type"
+ ],
+ "title": "MentionUserInput",
+ "type": "object"
+ }
+ ]
+ },
+ "WebSearchAction": {
+ "oneOf": [
+ {
+ "properties": {
+ "queries": {
+ "items": {
+ "type": "string"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "query": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "search"
+ ],
+ "title": "SearchWebSearchActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "SearchWebSearchAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "openPage"
+ ],
+ "title": "OpenPageWebSearchActionType",
+ "type": "string"
+ },
+ "url": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "OpenPageWebSearchAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "pattern": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "findInPage"
+ ],
+ "title": "FindInPageWebSearchActionType",
+ "type": "string"
+ },
+ "url": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "FindInPageWebSearchAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "other"
+ ],
+ "title": "OtherWebSearchActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "OtherWebSearchAction",
+ "type": "object"
+ }
+ ]
+ }
+ },
+ "properties": {
+ "reviewThreadId": {
+ "description": "Identifies the thread where the review runs.\n\nFor inline reviews, this is the original thread id. For detached reviews, this is the id of the new review thread.",
+ "type": "string"
+ },
+ "turn": {
+ "$ref": "#/definitions/Turn"
+ }
+ },
+ "required": [
+ "reviewThreadId",
+ "turn"
+ ],
+ "title": "ReviewStartResponse",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v2/SkillsConfigWriteParams.json b/codex-rs/app-server-protocol/schema/json/v2/SkillsConfigWriteParams.json
new file mode 100644
index 0000000000..3fa74811d5
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v2/SkillsConfigWriteParams.json
@@ -0,0 +1,17 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "enabled": {
+ "type": "boolean"
+ },
+ "path": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "enabled",
+ "path"
+ ],
+ "title": "SkillsConfigWriteParams",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v2/SkillsConfigWriteResponse.json b/codex-rs/app-server-protocol/schema/json/v2/SkillsConfigWriteResponse.json
new file mode 100644
index 0000000000..09d73b44c3
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v2/SkillsConfigWriteResponse.json
@@ -0,0 +1,13 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "effectiveEnabled": {
+ "type": "boolean"
+ }
+ },
+ "required": [
+ "effectiveEnabled"
+ ],
+ "title": "SkillsConfigWriteResponse",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v2/SkillsListParams.json b/codex-rs/app-server-protocol/schema/json/v2/SkillsListParams.json
new file mode 100644
index 0000000000..a9a8a9ef8d
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v2/SkillsListParams.json
@@ -0,0 +1,18 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "cwds": {
+ "description": "When empty, defaults to the current session working directory.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "forceReload": {
+ "description": "When true, bypass the skills cache and re-scan skills from disk.",
+ "type": "boolean"
+ }
+ },
+ "title": "SkillsListParams",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v2/SkillsListResponse.json b/codex-rs/app-server-protocol/schema/json/v2/SkillsListResponse.json
new file mode 100644
index 0000000000..b4ec51ba78
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v2/SkillsListResponse.json
@@ -0,0 +1,215 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "definitions": {
+ "SkillDependencies": {
+ "properties": {
+ "tools": {
+ "items": {
+ "$ref": "#/definitions/SkillToolDependency"
+ },
+ "type": "array"
+ }
+ },
+ "required": [
+ "tools"
+ ],
+ "type": "object"
+ },
+ "SkillErrorInfo": {
+ "properties": {
+ "message": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "message",
+ "path"
+ ],
+ "type": "object"
+ },
+ "SkillInterface": {
+ "properties": {
+ "brandColor": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "defaultPrompt": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "displayName": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "iconLarge": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "iconSmall": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "shortDescription": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "SkillMetadata": {
+ "properties": {
+ "dependencies": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/SkillDependencies"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "description": {
+ "type": "string"
+ },
+ "enabled": {
+ "type": "boolean"
+ },
+ "interface": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/SkillInterface"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "name": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "scope": {
+ "$ref": "#/definitions/SkillScope"
+ },
+ "shortDescription": {
+ "description": "Legacy short_description from SKILL.md. Prefer SKILL.json interface.short_description.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "description",
+ "enabled",
+ "name",
+ "path",
+ "scope"
+ ],
+ "type": "object"
+ },
+ "SkillScope": {
+ "enum": [
+ "user",
+ "repo",
+ "system",
+ "admin"
+ ],
+ "type": "string"
+ },
+ "SkillToolDependency": {
+ "properties": {
+ "command": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "description": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "transport": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "type": "string"
+ },
+ "url": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "value": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "value"
+ ],
+ "type": "object"
+ },
+ "SkillsListEntry": {
+ "properties": {
+ "cwd": {
+ "type": "string"
+ },
+ "errors": {
+ "items": {
+ "$ref": "#/definitions/SkillErrorInfo"
+ },
+ "type": "array"
+ },
+ "skills": {
+ "items": {
+ "$ref": "#/definitions/SkillMetadata"
+ },
+ "type": "array"
+ }
+ },
+ "required": [
+ "cwd",
+ "errors",
+ "skills"
+ ],
+ "type": "object"
+ }
+ },
+ "properties": {
+ "data": {
+ "items": {
+ "$ref": "#/definitions/SkillsListEntry"
+ },
+ "type": "array"
+ }
+ },
+ "required": [
+ "data"
+ ],
+ "title": "SkillsListResponse",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v2/TerminalInteractionNotification.json b/codex-rs/app-server-protocol/schema/json/v2/TerminalInteractionNotification.json
new file mode 100644
index 0000000000..ca2648a313
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v2/TerminalInteractionNotification.json
@@ -0,0 +1,29 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "itemId": {
+ "type": "string"
+ },
+ "processId": {
+ "type": "string"
+ },
+ "stdin": {
+ "type": "string"
+ },
+ "threadId": {
+ "type": "string"
+ },
+ "turnId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "itemId",
+ "processId",
+ "stdin",
+ "threadId",
+ "turnId"
+ ],
+ "title": "TerminalInteractionNotification",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v2/ThreadArchiveParams.json b/codex-rs/app-server-protocol/schema/json/v2/ThreadArchiveParams.json
new file mode 100644
index 0000000000..49322b60a4
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v2/ThreadArchiveParams.json
@@ -0,0 +1,13 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "threadId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "threadId"
+ ],
+ "title": "ThreadArchiveParams",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v2/ThreadArchiveResponse.json b/codex-rs/app-server-protocol/schema/json/v2/ThreadArchiveResponse.json
new file mode 100644
index 0000000000..bfd853e59e
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v2/ThreadArchiveResponse.json
@@ -0,0 +1,5 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "title": "ThreadArchiveResponse",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v2/ThreadForkParams.json b/codex-rs/app-server-protocol/schema/json/v2/ThreadForkParams.json
new file mode 100644
index 0000000000..1de59e2a09
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v2/ThreadForkParams.json
@@ -0,0 +1,98 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "definitions": {
+ "AskForApproval": {
+ "enum": [
+ "untrusted",
+ "on-failure",
+ "on-request",
+ "never"
+ ],
+ "type": "string"
+ },
+ "SandboxMode": {
+ "enum": [
+ "read-only",
+ "workspace-write",
+ "danger-full-access"
+ ],
+ "type": "string"
+ }
+ },
+ "description": "There are two ways to fork a thread: 1. By thread_id: load the thread from disk by thread_id and fork it into a new thread. 2. By path: load the thread from disk by path and fork it into a new thread.\n\nIf using path, the thread_id param will be ignored.\n\nPrefer using thread_id whenever possible.",
+ "properties": {
+ "approvalPolicy": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/AskForApproval"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "baseInstructions": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "config": {
+ "additionalProperties": true,
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "cwd": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "developerInstructions": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "model": {
+ "description": "Configuration overrides for the forked thread, if any.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "modelProvider": {
+ "type": [
+ "string",
+ "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": [
+ {
+ "$ref": "#/definitions/SandboxMode"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "threadId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "threadId"
+ ],
+ "title": "ThreadForkParams",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v2/ThreadForkResponse.json b/codex-rs/app-server-protocol/schema/json/v2/ThreadForkResponse.json
new file mode 100644
index 0000000000..0a3826d8fd
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v2/ThreadForkResponse.json
@@ -0,0 +1,1859 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "definitions": {
+ "AbsolutePathBuf": {
+ "description": "A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem).\n\nIMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set, the deserialization will fail unless the path being deserialized is already absolute.",
+ "type": "string"
+ },
+ "Annotations": {
+ "description": "Optional annotations for the client. The client can use annotations to inform how objects are used or displayed",
+ "properties": {
+ "audience": {
+ "items": {
+ "$ref": "#/definitions/Role"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "lastModified": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "priority": {
+ "format": "double",
+ "type": [
+ "number",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "AskForApproval": {
+ "enum": [
+ "untrusted",
+ "on-failure",
+ "on-request",
+ "never"
+ ],
+ "type": "string"
+ },
+ "AudioContent": {
+ "description": "Audio provided to or from an LLM.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "data": {
+ "type": "string"
+ },
+ "mimeType": {
+ "type": "string"
+ },
+ "type": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "data",
+ "mimeType",
+ "type"
+ ],
+ "type": "object"
+ },
+ "BlobResourceContents": {
+ "properties": {
+ "blob": {
+ "type": "string"
+ },
+ "mimeType": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "uri": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "blob",
+ "uri"
+ ],
+ "type": "object"
+ },
+ "ByteRange": {
+ "properties": {
+ "end": {
+ "format": "uint",
+ "minimum": 0.0,
+ "type": "integer"
+ },
+ "start": {
+ "format": "uint",
+ "minimum": 0.0,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "end",
+ "start"
+ ],
+ "type": "object"
+ },
+ "CodexErrorInfo": {
+ "description": "This translation layer make sure that we expose codex error code in camel case.\n\nWhen an upstream HTTP status is available (for example, from the Responses API or a provider), it is forwarded in `httpStatusCode` on the relevant `codexErrorInfo` variant.",
+ "oneOf": [
+ {
+ "enum": [
+ "contextWindowExceeded",
+ "usageLimitExceeded",
+ "internalServerError",
+ "unauthorized",
+ "badRequest",
+ "threadRollbackFailed",
+ "sandboxError",
+ "other"
+ ],
+ "type": "string"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "modelCap": {
+ "properties": {
+ "model": {
+ "type": "string"
+ },
+ "reset_after_seconds": {
+ "format": "uint64",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "model"
+ ],
+ "type": "object"
+ }
+ },
+ "required": [
+ "modelCap"
+ ],
+ "title": "ModelCapCodexErrorInfo",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "httpConnectionFailed": {
+ "properties": {
+ "httpStatusCode": {
+ "format": "uint16",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "httpConnectionFailed"
+ ],
+ "title": "HttpConnectionFailedCodexErrorInfo",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "Failed to connect to the response SSE stream.",
+ "properties": {
+ "responseStreamConnectionFailed": {
+ "properties": {
+ "httpStatusCode": {
+ "format": "uint16",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "responseStreamConnectionFailed"
+ ],
+ "title": "ResponseStreamConnectionFailedCodexErrorInfo",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "The response SSE stream disconnected in the middle of a turn before completion.",
+ "properties": {
+ "responseStreamDisconnected": {
+ "properties": {
+ "httpStatusCode": {
+ "format": "uint16",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "responseStreamDisconnected"
+ ],
+ "title": "ResponseStreamDisconnectedCodexErrorInfo",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "Reached the retry limit for responses.",
+ "properties": {
+ "responseTooManyFailedAttempts": {
+ "properties": {
+ "httpStatusCode": {
+ "format": "uint16",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "responseTooManyFailedAttempts"
+ ],
+ "title": "ResponseTooManyFailedAttemptsCodexErrorInfo",
+ "type": "object"
+ }
+ ]
+ },
+ "CollabAgentState": {
+ "properties": {
+ "message": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "status": {
+ "$ref": "#/definitions/CollabAgentStatus"
+ }
+ },
+ "required": [
+ "status"
+ ],
+ "type": "object"
+ },
+ "CollabAgentStatus": {
+ "enum": [
+ "pendingInit",
+ "running",
+ "completed",
+ "errored",
+ "shutdown",
+ "notFound"
+ ],
+ "type": "string"
+ },
+ "CollabAgentTool": {
+ "enum": [
+ "spawnAgent",
+ "sendInput",
+ "wait",
+ "closeAgent"
+ ],
+ "type": "string"
+ },
+ "CollabAgentToolCallStatus": {
+ "enum": [
+ "inProgress",
+ "completed",
+ "failed"
+ ],
+ "type": "string"
+ },
+ "CommandAction": {
+ "oneOf": [
+ {
+ "properties": {
+ "command": {
+ "type": "string"
+ },
+ "name": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "read"
+ ],
+ "title": "ReadCommandActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "command",
+ "name",
+ "path",
+ "type"
+ ],
+ "title": "ReadCommandAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "command": {
+ "type": "string"
+ },
+ "path": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "listFiles"
+ ],
+ "title": "ListFilesCommandActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "command",
+ "type"
+ ],
+ "title": "ListFilesCommandAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "command": {
+ "type": "string"
+ },
+ "path": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "query": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "search"
+ ],
+ "title": "SearchCommandActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "command",
+ "type"
+ ],
+ "title": "SearchCommandAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "command": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "unknown"
+ ],
+ "title": "UnknownCommandActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "command",
+ "type"
+ ],
+ "title": "UnknownCommandAction",
+ "type": "object"
+ }
+ ]
+ },
+ "CommandExecutionStatus": {
+ "enum": [
+ "inProgress",
+ "completed",
+ "failed",
+ "declined"
+ ],
+ "type": "string"
+ },
+ "ContentBlock": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/TextContent"
+ },
+ {
+ "$ref": "#/definitions/ImageContent"
+ },
+ {
+ "$ref": "#/definitions/AudioContent"
+ },
+ {
+ "$ref": "#/definitions/ResourceLink"
+ },
+ {
+ "$ref": "#/definitions/EmbeddedResource"
+ }
+ ]
+ },
+ "EmbeddedResource": {
+ "description": "The contents of a resource, embedded into a prompt or tool call result.\n\nIt is up to the client how best to render embedded resources for the benefit of the LLM and/or the user.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "resource": {
+ "$ref": "#/definitions/EmbeddedResourceResource"
+ },
+ "type": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "resource",
+ "type"
+ ],
+ "type": "object"
+ },
+ "EmbeddedResourceResource": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/TextResourceContents"
+ },
+ {
+ "$ref": "#/definitions/BlobResourceContents"
+ }
+ ]
+ },
+ "FileUpdateChange": {
+ "properties": {
+ "diff": {
+ "type": "string"
+ },
+ "kind": {
+ "$ref": "#/definitions/PatchChangeKind"
+ },
+ "path": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "diff",
+ "kind",
+ "path"
+ ],
+ "type": "object"
+ },
+ "GitInfo": {
+ "properties": {
+ "branch": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "originUrl": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "sha": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "ImageContent": {
+ "description": "An image provided to or from an LLM.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "data": {
+ "type": "string"
+ },
+ "mimeType": {
+ "type": "string"
+ },
+ "type": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "data",
+ "mimeType",
+ "type"
+ ],
+ "type": "object"
+ },
+ "McpToolCallError": {
+ "properties": {
+ "message": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "message"
+ ],
+ "type": "object"
+ },
+ "McpToolCallResult": {
+ "properties": {
+ "content": {
+ "items": {
+ "$ref": "#/definitions/ContentBlock"
+ },
+ "type": "array"
+ },
+ "structuredContent": true
+ },
+ "required": [
+ "content"
+ ],
+ "type": "object"
+ },
+ "McpToolCallStatus": {
+ "enum": [
+ "inProgress",
+ "completed",
+ "failed"
+ ],
+ "type": "string"
+ },
+ "NetworkAccess": {
+ "enum": [
+ "restricted",
+ "enabled"
+ ],
+ "type": "string"
+ },
+ "PatchApplyStatus": {
+ "enum": [
+ "inProgress",
+ "completed",
+ "failed",
+ "declined"
+ ],
+ "type": "string"
+ },
+ "PatchChangeKind": {
+ "oneOf": [
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "add"
+ ],
+ "title": "AddPatchChangeKindType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "AddPatchChangeKind",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "delete"
+ ],
+ "title": "DeletePatchChangeKindType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "DeletePatchChangeKind",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "move_path": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "update"
+ ],
+ "title": "UpdatePatchChangeKindType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "UpdatePatchChangeKind",
+ "type": "object"
+ }
+ ]
+ },
+ "ReasoningEffort": {
+ "description": "See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#get-started-with-reasoning",
+ "enum": [
+ "none",
+ "minimal",
+ "low",
+ "medium",
+ "high",
+ "xhigh"
+ ],
+ "type": "string"
+ },
+ "ResourceLink": {
+ "description": "A resource that the server is capable of reading, included in a prompt or tool call result.\n\nNote: resource links returned by tools are not guaranteed to appear in the results of `resources/list` requests.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "description": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "mimeType": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "name": {
+ "type": "string"
+ },
+ "size": {
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "title": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "type": "string"
+ },
+ "uri": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "type",
+ "uri"
+ ],
+ "type": "object"
+ },
+ "Role": {
+ "description": "The sender or recipient of messages and data in a conversation.",
+ "enum": [
+ "assistant",
+ "user"
+ ],
+ "type": "string"
+ },
+ "SandboxPolicy": {
+ "oneOf": [
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "dangerFullAccess"
+ ],
+ "title": "DangerFullAccessSandboxPolicyType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "DangerFullAccessSandboxPolicy",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "readOnly"
+ ],
+ "title": "ReadOnlySandboxPolicyType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "ReadOnlySandboxPolicy",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "networkAccess": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/NetworkAccess"
+ }
+ ],
+ "default": "restricted"
+ },
+ "type": {
+ "enum": [
+ "externalSandbox"
+ ],
+ "title": "ExternalSandboxSandboxPolicyType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "ExternalSandboxSandboxPolicy",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "excludeSlashTmp": {
+ "default": false,
+ "type": "boolean"
+ },
+ "excludeTmpdirEnvVar": {
+ "default": false,
+ "type": "boolean"
+ },
+ "networkAccess": {
+ "default": false,
+ "type": "boolean"
+ },
+ "type": {
+ "enum": [
+ "workspaceWrite"
+ ],
+ "title": "WorkspaceWriteSandboxPolicyType",
+ "type": "string"
+ },
+ "writableRoots": {
+ "default": [],
+ "items": {
+ "$ref": "#/definitions/AbsolutePathBuf"
+ },
+ "type": "array"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "WorkspaceWriteSandboxPolicy",
+ "type": "object"
+ }
+ ]
+ },
+ "SessionSource": {
+ "oneOf": [
+ {
+ "enum": [
+ "cli",
+ "vscode",
+ "exec",
+ "appServer",
+ "unknown"
+ ],
+ "type": "string"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "subAgent": {
+ "$ref": "#/definitions/SubAgentSource"
+ }
+ },
+ "required": [
+ "subAgent"
+ ],
+ "title": "SubAgentSessionSource",
+ "type": "object"
+ }
+ ]
+ },
+ "SubAgentSource": {
+ "oneOf": [
+ {
+ "enum": [
+ "review",
+ "compact"
+ ],
+ "type": "string"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "thread_spawn": {
+ "properties": {
+ "depth": {
+ "format": "int32",
+ "type": "integer"
+ },
+ "parent_thread_id": {
+ "$ref": "#/definitions/ThreadId"
+ }
+ },
+ "required": [
+ "depth",
+ "parent_thread_id"
+ ],
+ "type": "object"
+ }
+ },
+ "required": [
+ "thread_spawn"
+ ],
+ "title": "ThreadSpawnSubAgentSource",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "other": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "other"
+ ],
+ "title": "OtherSubAgentSource",
+ "type": "object"
+ }
+ ]
+ },
+ "TextContent": {
+ "description": "Text provided to or from an LLM.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "type": "object"
+ },
+ "TextElement": {
+ "properties": {
+ "byteRange": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ByteRange"
+ }
+ ],
+ "description": "Byte range in the parent `text` buffer that this element occupies."
+ },
+ "placeholder": {
+ "description": "Optional human-readable placeholder for the element, displayed in the UI.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "byteRange"
+ ],
+ "type": "object"
+ },
+ "TextResourceContents": {
+ "properties": {
+ "mimeType": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "text": {
+ "type": "string"
+ },
+ "uri": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "uri"
+ ],
+ "type": "object"
+ },
+ "Thread": {
+ "properties": {
+ "cliVersion": {
+ "description": "Version of the CLI that created the thread.",
+ "type": "string"
+ },
+ "createdAt": {
+ "description": "Unix timestamp (in seconds) when the thread was created.",
+ "format": "int64",
+ "type": "integer"
+ },
+ "cwd": {
+ "description": "Working directory captured for the thread.",
+ "type": "string"
+ },
+ "gitInfo": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/GitInfo"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Optional Git metadata captured when the thread was created."
+ },
+ "id": {
+ "type": "string"
+ },
+ "modelProvider": {
+ "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"
+ },
+ "source": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/SessionSource"
+ }
+ ],
+ "description": "Origin of the thread (CLI, VSCode, codex exec, codex app-server, etc.)."
+ },
+ "turns": {
+ "description": "Only populated on `thread/resume`, `thread/rollback`, `thread/fork`, and `thread/read` (when `includeTurns` is true) responses. For all other responses and notifications returning a Thread, the turns field will be an empty list.",
+ "items": {
+ "$ref": "#/definitions/Turn"
+ },
+ "type": "array"
+ },
+ "updatedAt": {
+ "description": "Unix timestamp (in seconds) when the thread was last updated.",
+ "format": "int64",
+ "type": "integer"
+ }
+ },
+ "required": [
+ "cliVersion",
+ "createdAt",
+ "cwd",
+ "id",
+ "modelProvider",
+ "preview",
+ "source",
+ "turns",
+ "updatedAt"
+ ],
+ "type": "object"
+ },
+ "ThreadId": {
+ "type": "string"
+ },
+ "ThreadItem": {
+ "oneOf": [
+ {
+ "properties": {
+ "content": {
+ "items": {
+ "$ref": "#/definitions/UserInput"
+ },
+ "type": "array"
+ },
+ "id": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "userMessage"
+ ],
+ "title": "UserMessageThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "content",
+ "id",
+ "type"
+ ],
+ "title": "UserMessageThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "agentMessage"
+ ],
+ "title": "AgentMessageThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "text",
+ "type"
+ ],
+ "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": {
+ "default": [],
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "id": {
+ "type": "string"
+ },
+ "summary": {
+ "default": [],
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "type": {
+ "enum": [
+ "reasoning"
+ ],
+ "title": "ReasoningThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "type"
+ ],
+ "title": "ReasoningThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "aggregatedOutput": {
+ "description": "The command's output, aggregated from stdout and stderr.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "command": {
+ "description": "The command to be executed.",
+ "type": "string"
+ },
+ "commandActions": {
+ "description": "A best-effort parsing of the command to understand the action(s) it will perform. This returns a list of CommandAction objects because a single shell command may be composed of many commands piped together.",
+ "items": {
+ "$ref": "#/definitions/CommandAction"
+ },
+ "type": "array"
+ },
+ "cwd": {
+ "description": "The command's working directory.",
+ "type": "string"
+ },
+ "durationMs": {
+ "description": "The duration of the command execution in milliseconds.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "exitCode": {
+ "description": "The command's exit code.",
+ "format": "int32",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "id": {
+ "type": "string"
+ },
+ "processId": {
+ "description": "Identifier for the underlying PTY process (when available).",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "status": {
+ "$ref": "#/definitions/CommandExecutionStatus"
+ },
+ "type": {
+ "enum": [
+ "commandExecution"
+ ],
+ "title": "CommandExecutionThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "command",
+ "commandActions",
+ "cwd",
+ "id",
+ "status",
+ "type"
+ ],
+ "title": "CommandExecutionThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "changes": {
+ "items": {
+ "$ref": "#/definitions/FileUpdateChange"
+ },
+ "type": "array"
+ },
+ "id": {
+ "type": "string"
+ },
+ "status": {
+ "$ref": "#/definitions/PatchApplyStatus"
+ },
+ "type": {
+ "enum": [
+ "fileChange"
+ ],
+ "title": "FileChangeThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "changes",
+ "id",
+ "status",
+ "type"
+ ],
+ "title": "FileChangeThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "arguments": true,
+ "durationMs": {
+ "description": "The duration of the MCP tool call in milliseconds.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "error": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/McpToolCallError"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "id": {
+ "type": "string"
+ },
+ "result": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/McpToolCallResult"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "server": {
+ "type": "string"
+ },
+ "status": {
+ "$ref": "#/definitions/McpToolCallStatus"
+ },
+ "tool": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "mcpToolCall"
+ ],
+ "title": "McpToolCallThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "arguments",
+ "id",
+ "server",
+ "status",
+ "tool",
+ "type"
+ ],
+ "title": "McpToolCallThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "agentsStates": {
+ "additionalProperties": {
+ "$ref": "#/definitions/CollabAgentState"
+ },
+ "description": "Last known status of the target agents, when available.",
+ "type": "object"
+ },
+ "id": {
+ "description": "Unique identifier for this collab tool call.",
+ "type": "string"
+ },
+ "prompt": {
+ "description": "Prompt text sent as part of the collab tool call, when available.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "receiverThreadIds": {
+ "description": "Thread ID of the receiving agent, when applicable. In case of spawn operation, this corresponds to the newly spawned agent.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "senderThreadId": {
+ "description": "Thread ID of the agent issuing the collab request.",
+ "type": "string"
+ },
+ "status": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/CollabAgentToolCallStatus"
+ }
+ ],
+ "description": "Current status of the collab tool call."
+ },
+ "tool": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/CollabAgentTool"
+ }
+ ],
+ "description": "Name of the collab tool that was invoked."
+ },
+ "type": {
+ "enum": [
+ "collabAgentToolCall"
+ ],
+ "title": "CollabAgentToolCallThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "agentsStates",
+ "id",
+ "receiverThreadIds",
+ "senderThreadId",
+ "status",
+ "tool",
+ "type"
+ ],
+ "title": "CollabAgentToolCallThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "action": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/WebSearchAction"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "id": {
+ "type": "string"
+ },
+ "query": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "webSearch"
+ ],
+ "title": "WebSearchThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "query",
+ "type"
+ ],
+ "title": "WebSearchThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "imageView"
+ ],
+ "title": "ImageViewThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "path",
+ "type"
+ ],
+ "title": "ImageViewThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "review": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "enteredReviewMode"
+ ],
+ "title": "EnteredReviewModeThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "review",
+ "type"
+ ],
+ "title": "EnteredReviewModeThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "review": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "exitedReviewMode"
+ ],
+ "title": "ExitedReviewModeThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "review",
+ "type"
+ ],
+ "title": "ExitedReviewModeThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "contextCompaction"
+ ],
+ "title": "ContextCompactionThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "type"
+ ],
+ "title": "ContextCompactionThreadItem",
+ "type": "object"
+ }
+ ]
+ },
+ "Turn": {
+ "properties": {
+ "error": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/TurnError"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Only populated when the Turn's status is failed."
+ },
+ "id": {
+ "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.",
+ "items": {
+ "$ref": "#/definitions/ThreadItem"
+ },
+ "type": "array"
+ },
+ "status": {
+ "$ref": "#/definitions/TurnStatus"
+ }
+ },
+ "required": [
+ "id",
+ "items",
+ "status"
+ ],
+ "type": "object"
+ },
+ "TurnError": {
+ "properties": {
+ "additionalDetails": {
+ "default": null,
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "codexErrorInfo": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/CodexErrorInfo"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "message": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "message"
+ ],
+ "type": "object"
+ },
+ "TurnStatus": {
+ "enum": [
+ "completed",
+ "interrupted",
+ "failed",
+ "inProgress"
+ ],
+ "type": "string"
+ },
+ "UserInput": {
+ "oneOf": [
+ {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "text_elements": {
+ "default": [],
+ "description": "UI-defined spans within `text` used to render or persist special elements.",
+ "items": {
+ "$ref": "#/definitions/TextElement"
+ },
+ "type": "array"
+ },
+ "type": {
+ "enum": [
+ "text"
+ ],
+ "title": "TextUserInputType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "TextUserInput",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "image"
+ ],
+ "title": "ImageUserInputType",
+ "type": "string"
+ },
+ "url": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "url"
+ ],
+ "title": "ImageUserInput",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "localImage"
+ ],
+ "title": "LocalImageUserInputType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "path",
+ "type"
+ ],
+ "title": "LocalImageUserInput",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "name": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "skill"
+ ],
+ "title": "SkillUserInputType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "path",
+ "type"
+ ],
+ "title": "SkillUserInput",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "name": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "mention"
+ ],
+ "title": "MentionUserInputType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "path",
+ "type"
+ ],
+ "title": "MentionUserInput",
+ "type": "object"
+ }
+ ]
+ },
+ "WebSearchAction": {
+ "oneOf": [
+ {
+ "properties": {
+ "queries": {
+ "items": {
+ "type": "string"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "query": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "search"
+ ],
+ "title": "SearchWebSearchActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "SearchWebSearchAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "openPage"
+ ],
+ "title": "OpenPageWebSearchActionType",
+ "type": "string"
+ },
+ "url": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "OpenPageWebSearchAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "pattern": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "findInPage"
+ ],
+ "title": "FindInPageWebSearchActionType",
+ "type": "string"
+ },
+ "url": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "FindInPageWebSearchAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "other"
+ ],
+ "title": "OtherWebSearchActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "OtherWebSearchAction",
+ "type": "object"
+ }
+ ]
+ }
+ },
+ "properties": {
+ "approvalPolicy": {
+ "$ref": "#/definitions/AskForApproval"
+ },
+ "cwd": {
+ "type": "string"
+ },
+ "model": {
+ "type": "string"
+ },
+ "modelProvider": {
+ "type": "string"
+ },
+ "reasoningEffort": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ReasoningEffort"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "sandbox": {
+ "$ref": "#/definitions/SandboxPolicy"
+ },
+ "thread": {
+ "$ref": "#/definitions/Thread"
+ }
+ },
+ "required": [
+ "approvalPolicy",
+ "cwd",
+ "model",
+ "modelProvider",
+ "sandbox",
+ "thread"
+ ],
+ "title": "ThreadForkResponse",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v2/ThreadListParams.json b/codex-rs/app-server-protocol/schema/json/v2/ThreadListParams.json
new file mode 100644
index 0000000000..dd4c7a4f12
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v2/ThreadListParams.json
@@ -0,0 +1,85 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "definitions": {
+ "ThreadSortKey": {
+ "enum": [
+ "created_at",
+ "updated_at"
+ ],
+ "type": "string"
+ },
+ "ThreadSourceKind": {
+ "enum": [
+ "cli",
+ "vscode",
+ "exec",
+ "appServer",
+ "subAgent",
+ "subAgentReview",
+ "subAgentCompact",
+ "subAgentThreadSpawn",
+ "subAgentOther",
+ "unknown"
+ ],
+ "type": "string"
+ }
+ },
+ "properties": {
+ "archived": {
+ "description": "Optional archived filter; when set to true, only archived threads are returned. If false or null, only non-archived threads are returned.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "cursor": {
+ "description": "Opaque pagination cursor returned by a previous call.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "limit": {
+ "description": "Optional page size; defaults to a reasonable server-side value.",
+ "format": "uint32",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "modelProviders": {
+ "description": "Optional provider filter; when set, only sessions recorded under these providers are returned. When present but empty, includes all providers.",
+ "items": {
+ "type": "string"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "sortKey": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ThreadSortKey"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Optional sort key; defaults to created_at."
+ },
+ "sourceKinds": {
+ "description": "Optional source filter; when set, only sessions from these source kinds are returned. When omitted or empty, defaults to interactive sources.",
+ "items": {
+ "$ref": "#/definitions/ThreadSourceKind"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ }
+ },
+ "title": "ThreadListParams",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v2/ThreadListResponse.json b/codex-rs/app-server-protocol/schema/json/v2/ThreadListResponse.json
new file mode 100644
index 0000000000..eb4ec81f68
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v2/ThreadListResponse.json
@@ -0,0 +1,1712 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "definitions": {
+ "Annotations": {
+ "description": "Optional annotations for the client. The client can use annotations to inform how objects are used or displayed",
+ "properties": {
+ "audience": {
+ "items": {
+ "$ref": "#/definitions/Role"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "lastModified": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "priority": {
+ "format": "double",
+ "type": [
+ "number",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "AudioContent": {
+ "description": "Audio provided to or from an LLM.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "data": {
+ "type": "string"
+ },
+ "mimeType": {
+ "type": "string"
+ },
+ "type": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "data",
+ "mimeType",
+ "type"
+ ],
+ "type": "object"
+ },
+ "BlobResourceContents": {
+ "properties": {
+ "blob": {
+ "type": "string"
+ },
+ "mimeType": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "uri": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "blob",
+ "uri"
+ ],
+ "type": "object"
+ },
+ "ByteRange": {
+ "properties": {
+ "end": {
+ "format": "uint",
+ "minimum": 0.0,
+ "type": "integer"
+ },
+ "start": {
+ "format": "uint",
+ "minimum": 0.0,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "end",
+ "start"
+ ],
+ "type": "object"
+ },
+ "CodexErrorInfo": {
+ "description": "This translation layer make sure that we expose codex error code in camel case.\n\nWhen an upstream HTTP status is available (for example, from the Responses API or a provider), it is forwarded in `httpStatusCode` on the relevant `codexErrorInfo` variant.",
+ "oneOf": [
+ {
+ "enum": [
+ "contextWindowExceeded",
+ "usageLimitExceeded",
+ "internalServerError",
+ "unauthorized",
+ "badRequest",
+ "threadRollbackFailed",
+ "sandboxError",
+ "other"
+ ],
+ "type": "string"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "modelCap": {
+ "properties": {
+ "model": {
+ "type": "string"
+ },
+ "reset_after_seconds": {
+ "format": "uint64",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "model"
+ ],
+ "type": "object"
+ }
+ },
+ "required": [
+ "modelCap"
+ ],
+ "title": "ModelCapCodexErrorInfo",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "httpConnectionFailed": {
+ "properties": {
+ "httpStatusCode": {
+ "format": "uint16",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "httpConnectionFailed"
+ ],
+ "title": "HttpConnectionFailedCodexErrorInfo",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "Failed to connect to the response SSE stream.",
+ "properties": {
+ "responseStreamConnectionFailed": {
+ "properties": {
+ "httpStatusCode": {
+ "format": "uint16",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "responseStreamConnectionFailed"
+ ],
+ "title": "ResponseStreamConnectionFailedCodexErrorInfo",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "The response SSE stream disconnected in the middle of a turn before completion.",
+ "properties": {
+ "responseStreamDisconnected": {
+ "properties": {
+ "httpStatusCode": {
+ "format": "uint16",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "responseStreamDisconnected"
+ ],
+ "title": "ResponseStreamDisconnectedCodexErrorInfo",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "Reached the retry limit for responses.",
+ "properties": {
+ "responseTooManyFailedAttempts": {
+ "properties": {
+ "httpStatusCode": {
+ "format": "uint16",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "responseTooManyFailedAttempts"
+ ],
+ "title": "ResponseTooManyFailedAttemptsCodexErrorInfo",
+ "type": "object"
+ }
+ ]
+ },
+ "CollabAgentState": {
+ "properties": {
+ "message": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "status": {
+ "$ref": "#/definitions/CollabAgentStatus"
+ }
+ },
+ "required": [
+ "status"
+ ],
+ "type": "object"
+ },
+ "CollabAgentStatus": {
+ "enum": [
+ "pendingInit",
+ "running",
+ "completed",
+ "errored",
+ "shutdown",
+ "notFound"
+ ],
+ "type": "string"
+ },
+ "CollabAgentTool": {
+ "enum": [
+ "spawnAgent",
+ "sendInput",
+ "wait",
+ "closeAgent"
+ ],
+ "type": "string"
+ },
+ "CollabAgentToolCallStatus": {
+ "enum": [
+ "inProgress",
+ "completed",
+ "failed"
+ ],
+ "type": "string"
+ },
+ "CommandAction": {
+ "oneOf": [
+ {
+ "properties": {
+ "command": {
+ "type": "string"
+ },
+ "name": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "read"
+ ],
+ "title": "ReadCommandActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "command",
+ "name",
+ "path",
+ "type"
+ ],
+ "title": "ReadCommandAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "command": {
+ "type": "string"
+ },
+ "path": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "listFiles"
+ ],
+ "title": "ListFilesCommandActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "command",
+ "type"
+ ],
+ "title": "ListFilesCommandAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "command": {
+ "type": "string"
+ },
+ "path": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "query": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "search"
+ ],
+ "title": "SearchCommandActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "command",
+ "type"
+ ],
+ "title": "SearchCommandAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "command": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "unknown"
+ ],
+ "title": "UnknownCommandActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "command",
+ "type"
+ ],
+ "title": "UnknownCommandAction",
+ "type": "object"
+ }
+ ]
+ },
+ "CommandExecutionStatus": {
+ "enum": [
+ "inProgress",
+ "completed",
+ "failed",
+ "declined"
+ ],
+ "type": "string"
+ },
+ "ContentBlock": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/TextContent"
+ },
+ {
+ "$ref": "#/definitions/ImageContent"
+ },
+ {
+ "$ref": "#/definitions/AudioContent"
+ },
+ {
+ "$ref": "#/definitions/ResourceLink"
+ },
+ {
+ "$ref": "#/definitions/EmbeddedResource"
+ }
+ ]
+ },
+ "EmbeddedResource": {
+ "description": "The contents of a resource, embedded into a prompt or tool call result.\n\nIt is up to the client how best to render embedded resources for the benefit of the LLM and/or the user.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "resource": {
+ "$ref": "#/definitions/EmbeddedResourceResource"
+ },
+ "type": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "resource",
+ "type"
+ ],
+ "type": "object"
+ },
+ "EmbeddedResourceResource": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/TextResourceContents"
+ },
+ {
+ "$ref": "#/definitions/BlobResourceContents"
+ }
+ ]
+ },
+ "FileUpdateChange": {
+ "properties": {
+ "diff": {
+ "type": "string"
+ },
+ "kind": {
+ "$ref": "#/definitions/PatchChangeKind"
+ },
+ "path": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "diff",
+ "kind",
+ "path"
+ ],
+ "type": "object"
+ },
+ "GitInfo": {
+ "properties": {
+ "branch": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "originUrl": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "sha": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "ImageContent": {
+ "description": "An image provided to or from an LLM.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "data": {
+ "type": "string"
+ },
+ "mimeType": {
+ "type": "string"
+ },
+ "type": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "data",
+ "mimeType",
+ "type"
+ ],
+ "type": "object"
+ },
+ "McpToolCallError": {
+ "properties": {
+ "message": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "message"
+ ],
+ "type": "object"
+ },
+ "McpToolCallResult": {
+ "properties": {
+ "content": {
+ "items": {
+ "$ref": "#/definitions/ContentBlock"
+ },
+ "type": "array"
+ },
+ "structuredContent": true
+ },
+ "required": [
+ "content"
+ ],
+ "type": "object"
+ },
+ "McpToolCallStatus": {
+ "enum": [
+ "inProgress",
+ "completed",
+ "failed"
+ ],
+ "type": "string"
+ },
+ "PatchApplyStatus": {
+ "enum": [
+ "inProgress",
+ "completed",
+ "failed",
+ "declined"
+ ],
+ "type": "string"
+ },
+ "PatchChangeKind": {
+ "oneOf": [
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "add"
+ ],
+ "title": "AddPatchChangeKindType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "AddPatchChangeKind",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "delete"
+ ],
+ "title": "DeletePatchChangeKindType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "DeletePatchChangeKind",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "move_path": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "update"
+ ],
+ "title": "UpdatePatchChangeKindType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "UpdatePatchChangeKind",
+ "type": "object"
+ }
+ ]
+ },
+ "ResourceLink": {
+ "description": "A resource that the server is capable of reading, included in a prompt or tool call result.\n\nNote: resource links returned by tools are not guaranteed to appear in the results of `resources/list` requests.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "description": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "mimeType": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "name": {
+ "type": "string"
+ },
+ "size": {
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "title": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "type": "string"
+ },
+ "uri": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "type",
+ "uri"
+ ],
+ "type": "object"
+ },
+ "Role": {
+ "description": "The sender or recipient of messages and data in a conversation.",
+ "enum": [
+ "assistant",
+ "user"
+ ],
+ "type": "string"
+ },
+ "SessionSource": {
+ "oneOf": [
+ {
+ "enum": [
+ "cli",
+ "vscode",
+ "exec",
+ "appServer",
+ "unknown"
+ ],
+ "type": "string"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "subAgent": {
+ "$ref": "#/definitions/SubAgentSource"
+ }
+ },
+ "required": [
+ "subAgent"
+ ],
+ "title": "SubAgentSessionSource",
+ "type": "object"
+ }
+ ]
+ },
+ "SubAgentSource": {
+ "oneOf": [
+ {
+ "enum": [
+ "review",
+ "compact"
+ ],
+ "type": "string"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "thread_spawn": {
+ "properties": {
+ "depth": {
+ "format": "int32",
+ "type": "integer"
+ },
+ "parent_thread_id": {
+ "$ref": "#/definitions/ThreadId"
+ }
+ },
+ "required": [
+ "depth",
+ "parent_thread_id"
+ ],
+ "type": "object"
+ }
+ },
+ "required": [
+ "thread_spawn"
+ ],
+ "title": "ThreadSpawnSubAgentSource",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "other": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "other"
+ ],
+ "title": "OtherSubAgentSource",
+ "type": "object"
+ }
+ ]
+ },
+ "TextContent": {
+ "description": "Text provided to or from an LLM.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "type": "object"
+ },
+ "TextElement": {
+ "properties": {
+ "byteRange": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ByteRange"
+ }
+ ],
+ "description": "Byte range in the parent `text` buffer that this element occupies."
+ },
+ "placeholder": {
+ "description": "Optional human-readable placeholder for the element, displayed in the UI.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "byteRange"
+ ],
+ "type": "object"
+ },
+ "TextResourceContents": {
+ "properties": {
+ "mimeType": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "text": {
+ "type": "string"
+ },
+ "uri": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "uri"
+ ],
+ "type": "object"
+ },
+ "Thread": {
+ "properties": {
+ "cliVersion": {
+ "description": "Version of the CLI that created the thread.",
+ "type": "string"
+ },
+ "createdAt": {
+ "description": "Unix timestamp (in seconds) when the thread was created.",
+ "format": "int64",
+ "type": "integer"
+ },
+ "cwd": {
+ "description": "Working directory captured for the thread.",
+ "type": "string"
+ },
+ "gitInfo": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/GitInfo"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Optional Git metadata captured when the thread was created."
+ },
+ "id": {
+ "type": "string"
+ },
+ "modelProvider": {
+ "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"
+ },
+ "source": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/SessionSource"
+ }
+ ],
+ "description": "Origin of the thread (CLI, VSCode, codex exec, codex app-server, etc.)."
+ },
+ "turns": {
+ "description": "Only populated on `thread/resume`, `thread/rollback`, `thread/fork`, and `thread/read` (when `includeTurns` is true) responses. For all other responses and notifications returning a Thread, the turns field will be an empty list.",
+ "items": {
+ "$ref": "#/definitions/Turn"
+ },
+ "type": "array"
+ },
+ "updatedAt": {
+ "description": "Unix timestamp (in seconds) when the thread was last updated.",
+ "format": "int64",
+ "type": "integer"
+ }
+ },
+ "required": [
+ "cliVersion",
+ "createdAt",
+ "cwd",
+ "id",
+ "modelProvider",
+ "preview",
+ "source",
+ "turns",
+ "updatedAt"
+ ],
+ "type": "object"
+ },
+ "ThreadId": {
+ "type": "string"
+ },
+ "ThreadItem": {
+ "oneOf": [
+ {
+ "properties": {
+ "content": {
+ "items": {
+ "$ref": "#/definitions/UserInput"
+ },
+ "type": "array"
+ },
+ "id": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "userMessage"
+ ],
+ "title": "UserMessageThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "content",
+ "id",
+ "type"
+ ],
+ "title": "UserMessageThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "agentMessage"
+ ],
+ "title": "AgentMessageThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "text",
+ "type"
+ ],
+ "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": {
+ "default": [],
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "id": {
+ "type": "string"
+ },
+ "summary": {
+ "default": [],
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "type": {
+ "enum": [
+ "reasoning"
+ ],
+ "title": "ReasoningThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "type"
+ ],
+ "title": "ReasoningThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "aggregatedOutput": {
+ "description": "The command's output, aggregated from stdout and stderr.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "command": {
+ "description": "The command to be executed.",
+ "type": "string"
+ },
+ "commandActions": {
+ "description": "A best-effort parsing of the command to understand the action(s) it will perform. This returns a list of CommandAction objects because a single shell command may be composed of many commands piped together.",
+ "items": {
+ "$ref": "#/definitions/CommandAction"
+ },
+ "type": "array"
+ },
+ "cwd": {
+ "description": "The command's working directory.",
+ "type": "string"
+ },
+ "durationMs": {
+ "description": "The duration of the command execution in milliseconds.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "exitCode": {
+ "description": "The command's exit code.",
+ "format": "int32",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "id": {
+ "type": "string"
+ },
+ "processId": {
+ "description": "Identifier for the underlying PTY process (when available).",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "status": {
+ "$ref": "#/definitions/CommandExecutionStatus"
+ },
+ "type": {
+ "enum": [
+ "commandExecution"
+ ],
+ "title": "CommandExecutionThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "command",
+ "commandActions",
+ "cwd",
+ "id",
+ "status",
+ "type"
+ ],
+ "title": "CommandExecutionThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "changes": {
+ "items": {
+ "$ref": "#/definitions/FileUpdateChange"
+ },
+ "type": "array"
+ },
+ "id": {
+ "type": "string"
+ },
+ "status": {
+ "$ref": "#/definitions/PatchApplyStatus"
+ },
+ "type": {
+ "enum": [
+ "fileChange"
+ ],
+ "title": "FileChangeThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "changes",
+ "id",
+ "status",
+ "type"
+ ],
+ "title": "FileChangeThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "arguments": true,
+ "durationMs": {
+ "description": "The duration of the MCP tool call in milliseconds.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "error": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/McpToolCallError"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "id": {
+ "type": "string"
+ },
+ "result": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/McpToolCallResult"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "server": {
+ "type": "string"
+ },
+ "status": {
+ "$ref": "#/definitions/McpToolCallStatus"
+ },
+ "tool": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "mcpToolCall"
+ ],
+ "title": "McpToolCallThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "arguments",
+ "id",
+ "server",
+ "status",
+ "tool",
+ "type"
+ ],
+ "title": "McpToolCallThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "agentsStates": {
+ "additionalProperties": {
+ "$ref": "#/definitions/CollabAgentState"
+ },
+ "description": "Last known status of the target agents, when available.",
+ "type": "object"
+ },
+ "id": {
+ "description": "Unique identifier for this collab tool call.",
+ "type": "string"
+ },
+ "prompt": {
+ "description": "Prompt text sent as part of the collab tool call, when available.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "receiverThreadIds": {
+ "description": "Thread ID of the receiving agent, when applicable. In case of spawn operation, this corresponds to the newly spawned agent.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "senderThreadId": {
+ "description": "Thread ID of the agent issuing the collab request.",
+ "type": "string"
+ },
+ "status": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/CollabAgentToolCallStatus"
+ }
+ ],
+ "description": "Current status of the collab tool call."
+ },
+ "tool": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/CollabAgentTool"
+ }
+ ],
+ "description": "Name of the collab tool that was invoked."
+ },
+ "type": {
+ "enum": [
+ "collabAgentToolCall"
+ ],
+ "title": "CollabAgentToolCallThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "agentsStates",
+ "id",
+ "receiverThreadIds",
+ "senderThreadId",
+ "status",
+ "tool",
+ "type"
+ ],
+ "title": "CollabAgentToolCallThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "action": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/WebSearchAction"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "id": {
+ "type": "string"
+ },
+ "query": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "webSearch"
+ ],
+ "title": "WebSearchThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "query",
+ "type"
+ ],
+ "title": "WebSearchThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "imageView"
+ ],
+ "title": "ImageViewThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "path",
+ "type"
+ ],
+ "title": "ImageViewThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "review": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "enteredReviewMode"
+ ],
+ "title": "EnteredReviewModeThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "review",
+ "type"
+ ],
+ "title": "EnteredReviewModeThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "review": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "exitedReviewMode"
+ ],
+ "title": "ExitedReviewModeThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "review",
+ "type"
+ ],
+ "title": "ExitedReviewModeThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "contextCompaction"
+ ],
+ "title": "ContextCompactionThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "type"
+ ],
+ "title": "ContextCompactionThreadItem",
+ "type": "object"
+ }
+ ]
+ },
+ "Turn": {
+ "properties": {
+ "error": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/TurnError"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Only populated when the Turn's status is failed."
+ },
+ "id": {
+ "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.",
+ "items": {
+ "$ref": "#/definitions/ThreadItem"
+ },
+ "type": "array"
+ },
+ "status": {
+ "$ref": "#/definitions/TurnStatus"
+ }
+ },
+ "required": [
+ "id",
+ "items",
+ "status"
+ ],
+ "type": "object"
+ },
+ "TurnError": {
+ "properties": {
+ "additionalDetails": {
+ "default": null,
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "codexErrorInfo": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/CodexErrorInfo"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "message": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "message"
+ ],
+ "type": "object"
+ },
+ "TurnStatus": {
+ "enum": [
+ "completed",
+ "interrupted",
+ "failed",
+ "inProgress"
+ ],
+ "type": "string"
+ },
+ "UserInput": {
+ "oneOf": [
+ {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "text_elements": {
+ "default": [],
+ "description": "UI-defined spans within `text` used to render or persist special elements.",
+ "items": {
+ "$ref": "#/definitions/TextElement"
+ },
+ "type": "array"
+ },
+ "type": {
+ "enum": [
+ "text"
+ ],
+ "title": "TextUserInputType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "TextUserInput",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "image"
+ ],
+ "title": "ImageUserInputType",
+ "type": "string"
+ },
+ "url": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "url"
+ ],
+ "title": "ImageUserInput",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "localImage"
+ ],
+ "title": "LocalImageUserInputType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "path",
+ "type"
+ ],
+ "title": "LocalImageUserInput",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "name": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "skill"
+ ],
+ "title": "SkillUserInputType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "path",
+ "type"
+ ],
+ "title": "SkillUserInput",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "name": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "mention"
+ ],
+ "title": "MentionUserInputType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "path",
+ "type"
+ ],
+ "title": "MentionUserInput",
+ "type": "object"
+ }
+ ]
+ },
+ "WebSearchAction": {
+ "oneOf": [
+ {
+ "properties": {
+ "queries": {
+ "items": {
+ "type": "string"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "query": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "search"
+ ],
+ "title": "SearchWebSearchActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "SearchWebSearchAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "openPage"
+ ],
+ "title": "OpenPageWebSearchActionType",
+ "type": "string"
+ },
+ "url": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "OpenPageWebSearchAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "pattern": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "findInPage"
+ ],
+ "title": "FindInPageWebSearchActionType",
+ "type": "string"
+ },
+ "url": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "FindInPageWebSearchAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "other"
+ ],
+ "title": "OtherWebSearchActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "OtherWebSearchAction",
+ "type": "object"
+ }
+ ]
+ }
+ },
+ "properties": {
+ "data": {
+ "items": {
+ "$ref": "#/definitions/Thread"
+ },
+ "type": "array"
+ },
+ "nextCursor": {
+ "description": "Opaque cursor to pass to the next call to continue after the last item. if None, there are no more items to return.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "data"
+ ],
+ "title": "ThreadListResponse",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v2/ThreadLoadedListParams.json b/codex-rs/app-server-protocol/schema/json/v2/ThreadLoadedListParams.json
new file mode 100644
index 0000000000..d10ee7ed96
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v2/ThreadLoadedListParams.json
@@ -0,0 +1,23 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "cursor": {
+ "description": "Opaque pagination cursor returned by a previous call.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "limit": {
+ "description": "Optional page size; defaults to no limit.",
+ "format": "uint32",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "title": "ThreadLoadedListParams",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v2/ThreadLoadedListResponse.json b/codex-rs/app-server-protocol/schema/json/v2/ThreadLoadedListResponse.json
new file mode 100644
index 0000000000..cfd90fb813
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v2/ThreadLoadedListResponse.json
@@ -0,0 +1,24 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "data": {
+ "description": "Thread ids for sessions currently loaded in memory.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "nextCursor": {
+ "description": "Opaque cursor to pass to the next call to continue after the last item. if None, there are no more items to return.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "data"
+ ],
+ "title": "ThreadLoadedListResponse",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v2/ThreadNameUpdatedNotification.json b/codex-rs/app-server-protocol/schema/json/v2/ThreadNameUpdatedNotification.json
new file mode 100644
index 0000000000..8c3b2095f5
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v2/ThreadNameUpdatedNotification.json
@@ -0,0 +1,19 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "threadId": {
+ "type": "string"
+ },
+ "threadName": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "threadId"
+ ],
+ "title": "ThreadNameUpdatedNotification",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v2/ThreadReadParams.json b/codex-rs/app-server-protocol/schema/json/v2/ThreadReadParams.json
new file mode 100644
index 0000000000..f5e5503cc0
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v2/ThreadReadParams.json
@@ -0,0 +1,18 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "includeTurns": {
+ "default": false,
+ "description": "When true, include turns and their items from rollout history.",
+ "type": "boolean"
+ },
+ "threadId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "threadId"
+ ],
+ "title": "ThreadReadParams",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v2/ThreadReadResponse.json b/codex-rs/app-server-protocol/schema/json/v2/ThreadReadResponse.json
new file mode 100644
index 0000000000..02dab752e3
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v2/ThreadReadResponse.json
@@ -0,0 +1,1702 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "definitions": {
+ "Annotations": {
+ "description": "Optional annotations for the client. The client can use annotations to inform how objects are used or displayed",
+ "properties": {
+ "audience": {
+ "items": {
+ "$ref": "#/definitions/Role"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "lastModified": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "priority": {
+ "format": "double",
+ "type": [
+ "number",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "AudioContent": {
+ "description": "Audio provided to or from an LLM.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "data": {
+ "type": "string"
+ },
+ "mimeType": {
+ "type": "string"
+ },
+ "type": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "data",
+ "mimeType",
+ "type"
+ ],
+ "type": "object"
+ },
+ "BlobResourceContents": {
+ "properties": {
+ "blob": {
+ "type": "string"
+ },
+ "mimeType": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "uri": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "blob",
+ "uri"
+ ],
+ "type": "object"
+ },
+ "ByteRange": {
+ "properties": {
+ "end": {
+ "format": "uint",
+ "minimum": 0.0,
+ "type": "integer"
+ },
+ "start": {
+ "format": "uint",
+ "minimum": 0.0,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "end",
+ "start"
+ ],
+ "type": "object"
+ },
+ "CodexErrorInfo": {
+ "description": "This translation layer make sure that we expose codex error code in camel case.\n\nWhen an upstream HTTP status is available (for example, from the Responses API or a provider), it is forwarded in `httpStatusCode` on the relevant `codexErrorInfo` variant.",
+ "oneOf": [
+ {
+ "enum": [
+ "contextWindowExceeded",
+ "usageLimitExceeded",
+ "internalServerError",
+ "unauthorized",
+ "badRequest",
+ "threadRollbackFailed",
+ "sandboxError",
+ "other"
+ ],
+ "type": "string"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "modelCap": {
+ "properties": {
+ "model": {
+ "type": "string"
+ },
+ "reset_after_seconds": {
+ "format": "uint64",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "model"
+ ],
+ "type": "object"
+ }
+ },
+ "required": [
+ "modelCap"
+ ],
+ "title": "ModelCapCodexErrorInfo",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "httpConnectionFailed": {
+ "properties": {
+ "httpStatusCode": {
+ "format": "uint16",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "httpConnectionFailed"
+ ],
+ "title": "HttpConnectionFailedCodexErrorInfo",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "Failed to connect to the response SSE stream.",
+ "properties": {
+ "responseStreamConnectionFailed": {
+ "properties": {
+ "httpStatusCode": {
+ "format": "uint16",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "responseStreamConnectionFailed"
+ ],
+ "title": "ResponseStreamConnectionFailedCodexErrorInfo",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "The response SSE stream disconnected in the middle of a turn before completion.",
+ "properties": {
+ "responseStreamDisconnected": {
+ "properties": {
+ "httpStatusCode": {
+ "format": "uint16",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "responseStreamDisconnected"
+ ],
+ "title": "ResponseStreamDisconnectedCodexErrorInfo",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "Reached the retry limit for responses.",
+ "properties": {
+ "responseTooManyFailedAttempts": {
+ "properties": {
+ "httpStatusCode": {
+ "format": "uint16",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "responseTooManyFailedAttempts"
+ ],
+ "title": "ResponseTooManyFailedAttemptsCodexErrorInfo",
+ "type": "object"
+ }
+ ]
+ },
+ "CollabAgentState": {
+ "properties": {
+ "message": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "status": {
+ "$ref": "#/definitions/CollabAgentStatus"
+ }
+ },
+ "required": [
+ "status"
+ ],
+ "type": "object"
+ },
+ "CollabAgentStatus": {
+ "enum": [
+ "pendingInit",
+ "running",
+ "completed",
+ "errored",
+ "shutdown",
+ "notFound"
+ ],
+ "type": "string"
+ },
+ "CollabAgentTool": {
+ "enum": [
+ "spawnAgent",
+ "sendInput",
+ "wait",
+ "closeAgent"
+ ],
+ "type": "string"
+ },
+ "CollabAgentToolCallStatus": {
+ "enum": [
+ "inProgress",
+ "completed",
+ "failed"
+ ],
+ "type": "string"
+ },
+ "CommandAction": {
+ "oneOf": [
+ {
+ "properties": {
+ "command": {
+ "type": "string"
+ },
+ "name": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "read"
+ ],
+ "title": "ReadCommandActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "command",
+ "name",
+ "path",
+ "type"
+ ],
+ "title": "ReadCommandAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "command": {
+ "type": "string"
+ },
+ "path": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "listFiles"
+ ],
+ "title": "ListFilesCommandActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "command",
+ "type"
+ ],
+ "title": "ListFilesCommandAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "command": {
+ "type": "string"
+ },
+ "path": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "query": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "search"
+ ],
+ "title": "SearchCommandActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "command",
+ "type"
+ ],
+ "title": "SearchCommandAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "command": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "unknown"
+ ],
+ "title": "UnknownCommandActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "command",
+ "type"
+ ],
+ "title": "UnknownCommandAction",
+ "type": "object"
+ }
+ ]
+ },
+ "CommandExecutionStatus": {
+ "enum": [
+ "inProgress",
+ "completed",
+ "failed",
+ "declined"
+ ],
+ "type": "string"
+ },
+ "ContentBlock": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/TextContent"
+ },
+ {
+ "$ref": "#/definitions/ImageContent"
+ },
+ {
+ "$ref": "#/definitions/AudioContent"
+ },
+ {
+ "$ref": "#/definitions/ResourceLink"
+ },
+ {
+ "$ref": "#/definitions/EmbeddedResource"
+ }
+ ]
+ },
+ "EmbeddedResource": {
+ "description": "The contents of a resource, embedded into a prompt or tool call result.\n\nIt is up to the client how best to render embedded resources for the benefit of the LLM and/or the user.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "resource": {
+ "$ref": "#/definitions/EmbeddedResourceResource"
+ },
+ "type": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "resource",
+ "type"
+ ],
+ "type": "object"
+ },
+ "EmbeddedResourceResource": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/TextResourceContents"
+ },
+ {
+ "$ref": "#/definitions/BlobResourceContents"
+ }
+ ]
+ },
+ "FileUpdateChange": {
+ "properties": {
+ "diff": {
+ "type": "string"
+ },
+ "kind": {
+ "$ref": "#/definitions/PatchChangeKind"
+ },
+ "path": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "diff",
+ "kind",
+ "path"
+ ],
+ "type": "object"
+ },
+ "GitInfo": {
+ "properties": {
+ "branch": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "originUrl": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "sha": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "ImageContent": {
+ "description": "An image provided to or from an LLM.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "data": {
+ "type": "string"
+ },
+ "mimeType": {
+ "type": "string"
+ },
+ "type": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "data",
+ "mimeType",
+ "type"
+ ],
+ "type": "object"
+ },
+ "McpToolCallError": {
+ "properties": {
+ "message": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "message"
+ ],
+ "type": "object"
+ },
+ "McpToolCallResult": {
+ "properties": {
+ "content": {
+ "items": {
+ "$ref": "#/definitions/ContentBlock"
+ },
+ "type": "array"
+ },
+ "structuredContent": true
+ },
+ "required": [
+ "content"
+ ],
+ "type": "object"
+ },
+ "McpToolCallStatus": {
+ "enum": [
+ "inProgress",
+ "completed",
+ "failed"
+ ],
+ "type": "string"
+ },
+ "PatchApplyStatus": {
+ "enum": [
+ "inProgress",
+ "completed",
+ "failed",
+ "declined"
+ ],
+ "type": "string"
+ },
+ "PatchChangeKind": {
+ "oneOf": [
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "add"
+ ],
+ "title": "AddPatchChangeKindType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "AddPatchChangeKind",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "delete"
+ ],
+ "title": "DeletePatchChangeKindType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "DeletePatchChangeKind",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "move_path": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "update"
+ ],
+ "title": "UpdatePatchChangeKindType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "UpdatePatchChangeKind",
+ "type": "object"
+ }
+ ]
+ },
+ "ResourceLink": {
+ "description": "A resource that the server is capable of reading, included in a prompt or tool call result.\n\nNote: resource links returned by tools are not guaranteed to appear in the results of `resources/list` requests.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "description": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "mimeType": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "name": {
+ "type": "string"
+ },
+ "size": {
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "title": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "type": "string"
+ },
+ "uri": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "type",
+ "uri"
+ ],
+ "type": "object"
+ },
+ "Role": {
+ "description": "The sender or recipient of messages and data in a conversation.",
+ "enum": [
+ "assistant",
+ "user"
+ ],
+ "type": "string"
+ },
+ "SessionSource": {
+ "oneOf": [
+ {
+ "enum": [
+ "cli",
+ "vscode",
+ "exec",
+ "appServer",
+ "unknown"
+ ],
+ "type": "string"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "subAgent": {
+ "$ref": "#/definitions/SubAgentSource"
+ }
+ },
+ "required": [
+ "subAgent"
+ ],
+ "title": "SubAgentSessionSource",
+ "type": "object"
+ }
+ ]
+ },
+ "SubAgentSource": {
+ "oneOf": [
+ {
+ "enum": [
+ "review",
+ "compact"
+ ],
+ "type": "string"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "thread_spawn": {
+ "properties": {
+ "depth": {
+ "format": "int32",
+ "type": "integer"
+ },
+ "parent_thread_id": {
+ "$ref": "#/definitions/ThreadId"
+ }
+ },
+ "required": [
+ "depth",
+ "parent_thread_id"
+ ],
+ "type": "object"
+ }
+ },
+ "required": [
+ "thread_spawn"
+ ],
+ "title": "ThreadSpawnSubAgentSource",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "other": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "other"
+ ],
+ "title": "OtherSubAgentSource",
+ "type": "object"
+ }
+ ]
+ },
+ "TextContent": {
+ "description": "Text provided to or from an LLM.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "type": "object"
+ },
+ "TextElement": {
+ "properties": {
+ "byteRange": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ByteRange"
+ }
+ ],
+ "description": "Byte range in the parent `text` buffer that this element occupies."
+ },
+ "placeholder": {
+ "description": "Optional human-readable placeholder for the element, displayed in the UI.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "byteRange"
+ ],
+ "type": "object"
+ },
+ "TextResourceContents": {
+ "properties": {
+ "mimeType": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "text": {
+ "type": "string"
+ },
+ "uri": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "uri"
+ ],
+ "type": "object"
+ },
+ "Thread": {
+ "properties": {
+ "cliVersion": {
+ "description": "Version of the CLI that created the thread.",
+ "type": "string"
+ },
+ "createdAt": {
+ "description": "Unix timestamp (in seconds) when the thread was created.",
+ "format": "int64",
+ "type": "integer"
+ },
+ "cwd": {
+ "description": "Working directory captured for the thread.",
+ "type": "string"
+ },
+ "gitInfo": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/GitInfo"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Optional Git metadata captured when the thread was created."
+ },
+ "id": {
+ "type": "string"
+ },
+ "modelProvider": {
+ "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"
+ },
+ "source": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/SessionSource"
+ }
+ ],
+ "description": "Origin of the thread (CLI, VSCode, codex exec, codex app-server, etc.)."
+ },
+ "turns": {
+ "description": "Only populated on `thread/resume`, `thread/rollback`, `thread/fork`, and `thread/read` (when `includeTurns` is true) responses. For all other responses and notifications returning a Thread, the turns field will be an empty list.",
+ "items": {
+ "$ref": "#/definitions/Turn"
+ },
+ "type": "array"
+ },
+ "updatedAt": {
+ "description": "Unix timestamp (in seconds) when the thread was last updated.",
+ "format": "int64",
+ "type": "integer"
+ }
+ },
+ "required": [
+ "cliVersion",
+ "createdAt",
+ "cwd",
+ "id",
+ "modelProvider",
+ "preview",
+ "source",
+ "turns",
+ "updatedAt"
+ ],
+ "type": "object"
+ },
+ "ThreadId": {
+ "type": "string"
+ },
+ "ThreadItem": {
+ "oneOf": [
+ {
+ "properties": {
+ "content": {
+ "items": {
+ "$ref": "#/definitions/UserInput"
+ },
+ "type": "array"
+ },
+ "id": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "userMessage"
+ ],
+ "title": "UserMessageThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "content",
+ "id",
+ "type"
+ ],
+ "title": "UserMessageThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "agentMessage"
+ ],
+ "title": "AgentMessageThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "text",
+ "type"
+ ],
+ "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": {
+ "default": [],
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "id": {
+ "type": "string"
+ },
+ "summary": {
+ "default": [],
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "type": {
+ "enum": [
+ "reasoning"
+ ],
+ "title": "ReasoningThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "type"
+ ],
+ "title": "ReasoningThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "aggregatedOutput": {
+ "description": "The command's output, aggregated from stdout and stderr.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "command": {
+ "description": "The command to be executed.",
+ "type": "string"
+ },
+ "commandActions": {
+ "description": "A best-effort parsing of the command to understand the action(s) it will perform. This returns a list of CommandAction objects because a single shell command may be composed of many commands piped together.",
+ "items": {
+ "$ref": "#/definitions/CommandAction"
+ },
+ "type": "array"
+ },
+ "cwd": {
+ "description": "The command's working directory.",
+ "type": "string"
+ },
+ "durationMs": {
+ "description": "The duration of the command execution in milliseconds.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "exitCode": {
+ "description": "The command's exit code.",
+ "format": "int32",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "id": {
+ "type": "string"
+ },
+ "processId": {
+ "description": "Identifier for the underlying PTY process (when available).",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "status": {
+ "$ref": "#/definitions/CommandExecutionStatus"
+ },
+ "type": {
+ "enum": [
+ "commandExecution"
+ ],
+ "title": "CommandExecutionThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "command",
+ "commandActions",
+ "cwd",
+ "id",
+ "status",
+ "type"
+ ],
+ "title": "CommandExecutionThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "changes": {
+ "items": {
+ "$ref": "#/definitions/FileUpdateChange"
+ },
+ "type": "array"
+ },
+ "id": {
+ "type": "string"
+ },
+ "status": {
+ "$ref": "#/definitions/PatchApplyStatus"
+ },
+ "type": {
+ "enum": [
+ "fileChange"
+ ],
+ "title": "FileChangeThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "changes",
+ "id",
+ "status",
+ "type"
+ ],
+ "title": "FileChangeThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "arguments": true,
+ "durationMs": {
+ "description": "The duration of the MCP tool call in milliseconds.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "error": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/McpToolCallError"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "id": {
+ "type": "string"
+ },
+ "result": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/McpToolCallResult"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "server": {
+ "type": "string"
+ },
+ "status": {
+ "$ref": "#/definitions/McpToolCallStatus"
+ },
+ "tool": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "mcpToolCall"
+ ],
+ "title": "McpToolCallThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "arguments",
+ "id",
+ "server",
+ "status",
+ "tool",
+ "type"
+ ],
+ "title": "McpToolCallThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "agentsStates": {
+ "additionalProperties": {
+ "$ref": "#/definitions/CollabAgentState"
+ },
+ "description": "Last known status of the target agents, when available.",
+ "type": "object"
+ },
+ "id": {
+ "description": "Unique identifier for this collab tool call.",
+ "type": "string"
+ },
+ "prompt": {
+ "description": "Prompt text sent as part of the collab tool call, when available.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "receiverThreadIds": {
+ "description": "Thread ID of the receiving agent, when applicable. In case of spawn operation, this corresponds to the newly spawned agent.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "senderThreadId": {
+ "description": "Thread ID of the agent issuing the collab request.",
+ "type": "string"
+ },
+ "status": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/CollabAgentToolCallStatus"
+ }
+ ],
+ "description": "Current status of the collab tool call."
+ },
+ "tool": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/CollabAgentTool"
+ }
+ ],
+ "description": "Name of the collab tool that was invoked."
+ },
+ "type": {
+ "enum": [
+ "collabAgentToolCall"
+ ],
+ "title": "CollabAgentToolCallThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "agentsStates",
+ "id",
+ "receiverThreadIds",
+ "senderThreadId",
+ "status",
+ "tool",
+ "type"
+ ],
+ "title": "CollabAgentToolCallThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "action": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/WebSearchAction"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "id": {
+ "type": "string"
+ },
+ "query": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "webSearch"
+ ],
+ "title": "WebSearchThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "query",
+ "type"
+ ],
+ "title": "WebSearchThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "imageView"
+ ],
+ "title": "ImageViewThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "path",
+ "type"
+ ],
+ "title": "ImageViewThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "review": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "enteredReviewMode"
+ ],
+ "title": "EnteredReviewModeThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "review",
+ "type"
+ ],
+ "title": "EnteredReviewModeThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "review": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "exitedReviewMode"
+ ],
+ "title": "ExitedReviewModeThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "review",
+ "type"
+ ],
+ "title": "ExitedReviewModeThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "contextCompaction"
+ ],
+ "title": "ContextCompactionThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "type"
+ ],
+ "title": "ContextCompactionThreadItem",
+ "type": "object"
+ }
+ ]
+ },
+ "Turn": {
+ "properties": {
+ "error": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/TurnError"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Only populated when the Turn's status is failed."
+ },
+ "id": {
+ "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.",
+ "items": {
+ "$ref": "#/definitions/ThreadItem"
+ },
+ "type": "array"
+ },
+ "status": {
+ "$ref": "#/definitions/TurnStatus"
+ }
+ },
+ "required": [
+ "id",
+ "items",
+ "status"
+ ],
+ "type": "object"
+ },
+ "TurnError": {
+ "properties": {
+ "additionalDetails": {
+ "default": null,
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "codexErrorInfo": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/CodexErrorInfo"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "message": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "message"
+ ],
+ "type": "object"
+ },
+ "TurnStatus": {
+ "enum": [
+ "completed",
+ "interrupted",
+ "failed",
+ "inProgress"
+ ],
+ "type": "string"
+ },
+ "UserInput": {
+ "oneOf": [
+ {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "text_elements": {
+ "default": [],
+ "description": "UI-defined spans within `text` used to render or persist special elements.",
+ "items": {
+ "$ref": "#/definitions/TextElement"
+ },
+ "type": "array"
+ },
+ "type": {
+ "enum": [
+ "text"
+ ],
+ "title": "TextUserInputType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "TextUserInput",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "image"
+ ],
+ "title": "ImageUserInputType",
+ "type": "string"
+ },
+ "url": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "url"
+ ],
+ "title": "ImageUserInput",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "localImage"
+ ],
+ "title": "LocalImageUserInputType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "path",
+ "type"
+ ],
+ "title": "LocalImageUserInput",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "name": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "skill"
+ ],
+ "title": "SkillUserInputType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "path",
+ "type"
+ ],
+ "title": "SkillUserInput",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "name": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "mention"
+ ],
+ "title": "MentionUserInputType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "path",
+ "type"
+ ],
+ "title": "MentionUserInput",
+ "type": "object"
+ }
+ ]
+ },
+ "WebSearchAction": {
+ "oneOf": [
+ {
+ "properties": {
+ "queries": {
+ "items": {
+ "type": "string"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "query": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "search"
+ ],
+ "title": "SearchWebSearchActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "SearchWebSearchAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "openPage"
+ ],
+ "title": "OpenPageWebSearchActionType",
+ "type": "string"
+ },
+ "url": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "OpenPageWebSearchAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "pattern": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "findInPage"
+ ],
+ "title": "FindInPageWebSearchActionType",
+ "type": "string"
+ },
+ "url": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "FindInPageWebSearchAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "other"
+ ],
+ "title": "OtherWebSearchActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "OtherWebSearchAction",
+ "type": "object"
+ }
+ ]
+ }
+ },
+ "properties": {
+ "thread": {
+ "$ref": "#/definitions/Thread"
+ }
+ },
+ "required": [
+ "thread"
+ ],
+ "title": "ThreadReadResponse",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v2/ThreadResumeParams.json b/codex-rs/app-server-protocol/schema/json/v2/ThreadResumeParams.json
new file mode 100644
index 0000000000..3da1e3c749
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v2/ThreadResumeParams.json
@@ -0,0 +1,872 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "definitions": {
+ "AskForApproval": {
+ "enum": [
+ "untrusted",
+ "on-failure",
+ "on-request",
+ "never"
+ ],
+ "type": "string"
+ },
+ "ContentItem": {
+ "oneOf": [
+ {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "input_text"
+ ],
+ "title": "InputTextContentItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "InputTextContentItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "image_url": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "input_image"
+ ],
+ "title": "InputImageContentItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "image_url",
+ "type"
+ ],
+ "title": "InputImageContentItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "output_text"
+ ],
+ "title": "OutputTextContentItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "OutputTextContentItem",
+ "type": "object"
+ }
+ ]
+ },
+ "FunctionCallOutputContentItem": {
+ "description": "Responses API compatible content items that can be returned by a tool call. This is a subset of ContentItem with the types we support as function call outputs.",
+ "oneOf": [
+ {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "input_text"
+ ],
+ "title": "InputTextFunctionCallOutputContentItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "InputTextFunctionCallOutputContentItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "image_url": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "input_image"
+ ],
+ "title": "InputImageFunctionCallOutputContentItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "image_url",
+ "type"
+ ],
+ "title": "InputImageFunctionCallOutputContentItem",
+ "type": "object"
+ }
+ ]
+ },
+ "FunctionCallOutputPayload": {
+ "description": "The payload we send back to OpenAI when reporting a tool call result.\n\n`content` preserves the historical plain-string payload so downstream integrations (tests, logging, etc.) can keep treating tool output as `String`. When an MCP server returns richer data we additionally populate `content_items` with the structured form that the Responses/Chat Completions APIs understand.",
+ "properties": {
+ "content": {
+ "type": "string"
+ },
+ "content_items": {
+ "items": {
+ "$ref": "#/definitions/FunctionCallOutputContentItem"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "success": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "content"
+ ],
+ "type": "object"
+ },
+ "GhostCommit": {
+ "description": "Details of a ghost commit created from a repository state.",
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "parent": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "preexisting_untracked_dirs": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "preexisting_untracked_files": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ }
+ },
+ "required": [
+ "id",
+ "preexisting_untracked_dirs",
+ "preexisting_untracked_files"
+ ],
+ "type": "object"
+ },
+ "LocalShellAction": {
+ "oneOf": [
+ {
+ "properties": {
+ "command": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "env": {
+ "additionalProperties": {
+ "type": "string"
+ },
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "timeout_ms": {
+ "format": "uint64",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "exec"
+ ],
+ "title": "ExecLocalShellActionType",
+ "type": "string"
+ },
+ "user": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "working_directory": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "command",
+ "type"
+ ],
+ "title": "ExecLocalShellAction",
+ "type": "object"
+ }
+ ]
+ },
+ "LocalShellStatus": {
+ "enum": [
+ "completed",
+ "in_progress",
+ "incomplete"
+ ],
+ "type": "string"
+ },
+ "Personality": {
+ "enum": [
+ "friendly",
+ "pragmatic"
+ ],
+ "type": "string"
+ },
+ "ReasoningItemContent": {
+ "oneOf": [
+ {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "reasoning_text"
+ ],
+ "title": "ReasoningTextReasoningItemContentType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "ReasoningTextReasoningItemContent",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "text"
+ ],
+ "title": "TextReasoningItemContentType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "TextReasoningItemContent",
+ "type": "object"
+ }
+ ]
+ },
+ "ReasoningItemReasoningSummary": {
+ "oneOf": [
+ {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "summary_text"
+ ],
+ "title": "SummaryTextReasoningItemReasoningSummaryType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "SummaryTextReasoningItemReasoningSummary",
+ "type": "object"
+ }
+ ]
+ },
+ "ResponseItem": {
+ "oneOf": [
+ {
+ "properties": {
+ "content": {
+ "items": {
+ "$ref": "#/definitions/ContentItem"
+ },
+ "type": "array"
+ },
+ "end_turn": {
+ "type": [
+ "boolean",
+ "null"
+ ]
+ },
+ "id": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "writeOnly": true
+ },
+ "role": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "message"
+ ],
+ "title": "MessageResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "content",
+ "role",
+ "type"
+ ],
+ "title": "MessageResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "content": {
+ "default": null,
+ "items": {
+ "$ref": "#/definitions/ReasoningItemContent"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "encrypted_content": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "id": {
+ "type": "string",
+ "writeOnly": true
+ },
+ "summary": {
+ "items": {
+ "$ref": "#/definitions/ReasoningItemReasoningSummary"
+ },
+ "type": "array"
+ },
+ "type": {
+ "enum": [
+ "reasoning"
+ ],
+ "title": "ReasoningResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "summary",
+ "type"
+ ],
+ "title": "ReasoningResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "action": {
+ "$ref": "#/definitions/LocalShellAction"
+ },
+ "call_id": {
+ "description": "Set when using the Responses API.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "id": {
+ "description": "Set when using the chat completions API.",
+ "type": [
+ "string",
+ "null"
+ ],
+ "writeOnly": true
+ },
+ "status": {
+ "$ref": "#/definitions/LocalShellStatus"
+ },
+ "type": {
+ "enum": [
+ "local_shell_call"
+ ],
+ "title": "LocalShellCallResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "action",
+ "status",
+ "type"
+ ],
+ "title": "LocalShellCallResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "arguments": {
+ "type": "string"
+ },
+ "call_id": {
+ "type": "string"
+ },
+ "id": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "writeOnly": true
+ },
+ "name": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "function_call"
+ ],
+ "title": "FunctionCallResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "arguments",
+ "call_id",
+ "name",
+ "type"
+ ],
+ "title": "FunctionCallResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "call_id": {
+ "type": "string"
+ },
+ "output": {
+ "$ref": "#/definitions/FunctionCallOutputPayload"
+ },
+ "type": {
+ "enum": [
+ "function_call_output"
+ ],
+ "title": "FunctionCallOutputResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "output",
+ "type"
+ ],
+ "title": "FunctionCallOutputResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "call_id": {
+ "type": "string"
+ },
+ "id": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "writeOnly": true
+ },
+ "input": {
+ "type": "string"
+ },
+ "name": {
+ "type": "string"
+ },
+ "status": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "custom_tool_call"
+ ],
+ "title": "CustomToolCallResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "input",
+ "name",
+ "type"
+ ],
+ "title": "CustomToolCallResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "call_id": {
+ "type": "string"
+ },
+ "output": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "custom_tool_call_output"
+ ],
+ "title": "CustomToolCallOutputResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "call_id",
+ "output",
+ "type"
+ ],
+ "title": "CustomToolCallOutputResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "action": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/WebSearchAction"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "id": {
+ "type": [
+ "string",
+ "null"
+ ],
+ "writeOnly": true
+ },
+ "status": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "web_search_call"
+ ],
+ "title": "WebSearchCallResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "WebSearchCallResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "ghost_commit": {
+ "$ref": "#/definitions/GhostCommit"
+ },
+ "type": {
+ "enum": [
+ "ghost_snapshot"
+ ],
+ "title": "GhostSnapshotResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "ghost_commit",
+ "type"
+ ],
+ "title": "GhostSnapshotResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "encrypted_content": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "compaction"
+ ],
+ "title": "CompactionResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "encrypted_content",
+ "type"
+ ],
+ "title": "CompactionResponseItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "other"
+ ],
+ "title": "OtherResponseItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "OtherResponseItem",
+ "type": "object"
+ }
+ ]
+ },
+ "SandboxMode": {
+ "enum": [
+ "read-only",
+ "workspace-write",
+ "danger-full-access"
+ ],
+ "type": "string"
+ },
+ "WebSearchAction": {
+ "oneOf": [
+ {
+ "properties": {
+ "queries": {
+ "items": {
+ "type": "string"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "query": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "search"
+ ],
+ "title": "SearchWebSearchActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "SearchWebSearchAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "open_page"
+ ],
+ "title": "OpenPageWebSearchActionType",
+ "type": "string"
+ },
+ "url": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "OpenPageWebSearchAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "pattern": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "find_in_page"
+ ],
+ "title": "FindInPageWebSearchActionType",
+ "type": "string"
+ },
+ "url": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "FindInPageWebSearchAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "other"
+ ],
+ "title": "OtherWebSearchActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "OtherWebSearchAction",
+ "type": "object"
+ }
+ ]
+ }
+ },
+ "description": "There are three ways to resume a thread: 1. By thread_id: load the thread from disk by thread_id and resume it. 2. By history: instantiate the thread from memory and resume it. 3. By path: load the thread from disk by path and resume it.\n\nThe precedence is: history > path > thread_id. If using history or path, the thread_id param will be ignored.\n\nPrefer using thread_id whenever possible.",
+ "properties": {
+ "approvalPolicy": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/AskForApproval"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "baseInstructions": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "config": {
+ "additionalProperties": true,
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "cwd": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "developerInstructions": {
+ "type": [
+ "string",
+ "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": [
+ "string",
+ "null"
+ ]
+ },
+ "modelProvider": {
+ "type": [
+ "string",
+ "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": [
+ {
+ "$ref": "#/definitions/Personality"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "sandbox": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/SandboxMode"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "threadId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "threadId"
+ ],
+ "title": "ThreadResumeParams",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v2/ThreadResumeResponse.json b/codex-rs/app-server-protocol/schema/json/v2/ThreadResumeResponse.json
new file mode 100644
index 0000000000..dad4ccbfeb
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v2/ThreadResumeResponse.json
@@ -0,0 +1,1859 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "definitions": {
+ "AbsolutePathBuf": {
+ "description": "A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem).\n\nIMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set, the deserialization will fail unless the path being deserialized is already absolute.",
+ "type": "string"
+ },
+ "Annotations": {
+ "description": "Optional annotations for the client. The client can use annotations to inform how objects are used or displayed",
+ "properties": {
+ "audience": {
+ "items": {
+ "$ref": "#/definitions/Role"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "lastModified": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "priority": {
+ "format": "double",
+ "type": [
+ "number",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "AskForApproval": {
+ "enum": [
+ "untrusted",
+ "on-failure",
+ "on-request",
+ "never"
+ ],
+ "type": "string"
+ },
+ "AudioContent": {
+ "description": "Audio provided to or from an LLM.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "data": {
+ "type": "string"
+ },
+ "mimeType": {
+ "type": "string"
+ },
+ "type": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "data",
+ "mimeType",
+ "type"
+ ],
+ "type": "object"
+ },
+ "BlobResourceContents": {
+ "properties": {
+ "blob": {
+ "type": "string"
+ },
+ "mimeType": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "uri": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "blob",
+ "uri"
+ ],
+ "type": "object"
+ },
+ "ByteRange": {
+ "properties": {
+ "end": {
+ "format": "uint",
+ "minimum": 0.0,
+ "type": "integer"
+ },
+ "start": {
+ "format": "uint",
+ "minimum": 0.0,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "end",
+ "start"
+ ],
+ "type": "object"
+ },
+ "CodexErrorInfo": {
+ "description": "This translation layer make sure that we expose codex error code in camel case.\n\nWhen an upstream HTTP status is available (for example, from the Responses API or a provider), it is forwarded in `httpStatusCode` on the relevant `codexErrorInfo` variant.",
+ "oneOf": [
+ {
+ "enum": [
+ "contextWindowExceeded",
+ "usageLimitExceeded",
+ "internalServerError",
+ "unauthorized",
+ "badRequest",
+ "threadRollbackFailed",
+ "sandboxError",
+ "other"
+ ],
+ "type": "string"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "modelCap": {
+ "properties": {
+ "model": {
+ "type": "string"
+ },
+ "reset_after_seconds": {
+ "format": "uint64",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "model"
+ ],
+ "type": "object"
+ }
+ },
+ "required": [
+ "modelCap"
+ ],
+ "title": "ModelCapCodexErrorInfo",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "httpConnectionFailed": {
+ "properties": {
+ "httpStatusCode": {
+ "format": "uint16",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "httpConnectionFailed"
+ ],
+ "title": "HttpConnectionFailedCodexErrorInfo",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "Failed to connect to the response SSE stream.",
+ "properties": {
+ "responseStreamConnectionFailed": {
+ "properties": {
+ "httpStatusCode": {
+ "format": "uint16",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "responseStreamConnectionFailed"
+ ],
+ "title": "ResponseStreamConnectionFailedCodexErrorInfo",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "The response SSE stream disconnected in the middle of a turn before completion.",
+ "properties": {
+ "responseStreamDisconnected": {
+ "properties": {
+ "httpStatusCode": {
+ "format": "uint16",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "responseStreamDisconnected"
+ ],
+ "title": "ResponseStreamDisconnectedCodexErrorInfo",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "Reached the retry limit for responses.",
+ "properties": {
+ "responseTooManyFailedAttempts": {
+ "properties": {
+ "httpStatusCode": {
+ "format": "uint16",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "responseTooManyFailedAttempts"
+ ],
+ "title": "ResponseTooManyFailedAttemptsCodexErrorInfo",
+ "type": "object"
+ }
+ ]
+ },
+ "CollabAgentState": {
+ "properties": {
+ "message": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "status": {
+ "$ref": "#/definitions/CollabAgentStatus"
+ }
+ },
+ "required": [
+ "status"
+ ],
+ "type": "object"
+ },
+ "CollabAgentStatus": {
+ "enum": [
+ "pendingInit",
+ "running",
+ "completed",
+ "errored",
+ "shutdown",
+ "notFound"
+ ],
+ "type": "string"
+ },
+ "CollabAgentTool": {
+ "enum": [
+ "spawnAgent",
+ "sendInput",
+ "wait",
+ "closeAgent"
+ ],
+ "type": "string"
+ },
+ "CollabAgentToolCallStatus": {
+ "enum": [
+ "inProgress",
+ "completed",
+ "failed"
+ ],
+ "type": "string"
+ },
+ "CommandAction": {
+ "oneOf": [
+ {
+ "properties": {
+ "command": {
+ "type": "string"
+ },
+ "name": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "read"
+ ],
+ "title": "ReadCommandActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "command",
+ "name",
+ "path",
+ "type"
+ ],
+ "title": "ReadCommandAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "command": {
+ "type": "string"
+ },
+ "path": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "listFiles"
+ ],
+ "title": "ListFilesCommandActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "command",
+ "type"
+ ],
+ "title": "ListFilesCommandAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "command": {
+ "type": "string"
+ },
+ "path": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "query": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "search"
+ ],
+ "title": "SearchCommandActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "command",
+ "type"
+ ],
+ "title": "SearchCommandAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "command": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "unknown"
+ ],
+ "title": "UnknownCommandActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "command",
+ "type"
+ ],
+ "title": "UnknownCommandAction",
+ "type": "object"
+ }
+ ]
+ },
+ "CommandExecutionStatus": {
+ "enum": [
+ "inProgress",
+ "completed",
+ "failed",
+ "declined"
+ ],
+ "type": "string"
+ },
+ "ContentBlock": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/TextContent"
+ },
+ {
+ "$ref": "#/definitions/ImageContent"
+ },
+ {
+ "$ref": "#/definitions/AudioContent"
+ },
+ {
+ "$ref": "#/definitions/ResourceLink"
+ },
+ {
+ "$ref": "#/definitions/EmbeddedResource"
+ }
+ ]
+ },
+ "EmbeddedResource": {
+ "description": "The contents of a resource, embedded into a prompt or tool call result.\n\nIt is up to the client how best to render embedded resources for the benefit of the LLM and/or the user.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "resource": {
+ "$ref": "#/definitions/EmbeddedResourceResource"
+ },
+ "type": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "resource",
+ "type"
+ ],
+ "type": "object"
+ },
+ "EmbeddedResourceResource": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/TextResourceContents"
+ },
+ {
+ "$ref": "#/definitions/BlobResourceContents"
+ }
+ ]
+ },
+ "FileUpdateChange": {
+ "properties": {
+ "diff": {
+ "type": "string"
+ },
+ "kind": {
+ "$ref": "#/definitions/PatchChangeKind"
+ },
+ "path": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "diff",
+ "kind",
+ "path"
+ ],
+ "type": "object"
+ },
+ "GitInfo": {
+ "properties": {
+ "branch": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "originUrl": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "sha": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "ImageContent": {
+ "description": "An image provided to or from an LLM.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "data": {
+ "type": "string"
+ },
+ "mimeType": {
+ "type": "string"
+ },
+ "type": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "data",
+ "mimeType",
+ "type"
+ ],
+ "type": "object"
+ },
+ "McpToolCallError": {
+ "properties": {
+ "message": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "message"
+ ],
+ "type": "object"
+ },
+ "McpToolCallResult": {
+ "properties": {
+ "content": {
+ "items": {
+ "$ref": "#/definitions/ContentBlock"
+ },
+ "type": "array"
+ },
+ "structuredContent": true
+ },
+ "required": [
+ "content"
+ ],
+ "type": "object"
+ },
+ "McpToolCallStatus": {
+ "enum": [
+ "inProgress",
+ "completed",
+ "failed"
+ ],
+ "type": "string"
+ },
+ "NetworkAccess": {
+ "enum": [
+ "restricted",
+ "enabled"
+ ],
+ "type": "string"
+ },
+ "PatchApplyStatus": {
+ "enum": [
+ "inProgress",
+ "completed",
+ "failed",
+ "declined"
+ ],
+ "type": "string"
+ },
+ "PatchChangeKind": {
+ "oneOf": [
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "add"
+ ],
+ "title": "AddPatchChangeKindType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "AddPatchChangeKind",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "delete"
+ ],
+ "title": "DeletePatchChangeKindType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "DeletePatchChangeKind",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "move_path": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "update"
+ ],
+ "title": "UpdatePatchChangeKindType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "UpdatePatchChangeKind",
+ "type": "object"
+ }
+ ]
+ },
+ "ReasoningEffort": {
+ "description": "See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#get-started-with-reasoning",
+ "enum": [
+ "none",
+ "minimal",
+ "low",
+ "medium",
+ "high",
+ "xhigh"
+ ],
+ "type": "string"
+ },
+ "ResourceLink": {
+ "description": "A resource that the server is capable of reading, included in a prompt or tool call result.\n\nNote: resource links returned by tools are not guaranteed to appear in the results of `resources/list` requests.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "description": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "mimeType": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "name": {
+ "type": "string"
+ },
+ "size": {
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "title": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "type": "string"
+ },
+ "uri": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "type",
+ "uri"
+ ],
+ "type": "object"
+ },
+ "Role": {
+ "description": "The sender or recipient of messages and data in a conversation.",
+ "enum": [
+ "assistant",
+ "user"
+ ],
+ "type": "string"
+ },
+ "SandboxPolicy": {
+ "oneOf": [
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "dangerFullAccess"
+ ],
+ "title": "DangerFullAccessSandboxPolicyType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "DangerFullAccessSandboxPolicy",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "readOnly"
+ ],
+ "title": "ReadOnlySandboxPolicyType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "ReadOnlySandboxPolicy",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "networkAccess": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/NetworkAccess"
+ }
+ ],
+ "default": "restricted"
+ },
+ "type": {
+ "enum": [
+ "externalSandbox"
+ ],
+ "title": "ExternalSandboxSandboxPolicyType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "ExternalSandboxSandboxPolicy",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "excludeSlashTmp": {
+ "default": false,
+ "type": "boolean"
+ },
+ "excludeTmpdirEnvVar": {
+ "default": false,
+ "type": "boolean"
+ },
+ "networkAccess": {
+ "default": false,
+ "type": "boolean"
+ },
+ "type": {
+ "enum": [
+ "workspaceWrite"
+ ],
+ "title": "WorkspaceWriteSandboxPolicyType",
+ "type": "string"
+ },
+ "writableRoots": {
+ "default": [],
+ "items": {
+ "$ref": "#/definitions/AbsolutePathBuf"
+ },
+ "type": "array"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "WorkspaceWriteSandboxPolicy",
+ "type": "object"
+ }
+ ]
+ },
+ "SessionSource": {
+ "oneOf": [
+ {
+ "enum": [
+ "cli",
+ "vscode",
+ "exec",
+ "appServer",
+ "unknown"
+ ],
+ "type": "string"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "subAgent": {
+ "$ref": "#/definitions/SubAgentSource"
+ }
+ },
+ "required": [
+ "subAgent"
+ ],
+ "title": "SubAgentSessionSource",
+ "type": "object"
+ }
+ ]
+ },
+ "SubAgentSource": {
+ "oneOf": [
+ {
+ "enum": [
+ "review",
+ "compact"
+ ],
+ "type": "string"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "thread_spawn": {
+ "properties": {
+ "depth": {
+ "format": "int32",
+ "type": "integer"
+ },
+ "parent_thread_id": {
+ "$ref": "#/definitions/ThreadId"
+ }
+ },
+ "required": [
+ "depth",
+ "parent_thread_id"
+ ],
+ "type": "object"
+ }
+ },
+ "required": [
+ "thread_spawn"
+ ],
+ "title": "ThreadSpawnSubAgentSource",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "other": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "other"
+ ],
+ "title": "OtherSubAgentSource",
+ "type": "object"
+ }
+ ]
+ },
+ "TextContent": {
+ "description": "Text provided to or from an LLM.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "type": "object"
+ },
+ "TextElement": {
+ "properties": {
+ "byteRange": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ByteRange"
+ }
+ ],
+ "description": "Byte range in the parent `text` buffer that this element occupies."
+ },
+ "placeholder": {
+ "description": "Optional human-readable placeholder for the element, displayed in the UI.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "byteRange"
+ ],
+ "type": "object"
+ },
+ "TextResourceContents": {
+ "properties": {
+ "mimeType": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "text": {
+ "type": "string"
+ },
+ "uri": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "uri"
+ ],
+ "type": "object"
+ },
+ "Thread": {
+ "properties": {
+ "cliVersion": {
+ "description": "Version of the CLI that created the thread.",
+ "type": "string"
+ },
+ "createdAt": {
+ "description": "Unix timestamp (in seconds) when the thread was created.",
+ "format": "int64",
+ "type": "integer"
+ },
+ "cwd": {
+ "description": "Working directory captured for the thread.",
+ "type": "string"
+ },
+ "gitInfo": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/GitInfo"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Optional Git metadata captured when the thread was created."
+ },
+ "id": {
+ "type": "string"
+ },
+ "modelProvider": {
+ "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"
+ },
+ "source": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/SessionSource"
+ }
+ ],
+ "description": "Origin of the thread (CLI, VSCode, codex exec, codex app-server, etc.)."
+ },
+ "turns": {
+ "description": "Only populated on `thread/resume`, `thread/rollback`, `thread/fork`, and `thread/read` (when `includeTurns` is true) responses. For all other responses and notifications returning a Thread, the turns field will be an empty list.",
+ "items": {
+ "$ref": "#/definitions/Turn"
+ },
+ "type": "array"
+ },
+ "updatedAt": {
+ "description": "Unix timestamp (in seconds) when the thread was last updated.",
+ "format": "int64",
+ "type": "integer"
+ }
+ },
+ "required": [
+ "cliVersion",
+ "createdAt",
+ "cwd",
+ "id",
+ "modelProvider",
+ "preview",
+ "source",
+ "turns",
+ "updatedAt"
+ ],
+ "type": "object"
+ },
+ "ThreadId": {
+ "type": "string"
+ },
+ "ThreadItem": {
+ "oneOf": [
+ {
+ "properties": {
+ "content": {
+ "items": {
+ "$ref": "#/definitions/UserInput"
+ },
+ "type": "array"
+ },
+ "id": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "userMessage"
+ ],
+ "title": "UserMessageThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "content",
+ "id",
+ "type"
+ ],
+ "title": "UserMessageThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "agentMessage"
+ ],
+ "title": "AgentMessageThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "text",
+ "type"
+ ],
+ "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": {
+ "default": [],
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "id": {
+ "type": "string"
+ },
+ "summary": {
+ "default": [],
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "type": {
+ "enum": [
+ "reasoning"
+ ],
+ "title": "ReasoningThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "type"
+ ],
+ "title": "ReasoningThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "aggregatedOutput": {
+ "description": "The command's output, aggregated from stdout and stderr.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "command": {
+ "description": "The command to be executed.",
+ "type": "string"
+ },
+ "commandActions": {
+ "description": "A best-effort parsing of the command to understand the action(s) it will perform. This returns a list of CommandAction objects because a single shell command may be composed of many commands piped together.",
+ "items": {
+ "$ref": "#/definitions/CommandAction"
+ },
+ "type": "array"
+ },
+ "cwd": {
+ "description": "The command's working directory.",
+ "type": "string"
+ },
+ "durationMs": {
+ "description": "The duration of the command execution in milliseconds.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "exitCode": {
+ "description": "The command's exit code.",
+ "format": "int32",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "id": {
+ "type": "string"
+ },
+ "processId": {
+ "description": "Identifier for the underlying PTY process (when available).",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "status": {
+ "$ref": "#/definitions/CommandExecutionStatus"
+ },
+ "type": {
+ "enum": [
+ "commandExecution"
+ ],
+ "title": "CommandExecutionThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "command",
+ "commandActions",
+ "cwd",
+ "id",
+ "status",
+ "type"
+ ],
+ "title": "CommandExecutionThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "changes": {
+ "items": {
+ "$ref": "#/definitions/FileUpdateChange"
+ },
+ "type": "array"
+ },
+ "id": {
+ "type": "string"
+ },
+ "status": {
+ "$ref": "#/definitions/PatchApplyStatus"
+ },
+ "type": {
+ "enum": [
+ "fileChange"
+ ],
+ "title": "FileChangeThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "changes",
+ "id",
+ "status",
+ "type"
+ ],
+ "title": "FileChangeThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "arguments": true,
+ "durationMs": {
+ "description": "The duration of the MCP tool call in milliseconds.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "error": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/McpToolCallError"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "id": {
+ "type": "string"
+ },
+ "result": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/McpToolCallResult"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "server": {
+ "type": "string"
+ },
+ "status": {
+ "$ref": "#/definitions/McpToolCallStatus"
+ },
+ "tool": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "mcpToolCall"
+ ],
+ "title": "McpToolCallThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "arguments",
+ "id",
+ "server",
+ "status",
+ "tool",
+ "type"
+ ],
+ "title": "McpToolCallThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "agentsStates": {
+ "additionalProperties": {
+ "$ref": "#/definitions/CollabAgentState"
+ },
+ "description": "Last known status of the target agents, when available.",
+ "type": "object"
+ },
+ "id": {
+ "description": "Unique identifier for this collab tool call.",
+ "type": "string"
+ },
+ "prompt": {
+ "description": "Prompt text sent as part of the collab tool call, when available.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "receiverThreadIds": {
+ "description": "Thread ID of the receiving agent, when applicable. In case of spawn operation, this corresponds to the newly spawned agent.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "senderThreadId": {
+ "description": "Thread ID of the agent issuing the collab request.",
+ "type": "string"
+ },
+ "status": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/CollabAgentToolCallStatus"
+ }
+ ],
+ "description": "Current status of the collab tool call."
+ },
+ "tool": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/CollabAgentTool"
+ }
+ ],
+ "description": "Name of the collab tool that was invoked."
+ },
+ "type": {
+ "enum": [
+ "collabAgentToolCall"
+ ],
+ "title": "CollabAgentToolCallThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "agentsStates",
+ "id",
+ "receiverThreadIds",
+ "senderThreadId",
+ "status",
+ "tool",
+ "type"
+ ],
+ "title": "CollabAgentToolCallThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "action": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/WebSearchAction"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "id": {
+ "type": "string"
+ },
+ "query": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "webSearch"
+ ],
+ "title": "WebSearchThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "query",
+ "type"
+ ],
+ "title": "WebSearchThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "imageView"
+ ],
+ "title": "ImageViewThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "path",
+ "type"
+ ],
+ "title": "ImageViewThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "review": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "enteredReviewMode"
+ ],
+ "title": "EnteredReviewModeThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "review",
+ "type"
+ ],
+ "title": "EnteredReviewModeThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "review": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "exitedReviewMode"
+ ],
+ "title": "ExitedReviewModeThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "review",
+ "type"
+ ],
+ "title": "ExitedReviewModeThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "contextCompaction"
+ ],
+ "title": "ContextCompactionThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "type"
+ ],
+ "title": "ContextCompactionThreadItem",
+ "type": "object"
+ }
+ ]
+ },
+ "Turn": {
+ "properties": {
+ "error": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/TurnError"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Only populated when the Turn's status is failed."
+ },
+ "id": {
+ "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.",
+ "items": {
+ "$ref": "#/definitions/ThreadItem"
+ },
+ "type": "array"
+ },
+ "status": {
+ "$ref": "#/definitions/TurnStatus"
+ }
+ },
+ "required": [
+ "id",
+ "items",
+ "status"
+ ],
+ "type": "object"
+ },
+ "TurnError": {
+ "properties": {
+ "additionalDetails": {
+ "default": null,
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "codexErrorInfo": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/CodexErrorInfo"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "message": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "message"
+ ],
+ "type": "object"
+ },
+ "TurnStatus": {
+ "enum": [
+ "completed",
+ "interrupted",
+ "failed",
+ "inProgress"
+ ],
+ "type": "string"
+ },
+ "UserInput": {
+ "oneOf": [
+ {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "text_elements": {
+ "default": [],
+ "description": "UI-defined spans within `text` used to render or persist special elements.",
+ "items": {
+ "$ref": "#/definitions/TextElement"
+ },
+ "type": "array"
+ },
+ "type": {
+ "enum": [
+ "text"
+ ],
+ "title": "TextUserInputType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "TextUserInput",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "image"
+ ],
+ "title": "ImageUserInputType",
+ "type": "string"
+ },
+ "url": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "url"
+ ],
+ "title": "ImageUserInput",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "localImage"
+ ],
+ "title": "LocalImageUserInputType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "path",
+ "type"
+ ],
+ "title": "LocalImageUserInput",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "name": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "skill"
+ ],
+ "title": "SkillUserInputType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "path",
+ "type"
+ ],
+ "title": "SkillUserInput",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "name": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "mention"
+ ],
+ "title": "MentionUserInputType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "path",
+ "type"
+ ],
+ "title": "MentionUserInput",
+ "type": "object"
+ }
+ ]
+ },
+ "WebSearchAction": {
+ "oneOf": [
+ {
+ "properties": {
+ "queries": {
+ "items": {
+ "type": "string"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "query": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "search"
+ ],
+ "title": "SearchWebSearchActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "SearchWebSearchAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "openPage"
+ ],
+ "title": "OpenPageWebSearchActionType",
+ "type": "string"
+ },
+ "url": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "OpenPageWebSearchAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "pattern": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "findInPage"
+ ],
+ "title": "FindInPageWebSearchActionType",
+ "type": "string"
+ },
+ "url": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "FindInPageWebSearchAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "other"
+ ],
+ "title": "OtherWebSearchActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "OtherWebSearchAction",
+ "type": "object"
+ }
+ ]
+ }
+ },
+ "properties": {
+ "approvalPolicy": {
+ "$ref": "#/definitions/AskForApproval"
+ },
+ "cwd": {
+ "type": "string"
+ },
+ "model": {
+ "type": "string"
+ },
+ "modelProvider": {
+ "type": "string"
+ },
+ "reasoningEffort": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ReasoningEffort"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "sandbox": {
+ "$ref": "#/definitions/SandboxPolicy"
+ },
+ "thread": {
+ "$ref": "#/definitions/Thread"
+ }
+ },
+ "required": [
+ "approvalPolicy",
+ "cwd",
+ "model",
+ "modelProvider",
+ "sandbox",
+ "thread"
+ ],
+ "title": "ThreadResumeResponse",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v2/ThreadRollbackParams.json b/codex-rs/app-server-protocol/schema/json/v2/ThreadRollbackParams.json
new file mode 100644
index 0000000000..cb3ba0db39
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v2/ThreadRollbackParams.json
@@ -0,0 +1,20 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "numTurns": {
+ "description": "The number of turns to drop from the end of the thread. Must be >= 1.\n\nThis only modifies the thread's history and does not revert local file changes that have been made by the agent. Clients are responsible for reverting these changes.",
+ "format": "uint32",
+ "minimum": 0.0,
+ "type": "integer"
+ },
+ "threadId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "numTurns",
+ "threadId"
+ ],
+ "title": "ThreadRollbackParams",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v2/ThreadRollbackResponse.json b/codex-rs/app-server-protocol/schema/json/v2/ThreadRollbackResponse.json
new file mode 100644
index 0000000000..3ebb5052d3
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v2/ThreadRollbackResponse.json
@@ -0,0 +1,1707 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "definitions": {
+ "Annotations": {
+ "description": "Optional annotations for the client. The client can use annotations to inform how objects are used or displayed",
+ "properties": {
+ "audience": {
+ "items": {
+ "$ref": "#/definitions/Role"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "lastModified": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "priority": {
+ "format": "double",
+ "type": [
+ "number",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "AudioContent": {
+ "description": "Audio provided to or from an LLM.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "data": {
+ "type": "string"
+ },
+ "mimeType": {
+ "type": "string"
+ },
+ "type": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "data",
+ "mimeType",
+ "type"
+ ],
+ "type": "object"
+ },
+ "BlobResourceContents": {
+ "properties": {
+ "blob": {
+ "type": "string"
+ },
+ "mimeType": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "uri": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "blob",
+ "uri"
+ ],
+ "type": "object"
+ },
+ "ByteRange": {
+ "properties": {
+ "end": {
+ "format": "uint",
+ "minimum": 0.0,
+ "type": "integer"
+ },
+ "start": {
+ "format": "uint",
+ "minimum": 0.0,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "end",
+ "start"
+ ],
+ "type": "object"
+ },
+ "CodexErrorInfo": {
+ "description": "This translation layer make sure that we expose codex error code in camel case.\n\nWhen an upstream HTTP status is available (for example, from the Responses API or a provider), it is forwarded in `httpStatusCode` on the relevant `codexErrorInfo` variant.",
+ "oneOf": [
+ {
+ "enum": [
+ "contextWindowExceeded",
+ "usageLimitExceeded",
+ "internalServerError",
+ "unauthorized",
+ "badRequest",
+ "threadRollbackFailed",
+ "sandboxError",
+ "other"
+ ],
+ "type": "string"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "modelCap": {
+ "properties": {
+ "model": {
+ "type": "string"
+ },
+ "reset_after_seconds": {
+ "format": "uint64",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "model"
+ ],
+ "type": "object"
+ }
+ },
+ "required": [
+ "modelCap"
+ ],
+ "title": "ModelCapCodexErrorInfo",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "httpConnectionFailed": {
+ "properties": {
+ "httpStatusCode": {
+ "format": "uint16",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "httpConnectionFailed"
+ ],
+ "title": "HttpConnectionFailedCodexErrorInfo",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "Failed to connect to the response SSE stream.",
+ "properties": {
+ "responseStreamConnectionFailed": {
+ "properties": {
+ "httpStatusCode": {
+ "format": "uint16",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "responseStreamConnectionFailed"
+ ],
+ "title": "ResponseStreamConnectionFailedCodexErrorInfo",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "The response SSE stream disconnected in the middle of a turn before completion.",
+ "properties": {
+ "responseStreamDisconnected": {
+ "properties": {
+ "httpStatusCode": {
+ "format": "uint16",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "responseStreamDisconnected"
+ ],
+ "title": "ResponseStreamDisconnectedCodexErrorInfo",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "Reached the retry limit for responses.",
+ "properties": {
+ "responseTooManyFailedAttempts": {
+ "properties": {
+ "httpStatusCode": {
+ "format": "uint16",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "responseTooManyFailedAttempts"
+ ],
+ "title": "ResponseTooManyFailedAttemptsCodexErrorInfo",
+ "type": "object"
+ }
+ ]
+ },
+ "CollabAgentState": {
+ "properties": {
+ "message": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "status": {
+ "$ref": "#/definitions/CollabAgentStatus"
+ }
+ },
+ "required": [
+ "status"
+ ],
+ "type": "object"
+ },
+ "CollabAgentStatus": {
+ "enum": [
+ "pendingInit",
+ "running",
+ "completed",
+ "errored",
+ "shutdown",
+ "notFound"
+ ],
+ "type": "string"
+ },
+ "CollabAgentTool": {
+ "enum": [
+ "spawnAgent",
+ "sendInput",
+ "wait",
+ "closeAgent"
+ ],
+ "type": "string"
+ },
+ "CollabAgentToolCallStatus": {
+ "enum": [
+ "inProgress",
+ "completed",
+ "failed"
+ ],
+ "type": "string"
+ },
+ "CommandAction": {
+ "oneOf": [
+ {
+ "properties": {
+ "command": {
+ "type": "string"
+ },
+ "name": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "read"
+ ],
+ "title": "ReadCommandActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "command",
+ "name",
+ "path",
+ "type"
+ ],
+ "title": "ReadCommandAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "command": {
+ "type": "string"
+ },
+ "path": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "listFiles"
+ ],
+ "title": "ListFilesCommandActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "command",
+ "type"
+ ],
+ "title": "ListFilesCommandAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "command": {
+ "type": "string"
+ },
+ "path": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "query": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "search"
+ ],
+ "title": "SearchCommandActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "command",
+ "type"
+ ],
+ "title": "SearchCommandAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "command": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "unknown"
+ ],
+ "title": "UnknownCommandActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "command",
+ "type"
+ ],
+ "title": "UnknownCommandAction",
+ "type": "object"
+ }
+ ]
+ },
+ "CommandExecutionStatus": {
+ "enum": [
+ "inProgress",
+ "completed",
+ "failed",
+ "declined"
+ ],
+ "type": "string"
+ },
+ "ContentBlock": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/TextContent"
+ },
+ {
+ "$ref": "#/definitions/ImageContent"
+ },
+ {
+ "$ref": "#/definitions/AudioContent"
+ },
+ {
+ "$ref": "#/definitions/ResourceLink"
+ },
+ {
+ "$ref": "#/definitions/EmbeddedResource"
+ }
+ ]
+ },
+ "EmbeddedResource": {
+ "description": "The contents of a resource, embedded into a prompt or tool call result.\n\nIt is up to the client how best to render embedded resources for the benefit of the LLM and/or the user.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "resource": {
+ "$ref": "#/definitions/EmbeddedResourceResource"
+ },
+ "type": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "resource",
+ "type"
+ ],
+ "type": "object"
+ },
+ "EmbeddedResourceResource": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/TextResourceContents"
+ },
+ {
+ "$ref": "#/definitions/BlobResourceContents"
+ }
+ ]
+ },
+ "FileUpdateChange": {
+ "properties": {
+ "diff": {
+ "type": "string"
+ },
+ "kind": {
+ "$ref": "#/definitions/PatchChangeKind"
+ },
+ "path": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "diff",
+ "kind",
+ "path"
+ ],
+ "type": "object"
+ },
+ "GitInfo": {
+ "properties": {
+ "branch": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "originUrl": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "sha": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "ImageContent": {
+ "description": "An image provided to or from an LLM.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "data": {
+ "type": "string"
+ },
+ "mimeType": {
+ "type": "string"
+ },
+ "type": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "data",
+ "mimeType",
+ "type"
+ ],
+ "type": "object"
+ },
+ "McpToolCallError": {
+ "properties": {
+ "message": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "message"
+ ],
+ "type": "object"
+ },
+ "McpToolCallResult": {
+ "properties": {
+ "content": {
+ "items": {
+ "$ref": "#/definitions/ContentBlock"
+ },
+ "type": "array"
+ },
+ "structuredContent": true
+ },
+ "required": [
+ "content"
+ ],
+ "type": "object"
+ },
+ "McpToolCallStatus": {
+ "enum": [
+ "inProgress",
+ "completed",
+ "failed"
+ ],
+ "type": "string"
+ },
+ "PatchApplyStatus": {
+ "enum": [
+ "inProgress",
+ "completed",
+ "failed",
+ "declined"
+ ],
+ "type": "string"
+ },
+ "PatchChangeKind": {
+ "oneOf": [
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "add"
+ ],
+ "title": "AddPatchChangeKindType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "AddPatchChangeKind",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "delete"
+ ],
+ "title": "DeletePatchChangeKindType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "DeletePatchChangeKind",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "move_path": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "update"
+ ],
+ "title": "UpdatePatchChangeKindType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "UpdatePatchChangeKind",
+ "type": "object"
+ }
+ ]
+ },
+ "ResourceLink": {
+ "description": "A resource that the server is capable of reading, included in a prompt or tool call result.\n\nNote: resource links returned by tools are not guaranteed to appear in the results of `resources/list` requests.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "description": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "mimeType": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "name": {
+ "type": "string"
+ },
+ "size": {
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "title": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "type": "string"
+ },
+ "uri": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "type",
+ "uri"
+ ],
+ "type": "object"
+ },
+ "Role": {
+ "description": "The sender or recipient of messages and data in a conversation.",
+ "enum": [
+ "assistant",
+ "user"
+ ],
+ "type": "string"
+ },
+ "SessionSource": {
+ "oneOf": [
+ {
+ "enum": [
+ "cli",
+ "vscode",
+ "exec",
+ "appServer",
+ "unknown"
+ ],
+ "type": "string"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "subAgent": {
+ "$ref": "#/definitions/SubAgentSource"
+ }
+ },
+ "required": [
+ "subAgent"
+ ],
+ "title": "SubAgentSessionSource",
+ "type": "object"
+ }
+ ]
+ },
+ "SubAgentSource": {
+ "oneOf": [
+ {
+ "enum": [
+ "review",
+ "compact"
+ ],
+ "type": "string"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "thread_spawn": {
+ "properties": {
+ "depth": {
+ "format": "int32",
+ "type": "integer"
+ },
+ "parent_thread_id": {
+ "$ref": "#/definitions/ThreadId"
+ }
+ },
+ "required": [
+ "depth",
+ "parent_thread_id"
+ ],
+ "type": "object"
+ }
+ },
+ "required": [
+ "thread_spawn"
+ ],
+ "title": "ThreadSpawnSubAgentSource",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "other": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "other"
+ ],
+ "title": "OtherSubAgentSource",
+ "type": "object"
+ }
+ ]
+ },
+ "TextContent": {
+ "description": "Text provided to or from an LLM.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "type": "object"
+ },
+ "TextElement": {
+ "properties": {
+ "byteRange": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ByteRange"
+ }
+ ],
+ "description": "Byte range in the parent `text` buffer that this element occupies."
+ },
+ "placeholder": {
+ "description": "Optional human-readable placeholder for the element, displayed in the UI.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "byteRange"
+ ],
+ "type": "object"
+ },
+ "TextResourceContents": {
+ "properties": {
+ "mimeType": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "text": {
+ "type": "string"
+ },
+ "uri": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "uri"
+ ],
+ "type": "object"
+ },
+ "Thread": {
+ "properties": {
+ "cliVersion": {
+ "description": "Version of the CLI that created the thread.",
+ "type": "string"
+ },
+ "createdAt": {
+ "description": "Unix timestamp (in seconds) when the thread was created.",
+ "format": "int64",
+ "type": "integer"
+ },
+ "cwd": {
+ "description": "Working directory captured for the thread.",
+ "type": "string"
+ },
+ "gitInfo": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/GitInfo"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Optional Git metadata captured when the thread was created."
+ },
+ "id": {
+ "type": "string"
+ },
+ "modelProvider": {
+ "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"
+ },
+ "source": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/SessionSource"
+ }
+ ],
+ "description": "Origin of the thread (CLI, VSCode, codex exec, codex app-server, etc.)."
+ },
+ "turns": {
+ "description": "Only populated on `thread/resume`, `thread/rollback`, `thread/fork`, and `thread/read` (when `includeTurns` is true) responses. For all other responses and notifications returning a Thread, the turns field will be an empty list.",
+ "items": {
+ "$ref": "#/definitions/Turn"
+ },
+ "type": "array"
+ },
+ "updatedAt": {
+ "description": "Unix timestamp (in seconds) when the thread was last updated.",
+ "format": "int64",
+ "type": "integer"
+ }
+ },
+ "required": [
+ "cliVersion",
+ "createdAt",
+ "cwd",
+ "id",
+ "modelProvider",
+ "preview",
+ "source",
+ "turns",
+ "updatedAt"
+ ],
+ "type": "object"
+ },
+ "ThreadId": {
+ "type": "string"
+ },
+ "ThreadItem": {
+ "oneOf": [
+ {
+ "properties": {
+ "content": {
+ "items": {
+ "$ref": "#/definitions/UserInput"
+ },
+ "type": "array"
+ },
+ "id": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "userMessage"
+ ],
+ "title": "UserMessageThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "content",
+ "id",
+ "type"
+ ],
+ "title": "UserMessageThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "agentMessage"
+ ],
+ "title": "AgentMessageThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "text",
+ "type"
+ ],
+ "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": {
+ "default": [],
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "id": {
+ "type": "string"
+ },
+ "summary": {
+ "default": [],
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "type": {
+ "enum": [
+ "reasoning"
+ ],
+ "title": "ReasoningThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "type"
+ ],
+ "title": "ReasoningThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "aggregatedOutput": {
+ "description": "The command's output, aggregated from stdout and stderr.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "command": {
+ "description": "The command to be executed.",
+ "type": "string"
+ },
+ "commandActions": {
+ "description": "A best-effort parsing of the command to understand the action(s) it will perform. This returns a list of CommandAction objects because a single shell command may be composed of many commands piped together.",
+ "items": {
+ "$ref": "#/definitions/CommandAction"
+ },
+ "type": "array"
+ },
+ "cwd": {
+ "description": "The command's working directory.",
+ "type": "string"
+ },
+ "durationMs": {
+ "description": "The duration of the command execution in milliseconds.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "exitCode": {
+ "description": "The command's exit code.",
+ "format": "int32",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "id": {
+ "type": "string"
+ },
+ "processId": {
+ "description": "Identifier for the underlying PTY process (when available).",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "status": {
+ "$ref": "#/definitions/CommandExecutionStatus"
+ },
+ "type": {
+ "enum": [
+ "commandExecution"
+ ],
+ "title": "CommandExecutionThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "command",
+ "commandActions",
+ "cwd",
+ "id",
+ "status",
+ "type"
+ ],
+ "title": "CommandExecutionThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "changes": {
+ "items": {
+ "$ref": "#/definitions/FileUpdateChange"
+ },
+ "type": "array"
+ },
+ "id": {
+ "type": "string"
+ },
+ "status": {
+ "$ref": "#/definitions/PatchApplyStatus"
+ },
+ "type": {
+ "enum": [
+ "fileChange"
+ ],
+ "title": "FileChangeThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "changes",
+ "id",
+ "status",
+ "type"
+ ],
+ "title": "FileChangeThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "arguments": true,
+ "durationMs": {
+ "description": "The duration of the MCP tool call in milliseconds.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "error": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/McpToolCallError"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "id": {
+ "type": "string"
+ },
+ "result": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/McpToolCallResult"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "server": {
+ "type": "string"
+ },
+ "status": {
+ "$ref": "#/definitions/McpToolCallStatus"
+ },
+ "tool": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "mcpToolCall"
+ ],
+ "title": "McpToolCallThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "arguments",
+ "id",
+ "server",
+ "status",
+ "tool",
+ "type"
+ ],
+ "title": "McpToolCallThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "agentsStates": {
+ "additionalProperties": {
+ "$ref": "#/definitions/CollabAgentState"
+ },
+ "description": "Last known status of the target agents, when available.",
+ "type": "object"
+ },
+ "id": {
+ "description": "Unique identifier for this collab tool call.",
+ "type": "string"
+ },
+ "prompt": {
+ "description": "Prompt text sent as part of the collab tool call, when available.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "receiverThreadIds": {
+ "description": "Thread ID of the receiving agent, when applicable. In case of spawn operation, this corresponds to the newly spawned agent.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "senderThreadId": {
+ "description": "Thread ID of the agent issuing the collab request.",
+ "type": "string"
+ },
+ "status": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/CollabAgentToolCallStatus"
+ }
+ ],
+ "description": "Current status of the collab tool call."
+ },
+ "tool": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/CollabAgentTool"
+ }
+ ],
+ "description": "Name of the collab tool that was invoked."
+ },
+ "type": {
+ "enum": [
+ "collabAgentToolCall"
+ ],
+ "title": "CollabAgentToolCallThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "agentsStates",
+ "id",
+ "receiverThreadIds",
+ "senderThreadId",
+ "status",
+ "tool",
+ "type"
+ ],
+ "title": "CollabAgentToolCallThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "action": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/WebSearchAction"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "id": {
+ "type": "string"
+ },
+ "query": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "webSearch"
+ ],
+ "title": "WebSearchThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "query",
+ "type"
+ ],
+ "title": "WebSearchThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "imageView"
+ ],
+ "title": "ImageViewThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "path",
+ "type"
+ ],
+ "title": "ImageViewThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "review": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "enteredReviewMode"
+ ],
+ "title": "EnteredReviewModeThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "review",
+ "type"
+ ],
+ "title": "EnteredReviewModeThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "review": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "exitedReviewMode"
+ ],
+ "title": "ExitedReviewModeThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "review",
+ "type"
+ ],
+ "title": "ExitedReviewModeThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "contextCompaction"
+ ],
+ "title": "ContextCompactionThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "type"
+ ],
+ "title": "ContextCompactionThreadItem",
+ "type": "object"
+ }
+ ]
+ },
+ "Turn": {
+ "properties": {
+ "error": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/TurnError"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Only populated when the Turn's status is failed."
+ },
+ "id": {
+ "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.",
+ "items": {
+ "$ref": "#/definitions/ThreadItem"
+ },
+ "type": "array"
+ },
+ "status": {
+ "$ref": "#/definitions/TurnStatus"
+ }
+ },
+ "required": [
+ "id",
+ "items",
+ "status"
+ ],
+ "type": "object"
+ },
+ "TurnError": {
+ "properties": {
+ "additionalDetails": {
+ "default": null,
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "codexErrorInfo": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/CodexErrorInfo"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "message": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "message"
+ ],
+ "type": "object"
+ },
+ "TurnStatus": {
+ "enum": [
+ "completed",
+ "interrupted",
+ "failed",
+ "inProgress"
+ ],
+ "type": "string"
+ },
+ "UserInput": {
+ "oneOf": [
+ {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "text_elements": {
+ "default": [],
+ "description": "UI-defined spans within `text` used to render or persist special elements.",
+ "items": {
+ "$ref": "#/definitions/TextElement"
+ },
+ "type": "array"
+ },
+ "type": {
+ "enum": [
+ "text"
+ ],
+ "title": "TextUserInputType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "TextUserInput",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "image"
+ ],
+ "title": "ImageUserInputType",
+ "type": "string"
+ },
+ "url": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "url"
+ ],
+ "title": "ImageUserInput",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "localImage"
+ ],
+ "title": "LocalImageUserInputType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "path",
+ "type"
+ ],
+ "title": "LocalImageUserInput",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "name": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "skill"
+ ],
+ "title": "SkillUserInputType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "path",
+ "type"
+ ],
+ "title": "SkillUserInput",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "name": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "mention"
+ ],
+ "title": "MentionUserInputType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "path",
+ "type"
+ ],
+ "title": "MentionUserInput",
+ "type": "object"
+ }
+ ]
+ },
+ "WebSearchAction": {
+ "oneOf": [
+ {
+ "properties": {
+ "queries": {
+ "items": {
+ "type": "string"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "query": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "search"
+ ],
+ "title": "SearchWebSearchActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "SearchWebSearchAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "openPage"
+ ],
+ "title": "OpenPageWebSearchActionType",
+ "type": "string"
+ },
+ "url": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "OpenPageWebSearchAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "pattern": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "findInPage"
+ ],
+ "title": "FindInPageWebSearchActionType",
+ "type": "string"
+ },
+ "url": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "FindInPageWebSearchAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "other"
+ ],
+ "title": "OtherWebSearchActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "OtherWebSearchAction",
+ "type": "object"
+ }
+ ]
+ }
+ },
+ "properties": {
+ "thread": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/Thread"
+ }
+ ],
+ "description": "The updated thread after applying the rollback, with `turns` populated.\n\nThe ThreadItems stored in each Turn are lossy since we explicitly do not persist all agent interactions, such as command executions. This is the same behavior as `thread/resume`."
+ }
+ },
+ "required": [
+ "thread"
+ ],
+ "title": "ThreadRollbackResponse",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v2/ThreadSetNameParams.json b/codex-rs/app-server-protocol/schema/json/v2/ThreadSetNameParams.json
new file mode 100644
index 0000000000..9381c7cb12
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v2/ThreadSetNameParams.json
@@ -0,0 +1,17 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "name": {
+ "type": "string"
+ },
+ "threadId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "threadId"
+ ],
+ "title": "ThreadSetNameParams",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v2/ThreadSetNameResponse.json b/codex-rs/app-server-protocol/schema/json/v2/ThreadSetNameResponse.json
new file mode 100644
index 0000000000..3d25712ff0
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v2/ThreadSetNameResponse.json
@@ -0,0 +1,5 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "title": "ThreadSetNameResponse",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v2/ThreadStartParams.json b/codex-rs/app-server-protocol/schema/json/v2/ThreadStartParams.json
new file mode 100644
index 0000000000..03bed7f93c
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v2/ThreadStartParams.json
@@ -0,0 +1,128 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "definitions": {
+ "AskForApproval": {
+ "enum": [
+ "untrusted",
+ "on-failure",
+ "on-request",
+ "never"
+ ],
+ "type": "string"
+ },
+ "DynamicToolSpec": {
+ "properties": {
+ "description": {
+ "type": "string"
+ },
+ "inputSchema": true,
+ "name": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "description",
+ "inputSchema",
+ "name"
+ ],
+ "type": "object"
+ },
+ "Personality": {
+ "enum": [
+ "friendly",
+ "pragmatic"
+ ],
+ "type": "string"
+ },
+ "SandboxMode": {
+ "enum": [
+ "read-only",
+ "workspace-write",
+ "danger-full-access"
+ ],
+ "type": "string"
+ }
+ },
+ "properties": {
+ "approvalPolicy": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/AskForApproval"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "baseInstructions": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "config": {
+ "additionalProperties": true,
+ "type": [
+ "object",
+ "null"
+ ]
+ },
+ "cwd": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "developerInstructions": {
+ "type": [
+ "string",
+ "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",
+ "null"
+ ]
+ },
+ "modelProvider": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "personality": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Personality"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "sandbox": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/SandboxMode"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ }
+ },
+ "title": "ThreadStartParams",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v2/ThreadStartResponse.json b/codex-rs/app-server-protocol/schema/json/v2/ThreadStartResponse.json
new file mode 100644
index 0000000000..d88d3694de
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v2/ThreadStartResponse.json
@@ -0,0 +1,1859 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "definitions": {
+ "AbsolutePathBuf": {
+ "description": "A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem).\n\nIMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set, the deserialization will fail unless the path being deserialized is already absolute.",
+ "type": "string"
+ },
+ "Annotations": {
+ "description": "Optional annotations for the client. The client can use annotations to inform how objects are used or displayed",
+ "properties": {
+ "audience": {
+ "items": {
+ "$ref": "#/definitions/Role"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "lastModified": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "priority": {
+ "format": "double",
+ "type": [
+ "number",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "AskForApproval": {
+ "enum": [
+ "untrusted",
+ "on-failure",
+ "on-request",
+ "never"
+ ],
+ "type": "string"
+ },
+ "AudioContent": {
+ "description": "Audio provided to or from an LLM.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "data": {
+ "type": "string"
+ },
+ "mimeType": {
+ "type": "string"
+ },
+ "type": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "data",
+ "mimeType",
+ "type"
+ ],
+ "type": "object"
+ },
+ "BlobResourceContents": {
+ "properties": {
+ "blob": {
+ "type": "string"
+ },
+ "mimeType": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "uri": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "blob",
+ "uri"
+ ],
+ "type": "object"
+ },
+ "ByteRange": {
+ "properties": {
+ "end": {
+ "format": "uint",
+ "minimum": 0.0,
+ "type": "integer"
+ },
+ "start": {
+ "format": "uint",
+ "minimum": 0.0,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "end",
+ "start"
+ ],
+ "type": "object"
+ },
+ "CodexErrorInfo": {
+ "description": "This translation layer make sure that we expose codex error code in camel case.\n\nWhen an upstream HTTP status is available (for example, from the Responses API or a provider), it is forwarded in `httpStatusCode` on the relevant `codexErrorInfo` variant.",
+ "oneOf": [
+ {
+ "enum": [
+ "contextWindowExceeded",
+ "usageLimitExceeded",
+ "internalServerError",
+ "unauthorized",
+ "badRequest",
+ "threadRollbackFailed",
+ "sandboxError",
+ "other"
+ ],
+ "type": "string"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "modelCap": {
+ "properties": {
+ "model": {
+ "type": "string"
+ },
+ "reset_after_seconds": {
+ "format": "uint64",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "model"
+ ],
+ "type": "object"
+ }
+ },
+ "required": [
+ "modelCap"
+ ],
+ "title": "ModelCapCodexErrorInfo",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "httpConnectionFailed": {
+ "properties": {
+ "httpStatusCode": {
+ "format": "uint16",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "httpConnectionFailed"
+ ],
+ "title": "HttpConnectionFailedCodexErrorInfo",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "Failed to connect to the response SSE stream.",
+ "properties": {
+ "responseStreamConnectionFailed": {
+ "properties": {
+ "httpStatusCode": {
+ "format": "uint16",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "responseStreamConnectionFailed"
+ ],
+ "title": "ResponseStreamConnectionFailedCodexErrorInfo",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "The response SSE stream disconnected in the middle of a turn before completion.",
+ "properties": {
+ "responseStreamDisconnected": {
+ "properties": {
+ "httpStatusCode": {
+ "format": "uint16",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "responseStreamDisconnected"
+ ],
+ "title": "ResponseStreamDisconnectedCodexErrorInfo",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "Reached the retry limit for responses.",
+ "properties": {
+ "responseTooManyFailedAttempts": {
+ "properties": {
+ "httpStatusCode": {
+ "format": "uint16",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "responseTooManyFailedAttempts"
+ ],
+ "title": "ResponseTooManyFailedAttemptsCodexErrorInfo",
+ "type": "object"
+ }
+ ]
+ },
+ "CollabAgentState": {
+ "properties": {
+ "message": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "status": {
+ "$ref": "#/definitions/CollabAgentStatus"
+ }
+ },
+ "required": [
+ "status"
+ ],
+ "type": "object"
+ },
+ "CollabAgentStatus": {
+ "enum": [
+ "pendingInit",
+ "running",
+ "completed",
+ "errored",
+ "shutdown",
+ "notFound"
+ ],
+ "type": "string"
+ },
+ "CollabAgentTool": {
+ "enum": [
+ "spawnAgent",
+ "sendInput",
+ "wait",
+ "closeAgent"
+ ],
+ "type": "string"
+ },
+ "CollabAgentToolCallStatus": {
+ "enum": [
+ "inProgress",
+ "completed",
+ "failed"
+ ],
+ "type": "string"
+ },
+ "CommandAction": {
+ "oneOf": [
+ {
+ "properties": {
+ "command": {
+ "type": "string"
+ },
+ "name": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "read"
+ ],
+ "title": "ReadCommandActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "command",
+ "name",
+ "path",
+ "type"
+ ],
+ "title": "ReadCommandAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "command": {
+ "type": "string"
+ },
+ "path": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "listFiles"
+ ],
+ "title": "ListFilesCommandActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "command",
+ "type"
+ ],
+ "title": "ListFilesCommandAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "command": {
+ "type": "string"
+ },
+ "path": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "query": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "search"
+ ],
+ "title": "SearchCommandActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "command",
+ "type"
+ ],
+ "title": "SearchCommandAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "command": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "unknown"
+ ],
+ "title": "UnknownCommandActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "command",
+ "type"
+ ],
+ "title": "UnknownCommandAction",
+ "type": "object"
+ }
+ ]
+ },
+ "CommandExecutionStatus": {
+ "enum": [
+ "inProgress",
+ "completed",
+ "failed",
+ "declined"
+ ],
+ "type": "string"
+ },
+ "ContentBlock": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/TextContent"
+ },
+ {
+ "$ref": "#/definitions/ImageContent"
+ },
+ {
+ "$ref": "#/definitions/AudioContent"
+ },
+ {
+ "$ref": "#/definitions/ResourceLink"
+ },
+ {
+ "$ref": "#/definitions/EmbeddedResource"
+ }
+ ]
+ },
+ "EmbeddedResource": {
+ "description": "The contents of a resource, embedded into a prompt or tool call result.\n\nIt is up to the client how best to render embedded resources for the benefit of the LLM and/or the user.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "resource": {
+ "$ref": "#/definitions/EmbeddedResourceResource"
+ },
+ "type": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "resource",
+ "type"
+ ],
+ "type": "object"
+ },
+ "EmbeddedResourceResource": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/TextResourceContents"
+ },
+ {
+ "$ref": "#/definitions/BlobResourceContents"
+ }
+ ]
+ },
+ "FileUpdateChange": {
+ "properties": {
+ "diff": {
+ "type": "string"
+ },
+ "kind": {
+ "$ref": "#/definitions/PatchChangeKind"
+ },
+ "path": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "diff",
+ "kind",
+ "path"
+ ],
+ "type": "object"
+ },
+ "GitInfo": {
+ "properties": {
+ "branch": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "originUrl": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "sha": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "ImageContent": {
+ "description": "An image provided to or from an LLM.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "data": {
+ "type": "string"
+ },
+ "mimeType": {
+ "type": "string"
+ },
+ "type": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "data",
+ "mimeType",
+ "type"
+ ],
+ "type": "object"
+ },
+ "McpToolCallError": {
+ "properties": {
+ "message": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "message"
+ ],
+ "type": "object"
+ },
+ "McpToolCallResult": {
+ "properties": {
+ "content": {
+ "items": {
+ "$ref": "#/definitions/ContentBlock"
+ },
+ "type": "array"
+ },
+ "structuredContent": true
+ },
+ "required": [
+ "content"
+ ],
+ "type": "object"
+ },
+ "McpToolCallStatus": {
+ "enum": [
+ "inProgress",
+ "completed",
+ "failed"
+ ],
+ "type": "string"
+ },
+ "NetworkAccess": {
+ "enum": [
+ "restricted",
+ "enabled"
+ ],
+ "type": "string"
+ },
+ "PatchApplyStatus": {
+ "enum": [
+ "inProgress",
+ "completed",
+ "failed",
+ "declined"
+ ],
+ "type": "string"
+ },
+ "PatchChangeKind": {
+ "oneOf": [
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "add"
+ ],
+ "title": "AddPatchChangeKindType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "AddPatchChangeKind",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "delete"
+ ],
+ "title": "DeletePatchChangeKindType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "DeletePatchChangeKind",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "move_path": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "update"
+ ],
+ "title": "UpdatePatchChangeKindType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "UpdatePatchChangeKind",
+ "type": "object"
+ }
+ ]
+ },
+ "ReasoningEffort": {
+ "description": "See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#get-started-with-reasoning",
+ "enum": [
+ "none",
+ "minimal",
+ "low",
+ "medium",
+ "high",
+ "xhigh"
+ ],
+ "type": "string"
+ },
+ "ResourceLink": {
+ "description": "A resource that the server is capable of reading, included in a prompt or tool call result.\n\nNote: resource links returned by tools are not guaranteed to appear in the results of `resources/list` requests.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "description": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "mimeType": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "name": {
+ "type": "string"
+ },
+ "size": {
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "title": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "type": "string"
+ },
+ "uri": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "type",
+ "uri"
+ ],
+ "type": "object"
+ },
+ "Role": {
+ "description": "The sender or recipient of messages and data in a conversation.",
+ "enum": [
+ "assistant",
+ "user"
+ ],
+ "type": "string"
+ },
+ "SandboxPolicy": {
+ "oneOf": [
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "dangerFullAccess"
+ ],
+ "title": "DangerFullAccessSandboxPolicyType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "DangerFullAccessSandboxPolicy",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "readOnly"
+ ],
+ "title": "ReadOnlySandboxPolicyType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "ReadOnlySandboxPolicy",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "networkAccess": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/NetworkAccess"
+ }
+ ],
+ "default": "restricted"
+ },
+ "type": {
+ "enum": [
+ "externalSandbox"
+ ],
+ "title": "ExternalSandboxSandboxPolicyType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "ExternalSandboxSandboxPolicy",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "excludeSlashTmp": {
+ "default": false,
+ "type": "boolean"
+ },
+ "excludeTmpdirEnvVar": {
+ "default": false,
+ "type": "boolean"
+ },
+ "networkAccess": {
+ "default": false,
+ "type": "boolean"
+ },
+ "type": {
+ "enum": [
+ "workspaceWrite"
+ ],
+ "title": "WorkspaceWriteSandboxPolicyType",
+ "type": "string"
+ },
+ "writableRoots": {
+ "default": [],
+ "items": {
+ "$ref": "#/definitions/AbsolutePathBuf"
+ },
+ "type": "array"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "WorkspaceWriteSandboxPolicy",
+ "type": "object"
+ }
+ ]
+ },
+ "SessionSource": {
+ "oneOf": [
+ {
+ "enum": [
+ "cli",
+ "vscode",
+ "exec",
+ "appServer",
+ "unknown"
+ ],
+ "type": "string"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "subAgent": {
+ "$ref": "#/definitions/SubAgentSource"
+ }
+ },
+ "required": [
+ "subAgent"
+ ],
+ "title": "SubAgentSessionSource",
+ "type": "object"
+ }
+ ]
+ },
+ "SubAgentSource": {
+ "oneOf": [
+ {
+ "enum": [
+ "review",
+ "compact"
+ ],
+ "type": "string"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "thread_spawn": {
+ "properties": {
+ "depth": {
+ "format": "int32",
+ "type": "integer"
+ },
+ "parent_thread_id": {
+ "$ref": "#/definitions/ThreadId"
+ }
+ },
+ "required": [
+ "depth",
+ "parent_thread_id"
+ ],
+ "type": "object"
+ }
+ },
+ "required": [
+ "thread_spawn"
+ ],
+ "title": "ThreadSpawnSubAgentSource",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "other": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "other"
+ ],
+ "title": "OtherSubAgentSource",
+ "type": "object"
+ }
+ ]
+ },
+ "TextContent": {
+ "description": "Text provided to or from an LLM.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "type": "object"
+ },
+ "TextElement": {
+ "properties": {
+ "byteRange": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ByteRange"
+ }
+ ],
+ "description": "Byte range in the parent `text` buffer that this element occupies."
+ },
+ "placeholder": {
+ "description": "Optional human-readable placeholder for the element, displayed in the UI.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "byteRange"
+ ],
+ "type": "object"
+ },
+ "TextResourceContents": {
+ "properties": {
+ "mimeType": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "text": {
+ "type": "string"
+ },
+ "uri": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "uri"
+ ],
+ "type": "object"
+ },
+ "Thread": {
+ "properties": {
+ "cliVersion": {
+ "description": "Version of the CLI that created the thread.",
+ "type": "string"
+ },
+ "createdAt": {
+ "description": "Unix timestamp (in seconds) when the thread was created.",
+ "format": "int64",
+ "type": "integer"
+ },
+ "cwd": {
+ "description": "Working directory captured for the thread.",
+ "type": "string"
+ },
+ "gitInfo": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/GitInfo"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Optional Git metadata captured when the thread was created."
+ },
+ "id": {
+ "type": "string"
+ },
+ "modelProvider": {
+ "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"
+ },
+ "source": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/SessionSource"
+ }
+ ],
+ "description": "Origin of the thread (CLI, VSCode, codex exec, codex app-server, etc.)."
+ },
+ "turns": {
+ "description": "Only populated on `thread/resume`, `thread/rollback`, `thread/fork`, and `thread/read` (when `includeTurns` is true) responses. For all other responses and notifications returning a Thread, the turns field will be an empty list.",
+ "items": {
+ "$ref": "#/definitions/Turn"
+ },
+ "type": "array"
+ },
+ "updatedAt": {
+ "description": "Unix timestamp (in seconds) when the thread was last updated.",
+ "format": "int64",
+ "type": "integer"
+ }
+ },
+ "required": [
+ "cliVersion",
+ "createdAt",
+ "cwd",
+ "id",
+ "modelProvider",
+ "preview",
+ "source",
+ "turns",
+ "updatedAt"
+ ],
+ "type": "object"
+ },
+ "ThreadId": {
+ "type": "string"
+ },
+ "ThreadItem": {
+ "oneOf": [
+ {
+ "properties": {
+ "content": {
+ "items": {
+ "$ref": "#/definitions/UserInput"
+ },
+ "type": "array"
+ },
+ "id": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "userMessage"
+ ],
+ "title": "UserMessageThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "content",
+ "id",
+ "type"
+ ],
+ "title": "UserMessageThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "agentMessage"
+ ],
+ "title": "AgentMessageThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "text",
+ "type"
+ ],
+ "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": {
+ "default": [],
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "id": {
+ "type": "string"
+ },
+ "summary": {
+ "default": [],
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "type": {
+ "enum": [
+ "reasoning"
+ ],
+ "title": "ReasoningThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "type"
+ ],
+ "title": "ReasoningThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "aggregatedOutput": {
+ "description": "The command's output, aggregated from stdout and stderr.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "command": {
+ "description": "The command to be executed.",
+ "type": "string"
+ },
+ "commandActions": {
+ "description": "A best-effort parsing of the command to understand the action(s) it will perform. This returns a list of CommandAction objects because a single shell command may be composed of many commands piped together.",
+ "items": {
+ "$ref": "#/definitions/CommandAction"
+ },
+ "type": "array"
+ },
+ "cwd": {
+ "description": "The command's working directory.",
+ "type": "string"
+ },
+ "durationMs": {
+ "description": "The duration of the command execution in milliseconds.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "exitCode": {
+ "description": "The command's exit code.",
+ "format": "int32",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "id": {
+ "type": "string"
+ },
+ "processId": {
+ "description": "Identifier for the underlying PTY process (when available).",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "status": {
+ "$ref": "#/definitions/CommandExecutionStatus"
+ },
+ "type": {
+ "enum": [
+ "commandExecution"
+ ],
+ "title": "CommandExecutionThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "command",
+ "commandActions",
+ "cwd",
+ "id",
+ "status",
+ "type"
+ ],
+ "title": "CommandExecutionThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "changes": {
+ "items": {
+ "$ref": "#/definitions/FileUpdateChange"
+ },
+ "type": "array"
+ },
+ "id": {
+ "type": "string"
+ },
+ "status": {
+ "$ref": "#/definitions/PatchApplyStatus"
+ },
+ "type": {
+ "enum": [
+ "fileChange"
+ ],
+ "title": "FileChangeThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "changes",
+ "id",
+ "status",
+ "type"
+ ],
+ "title": "FileChangeThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "arguments": true,
+ "durationMs": {
+ "description": "The duration of the MCP tool call in milliseconds.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "error": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/McpToolCallError"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "id": {
+ "type": "string"
+ },
+ "result": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/McpToolCallResult"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "server": {
+ "type": "string"
+ },
+ "status": {
+ "$ref": "#/definitions/McpToolCallStatus"
+ },
+ "tool": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "mcpToolCall"
+ ],
+ "title": "McpToolCallThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "arguments",
+ "id",
+ "server",
+ "status",
+ "tool",
+ "type"
+ ],
+ "title": "McpToolCallThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "agentsStates": {
+ "additionalProperties": {
+ "$ref": "#/definitions/CollabAgentState"
+ },
+ "description": "Last known status of the target agents, when available.",
+ "type": "object"
+ },
+ "id": {
+ "description": "Unique identifier for this collab tool call.",
+ "type": "string"
+ },
+ "prompt": {
+ "description": "Prompt text sent as part of the collab tool call, when available.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "receiverThreadIds": {
+ "description": "Thread ID of the receiving agent, when applicable. In case of spawn operation, this corresponds to the newly spawned agent.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "senderThreadId": {
+ "description": "Thread ID of the agent issuing the collab request.",
+ "type": "string"
+ },
+ "status": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/CollabAgentToolCallStatus"
+ }
+ ],
+ "description": "Current status of the collab tool call."
+ },
+ "tool": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/CollabAgentTool"
+ }
+ ],
+ "description": "Name of the collab tool that was invoked."
+ },
+ "type": {
+ "enum": [
+ "collabAgentToolCall"
+ ],
+ "title": "CollabAgentToolCallThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "agentsStates",
+ "id",
+ "receiverThreadIds",
+ "senderThreadId",
+ "status",
+ "tool",
+ "type"
+ ],
+ "title": "CollabAgentToolCallThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "action": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/WebSearchAction"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "id": {
+ "type": "string"
+ },
+ "query": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "webSearch"
+ ],
+ "title": "WebSearchThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "query",
+ "type"
+ ],
+ "title": "WebSearchThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "imageView"
+ ],
+ "title": "ImageViewThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "path",
+ "type"
+ ],
+ "title": "ImageViewThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "review": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "enteredReviewMode"
+ ],
+ "title": "EnteredReviewModeThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "review",
+ "type"
+ ],
+ "title": "EnteredReviewModeThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "review": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "exitedReviewMode"
+ ],
+ "title": "ExitedReviewModeThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "review",
+ "type"
+ ],
+ "title": "ExitedReviewModeThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "contextCompaction"
+ ],
+ "title": "ContextCompactionThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "type"
+ ],
+ "title": "ContextCompactionThreadItem",
+ "type": "object"
+ }
+ ]
+ },
+ "Turn": {
+ "properties": {
+ "error": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/TurnError"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Only populated when the Turn's status is failed."
+ },
+ "id": {
+ "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.",
+ "items": {
+ "$ref": "#/definitions/ThreadItem"
+ },
+ "type": "array"
+ },
+ "status": {
+ "$ref": "#/definitions/TurnStatus"
+ }
+ },
+ "required": [
+ "id",
+ "items",
+ "status"
+ ],
+ "type": "object"
+ },
+ "TurnError": {
+ "properties": {
+ "additionalDetails": {
+ "default": null,
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "codexErrorInfo": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/CodexErrorInfo"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "message": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "message"
+ ],
+ "type": "object"
+ },
+ "TurnStatus": {
+ "enum": [
+ "completed",
+ "interrupted",
+ "failed",
+ "inProgress"
+ ],
+ "type": "string"
+ },
+ "UserInput": {
+ "oneOf": [
+ {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "text_elements": {
+ "default": [],
+ "description": "UI-defined spans within `text` used to render or persist special elements.",
+ "items": {
+ "$ref": "#/definitions/TextElement"
+ },
+ "type": "array"
+ },
+ "type": {
+ "enum": [
+ "text"
+ ],
+ "title": "TextUserInputType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "TextUserInput",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "image"
+ ],
+ "title": "ImageUserInputType",
+ "type": "string"
+ },
+ "url": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "url"
+ ],
+ "title": "ImageUserInput",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "localImage"
+ ],
+ "title": "LocalImageUserInputType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "path",
+ "type"
+ ],
+ "title": "LocalImageUserInput",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "name": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "skill"
+ ],
+ "title": "SkillUserInputType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "path",
+ "type"
+ ],
+ "title": "SkillUserInput",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "name": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "mention"
+ ],
+ "title": "MentionUserInputType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "path",
+ "type"
+ ],
+ "title": "MentionUserInput",
+ "type": "object"
+ }
+ ]
+ },
+ "WebSearchAction": {
+ "oneOf": [
+ {
+ "properties": {
+ "queries": {
+ "items": {
+ "type": "string"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "query": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "search"
+ ],
+ "title": "SearchWebSearchActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "SearchWebSearchAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "openPage"
+ ],
+ "title": "OpenPageWebSearchActionType",
+ "type": "string"
+ },
+ "url": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "OpenPageWebSearchAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "pattern": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "findInPage"
+ ],
+ "title": "FindInPageWebSearchActionType",
+ "type": "string"
+ },
+ "url": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "FindInPageWebSearchAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "other"
+ ],
+ "title": "OtherWebSearchActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "OtherWebSearchAction",
+ "type": "object"
+ }
+ ]
+ }
+ },
+ "properties": {
+ "approvalPolicy": {
+ "$ref": "#/definitions/AskForApproval"
+ },
+ "cwd": {
+ "type": "string"
+ },
+ "model": {
+ "type": "string"
+ },
+ "modelProvider": {
+ "type": "string"
+ },
+ "reasoningEffort": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ReasoningEffort"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "sandbox": {
+ "$ref": "#/definitions/SandboxPolicy"
+ },
+ "thread": {
+ "$ref": "#/definitions/Thread"
+ }
+ },
+ "required": [
+ "approvalPolicy",
+ "cwd",
+ "model",
+ "modelProvider",
+ "sandbox",
+ "thread"
+ ],
+ "title": "ThreadStartResponse",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v2/ThreadStartedNotification.json b/codex-rs/app-server-protocol/schema/json/v2/ThreadStartedNotification.json
new file mode 100644
index 0000000000..0c8d47136e
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v2/ThreadStartedNotification.json
@@ -0,0 +1,1702 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "definitions": {
+ "Annotations": {
+ "description": "Optional annotations for the client. The client can use annotations to inform how objects are used or displayed",
+ "properties": {
+ "audience": {
+ "items": {
+ "$ref": "#/definitions/Role"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "lastModified": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "priority": {
+ "format": "double",
+ "type": [
+ "number",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "AudioContent": {
+ "description": "Audio provided to or from an LLM.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "data": {
+ "type": "string"
+ },
+ "mimeType": {
+ "type": "string"
+ },
+ "type": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "data",
+ "mimeType",
+ "type"
+ ],
+ "type": "object"
+ },
+ "BlobResourceContents": {
+ "properties": {
+ "blob": {
+ "type": "string"
+ },
+ "mimeType": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "uri": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "blob",
+ "uri"
+ ],
+ "type": "object"
+ },
+ "ByteRange": {
+ "properties": {
+ "end": {
+ "format": "uint",
+ "minimum": 0.0,
+ "type": "integer"
+ },
+ "start": {
+ "format": "uint",
+ "minimum": 0.0,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "end",
+ "start"
+ ],
+ "type": "object"
+ },
+ "CodexErrorInfo": {
+ "description": "This translation layer make sure that we expose codex error code in camel case.\n\nWhen an upstream HTTP status is available (for example, from the Responses API or a provider), it is forwarded in `httpStatusCode` on the relevant `codexErrorInfo` variant.",
+ "oneOf": [
+ {
+ "enum": [
+ "contextWindowExceeded",
+ "usageLimitExceeded",
+ "internalServerError",
+ "unauthorized",
+ "badRequest",
+ "threadRollbackFailed",
+ "sandboxError",
+ "other"
+ ],
+ "type": "string"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "modelCap": {
+ "properties": {
+ "model": {
+ "type": "string"
+ },
+ "reset_after_seconds": {
+ "format": "uint64",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "model"
+ ],
+ "type": "object"
+ }
+ },
+ "required": [
+ "modelCap"
+ ],
+ "title": "ModelCapCodexErrorInfo",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "httpConnectionFailed": {
+ "properties": {
+ "httpStatusCode": {
+ "format": "uint16",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "httpConnectionFailed"
+ ],
+ "title": "HttpConnectionFailedCodexErrorInfo",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "Failed to connect to the response SSE stream.",
+ "properties": {
+ "responseStreamConnectionFailed": {
+ "properties": {
+ "httpStatusCode": {
+ "format": "uint16",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "responseStreamConnectionFailed"
+ ],
+ "title": "ResponseStreamConnectionFailedCodexErrorInfo",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "The response SSE stream disconnected in the middle of a turn before completion.",
+ "properties": {
+ "responseStreamDisconnected": {
+ "properties": {
+ "httpStatusCode": {
+ "format": "uint16",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "responseStreamDisconnected"
+ ],
+ "title": "ResponseStreamDisconnectedCodexErrorInfo",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "Reached the retry limit for responses.",
+ "properties": {
+ "responseTooManyFailedAttempts": {
+ "properties": {
+ "httpStatusCode": {
+ "format": "uint16",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "responseTooManyFailedAttempts"
+ ],
+ "title": "ResponseTooManyFailedAttemptsCodexErrorInfo",
+ "type": "object"
+ }
+ ]
+ },
+ "CollabAgentState": {
+ "properties": {
+ "message": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "status": {
+ "$ref": "#/definitions/CollabAgentStatus"
+ }
+ },
+ "required": [
+ "status"
+ ],
+ "type": "object"
+ },
+ "CollabAgentStatus": {
+ "enum": [
+ "pendingInit",
+ "running",
+ "completed",
+ "errored",
+ "shutdown",
+ "notFound"
+ ],
+ "type": "string"
+ },
+ "CollabAgentTool": {
+ "enum": [
+ "spawnAgent",
+ "sendInput",
+ "wait",
+ "closeAgent"
+ ],
+ "type": "string"
+ },
+ "CollabAgentToolCallStatus": {
+ "enum": [
+ "inProgress",
+ "completed",
+ "failed"
+ ],
+ "type": "string"
+ },
+ "CommandAction": {
+ "oneOf": [
+ {
+ "properties": {
+ "command": {
+ "type": "string"
+ },
+ "name": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "read"
+ ],
+ "title": "ReadCommandActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "command",
+ "name",
+ "path",
+ "type"
+ ],
+ "title": "ReadCommandAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "command": {
+ "type": "string"
+ },
+ "path": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "listFiles"
+ ],
+ "title": "ListFilesCommandActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "command",
+ "type"
+ ],
+ "title": "ListFilesCommandAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "command": {
+ "type": "string"
+ },
+ "path": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "query": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "search"
+ ],
+ "title": "SearchCommandActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "command",
+ "type"
+ ],
+ "title": "SearchCommandAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "command": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "unknown"
+ ],
+ "title": "UnknownCommandActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "command",
+ "type"
+ ],
+ "title": "UnknownCommandAction",
+ "type": "object"
+ }
+ ]
+ },
+ "CommandExecutionStatus": {
+ "enum": [
+ "inProgress",
+ "completed",
+ "failed",
+ "declined"
+ ],
+ "type": "string"
+ },
+ "ContentBlock": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/TextContent"
+ },
+ {
+ "$ref": "#/definitions/ImageContent"
+ },
+ {
+ "$ref": "#/definitions/AudioContent"
+ },
+ {
+ "$ref": "#/definitions/ResourceLink"
+ },
+ {
+ "$ref": "#/definitions/EmbeddedResource"
+ }
+ ]
+ },
+ "EmbeddedResource": {
+ "description": "The contents of a resource, embedded into a prompt or tool call result.\n\nIt is up to the client how best to render embedded resources for the benefit of the LLM and/or the user.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "resource": {
+ "$ref": "#/definitions/EmbeddedResourceResource"
+ },
+ "type": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "resource",
+ "type"
+ ],
+ "type": "object"
+ },
+ "EmbeddedResourceResource": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/TextResourceContents"
+ },
+ {
+ "$ref": "#/definitions/BlobResourceContents"
+ }
+ ]
+ },
+ "FileUpdateChange": {
+ "properties": {
+ "diff": {
+ "type": "string"
+ },
+ "kind": {
+ "$ref": "#/definitions/PatchChangeKind"
+ },
+ "path": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "diff",
+ "kind",
+ "path"
+ ],
+ "type": "object"
+ },
+ "GitInfo": {
+ "properties": {
+ "branch": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "originUrl": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "sha": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "ImageContent": {
+ "description": "An image provided to or from an LLM.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "data": {
+ "type": "string"
+ },
+ "mimeType": {
+ "type": "string"
+ },
+ "type": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "data",
+ "mimeType",
+ "type"
+ ],
+ "type": "object"
+ },
+ "McpToolCallError": {
+ "properties": {
+ "message": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "message"
+ ],
+ "type": "object"
+ },
+ "McpToolCallResult": {
+ "properties": {
+ "content": {
+ "items": {
+ "$ref": "#/definitions/ContentBlock"
+ },
+ "type": "array"
+ },
+ "structuredContent": true
+ },
+ "required": [
+ "content"
+ ],
+ "type": "object"
+ },
+ "McpToolCallStatus": {
+ "enum": [
+ "inProgress",
+ "completed",
+ "failed"
+ ],
+ "type": "string"
+ },
+ "PatchApplyStatus": {
+ "enum": [
+ "inProgress",
+ "completed",
+ "failed",
+ "declined"
+ ],
+ "type": "string"
+ },
+ "PatchChangeKind": {
+ "oneOf": [
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "add"
+ ],
+ "title": "AddPatchChangeKindType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "AddPatchChangeKind",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "delete"
+ ],
+ "title": "DeletePatchChangeKindType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "DeletePatchChangeKind",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "move_path": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "update"
+ ],
+ "title": "UpdatePatchChangeKindType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "UpdatePatchChangeKind",
+ "type": "object"
+ }
+ ]
+ },
+ "ResourceLink": {
+ "description": "A resource that the server is capable of reading, included in a prompt or tool call result.\n\nNote: resource links returned by tools are not guaranteed to appear in the results of `resources/list` requests.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "description": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "mimeType": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "name": {
+ "type": "string"
+ },
+ "size": {
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "title": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "type": "string"
+ },
+ "uri": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "type",
+ "uri"
+ ],
+ "type": "object"
+ },
+ "Role": {
+ "description": "The sender or recipient of messages and data in a conversation.",
+ "enum": [
+ "assistant",
+ "user"
+ ],
+ "type": "string"
+ },
+ "SessionSource": {
+ "oneOf": [
+ {
+ "enum": [
+ "cli",
+ "vscode",
+ "exec",
+ "appServer",
+ "unknown"
+ ],
+ "type": "string"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "subAgent": {
+ "$ref": "#/definitions/SubAgentSource"
+ }
+ },
+ "required": [
+ "subAgent"
+ ],
+ "title": "SubAgentSessionSource",
+ "type": "object"
+ }
+ ]
+ },
+ "SubAgentSource": {
+ "oneOf": [
+ {
+ "enum": [
+ "review",
+ "compact"
+ ],
+ "type": "string"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "thread_spawn": {
+ "properties": {
+ "depth": {
+ "format": "int32",
+ "type": "integer"
+ },
+ "parent_thread_id": {
+ "$ref": "#/definitions/ThreadId"
+ }
+ },
+ "required": [
+ "depth",
+ "parent_thread_id"
+ ],
+ "type": "object"
+ }
+ },
+ "required": [
+ "thread_spawn"
+ ],
+ "title": "ThreadSpawnSubAgentSource",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "other": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "other"
+ ],
+ "title": "OtherSubAgentSource",
+ "type": "object"
+ }
+ ]
+ },
+ "TextContent": {
+ "description": "Text provided to or from an LLM.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "type": "object"
+ },
+ "TextElement": {
+ "properties": {
+ "byteRange": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ByteRange"
+ }
+ ],
+ "description": "Byte range in the parent `text` buffer that this element occupies."
+ },
+ "placeholder": {
+ "description": "Optional human-readable placeholder for the element, displayed in the UI.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "byteRange"
+ ],
+ "type": "object"
+ },
+ "TextResourceContents": {
+ "properties": {
+ "mimeType": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "text": {
+ "type": "string"
+ },
+ "uri": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "uri"
+ ],
+ "type": "object"
+ },
+ "Thread": {
+ "properties": {
+ "cliVersion": {
+ "description": "Version of the CLI that created the thread.",
+ "type": "string"
+ },
+ "createdAt": {
+ "description": "Unix timestamp (in seconds) when the thread was created.",
+ "format": "int64",
+ "type": "integer"
+ },
+ "cwd": {
+ "description": "Working directory captured for the thread.",
+ "type": "string"
+ },
+ "gitInfo": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/GitInfo"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Optional Git metadata captured when the thread was created."
+ },
+ "id": {
+ "type": "string"
+ },
+ "modelProvider": {
+ "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"
+ },
+ "source": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/SessionSource"
+ }
+ ],
+ "description": "Origin of the thread (CLI, VSCode, codex exec, codex app-server, etc.)."
+ },
+ "turns": {
+ "description": "Only populated on `thread/resume`, `thread/rollback`, `thread/fork`, and `thread/read` (when `includeTurns` is true) responses. For all other responses and notifications returning a Thread, the turns field will be an empty list.",
+ "items": {
+ "$ref": "#/definitions/Turn"
+ },
+ "type": "array"
+ },
+ "updatedAt": {
+ "description": "Unix timestamp (in seconds) when the thread was last updated.",
+ "format": "int64",
+ "type": "integer"
+ }
+ },
+ "required": [
+ "cliVersion",
+ "createdAt",
+ "cwd",
+ "id",
+ "modelProvider",
+ "preview",
+ "source",
+ "turns",
+ "updatedAt"
+ ],
+ "type": "object"
+ },
+ "ThreadId": {
+ "type": "string"
+ },
+ "ThreadItem": {
+ "oneOf": [
+ {
+ "properties": {
+ "content": {
+ "items": {
+ "$ref": "#/definitions/UserInput"
+ },
+ "type": "array"
+ },
+ "id": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "userMessage"
+ ],
+ "title": "UserMessageThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "content",
+ "id",
+ "type"
+ ],
+ "title": "UserMessageThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "agentMessage"
+ ],
+ "title": "AgentMessageThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "text",
+ "type"
+ ],
+ "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": {
+ "default": [],
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "id": {
+ "type": "string"
+ },
+ "summary": {
+ "default": [],
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "type": {
+ "enum": [
+ "reasoning"
+ ],
+ "title": "ReasoningThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "type"
+ ],
+ "title": "ReasoningThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "aggregatedOutput": {
+ "description": "The command's output, aggregated from stdout and stderr.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "command": {
+ "description": "The command to be executed.",
+ "type": "string"
+ },
+ "commandActions": {
+ "description": "A best-effort parsing of the command to understand the action(s) it will perform. This returns a list of CommandAction objects because a single shell command may be composed of many commands piped together.",
+ "items": {
+ "$ref": "#/definitions/CommandAction"
+ },
+ "type": "array"
+ },
+ "cwd": {
+ "description": "The command's working directory.",
+ "type": "string"
+ },
+ "durationMs": {
+ "description": "The duration of the command execution in milliseconds.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "exitCode": {
+ "description": "The command's exit code.",
+ "format": "int32",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "id": {
+ "type": "string"
+ },
+ "processId": {
+ "description": "Identifier for the underlying PTY process (when available).",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "status": {
+ "$ref": "#/definitions/CommandExecutionStatus"
+ },
+ "type": {
+ "enum": [
+ "commandExecution"
+ ],
+ "title": "CommandExecutionThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "command",
+ "commandActions",
+ "cwd",
+ "id",
+ "status",
+ "type"
+ ],
+ "title": "CommandExecutionThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "changes": {
+ "items": {
+ "$ref": "#/definitions/FileUpdateChange"
+ },
+ "type": "array"
+ },
+ "id": {
+ "type": "string"
+ },
+ "status": {
+ "$ref": "#/definitions/PatchApplyStatus"
+ },
+ "type": {
+ "enum": [
+ "fileChange"
+ ],
+ "title": "FileChangeThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "changes",
+ "id",
+ "status",
+ "type"
+ ],
+ "title": "FileChangeThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "arguments": true,
+ "durationMs": {
+ "description": "The duration of the MCP tool call in milliseconds.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "error": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/McpToolCallError"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "id": {
+ "type": "string"
+ },
+ "result": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/McpToolCallResult"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "server": {
+ "type": "string"
+ },
+ "status": {
+ "$ref": "#/definitions/McpToolCallStatus"
+ },
+ "tool": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "mcpToolCall"
+ ],
+ "title": "McpToolCallThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "arguments",
+ "id",
+ "server",
+ "status",
+ "tool",
+ "type"
+ ],
+ "title": "McpToolCallThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "agentsStates": {
+ "additionalProperties": {
+ "$ref": "#/definitions/CollabAgentState"
+ },
+ "description": "Last known status of the target agents, when available.",
+ "type": "object"
+ },
+ "id": {
+ "description": "Unique identifier for this collab tool call.",
+ "type": "string"
+ },
+ "prompt": {
+ "description": "Prompt text sent as part of the collab tool call, when available.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "receiverThreadIds": {
+ "description": "Thread ID of the receiving agent, when applicable. In case of spawn operation, this corresponds to the newly spawned agent.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "senderThreadId": {
+ "description": "Thread ID of the agent issuing the collab request.",
+ "type": "string"
+ },
+ "status": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/CollabAgentToolCallStatus"
+ }
+ ],
+ "description": "Current status of the collab tool call."
+ },
+ "tool": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/CollabAgentTool"
+ }
+ ],
+ "description": "Name of the collab tool that was invoked."
+ },
+ "type": {
+ "enum": [
+ "collabAgentToolCall"
+ ],
+ "title": "CollabAgentToolCallThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "agentsStates",
+ "id",
+ "receiverThreadIds",
+ "senderThreadId",
+ "status",
+ "tool",
+ "type"
+ ],
+ "title": "CollabAgentToolCallThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "action": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/WebSearchAction"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "id": {
+ "type": "string"
+ },
+ "query": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "webSearch"
+ ],
+ "title": "WebSearchThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "query",
+ "type"
+ ],
+ "title": "WebSearchThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "imageView"
+ ],
+ "title": "ImageViewThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "path",
+ "type"
+ ],
+ "title": "ImageViewThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "review": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "enteredReviewMode"
+ ],
+ "title": "EnteredReviewModeThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "review",
+ "type"
+ ],
+ "title": "EnteredReviewModeThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "review": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "exitedReviewMode"
+ ],
+ "title": "ExitedReviewModeThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "review",
+ "type"
+ ],
+ "title": "ExitedReviewModeThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "contextCompaction"
+ ],
+ "title": "ContextCompactionThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "type"
+ ],
+ "title": "ContextCompactionThreadItem",
+ "type": "object"
+ }
+ ]
+ },
+ "Turn": {
+ "properties": {
+ "error": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/TurnError"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Only populated when the Turn's status is failed."
+ },
+ "id": {
+ "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.",
+ "items": {
+ "$ref": "#/definitions/ThreadItem"
+ },
+ "type": "array"
+ },
+ "status": {
+ "$ref": "#/definitions/TurnStatus"
+ }
+ },
+ "required": [
+ "id",
+ "items",
+ "status"
+ ],
+ "type": "object"
+ },
+ "TurnError": {
+ "properties": {
+ "additionalDetails": {
+ "default": null,
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "codexErrorInfo": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/CodexErrorInfo"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "message": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "message"
+ ],
+ "type": "object"
+ },
+ "TurnStatus": {
+ "enum": [
+ "completed",
+ "interrupted",
+ "failed",
+ "inProgress"
+ ],
+ "type": "string"
+ },
+ "UserInput": {
+ "oneOf": [
+ {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "text_elements": {
+ "default": [],
+ "description": "UI-defined spans within `text` used to render or persist special elements.",
+ "items": {
+ "$ref": "#/definitions/TextElement"
+ },
+ "type": "array"
+ },
+ "type": {
+ "enum": [
+ "text"
+ ],
+ "title": "TextUserInputType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "TextUserInput",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "image"
+ ],
+ "title": "ImageUserInputType",
+ "type": "string"
+ },
+ "url": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "url"
+ ],
+ "title": "ImageUserInput",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "localImage"
+ ],
+ "title": "LocalImageUserInputType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "path",
+ "type"
+ ],
+ "title": "LocalImageUserInput",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "name": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "skill"
+ ],
+ "title": "SkillUserInputType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "path",
+ "type"
+ ],
+ "title": "SkillUserInput",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "name": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "mention"
+ ],
+ "title": "MentionUserInputType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "path",
+ "type"
+ ],
+ "title": "MentionUserInput",
+ "type": "object"
+ }
+ ]
+ },
+ "WebSearchAction": {
+ "oneOf": [
+ {
+ "properties": {
+ "queries": {
+ "items": {
+ "type": "string"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "query": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "search"
+ ],
+ "title": "SearchWebSearchActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "SearchWebSearchAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "openPage"
+ ],
+ "title": "OpenPageWebSearchActionType",
+ "type": "string"
+ },
+ "url": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "OpenPageWebSearchAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "pattern": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "findInPage"
+ ],
+ "title": "FindInPageWebSearchActionType",
+ "type": "string"
+ },
+ "url": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "FindInPageWebSearchAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "other"
+ ],
+ "title": "OtherWebSearchActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "OtherWebSearchAction",
+ "type": "object"
+ }
+ ]
+ }
+ },
+ "properties": {
+ "thread": {
+ "$ref": "#/definitions/Thread"
+ }
+ },
+ "required": [
+ "thread"
+ ],
+ "title": "ThreadStartedNotification",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v2/ThreadTokenUsageUpdatedNotification.json b/codex-rs/app-server-protocol/schema/json/v2/ThreadTokenUsageUpdatedNotification.json
new file mode 100644
index 0000000000..111de85c62
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v2/ThreadTokenUsageUpdatedNotification.json
@@ -0,0 +1,77 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "definitions": {
+ "ThreadTokenUsage": {
+ "properties": {
+ "last": {
+ "$ref": "#/definitions/TokenUsageBreakdown"
+ },
+ "modelContextWindow": {
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "total": {
+ "$ref": "#/definitions/TokenUsageBreakdown"
+ }
+ },
+ "required": [
+ "last",
+ "total"
+ ],
+ "type": "object"
+ },
+ "TokenUsageBreakdown": {
+ "properties": {
+ "cachedInputTokens": {
+ "format": "int64",
+ "type": "integer"
+ },
+ "inputTokens": {
+ "format": "int64",
+ "type": "integer"
+ },
+ "outputTokens": {
+ "format": "int64",
+ "type": "integer"
+ },
+ "reasoningOutputTokens": {
+ "format": "int64",
+ "type": "integer"
+ },
+ "totalTokens": {
+ "format": "int64",
+ "type": "integer"
+ }
+ },
+ "required": [
+ "cachedInputTokens",
+ "inputTokens",
+ "outputTokens",
+ "reasoningOutputTokens",
+ "totalTokens"
+ ],
+ "type": "object"
+ }
+ },
+ "properties": {
+ "threadId": {
+ "type": "string"
+ },
+ "tokenUsage": {
+ "$ref": "#/definitions/ThreadTokenUsage"
+ },
+ "turnId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "threadId",
+ "tokenUsage",
+ "turnId"
+ ],
+ "title": "ThreadTokenUsageUpdatedNotification",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v2/ThreadUnarchiveParams.json b/codex-rs/app-server-protocol/schema/json/v2/ThreadUnarchiveParams.json
new file mode 100644
index 0000000000..fd62a96cc3
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v2/ThreadUnarchiveParams.json
@@ -0,0 +1,13 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "threadId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "threadId"
+ ],
+ "title": "ThreadUnarchiveParams",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v2/ThreadUnarchiveResponse.json b/codex-rs/app-server-protocol/schema/json/v2/ThreadUnarchiveResponse.json
new file mode 100644
index 0000000000..46478554bb
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v2/ThreadUnarchiveResponse.json
@@ -0,0 +1,1702 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "definitions": {
+ "Annotations": {
+ "description": "Optional annotations for the client. The client can use annotations to inform how objects are used or displayed",
+ "properties": {
+ "audience": {
+ "items": {
+ "$ref": "#/definitions/Role"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "lastModified": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "priority": {
+ "format": "double",
+ "type": [
+ "number",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "AudioContent": {
+ "description": "Audio provided to or from an LLM.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "data": {
+ "type": "string"
+ },
+ "mimeType": {
+ "type": "string"
+ },
+ "type": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "data",
+ "mimeType",
+ "type"
+ ],
+ "type": "object"
+ },
+ "BlobResourceContents": {
+ "properties": {
+ "blob": {
+ "type": "string"
+ },
+ "mimeType": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "uri": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "blob",
+ "uri"
+ ],
+ "type": "object"
+ },
+ "ByteRange": {
+ "properties": {
+ "end": {
+ "format": "uint",
+ "minimum": 0.0,
+ "type": "integer"
+ },
+ "start": {
+ "format": "uint",
+ "minimum": 0.0,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "end",
+ "start"
+ ],
+ "type": "object"
+ },
+ "CodexErrorInfo": {
+ "description": "This translation layer make sure that we expose codex error code in camel case.\n\nWhen an upstream HTTP status is available (for example, from the Responses API or a provider), it is forwarded in `httpStatusCode` on the relevant `codexErrorInfo` variant.",
+ "oneOf": [
+ {
+ "enum": [
+ "contextWindowExceeded",
+ "usageLimitExceeded",
+ "internalServerError",
+ "unauthorized",
+ "badRequest",
+ "threadRollbackFailed",
+ "sandboxError",
+ "other"
+ ],
+ "type": "string"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "modelCap": {
+ "properties": {
+ "model": {
+ "type": "string"
+ },
+ "reset_after_seconds": {
+ "format": "uint64",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "model"
+ ],
+ "type": "object"
+ }
+ },
+ "required": [
+ "modelCap"
+ ],
+ "title": "ModelCapCodexErrorInfo",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "httpConnectionFailed": {
+ "properties": {
+ "httpStatusCode": {
+ "format": "uint16",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "httpConnectionFailed"
+ ],
+ "title": "HttpConnectionFailedCodexErrorInfo",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "Failed to connect to the response SSE stream.",
+ "properties": {
+ "responseStreamConnectionFailed": {
+ "properties": {
+ "httpStatusCode": {
+ "format": "uint16",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "responseStreamConnectionFailed"
+ ],
+ "title": "ResponseStreamConnectionFailedCodexErrorInfo",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "The response SSE stream disconnected in the middle of a turn before completion.",
+ "properties": {
+ "responseStreamDisconnected": {
+ "properties": {
+ "httpStatusCode": {
+ "format": "uint16",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "responseStreamDisconnected"
+ ],
+ "title": "ResponseStreamDisconnectedCodexErrorInfo",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "Reached the retry limit for responses.",
+ "properties": {
+ "responseTooManyFailedAttempts": {
+ "properties": {
+ "httpStatusCode": {
+ "format": "uint16",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "responseTooManyFailedAttempts"
+ ],
+ "title": "ResponseTooManyFailedAttemptsCodexErrorInfo",
+ "type": "object"
+ }
+ ]
+ },
+ "CollabAgentState": {
+ "properties": {
+ "message": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "status": {
+ "$ref": "#/definitions/CollabAgentStatus"
+ }
+ },
+ "required": [
+ "status"
+ ],
+ "type": "object"
+ },
+ "CollabAgentStatus": {
+ "enum": [
+ "pendingInit",
+ "running",
+ "completed",
+ "errored",
+ "shutdown",
+ "notFound"
+ ],
+ "type": "string"
+ },
+ "CollabAgentTool": {
+ "enum": [
+ "spawnAgent",
+ "sendInput",
+ "wait",
+ "closeAgent"
+ ],
+ "type": "string"
+ },
+ "CollabAgentToolCallStatus": {
+ "enum": [
+ "inProgress",
+ "completed",
+ "failed"
+ ],
+ "type": "string"
+ },
+ "CommandAction": {
+ "oneOf": [
+ {
+ "properties": {
+ "command": {
+ "type": "string"
+ },
+ "name": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "read"
+ ],
+ "title": "ReadCommandActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "command",
+ "name",
+ "path",
+ "type"
+ ],
+ "title": "ReadCommandAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "command": {
+ "type": "string"
+ },
+ "path": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "listFiles"
+ ],
+ "title": "ListFilesCommandActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "command",
+ "type"
+ ],
+ "title": "ListFilesCommandAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "command": {
+ "type": "string"
+ },
+ "path": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "query": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "search"
+ ],
+ "title": "SearchCommandActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "command",
+ "type"
+ ],
+ "title": "SearchCommandAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "command": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "unknown"
+ ],
+ "title": "UnknownCommandActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "command",
+ "type"
+ ],
+ "title": "UnknownCommandAction",
+ "type": "object"
+ }
+ ]
+ },
+ "CommandExecutionStatus": {
+ "enum": [
+ "inProgress",
+ "completed",
+ "failed",
+ "declined"
+ ],
+ "type": "string"
+ },
+ "ContentBlock": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/TextContent"
+ },
+ {
+ "$ref": "#/definitions/ImageContent"
+ },
+ {
+ "$ref": "#/definitions/AudioContent"
+ },
+ {
+ "$ref": "#/definitions/ResourceLink"
+ },
+ {
+ "$ref": "#/definitions/EmbeddedResource"
+ }
+ ]
+ },
+ "EmbeddedResource": {
+ "description": "The contents of a resource, embedded into a prompt or tool call result.\n\nIt is up to the client how best to render embedded resources for the benefit of the LLM and/or the user.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "resource": {
+ "$ref": "#/definitions/EmbeddedResourceResource"
+ },
+ "type": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "resource",
+ "type"
+ ],
+ "type": "object"
+ },
+ "EmbeddedResourceResource": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/TextResourceContents"
+ },
+ {
+ "$ref": "#/definitions/BlobResourceContents"
+ }
+ ]
+ },
+ "FileUpdateChange": {
+ "properties": {
+ "diff": {
+ "type": "string"
+ },
+ "kind": {
+ "$ref": "#/definitions/PatchChangeKind"
+ },
+ "path": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "diff",
+ "kind",
+ "path"
+ ],
+ "type": "object"
+ },
+ "GitInfo": {
+ "properties": {
+ "branch": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "originUrl": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "sha": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "ImageContent": {
+ "description": "An image provided to or from an LLM.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "data": {
+ "type": "string"
+ },
+ "mimeType": {
+ "type": "string"
+ },
+ "type": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "data",
+ "mimeType",
+ "type"
+ ],
+ "type": "object"
+ },
+ "McpToolCallError": {
+ "properties": {
+ "message": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "message"
+ ],
+ "type": "object"
+ },
+ "McpToolCallResult": {
+ "properties": {
+ "content": {
+ "items": {
+ "$ref": "#/definitions/ContentBlock"
+ },
+ "type": "array"
+ },
+ "structuredContent": true
+ },
+ "required": [
+ "content"
+ ],
+ "type": "object"
+ },
+ "McpToolCallStatus": {
+ "enum": [
+ "inProgress",
+ "completed",
+ "failed"
+ ],
+ "type": "string"
+ },
+ "PatchApplyStatus": {
+ "enum": [
+ "inProgress",
+ "completed",
+ "failed",
+ "declined"
+ ],
+ "type": "string"
+ },
+ "PatchChangeKind": {
+ "oneOf": [
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "add"
+ ],
+ "title": "AddPatchChangeKindType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "AddPatchChangeKind",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "delete"
+ ],
+ "title": "DeletePatchChangeKindType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "DeletePatchChangeKind",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "move_path": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "update"
+ ],
+ "title": "UpdatePatchChangeKindType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "UpdatePatchChangeKind",
+ "type": "object"
+ }
+ ]
+ },
+ "ResourceLink": {
+ "description": "A resource that the server is capable of reading, included in a prompt or tool call result.\n\nNote: resource links returned by tools are not guaranteed to appear in the results of `resources/list` requests.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "description": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "mimeType": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "name": {
+ "type": "string"
+ },
+ "size": {
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "title": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "type": "string"
+ },
+ "uri": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "type",
+ "uri"
+ ],
+ "type": "object"
+ },
+ "Role": {
+ "description": "The sender or recipient of messages and data in a conversation.",
+ "enum": [
+ "assistant",
+ "user"
+ ],
+ "type": "string"
+ },
+ "SessionSource": {
+ "oneOf": [
+ {
+ "enum": [
+ "cli",
+ "vscode",
+ "exec",
+ "appServer",
+ "unknown"
+ ],
+ "type": "string"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "subAgent": {
+ "$ref": "#/definitions/SubAgentSource"
+ }
+ },
+ "required": [
+ "subAgent"
+ ],
+ "title": "SubAgentSessionSource",
+ "type": "object"
+ }
+ ]
+ },
+ "SubAgentSource": {
+ "oneOf": [
+ {
+ "enum": [
+ "review",
+ "compact"
+ ],
+ "type": "string"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "thread_spawn": {
+ "properties": {
+ "depth": {
+ "format": "int32",
+ "type": "integer"
+ },
+ "parent_thread_id": {
+ "$ref": "#/definitions/ThreadId"
+ }
+ },
+ "required": [
+ "depth",
+ "parent_thread_id"
+ ],
+ "type": "object"
+ }
+ },
+ "required": [
+ "thread_spawn"
+ ],
+ "title": "ThreadSpawnSubAgentSource",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "other": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "other"
+ ],
+ "title": "OtherSubAgentSource",
+ "type": "object"
+ }
+ ]
+ },
+ "TextContent": {
+ "description": "Text provided to or from an LLM.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "type": "object"
+ },
+ "TextElement": {
+ "properties": {
+ "byteRange": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ByteRange"
+ }
+ ],
+ "description": "Byte range in the parent `text` buffer that this element occupies."
+ },
+ "placeholder": {
+ "description": "Optional human-readable placeholder for the element, displayed in the UI.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "byteRange"
+ ],
+ "type": "object"
+ },
+ "TextResourceContents": {
+ "properties": {
+ "mimeType": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "text": {
+ "type": "string"
+ },
+ "uri": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "uri"
+ ],
+ "type": "object"
+ },
+ "Thread": {
+ "properties": {
+ "cliVersion": {
+ "description": "Version of the CLI that created the thread.",
+ "type": "string"
+ },
+ "createdAt": {
+ "description": "Unix timestamp (in seconds) when the thread was created.",
+ "format": "int64",
+ "type": "integer"
+ },
+ "cwd": {
+ "description": "Working directory captured for the thread.",
+ "type": "string"
+ },
+ "gitInfo": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/GitInfo"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Optional Git metadata captured when the thread was created."
+ },
+ "id": {
+ "type": "string"
+ },
+ "modelProvider": {
+ "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"
+ },
+ "source": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/SessionSource"
+ }
+ ],
+ "description": "Origin of the thread (CLI, VSCode, codex exec, codex app-server, etc.)."
+ },
+ "turns": {
+ "description": "Only populated on `thread/resume`, `thread/rollback`, `thread/fork`, and `thread/read` (when `includeTurns` is true) responses. For all other responses and notifications returning a Thread, the turns field will be an empty list.",
+ "items": {
+ "$ref": "#/definitions/Turn"
+ },
+ "type": "array"
+ },
+ "updatedAt": {
+ "description": "Unix timestamp (in seconds) when the thread was last updated.",
+ "format": "int64",
+ "type": "integer"
+ }
+ },
+ "required": [
+ "cliVersion",
+ "createdAt",
+ "cwd",
+ "id",
+ "modelProvider",
+ "preview",
+ "source",
+ "turns",
+ "updatedAt"
+ ],
+ "type": "object"
+ },
+ "ThreadId": {
+ "type": "string"
+ },
+ "ThreadItem": {
+ "oneOf": [
+ {
+ "properties": {
+ "content": {
+ "items": {
+ "$ref": "#/definitions/UserInput"
+ },
+ "type": "array"
+ },
+ "id": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "userMessage"
+ ],
+ "title": "UserMessageThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "content",
+ "id",
+ "type"
+ ],
+ "title": "UserMessageThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "agentMessage"
+ ],
+ "title": "AgentMessageThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "text",
+ "type"
+ ],
+ "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": {
+ "default": [],
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "id": {
+ "type": "string"
+ },
+ "summary": {
+ "default": [],
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "type": {
+ "enum": [
+ "reasoning"
+ ],
+ "title": "ReasoningThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "type"
+ ],
+ "title": "ReasoningThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "aggregatedOutput": {
+ "description": "The command's output, aggregated from stdout and stderr.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "command": {
+ "description": "The command to be executed.",
+ "type": "string"
+ },
+ "commandActions": {
+ "description": "A best-effort parsing of the command to understand the action(s) it will perform. This returns a list of CommandAction objects because a single shell command may be composed of many commands piped together.",
+ "items": {
+ "$ref": "#/definitions/CommandAction"
+ },
+ "type": "array"
+ },
+ "cwd": {
+ "description": "The command's working directory.",
+ "type": "string"
+ },
+ "durationMs": {
+ "description": "The duration of the command execution in milliseconds.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "exitCode": {
+ "description": "The command's exit code.",
+ "format": "int32",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "id": {
+ "type": "string"
+ },
+ "processId": {
+ "description": "Identifier for the underlying PTY process (when available).",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "status": {
+ "$ref": "#/definitions/CommandExecutionStatus"
+ },
+ "type": {
+ "enum": [
+ "commandExecution"
+ ],
+ "title": "CommandExecutionThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "command",
+ "commandActions",
+ "cwd",
+ "id",
+ "status",
+ "type"
+ ],
+ "title": "CommandExecutionThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "changes": {
+ "items": {
+ "$ref": "#/definitions/FileUpdateChange"
+ },
+ "type": "array"
+ },
+ "id": {
+ "type": "string"
+ },
+ "status": {
+ "$ref": "#/definitions/PatchApplyStatus"
+ },
+ "type": {
+ "enum": [
+ "fileChange"
+ ],
+ "title": "FileChangeThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "changes",
+ "id",
+ "status",
+ "type"
+ ],
+ "title": "FileChangeThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "arguments": true,
+ "durationMs": {
+ "description": "The duration of the MCP tool call in milliseconds.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "error": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/McpToolCallError"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "id": {
+ "type": "string"
+ },
+ "result": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/McpToolCallResult"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "server": {
+ "type": "string"
+ },
+ "status": {
+ "$ref": "#/definitions/McpToolCallStatus"
+ },
+ "tool": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "mcpToolCall"
+ ],
+ "title": "McpToolCallThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "arguments",
+ "id",
+ "server",
+ "status",
+ "tool",
+ "type"
+ ],
+ "title": "McpToolCallThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "agentsStates": {
+ "additionalProperties": {
+ "$ref": "#/definitions/CollabAgentState"
+ },
+ "description": "Last known status of the target agents, when available.",
+ "type": "object"
+ },
+ "id": {
+ "description": "Unique identifier for this collab tool call.",
+ "type": "string"
+ },
+ "prompt": {
+ "description": "Prompt text sent as part of the collab tool call, when available.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "receiverThreadIds": {
+ "description": "Thread ID of the receiving agent, when applicable. In case of spawn operation, this corresponds to the newly spawned agent.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "senderThreadId": {
+ "description": "Thread ID of the agent issuing the collab request.",
+ "type": "string"
+ },
+ "status": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/CollabAgentToolCallStatus"
+ }
+ ],
+ "description": "Current status of the collab tool call."
+ },
+ "tool": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/CollabAgentTool"
+ }
+ ],
+ "description": "Name of the collab tool that was invoked."
+ },
+ "type": {
+ "enum": [
+ "collabAgentToolCall"
+ ],
+ "title": "CollabAgentToolCallThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "agentsStates",
+ "id",
+ "receiverThreadIds",
+ "senderThreadId",
+ "status",
+ "tool",
+ "type"
+ ],
+ "title": "CollabAgentToolCallThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "action": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/WebSearchAction"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "id": {
+ "type": "string"
+ },
+ "query": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "webSearch"
+ ],
+ "title": "WebSearchThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "query",
+ "type"
+ ],
+ "title": "WebSearchThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "imageView"
+ ],
+ "title": "ImageViewThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "path",
+ "type"
+ ],
+ "title": "ImageViewThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "review": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "enteredReviewMode"
+ ],
+ "title": "EnteredReviewModeThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "review",
+ "type"
+ ],
+ "title": "EnteredReviewModeThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "review": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "exitedReviewMode"
+ ],
+ "title": "ExitedReviewModeThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "review",
+ "type"
+ ],
+ "title": "ExitedReviewModeThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "contextCompaction"
+ ],
+ "title": "ContextCompactionThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "type"
+ ],
+ "title": "ContextCompactionThreadItem",
+ "type": "object"
+ }
+ ]
+ },
+ "Turn": {
+ "properties": {
+ "error": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/TurnError"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Only populated when the Turn's status is failed."
+ },
+ "id": {
+ "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.",
+ "items": {
+ "$ref": "#/definitions/ThreadItem"
+ },
+ "type": "array"
+ },
+ "status": {
+ "$ref": "#/definitions/TurnStatus"
+ }
+ },
+ "required": [
+ "id",
+ "items",
+ "status"
+ ],
+ "type": "object"
+ },
+ "TurnError": {
+ "properties": {
+ "additionalDetails": {
+ "default": null,
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "codexErrorInfo": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/CodexErrorInfo"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "message": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "message"
+ ],
+ "type": "object"
+ },
+ "TurnStatus": {
+ "enum": [
+ "completed",
+ "interrupted",
+ "failed",
+ "inProgress"
+ ],
+ "type": "string"
+ },
+ "UserInput": {
+ "oneOf": [
+ {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "text_elements": {
+ "default": [],
+ "description": "UI-defined spans within `text` used to render or persist special elements.",
+ "items": {
+ "$ref": "#/definitions/TextElement"
+ },
+ "type": "array"
+ },
+ "type": {
+ "enum": [
+ "text"
+ ],
+ "title": "TextUserInputType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "TextUserInput",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "image"
+ ],
+ "title": "ImageUserInputType",
+ "type": "string"
+ },
+ "url": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "url"
+ ],
+ "title": "ImageUserInput",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "localImage"
+ ],
+ "title": "LocalImageUserInputType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "path",
+ "type"
+ ],
+ "title": "LocalImageUserInput",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "name": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "skill"
+ ],
+ "title": "SkillUserInputType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "path",
+ "type"
+ ],
+ "title": "SkillUserInput",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "name": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "mention"
+ ],
+ "title": "MentionUserInputType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "path",
+ "type"
+ ],
+ "title": "MentionUserInput",
+ "type": "object"
+ }
+ ]
+ },
+ "WebSearchAction": {
+ "oneOf": [
+ {
+ "properties": {
+ "queries": {
+ "items": {
+ "type": "string"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "query": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "search"
+ ],
+ "title": "SearchWebSearchActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "SearchWebSearchAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "openPage"
+ ],
+ "title": "OpenPageWebSearchActionType",
+ "type": "string"
+ },
+ "url": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "OpenPageWebSearchAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "pattern": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "findInPage"
+ ],
+ "title": "FindInPageWebSearchActionType",
+ "type": "string"
+ },
+ "url": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "FindInPageWebSearchAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "other"
+ ],
+ "title": "OtherWebSearchActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "OtherWebSearchAction",
+ "type": "object"
+ }
+ ]
+ }
+ },
+ "properties": {
+ "thread": {
+ "$ref": "#/definitions/Thread"
+ }
+ },
+ "required": [
+ "thread"
+ ],
+ "title": "ThreadUnarchiveResponse",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v2/TurnCompletedNotification.json b/codex-rs/app-server-protocol/schema/json/v2/TurnCompletedNotification.json
new file mode 100644
index 0000000000..918f82a456
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v2/TurnCompletedNotification.json
@@ -0,0 +1,1525 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "definitions": {
+ "Annotations": {
+ "description": "Optional annotations for the client. The client can use annotations to inform how objects are used or displayed",
+ "properties": {
+ "audience": {
+ "items": {
+ "$ref": "#/definitions/Role"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "lastModified": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "priority": {
+ "format": "double",
+ "type": [
+ "number",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "AudioContent": {
+ "description": "Audio provided to or from an LLM.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "data": {
+ "type": "string"
+ },
+ "mimeType": {
+ "type": "string"
+ },
+ "type": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "data",
+ "mimeType",
+ "type"
+ ],
+ "type": "object"
+ },
+ "BlobResourceContents": {
+ "properties": {
+ "blob": {
+ "type": "string"
+ },
+ "mimeType": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "uri": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "blob",
+ "uri"
+ ],
+ "type": "object"
+ },
+ "ByteRange": {
+ "properties": {
+ "end": {
+ "format": "uint",
+ "minimum": 0.0,
+ "type": "integer"
+ },
+ "start": {
+ "format": "uint",
+ "minimum": 0.0,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "end",
+ "start"
+ ],
+ "type": "object"
+ },
+ "CodexErrorInfo": {
+ "description": "This translation layer make sure that we expose codex error code in camel case.\n\nWhen an upstream HTTP status is available (for example, from the Responses API or a provider), it is forwarded in `httpStatusCode` on the relevant `codexErrorInfo` variant.",
+ "oneOf": [
+ {
+ "enum": [
+ "contextWindowExceeded",
+ "usageLimitExceeded",
+ "internalServerError",
+ "unauthorized",
+ "badRequest",
+ "threadRollbackFailed",
+ "sandboxError",
+ "other"
+ ],
+ "type": "string"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "modelCap": {
+ "properties": {
+ "model": {
+ "type": "string"
+ },
+ "reset_after_seconds": {
+ "format": "uint64",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "model"
+ ],
+ "type": "object"
+ }
+ },
+ "required": [
+ "modelCap"
+ ],
+ "title": "ModelCapCodexErrorInfo",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "httpConnectionFailed": {
+ "properties": {
+ "httpStatusCode": {
+ "format": "uint16",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "httpConnectionFailed"
+ ],
+ "title": "HttpConnectionFailedCodexErrorInfo",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "Failed to connect to the response SSE stream.",
+ "properties": {
+ "responseStreamConnectionFailed": {
+ "properties": {
+ "httpStatusCode": {
+ "format": "uint16",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "responseStreamConnectionFailed"
+ ],
+ "title": "ResponseStreamConnectionFailedCodexErrorInfo",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "The response SSE stream disconnected in the middle of a turn before completion.",
+ "properties": {
+ "responseStreamDisconnected": {
+ "properties": {
+ "httpStatusCode": {
+ "format": "uint16",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "responseStreamDisconnected"
+ ],
+ "title": "ResponseStreamDisconnectedCodexErrorInfo",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "Reached the retry limit for responses.",
+ "properties": {
+ "responseTooManyFailedAttempts": {
+ "properties": {
+ "httpStatusCode": {
+ "format": "uint16",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "responseTooManyFailedAttempts"
+ ],
+ "title": "ResponseTooManyFailedAttemptsCodexErrorInfo",
+ "type": "object"
+ }
+ ]
+ },
+ "CollabAgentState": {
+ "properties": {
+ "message": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "status": {
+ "$ref": "#/definitions/CollabAgentStatus"
+ }
+ },
+ "required": [
+ "status"
+ ],
+ "type": "object"
+ },
+ "CollabAgentStatus": {
+ "enum": [
+ "pendingInit",
+ "running",
+ "completed",
+ "errored",
+ "shutdown",
+ "notFound"
+ ],
+ "type": "string"
+ },
+ "CollabAgentTool": {
+ "enum": [
+ "spawnAgent",
+ "sendInput",
+ "wait",
+ "closeAgent"
+ ],
+ "type": "string"
+ },
+ "CollabAgentToolCallStatus": {
+ "enum": [
+ "inProgress",
+ "completed",
+ "failed"
+ ],
+ "type": "string"
+ },
+ "CommandAction": {
+ "oneOf": [
+ {
+ "properties": {
+ "command": {
+ "type": "string"
+ },
+ "name": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "read"
+ ],
+ "title": "ReadCommandActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "command",
+ "name",
+ "path",
+ "type"
+ ],
+ "title": "ReadCommandAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "command": {
+ "type": "string"
+ },
+ "path": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "listFiles"
+ ],
+ "title": "ListFilesCommandActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "command",
+ "type"
+ ],
+ "title": "ListFilesCommandAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "command": {
+ "type": "string"
+ },
+ "path": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "query": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "search"
+ ],
+ "title": "SearchCommandActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "command",
+ "type"
+ ],
+ "title": "SearchCommandAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "command": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "unknown"
+ ],
+ "title": "UnknownCommandActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "command",
+ "type"
+ ],
+ "title": "UnknownCommandAction",
+ "type": "object"
+ }
+ ]
+ },
+ "CommandExecutionStatus": {
+ "enum": [
+ "inProgress",
+ "completed",
+ "failed",
+ "declined"
+ ],
+ "type": "string"
+ },
+ "ContentBlock": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/TextContent"
+ },
+ {
+ "$ref": "#/definitions/ImageContent"
+ },
+ {
+ "$ref": "#/definitions/AudioContent"
+ },
+ {
+ "$ref": "#/definitions/ResourceLink"
+ },
+ {
+ "$ref": "#/definitions/EmbeddedResource"
+ }
+ ]
+ },
+ "EmbeddedResource": {
+ "description": "The contents of a resource, embedded into a prompt or tool call result.\n\nIt is up to the client how best to render embedded resources for the benefit of the LLM and/or the user.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "resource": {
+ "$ref": "#/definitions/EmbeddedResourceResource"
+ },
+ "type": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "resource",
+ "type"
+ ],
+ "type": "object"
+ },
+ "EmbeddedResourceResource": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/TextResourceContents"
+ },
+ {
+ "$ref": "#/definitions/BlobResourceContents"
+ }
+ ]
+ },
+ "FileUpdateChange": {
+ "properties": {
+ "diff": {
+ "type": "string"
+ },
+ "kind": {
+ "$ref": "#/definitions/PatchChangeKind"
+ },
+ "path": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "diff",
+ "kind",
+ "path"
+ ],
+ "type": "object"
+ },
+ "ImageContent": {
+ "description": "An image provided to or from an LLM.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "data": {
+ "type": "string"
+ },
+ "mimeType": {
+ "type": "string"
+ },
+ "type": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "data",
+ "mimeType",
+ "type"
+ ],
+ "type": "object"
+ },
+ "McpToolCallError": {
+ "properties": {
+ "message": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "message"
+ ],
+ "type": "object"
+ },
+ "McpToolCallResult": {
+ "properties": {
+ "content": {
+ "items": {
+ "$ref": "#/definitions/ContentBlock"
+ },
+ "type": "array"
+ },
+ "structuredContent": true
+ },
+ "required": [
+ "content"
+ ],
+ "type": "object"
+ },
+ "McpToolCallStatus": {
+ "enum": [
+ "inProgress",
+ "completed",
+ "failed"
+ ],
+ "type": "string"
+ },
+ "PatchApplyStatus": {
+ "enum": [
+ "inProgress",
+ "completed",
+ "failed",
+ "declined"
+ ],
+ "type": "string"
+ },
+ "PatchChangeKind": {
+ "oneOf": [
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "add"
+ ],
+ "title": "AddPatchChangeKindType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "AddPatchChangeKind",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "delete"
+ ],
+ "title": "DeletePatchChangeKindType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "DeletePatchChangeKind",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "move_path": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "update"
+ ],
+ "title": "UpdatePatchChangeKindType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "UpdatePatchChangeKind",
+ "type": "object"
+ }
+ ]
+ },
+ "ResourceLink": {
+ "description": "A resource that the server is capable of reading, included in a prompt or tool call result.\n\nNote: resource links returned by tools are not guaranteed to appear in the results of `resources/list` requests.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "description": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "mimeType": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "name": {
+ "type": "string"
+ },
+ "size": {
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "title": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "type": "string"
+ },
+ "uri": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "type",
+ "uri"
+ ],
+ "type": "object"
+ },
+ "Role": {
+ "description": "The sender or recipient of messages and data in a conversation.",
+ "enum": [
+ "assistant",
+ "user"
+ ],
+ "type": "string"
+ },
+ "TextContent": {
+ "description": "Text provided to or from an LLM.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "type": "object"
+ },
+ "TextElement": {
+ "properties": {
+ "byteRange": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ByteRange"
+ }
+ ],
+ "description": "Byte range in the parent `text` buffer that this element occupies."
+ },
+ "placeholder": {
+ "description": "Optional human-readable placeholder for the element, displayed in the UI.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "byteRange"
+ ],
+ "type": "object"
+ },
+ "TextResourceContents": {
+ "properties": {
+ "mimeType": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "text": {
+ "type": "string"
+ },
+ "uri": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "uri"
+ ],
+ "type": "object"
+ },
+ "ThreadItem": {
+ "oneOf": [
+ {
+ "properties": {
+ "content": {
+ "items": {
+ "$ref": "#/definitions/UserInput"
+ },
+ "type": "array"
+ },
+ "id": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "userMessage"
+ ],
+ "title": "UserMessageThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "content",
+ "id",
+ "type"
+ ],
+ "title": "UserMessageThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "agentMessage"
+ ],
+ "title": "AgentMessageThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "text",
+ "type"
+ ],
+ "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": {
+ "default": [],
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "id": {
+ "type": "string"
+ },
+ "summary": {
+ "default": [],
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "type": {
+ "enum": [
+ "reasoning"
+ ],
+ "title": "ReasoningThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "type"
+ ],
+ "title": "ReasoningThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "aggregatedOutput": {
+ "description": "The command's output, aggregated from stdout and stderr.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "command": {
+ "description": "The command to be executed.",
+ "type": "string"
+ },
+ "commandActions": {
+ "description": "A best-effort parsing of the command to understand the action(s) it will perform. This returns a list of CommandAction objects because a single shell command may be composed of many commands piped together.",
+ "items": {
+ "$ref": "#/definitions/CommandAction"
+ },
+ "type": "array"
+ },
+ "cwd": {
+ "description": "The command's working directory.",
+ "type": "string"
+ },
+ "durationMs": {
+ "description": "The duration of the command execution in milliseconds.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "exitCode": {
+ "description": "The command's exit code.",
+ "format": "int32",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "id": {
+ "type": "string"
+ },
+ "processId": {
+ "description": "Identifier for the underlying PTY process (when available).",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "status": {
+ "$ref": "#/definitions/CommandExecutionStatus"
+ },
+ "type": {
+ "enum": [
+ "commandExecution"
+ ],
+ "title": "CommandExecutionThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "command",
+ "commandActions",
+ "cwd",
+ "id",
+ "status",
+ "type"
+ ],
+ "title": "CommandExecutionThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "changes": {
+ "items": {
+ "$ref": "#/definitions/FileUpdateChange"
+ },
+ "type": "array"
+ },
+ "id": {
+ "type": "string"
+ },
+ "status": {
+ "$ref": "#/definitions/PatchApplyStatus"
+ },
+ "type": {
+ "enum": [
+ "fileChange"
+ ],
+ "title": "FileChangeThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "changes",
+ "id",
+ "status",
+ "type"
+ ],
+ "title": "FileChangeThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "arguments": true,
+ "durationMs": {
+ "description": "The duration of the MCP tool call in milliseconds.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "error": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/McpToolCallError"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "id": {
+ "type": "string"
+ },
+ "result": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/McpToolCallResult"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "server": {
+ "type": "string"
+ },
+ "status": {
+ "$ref": "#/definitions/McpToolCallStatus"
+ },
+ "tool": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "mcpToolCall"
+ ],
+ "title": "McpToolCallThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "arguments",
+ "id",
+ "server",
+ "status",
+ "tool",
+ "type"
+ ],
+ "title": "McpToolCallThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "agentsStates": {
+ "additionalProperties": {
+ "$ref": "#/definitions/CollabAgentState"
+ },
+ "description": "Last known status of the target agents, when available.",
+ "type": "object"
+ },
+ "id": {
+ "description": "Unique identifier for this collab tool call.",
+ "type": "string"
+ },
+ "prompt": {
+ "description": "Prompt text sent as part of the collab tool call, when available.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "receiverThreadIds": {
+ "description": "Thread ID of the receiving agent, when applicable. In case of spawn operation, this corresponds to the newly spawned agent.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "senderThreadId": {
+ "description": "Thread ID of the agent issuing the collab request.",
+ "type": "string"
+ },
+ "status": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/CollabAgentToolCallStatus"
+ }
+ ],
+ "description": "Current status of the collab tool call."
+ },
+ "tool": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/CollabAgentTool"
+ }
+ ],
+ "description": "Name of the collab tool that was invoked."
+ },
+ "type": {
+ "enum": [
+ "collabAgentToolCall"
+ ],
+ "title": "CollabAgentToolCallThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "agentsStates",
+ "id",
+ "receiverThreadIds",
+ "senderThreadId",
+ "status",
+ "tool",
+ "type"
+ ],
+ "title": "CollabAgentToolCallThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "action": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/WebSearchAction"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "id": {
+ "type": "string"
+ },
+ "query": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "webSearch"
+ ],
+ "title": "WebSearchThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "query",
+ "type"
+ ],
+ "title": "WebSearchThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "imageView"
+ ],
+ "title": "ImageViewThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "path",
+ "type"
+ ],
+ "title": "ImageViewThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "review": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "enteredReviewMode"
+ ],
+ "title": "EnteredReviewModeThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "review",
+ "type"
+ ],
+ "title": "EnteredReviewModeThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "review": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "exitedReviewMode"
+ ],
+ "title": "ExitedReviewModeThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "review",
+ "type"
+ ],
+ "title": "ExitedReviewModeThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "contextCompaction"
+ ],
+ "title": "ContextCompactionThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "type"
+ ],
+ "title": "ContextCompactionThreadItem",
+ "type": "object"
+ }
+ ]
+ },
+ "Turn": {
+ "properties": {
+ "error": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/TurnError"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Only populated when the Turn's status is failed."
+ },
+ "id": {
+ "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.",
+ "items": {
+ "$ref": "#/definitions/ThreadItem"
+ },
+ "type": "array"
+ },
+ "status": {
+ "$ref": "#/definitions/TurnStatus"
+ }
+ },
+ "required": [
+ "id",
+ "items",
+ "status"
+ ],
+ "type": "object"
+ },
+ "TurnError": {
+ "properties": {
+ "additionalDetails": {
+ "default": null,
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "codexErrorInfo": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/CodexErrorInfo"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "message": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "message"
+ ],
+ "type": "object"
+ },
+ "TurnStatus": {
+ "enum": [
+ "completed",
+ "interrupted",
+ "failed",
+ "inProgress"
+ ],
+ "type": "string"
+ },
+ "UserInput": {
+ "oneOf": [
+ {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "text_elements": {
+ "default": [],
+ "description": "UI-defined spans within `text` used to render or persist special elements.",
+ "items": {
+ "$ref": "#/definitions/TextElement"
+ },
+ "type": "array"
+ },
+ "type": {
+ "enum": [
+ "text"
+ ],
+ "title": "TextUserInputType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "TextUserInput",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "image"
+ ],
+ "title": "ImageUserInputType",
+ "type": "string"
+ },
+ "url": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "url"
+ ],
+ "title": "ImageUserInput",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "localImage"
+ ],
+ "title": "LocalImageUserInputType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "path",
+ "type"
+ ],
+ "title": "LocalImageUserInput",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "name": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "skill"
+ ],
+ "title": "SkillUserInputType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "path",
+ "type"
+ ],
+ "title": "SkillUserInput",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "name": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "mention"
+ ],
+ "title": "MentionUserInputType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "path",
+ "type"
+ ],
+ "title": "MentionUserInput",
+ "type": "object"
+ }
+ ]
+ },
+ "WebSearchAction": {
+ "oneOf": [
+ {
+ "properties": {
+ "queries": {
+ "items": {
+ "type": "string"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "query": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "search"
+ ],
+ "title": "SearchWebSearchActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "SearchWebSearchAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "openPage"
+ ],
+ "title": "OpenPageWebSearchActionType",
+ "type": "string"
+ },
+ "url": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "OpenPageWebSearchAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "pattern": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "findInPage"
+ ],
+ "title": "FindInPageWebSearchActionType",
+ "type": "string"
+ },
+ "url": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "FindInPageWebSearchAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "other"
+ ],
+ "title": "OtherWebSearchActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "OtherWebSearchAction",
+ "type": "object"
+ }
+ ]
+ }
+ },
+ "properties": {
+ "threadId": {
+ "type": "string"
+ },
+ "turn": {
+ "$ref": "#/definitions/Turn"
+ }
+ },
+ "required": [
+ "threadId",
+ "turn"
+ ],
+ "title": "TurnCompletedNotification",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v2/TurnDiffUpdatedNotification.json b/codex-rs/app-server-protocol/schema/json/v2/TurnDiffUpdatedNotification.json
new file mode 100644
index 0000000000..b694ce254c
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v2/TurnDiffUpdatedNotification.json
@@ -0,0 +1,22 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "description": "Notification that the turn-level unified diff has changed. Contains the latest aggregated diff across all file changes in the turn.",
+ "properties": {
+ "diff": {
+ "type": "string"
+ },
+ "threadId": {
+ "type": "string"
+ },
+ "turnId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "diff",
+ "threadId",
+ "turnId"
+ ],
+ "title": "TurnDiffUpdatedNotification",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v2/TurnInterruptParams.json b/codex-rs/app-server-protocol/schema/json/v2/TurnInterruptParams.json
new file mode 100644
index 0000000000..9181428a10
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v2/TurnInterruptParams.json
@@ -0,0 +1,17 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "threadId": {
+ "type": "string"
+ },
+ "turnId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "threadId",
+ "turnId"
+ ],
+ "title": "TurnInterruptParams",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v2/TurnInterruptResponse.json b/codex-rs/app-server-protocol/schema/json/v2/TurnInterruptResponse.json
new file mode 100644
index 0000000000..5d8a0f9ce2
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v2/TurnInterruptResponse.json
@@ -0,0 +1,5 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "title": "TurnInterruptResponse",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v2/TurnPlanUpdatedNotification.json b/codex-rs/app-server-protocol/schema/json/v2/TurnPlanUpdatedNotification.json
new file mode 100644
index 0000000000..5a28ffbf17
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v2/TurnPlanUpdatedNotification.json
@@ -0,0 +1,55 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "definitions": {
+ "TurnPlanStep": {
+ "properties": {
+ "status": {
+ "$ref": "#/definitions/TurnPlanStepStatus"
+ },
+ "step": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "status",
+ "step"
+ ],
+ "type": "object"
+ },
+ "TurnPlanStepStatus": {
+ "enum": [
+ "pending",
+ "inProgress",
+ "completed"
+ ],
+ "type": "string"
+ }
+ },
+ "properties": {
+ "explanation": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "plan": {
+ "items": {
+ "$ref": "#/definitions/TurnPlanStep"
+ },
+ "type": "array"
+ },
+ "threadId": {
+ "type": "string"
+ },
+ "turnId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "plan",
+ "threadId",
+ "turnId"
+ ],
+ "title": "TurnPlanUpdatedNotification",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v2/TurnStartParams.json b/codex-rs/app-server-protocol/schema/json/v2/TurnStartParams.json
new file mode 100644
index 0000000000..35a87890ae
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v2/TurnStartParams.json
@@ -0,0 +1,476 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "definitions": {
+ "AbsolutePathBuf": {
+ "description": "A path that is guaranteed to be absolute and normalized (though it is not guaranteed to be canonicalized or exist on the filesystem).\n\nIMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set using [AbsolutePathBufGuard::new]. If no base path is set, the deserialization will fail unless the path being deserialized is already absolute.",
+ "type": "string"
+ },
+ "AskForApproval": {
+ "enum": [
+ "untrusted",
+ "on-failure",
+ "on-request",
+ "never"
+ ],
+ "type": "string"
+ },
+ "ByteRange": {
+ "properties": {
+ "end": {
+ "format": "uint",
+ "minimum": 0.0,
+ "type": "integer"
+ },
+ "start": {
+ "format": "uint",
+ "minimum": 0.0,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "end",
+ "start"
+ ],
+ "type": "object"
+ },
+ "CollaborationMode": {
+ "description": "Collaboration mode for a Codex session.",
+ "properties": {
+ "mode": {
+ "$ref": "#/definitions/ModeKind"
+ },
+ "settings": {
+ "$ref": "#/definitions/Settings"
+ }
+ },
+ "required": [
+ "mode",
+ "settings"
+ ],
+ "type": "object"
+ },
+ "ModeKind": {
+ "description": "Initial collaboration mode to use when the TUI starts.",
+ "enum": [
+ "plan",
+ "code",
+ "pair_programming",
+ "execute",
+ "custom"
+ ],
+ "type": "string"
+ },
+ "NetworkAccess": {
+ "enum": [
+ "restricted",
+ "enabled"
+ ],
+ "type": "string"
+ },
+ "Personality": {
+ "enum": [
+ "friendly",
+ "pragmatic"
+ ],
+ "type": "string"
+ },
+ "ReasoningEffort": {
+ "description": "See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#get-started-with-reasoning",
+ "enum": [
+ "none",
+ "minimal",
+ "low",
+ "medium",
+ "high",
+ "xhigh"
+ ],
+ "type": "string"
+ },
+ "ReasoningSummary": {
+ "description": "A summary of the reasoning performed by the model. This can be useful for debugging and understanding the model's reasoning process. See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#reasoning-summaries",
+ "oneOf": [
+ {
+ "enum": [
+ "auto",
+ "concise",
+ "detailed"
+ ],
+ "type": "string"
+ },
+ {
+ "description": "Option to disable reasoning summaries.",
+ "enum": [
+ "none"
+ ],
+ "type": "string"
+ }
+ ]
+ },
+ "SandboxPolicy": {
+ "oneOf": [
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "dangerFullAccess"
+ ],
+ "title": "DangerFullAccessSandboxPolicyType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "DangerFullAccessSandboxPolicy",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "readOnly"
+ ],
+ "title": "ReadOnlySandboxPolicyType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "ReadOnlySandboxPolicy",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "networkAccess": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/NetworkAccess"
+ }
+ ],
+ "default": "restricted"
+ },
+ "type": {
+ "enum": [
+ "externalSandbox"
+ ],
+ "title": "ExternalSandboxSandboxPolicyType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "ExternalSandboxSandboxPolicy",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "excludeSlashTmp": {
+ "default": false,
+ "type": "boolean"
+ },
+ "excludeTmpdirEnvVar": {
+ "default": false,
+ "type": "boolean"
+ },
+ "networkAccess": {
+ "default": false,
+ "type": "boolean"
+ },
+ "type": {
+ "enum": [
+ "workspaceWrite"
+ ],
+ "title": "WorkspaceWriteSandboxPolicyType",
+ "type": "string"
+ },
+ "writableRoots": {
+ "default": [],
+ "items": {
+ "$ref": "#/definitions/AbsolutePathBuf"
+ },
+ "type": "array"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "WorkspaceWriteSandboxPolicy",
+ "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"
+ },
+ "TextElement": {
+ "properties": {
+ "byteRange": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ByteRange"
+ }
+ ],
+ "description": "Byte range in the parent `text` buffer that this element occupies."
+ },
+ "placeholder": {
+ "description": "Optional human-readable placeholder for the element, displayed in the UI.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "byteRange"
+ ],
+ "type": "object"
+ },
+ "UserInput": {
+ "oneOf": [
+ {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "text_elements": {
+ "default": [],
+ "description": "UI-defined spans within `text` used to render or persist special elements.",
+ "items": {
+ "$ref": "#/definitions/TextElement"
+ },
+ "type": "array"
+ },
+ "type": {
+ "enum": [
+ "text"
+ ],
+ "title": "TextUserInputType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "TextUserInput",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "image"
+ ],
+ "title": "ImageUserInputType",
+ "type": "string"
+ },
+ "url": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "url"
+ ],
+ "title": "ImageUserInput",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "localImage"
+ ],
+ "title": "LocalImageUserInputType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "path",
+ "type"
+ ],
+ "title": "LocalImageUserInput",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "name": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "skill"
+ ],
+ "title": "SkillUserInputType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "path",
+ "type"
+ ],
+ "title": "SkillUserInput",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "name": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "mention"
+ ],
+ "title": "MentionUserInputType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "path",
+ "type"
+ ],
+ "title": "MentionUserInput",
+ "type": "object"
+ }
+ ]
+ }
+ },
+ "properties": {
+ "approvalPolicy": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/AskForApproval"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "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": [
+ "string",
+ "null"
+ ]
+ },
+ "effort": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ReasoningEffort"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Override the reasoning effort for this turn and subsequent turns."
+ },
+ "input": {
+ "items": {
+ "$ref": "#/definitions/UserInput"
+ },
+ "type": "array"
+ },
+ "model": {
+ "description": "Override the model for this turn and subsequent turns.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "outputSchema": {
+ "description": "Optional JSON Schema used to constrain the final assistant message for this turn."
+ },
+ "personality": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Personality"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Override the personality for this turn and subsequent turns."
+ },
+ "sandboxPolicy": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/SandboxPolicy"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Override the sandbox policy for this turn and subsequent turns."
+ },
+ "summary": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/ReasoningSummary"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Override the reasoning summary for this turn and subsequent turns."
+ },
+ "threadId": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "input",
+ "threadId"
+ ],
+ "title": "TurnStartParams",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v2/TurnStartResponse.json b/codex-rs/app-server-protocol/schema/json/v2/TurnStartResponse.json
new file mode 100644
index 0000000000..d0d09a3f20
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v2/TurnStartResponse.json
@@ -0,0 +1,1521 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "definitions": {
+ "Annotations": {
+ "description": "Optional annotations for the client. The client can use annotations to inform how objects are used or displayed",
+ "properties": {
+ "audience": {
+ "items": {
+ "$ref": "#/definitions/Role"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "lastModified": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "priority": {
+ "format": "double",
+ "type": [
+ "number",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "AudioContent": {
+ "description": "Audio provided to or from an LLM.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "data": {
+ "type": "string"
+ },
+ "mimeType": {
+ "type": "string"
+ },
+ "type": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "data",
+ "mimeType",
+ "type"
+ ],
+ "type": "object"
+ },
+ "BlobResourceContents": {
+ "properties": {
+ "blob": {
+ "type": "string"
+ },
+ "mimeType": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "uri": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "blob",
+ "uri"
+ ],
+ "type": "object"
+ },
+ "ByteRange": {
+ "properties": {
+ "end": {
+ "format": "uint",
+ "minimum": 0.0,
+ "type": "integer"
+ },
+ "start": {
+ "format": "uint",
+ "minimum": 0.0,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "end",
+ "start"
+ ],
+ "type": "object"
+ },
+ "CodexErrorInfo": {
+ "description": "This translation layer make sure that we expose codex error code in camel case.\n\nWhen an upstream HTTP status is available (for example, from the Responses API or a provider), it is forwarded in `httpStatusCode` on the relevant `codexErrorInfo` variant.",
+ "oneOf": [
+ {
+ "enum": [
+ "contextWindowExceeded",
+ "usageLimitExceeded",
+ "internalServerError",
+ "unauthorized",
+ "badRequest",
+ "threadRollbackFailed",
+ "sandboxError",
+ "other"
+ ],
+ "type": "string"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "modelCap": {
+ "properties": {
+ "model": {
+ "type": "string"
+ },
+ "reset_after_seconds": {
+ "format": "uint64",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "model"
+ ],
+ "type": "object"
+ }
+ },
+ "required": [
+ "modelCap"
+ ],
+ "title": "ModelCapCodexErrorInfo",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "httpConnectionFailed": {
+ "properties": {
+ "httpStatusCode": {
+ "format": "uint16",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "httpConnectionFailed"
+ ],
+ "title": "HttpConnectionFailedCodexErrorInfo",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "Failed to connect to the response SSE stream.",
+ "properties": {
+ "responseStreamConnectionFailed": {
+ "properties": {
+ "httpStatusCode": {
+ "format": "uint16",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "responseStreamConnectionFailed"
+ ],
+ "title": "ResponseStreamConnectionFailedCodexErrorInfo",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "The response SSE stream disconnected in the middle of a turn before completion.",
+ "properties": {
+ "responseStreamDisconnected": {
+ "properties": {
+ "httpStatusCode": {
+ "format": "uint16",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "responseStreamDisconnected"
+ ],
+ "title": "ResponseStreamDisconnectedCodexErrorInfo",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "Reached the retry limit for responses.",
+ "properties": {
+ "responseTooManyFailedAttempts": {
+ "properties": {
+ "httpStatusCode": {
+ "format": "uint16",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "responseTooManyFailedAttempts"
+ ],
+ "title": "ResponseTooManyFailedAttemptsCodexErrorInfo",
+ "type": "object"
+ }
+ ]
+ },
+ "CollabAgentState": {
+ "properties": {
+ "message": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "status": {
+ "$ref": "#/definitions/CollabAgentStatus"
+ }
+ },
+ "required": [
+ "status"
+ ],
+ "type": "object"
+ },
+ "CollabAgentStatus": {
+ "enum": [
+ "pendingInit",
+ "running",
+ "completed",
+ "errored",
+ "shutdown",
+ "notFound"
+ ],
+ "type": "string"
+ },
+ "CollabAgentTool": {
+ "enum": [
+ "spawnAgent",
+ "sendInput",
+ "wait",
+ "closeAgent"
+ ],
+ "type": "string"
+ },
+ "CollabAgentToolCallStatus": {
+ "enum": [
+ "inProgress",
+ "completed",
+ "failed"
+ ],
+ "type": "string"
+ },
+ "CommandAction": {
+ "oneOf": [
+ {
+ "properties": {
+ "command": {
+ "type": "string"
+ },
+ "name": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "read"
+ ],
+ "title": "ReadCommandActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "command",
+ "name",
+ "path",
+ "type"
+ ],
+ "title": "ReadCommandAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "command": {
+ "type": "string"
+ },
+ "path": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "listFiles"
+ ],
+ "title": "ListFilesCommandActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "command",
+ "type"
+ ],
+ "title": "ListFilesCommandAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "command": {
+ "type": "string"
+ },
+ "path": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "query": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "search"
+ ],
+ "title": "SearchCommandActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "command",
+ "type"
+ ],
+ "title": "SearchCommandAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "command": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "unknown"
+ ],
+ "title": "UnknownCommandActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "command",
+ "type"
+ ],
+ "title": "UnknownCommandAction",
+ "type": "object"
+ }
+ ]
+ },
+ "CommandExecutionStatus": {
+ "enum": [
+ "inProgress",
+ "completed",
+ "failed",
+ "declined"
+ ],
+ "type": "string"
+ },
+ "ContentBlock": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/TextContent"
+ },
+ {
+ "$ref": "#/definitions/ImageContent"
+ },
+ {
+ "$ref": "#/definitions/AudioContent"
+ },
+ {
+ "$ref": "#/definitions/ResourceLink"
+ },
+ {
+ "$ref": "#/definitions/EmbeddedResource"
+ }
+ ]
+ },
+ "EmbeddedResource": {
+ "description": "The contents of a resource, embedded into a prompt or tool call result.\n\nIt is up to the client how best to render embedded resources for the benefit of the LLM and/or the user.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "resource": {
+ "$ref": "#/definitions/EmbeddedResourceResource"
+ },
+ "type": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "resource",
+ "type"
+ ],
+ "type": "object"
+ },
+ "EmbeddedResourceResource": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/TextResourceContents"
+ },
+ {
+ "$ref": "#/definitions/BlobResourceContents"
+ }
+ ]
+ },
+ "FileUpdateChange": {
+ "properties": {
+ "diff": {
+ "type": "string"
+ },
+ "kind": {
+ "$ref": "#/definitions/PatchChangeKind"
+ },
+ "path": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "diff",
+ "kind",
+ "path"
+ ],
+ "type": "object"
+ },
+ "ImageContent": {
+ "description": "An image provided to or from an LLM.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "data": {
+ "type": "string"
+ },
+ "mimeType": {
+ "type": "string"
+ },
+ "type": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "data",
+ "mimeType",
+ "type"
+ ],
+ "type": "object"
+ },
+ "McpToolCallError": {
+ "properties": {
+ "message": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "message"
+ ],
+ "type": "object"
+ },
+ "McpToolCallResult": {
+ "properties": {
+ "content": {
+ "items": {
+ "$ref": "#/definitions/ContentBlock"
+ },
+ "type": "array"
+ },
+ "structuredContent": true
+ },
+ "required": [
+ "content"
+ ],
+ "type": "object"
+ },
+ "McpToolCallStatus": {
+ "enum": [
+ "inProgress",
+ "completed",
+ "failed"
+ ],
+ "type": "string"
+ },
+ "PatchApplyStatus": {
+ "enum": [
+ "inProgress",
+ "completed",
+ "failed",
+ "declined"
+ ],
+ "type": "string"
+ },
+ "PatchChangeKind": {
+ "oneOf": [
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "add"
+ ],
+ "title": "AddPatchChangeKindType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "AddPatchChangeKind",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "delete"
+ ],
+ "title": "DeletePatchChangeKindType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "DeletePatchChangeKind",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "move_path": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "update"
+ ],
+ "title": "UpdatePatchChangeKindType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "UpdatePatchChangeKind",
+ "type": "object"
+ }
+ ]
+ },
+ "ResourceLink": {
+ "description": "A resource that the server is capable of reading, included in a prompt or tool call result.\n\nNote: resource links returned by tools are not guaranteed to appear in the results of `resources/list` requests.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "description": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "mimeType": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "name": {
+ "type": "string"
+ },
+ "size": {
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "title": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "type": "string"
+ },
+ "uri": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "type",
+ "uri"
+ ],
+ "type": "object"
+ },
+ "Role": {
+ "description": "The sender or recipient of messages and data in a conversation.",
+ "enum": [
+ "assistant",
+ "user"
+ ],
+ "type": "string"
+ },
+ "TextContent": {
+ "description": "Text provided to or from an LLM.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "type": "object"
+ },
+ "TextElement": {
+ "properties": {
+ "byteRange": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ByteRange"
+ }
+ ],
+ "description": "Byte range in the parent `text` buffer that this element occupies."
+ },
+ "placeholder": {
+ "description": "Optional human-readable placeholder for the element, displayed in the UI.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "byteRange"
+ ],
+ "type": "object"
+ },
+ "TextResourceContents": {
+ "properties": {
+ "mimeType": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "text": {
+ "type": "string"
+ },
+ "uri": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "uri"
+ ],
+ "type": "object"
+ },
+ "ThreadItem": {
+ "oneOf": [
+ {
+ "properties": {
+ "content": {
+ "items": {
+ "$ref": "#/definitions/UserInput"
+ },
+ "type": "array"
+ },
+ "id": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "userMessage"
+ ],
+ "title": "UserMessageThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "content",
+ "id",
+ "type"
+ ],
+ "title": "UserMessageThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "agentMessage"
+ ],
+ "title": "AgentMessageThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "text",
+ "type"
+ ],
+ "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": {
+ "default": [],
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "id": {
+ "type": "string"
+ },
+ "summary": {
+ "default": [],
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "type": {
+ "enum": [
+ "reasoning"
+ ],
+ "title": "ReasoningThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "type"
+ ],
+ "title": "ReasoningThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "aggregatedOutput": {
+ "description": "The command's output, aggregated from stdout and stderr.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "command": {
+ "description": "The command to be executed.",
+ "type": "string"
+ },
+ "commandActions": {
+ "description": "A best-effort parsing of the command to understand the action(s) it will perform. This returns a list of CommandAction objects because a single shell command may be composed of many commands piped together.",
+ "items": {
+ "$ref": "#/definitions/CommandAction"
+ },
+ "type": "array"
+ },
+ "cwd": {
+ "description": "The command's working directory.",
+ "type": "string"
+ },
+ "durationMs": {
+ "description": "The duration of the command execution in milliseconds.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "exitCode": {
+ "description": "The command's exit code.",
+ "format": "int32",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "id": {
+ "type": "string"
+ },
+ "processId": {
+ "description": "Identifier for the underlying PTY process (when available).",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "status": {
+ "$ref": "#/definitions/CommandExecutionStatus"
+ },
+ "type": {
+ "enum": [
+ "commandExecution"
+ ],
+ "title": "CommandExecutionThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "command",
+ "commandActions",
+ "cwd",
+ "id",
+ "status",
+ "type"
+ ],
+ "title": "CommandExecutionThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "changes": {
+ "items": {
+ "$ref": "#/definitions/FileUpdateChange"
+ },
+ "type": "array"
+ },
+ "id": {
+ "type": "string"
+ },
+ "status": {
+ "$ref": "#/definitions/PatchApplyStatus"
+ },
+ "type": {
+ "enum": [
+ "fileChange"
+ ],
+ "title": "FileChangeThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "changes",
+ "id",
+ "status",
+ "type"
+ ],
+ "title": "FileChangeThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "arguments": true,
+ "durationMs": {
+ "description": "The duration of the MCP tool call in milliseconds.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "error": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/McpToolCallError"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "id": {
+ "type": "string"
+ },
+ "result": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/McpToolCallResult"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "server": {
+ "type": "string"
+ },
+ "status": {
+ "$ref": "#/definitions/McpToolCallStatus"
+ },
+ "tool": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "mcpToolCall"
+ ],
+ "title": "McpToolCallThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "arguments",
+ "id",
+ "server",
+ "status",
+ "tool",
+ "type"
+ ],
+ "title": "McpToolCallThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "agentsStates": {
+ "additionalProperties": {
+ "$ref": "#/definitions/CollabAgentState"
+ },
+ "description": "Last known status of the target agents, when available.",
+ "type": "object"
+ },
+ "id": {
+ "description": "Unique identifier for this collab tool call.",
+ "type": "string"
+ },
+ "prompt": {
+ "description": "Prompt text sent as part of the collab tool call, when available.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "receiverThreadIds": {
+ "description": "Thread ID of the receiving agent, when applicable. In case of spawn operation, this corresponds to the newly spawned agent.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "senderThreadId": {
+ "description": "Thread ID of the agent issuing the collab request.",
+ "type": "string"
+ },
+ "status": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/CollabAgentToolCallStatus"
+ }
+ ],
+ "description": "Current status of the collab tool call."
+ },
+ "tool": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/CollabAgentTool"
+ }
+ ],
+ "description": "Name of the collab tool that was invoked."
+ },
+ "type": {
+ "enum": [
+ "collabAgentToolCall"
+ ],
+ "title": "CollabAgentToolCallThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "agentsStates",
+ "id",
+ "receiverThreadIds",
+ "senderThreadId",
+ "status",
+ "tool",
+ "type"
+ ],
+ "title": "CollabAgentToolCallThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "action": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/WebSearchAction"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "id": {
+ "type": "string"
+ },
+ "query": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "webSearch"
+ ],
+ "title": "WebSearchThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "query",
+ "type"
+ ],
+ "title": "WebSearchThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "imageView"
+ ],
+ "title": "ImageViewThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "path",
+ "type"
+ ],
+ "title": "ImageViewThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "review": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "enteredReviewMode"
+ ],
+ "title": "EnteredReviewModeThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "review",
+ "type"
+ ],
+ "title": "EnteredReviewModeThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "review": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "exitedReviewMode"
+ ],
+ "title": "ExitedReviewModeThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "review",
+ "type"
+ ],
+ "title": "ExitedReviewModeThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "contextCompaction"
+ ],
+ "title": "ContextCompactionThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "type"
+ ],
+ "title": "ContextCompactionThreadItem",
+ "type": "object"
+ }
+ ]
+ },
+ "Turn": {
+ "properties": {
+ "error": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/TurnError"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Only populated when the Turn's status is failed."
+ },
+ "id": {
+ "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.",
+ "items": {
+ "$ref": "#/definitions/ThreadItem"
+ },
+ "type": "array"
+ },
+ "status": {
+ "$ref": "#/definitions/TurnStatus"
+ }
+ },
+ "required": [
+ "id",
+ "items",
+ "status"
+ ],
+ "type": "object"
+ },
+ "TurnError": {
+ "properties": {
+ "additionalDetails": {
+ "default": null,
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "codexErrorInfo": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/CodexErrorInfo"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "message": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "message"
+ ],
+ "type": "object"
+ },
+ "TurnStatus": {
+ "enum": [
+ "completed",
+ "interrupted",
+ "failed",
+ "inProgress"
+ ],
+ "type": "string"
+ },
+ "UserInput": {
+ "oneOf": [
+ {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "text_elements": {
+ "default": [],
+ "description": "UI-defined spans within `text` used to render or persist special elements.",
+ "items": {
+ "$ref": "#/definitions/TextElement"
+ },
+ "type": "array"
+ },
+ "type": {
+ "enum": [
+ "text"
+ ],
+ "title": "TextUserInputType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "TextUserInput",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "image"
+ ],
+ "title": "ImageUserInputType",
+ "type": "string"
+ },
+ "url": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "url"
+ ],
+ "title": "ImageUserInput",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "localImage"
+ ],
+ "title": "LocalImageUserInputType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "path",
+ "type"
+ ],
+ "title": "LocalImageUserInput",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "name": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "skill"
+ ],
+ "title": "SkillUserInputType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "path",
+ "type"
+ ],
+ "title": "SkillUserInput",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "name": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "mention"
+ ],
+ "title": "MentionUserInputType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "path",
+ "type"
+ ],
+ "title": "MentionUserInput",
+ "type": "object"
+ }
+ ]
+ },
+ "WebSearchAction": {
+ "oneOf": [
+ {
+ "properties": {
+ "queries": {
+ "items": {
+ "type": "string"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "query": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "search"
+ ],
+ "title": "SearchWebSearchActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "SearchWebSearchAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "openPage"
+ ],
+ "title": "OpenPageWebSearchActionType",
+ "type": "string"
+ },
+ "url": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "OpenPageWebSearchAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "pattern": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "findInPage"
+ ],
+ "title": "FindInPageWebSearchActionType",
+ "type": "string"
+ },
+ "url": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "FindInPageWebSearchAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "other"
+ ],
+ "title": "OtherWebSearchActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "OtherWebSearchAction",
+ "type": "object"
+ }
+ ]
+ }
+ },
+ "properties": {
+ "turn": {
+ "$ref": "#/definitions/Turn"
+ }
+ },
+ "required": [
+ "turn"
+ ],
+ "title": "TurnStartResponse",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v2/TurnStartedNotification.json b/codex-rs/app-server-protocol/schema/json/v2/TurnStartedNotification.json
new file mode 100644
index 0000000000..9dd23a33e6
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v2/TurnStartedNotification.json
@@ -0,0 +1,1525 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "definitions": {
+ "Annotations": {
+ "description": "Optional annotations for the client. The client can use annotations to inform how objects are used or displayed",
+ "properties": {
+ "audience": {
+ "items": {
+ "$ref": "#/definitions/Role"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "lastModified": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "priority": {
+ "format": "double",
+ "type": [
+ "number",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "AudioContent": {
+ "description": "Audio provided to or from an LLM.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "data": {
+ "type": "string"
+ },
+ "mimeType": {
+ "type": "string"
+ },
+ "type": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "data",
+ "mimeType",
+ "type"
+ ],
+ "type": "object"
+ },
+ "BlobResourceContents": {
+ "properties": {
+ "blob": {
+ "type": "string"
+ },
+ "mimeType": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "uri": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "blob",
+ "uri"
+ ],
+ "type": "object"
+ },
+ "ByteRange": {
+ "properties": {
+ "end": {
+ "format": "uint",
+ "minimum": 0.0,
+ "type": "integer"
+ },
+ "start": {
+ "format": "uint",
+ "minimum": 0.0,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "end",
+ "start"
+ ],
+ "type": "object"
+ },
+ "CodexErrorInfo": {
+ "description": "This translation layer make sure that we expose codex error code in camel case.\n\nWhen an upstream HTTP status is available (for example, from the Responses API or a provider), it is forwarded in `httpStatusCode` on the relevant `codexErrorInfo` variant.",
+ "oneOf": [
+ {
+ "enum": [
+ "contextWindowExceeded",
+ "usageLimitExceeded",
+ "internalServerError",
+ "unauthorized",
+ "badRequest",
+ "threadRollbackFailed",
+ "sandboxError",
+ "other"
+ ],
+ "type": "string"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "modelCap": {
+ "properties": {
+ "model": {
+ "type": "string"
+ },
+ "reset_after_seconds": {
+ "format": "uint64",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "model"
+ ],
+ "type": "object"
+ }
+ },
+ "required": [
+ "modelCap"
+ ],
+ "title": "ModelCapCodexErrorInfo",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "httpConnectionFailed": {
+ "properties": {
+ "httpStatusCode": {
+ "format": "uint16",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "httpConnectionFailed"
+ ],
+ "title": "HttpConnectionFailedCodexErrorInfo",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "Failed to connect to the response SSE stream.",
+ "properties": {
+ "responseStreamConnectionFailed": {
+ "properties": {
+ "httpStatusCode": {
+ "format": "uint16",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "responseStreamConnectionFailed"
+ ],
+ "title": "ResponseStreamConnectionFailedCodexErrorInfo",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "The response SSE stream disconnected in the middle of a turn before completion.",
+ "properties": {
+ "responseStreamDisconnected": {
+ "properties": {
+ "httpStatusCode": {
+ "format": "uint16",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "responseStreamDisconnected"
+ ],
+ "title": "ResponseStreamDisconnectedCodexErrorInfo",
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "description": "Reached the retry limit for responses.",
+ "properties": {
+ "responseTooManyFailedAttempts": {
+ "properties": {
+ "httpStatusCode": {
+ "format": "uint16",
+ "minimum": 0.0,
+ "type": [
+ "integer",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "responseTooManyFailedAttempts"
+ ],
+ "title": "ResponseTooManyFailedAttemptsCodexErrorInfo",
+ "type": "object"
+ }
+ ]
+ },
+ "CollabAgentState": {
+ "properties": {
+ "message": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "status": {
+ "$ref": "#/definitions/CollabAgentStatus"
+ }
+ },
+ "required": [
+ "status"
+ ],
+ "type": "object"
+ },
+ "CollabAgentStatus": {
+ "enum": [
+ "pendingInit",
+ "running",
+ "completed",
+ "errored",
+ "shutdown",
+ "notFound"
+ ],
+ "type": "string"
+ },
+ "CollabAgentTool": {
+ "enum": [
+ "spawnAgent",
+ "sendInput",
+ "wait",
+ "closeAgent"
+ ],
+ "type": "string"
+ },
+ "CollabAgentToolCallStatus": {
+ "enum": [
+ "inProgress",
+ "completed",
+ "failed"
+ ],
+ "type": "string"
+ },
+ "CommandAction": {
+ "oneOf": [
+ {
+ "properties": {
+ "command": {
+ "type": "string"
+ },
+ "name": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "read"
+ ],
+ "title": "ReadCommandActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "command",
+ "name",
+ "path",
+ "type"
+ ],
+ "title": "ReadCommandAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "command": {
+ "type": "string"
+ },
+ "path": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "listFiles"
+ ],
+ "title": "ListFilesCommandActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "command",
+ "type"
+ ],
+ "title": "ListFilesCommandAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "command": {
+ "type": "string"
+ },
+ "path": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "query": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "search"
+ ],
+ "title": "SearchCommandActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "command",
+ "type"
+ ],
+ "title": "SearchCommandAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "command": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "unknown"
+ ],
+ "title": "UnknownCommandActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "command",
+ "type"
+ ],
+ "title": "UnknownCommandAction",
+ "type": "object"
+ }
+ ]
+ },
+ "CommandExecutionStatus": {
+ "enum": [
+ "inProgress",
+ "completed",
+ "failed",
+ "declined"
+ ],
+ "type": "string"
+ },
+ "ContentBlock": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/TextContent"
+ },
+ {
+ "$ref": "#/definitions/ImageContent"
+ },
+ {
+ "$ref": "#/definitions/AudioContent"
+ },
+ {
+ "$ref": "#/definitions/ResourceLink"
+ },
+ {
+ "$ref": "#/definitions/EmbeddedResource"
+ }
+ ]
+ },
+ "EmbeddedResource": {
+ "description": "The contents of a resource, embedded into a prompt or tool call result.\n\nIt is up to the client how best to render embedded resources for the benefit of the LLM and/or the user.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "resource": {
+ "$ref": "#/definitions/EmbeddedResourceResource"
+ },
+ "type": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "resource",
+ "type"
+ ],
+ "type": "object"
+ },
+ "EmbeddedResourceResource": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/TextResourceContents"
+ },
+ {
+ "$ref": "#/definitions/BlobResourceContents"
+ }
+ ]
+ },
+ "FileUpdateChange": {
+ "properties": {
+ "diff": {
+ "type": "string"
+ },
+ "kind": {
+ "$ref": "#/definitions/PatchChangeKind"
+ },
+ "path": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "diff",
+ "kind",
+ "path"
+ ],
+ "type": "object"
+ },
+ "ImageContent": {
+ "description": "An image provided to or from an LLM.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "data": {
+ "type": "string"
+ },
+ "mimeType": {
+ "type": "string"
+ },
+ "type": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "data",
+ "mimeType",
+ "type"
+ ],
+ "type": "object"
+ },
+ "McpToolCallError": {
+ "properties": {
+ "message": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "message"
+ ],
+ "type": "object"
+ },
+ "McpToolCallResult": {
+ "properties": {
+ "content": {
+ "items": {
+ "$ref": "#/definitions/ContentBlock"
+ },
+ "type": "array"
+ },
+ "structuredContent": true
+ },
+ "required": [
+ "content"
+ ],
+ "type": "object"
+ },
+ "McpToolCallStatus": {
+ "enum": [
+ "inProgress",
+ "completed",
+ "failed"
+ ],
+ "type": "string"
+ },
+ "PatchApplyStatus": {
+ "enum": [
+ "inProgress",
+ "completed",
+ "failed",
+ "declined"
+ ],
+ "type": "string"
+ },
+ "PatchChangeKind": {
+ "oneOf": [
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "add"
+ ],
+ "title": "AddPatchChangeKindType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "AddPatchChangeKind",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "delete"
+ ],
+ "title": "DeletePatchChangeKindType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "DeletePatchChangeKind",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "move_path": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "update"
+ ],
+ "title": "UpdatePatchChangeKindType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "UpdatePatchChangeKind",
+ "type": "object"
+ }
+ ]
+ },
+ "ResourceLink": {
+ "description": "A resource that the server is capable of reading, included in a prompt or tool call result.\n\nNote: resource links returned by tools are not guaranteed to appear in the results of `resources/list` requests.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "description": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "mimeType": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "name": {
+ "type": "string"
+ },
+ "size": {
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "title": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "type": "string"
+ },
+ "uri": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "type",
+ "uri"
+ ],
+ "type": "object"
+ },
+ "Role": {
+ "description": "The sender or recipient of messages and data in a conversation.",
+ "enum": [
+ "assistant",
+ "user"
+ ],
+ "type": "string"
+ },
+ "TextContent": {
+ "description": "Text provided to or from an LLM.",
+ "properties": {
+ "annotations": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Annotations"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "type": "object"
+ },
+ "TextElement": {
+ "properties": {
+ "byteRange": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/ByteRange"
+ }
+ ],
+ "description": "Byte range in the parent `text` buffer that this element occupies."
+ },
+ "placeholder": {
+ "description": "Optional human-readable placeholder for the element, displayed in the UI.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "byteRange"
+ ],
+ "type": "object"
+ },
+ "TextResourceContents": {
+ "properties": {
+ "mimeType": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "text": {
+ "type": "string"
+ },
+ "uri": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "uri"
+ ],
+ "type": "object"
+ },
+ "ThreadItem": {
+ "oneOf": [
+ {
+ "properties": {
+ "content": {
+ "items": {
+ "$ref": "#/definitions/UserInput"
+ },
+ "type": "array"
+ },
+ "id": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "userMessage"
+ ],
+ "title": "UserMessageThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "content",
+ "id",
+ "type"
+ ],
+ "title": "UserMessageThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "text": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "agentMessage"
+ ],
+ "title": "AgentMessageThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "text",
+ "type"
+ ],
+ "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": {
+ "default": [],
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "id": {
+ "type": "string"
+ },
+ "summary": {
+ "default": [],
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "type": {
+ "enum": [
+ "reasoning"
+ ],
+ "title": "ReasoningThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "type"
+ ],
+ "title": "ReasoningThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "aggregatedOutput": {
+ "description": "The command's output, aggregated from stdout and stderr.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "command": {
+ "description": "The command to be executed.",
+ "type": "string"
+ },
+ "commandActions": {
+ "description": "A best-effort parsing of the command to understand the action(s) it will perform. This returns a list of CommandAction objects because a single shell command may be composed of many commands piped together.",
+ "items": {
+ "$ref": "#/definitions/CommandAction"
+ },
+ "type": "array"
+ },
+ "cwd": {
+ "description": "The command's working directory.",
+ "type": "string"
+ },
+ "durationMs": {
+ "description": "The duration of the command execution in milliseconds.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "exitCode": {
+ "description": "The command's exit code.",
+ "format": "int32",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "id": {
+ "type": "string"
+ },
+ "processId": {
+ "description": "Identifier for the underlying PTY process (when available).",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "status": {
+ "$ref": "#/definitions/CommandExecutionStatus"
+ },
+ "type": {
+ "enum": [
+ "commandExecution"
+ ],
+ "title": "CommandExecutionThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "command",
+ "commandActions",
+ "cwd",
+ "id",
+ "status",
+ "type"
+ ],
+ "title": "CommandExecutionThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "changes": {
+ "items": {
+ "$ref": "#/definitions/FileUpdateChange"
+ },
+ "type": "array"
+ },
+ "id": {
+ "type": "string"
+ },
+ "status": {
+ "$ref": "#/definitions/PatchApplyStatus"
+ },
+ "type": {
+ "enum": [
+ "fileChange"
+ ],
+ "title": "FileChangeThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "changes",
+ "id",
+ "status",
+ "type"
+ ],
+ "title": "FileChangeThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "arguments": true,
+ "durationMs": {
+ "description": "The duration of the MCP tool call in milliseconds.",
+ "format": "int64",
+ "type": [
+ "integer",
+ "null"
+ ]
+ },
+ "error": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/McpToolCallError"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "id": {
+ "type": "string"
+ },
+ "result": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/McpToolCallResult"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "server": {
+ "type": "string"
+ },
+ "status": {
+ "$ref": "#/definitions/McpToolCallStatus"
+ },
+ "tool": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "mcpToolCall"
+ ],
+ "title": "McpToolCallThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "arguments",
+ "id",
+ "server",
+ "status",
+ "tool",
+ "type"
+ ],
+ "title": "McpToolCallThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "agentsStates": {
+ "additionalProperties": {
+ "$ref": "#/definitions/CollabAgentState"
+ },
+ "description": "Last known status of the target agents, when available.",
+ "type": "object"
+ },
+ "id": {
+ "description": "Unique identifier for this collab tool call.",
+ "type": "string"
+ },
+ "prompt": {
+ "description": "Prompt text sent as part of the collab tool call, when available.",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "receiverThreadIds": {
+ "description": "Thread ID of the receiving agent, when applicable. In case of spawn operation, this corresponds to the newly spawned agent.",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "senderThreadId": {
+ "description": "Thread ID of the agent issuing the collab request.",
+ "type": "string"
+ },
+ "status": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/CollabAgentToolCallStatus"
+ }
+ ],
+ "description": "Current status of the collab tool call."
+ },
+ "tool": {
+ "allOf": [
+ {
+ "$ref": "#/definitions/CollabAgentTool"
+ }
+ ],
+ "description": "Name of the collab tool that was invoked."
+ },
+ "type": {
+ "enum": [
+ "collabAgentToolCall"
+ ],
+ "title": "CollabAgentToolCallThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "agentsStates",
+ "id",
+ "receiverThreadIds",
+ "senderThreadId",
+ "status",
+ "tool",
+ "type"
+ ],
+ "title": "CollabAgentToolCallThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "action": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/WebSearchAction"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "id": {
+ "type": "string"
+ },
+ "query": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "webSearch"
+ ],
+ "title": "WebSearchThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "query",
+ "type"
+ ],
+ "title": "WebSearchThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "imageView"
+ ],
+ "title": "ImageViewThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "path",
+ "type"
+ ],
+ "title": "ImageViewThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "review": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "enteredReviewMode"
+ ],
+ "title": "EnteredReviewModeThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "review",
+ "type"
+ ],
+ "title": "EnteredReviewModeThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "review": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "exitedReviewMode"
+ ],
+ "title": "ExitedReviewModeThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "review",
+ "type"
+ ],
+ "title": "ExitedReviewModeThreadItem",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "id": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "contextCompaction"
+ ],
+ "title": "ContextCompactionThreadItemType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "type"
+ ],
+ "title": "ContextCompactionThreadItem",
+ "type": "object"
+ }
+ ]
+ },
+ "Turn": {
+ "properties": {
+ "error": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/TurnError"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Only populated when the Turn's status is failed."
+ },
+ "id": {
+ "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.",
+ "items": {
+ "$ref": "#/definitions/ThreadItem"
+ },
+ "type": "array"
+ },
+ "status": {
+ "$ref": "#/definitions/TurnStatus"
+ }
+ },
+ "required": [
+ "id",
+ "items",
+ "status"
+ ],
+ "type": "object"
+ },
+ "TurnError": {
+ "properties": {
+ "additionalDetails": {
+ "default": null,
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "codexErrorInfo": {
+ "anyOf": [
+ {
+ "$ref": "#/definitions/CodexErrorInfo"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "message": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "message"
+ ],
+ "type": "object"
+ },
+ "TurnStatus": {
+ "enum": [
+ "completed",
+ "interrupted",
+ "failed",
+ "inProgress"
+ ],
+ "type": "string"
+ },
+ "UserInput": {
+ "oneOf": [
+ {
+ "properties": {
+ "text": {
+ "type": "string"
+ },
+ "text_elements": {
+ "default": [],
+ "description": "UI-defined spans within `text` used to render or persist special elements.",
+ "items": {
+ "$ref": "#/definitions/TextElement"
+ },
+ "type": "array"
+ },
+ "type": {
+ "enum": [
+ "text"
+ ],
+ "title": "TextUserInputType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "text",
+ "type"
+ ],
+ "title": "TextUserInput",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "image"
+ ],
+ "title": "ImageUserInputType",
+ "type": "string"
+ },
+ "url": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "url"
+ ],
+ "title": "ImageUserInput",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "localImage"
+ ],
+ "title": "LocalImageUserInputType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "path",
+ "type"
+ ],
+ "title": "LocalImageUserInput",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "name": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "skill"
+ ],
+ "title": "SkillUserInputType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "path",
+ "type"
+ ],
+ "title": "SkillUserInput",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "name": {
+ "type": "string"
+ },
+ "path": {
+ "type": "string"
+ },
+ "type": {
+ "enum": [
+ "mention"
+ ],
+ "title": "MentionUserInputType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "path",
+ "type"
+ ],
+ "title": "MentionUserInput",
+ "type": "object"
+ }
+ ]
+ },
+ "WebSearchAction": {
+ "oneOf": [
+ {
+ "properties": {
+ "queries": {
+ "items": {
+ "type": "string"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "query": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "search"
+ ],
+ "title": "SearchWebSearchActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "SearchWebSearchAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "openPage"
+ ],
+ "title": "OpenPageWebSearchActionType",
+ "type": "string"
+ },
+ "url": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "OpenPageWebSearchAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "pattern": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "type": {
+ "enum": [
+ "findInPage"
+ ],
+ "title": "FindInPageWebSearchActionType",
+ "type": "string"
+ },
+ "url": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "FindInPageWebSearchAction",
+ "type": "object"
+ },
+ {
+ "properties": {
+ "type": {
+ "enum": [
+ "other"
+ ],
+ "title": "OtherWebSearchActionType",
+ "type": "string"
+ }
+ },
+ "required": [
+ "type"
+ ],
+ "title": "OtherWebSearchAction",
+ "type": "object"
+ }
+ ]
+ }
+ },
+ "properties": {
+ "threadId": {
+ "type": "string"
+ },
+ "turn": {
+ "$ref": "#/definitions/Turn"
+ }
+ },
+ "required": [
+ "threadId",
+ "turn"
+ ],
+ "title": "TurnStartedNotification",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/json/v2/WindowsWorldWritableWarningNotification.json b/codex-rs/app-server-protocol/schema/json/v2/WindowsWorldWritableWarningNotification.json
new file mode 100644
index 0000000000..893dbbaf10
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/json/v2/WindowsWorldWritableWarningNotification.json
@@ -0,0 +1,26 @@
+{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "properties": {
+ "extraCount": {
+ "format": "uint",
+ "minimum": 0.0,
+ "type": "integer"
+ },
+ "failedScan": {
+ "type": "boolean"
+ },
+ "samplePaths": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ }
+ },
+ "required": [
+ "extraCount",
+ "failedScan",
+ "samplePaths"
+ ],
+ "title": "WindowsWorldWritableWarningNotification",
+ "type": "object"
+}
\ No newline at end of file
diff --git a/codex-rs/app-server-protocol/schema/typescript/AbsolutePathBuf.ts b/codex-rs/app-server-protocol/schema/typescript/AbsolutePathBuf.ts
new file mode 100644
index 0000000000..dc1cde1241
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/AbsolutePathBuf.ts
@@ -0,0 +1,14 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+/**
+ * A path that is guaranteed to be absolute and normalized (though it is not
+ * guaranteed to be canonicalized or exist on the filesystem).
+ *
+ * IMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set
+ * using [AbsolutePathBufGuard::new]. If no base path is set, the
+ * deserialization will fail unless the path being deserialized is already
+ * absolute.
+ */
+export type AbsolutePathBuf = string;
diff --git a/codex-rs/app-server-protocol/schema/typescript/AddConversationListenerParams.ts b/codex-rs/app-server-protocol/schema/typescript/AddConversationListenerParams.ts
new file mode 100644
index 0000000000..6441bed68a
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/AddConversationListenerParams.ts
@@ -0,0 +1,6 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ThreadId } from "./ThreadId";
+
+export type AddConversationListenerParams = { conversationId: ThreadId, experimentalRawEvents: boolean, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/AddConversationSubscriptionResponse.ts b/codex-rs/app-server-protocol/schema/typescript/AddConversationSubscriptionResponse.ts
new file mode 100644
index 0000000000..f7e34ef658
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/AddConversationSubscriptionResponse.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type AddConversationSubscriptionResponse = { subscriptionId: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/AgentMessageContent.ts b/codex-rs/app-server-protocol/schema/typescript/AgentMessageContent.ts
new file mode 100644
index 0000000000..dc2cfb77e3
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/AgentMessageContent.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type AgentMessageContent = { "type": "Text", text: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/AgentMessageContentDeltaEvent.ts b/codex-rs/app-server-protocol/schema/typescript/AgentMessageContentDeltaEvent.ts
new file mode 100644
index 0000000000..1473a4f2bc
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/AgentMessageContentDeltaEvent.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type AgentMessageContentDeltaEvent = { thread_id: string, turn_id: string, item_id: string, delta: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/AgentMessageDeltaEvent.ts b/codex-rs/app-server-protocol/schema/typescript/AgentMessageDeltaEvent.ts
new file mode 100644
index 0000000000..1e12d85fbb
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/AgentMessageDeltaEvent.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type AgentMessageDeltaEvent = { delta: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/AgentMessageEvent.ts b/codex-rs/app-server-protocol/schema/typescript/AgentMessageEvent.ts
new file mode 100644
index 0000000000..ee436566e0
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/AgentMessageEvent.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type AgentMessageEvent = { message: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/AgentMessageItem.ts b/codex-rs/app-server-protocol/schema/typescript/AgentMessageItem.ts
new file mode 100644
index 0000000000..f884067581
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/AgentMessageItem.ts
@@ -0,0 +1,6 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { AgentMessageContent } from "./AgentMessageContent";
+
+export type AgentMessageItem = { id: string, content: Array, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/AgentReasoningDeltaEvent.ts b/codex-rs/app-server-protocol/schema/typescript/AgentReasoningDeltaEvent.ts
new file mode 100644
index 0000000000..fc2c221937
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/AgentReasoningDeltaEvent.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type AgentReasoningDeltaEvent = { delta: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/AgentReasoningEvent.ts b/codex-rs/app-server-protocol/schema/typescript/AgentReasoningEvent.ts
new file mode 100644
index 0000000000..bf0062cd43
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/AgentReasoningEvent.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type AgentReasoningEvent = { text: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/AgentReasoningRawContentDeltaEvent.ts b/codex-rs/app-server-protocol/schema/typescript/AgentReasoningRawContentDeltaEvent.ts
new file mode 100644
index 0000000000..fcfa816f5d
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/AgentReasoningRawContentDeltaEvent.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type AgentReasoningRawContentDeltaEvent = { delta: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/AgentReasoningRawContentEvent.ts b/codex-rs/app-server-protocol/schema/typescript/AgentReasoningRawContentEvent.ts
new file mode 100644
index 0000000000..364c278229
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/AgentReasoningRawContentEvent.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type AgentReasoningRawContentEvent = { text: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/AgentReasoningSectionBreakEvent.ts b/codex-rs/app-server-protocol/schema/typescript/AgentReasoningSectionBreakEvent.ts
new file mode 100644
index 0000000000..604aceed93
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/AgentReasoningSectionBreakEvent.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type AgentReasoningSectionBreakEvent = { item_id: string, summary_index: bigint, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/AgentStatus.ts b/codex-rs/app-server-protocol/schema/typescript/AgentStatus.ts
new file mode 100644
index 0000000000..ddf6789c78
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/AgentStatus.ts
@@ -0,0 +1,8 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+/**
+ * Agent lifecycle status, derived from emitted events.
+ */
+export type AgentStatus = "pending_init" | "running" | { "completed": string | null } | { "errored": string } | "shutdown" | "not_found";
diff --git a/codex-rs/app-server-protocol/schema/typescript/Annotations.ts b/codex-rs/app-server-protocol/schema/typescript/Annotations.ts
new file mode 100644
index 0000000000..b89cbd725f
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/Annotations.ts
@@ -0,0 +1,9 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { Role } from "./Role";
+
+/**
+ * Optional annotations for the client. The client can use annotations to inform how objects are used or displayed
+ */
+export type Annotations = { audience?: Array, lastModified?: string, priority?: number, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/ApplyPatchApprovalParams.ts b/codex-rs/app-server-protocol/schema/typescript/ApplyPatchApprovalParams.ts
new file mode 100644
index 0000000000..27de027cc6
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/ApplyPatchApprovalParams.ts
@@ -0,0 +1,21 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { FileChange } from "./FileChange";
+import type { ThreadId } from "./ThreadId";
+
+export type ApplyPatchApprovalParams = { conversationId: ThreadId,
+/**
+ * Use to correlate this with [codex_core::protocol::PatchApplyBeginEvent]
+ * and [codex_core::protocol::PatchApplyEndEvent].
+ */
+callId: string, fileChanges: { [key in string]?: FileChange },
+/**
+ * Optional explanatory reason (e.g. request for extra write access).
+ */
+reason: string | null,
+/**
+ * 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).
+ */
+grantRoot: string | null, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/ApplyPatchApprovalRequestEvent.ts b/codex-rs/app-server-protocol/schema/typescript/ApplyPatchApprovalRequestEvent.ts
new file mode 100644
index 0000000000..0c53cf50b8
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/ApplyPatchApprovalRequestEvent.ts
@@ -0,0 +1,23 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { FileChange } from "./FileChange";
+
+export type ApplyPatchApprovalRequestEvent = {
+/**
+ * Responses API call id for the associated patch apply call, if available.
+ */
+call_id: string,
+/**
+ * Turn ID that this patch belongs to.
+ * Uses `#[serde(default)]` for backwards compatibility with older senders.
+ */
+turn_id: string, changes: { [key in string]?: FileChange },
+/**
+ * Optional explanatory reason (e.g. request for extra write access).
+ */
+reason: string | null,
+/**
+ * When set, the agent is asking the user to allow writes under this root for the remainder of the session.
+ */
+grant_root: string | null, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/ApplyPatchApprovalResponse.ts b/codex-rs/app-server-protocol/schema/typescript/ApplyPatchApprovalResponse.ts
new file mode 100644
index 0000000000..e5da8d62db
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/ApplyPatchApprovalResponse.ts
@@ -0,0 +1,6 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ReviewDecision } from "./ReviewDecision";
+
+export type ApplyPatchApprovalResponse = { decision: ReviewDecision, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/ArchiveConversationParams.ts b/codex-rs/app-server-protocol/schema/typescript/ArchiveConversationParams.ts
new file mode 100644
index 0000000000..61fbcc9fc8
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/ArchiveConversationParams.ts
@@ -0,0 +1,6 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ThreadId } from "./ThreadId";
+
+export type ArchiveConversationParams = { conversationId: ThreadId, rolloutPath: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/ArchiveConversationResponse.ts b/codex-rs/app-server-protocol/schema/typescript/ArchiveConversationResponse.ts
new file mode 100644
index 0000000000..24900592b2
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/ArchiveConversationResponse.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type ArchiveConversationResponse = Record;
diff --git a/codex-rs/app-server-protocol/schema/typescript/AskForApproval.ts b/codex-rs/app-server-protocol/schema/typescript/AskForApproval.ts
new file mode 100644
index 0000000000..b21e86fd70
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/AskForApproval.ts
@@ -0,0 +1,9 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+/**
+ * Determines the conditions under which the user is consulted to approve
+ * running the command proposed by Codex.
+ */
+export type AskForApproval = "untrusted" | "on-failure" | "on-request" | "never";
diff --git a/codex-rs/app-server-protocol/schema/typescript/AudioContent.ts b/codex-rs/app-server-protocol/schema/typescript/AudioContent.ts
new file mode 100644
index 0000000000..90dd930c93
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/AudioContent.ts
@@ -0,0 +1,9 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { Annotations } from "./Annotations";
+
+/**
+ * Audio provided to or from an LLM.
+ */
+export type AudioContent = { annotations?: Annotations, data: string, mimeType: string, type: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/AuthMode.ts b/codex-rs/app-server-protocol/schema/typescript/AuthMode.ts
new file mode 100644
index 0000000000..5e0cad8864
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/AuthMode.ts
@@ -0,0 +1,8 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+/**
+ * Authentication mode for OpenAI-backed providers.
+ */
+export type AuthMode = "apikey" | "chatgpt" | "chatgptAuthTokens";
diff --git a/codex-rs/app-server-protocol/schema/typescript/AuthStatusChangeNotification.ts b/codex-rs/app-server-protocol/schema/typescript/AuthStatusChangeNotification.ts
new file mode 100644
index 0000000000..17cb442fe0
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/AuthStatusChangeNotification.ts
@@ -0,0 +1,9 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { AuthMode } from "./AuthMode";
+
+/**
+ * Deprecated notification. Use AccountUpdatedNotification instead.
+ */
+export type AuthStatusChangeNotification = { authMethod: AuthMode | null, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/BackgroundEventEvent.ts b/codex-rs/app-server-protocol/schema/typescript/BackgroundEventEvent.ts
new file mode 100644
index 0000000000..236b1dd888
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/BackgroundEventEvent.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type BackgroundEventEvent = { message: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/BlobResourceContents.ts b/codex-rs/app-server-protocol/schema/typescript/BlobResourceContents.ts
new file mode 100644
index 0000000000..362adcfe14
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/BlobResourceContents.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type BlobResourceContents = { blob: string, mimeType?: string, uri: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/ByteRange.ts b/codex-rs/app-server-protocol/schema/typescript/ByteRange.ts
new file mode 100644
index 0000000000..ab36a79acd
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/ByteRange.ts
@@ -0,0 +1,13 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type ByteRange = {
+/**
+ * Start byte offset (inclusive) within the UTF-8 text buffer.
+ */
+start: number,
+/**
+ * End byte offset (exclusive) within the UTF-8 text buffer.
+ */
+end: number, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/CallToolResult.ts b/codex-rs/app-server-protocol/schema/typescript/CallToolResult.ts
new file mode 100644
index 0000000000..6c6b590d1a
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/CallToolResult.ts
@@ -0,0 +1,10 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ContentBlock } from "./ContentBlock";
+import type { JsonValue } from "./serde_json/JsonValue";
+
+/**
+ * The server's response to a tool call.
+ */
+export type CallToolResult = { content: Array, isError?: boolean, structuredContent?: JsonValue, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/CancelLoginChatGptParams.ts b/codex-rs/app-server-protocol/schema/typescript/CancelLoginChatGptParams.ts
new file mode 100644
index 0000000000..dae8e8c784
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/CancelLoginChatGptParams.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type CancelLoginChatGptParams = { loginId: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/CancelLoginChatGptResponse.ts b/codex-rs/app-server-protocol/schema/typescript/CancelLoginChatGptResponse.ts
new file mode 100644
index 0000000000..004e6f8ea2
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/CancelLoginChatGptResponse.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type CancelLoginChatGptResponse = Record;
diff --git a/codex-rs/app-server-protocol/schema/typescript/ClientInfo.ts b/codex-rs/app-server-protocol/schema/typescript/ClientInfo.ts
new file mode 100644
index 0000000000..33339b6b20
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/ClientInfo.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type ClientInfo = { name: string, title: string | null, version: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/ClientNotification.ts b/codex-rs/app-server-protocol/schema/typescript/ClientNotification.ts
new file mode 100644
index 0000000000..8ce2839108
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/ClientNotification.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type ClientNotification = { "method": "initialized" };
diff --git a/codex-rs/app-server-protocol/schema/typescript/ClientRequest.ts b/codex-rs/app-server-protocol/schema/typescript/ClientRequest.ts
new file mode 100644
index 0000000000..b65d9ee931
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/ClientRequest.ts
@@ -0,0 +1,55 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { AddConversationListenerParams } from "./AddConversationListenerParams";
+import type { ArchiveConversationParams } from "./ArchiveConversationParams";
+import type { CancelLoginChatGptParams } from "./CancelLoginChatGptParams";
+import type { ExecOneOffCommandParams } from "./ExecOneOffCommandParams";
+import type { ForkConversationParams } from "./ForkConversationParams";
+import type { FuzzyFileSearchParams } from "./FuzzyFileSearchParams";
+import type { GetAuthStatusParams } from "./GetAuthStatusParams";
+import type { GetConversationSummaryParams } from "./GetConversationSummaryParams";
+import type { GitDiffToRemoteParams } from "./GitDiffToRemoteParams";
+import type { InitializeParams } from "./InitializeParams";
+import type { InterruptConversationParams } from "./InterruptConversationParams";
+import type { ListConversationsParams } from "./ListConversationsParams";
+import type { LoginApiKeyParams } from "./LoginApiKeyParams";
+import type { NewConversationParams } from "./NewConversationParams";
+import type { RemoveConversationListenerParams } from "./RemoveConversationListenerParams";
+import type { RequestId } from "./RequestId";
+import type { ResumeConversationParams } from "./ResumeConversationParams";
+import type { SendUserMessageParams } from "./SendUserMessageParams";
+import type { SendUserTurnParams } from "./SendUserTurnParams";
+import type { SetDefaultModelParams } from "./SetDefaultModelParams";
+import type { AppsListParams } from "./v2/AppsListParams";
+import type { CancelLoginAccountParams } from "./v2/CancelLoginAccountParams";
+import type { CommandExecParams } from "./v2/CommandExecParams";
+import type { ConfigBatchWriteParams } from "./v2/ConfigBatchWriteParams";
+import type { ConfigReadParams } from "./v2/ConfigReadParams";
+import type { ConfigValueWriteParams } from "./v2/ConfigValueWriteParams";
+import type { FeedbackUploadParams } from "./v2/FeedbackUploadParams";
+import type { GetAccountParams } from "./v2/GetAccountParams";
+import type { ListMcpServerStatusParams } from "./v2/ListMcpServerStatusParams";
+import type { LoginAccountParams } from "./v2/LoginAccountParams";
+import type { McpServerOauthLoginParams } from "./v2/McpServerOauthLoginParams";
+import type { ModelListParams } from "./v2/ModelListParams";
+import type { ReviewStartParams } from "./v2/ReviewStartParams";
+import type { SkillsConfigWriteParams } from "./v2/SkillsConfigWriteParams";
+import type { SkillsListParams } from "./v2/SkillsListParams";
+import type { ThreadArchiveParams } from "./v2/ThreadArchiveParams";
+import type { ThreadForkParams } from "./v2/ThreadForkParams";
+import type { ThreadListParams } from "./v2/ThreadListParams";
+import type { ThreadLoadedListParams } from "./v2/ThreadLoadedListParams";
+import type { ThreadReadParams } from "./v2/ThreadReadParams";
+import type { ThreadResumeParams } from "./v2/ThreadResumeParams";
+import type { ThreadRollbackParams } from "./v2/ThreadRollbackParams";
+import type { ThreadSetNameParams } from "./v2/ThreadSetNameParams";
+import type { ThreadStartParams } from "./v2/ThreadStartParams";
+import type { ThreadUnarchiveParams } from "./v2/ThreadUnarchiveParams";
+import type { TurnInterruptParams } from "./v2/TurnInterruptParams";
+import type { TurnStartParams } from "./v2/TurnStartParams";
+
+/**
+ * Request from the client to the server.
+ */
+export type ClientRequest ={ "method": "initialize", id: RequestId, params: InitializeParams, } | { "method": "thread/start", id: RequestId, params: ThreadStartParams, } | { "method": "thread/resume", id: RequestId, params: ThreadResumeParams, } | { "method": "thread/fork", id: RequestId, params: ThreadForkParams, } | { "method": "thread/archive", id: RequestId, params: ThreadArchiveParams, } | { "method": "thread/name/set", id: RequestId, params: ThreadSetNameParams, } | { "method": "thread/unarchive", id: RequestId, params: ThreadUnarchiveParams, } | { "method": "thread/rollback", id: RequestId, params: ThreadRollbackParams, } | { "method": "thread/list", id: RequestId, params: ThreadListParams, } | { "method": "thread/loaded/list", id: RequestId, params: ThreadLoadedListParams, } | { "method": "thread/read", id: RequestId, params: ThreadReadParams, } | { "method": "skills/list", id: RequestId, params: SkillsListParams, } | { "method": "app/list", id: RequestId, params: AppsListParams, } | { "method": "skills/config/write", id: RequestId, params: SkillsConfigWriteParams, } | { "method": "turn/start", id: RequestId, params: TurnStartParams, } | { "method": "turn/interrupt", id: RequestId, params: TurnInterruptParams, } | { "method": "review/start", id: RequestId, params: ReviewStartParams, } | { "method": "model/list", id: RequestId, params: ModelListParams, } | { "method": "mcpServer/oauth/login", id: RequestId, params: McpServerOauthLoginParams, } | { "method": "config/mcpServer/reload", id: RequestId, params: undefined, } | { "method": "mcpServerStatus/list", id: RequestId, params: ListMcpServerStatusParams, } | { "method": "account/login/start", id: RequestId, params: LoginAccountParams, } | { "method": "account/login/cancel", id: RequestId, params: CancelLoginAccountParams, } | { "method": "account/logout", id: RequestId, params: undefined, } | { "method": "account/rateLimits/read", id: RequestId, params: undefined, } | { "method": "feedback/upload", id: RequestId, params: FeedbackUploadParams, } | { "method": "command/exec", id: RequestId, params: CommandExecParams, } | { "method": "config/read", id: RequestId, params: ConfigReadParams, } | { "method": "config/value/write", id: RequestId, params: ConfigValueWriteParams, } | { "method": "config/batchWrite", id: RequestId, params: ConfigBatchWriteParams, } | { "method": "configRequirements/read", id: RequestId, params: undefined, } | { "method": "account/read", id: RequestId, params: GetAccountParams, } | { "method": "newConversation", id: RequestId, params: NewConversationParams, } | { "method": "getConversationSummary", id: RequestId, params: GetConversationSummaryParams, } | { "method": "listConversations", id: RequestId, params: ListConversationsParams, } | { "method": "resumeConversation", id: RequestId, params: ResumeConversationParams, } | { "method": "forkConversation", id: RequestId, params: ForkConversationParams, } | { "method": "archiveConversation", id: RequestId, params: ArchiveConversationParams, } | { "method": "sendUserMessage", id: RequestId, params: SendUserMessageParams, } | { "method": "sendUserTurn", id: RequestId, params: SendUserTurnParams, } | { "method": "interruptConversation", id: RequestId, params: InterruptConversationParams, } | { "method": "addConversationListener", id: RequestId, params: AddConversationListenerParams, } | { "method": "removeConversationListener", id: RequestId, params: RemoveConversationListenerParams, } | { "method": "gitDiffToRemote", id: RequestId, params: GitDiffToRemoteParams, } | { "method": "loginApiKey", id: RequestId, params: LoginApiKeyParams, } | { "method": "loginChatGpt", id: RequestId, params: undefined, } | { "method": "cancelLoginChatGpt", id: RequestId, params: CancelLoginChatGptParams, } | { "method": "logoutChatGpt", id: RequestId, params: undefined, } | { "method": "getAuthStatus", id: RequestId, params: GetAuthStatusParams, } | { "method": "getUserSavedConfig", id: RequestId, params: undefined, } | { "method": "setDefaultModel", id: RequestId, params: SetDefaultModelParams, } | { "method": "getUserAgent", id: RequestId, params: undefined, } | { "method": "userInfo", id: RequestId, params: undefined, } | { "method": "fuzzyFileSearch", id: RequestId, params: FuzzyFileSearchParams, } | { "method": "execOneOffCommand", id: RequestId, params: ExecOneOffCommandParams, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/CodexErrorInfo.ts b/codex-rs/app-server-protocol/schema/typescript/CodexErrorInfo.ts
new file mode 100644
index 0000000000..20dd2414bb
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/CodexErrorInfo.ts
@@ -0,0 +1,8 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+/**
+ * Codex errors that we expose to clients.
+ */
+export type CodexErrorInfo = "context_window_exceeded" | "usage_limit_exceeded" | { "model_cap": { model: string, reset_after_seconds: bigint | null, } } | { "http_connection_failed": { http_status_code: number | null, } } | { "response_stream_connection_failed": { http_status_code: number | null, } } | "internal_server_error" | "unauthorized" | "bad_request" | "sandbox_error" | { "response_stream_disconnected": { http_status_code: number | null, } } | { "response_too_many_failed_attempts": { http_status_code: number | null, } } | "thread_rollback_failed" | "other";
diff --git a/codex-rs/app-server-protocol/schema/typescript/CollabAgentInteractionBeginEvent.ts b/codex-rs/app-server-protocol/schema/typescript/CollabAgentInteractionBeginEvent.ts
new file mode 100644
index 0000000000..7109741999
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/CollabAgentInteractionBeginEvent.ts
@@ -0,0 +1,23 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ThreadId } from "./ThreadId";
+
+export type CollabAgentInteractionBeginEvent = {
+/**
+ * Identifier for the collab tool call.
+ */
+call_id: string,
+/**
+ * Thread ID of the sender.
+ */
+sender_thread_id: ThreadId,
+/**
+ * Thread ID of the receiver.
+ */
+receiver_thread_id: ThreadId,
+/**
+ * Prompt sent from the sender to the receiver. Can be empty to prevent CoT
+ * leaking at the beginning.
+ */
+prompt: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/CollabAgentInteractionEndEvent.ts b/codex-rs/app-server-protocol/schema/typescript/CollabAgentInteractionEndEvent.ts
new file mode 100644
index 0000000000..0596300b35
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/CollabAgentInteractionEndEvent.ts
@@ -0,0 +1,28 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { AgentStatus } from "./AgentStatus";
+import type { ThreadId } from "./ThreadId";
+
+export type CollabAgentInteractionEndEvent = {
+/**
+ * Identifier for the collab tool call.
+ */
+call_id: string,
+/**
+ * Thread ID of the sender.
+ */
+sender_thread_id: ThreadId,
+/**
+ * Thread ID of the receiver.
+ */
+receiver_thread_id: ThreadId,
+/**
+ * Prompt sent from the sender to the receiver. Can be empty to prevent CoT
+ * leaking at the beginning.
+ */
+prompt: string,
+/**
+ * Last known status of the receiver agent reported to the sender agent.
+ */
+status: AgentStatus, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/CollabAgentSpawnBeginEvent.ts b/codex-rs/app-server-protocol/schema/typescript/CollabAgentSpawnBeginEvent.ts
new file mode 100644
index 0000000000..a86598e20c
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/CollabAgentSpawnBeginEvent.ts
@@ -0,0 +1,19 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ThreadId } from "./ThreadId";
+
+export type CollabAgentSpawnBeginEvent = {
+/**
+ * Identifier for the collab tool call.
+ */
+call_id: string,
+/**
+ * Thread ID of the sender.
+ */
+sender_thread_id: ThreadId,
+/**
+ * Initial prompt sent to the agent. Can be empty to prevent CoT leaking at the
+ * beginning.
+ */
+prompt: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/CollabAgentSpawnEndEvent.ts b/codex-rs/app-server-protocol/schema/typescript/CollabAgentSpawnEndEvent.ts
new file mode 100644
index 0000000000..e880b5a401
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/CollabAgentSpawnEndEvent.ts
@@ -0,0 +1,28 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { AgentStatus } from "./AgentStatus";
+import type { ThreadId } from "./ThreadId";
+
+export type CollabAgentSpawnEndEvent = {
+/**
+ * Identifier for the collab tool call.
+ */
+call_id: string,
+/**
+ * Thread ID of the sender.
+ */
+sender_thread_id: ThreadId,
+/**
+ * Thread ID of the newly spawned agent, if it was created.
+ */
+new_thread_id: ThreadId | null,
+/**
+ * Initial prompt sent to the agent. Can be empty to prevent CoT leaking at the
+ * beginning.
+ */
+prompt: string,
+/**
+ * Last known status of the new agent reported to the sender agent.
+ */
+status: AgentStatus, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/CollabCloseBeginEvent.ts b/codex-rs/app-server-protocol/schema/typescript/CollabCloseBeginEvent.ts
new file mode 100644
index 0000000000..355d59523a
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/CollabCloseBeginEvent.ts
@@ -0,0 +1,18 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ThreadId } from "./ThreadId";
+
+export type CollabCloseBeginEvent = {
+/**
+ * Identifier for the collab tool call.
+ */
+call_id: string,
+/**
+ * Thread ID of the sender.
+ */
+sender_thread_id: ThreadId,
+/**
+ * Thread ID of the receiver.
+ */
+receiver_thread_id: ThreadId, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/CollabCloseEndEvent.ts b/codex-rs/app-server-protocol/schema/typescript/CollabCloseEndEvent.ts
new file mode 100644
index 0000000000..70343cbe4d
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/CollabCloseEndEvent.ts
@@ -0,0 +1,24 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { AgentStatus } from "./AgentStatus";
+import type { ThreadId } from "./ThreadId";
+
+export type CollabCloseEndEvent = {
+/**
+ * Identifier for the collab tool call.
+ */
+call_id: string,
+/**
+ * Thread ID of the sender.
+ */
+sender_thread_id: ThreadId,
+/**
+ * Thread ID of the receiver.
+ */
+receiver_thread_id: ThreadId,
+/**
+ * Last known status of the receiver agent reported to the sender agent before
+ * the close.
+ */
+status: AgentStatus, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/CollabWaitingBeginEvent.ts b/codex-rs/app-server-protocol/schema/typescript/CollabWaitingBeginEvent.ts
new file mode 100644
index 0000000000..0cbe04f62b
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/CollabWaitingBeginEvent.ts
@@ -0,0 +1,18 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ThreadId } from "./ThreadId";
+
+export type CollabWaitingBeginEvent = {
+/**
+ * Thread ID of the sender.
+ */
+sender_thread_id: ThreadId,
+/**
+ * Thread ID of the receivers.
+ */
+receiver_thread_ids: Array,
+/**
+ * ID of the waiting call.
+ */
+call_id: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/CollabWaitingEndEvent.ts b/codex-rs/app-server-protocol/schema/typescript/CollabWaitingEndEvent.ts
new file mode 100644
index 0000000000..57f914c134
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/CollabWaitingEndEvent.ts
@@ -0,0 +1,19 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { AgentStatus } from "./AgentStatus";
+import type { ThreadId } from "./ThreadId";
+
+export type CollabWaitingEndEvent = {
+/**
+ * Thread ID of the sender.
+ */
+sender_thread_id: ThreadId,
+/**
+ * ID of the waiting call.
+ */
+call_id: string,
+/**
+ * Last known status of the receiver agents reported to the sender agent.
+ */
+statuses: { [key in ThreadId]?: AgentStatus }, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/CollaborationMode.ts b/codex-rs/app-server-protocol/schema/typescript/CollaborationMode.ts
new file mode 100644
index 0000000000..0f60f5d104
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/CollaborationMode.ts
@@ -0,0 +1,10 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ModeKind } from "./ModeKind";
+import type { Settings } from "./Settings";
+
+/**
+ * Collaboration mode for a Codex session.
+ */
+export type CollaborationMode = { mode: ModeKind, settings: Settings, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/CollaborationModeMask.ts b/codex-rs/app-server-protocol/schema/typescript/CollaborationModeMask.ts
new file mode 100644
index 0000000000..05902676d7
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/CollaborationModeMask.ts
@@ -0,0 +1,11 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ModeKind } from "./ModeKind";
+import type { ReasoningEffort } from "./ReasoningEffort";
+
+/**
+ * A mask for collaboration mode settings, allowing partial updates.
+ * All fields except `name` are optional, enabling selective updates.
+ */
+export type CollaborationModeMask = { name: string, mode: ModeKind | null, model: string | null, reasoning_effort: ReasoningEffort | null | null, developer_instructions: string | null | null, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/ContentBlock.ts b/codex-rs/app-server-protocol/schema/typescript/ContentBlock.ts
new file mode 100644
index 0000000000..2dd62d87b4
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/ContentBlock.ts
@@ -0,0 +1,10 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { AudioContent } from "./AudioContent";
+import type { EmbeddedResource } from "./EmbeddedResource";
+import type { ImageContent } from "./ImageContent";
+import type { ResourceLink } from "./ResourceLink";
+import type { TextContent } from "./TextContent";
+
+export type ContentBlock = TextContent | ImageContent | AudioContent | ResourceLink | EmbeddedResource;
diff --git a/codex-rs/app-server-protocol/schema/typescript/ContentItem.ts b/codex-rs/app-server-protocol/schema/typescript/ContentItem.ts
new file mode 100644
index 0000000000..c89b9d78a4
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/ContentItem.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type ContentItem = { "type": "input_text", text: string, } | { "type": "input_image", image_url: string, } | { "type": "output_text", text: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/ContextCompactedEvent.ts b/codex-rs/app-server-protocol/schema/typescript/ContextCompactedEvent.ts
new file mode 100644
index 0000000000..538ca7a1bc
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/ContextCompactedEvent.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type ContextCompactedEvent = null;
diff --git a/codex-rs/app-server-protocol/schema/typescript/ContextCompactionItem.ts b/codex-rs/app-server-protocol/schema/typescript/ContextCompactionItem.ts
new file mode 100644
index 0000000000..dc3ab6388e
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/ContextCompactionItem.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type ContextCompactionItem = { id: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/ConversationGitInfo.ts b/codex-rs/app-server-protocol/schema/typescript/ConversationGitInfo.ts
new file mode 100644
index 0000000000..ff0da8383a
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/ConversationGitInfo.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type ConversationGitInfo = { sha: string | null, branch: string | null, origin_url: string | null, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/ConversationSummary.ts b/codex-rs/app-server-protocol/schema/typescript/ConversationSummary.ts
new file mode 100644
index 0000000000..2cc2a05706
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/ConversationSummary.ts
@@ -0,0 +1,8 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ConversationGitInfo } from "./ConversationGitInfo";
+import type { SessionSource } from "./SessionSource";
+import type { ThreadId } from "./ThreadId";
+
+export type ConversationSummary = { conversationId: ThreadId, path: string, preview: string, timestamp: string | null, updatedAt: string | null, modelProvider: string, cwd: string, cliVersion: string, source: SessionSource, gitInfo: ConversationGitInfo | null, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/CreditsSnapshot.ts b/codex-rs/app-server-protocol/schema/typescript/CreditsSnapshot.ts
new file mode 100644
index 0000000000..737bf99bef
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/CreditsSnapshot.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type CreditsSnapshot = { has_credits: boolean, unlimited: boolean, balance: string | null, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/CustomPrompt.ts b/codex-rs/app-server-protocol/schema/typescript/CustomPrompt.ts
new file mode 100644
index 0000000000..96fe75e969
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/CustomPrompt.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type CustomPrompt = { name: string, path: string, content: string, description: string | null, argument_hint: string | null, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/DeprecationNoticeEvent.ts b/codex-rs/app-server-protocol/schema/typescript/DeprecationNoticeEvent.ts
new file mode 100644
index 0000000000..c1a7d81314
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/DeprecationNoticeEvent.ts
@@ -0,0 +1,13 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type DeprecationNoticeEvent = {
+/**
+ * Concise summary of what is deprecated.
+ */
+summary: string,
+/**
+ * Optional extra guidance, such as migration steps or rationale.
+ */
+details: string | null, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/DynamicToolCallRequest.ts b/codex-rs/app-server-protocol/schema/typescript/DynamicToolCallRequest.ts
new file mode 100644
index 0000000000..94b0c65c66
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/DynamicToolCallRequest.ts
@@ -0,0 +1,6 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { JsonValue } from "./serde_json/JsonValue";
+
+export type DynamicToolCallRequest = { callId: string, turnId: string, tool: string, arguments: JsonValue, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/ElicitationRequestEvent.ts b/codex-rs/app-server-protocol/schema/typescript/ElicitationRequestEvent.ts
new file mode 100644
index 0000000000..a4d641fd44
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/ElicitationRequestEvent.ts
@@ -0,0 +1,6 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { RequestId } from "./RequestId";
+
+export type ElicitationRequestEvent = { server_name: string, id: RequestId, message: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/EmbeddedResource.ts b/codex-rs/app-server-protocol/schema/typescript/EmbeddedResource.ts
new file mode 100644
index 0000000000..1b81e37ab1
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/EmbeddedResource.ts
@@ -0,0 +1,13 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { Annotations } from "./Annotations";
+import type { EmbeddedResourceResource } from "./EmbeddedResourceResource";
+
+/**
+ * The contents of a resource, embedded into a prompt or tool call result.
+ *
+ * It is up to the client how best to render embedded resources for the benefit
+ * of the LLM and/or the user.
+ */
+export type EmbeddedResource = { annotations?: Annotations, resource: EmbeddedResourceResource, type: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/EmbeddedResourceResource.ts b/codex-rs/app-server-protocol/schema/typescript/EmbeddedResourceResource.ts
new file mode 100644
index 0000000000..58f70f6e82
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/EmbeddedResourceResource.ts
@@ -0,0 +1,7 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { BlobResourceContents } from "./BlobResourceContents";
+import type { TextResourceContents } from "./TextResourceContents";
+
+export type EmbeddedResourceResource = TextResourceContents | BlobResourceContents;
diff --git a/codex-rs/app-server-protocol/schema/typescript/ErrorEvent.ts b/codex-rs/app-server-protocol/schema/typescript/ErrorEvent.ts
new file mode 100644
index 0000000000..fafde767e0
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/ErrorEvent.ts
@@ -0,0 +1,6 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { CodexErrorInfo } from "./CodexErrorInfo";
+
+export type ErrorEvent = { message: string, codex_error_info: CodexErrorInfo | null, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/EventMsg.ts b/codex-rs/app-server-protocol/schema/typescript/EventMsg.ts
new file mode 100644
index 0000000000..5f158de2cb
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/EventMsg.ts
@@ -0,0 +1,73 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { AgentMessageContentDeltaEvent } from "./AgentMessageContentDeltaEvent";
+import type { AgentMessageDeltaEvent } from "./AgentMessageDeltaEvent";
+import type { AgentMessageEvent } from "./AgentMessageEvent";
+import type { AgentReasoningDeltaEvent } from "./AgentReasoningDeltaEvent";
+import type { AgentReasoningEvent } from "./AgentReasoningEvent";
+import type { AgentReasoningRawContentDeltaEvent } from "./AgentReasoningRawContentDeltaEvent";
+import type { AgentReasoningRawContentEvent } from "./AgentReasoningRawContentEvent";
+import type { AgentReasoningSectionBreakEvent } from "./AgentReasoningSectionBreakEvent";
+import type { ApplyPatchApprovalRequestEvent } from "./ApplyPatchApprovalRequestEvent";
+import type { BackgroundEventEvent } from "./BackgroundEventEvent";
+import type { CollabAgentInteractionBeginEvent } from "./CollabAgentInteractionBeginEvent";
+import type { CollabAgentInteractionEndEvent } from "./CollabAgentInteractionEndEvent";
+import type { CollabAgentSpawnBeginEvent } from "./CollabAgentSpawnBeginEvent";
+import type { CollabAgentSpawnEndEvent } from "./CollabAgentSpawnEndEvent";
+import type { CollabCloseBeginEvent } from "./CollabCloseBeginEvent";
+import type { CollabCloseEndEvent } from "./CollabCloseEndEvent";
+import type { CollabWaitingBeginEvent } from "./CollabWaitingBeginEvent";
+import type { CollabWaitingEndEvent } from "./CollabWaitingEndEvent";
+import type { ContextCompactedEvent } from "./ContextCompactedEvent";
+import type { DeprecationNoticeEvent } from "./DeprecationNoticeEvent";
+import type { DynamicToolCallRequest } from "./DynamicToolCallRequest";
+import type { ElicitationRequestEvent } from "./ElicitationRequestEvent";
+import type { ErrorEvent } from "./ErrorEvent";
+import type { ExecApprovalRequestEvent } from "./ExecApprovalRequestEvent";
+import type { ExecCommandBeginEvent } from "./ExecCommandBeginEvent";
+import type { ExecCommandEndEvent } from "./ExecCommandEndEvent";
+import type { ExecCommandOutputDeltaEvent } from "./ExecCommandOutputDeltaEvent";
+import type { ExitedReviewModeEvent } from "./ExitedReviewModeEvent";
+import type { GetHistoryEntryResponseEvent } from "./GetHistoryEntryResponseEvent";
+import type { ItemCompletedEvent } from "./ItemCompletedEvent";
+import type { ItemStartedEvent } from "./ItemStartedEvent";
+import type { ListCustomPromptsResponseEvent } from "./ListCustomPromptsResponseEvent";
+import type { ListSkillsResponseEvent } from "./ListSkillsResponseEvent";
+import type { McpListToolsResponseEvent } from "./McpListToolsResponseEvent";
+import type { McpStartupCompleteEvent } from "./McpStartupCompleteEvent";
+import type { McpStartupUpdateEvent } from "./McpStartupUpdateEvent";
+import type { McpToolCallBeginEvent } from "./McpToolCallBeginEvent";
+import type { McpToolCallEndEvent } from "./McpToolCallEndEvent";
+import type { PatchApplyBeginEvent } from "./PatchApplyBeginEvent";
+import type { PatchApplyEndEvent } from "./PatchApplyEndEvent";
+import type { PlanDeltaEvent } from "./PlanDeltaEvent";
+import type { RawResponseItemEvent } from "./RawResponseItemEvent";
+import type { ReasoningContentDeltaEvent } from "./ReasoningContentDeltaEvent";
+import type { ReasoningRawContentDeltaEvent } from "./ReasoningRawContentDeltaEvent";
+import type { RequestUserInputEvent } from "./RequestUserInputEvent";
+import type { ReviewRequest } from "./ReviewRequest";
+import type { SessionConfiguredEvent } from "./SessionConfiguredEvent";
+import type { StreamErrorEvent } from "./StreamErrorEvent";
+import type { TerminalInteractionEvent } from "./TerminalInteractionEvent";
+import type { ThreadNameUpdatedEvent } from "./ThreadNameUpdatedEvent";
+import type { ThreadRolledBackEvent } from "./ThreadRolledBackEvent";
+import type { TokenCountEvent } from "./TokenCountEvent";
+import type { TurnAbortedEvent } from "./TurnAbortedEvent";
+import type { TurnCompleteEvent } from "./TurnCompleteEvent";
+import type { TurnDiffEvent } from "./TurnDiffEvent";
+import type { TurnStartedEvent } from "./TurnStartedEvent";
+import type { UndoCompletedEvent } from "./UndoCompletedEvent";
+import type { UndoStartedEvent } from "./UndoStartedEvent";
+import type { UpdatePlanArgs } from "./UpdatePlanArgs";
+import type { UserMessageEvent } from "./UserMessageEvent";
+import type { ViewImageToolCallEvent } from "./ViewImageToolCallEvent";
+import type { WarningEvent } from "./WarningEvent";
+import type { WebSearchBeginEvent } from "./WebSearchBeginEvent";
+import type { WebSearchEndEvent } from "./WebSearchEndEvent";
+
+/**
+ * Response event from the agent
+ * NOTE: Make sure none of these values have optional types, as it will mess up the extension code-gen.
+ */
+export type EventMsg = { "type": "error" } & ErrorEvent | { "type": "warning" } & WarningEvent | { "type": "context_compacted" } & ContextCompactedEvent | { "type": "thread_rolled_back" } & ThreadRolledBackEvent | { "type": "task_started" } & TurnStartedEvent | { "type": "task_complete" } & TurnCompleteEvent | { "type": "token_count" } & TokenCountEvent | { "type": "agent_message" } & AgentMessageEvent | { "type": "user_message" } & UserMessageEvent | { "type": "agent_message_delta" } & AgentMessageDeltaEvent | { "type": "agent_reasoning" } & AgentReasoningEvent | { "type": "agent_reasoning_delta" } & AgentReasoningDeltaEvent | { "type": "agent_reasoning_raw_content" } & AgentReasoningRawContentEvent | { "type": "agent_reasoning_raw_content_delta" } & AgentReasoningRawContentDeltaEvent | { "type": "agent_reasoning_section_break" } & AgentReasoningSectionBreakEvent | { "type": "session_configured" } & SessionConfiguredEvent | { "type": "thread_name_updated" } & ThreadNameUpdatedEvent | { "type": "mcp_startup_update" } & McpStartupUpdateEvent | { "type": "mcp_startup_complete" } & McpStartupCompleteEvent | { "type": "mcp_tool_call_begin" } & McpToolCallBeginEvent | { "type": "mcp_tool_call_end" } & McpToolCallEndEvent | { "type": "web_search_begin" } & WebSearchBeginEvent | { "type": "web_search_end" } & WebSearchEndEvent | { "type": "exec_command_begin" } & ExecCommandBeginEvent | { "type": "exec_command_output_delta" } & ExecCommandOutputDeltaEvent | { "type": "terminal_interaction" } & TerminalInteractionEvent | { "type": "exec_command_end" } & ExecCommandEndEvent | { "type": "view_image_tool_call" } & ViewImageToolCallEvent | { "type": "exec_approval_request" } & ExecApprovalRequestEvent | { "type": "request_user_input" } & RequestUserInputEvent | { "type": "dynamic_tool_call_request" } & DynamicToolCallRequest | { "type": "elicitation_request" } & ElicitationRequestEvent | { "type": "apply_patch_approval_request" } & ApplyPatchApprovalRequestEvent | { "type": "deprecation_notice" } & DeprecationNoticeEvent | { "type": "background_event" } & BackgroundEventEvent | { "type": "undo_started" } & UndoStartedEvent | { "type": "undo_completed" } & UndoCompletedEvent | { "type": "stream_error" } & StreamErrorEvent | { "type": "patch_apply_begin" } & PatchApplyBeginEvent | { "type": "patch_apply_end" } & PatchApplyEndEvent | { "type": "turn_diff" } & TurnDiffEvent | { "type": "get_history_entry_response" } & GetHistoryEntryResponseEvent | { "type": "mcp_list_tools_response" } & McpListToolsResponseEvent | { "type": "list_custom_prompts_response" } & ListCustomPromptsResponseEvent | { "type": "list_skills_response" } & ListSkillsResponseEvent | { "type": "skills_update_available" } | { "type": "plan_update" } & UpdatePlanArgs | { "type": "turn_aborted" } & TurnAbortedEvent | { "type": "shutdown_complete" } | { "type": "entered_review_mode" } & ReviewRequest | { "type": "exited_review_mode" } & ExitedReviewModeEvent | { "type": "raw_response_item" } & RawResponseItemEvent | { "type": "item_started" } & ItemStartedEvent | { "type": "item_completed" } & ItemCompletedEvent | { "type": "agent_message_content_delta" } & AgentMessageContentDeltaEvent | { "type": "plan_delta" } & PlanDeltaEvent | { "type": "reasoning_content_delta" } & ReasoningContentDeltaEvent | { "type": "reasoning_raw_content_delta" } & ReasoningRawContentDeltaEvent | { "type": "collab_agent_spawn_begin" } & CollabAgentSpawnBeginEvent | { "type": "collab_agent_spawn_end" } & CollabAgentSpawnEndEvent | { "type": "collab_agent_interaction_begin" } & CollabAgentInteractionBeginEvent | { "type": "collab_agent_interaction_end" } & CollabAgentInteractionEndEvent | { "type": "collab_waiting_begin" } & CollabWaitingBeginEvent | { "type": "collab_waiting_end" } & CollabWaitingEndEvent | { "type": "collab_close_begin" } & CollabCloseBeginEvent | { "type": "collab_close_end" } & CollabCloseEndEvent;
diff --git a/codex-rs/app-server-protocol/schema/typescript/ExecApprovalRequestEvent.ts b/codex-rs/app-server-protocol/schema/typescript/ExecApprovalRequestEvent.ts
new file mode 100644
index 0000000000..66db8fd40a
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/ExecApprovalRequestEvent.ts
@@ -0,0 +1,32 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ExecPolicyAmendment } from "./ExecPolicyAmendment";
+import type { ParsedCommand } from "./ParsedCommand";
+
+export type ExecApprovalRequestEvent = {
+/**
+ * Identifier for the associated exec call, if available.
+ */
+call_id: string,
+/**
+ * Turn ID that this command belongs to.
+ * Uses `#[serde(default)]` for backwards compatibility.
+ */
+turn_id: string,
+/**
+ * The command to be executed.
+ */
+command: Array,
+/**
+ * The command's working directory.
+ */
+cwd: string,
+/**
+ * Optional human-readable reason for the approval (e.g. retry without sandbox).
+ */
+reason: string | null,
+/**
+ * Proposed execpolicy amendment that can be applied to allow future runs.
+ */
+proposed_execpolicy_amendment?: ExecPolicyAmendment, parsed_cmd: Array, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/ExecCommandApprovalParams.ts b/codex-rs/app-server-protocol/schema/typescript/ExecCommandApprovalParams.ts
new file mode 100644
index 0000000000..b427337a84
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/ExecCommandApprovalParams.ts
@@ -0,0 +1,12 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ParsedCommand } from "./ParsedCommand";
+import type { ThreadId } from "./ThreadId";
+
+export type ExecCommandApprovalParams = { conversationId: ThreadId,
+/**
+ * Use to correlate this with [codex_core::protocol::ExecCommandBeginEvent]
+ * and [codex_core::protocol::ExecCommandEndEvent].
+ */
+callId: string, command: Array, cwd: string, reason: string | null, parsedCmd: Array, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/ExecCommandApprovalResponse.ts b/codex-rs/app-server-protocol/schema/typescript/ExecCommandApprovalResponse.ts
new file mode 100644
index 0000000000..ce1a521614
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/ExecCommandApprovalResponse.ts
@@ -0,0 +1,6 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ReviewDecision } from "./ReviewDecision";
+
+export type ExecCommandApprovalResponse = { decision: ReviewDecision, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/ExecCommandBeginEvent.ts b/codex-rs/app-server-protocol/schema/typescript/ExecCommandBeginEvent.ts
new file mode 100644
index 0000000000..a9b4bc9393
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/ExecCommandBeginEvent.ts
@@ -0,0 +1,35 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ExecCommandSource } from "./ExecCommandSource";
+import type { ParsedCommand } from "./ParsedCommand";
+
+export type ExecCommandBeginEvent = {
+/**
+ * Identifier so this can be paired with the ExecCommandEnd event.
+ */
+call_id: string,
+/**
+ * Identifier for the underlying PTY process (when available).
+ */
+process_id?: string,
+/**
+ * Turn ID that this command belongs to.
+ */
+turn_id: string,
+/**
+ * The command to be executed.
+ */
+command: Array,
+/**
+ * The command's working directory if not the default cwd for the agent.
+ */
+cwd: string, parsed_cmd: Array,
+/**
+ * Where the command originated. Defaults to Agent for backward compatibility.
+ */
+source: ExecCommandSource,
+/**
+ * Raw input sent to a unified exec session (if this is an interaction event).
+ */
+interaction_input?: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/ExecCommandEndEvent.ts b/codex-rs/app-server-protocol/schema/typescript/ExecCommandEndEvent.ts
new file mode 100644
index 0000000000..c9b465e45a
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/ExecCommandEndEvent.ts
@@ -0,0 +1,59 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ExecCommandSource } from "./ExecCommandSource";
+import type { ParsedCommand } from "./ParsedCommand";
+
+export type ExecCommandEndEvent = {
+/**
+ * Identifier for the ExecCommandBegin that finished.
+ */
+call_id: string,
+/**
+ * Identifier for the underlying PTY process (when available).
+ */
+process_id?: string,
+/**
+ * Turn ID that this command belongs to.
+ */
+turn_id: string,
+/**
+ * The command that was executed.
+ */
+command: Array,
+/**
+ * The command's working directory if not the default cwd for the agent.
+ */
+cwd: string, parsed_cmd: Array,
+/**
+ * Where the command originated. Defaults to Agent for backward compatibility.
+ */
+source: ExecCommandSource,
+/**
+ * Raw input sent to a unified exec session (if this is an interaction event).
+ */
+interaction_input?: string,
+/**
+ * Captured stdout
+ */
+stdout: string,
+/**
+ * Captured stderr
+ */
+stderr: string,
+/**
+ * Captured aggregated output
+ */
+aggregated_output: string,
+/**
+ * The command's exit code.
+ */
+exit_code: number,
+/**
+ * The duration of the command execution.
+ */
+duration: string,
+/**
+ * Formatted output from the command, as seen by the model.
+ */
+formatted_output: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/ExecCommandOutputDeltaEvent.ts b/codex-rs/app-server-protocol/schema/typescript/ExecCommandOutputDeltaEvent.ts
new file mode 100644
index 0000000000..0930bdd827
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/ExecCommandOutputDeltaEvent.ts
@@ -0,0 +1,18 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ExecOutputStream } from "./ExecOutputStream";
+
+export type ExecCommandOutputDeltaEvent = {
+/**
+ * Identifier for the ExecCommandBegin that produced this chunk.
+ */
+call_id: string,
+/**
+ * Which stream produced this chunk.
+ */
+stream: ExecOutputStream,
+/**
+ * Raw bytes from the stream (may not be valid UTF-8).
+ */
+chunk: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/ExecCommandSource.ts b/codex-rs/app-server-protocol/schema/typescript/ExecCommandSource.ts
new file mode 100644
index 0000000000..b665441bc2
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/ExecCommandSource.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type ExecCommandSource = "agent" | "user_shell" | "unified_exec_startup" | "unified_exec_interaction";
diff --git a/codex-rs/app-server-protocol/schema/typescript/ExecOneOffCommandParams.ts b/codex-rs/app-server-protocol/schema/typescript/ExecOneOffCommandParams.ts
new file mode 100644
index 0000000000..ca28ad775c
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/ExecOneOffCommandParams.ts
@@ -0,0 +1,6 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { SandboxPolicy } from "./SandboxPolicy";
+
+export type ExecOneOffCommandParams = { command: Array, timeoutMs: bigint | null, cwd: string | null, sandboxPolicy: SandboxPolicy | null, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/ExecOneOffCommandResponse.ts b/codex-rs/app-server-protocol/schema/typescript/ExecOneOffCommandResponse.ts
new file mode 100644
index 0000000000..ff43ec4ca2
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/ExecOneOffCommandResponse.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type ExecOneOffCommandResponse = { exitCode: number, stdout: string, stderr: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/ExecOutputStream.ts b/codex-rs/app-server-protocol/schema/typescript/ExecOutputStream.ts
new file mode 100644
index 0000000000..96aa74483d
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/ExecOutputStream.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type ExecOutputStream = "stdout" | "stderr";
diff --git a/codex-rs/app-server-protocol/schema/typescript/ExecPolicyAmendment.ts b/codex-rs/app-server-protocol/schema/typescript/ExecPolicyAmendment.ts
new file mode 100644
index 0000000000..98e2626c38
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/ExecPolicyAmendment.ts
@@ -0,0 +1,12 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+/**
+ * Proposed execpolicy change to allow commands starting with this prefix.
+ *
+ * The `command` tokens form the prefix that would be added as an execpolicy
+ * `prefix_rule(..., decision="allow")`, letting the agent bypass approval for
+ * commands that start with this token sequence.
+ */
+export type ExecPolicyAmendment = Array;
diff --git a/codex-rs/app-server-protocol/schema/typescript/ExitedReviewModeEvent.ts b/codex-rs/app-server-protocol/schema/typescript/ExitedReviewModeEvent.ts
new file mode 100644
index 0000000000..7271f07a3f
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/ExitedReviewModeEvent.ts
@@ -0,0 +1,6 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ReviewOutputEvent } from "./ReviewOutputEvent";
+
+export type ExitedReviewModeEvent = { review_output: ReviewOutputEvent | null, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/FileChange.ts b/codex-rs/app-server-protocol/schema/typescript/FileChange.ts
new file mode 100644
index 0000000000..8eaac9e8d7
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/FileChange.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type FileChange = { "type": "add", content: string, } | { "type": "delete", content: string, } | { "type": "update", unified_diff: string, move_path: string | null, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/ForcedLoginMethod.ts b/codex-rs/app-server-protocol/schema/typescript/ForcedLoginMethod.ts
new file mode 100644
index 0000000000..c695908866
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/ForcedLoginMethod.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type ForcedLoginMethod = "chatgpt" | "api";
diff --git a/codex-rs/app-server-protocol/schema/typescript/ForkConversationParams.ts b/codex-rs/app-server-protocol/schema/typescript/ForkConversationParams.ts
new file mode 100644
index 0000000000..4ca548fbff
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/ForkConversationParams.ts
@@ -0,0 +1,7 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { NewConversationParams } from "./NewConversationParams";
+import type { ThreadId } from "./ThreadId";
+
+export type ForkConversationParams = { path: string | null, conversationId: ThreadId | null, overrides: NewConversationParams | null, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/ForkConversationResponse.ts b/codex-rs/app-server-protocol/schema/typescript/ForkConversationResponse.ts
new file mode 100644
index 0000000000..80d6e7947c
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/ForkConversationResponse.ts
@@ -0,0 +1,7 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { EventMsg } from "./EventMsg";
+import type { ThreadId } from "./ThreadId";
+
+export type ForkConversationResponse = { conversationId: ThreadId, model: string, initialMessages: Array | null, rolloutPath: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/FunctionCallOutputContentItem.ts b/codex-rs/app-server-protocol/schema/typescript/FunctionCallOutputContentItem.ts
new file mode 100644
index 0000000000..8bfb6993d0
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/FunctionCallOutputContentItem.ts
@@ -0,0 +1,9 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+/**
+ * Responses API compatible content items that can be returned by a tool call.
+ * This is a subset of ContentItem with the types we support as function call outputs.
+ */
+export type FunctionCallOutputContentItem = { "type": "input_text", text: string, } | { "type": "input_image", image_url: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/FunctionCallOutputPayload.ts b/codex-rs/app-server-protocol/schema/typescript/FunctionCallOutputPayload.ts
new file mode 100644
index 0000000000..776369b10f
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/FunctionCallOutputPayload.ts
@@ -0,0 +1,15 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { FunctionCallOutputContentItem } from "./FunctionCallOutputContentItem";
+
+/**
+ * The payload we send back to OpenAI when reporting a tool call result.
+ *
+ * `content` preserves the historical plain-string payload so downstream
+ * integrations (tests, logging, etc.) can keep treating tool output as
+ * `String`. When an MCP server returns richer data we additionally populate
+ * `content_items` with the structured form that the Responses/Chat
+ * Completions APIs understand.
+ */
+export type FunctionCallOutputPayload = { content: string, content_items: Array | null, success: boolean | null, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/FuzzyFileSearchParams.ts b/codex-rs/app-server-protocol/schema/typescript/FuzzyFileSearchParams.ts
new file mode 100644
index 0000000000..02a7a7cfdf
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/FuzzyFileSearchParams.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type FuzzyFileSearchParams = { query: string, roots: Array, cancellationToken: string | null, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/FuzzyFileSearchResponse.ts b/codex-rs/app-server-protocol/schema/typescript/FuzzyFileSearchResponse.ts
new file mode 100644
index 0000000000..276b94764b
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/FuzzyFileSearchResponse.ts
@@ -0,0 +1,6 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { FuzzyFileSearchResult } from "./FuzzyFileSearchResult";
+
+export type FuzzyFileSearchResponse = { files: Array, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/FuzzyFileSearchResult.ts b/codex-rs/app-server-protocol/schema/typescript/FuzzyFileSearchResult.ts
new file mode 100644
index 0000000000..e841dbfa04
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/FuzzyFileSearchResult.ts
@@ -0,0 +1,8 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+/**
+ * Superset of [`codex_file_search::FileMatch`]
+ */
+export type FuzzyFileSearchResult = { root: string, path: string, file_name: string, score: number, indices: Array | null, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/GetAuthStatusParams.ts b/codex-rs/app-server-protocol/schema/typescript/GetAuthStatusParams.ts
new file mode 100644
index 0000000000..f185a43718
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/GetAuthStatusParams.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type GetAuthStatusParams = { includeToken: boolean | null, refreshToken: boolean | null, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/GetAuthStatusResponse.ts b/codex-rs/app-server-protocol/schema/typescript/GetAuthStatusResponse.ts
new file mode 100644
index 0000000000..9a050f4124
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/GetAuthStatusResponse.ts
@@ -0,0 +1,6 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { AuthMode } from "./AuthMode";
+
+export type GetAuthStatusResponse = { authMethod: AuthMode | null, authToken: string | null, requiresOpenaiAuth: boolean | null, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/GetConversationSummaryParams.ts b/codex-rs/app-server-protocol/schema/typescript/GetConversationSummaryParams.ts
new file mode 100644
index 0000000000..4e0005430d
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/GetConversationSummaryParams.ts
@@ -0,0 +1,6 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ThreadId } from "./ThreadId";
+
+export type GetConversationSummaryParams = { rolloutPath: string, } | { conversationId: ThreadId, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/GetConversationSummaryResponse.ts b/codex-rs/app-server-protocol/schema/typescript/GetConversationSummaryResponse.ts
new file mode 100644
index 0000000000..d3dee5d621
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/GetConversationSummaryResponse.ts
@@ -0,0 +1,6 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ConversationSummary } from "./ConversationSummary";
+
+export type GetConversationSummaryResponse = { summary: ConversationSummary, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/GetHistoryEntryResponseEvent.ts b/codex-rs/app-server-protocol/schema/typescript/GetHistoryEntryResponseEvent.ts
new file mode 100644
index 0000000000..d46019c1dc
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/GetHistoryEntryResponseEvent.ts
@@ -0,0 +1,10 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { HistoryEntry } from "./HistoryEntry";
+
+export type GetHistoryEntryResponseEvent = { offset: number, log_id: bigint,
+/**
+ * The entry at the requested offset, if available and parseable.
+ */
+entry: HistoryEntry | null, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/GetUserAgentResponse.ts b/codex-rs/app-server-protocol/schema/typescript/GetUserAgentResponse.ts
new file mode 100644
index 0000000000..a74aba5da6
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/GetUserAgentResponse.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type GetUserAgentResponse = { userAgent: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/GetUserSavedConfigResponse.ts b/codex-rs/app-server-protocol/schema/typescript/GetUserSavedConfigResponse.ts
new file mode 100644
index 0000000000..f8dcf2e67c
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/GetUserSavedConfigResponse.ts
@@ -0,0 +1,6 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { UserSavedConfig } from "./UserSavedConfig";
+
+export type GetUserSavedConfigResponse = { config: UserSavedConfig, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/GhostCommit.ts b/codex-rs/app-server-protocol/schema/typescript/GhostCommit.ts
new file mode 100644
index 0000000000..d7b927492b
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/GhostCommit.ts
@@ -0,0 +1,8 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+/**
+ * Details of a ghost commit created from a repository state.
+ */
+export type GhostCommit = { id: string, parent: string | null, preexisting_untracked_files: Array, preexisting_untracked_dirs: Array, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/GitDiffToRemoteParams.ts b/codex-rs/app-server-protocol/schema/typescript/GitDiffToRemoteParams.ts
new file mode 100644
index 0000000000..535aad3c29
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/GitDiffToRemoteParams.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type GitDiffToRemoteParams = { cwd: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/GitDiffToRemoteResponse.ts b/codex-rs/app-server-protocol/schema/typescript/GitDiffToRemoteResponse.ts
new file mode 100644
index 0000000000..ec6c151510
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/GitDiffToRemoteResponse.ts
@@ -0,0 +1,6 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { GitSha } from "./GitSha";
+
+export type GitDiffToRemoteResponse = { sha: GitSha, diff: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/GitSha.ts b/codex-rs/app-server-protocol/schema/typescript/GitSha.ts
new file mode 100644
index 0000000000..701b75aa0b
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/GitSha.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type GitSha = string;
diff --git a/codex-rs/app-server-protocol/schema/typescript/HistoryEntry.ts b/codex-rs/app-server-protocol/schema/typescript/HistoryEntry.ts
new file mode 100644
index 0000000000..da5bc37c21
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/HistoryEntry.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type HistoryEntry = { conversation_id: string, ts: bigint, text: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/ImageContent.ts b/codex-rs/app-server-protocol/schema/typescript/ImageContent.ts
new file mode 100644
index 0000000000..0537639c02
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/ImageContent.ts
@@ -0,0 +1,9 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { Annotations } from "./Annotations";
+
+/**
+ * An image provided to or from an LLM.
+ */
+export type ImageContent = { annotations?: Annotations, data: string, mimeType: string, type: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/InitializeCapabilities.ts b/codex-rs/app-server-protocol/schema/typescript/InitializeCapabilities.ts
new file mode 100644
index 0000000000..24f5302627
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/InitializeCapabilities.ts
@@ -0,0 +1,12 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+/**
+ * Client-declared capabilities negotiated during initialize.
+ */
+export type InitializeCapabilities = {
+/**
+ * Opt into receiving experimental API methods and fields.
+ */
+experimentalApi: boolean, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/InitializeParams.ts b/codex-rs/app-server-protocol/schema/typescript/InitializeParams.ts
new file mode 100644
index 0000000000..e48c5ee7b5
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/InitializeParams.ts
@@ -0,0 +1,7 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ClientInfo } from "./ClientInfo";
+import type { InitializeCapabilities } from "./InitializeCapabilities";
+
+export type InitializeParams = { clientInfo: ClientInfo, capabilities: InitializeCapabilities | null, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/InitializeResponse.ts b/codex-rs/app-server-protocol/schema/typescript/InitializeResponse.ts
new file mode 100644
index 0000000000..8a6bec66ef
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/InitializeResponse.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type InitializeResponse = { userAgent: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/InputItem.ts b/codex-rs/app-server-protocol/schema/typescript/InputItem.ts
new file mode 100644
index 0000000000..3ac72d31d8
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/InputItem.ts
@@ -0,0 +1,10 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { TextElement } from "./TextElement";
+
+export type InputItem = { "type": "text", "data": { text: string,
+/**
+ * UI-defined spans within `text` used to render or persist special elements.
+ */
+text_elements: Array, } } | { "type": "image", "data": { image_url: string, } } | { "type": "localImage", "data": { path: string, } };
diff --git a/codex-rs/app-server-protocol/schema/typescript/InterruptConversationParams.ts b/codex-rs/app-server-protocol/schema/typescript/InterruptConversationParams.ts
new file mode 100644
index 0000000000..8db162c97c
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/InterruptConversationParams.ts
@@ -0,0 +1,6 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ThreadId } from "./ThreadId";
+
+export type InterruptConversationParams = { conversationId: ThreadId, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/InterruptConversationResponse.ts b/codex-rs/app-server-protocol/schema/typescript/InterruptConversationResponse.ts
new file mode 100644
index 0000000000..375604eef3
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/InterruptConversationResponse.ts
@@ -0,0 +1,6 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { TurnAbortReason } from "./TurnAbortReason";
+
+export type InterruptConversationResponse = { abortReason: TurnAbortReason, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/ItemCompletedEvent.ts b/codex-rs/app-server-protocol/schema/typescript/ItemCompletedEvent.ts
new file mode 100644
index 0000000000..97de348dff
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/ItemCompletedEvent.ts
@@ -0,0 +1,7 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ThreadId } from "./ThreadId";
+import type { TurnItem } from "./TurnItem";
+
+export type ItemCompletedEvent = { thread_id: ThreadId, turn_id: string, item: TurnItem, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/ItemStartedEvent.ts b/codex-rs/app-server-protocol/schema/typescript/ItemStartedEvent.ts
new file mode 100644
index 0000000000..e82f78f965
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/ItemStartedEvent.ts
@@ -0,0 +1,7 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ThreadId } from "./ThreadId";
+import type { TurnItem } from "./TurnItem";
+
+export type ItemStartedEvent = { thread_id: ThreadId, turn_id: string, item: TurnItem, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/ListConversationsParams.ts b/codex-rs/app-server-protocol/schema/typescript/ListConversationsParams.ts
new file mode 100644
index 0000000000..27c9f3172a
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/ListConversationsParams.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type ListConversationsParams = { pageSize: number | null, cursor: string | null, modelProviders: Array | null, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/ListConversationsResponse.ts b/codex-rs/app-server-protocol/schema/typescript/ListConversationsResponse.ts
new file mode 100644
index 0000000000..0e26443a5f
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/ListConversationsResponse.ts
@@ -0,0 +1,6 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ConversationSummary } from "./ConversationSummary";
+
+export type ListConversationsResponse = { items: Array, nextCursor: string | null, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/ListCustomPromptsResponseEvent.ts b/codex-rs/app-server-protocol/schema/typescript/ListCustomPromptsResponseEvent.ts
new file mode 100644
index 0000000000..9ebb43afb7
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/ListCustomPromptsResponseEvent.ts
@@ -0,0 +1,9 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { CustomPrompt } from "./CustomPrompt";
+
+/**
+ * Response payload for `Op::ListCustomPrompts`.
+ */
+export type ListCustomPromptsResponseEvent = { custom_prompts: Array, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/ListSkillsResponseEvent.ts b/codex-rs/app-server-protocol/schema/typescript/ListSkillsResponseEvent.ts
new file mode 100644
index 0000000000..efdd547596
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/ListSkillsResponseEvent.ts
@@ -0,0 +1,9 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { SkillsListEntry } from "./SkillsListEntry";
+
+/**
+ * Response payload for `Op::ListSkills`.
+ */
+export type ListSkillsResponseEvent = { skills: Array, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/LocalShellAction.ts b/codex-rs/app-server-protocol/schema/typescript/LocalShellAction.ts
new file mode 100644
index 0000000000..b24847dc4e
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/LocalShellAction.ts
@@ -0,0 +1,6 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { LocalShellExecAction } from "./LocalShellExecAction";
+
+export type LocalShellAction = { "type": "exec" } & LocalShellExecAction;
diff --git a/codex-rs/app-server-protocol/schema/typescript/LocalShellExecAction.ts b/codex-rs/app-server-protocol/schema/typescript/LocalShellExecAction.ts
new file mode 100644
index 0000000000..10d4133639
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/LocalShellExecAction.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type LocalShellExecAction = { command: Array, timeout_ms: bigint | null, working_directory: string | null, env: { [key in string]?: string } | null, user: string | null, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/LocalShellStatus.ts b/codex-rs/app-server-protocol/schema/typescript/LocalShellStatus.ts
new file mode 100644
index 0000000000..00db484ad6
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/LocalShellStatus.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type LocalShellStatus = "completed" | "in_progress" | "incomplete";
diff --git a/codex-rs/app-server-protocol/schema/typescript/LoginApiKeyParams.ts b/codex-rs/app-server-protocol/schema/typescript/LoginApiKeyParams.ts
new file mode 100644
index 0000000000..3638553d3e
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/LoginApiKeyParams.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type LoginApiKeyParams = { apiKey: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/LoginApiKeyResponse.ts b/codex-rs/app-server-protocol/schema/typescript/LoginApiKeyResponse.ts
new file mode 100644
index 0000000000..a67347aeb7
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/LoginApiKeyResponse.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type LoginApiKeyResponse = Record;
diff --git a/codex-rs/app-server-protocol/schema/typescript/LoginChatGptCompleteNotification.ts b/codex-rs/app-server-protocol/schema/typescript/LoginChatGptCompleteNotification.ts
new file mode 100644
index 0000000000..82c07bfa2d
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/LoginChatGptCompleteNotification.ts
@@ -0,0 +1,8 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+/**
+ * Deprecated in favor of AccountLoginCompletedNotification.
+ */
+export type LoginChatGptCompleteNotification = { loginId: string, success: boolean, error: string | null, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/LoginChatGptResponse.ts b/codex-rs/app-server-protocol/schema/typescript/LoginChatGptResponse.ts
new file mode 100644
index 0000000000..4147280117
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/LoginChatGptResponse.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type LoginChatGptResponse = { loginId: string, authUrl: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/LogoutChatGptResponse.ts b/codex-rs/app-server-protocol/schema/typescript/LogoutChatGptResponse.ts
new file mode 100644
index 0000000000..ad5dbd9105
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/LogoutChatGptResponse.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type LogoutChatGptResponse = Record;
diff --git a/codex-rs/app-server-protocol/schema/typescript/McpAuthStatus.ts b/codex-rs/app-server-protocol/schema/typescript/McpAuthStatus.ts
new file mode 100644
index 0000000000..919ae85fd0
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/McpAuthStatus.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type McpAuthStatus = "unsupported" | "not_logged_in" | "bearer_token" | "o_auth";
diff --git a/codex-rs/app-server-protocol/schema/typescript/McpInvocation.ts b/codex-rs/app-server-protocol/schema/typescript/McpInvocation.ts
new file mode 100644
index 0000000000..5b7103a60c
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/McpInvocation.ts
@@ -0,0 +1,18 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { JsonValue } from "./serde_json/JsonValue";
+
+export type McpInvocation = {
+/**
+ * Name of the MCP server as defined in the config.
+ */
+server: string,
+/**
+ * Name of the tool as given by the MCP server.
+ */
+tool: string,
+/**
+ * Arguments to the tool call.
+ */
+arguments: JsonValue | null, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/McpListToolsResponseEvent.ts b/codex-rs/app-server-protocol/schema/typescript/McpListToolsResponseEvent.ts
new file mode 100644
index 0000000000..945959431a
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/McpListToolsResponseEvent.ts
@@ -0,0 +1,25 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { McpAuthStatus } from "./McpAuthStatus";
+import type { Resource } from "./Resource";
+import type { ResourceTemplate } from "./ResourceTemplate";
+import type { Tool } from "./Tool";
+
+export type McpListToolsResponseEvent = {
+/**
+ * Fully qualified tool name -> tool definition.
+ */
+tools: { [key in string]?: Tool },
+/**
+ * Known resources grouped by server name.
+ */
+resources: { [key in string]?: Array },
+/**
+ * Known resource templates grouped by server name.
+ */
+resource_templates: { [key in string]?: Array },
+/**
+ * Authentication status for each configured MCP server.
+ */
+auth_statuses: { [key in string]?: McpAuthStatus }, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/McpStartupCompleteEvent.ts b/codex-rs/app-server-protocol/schema/typescript/McpStartupCompleteEvent.ts
new file mode 100644
index 0000000000..67354adfbe
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/McpStartupCompleteEvent.ts
@@ -0,0 +1,6 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { McpStartupFailure } from "./McpStartupFailure";
+
+export type McpStartupCompleteEvent = { ready: Array, failed: Array, cancelled: Array, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/McpStartupFailure.ts b/codex-rs/app-server-protocol/schema/typescript/McpStartupFailure.ts
new file mode 100644
index 0000000000..b12009b15b
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/McpStartupFailure.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type McpStartupFailure = { server: string, error: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/McpStartupStatus.ts b/codex-rs/app-server-protocol/schema/typescript/McpStartupStatus.ts
new file mode 100644
index 0000000000..48c08226f4
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/McpStartupStatus.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type McpStartupStatus = { "state": "starting" } | { "state": "ready" } | { "state": "failed", error: string, } | { "state": "cancelled" };
diff --git a/codex-rs/app-server-protocol/schema/typescript/McpStartupUpdateEvent.ts b/codex-rs/app-server-protocol/schema/typescript/McpStartupUpdateEvent.ts
new file mode 100644
index 0000000000..ecfe7d551e
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/McpStartupUpdateEvent.ts
@@ -0,0 +1,14 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { McpStartupStatus } from "./McpStartupStatus";
+
+export type McpStartupUpdateEvent = {
+/**
+ * Server name being started.
+ */
+server: string,
+/**
+ * Current startup status.
+ */
+status: McpStartupStatus, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/McpToolCallBeginEvent.ts b/codex-rs/app-server-protocol/schema/typescript/McpToolCallBeginEvent.ts
new file mode 100644
index 0000000000..feb7ca7c21
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/McpToolCallBeginEvent.ts
@@ -0,0 +1,10 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { McpInvocation } from "./McpInvocation";
+
+export type McpToolCallBeginEvent = {
+/**
+ * Identifier so this can be paired with the McpToolCallEnd event.
+ */
+call_id: string, invocation: McpInvocation, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/McpToolCallEndEvent.ts b/codex-rs/app-server-protocol/schema/typescript/McpToolCallEndEvent.ts
new file mode 100644
index 0000000000..0ca82b2bc6
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/McpToolCallEndEvent.ts
@@ -0,0 +1,15 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { CallToolResult } from "./CallToolResult";
+import type { McpInvocation } from "./McpInvocation";
+
+export type McpToolCallEndEvent = {
+/**
+ * Identifier for the corresponding McpToolCallBegin that finished.
+ */
+call_id: string, invocation: McpInvocation, duration: string,
+/**
+ * Result of the tool call. Note this could be an error.
+ */
+result: { Ok : CallToolResult } | { Err : string }, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/ModeKind.ts b/codex-rs/app-server-protocol/schema/typescript/ModeKind.ts
new file mode 100644
index 0000000000..246d440c91
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/ModeKind.ts
@@ -0,0 +1,8 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+/**
+ * Initial collaboration mode to use when the TUI starts.
+ */
+export type ModeKind = "plan" | "code" | "pair_programming" | "execute" | "custom";
diff --git a/codex-rs/app-server-protocol/schema/typescript/NetworkAccess.ts b/codex-rs/app-server-protocol/schema/typescript/NetworkAccess.ts
new file mode 100644
index 0000000000..f259e67b99
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/NetworkAccess.ts
@@ -0,0 +1,8 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+/**
+ * Represents whether outbound network access is available to the agent.
+ */
+export type NetworkAccess = "restricted" | "enabled";
diff --git a/codex-rs/app-server-protocol/schema/typescript/NewConversationParams.ts b/codex-rs/app-server-protocol/schema/typescript/NewConversationParams.ts
new file mode 100644
index 0000000000..e1113c27e2
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/NewConversationParams.ts
@@ -0,0 +1,8 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { AskForApproval } from "./AskForApproval";
+import type { SandboxMode } from "./SandboxMode";
+import type { JsonValue } from "./serde_json/JsonValue";
+
+export type NewConversationParams = { model: string | null, modelProvider: string | null, profile: string | null, cwd: string | null, approvalPolicy: AskForApproval | null, sandbox: SandboxMode | null, config: { [key in string]?: JsonValue } | null, baseInstructions: string | null, developerInstructions: string | null, compactPrompt: string | null, includeApplyPatchTool: boolean | null, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/NewConversationResponse.ts b/codex-rs/app-server-protocol/schema/typescript/NewConversationResponse.ts
new file mode 100644
index 0000000000..608c2ac110
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/NewConversationResponse.ts
@@ -0,0 +1,7 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ReasoningEffort } from "./ReasoningEffort";
+import type { ThreadId } from "./ThreadId";
+
+export type NewConversationResponse = { conversationId: ThreadId, model: string, reasoningEffort: ReasoningEffort | null, rolloutPath: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/ParsedCommand.ts b/codex-rs/app-server-protocol/schema/typescript/ParsedCommand.ts
new file mode 100644
index 0000000000..146d7816c2
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/ParsedCommand.ts
@@ -0,0 +1,12 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type ParsedCommand = { "type": "read", cmd: string, name: string,
+/**
+ * (Best effort) Path to the file being read by the command. When
+ * possible, this is an absolute path, though when relative, it should
+ * be resolved against the `cwd`` that will be used to run the command
+ * to derive the absolute path.
+ */
+path: string, } | { "type": "list_files", cmd: string, path: string | null, } | { "type": "search", cmd: string, query: string | null, path: string | null, } | { "type": "unknown", cmd: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/PatchApplyBeginEvent.ts b/codex-rs/app-server-protocol/schema/typescript/PatchApplyBeginEvent.ts
new file mode 100644
index 0000000000..19ff0d5754
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/PatchApplyBeginEvent.ts
@@ -0,0 +1,23 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { FileChange } from "./FileChange";
+
+export type PatchApplyBeginEvent = {
+/**
+ * Identifier so this can be paired with the PatchApplyEnd event.
+ */
+call_id: string,
+/**
+ * Turn ID that this patch belongs to.
+ * Uses `#[serde(default)]` for backwards compatibility.
+ */
+turn_id: string,
+/**
+ * If true, there was no ApplyPatchApprovalRequest for this patch.
+ */
+auto_approved: boolean,
+/**
+ * The changes to be applied.
+ */
+changes: { [key in string]?: FileChange }, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/PatchApplyEndEvent.ts b/codex-rs/app-server-protocol/schema/typescript/PatchApplyEndEvent.ts
new file mode 100644
index 0000000000..d52940af1c
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/PatchApplyEndEvent.ts
@@ -0,0 +1,31 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { FileChange } from "./FileChange";
+
+export type PatchApplyEndEvent = {
+/**
+ * Identifier for the PatchApplyBegin that finished.
+ */
+call_id: string,
+/**
+ * Turn ID that this patch belongs to.
+ * Uses `#[serde(default)]` for backwards compatibility.
+ */
+turn_id: string,
+/**
+ * Captured stdout (summary printed by apply_patch).
+ */
+stdout: string,
+/**
+ * Captured stderr (parser errors, IO failures, etc.).
+ */
+stderr: string,
+/**
+ * Whether the patch was applied successfully.
+ */
+success: boolean,
+/**
+ * The changes that were applied (mirrors PatchApplyBeginEvent::changes).
+ */
+changes: { [key in string]?: FileChange }, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/Personality.ts b/codex-rs/app-server-protocol/schema/typescript/Personality.ts
new file mode 100644
index 0000000000..b9ccad4dc2
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/Personality.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type Personality = "friendly" | "pragmatic";
diff --git a/codex-rs/app-server-protocol/schema/typescript/PlanDeltaEvent.ts b/codex-rs/app-server-protocol/schema/typescript/PlanDeltaEvent.ts
new file mode 100644
index 0000000000..f2ff588442
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/PlanDeltaEvent.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type PlanDeltaEvent = { thread_id: string, turn_id: string, item_id: string, delta: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/PlanItem.ts b/codex-rs/app-server-protocol/schema/typescript/PlanItem.ts
new file mode 100644
index 0000000000..909ab40e64
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/PlanItem.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type PlanItem = { id: string, text: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/PlanItemArg.ts b/codex-rs/app-server-protocol/schema/typescript/PlanItemArg.ts
new file mode 100644
index 0000000000..a9c8acfa75
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/PlanItemArg.ts
@@ -0,0 +1,6 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { StepStatus } from "./StepStatus";
+
+export type PlanItemArg = { step: string, status: StepStatus, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/PlanType.ts b/codex-rs/app-server-protocol/schema/typescript/PlanType.ts
new file mode 100644
index 0000000000..9f622d0f1b
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/PlanType.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type PlanType = "free" | "go" | "plus" | "pro" | "team" | "business" | "enterprise" | "edu" | "unknown";
diff --git a/codex-rs/app-server-protocol/schema/typescript/Profile.ts b/codex-rs/app-server-protocol/schema/typescript/Profile.ts
new file mode 100644
index 0000000000..53d16e4a33
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/Profile.ts
@@ -0,0 +1,9 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { AskForApproval } from "./AskForApproval";
+import type { ReasoningEffort } from "./ReasoningEffort";
+import type { ReasoningSummary } from "./ReasoningSummary";
+import type { Verbosity } from "./Verbosity";
+
+export type Profile = { model: string | null, modelProvider: string | null, approvalPolicy: AskForApproval | null, modelReasoningEffort: ReasoningEffort | null, modelReasoningSummary: ReasoningSummary | null, modelVerbosity: Verbosity | null, chatgptBaseUrl: string | null, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/RateLimitSnapshot.ts b/codex-rs/app-server-protocol/schema/typescript/RateLimitSnapshot.ts
new file mode 100644
index 0000000000..9c2dad7f09
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/RateLimitSnapshot.ts
@@ -0,0 +1,8 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { CreditsSnapshot } from "./CreditsSnapshot";
+import type { PlanType } from "./PlanType";
+import type { RateLimitWindow } from "./RateLimitWindow";
+
+export type RateLimitSnapshot = { primary: RateLimitWindow | null, secondary: RateLimitWindow | null, credits: CreditsSnapshot | null, plan_type: PlanType | null, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/RateLimitWindow.ts b/codex-rs/app-server-protocol/schema/typescript/RateLimitWindow.ts
new file mode 100644
index 0000000000..4a85062bf7
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/RateLimitWindow.ts
@@ -0,0 +1,17 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type RateLimitWindow = {
+/**
+ * Percentage (0-100) of the window that has been consumed.
+ */
+used_percent: number,
+/**
+ * Rolling window duration, in minutes.
+ */
+window_minutes: number | null,
+/**
+ * Unix timestamp (seconds since epoch) when the window resets.
+ */
+resets_at: number | null, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/RawResponseItemEvent.ts b/codex-rs/app-server-protocol/schema/typescript/RawResponseItemEvent.ts
new file mode 100644
index 0000000000..62dd4f0018
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/RawResponseItemEvent.ts
@@ -0,0 +1,6 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ResponseItem } from "./ResponseItem";
+
+export type RawResponseItemEvent = { item: ResponseItem, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/ReasoningContentDeltaEvent.ts b/codex-rs/app-server-protocol/schema/typescript/ReasoningContentDeltaEvent.ts
new file mode 100644
index 0000000000..70dfc01d24
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/ReasoningContentDeltaEvent.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type ReasoningContentDeltaEvent = { thread_id: string, turn_id: string, item_id: string, delta: string, summary_index: bigint, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/ReasoningEffort.ts b/codex-rs/app-server-protocol/schema/typescript/ReasoningEffort.ts
new file mode 100644
index 0000000000..c0798f43a3
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/ReasoningEffort.ts
@@ -0,0 +1,8 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+/**
+ * See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#get-started-with-reasoning
+ */
+export type ReasoningEffort = "none" | "minimal" | "low" | "medium" | "high" | "xhigh";
diff --git a/codex-rs/app-server-protocol/schema/typescript/ReasoningItem.ts b/codex-rs/app-server-protocol/schema/typescript/ReasoningItem.ts
new file mode 100644
index 0000000000..80bcb65fd1
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/ReasoningItem.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type ReasoningItem = { id: string, summary_text: Array, raw_content: Array, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/ReasoningItemContent.ts b/codex-rs/app-server-protocol/schema/typescript/ReasoningItemContent.ts
new file mode 100644
index 0000000000..fd533796fe
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/ReasoningItemContent.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type ReasoningItemContent = { "type": "reasoning_text", text: string, } | { "type": "text", text: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/ReasoningItemReasoningSummary.ts b/codex-rs/app-server-protocol/schema/typescript/ReasoningItemReasoningSummary.ts
new file mode 100644
index 0000000000..f01a88a0c0
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/ReasoningItemReasoningSummary.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type ReasoningItemReasoningSummary = { "type": "summary_text", text: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/ReasoningRawContentDeltaEvent.ts b/codex-rs/app-server-protocol/schema/typescript/ReasoningRawContentDeltaEvent.ts
new file mode 100644
index 0000000000..ef3a792caf
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/ReasoningRawContentDeltaEvent.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type ReasoningRawContentDeltaEvent = { thread_id: string, turn_id: string, item_id: string, delta: string, content_index: bigint, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/ReasoningSummary.ts b/codex-rs/app-server-protocol/schema/typescript/ReasoningSummary.ts
new file mode 100644
index 0000000000..d246ac12ec
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/ReasoningSummary.ts
@@ -0,0 +1,10 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+/**
+ * A summary of the reasoning performed by the model. This can be useful for
+ * debugging and understanding the model's reasoning process.
+ * See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#reasoning-summaries
+ */
+export type ReasoningSummary = "auto" | "concise" | "detailed" | "none";
diff --git a/codex-rs/app-server-protocol/schema/typescript/RemoveConversationListenerParams.ts b/codex-rs/app-server-protocol/schema/typescript/RemoveConversationListenerParams.ts
new file mode 100644
index 0000000000..e9628b6341
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/RemoveConversationListenerParams.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type RemoveConversationListenerParams = { subscriptionId: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/RemoveConversationSubscriptionResponse.ts b/codex-rs/app-server-protocol/schema/typescript/RemoveConversationSubscriptionResponse.ts
new file mode 100644
index 0000000000..8053d7e4b4
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/RemoveConversationSubscriptionResponse.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type RemoveConversationSubscriptionResponse = Record;
diff --git a/codex-rs/app-server-protocol/schema/typescript/RequestId.ts b/codex-rs/app-server-protocol/schema/typescript/RequestId.ts
new file mode 100644
index 0000000000..8a771bd021
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/RequestId.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type RequestId = string | number;
diff --git a/codex-rs/app-server-protocol/schema/typescript/RequestUserInputEvent.ts b/codex-rs/app-server-protocol/schema/typescript/RequestUserInputEvent.ts
new file mode 100644
index 0000000000..8ea6453de9
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/RequestUserInputEvent.ts
@@ -0,0 +1,15 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { RequestUserInputQuestion } from "./RequestUserInputQuestion";
+
+export type RequestUserInputEvent = {
+/**
+ * Responses API call id for the associated tool call, if available.
+ */
+call_id: string,
+/**
+ * Turn ID that this request belongs to.
+ * Uses `#[serde(default)]` for backwards compatibility.
+ */
+turn_id: string, questions: Array, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/RequestUserInputQuestion.ts b/codex-rs/app-server-protocol/schema/typescript/RequestUserInputQuestion.ts
new file mode 100644
index 0000000000..2a68f7b4c8
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/RequestUserInputQuestion.ts
@@ -0,0 +1,6 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { RequestUserInputQuestionOption } from "./RequestUserInputQuestionOption";
+
+export type RequestUserInputQuestion = { id: string, header: string, question: string, isOther: boolean, isSecret: boolean, options: Array | null, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/RequestUserInputQuestionOption.ts b/codex-rs/app-server-protocol/schema/typescript/RequestUserInputQuestionOption.ts
new file mode 100644
index 0000000000..b2d2a0db48
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/RequestUserInputQuestionOption.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type RequestUserInputQuestionOption = { label: string, description: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/Resource.ts b/codex-rs/app-server-protocol/schema/typescript/Resource.ts
new file mode 100644
index 0000000000..238cd9008c
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/Resource.ts
@@ -0,0 +1,9 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { Annotations } from "./Annotations";
+
+/**
+ * A known resource that the server is capable of reading.
+ */
+export type Resource = { annotations?: Annotations, description?: string, mimeType?: string, name: string, size?: bigint, title?: string, uri: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/ResourceLink.ts b/codex-rs/app-server-protocol/schema/typescript/ResourceLink.ts
new file mode 100644
index 0000000000..fe934c3a5d
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/ResourceLink.ts
@@ -0,0 +1,11 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { Annotations } from "./Annotations";
+
+/**
+ * A resource that the server is capable of reading, included in a prompt or tool call result.
+ *
+ * Note: resource links returned by tools are not guaranteed to appear in the results of `resources/list` requests.
+ */
+export type ResourceLink = { annotations?: Annotations, description?: string, mimeType?: string, name: string, size?: bigint, title?: string, type: string, uri: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/ResourceTemplate.ts b/codex-rs/app-server-protocol/schema/typescript/ResourceTemplate.ts
new file mode 100644
index 0000000000..03c9a116c8
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/ResourceTemplate.ts
@@ -0,0 +1,9 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { Annotations } from "./Annotations";
+
+/**
+ * A template description for resources available on the server.
+ */
+export type ResourceTemplate = { annotations?: Annotations, description?: string, mimeType?: string, name: string, title?: string, uriTemplate: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/ResponseItem.ts b/codex-rs/app-server-protocol/schema/typescript/ResponseItem.ts
new file mode 100644
index 0000000000..d720021612
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/ResponseItem.ts
@@ -0,0 +1,17 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ContentItem } from "./ContentItem";
+import type { FunctionCallOutputPayload } from "./FunctionCallOutputPayload";
+import type { GhostCommit } from "./GhostCommit";
+import type { LocalShellAction } from "./LocalShellAction";
+import type { LocalShellStatus } from "./LocalShellStatus";
+import type { ReasoningItemContent } from "./ReasoningItemContent";
+import type { ReasoningItemReasoningSummary } from "./ReasoningItemReasoningSummary";
+import type { WebSearchAction } from "./WebSearchAction";
+
+export type ResponseItem = { "type": "message", role: string, content: Array, end_turn?: boolean, } | { "type": "reasoning", summary: Array, content?: Array, encrypted_content: string | null, } | { "type": "local_shell_call",
+/**
+ * Set when using the Responses API.
+ */
+call_id: string | null, status: LocalShellStatus, action: LocalShellAction, } | { "type": "function_call", name: string, arguments: string, call_id: string, } | { "type": "function_call_output", call_id: string, output: FunctionCallOutputPayload, } | { "type": "custom_tool_call", status?: string, call_id: string, name: string, input: string, } | { "type": "custom_tool_call_output", call_id: string, output: string, } | { "type": "web_search_call", status?: string, action?: WebSearchAction, } | { "type": "ghost_snapshot", ghost_commit: GhostCommit, } | { "type": "compaction", encrypted_content: string, } | { "type": "other" };
diff --git a/codex-rs/app-server-protocol/schema/typescript/ResumeConversationParams.ts b/codex-rs/app-server-protocol/schema/typescript/ResumeConversationParams.ts
new file mode 100644
index 0000000000..f2fe9d47c8
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/ResumeConversationParams.ts
@@ -0,0 +1,8 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { NewConversationParams } from "./NewConversationParams";
+import type { ResponseItem } from "./ResponseItem";
+import type { ThreadId } from "./ThreadId";
+
+export type ResumeConversationParams = { path: string | null, conversationId: ThreadId | null, history: Array | null, overrides: NewConversationParams | null, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/ResumeConversationResponse.ts b/codex-rs/app-server-protocol/schema/typescript/ResumeConversationResponse.ts
new file mode 100644
index 0000000000..1af5b68599
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/ResumeConversationResponse.ts
@@ -0,0 +1,7 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { EventMsg } from "./EventMsg";
+import type { ThreadId } from "./ThreadId";
+
+export type ResumeConversationResponse = { conversationId: ThreadId, model: string, initialMessages: Array | null, rolloutPath: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/ReviewCodeLocation.ts b/codex-rs/app-server-protocol/schema/typescript/ReviewCodeLocation.ts
new file mode 100644
index 0000000000..752589fe55
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/ReviewCodeLocation.ts
@@ -0,0 +1,9 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ReviewLineRange } from "./ReviewLineRange";
+
+/**
+ * Location of the code related to a review finding.
+ */
+export type ReviewCodeLocation = { absolute_file_path: string, line_range: ReviewLineRange, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/ReviewDecision.ts b/codex-rs/app-server-protocol/schema/typescript/ReviewDecision.ts
new file mode 100644
index 0000000000..662fae625a
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/ReviewDecision.ts
@@ -0,0 +1,9 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ExecPolicyAmendment } from "./ExecPolicyAmendment";
+
+/**
+ * User's decision in response to an ExecApprovalRequest.
+ */
+export type ReviewDecision = "approved" | { "approved_execpolicy_amendment": { proposed_execpolicy_amendment: ExecPolicyAmendment, } } | "approved_for_session" | "denied" | "abort";
diff --git a/codex-rs/app-server-protocol/schema/typescript/ReviewFinding.ts b/codex-rs/app-server-protocol/schema/typescript/ReviewFinding.ts
new file mode 100644
index 0000000000..e7c96bd170
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/ReviewFinding.ts
@@ -0,0 +1,9 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ReviewCodeLocation } from "./ReviewCodeLocation";
+
+/**
+ * A single review finding describing an observed issue or recommendation.
+ */
+export type ReviewFinding = { title: string, body: string, confidence_score: number, priority: number, code_location: ReviewCodeLocation, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/ReviewLineRange.ts b/codex-rs/app-server-protocol/schema/typescript/ReviewLineRange.ts
new file mode 100644
index 0000000000..c57ec6ed60
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/ReviewLineRange.ts
@@ -0,0 +1,8 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+/**
+ * Inclusive line range in a file associated with the finding.
+ */
+export type ReviewLineRange = { start: number, end: number, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/ReviewOutputEvent.ts b/codex-rs/app-server-protocol/schema/typescript/ReviewOutputEvent.ts
new file mode 100644
index 0000000000..c45747424b
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/ReviewOutputEvent.ts
@@ -0,0 +1,9 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ReviewFinding } from "./ReviewFinding";
+
+/**
+ * Structured review result produced by a child review session.
+ */
+export type ReviewOutputEvent = { findings: Array, overall_correctness: string, overall_explanation: string, overall_confidence_score: number, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/ReviewRequest.ts b/codex-rs/app-server-protocol/schema/typescript/ReviewRequest.ts
new file mode 100644
index 0000000000..1e9b8ad2ee
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/ReviewRequest.ts
@@ -0,0 +1,9 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ReviewTarget } from "./ReviewTarget";
+
+/**
+ * Review request sent to the review session.
+ */
+export type ReviewRequest = { target: ReviewTarget, user_facing_hint?: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/ReviewTarget.ts b/codex-rs/app-server-protocol/schema/typescript/ReviewTarget.ts
new file mode 100644
index 0000000000..a79f1e993c
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/ReviewTarget.ts
@@ -0,0 +1,9 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type ReviewTarget = { "type": "uncommittedChanges" } | { "type": "baseBranch", branch: string, } | { "type": "commit", sha: string,
+/**
+ * Optional human-readable label (e.g., commit subject) for UIs.
+ */
+title: string | null, } | { "type": "custom", instructions: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/Role.ts b/codex-rs/app-server-protocol/schema/typescript/Role.ts
new file mode 100644
index 0000000000..009307efce
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/Role.ts
@@ -0,0 +1,8 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+/**
+ * The sender or recipient of messages and data in a conversation.
+ */
+export type Role = "assistant" | "user";
diff --git a/codex-rs/app-server-protocol/schema/typescript/SandboxMode.ts b/codex-rs/app-server-protocol/schema/typescript/SandboxMode.ts
new file mode 100644
index 0000000000..b8cf4326b9
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/SandboxMode.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type SandboxMode = "read-only" | "workspace-write" | "danger-full-access";
diff --git a/codex-rs/app-server-protocol/schema/typescript/SandboxPolicy.ts b/codex-rs/app-server-protocol/schema/typescript/SandboxPolicy.ts
new file mode 100644
index 0000000000..103a6863f4
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/SandboxPolicy.ts
@@ -0,0 +1,35 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { AbsolutePathBuf } from "./AbsolutePathBuf";
+import type { NetworkAccess } from "./NetworkAccess";
+
+/**
+ * Determines execution restrictions for model shell commands.
+ */
+export type SandboxPolicy = { "type": "danger-full-access" } | { "type": "read-only" } | { "type": "external-sandbox",
+/**
+ * Whether the external sandbox permits outbound network traffic.
+ */
+network_access: NetworkAccess, } | { "type": "workspace-write",
+/**
+ * Additional folders (beyond cwd and possibly TMPDIR) that should be
+ * writable from within the sandbox.
+ */
+writable_roots?: Array,
+/**
+ * When set to `true`, outbound network access is allowed. `false` by
+ * default.
+ */
+network_access: boolean,
+/**
+ * When set to `true`, will NOT include the per-user `TMPDIR`
+ * environment variable among the default writable roots. Defaults to
+ * `false`.
+ */
+exclude_tmpdir_env_var: boolean,
+/**
+ * When set to `true`, will NOT include the `/tmp` among the default
+ * writable roots on UNIX. Defaults to `false`.
+ */
+exclude_slash_tmp: boolean, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/SandboxSettings.ts b/codex-rs/app-server-protocol/schema/typescript/SandboxSettings.ts
new file mode 100644
index 0000000000..94139b0e5d
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/SandboxSettings.ts
@@ -0,0 +1,6 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { AbsolutePathBuf } from "./AbsolutePathBuf";
+
+export type SandboxSettings = { writableRoots: Array, networkAccess: boolean | null, excludeTmpdirEnvVar: boolean | null, excludeSlashTmp: boolean | null, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/SendUserMessageParams.ts b/codex-rs/app-server-protocol/schema/typescript/SendUserMessageParams.ts
new file mode 100644
index 0000000000..6aee538eb0
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/SendUserMessageParams.ts
@@ -0,0 +1,7 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { InputItem } from "./InputItem";
+import type { ThreadId } from "./ThreadId";
+
+export type SendUserMessageParams = { conversationId: ThreadId, items: Array, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/SendUserMessageResponse.ts b/codex-rs/app-server-protocol/schema/typescript/SendUserMessageResponse.ts
new file mode 100644
index 0000000000..1a03e043a6
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/SendUserMessageResponse.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type SendUserMessageResponse = Record;
diff --git a/codex-rs/app-server-protocol/schema/typescript/SendUserTurnParams.ts b/codex-rs/app-server-protocol/schema/typescript/SendUserTurnParams.ts
new file mode 100644
index 0000000000..dc4cfba8f5
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/SendUserTurnParams.ts
@@ -0,0 +1,16 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { AskForApproval } from "./AskForApproval";
+import type { InputItem } from "./InputItem";
+import type { ReasoningEffort } from "./ReasoningEffort";
+import type { ReasoningSummary } from "./ReasoningSummary";
+import type { SandboxPolicy } from "./SandboxPolicy";
+import type { ThreadId } from "./ThreadId";
+import type { JsonValue } from "./serde_json/JsonValue";
+
+export type SendUserTurnParams = { conversationId: ThreadId, items: Array, cwd: string, approvalPolicy: AskForApproval, sandboxPolicy: SandboxPolicy, model: string, effort: ReasoningEffort | null, summary: ReasoningSummary,
+/**
+ * Optional JSON Schema used to constrain the final assistant message for this turn.
+ */
+outputSchema: JsonValue | null, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/SendUserTurnResponse.ts b/codex-rs/app-server-protocol/schema/typescript/SendUserTurnResponse.ts
new file mode 100644
index 0000000000..cffd0ac398
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/SendUserTurnResponse.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type SendUserTurnResponse = Record;
diff --git a/codex-rs/app-server-protocol/schema/typescript/ServerNotification.ts b/codex-rs/app-server-protocol/schema/typescript/ServerNotification.ts
new file mode 100644
index 0000000000..403617fcd4
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/ServerNotification.ts
@@ -0,0 +1,39 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { AuthStatusChangeNotification } from "./AuthStatusChangeNotification";
+import type { LoginChatGptCompleteNotification } from "./LoginChatGptCompleteNotification";
+import type { SessionConfiguredNotification } from "./SessionConfiguredNotification";
+import type { AccountLoginCompletedNotification } from "./v2/AccountLoginCompletedNotification";
+import type { AccountRateLimitsUpdatedNotification } from "./v2/AccountRateLimitsUpdatedNotification";
+import type { AccountUpdatedNotification } from "./v2/AccountUpdatedNotification";
+import type { AgentMessageDeltaNotification } from "./v2/AgentMessageDeltaNotification";
+import type { CommandExecutionOutputDeltaNotification } from "./v2/CommandExecutionOutputDeltaNotification";
+import type { ConfigWarningNotification } from "./v2/ConfigWarningNotification";
+import type { ContextCompactedNotification } from "./v2/ContextCompactedNotification";
+import type { DeprecationNoticeNotification } from "./v2/DeprecationNoticeNotification";
+import type { ErrorNotification } from "./v2/ErrorNotification";
+import type { FileChangeOutputDeltaNotification } from "./v2/FileChangeOutputDeltaNotification";
+import type { ItemCompletedNotification } from "./v2/ItemCompletedNotification";
+import type { ItemStartedNotification } from "./v2/ItemStartedNotification";
+import type { McpServerOauthLoginCompletedNotification } from "./v2/McpServerOauthLoginCompletedNotification";
+import type { McpToolCallProgressNotification } from "./v2/McpToolCallProgressNotification";
+import type { PlanDeltaNotification } from "./v2/PlanDeltaNotification";
+import type { RawResponseItemCompletedNotification } from "./v2/RawResponseItemCompletedNotification";
+import type { ReasoningSummaryPartAddedNotification } from "./v2/ReasoningSummaryPartAddedNotification";
+import type { ReasoningSummaryTextDeltaNotification } from "./v2/ReasoningSummaryTextDeltaNotification";
+import type { ReasoningTextDeltaNotification } from "./v2/ReasoningTextDeltaNotification";
+import type { TerminalInteractionNotification } from "./v2/TerminalInteractionNotification";
+import type { ThreadNameUpdatedNotification } from "./v2/ThreadNameUpdatedNotification";
+import type { ThreadStartedNotification } from "./v2/ThreadStartedNotification";
+import type { ThreadTokenUsageUpdatedNotification } from "./v2/ThreadTokenUsageUpdatedNotification";
+import type { TurnCompletedNotification } from "./v2/TurnCompletedNotification";
+import type { TurnDiffUpdatedNotification } from "./v2/TurnDiffUpdatedNotification";
+import type { TurnPlanUpdatedNotification } from "./v2/TurnPlanUpdatedNotification";
+import type { TurnStartedNotification } from "./v2/TurnStartedNotification";
+import type { WindowsWorldWritableWarningNotification } from "./v2/WindowsWorldWritableWarningNotification";
+
+/**
+ * Notification sent from the server to the client.
+ */
+export type ServerNotification = { "method": "error", "params": ErrorNotification } | { "method": "thread/started", "params": ThreadStartedNotification } | { "method": "thread/name/updated", "params": ThreadNameUpdatedNotification } | { "method": "thread/tokenUsage/updated", "params": ThreadTokenUsageUpdatedNotification } | { "method": "turn/started", "params": TurnStartedNotification } | { "method": "turn/completed", "params": TurnCompletedNotification } | { "method": "turn/diff/updated", "params": TurnDiffUpdatedNotification } | { "method": "turn/plan/updated", "params": TurnPlanUpdatedNotification } | { "method": "item/started", "params": ItemStartedNotification } | { "method": "item/completed", "params": ItemCompletedNotification } | { "method": "rawResponseItem/completed", "params": RawResponseItemCompletedNotification } | { "method": "item/agentMessage/delta", "params": AgentMessageDeltaNotification } | { "method": "item/plan/delta", "params": PlanDeltaNotification } | { "method": "item/commandExecution/outputDelta", "params": CommandExecutionOutputDeltaNotification } | { "method": "item/commandExecution/terminalInteraction", "params": TerminalInteractionNotification } | { "method": "item/fileChange/outputDelta", "params": FileChangeOutputDeltaNotification } | { "method": "item/mcpToolCall/progress", "params": McpToolCallProgressNotification } | { "method": "mcpServer/oauthLogin/completed", "params": McpServerOauthLoginCompletedNotification } | { "method": "account/updated", "params": AccountUpdatedNotification } | { "method": "account/rateLimits/updated", "params": AccountRateLimitsUpdatedNotification } | { "method": "item/reasoning/summaryTextDelta", "params": ReasoningSummaryTextDeltaNotification } | { "method": "item/reasoning/summaryPartAdded", "params": ReasoningSummaryPartAddedNotification } | { "method": "item/reasoning/textDelta", "params": ReasoningTextDeltaNotification } | { "method": "thread/compacted", "params": ContextCompactedNotification } | { "method": "deprecationNotice", "params": DeprecationNoticeNotification } | { "method": "configWarning", "params": ConfigWarningNotification } | { "method": "windows/worldWritableWarning", "params": WindowsWorldWritableWarningNotification } | { "method": "account/login/completed", "params": AccountLoginCompletedNotification } | { "method": "authStatusChange", "params": AuthStatusChangeNotification } | { "method": "loginChatGptComplete", "params": LoginChatGptCompleteNotification } | { "method": "sessionConfigured", "params": SessionConfiguredNotification };
diff --git a/codex-rs/app-server-protocol/schema/typescript/ServerRequest.ts b/codex-rs/app-server-protocol/schema/typescript/ServerRequest.ts
new file mode 100644
index 0000000000..17c66959aa
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/ServerRequest.ts
@@ -0,0 +1,16 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ApplyPatchApprovalParams } from "./ApplyPatchApprovalParams";
+import type { ExecCommandApprovalParams } from "./ExecCommandApprovalParams";
+import type { RequestId } from "./RequestId";
+import type { ChatgptAuthTokensRefreshParams } from "./v2/ChatgptAuthTokensRefreshParams";
+import type { CommandExecutionRequestApprovalParams } from "./v2/CommandExecutionRequestApprovalParams";
+import type { DynamicToolCallParams } from "./v2/DynamicToolCallParams";
+import type { FileChangeRequestApprovalParams } from "./v2/FileChangeRequestApprovalParams";
+import type { ToolRequestUserInputParams } from "./v2/ToolRequestUserInputParams";
+
+/**
+ * Request initiated from the server and sent to the client.
+ */
+export type ServerRequest = { "method": "item/commandExecution/requestApproval", id: RequestId, params: CommandExecutionRequestApprovalParams, } | { "method": "item/fileChange/requestApproval", id: RequestId, params: FileChangeRequestApprovalParams, } | { "method": "item/tool/requestUserInput", id: RequestId, params: ToolRequestUserInputParams, } | { "method": "item/tool/call", id: RequestId, params: DynamicToolCallParams, } | { "method": "account/chatgptAuthTokens/refresh", id: RequestId, params: ChatgptAuthTokensRefreshParams, } | { "method": "applyPatchApproval", id: RequestId, params: ApplyPatchApprovalParams, } | { "method": "execCommandApproval", id: RequestId, params: ExecCommandApprovalParams, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/SessionConfiguredEvent.ts b/codex-rs/app-server-protocol/schema/typescript/SessionConfiguredEvent.ts
new file mode 100644
index 0000000000..2e1896a396
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/SessionConfiguredEvent.ts
@@ -0,0 +1,52 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { AskForApproval } from "./AskForApproval";
+import type { EventMsg } from "./EventMsg";
+import type { ReasoningEffort } from "./ReasoningEffort";
+import type { SandboxPolicy } from "./SandboxPolicy";
+import type { ThreadId } from "./ThreadId";
+
+export type SessionConfiguredEvent = { session_id: ThreadId, forked_from_id: ThreadId | null,
+/**
+ * Optional user-facing thread name (may be unset).
+ */
+thread_name?: string,
+/**
+ * Tell the client what model is being queried.
+ */
+model: string, model_provider_id: string,
+/**
+ * When to escalate for approval for execution
+ */
+approval_policy: AskForApproval,
+/**
+ * How to sandbox commands executed in the system
+ */
+sandbox_policy: SandboxPolicy,
+/**
+ * Working directory that should be treated as the *root* of the
+ * session.
+ */
+cwd: string,
+/**
+ * The effort the model is putting into reasoning about the user's request.
+ */
+reasoning_effort: ReasoningEffort | null,
+/**
+ * Identifier of the history log file (inode on Unix, 0 otherwise).
+ */
+history_log_id: bigint,
+/**
+ * Current number of entries in the history log.
+ */
+history_entry_count: number,
+/**
+ * Optional initial messages (as events) for resumed sessions.
+ * When present, UIs can use these to seed the history.
+ */
+initial_messages: Array | null,
+/**
+ * Path in which the rollout is stored. Can be `None` for ephemeral threads
+ */
+rollout_path: string | null, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/SessionConfiguredNotification.ts b/codex-rs/app-server-protocol/schema/typescript/SessionConfiguredNotification.ts
new file mode 100644
index 0000000000..3dee74aa3a
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/SessionConfiguredNotification.ts
@@ -0,0 +1,8 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { EventMsg } from "./EventMsg";
+import type { ReasoningEffort } from "./ReasoningEffort";
+import type { ThreadId } from "./ThreadId";
+
+export type SessionConfiguredNotification = { sessionId: ThreadId, model: string, reasoningEffort: ReasoningEffort | null, historyLogId: bigint, historyEntryCount: number, initialMessages: Array | null, rolloutPath: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/SessionSource.ts b/codex-rs/app-server-protocol/schema/typescript/SessionSource.ts
new file mode 100644
index 0000000000..e5e746e384
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/SessionSource.ts
@@ -0,0 +1,6 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { SubAgentSource } from "./SubAgentSource";
+
+export type SessionSource = "cli" | "vscode" | "exec" | "mcp" | { "subagent": SubAgentSource } | "unknown";
diff --git a/codex-rs/app-server-protocol/schema/typescript/SetDefaultModelParams.ts b/codex-rs/app-server-protocol/schema/typescript/SetDefaultModelParams.ts
new file mode 100644
index 0000000000..b9e4e7d901
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/SetDefaultModelParams.ts
@@ -0,0 +1,6 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ReasoningEffort } from "./ReasoningEffort";
+
+export type SetDefaultModelParams = { model: string | null, reasoningEffort: ReasoningEffort | null, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/SetDefaultModelResponse.ts b/codex-rs/app-server-protocol/schema/typescript/SetDefaultModelResponse.ts
new file mode 100644
index 0000000000..1639601e0c
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/SetDefaultModelResponse.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type SetDefaultModelResponse = Record;
diff --git a/codex-rs/app-server-protocol/schema/typescript/Settings.ts b/codex-rs/app-server-protocol/schema/typescript/Settings.ts
new file mode 100644
index 0000000000..29bcadd52e
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/Settings.ts
@@ -0,0 +1,9 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ReasoningEffort } from "./ReasoningEffort";
+
+/**
+ * Settings for a collaboration mode.
+ */
+export type Settings = { model: string, reasoning_effort: ReasoningEffort | null, developer_instructions: string | null, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/SkillDependencies.ts b/codex-rs/app-server-protocol/schema/typescript/SkillDependencies.ts
new file mode 100644
index 0000000000..e2dd4f4241
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/SkillDependencies.ts
@@ -0,0 +1,6 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { SkillToolDependency } from "./SkillToolDependency";
+
+export type SkillDependencies = { tools: Array, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/SkillErrorInfo.ts b/codex-rs/app-server-protocol/schema/typescript/SkillErrorInfo.ts
new file mode 100644
index 0000000000..6eaf035d8c
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/SkillErrorInfo.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type SkillErrorInfo = { path: string, message: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/SkillInterface.ts b/codex-rs/app-server-protocol/schema/typescript/SkillInterface.ts
new file mode 100644
index 0000000000..30250b9383
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/SkillInterface.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type SkillInterface = { display_name?: string, short_description?: string, icon_small?: string, icon_large?: string, brand_color?: string, default_prompt?: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/SkillMetadata.ts b/codex-rs/app-server-protocol/schema/typescript/SkillMetadata.ts
new file mode 100644
index 0000000000..088abc406a
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/SkillMetadata.ts
@@ -0,0 +1,12 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { SkillDependencies } from "./SkillDependencies";
+import type { SkillInterface } from "./SkillInterface";
+import type { SkillScope } from "./SkillScope";
+
+export type SkillMetadata = { name: string, description: string,
+/**
+ * Legacy short_description from SKILL.md. Prefer SKILL.json interface.short_description.
+ */
+short_description?: string, interface?: SkillInterface, dependencies?: SkillDependencies, path: string, scope: SkillScope, enabled: boolean, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/SkillScope.ts b/codex-rs/app-server-protocol/schema/typescript/SkillScope.ts
new file mode 100644
index 0000000000..997006f5b8
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/SkillScope.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type SkillScope = "user" | "repo" | "system" | "admin";
diff --git a/codex-rs/app-server-protocol/schema/typescript/SkillToolDependency.ts b/codex-rs/app-server-protocol/schema/typescript/SkillToolDependency.ts
new file mode 100644
index 0000000000..a5da45e178
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/SkillToolDependency.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type SkillToolDependency = { type: string, value: string, description?: string, transport?: string, command?: string, url?: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/SkillsListEntry.ts b/codex-rs/app-server-protocol/schema/typescript/SkillsListEntry.ts
new file mode 100644
index 0000000000..3f46c98a4a
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/SkillsListEntry.ts
@@ -0,0 +1,7 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { SkillErrorInfo } from "./SkillErrorInfo";
+import type { SkillMetadata } from "./SkillMetadata";
+
+export type SkillsListEntry = { cwd: string, skills: Array, errors: Array, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/StepStatus.ts b/codex-rs/app-server-protocol/schema/typescript/StepStatus.ts
new file mode 100644
index 0000000000..8494a76e0b
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/StepStatus.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type StepStatus = "pending" | "in_progress" | "completed";
diff --git a/codex-rs/app-server-protocol/schema/typescript/StreamErrorEvent.ts b/codex-rs/app-server-protocol/schema/typescript/StreamErrorEvent.ts
new file mode 100644
index 0000000000..b88993a344
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/StreamErrorEvent.ts
@@ -0,0 +1,12 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { CodexErrorInfo } from "./CodexErrorInfo";
+
+export type StreamErrorEvent = { message: string, codex_error_info: CodexErrorInfo | null,
+/**
+ * Optional details about the underlying stream failure (often the same
+ * human-readable message that is surfaced as the terminal error if retries
+ * are exhausted).
+ */
+additional_details: string | null, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/SubAgentSource.ts b/codex-rs/app-server-protocol/schema/typescript/SubAgentSource.ts
new file mode 100644
index 0000000000..d6da7a466b
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/SubAgentSource.ts
@@ -0,0 +1,6 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ThreadId } from "./ThreadId";
+
+export type SubAgentSource = "review" | "compact" | { "thread_spawn": { parent_thread_id: ThreadId, depth: number, } } | { "other": string };
diff --git a/codex-rs/app-server-protocol/schema/typescript/TerminalInteractionEvent.ts b/codex-rs/app-server-protocol/schema/typescript/TerminalInteractionEvent.ts
new file mode 100644
index 0000000000..5f300e6ca5
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/TerminalInteractionEvent.ts
@@ -0,0 +1,17 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type TerminalInteractionEvent = {
+/**
+ * Identifier for the ExecCommandBegin that produced this chunk.
+ */
+call_id: string,
+/**
+ * Process id associated with the running command.
+ */
+process_id: string,
+/**
+ * Stdin sent to the running session.
+ */
+stdin: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/TextContent.ts b/codex-rs/app-server-protocol/schema/typescript/TextContent.ts
new file mode 100644
index 0000000000..760102f81d
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/TextContent.ts
@@ -0,0 +1,9 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { Annotations } from "./Annotations";
+
+/**
+ * Text provided to or from an LLM.
+ */
+export type TextContent = { annotations?: Annotations, text: string, type: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/TextElement.ts b/codex-rs/app-server-protocol/schema/typescript/TextElement.ts
new file mode 100644
index 0000000000..8841d00499
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/TextElement.ts
@@ -0,0 +1,14 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ByteRange } from "./ByteRange";
+
+export type TextElement = {
+/**
+ * Byte range in the parent `text` buffer that this element occupies.
+ */
+byteRange: ByteRange,
+/**
+ * Optional human-readable placeholder for the element, displayed in the UI.
+ */
+placeholder: string | null, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/TextResourceContents.ts b/codex-rs/app-server-protocol/schema/typescript/TextResourceContents.ts
new file mode 100644
index 0000000000..5bef79210c
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/TextResourceContents.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type TextResourceContents = { mimeType?: string, text: string, uri: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/ThreadId.ts b/codex-rs/app-server-protocol/schema/typescript/ThreadId.ts
new file mode 100644
index 0000000000..bfb3b4b4d7
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/ThreadId.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type ThreadId = string;
diff --git a/codex-rs/app-server-protocol/schema/typescript/ThreadNameUpdatedEvent.ts b/codex-rs/app-server-protocol/schema/typescript/ThreadNameUpdatedEvent.ts
new file mode 100644
index 0000000000..639e29f9d7
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/ThreadNameUpdatedEvent.ts
@@ -0,0 +1,6 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ThreadId } from "./ThreadId";
+
+export type ThreadNameUpdatedEvent = { thread_id: ThreadId, thread_name?: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/ThreadRolledBackEvent.ts b/codex-rs/app-server-protocol/schema/typescript/ThreadRolledBackEvent.ts
new file mode 100644
index 0000000000..30bc64c9c1
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/ThreadRolledBackEvent.ts
@@ -0,0 +1,9 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type ThreadRolledBackEvent = {
+/**
+ * Number of user turns that were removed from context.
+ */
+num_turns: number, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/TokenCountEvent.ts b/codex-rs/app-server-protocol/schema/typescript/TokenCountEvent.ts
new file mode 100644
index 0000000000..f58b574641
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/TokenCountEvent.ts
@@ -0,0 +1,7 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { RateLimitSnapshot } from "./RateLimitSnapshot";
+import type { TokenUsageInfo } from "./TokenUsageInfo";
+
+export type TokenCountEvent = { info: TokenUsageInfo | null, rate_limits: RateLimitSnapshot | null, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/TokenUsage.ts b/codex-rs/app-server-protocol/schema/typescript/TokenUsage.ts
new file mode 100644
index 0000000000..41186b25b9
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/TokenUsage.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type TokenUsage = { input_tokens: number, cached_input_tokens: number, output_tokens: number, reasoning_output_tokens: number, total_tokens: number, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/TokenUsageInfo.ts b/codex-rs/app-server-protocol/schema/typescript/TokenUsageInfo.ts
new file mode 100644
index 0000000000..cb15de42e7
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/TokenUsageInfo.ts
@@ -0,0 +1,6 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { TokenUsage } from "./TokenUsage";
+
+export type TokenUsageInfo = { total_token_usage: TokenUsage, last_token_usage: TokenUsage, model_context_window: number | null, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/Tool.ts b/codex-rs/app-server-protocol/schema/typescript/Tool.ts
new file mode 100644
index 0000000000..8255eecf2c
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/Tool.ts
@@ -0,0 +1,11 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ToolAnnotations } from "./ToolAnnotations";
+import type { ToolInputSchema } from "./ToolInputSchema";
+import type { ToolOutputSchema } from "./ToolOutputSchema";
+
+/**
+ * Definition for a tool the client can call.
+ */
+export type Tool = { annotations?: ToolAnnotations, description?: string, inputSchema: ToolInputSchema, name: string, outputSchema?: ToolOutputSchema, title?: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/ToolAnnotations.ts b/codex-rs/app-server-protocol/schema/typescript/ToolAnnotations.ts
new file mode 100644
index 0000000000..70348a9964
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/ToolAnnotations.ts
@@ -0,0 +1,15 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+/**
+ * Additional properties describing a Tool to clients.
+ *
+ * NOTE: all properties in ToolAnnotations are **hints**.
+ * They are not guaranteed to provide a faithful description of
+ * tool behavior (including descriptive properties like `title`).
+ *
+ * Clients should never make tool use decisions based on ToolAnnotations
+ * received from untrusted servers.
+ */
+export type ToolAnnotations = { destructiveHint?: boolean, idempotentHint?: boolean, openWorldHint?: boolean, readOnlyHint?: boolean, title?: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/ToolInputSchema.ts b/codex-rs/app-server-protocol/schema/typescript/ToolInputSchema.ts
new file mode 100644
index 0000000000..78f40bbe40
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/ToolInputSchema.ts
@@ -0,0 +1,9 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { JsonValue } from "./serde_json/JsonValue";
+
+/**
+ * A JSON Schema object defining the expected parameters for the tool.
+ */
+export type ToolInputSchema = { properties?: JsonValue, required?: Array, type: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/ToolOutputSchema.ts b/codex-rs/app-server-protocol/schema/typescript/ToolOutputSchema.ts
new file mode 100644
index 0000000000..9270c8e7b7
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/ToolOutputSchema.ts
@@ -0,0 +1,10 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { JsonValue } from "./serde_json/JsonValue";
+
+/**
+ * An optional JSON Schema object defining the structure of the tool's output returned in
+ * the structuredContent field of a CallToolResult.
+ */
+export type ToolOutputSchema = { properties?: JsonValue, required?: Array, type: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/Tools.ts b/codex-rs/app-server-protocol/schema/typescript/Tools.ts
new file mode 100644
index 0000000000..0387022966
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/Tools.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type Tools = { webSearch: boolean | null, viewImage: boolean | null, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/TurnAbortReason.ts b/codex-rs/app-server-protocol/schema/typescript/TurnAbortReason.ts
new file mode 100644
index 0000000000..f07cde6292
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/TurnAbortReason.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type TurnAbortReason = "interrupted" | "replaced" | "review_ended";
diff --git a/codex-rs/app-server-protocol/schema/typescript/TurnAbortedEvent.ts b/codex-rs/app-server-protocol/schema/typescript/TurnAbortedEvent.ts
new file mode 100644
index 0000000000..eb0bf24c18
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/TurnAbortedEvent.ts
@@ -0,0 +1,6 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { TurnAbortReason } from "./TurnAbortReason";
+
+export type TurnAbortedEvent = { reason: TurnAbortReason, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/TurnCompleteEvent.ts b/codex-rs/app-server-protocol/schema/typescript/TurnCompleteEvent.ts
new file mode 100644
index 0000000000..ab271ba9e3
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/TurnCompleteEvent.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type TurnCompleteEvent = { last_agent_message: string | null, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/TurnDiffEvent.ts b/codex-rs/app-server-protocol/schema/typescript/TurnDiffEvent.ts
new file mode 100644
index 0000000000..52e3df09b0
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/TurnDiffEvent.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type TurnDiffEvent = { unified_diff: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/TurnItem.ts b/codex-rs/app-server-protocol/schema/typescript/TurnItem.ts
new file mode 100644
index 0000000000..0f2ea12a21
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/TurnItem.ts
@@ -0,0 +1,11 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { AgentMessageItem } from "./AgentMessageItem";
+import type { ContextCompactionItem } from "./ContextCompactionItem";
+import type { PlanItem } from "./PlanItem";
+import type { ReasoningItem } from "./ReasoningItem";
+import type { UserMessageItem } from "./UserMessageItem";
+import type { WebSearchItem } from "./WebSearchItem";
+
+export type TurnItem = { "type": "UserMessage" } & UserMessageItem | { "type": "AgentMessage" } & AgentMessageItem | { "type": "Plan" } & PlanItem | { "type": "Reasoning" } & ReasoningItem | { "type": "WebSearch" } & WebSearchItem | { "type": "ContextCompaction" } & ContextCompactionItem;
diff --git a/codex-rs/app-server-protocol/schema/typescript/TurnStartedEvent.ts b/codex-rs/app-server-protocol/schema/typescript/TurnStartedEvent.ts
new file mode 100644
index 0000000000..91598aa789
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/TurnStartedEvent.ts
@@ -0,0 +1,6 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ModeKind } from "./ModeKind";
+
+export type TurnStartedEvent = { model_context_window: bigint | null, collaboration_mode_kind: ModeKind, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/UndoCompletedEvent.ts b/codex-rs/app-server-protocol/schema/typescript/UndoCompletedEvent.ts
new file mode 100644
index 0000000000..2d94e2e18d
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/UndoCompletedEvent.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type UndoCompletedEvent = { success: boolean, message: string | null, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/UndoStartedEvent.ts b/codex-rs/app-server-protocol/schema/typescript/UndoStartedEvent.ts
new file mode 100644
index 0000000000..712082adff
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/UndoStartedEvent.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type UndoStartedEvent = { message: string | null, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/UpdatePlanArgs.ts b/codex-rs/app-server-protocol/schema/typescript/UpdatePlanArgs.ts
new file mode 100644
index 0000000000..61613fcb5f
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/UpdatePlanArgs.ts
@@ -0,0 +1,10 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { PlanItemArg } from "./PlanItemArg";
+
+export type UpdatePlanArgs = {
+/**
+ * Arguments for the `update_plan` todo/checklist tool (not plan mode).
+ */
+explanation: string | null, plan: Array, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/UserInfoResponse.ts b/codex-rs/app-server-protocol/schema/typescript/UserInfoResponse.ts
new file mode 100644
index 0000000000..3d257a1c5e
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/UserInfoResponse.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type UserInfoResponse = { allegedUserEmail: string | null, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/UserInput.ts b/codex-rs/app-server-protocol/schema/typescript/UserInput.ts
new file mode 100644
index 0000000000..e6a9c3a580
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/UserInput.ts
@@ -0,0 +1,16 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { TextElement } from "./TextElement";
+
+/**
+ * User input
+ */
+export type UserInput = { "type": "text", text: string,
+/**
+ * UI-defined spans within `text` that should be treated as special elements.
+ * These are byte ranges into the UTF-8 `text` buffer and are used to render
+ * or persist rich input markers (e.g., image placeholders) across history
+ * and resume without mutating the literal text.
+ */
+text_elements: Array, } | { "type": "image", image_url: string, } | { "type": "local_image", path: string, } | { "type": "skill", name: string, path: string, } | { "type": "mention", name: string, path: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/UserMessageEvent.ts b/codex-rs/app-server-protocol/schema/typescript/UserMessageEvent.ts
new file mode 100644
index 0000000000..2fde364d67
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/UserMessageEvent.ts
@@ -0,0 +1,22 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { TextElement } from "./TextElement";
+
+export type UserMessageEvent = { message: string,
+/**
+ * Image URLs sourced from `UserInput::Image`. These are safe
+ * to replay in legacy UI history events and correspond to images sent to
+ * the model.
+ */
+images: Array | null,
+/**
+ * Local file paths sourced from `UserInput::LocalImage`. These are kept so
+ * the UI can reattach images when editing history, and should not be sent
+ * to the model or treated as API-ready URLs.
+ */
+local_images: Array,
+/**
+ * UI-defined spans within `message` used to render or persist special elements.
+ */
+text_elements: Array, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/UserMessageItem.ts b/codex-rs/app-server-protocol/schema/typescript/UserMessageItem.ts
new file mode 100644
index 0000000000..df856287a5
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/UserMessageItem.ts
@@ -0,0 +1,6 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { UserInput } from "./UserInput";
+
+export type UserMessageItem = { id: string, content: Array, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/UserSavedConfig.ts b/codex-rs/app-server-protocol/schema/typescript/UserSavedConfig.ts
new file mode 100644
index 0000000000..e70107f31e
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/UserSavedConfig.ts
@@ -0,0 +1,14 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { AskForApproval } from "./AskForApproval";
+import type { ForcedLoginMethod } from "./ForcedLoginMethod";
+import type { Profile } from "./Profile";
+import type { ReasoningEffort } from "./ReasoningEffort";
+import type { ReasoningSummary } from "./ReasoningSummary";
+import type { SandboxMode } from "./SandboxMode";
+import type { SandboxSettings } from "./SandboxSettings";
+import type { Tools } from "./Tools";
+import type { Verbosity } from "./Verbosity";
+
+export type UserSavedConfig = { approvalPolicy: AskForApproval | null, sandboxMode: SandboxMode | null, sandboxSettings: SandboxSettings | null, forcedChatgptWorkspaceId: string | null, forcedLoginMethod: ForcedLoginMethod | null, model: string | null, modelReasoningEffort: ReasoningEffort | null, modelReasoningSummary: ReasoningSummary | null, modelVerbosity: Verbosity | null, tools: Tools | null, profile: string | null, profiles: { [key in string]?: Profile }, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/Verbosity.ts b/codex-rs/app-server-protocol/schema/typescript/Verbosity.ts
new file mode 100644
index 0000000000..8fd97b0b89
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/Verbosity.ts
@@ -0,0 +1,9 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+/**
+ * Controls output length/detail on GPT-5 models via the Responses API.
+ * Serialized with lowercase values to match the OpenAI API.
+ */
+export type Verbosity = "low" | "medium" | "high";
diff --git a/codex-rs/app-server-protocol/schema/typescript/ViewImageToolCallEvent.ts b/codex-rs/app-server-protocol/schema/typescript/ViewImageToolCallEvent.ts
new file mode 100644
index 0000000000..76541a773a
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/ViewImageToolCallEvent.ts
@@ -0,0 +1,13 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type ViewImageToolCallEvent = {
+/**
+ * Identifier for the originating tool call.
+ */
+call_id: string,
+/**
+ * Local filesystem path provided to the tool.
+ */
+path: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/WarningEvent.ts b/codex-rs/app-server-protocol/schema/typescript/WarningEvent.ts
new file mode 100644
index 0000000000..35ec40f7cd
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/WarningEvent.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type WarningEvent = { message: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/WebSearchAction.ts b/codex-rs/app-server-protocol/schema/typescript/WebSearchAction.ts
new file mode 100644
index 0000000000..91cb99e9ed
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/WebSearchAction.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type WebSearchAction = { "type": "search", query?: string, queries?: Array, } | { "type": "open_page", url?: string, } | { "type": "find_in_page", url?: string, pattern?: string, } | { "type": "other" };
diff --git a/codex-rs/app-server-protocol/schema/typescript/WebSearchBeginEvent.ts b/codex-rs/app-server-protocol/schema/typescript/WebSearchBeginEvent.ts
new file mode 100644
index 0000000000..4a8d881914
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/WebSearchBeginEvent.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type WebSearchBeginEvent = { call_id: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/WebSearchEndEvent.ts b/codex-rs/app-server-protocol/schema/typescript/WebSearchEndEvent.ts
new file mode 100644
index 0000000000..5b8b67c28b
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/WebSearchEndEvent.ts
@@ -0,0 +1,6 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { WebSearchAction } from "./WebSearchAction";
+
+export type WebSearchEndEvent = { call_id: string, query: string, action: WebSearchAction, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/WebSearchItem.ts b/codex-rs/app-server-protocol/schema/typescript/WebSearchItem.ts
new file mode 100644
index 0000000000..46b1406519
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/WebSearchItem.ts
@@ -0,0 +1,6 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { WebSearchAction } from "./WebSearchAction";
+
+export type WebSearchItem = { id: string, query: string, action: WebSearchAction, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/WebSearchMode.ts b/codex-rs/app-server-protocol/schema/typescript/WebSearchMode.ts
new file mode 100644
index 0000000000..695c13e3f6
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/WebSearchMode.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type WebSearchMode = "disabled" | "cached" | "live";
diff --git a/codex-rs/app-server-protocol/schema/typescript/index.ts b/codex-rs/app-server-protocol/schema/typescript/index.ts
new file mode 100644
index 0000000000..fafc6aad9d
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/index.ts
@@ -0,0 +1,230 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+export type { AbsolutePathBuf } from "./AbsolutePathBuf";
+export type { AddConversationListenerParams } from "./AddConversationListenerParams";
+export type { AddConversationSubscriptionResponse } from "./AddConversationSubscriptionResponse";
+export type { AgentMessageContent } from "./AgentMessageContent";
+export type { AgentMessageContentDeltaEvent } from "./AgentMessageContentDeltaEvent";
+export type { AgentMessageDeltaEvent } from "./AgentMessageDeltaEvent";
+export type { AgentMessageEvent } from "./AgentMessageEvent";
+export type { AgentMessageItem } from "./AgentMessageItem";
+export type { AgentReasoningDeltaEvent } from "./AgentReasoningDeltaEvent";
+export type { AgentReasoningEvent } from "./AgentReasoningEvent";
+export type { AgentReasoningRawContentDeltaEvent } from "./AgentReasoningRawContentDeltaEvent";
+export type { AgentReasoningRawContentEvent } from "./AgentReasoningRawContentEvent";
+export type { AgentReasoningSectionBreakEvent } from "./AgentReasoningSectionBreakEvent";
+export type { AgentStatus } from "./AgentStatus";
+export type { Annotations } from "./Annotations";
+export type { ApplyPatchApprovalParams } from "./ApplyPatchApprovalParams";
+export type { ApplyPatchApprovalRequestEvent } from "./ApplyPatchApprovalRequestEvent";
+export type { ApplyPatchApprovalResponse } from "./ApplyPatchApprovalResponse";
+export type { ArchiveConversationParams } from "./ArchiveConversationParams";
+export type { ArchiveConversationResponse } from "./ArchiveConversationResponse";
+export type { AskForApproval } from "./AskForApproval";
+export type { AudioContent } from "./AudioContent";
+export type { AuthMode } from "./AuthMode";
+export type { AuthStatusChangeNotification } from "./AuthStatusChangeNotification";
+export type { BackgroundEventEvent } from "./BackgroundEventEvent";
+export type { BlobResourceContents } from "./BlobResourceContents";
+export type { ByteRange } from "./ByteRange";
+export type { CallToolResult } from "./CallToolResult";
+export type { CancelLoginChatGptParams } from "./CancelLoginChatGptParams";
+export type { CancelLoginChatGptResponse } from "./CancelLoginChatGptResponse";
+export type { ClientInfo } from "./ClientInfo";
+export type { ClientNotification } from "./ClientNotification";
+export type { ClientRequest } from "./ClientRequest";
+export type { CodexErrorInfo } from "./CodexErrorInfo";
+export type { CollabAgentInteractionBeginEvent } from "./CollabAgentInteractionBeginEvent";
+export type { CollabAgentInteractionEndEvent } from "./CollabAgentInteractionEndEvent";
+export type { CollabAgentSpawnBeginEvent } from "./CollabAgentSpawnBeginEvent";
+export type { CollabAgentSpawnEndEvent } from "./CollabAgentSpawnEndEvent";
+export type { CollabCloseBeginEvent } from "./CollabCloseBeginEvent";
+export type { CollabCloseEndEvent } from "./CollabCloseEndEvent";
+export type { CollabWaitingBeginEvent } from "./CollabWaitingBeginEvent";
+export type { CollabWaitingEndEvent } from "./CollabWaitingEndEvent";
+export type { CollaborationMode } from "./CollaborationMode";
+export type { CollaborationModeMask } from "./CollaborationModeMask";
+export type { ContentBlock } from "./ContentBlock";
+export type { ContentItem } from "./ContentItem";
+export type { ContextCompactedEvent } from "./ContextCompactedEvent";
+export type { ContextCompactionItem } from "./ContextCompactionItem";
+export type { ConversationGitInfo } from "./ConversationGitInfo";
+export type { ConversationSummary } from "./ConversationSummary";
+export type { CreditsSnapshot } from "./CreditsSnapshot";
+export type { CustomPrompt } from "./CustomPrompt";
+export type { DeprecationNoticeEvent } from "./DeprecationNoticeEvent";
+export type { DynamicToolCallRequest } from "./DynamicToolCallRequest";
+export type { ElicitationRequestEvent } from "./ElicitationRequestEvent";
+export type { EmbeddedResource } from "./EmbeddedResource";
+export type { EmbeddedResourceResource } from "./EmbeddedResourceResource";
+export type { ErrorEvent } from "./ErrorEvent";
+export type { EventMsg } from "./EventMsg";
+export type { ExecApprovalRequestEvent } from "./ExecApprovalRequestEvent";
+export type { ExecCommandApprovalParams } from "./ExecCommandApprovalParams";
+export type { ExecCommandApprovalResponse } from "./ExecCommandApprovalResponse";
+export type { ExecCommandBeginEvent } from "./ExecCommandBeginEvent";
+export type { ExecCommandEndEvent } from "./ExecCommandEndEvent";
+export type { ExecCommandOutputDeltaEvent } from "./ExecCommandOutputDeltaEvent";
+export type { ExecCommandSource } from "./ExecCommandSource";
+export type { ExecOneOffCommandParams } from "./ExecOneOffCommandParams";
+export type { ExecOneOffCommandResponse } from "./ExecOneOffCommandResponse";
+export type { ExecOutputStream } from "./ExecOutputStream";
+export type { ExecPolicyAmendment } from "./ExecPolicyAmendment";
+export type { ExitedReviewModeEvent } from "./ExitedReviewModeEvent";
+export type { FileChange } from "./FileChange";
+export type { ForcedLoginMethod } from "./ForcedLoginMethod";
+export type { ForkConversationParams } from "./ForkConversationParams";
+export type { ForkConversationResponse } from "./ForkConversationResponse";
+export type { FunctionCallOutputContentItem } from "./FunctionCallOutputContentItem";
+export type { FunctionCallOutputPayload } from "./FunctionCallOutputPayload";
+export type { FuzzyFileSearchParams } from "./FuzzyFileSearchParams";
+export type { FuzzyFileSearchResponse } from "./FuzzyFileSearchResponse";
+export type { FuzzyFileSearchResult } from "./FuzzyFileSearchResult";
+export type { GetAuthStatusParams } from "./GetAuthStatusParams";
+export type { GetAuthStatusResponse } from "./GetAuthStatusResponse";
+export type { GetConversationSummaryParams } from "./GetConversationSummaryParams";
+export type { GetConversationSummaryResponse } from "./GetConversationSummaryResponse";
+export type { GetHistoryEntryResponseEvent } from "./GetHistoryEntryResponseEvent";
+export type { GetUserAgentResponse } from "./GetUserAgentResponse";
+export type { GetUserSavedConfigResponse } from "./GetUserSavedConfigResponse";
+export type { GhostCommit } from "./GhostCommit";
+export type { GitDiffToRemoteParams } from "./GitDiffToRemoteParams";
+export type { GitDiffToRemoteResponse } from "./GitDiffToRemoteResponse";
+export type { GitSha } from "./GitSha";
+export type { HistoryEntry } from "./HistoryEntry";
+export type { ImageContent } from "./ImageContent";
+export type { InitializeCapabilities } from "./InitializeCapabilities";
+export type { InitializeParams } from "./InitializeParams";
+export type { InitializeResponse } from "./InitializeResponse";
+export type { InputItem } from "./InputItem";
+export type { InterruptConversationParams } from "./InterruptConversationParams";
+export type { InterruptConversationResponse } from "./InterruptConversationResponse";
+export type { ItemCompletedEvent } from "./ItemCompletedEvent";
+export type { ItemStartedEvent } from "./ItemStartedEvent";
+export type { ListConversationsParams } from "./ListConversationsParams";
+export type { ListConversationsResponse } from "./ListConversationsResponse";
+export type { ListCustomPromptsResponseEvent } from "./ListCustomPromptsResponseEvent";
+export type { ListSkillsResponseEvent } from "./ListSkillsResponseEvent";
+export type { LocalShellAction } from "./LocalShellAction";
+export type { LocalShellExecAction } from "./LocalShellExecAction";
+export type { LocalShellStatus } from "./LocalShellStatus";
+export type { LoginApiKeyParams } from "./LoginApiKeyParams";
+export type { LoginApiKeyResponse } from "./LoginApiKeyResponse";
+export type { LoginChatGptCompleteNotification } from "./LoginChatGptCompleteNotification";
+export type { LoginChatGptResponse } from "./LoginChatGptResponse";
+export type { LogoutChatGptResponse } from "./LogoutChatGptResponse";
+export type { McpAuthStatus } from "./McpAuthStatus";
+export type { McpInvocation } from "./McpInvocation";
+export type { McpListToolsResponseEvent } from "./McpListToolsResponseEvent";
+export type { McpStartupCompleteEvent } from "./McpStartupCompleteEvent";
+export type { McpStartupFailure } from "./McpStartupFailure";
+export type { McpStartupStatus } from "./McpStartupStatus";
+export type { McpStartupUpdateEvent } from "./McpStartupUpdateEvent";
+export type { McpToolCallBeginEvent } from "./McpToolCallBeginEvent";
+export type { McpToolCallEndEvent } from "./McpToolCallEndEvent";
+export type { ModeKind } from "./ModeKind";
+export type { NetworkAccess } from "./NetworkAccess";
+export type { NewConversationParams } from "./NewConversationParams";
+export type { NewConversationResponse } from "./NewConversationResponse";
+export type { ParsedCommand } from "./ParsedCommand";
+export type { PatchApplyBeginEvent } from "./PatchApplyBeginEvent";
+export type { PatchApplyEndEvent } from "./PatchApplyEndEvent";
+export type { Personality } from "./Personality";
+export type { PlanDeltaEvent } from "./PlanDeltaEvent";
+export type { PlanItem } from "./PlanItem";
+export type { PlanItemArg } from "./PlanItemArg";
+export type { PlanType } from "./PlanType";
+export type { Profile } from "./Profile";
+export type { RateLimitSnapshot } from "./RateLimitSnapshot";
+export type { RateLimitWindow } from "./RateLimitWindow";
+export type { RawResponseItemEvent } from "./RawResponseItemEvent";
+export type { ReasoningContentDeltaEvent } from "./ReasoningContentDeltaEvent";
+export type { ReasoningEffort } from "./ReasoningEffort";
+export type { ReasoningItem } from "./ReasoningItem";
+export type { ReasoningItemContent } from "./ReasoningItemContent";
+export type { ReasoningItemReasoningSummary } from "./ReasoningItemReasoningSummary";
+export type { ReasoningRawContentDeltaEvent } from "./ReasoningRawContentDeltaEvent";
+export type { ReasoningSummary } from "./ReasoningSummary";
+export type { RemoveConversationListenerParams } from "./RemoveConversationListenerParams";
+export type { RemoveConversationSubscriptionResponse } from "./RemoveConversationSubscriptionResponse";
+export type { RequestId } from "./RequestId";
+export type { RequestUserInputEvent } from "./RequestUserInputEvent";
+export type { RequestUserInputQuestion } from "./RequestUserInputQuestion";
+export type { RequestUserInputQuestionOption } from "./RequestUserInputQuestionOption";
+export type { Resource } from "./Resource";
+export type { ResourceLink } from "./ResourceLink";
+export type { ResourceTemplate } from "./ResourceTemplate";
+export type { ResponseItem } from "./ResponseItem";
+export type { ResumeConversationParams } from "./ResumeConversationParams";
+export type { ResumeConversationResponse } from "./ResumeConversationResponse";
+export type { ReviewCodeLocation } from "./ReviewCodeLocation";
+export type { ReviewDecision } from "./ReviewDecision";
+export type { ReviewFinding } from "./ReviewFinding";
+export type { ReviewLineRange } from "./ReviewLineRange";
+export type { ReviewOutputEvent } from "./ReviewOutputEvent";
+export type { ReviewRequest } from "./ReviewRequest";
+export type { ReviewTarget } from "./ReviewTarget";
+export type { Role } from "./Role";
+export type { SandboxMode } from "./SandboxMode";
+export type { SandboxPolicy } from "./SandboxPolicy";
+export type { SandboxSettings } from "./SandboxSettings";
+export type { SendUserMessageParams } from "./SendUserMessageParams";
+export type { SendUserMessageResponse } from "./SendUserMessageResponse";
+export type { SendUserTurnParams } from "./SendUserTurnParams";
+export type { SendUserTurnResponse } from "./SendUserTurnResponse";
+export type { ServerNotification } from "./ServerNotification";
+export type { ServerRequest } from "./ServerRequest";
+export type { SessionConfiguredEvent } from "./SessionConfiguredEvent";
+export type { SessionConfiguredNotification } from "./SessionConfiguredNotification";
+export type { SessionSource } from "./SessionSource";
+export type { SetDefaultModelParams } from "./SetDefaultModelParams";
+export type { SetDefaultModelResponse } from "./SetDefaultModelResponse";
+export type { Settings } from "./Settings";
+export type { SkillDependencies } from "./SkillDependencies";
+export type { SkillErrorInfo } from "./SkillErrorInfo";
+export type { SkillInterface } from "./SkillInterface";
+export type { SkillMetadata } from "./SkillMetadata";
+export type { SkillScope } from "./SkillScope";
+export type { SkillToolDependency } from "./SkillToolDependency";
+export type { SkillsListEntry } from "./SkillsListEntry";
+export type { StepStatus } from "./StepStatus";
+export type { StreamErrorEvent } from "./StreamErrorEvent";
+export type { SubAgentSource } from "./SubAgentSource";
+export type { TerminalInteractionEvent } from "./TerminalInteractionEvent";
+export type { TextContent } from "./TextContent";
+export type { TextElement } from "./TextElement";
+export type { TextResourceContents } from "./TextResourceContents";
+export type { ThreadId } from "./ThreadId";
+export type { ThreadNameUpdatedEvent } from "./ThreadNameUpdatedEvent";
+export type { ThreadRolledBackEvent } from "./ThreadRolledBackEvent";
+export type { TokenCountEvent } from "./TokenCountEvent";
+export type { TokenUsage } from "./TokenUsage";
+export type { TokenUsageInfo } from "./TokenUsageInfo";
+export type { Tool } from "./Tool";
+export type { ToolAnnotations } from "./ToolAnnotations";
+export type { ToolInputSchema } from "./ToolInputSchema";
+export type { ToolOutputSchema } from "./ToolOutputSchema";
+export type { Tools } from "./Tools";
+export type { TurnAbortReason } from "./TurnAbortReason";
+export type { TurnAbortedEvent } from "./TurnAbortedEvent";
+export type { TurnCompleteEvent } from "./TurnCompleteEvent";
+export type { TurnDiffEvent } from "./TurnDiffEvent";
+export type { TurnItem } from "./TurnItem";
+export type { TurnStartedEvent } from "./TurnStartedEvent";
+export type { UndoCompletedEvent } from "./UndoCompletedEvent";
+export type { UndoStartedEvent } from "./UndoStartedEvent";
+export type { UpdatePlanArgs } from "./UpdatePlanArgs";
+export type { UserInfoResponse } from "./UserInfoResponse";
+export type { UserInput } from "./UserInput";
+export type { UserMessageEvent } from "./UserMessageEvent";
+export type { UserMessageItem } from "./UserMessageItem";
+export type { UserSavedConfig } from "./UserSavedConfig";
+export type { Verbosity } from "./Verbosity";
+export type { ViewImageToolCallEvent } from "./ViewImageToolCallEvent";
+export type { WarningEvent } from "./WarningEvent";
+export type { WebSearchAction } from "./WebSearchAction";
+export type { WebSearchBeginEvent } from "./WebSearchBeginEvent";
+export type { WebSearchEndEvent } from "./WebSearchEndEvent";
+export type { WebSearchItem } from "./WebSearchItem";
+export type { WebSearchMode } from "./WebSearchMode";
+export * as v2 from "./v2";
diff --git a/codex-rs/app-server-protocol/schema/typescript/serde_json/JsonValue.ts b/codex-rs/app-server-protocol/schema/typescript/serde_json/JsonValue.ts
new file mode 100644
index 0000000000..75cf7389ad
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/serde_json/JsonValue.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type JsonValue = number | string | boolean | Array | { [key in string]?: JsonValue } | null;
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/Account.ts b/codex-rs/app-server-protocol/schema/typescript/v2/Account.ts
new file mode 100644
index 0000000000..f91677499e
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/Account.ts
@@ -0,0 +1,6 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { PlanType } from "../PlanType";
+
+export type Account = { "type": "apiKey", } | { "type": "chatgpt", email: string, planType: PlanType, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/AccountLoginCompletedNotification.ts b/codex-rs/app-server-protocol/schema/typescript/v2/AccountLoginCompletedNotification.ts
new file mode 100644
index 0000000000..587237b275
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/AccountLoginCompletedNotification.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type AccountLoginCompletedNotification = { loginId: string | null, success: boolean, error: string | null, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/AccountRateLimitsUpdatedNotification.ts b/codex-rs/app-server-protocol/schema/typescript/v2/AccountRateLimitsUpdatedNotification.ts
new file mode 100644
index 0000000000..96c735a2eb
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/AccountRateLimitsUpdatedNotification.ts
@@ -0,0 +1,6 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { RateLimitSnapshot } from "./RateLimitSnapshot";
+
+export type AccountRateLimitsUpdatedNotification = { rateLimits: RateLimitSnapshot, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/AccountUpdatedNotification.ts b/codex-rs/app-server-protocol/schema/typescript/v2/AccountUpdatedNotification.ts
new file mode 100644
index 0000000000..eacb815412
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/AccountUpdatedNotification.ts
@@ -0,0 +1,6 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { AuthMode } from "../AuthMode";
+
+export type AccountUpdatedNotification = { authMode: AuthMode | null, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/AgentMessageDeltaNotification.ts b/codex-rs/app-server-protocol/schema/typescript/v2/AgentMessageDeltaNotification.ts
new file mode 100644
index 0000000000..b47985e5b7
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/AgentMessageDeltaNotification.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type AgentMessageDeltaNotification = { threadId: string, turnId: string, itemId: string, delta: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/AnalyticsConfig.ts b/codex-rs/app-server-protocol/schema/typescript/v2/AnalyticsConfig.ts
new file mode 100644
index 0000000000..d095439aee
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/AnalyticsConfig.ts
@@ -0,0 +1,6 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { JsonValue } from "../serde_json/JsonValue";
+
+export type AnalyticsConfig = { enabled: boolean | null, } & ({ [key in string]?: number | string | boolean | Array | { [key in string]?: JsonValue } | null });
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/AppInfo.ts b/codex-rs/app-server-protocol/schema/typescript/v2/AppInfo.ts
new file mode 100644
index 0000000000..6e959cc2ef
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/AppInfo.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type AppInfo = { id: string, name: string, description: string | null, logoUrl: string | null, logoUrlDark: string | null, distributionChannel: string | null, installUrl: string | null, isAccessible: boolean, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/AppsListParams.ts b/codex-rs/app-server-protocol/schema/typescript/v2/AppsListParams.ts
new file mode 100644
index 0000000000..fe925998bf
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/AppsListParams.ts
@@ -0,0 +1,13 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type AppsListParams = {
+/**
+ * Opaque pagination cursor returned by a previous call.
+ */
+cursor: string | null,
+/**
+ * Optional page size; defaults to a reasonable server-side value.
+ */
+limit: number | null, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/AppsListResponse.ts b/codex-rs/app-server-protocol/schema/typescript/v2/AppsListResponse.ts
new file mode 100644
index 0000000000..b6f5c653f2
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/AppsListResponse.ts
@@ -0,0 +1,11 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { AppInfo } from "./AppInfo";
+
+export type AppsListResponse = { data: Array,
+/**
+ * Opaque cursor to pass to the next call to continue after the last item.
+ * If None, there are no more items to return.
+ */
+nextCursor: string | null, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/AskForApproval.ts b/codex-rs/app-server-protocol/schema/typescript/v2/AskForApproval.ts
new file mode 100644
index 0000000000..d3c3e77e39
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/AskForApproval.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type AskForApproval = "untrusted" | "on-failure" | "on-request" | "never";
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/ByteRange.ts b/codex-rs/app-server-protocol/schema/typescript/v2/ByteRange.ts
new file mode 100644
index 0000000000..6cb81b87c0
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/ByteRange.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type ByteRange = { start: number, end: number, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/CancelLoginAccountParams.ts b/codex-rs/app-server-protocol/schema/typescript/v2/CancelLoginAccountParams.ts
new file mode 100644
index 0000000000..8e2e90dfb6
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/CancelLoginAccountParams.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type CancelLoginAccountParams = { loginId: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/CancelLoginAccountResponse.ts b/codex-rs/app-server-protocol/schema/typescript/v2/CancelLoginAccountResponse.ts
new file mode 100644
index 0000000000..2e7b3d03fe
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/CancelLoginAccountResponse.ts
@@ -0,0 +1,6 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { CancelLoginAccountStatus } from "./CancelLoginAccountStatus";
+
+export type CancelLoginAccountResponse = { status: CancelLoginAccountStatus, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/CancelLoginAccountStatus.ts b/codex-rs/app-server-protocol/schema/typescript/v2/CancelLoginAccountStatus.ts
new file mode 100644
index 0000000000..bd851c6a39
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/CancelLoginAccountStatus.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type CancelLoginAccountStatus = "canceled" | "notFound";
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/ChatgptAuthTokensRefreshParams.ts b/codex-rs/app-server-protocol/schema/typescript/v2/ChatgptAuthTokensRefreshParams.ts
new file mode 100644
index 0000000000..75e677f5c6
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/ChatgptAuthTokensRefreshParams.ts
@@ -0,0 +1,16 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ChatgptAuthTokensRefreshReason } from "./ChatgptAuthTokensRefreshReason";
+
+export type ChatgptAuthTokensRefreshParams = { reason: ChatgptAuthTokensRefreshReason,
+/**
+ * Workspace/account identifier that Codex was previously using.
+ *
+ * Clients that manage multiple accounts/workspaces can use this as a hint
+ * to refresh the token for the correct workspace.
+ *
+ * This 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.
+ */
+previousAccountId: string | null, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/ChatgptAuthTokensRefreshReason.ts b/codex-rs/app-server-protocol/schema/typescript/v2/ChatgptAuthTokensRefreshReason.ts
new file mode 100644
index 0000000000..ac4006ba6a
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/ChatgptAuthTokensRefreshReason.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type ChatgptAuthTokensRefreshReason = "unauthorized";
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/ChatgptAuthTokensRefreshResponse.ts b/codex-rs/app-server-protocol/schema/typescript/v2/ChatgptAuthTokensRefreshResponse.ts
new file mode 100644
index 0000000000..f7f7ecba89
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/ChatgptAuthTokensRefreshResponse.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type ChatgptAuthTokensRefreshResponse = { idToken: string, accessToken: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/CodexErrorInfo.ts b/codex-rs/app-server-protocol/schema/typescript/v2/CodexErrorInfo.ts
new file mode 100644
index 0000000000..a1e65c30c0
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/CodexErrorInfo.ts
@@ -0,0 +1,11 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+/**
+ * This translation layer make sure that we expose codex error code in camel case.
+ *
+ * When an upstream HTTP status is available (for example, from the Responses API or a provider),
+ * it is forwarded in `httpStatusCode` on the relevant `codexErrorInfo` variant.
+ */
+export type CodexErrorInfo = "contextWindowExceeded" | "usageLimitExceeded" | { "modelCap": { model: string, reset_after_seconds: bigint | null, } } | { "httpConnectionFailed": { httpStatusCode: number | null, } } | { "responseStreamConnectionFailed": { httpStatusCode: number | null, } } | "internalServerError" | "unauthorized" | "badRequest" | "threadRollbackFailed" | "sandboxError" | { "responseStreamDisconnected": { httpStatusCode: number | null, } } | { "responseTooManyFailedAttempts": { httpStatusCode: number | null, } } | "other";
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/CollabAgentState.ts b/codex-rs/app-server-protocol/schema/typescript/v2/CollabAgentState.ts
new file mode 100644
index 0000000000..785dbf1fe0
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/CollabAgentState.ts
@@ -0,0 +1,6 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { CollabAgentStatus } from "./CollabAgentStatus";
+
+export type CollabAgentState = { status: CollabAgentStatus, message: string | null, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/CollabAgentStatus.ts b/codex-rs/app-server-protocol/schema/typescript/v2/CollabAgentStatus.ts
new file mode 100644
index 0000000000..3672d19dac
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/CollabAgentStatus.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type CollabAgentStatus = "pendingInit" | "running" | "completed" | "errored" | "shutdown" | "notFound";
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/CollabAgentTool.ts b/codex-rs/app-server-protocol/schema/typescript/v2/CollabAgentTool.ts
new file mode 100644
index 0000000000..11db4dbf9a
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/CollabAgentTool.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type CollabAgentTool = "spawnAgent" | "sendInput" | "wait" | "closeAgent";
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/CollabAgentToolCallStatus.ts b/codex-rs/app-server-protocol/schema/typescript/v2/CollabAgentToolCallStatus.ts
new file mode 100644
index 0000000000..f21f7bd5d5
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/CollabAgentToolCallStatus.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type CollabAgentToolCallStatus = "inProgress" | "completed" | "failed";
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/CommandAction.ts b/codex-rs/app-server-protocol/schema/typescript/v2/CommandAction.ts
new file mode 100644
index 0000000000..ac1314c89b
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/CommandAction.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type CommandAction = { "type": "read", command: string, name: string, path: string, } | { "type": "listFiles", command: string, path: string | null, } | { "type": "search", command: string, query: string | null, path: string | null, } | { "type": "unknown", command: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/CommandExecParams.ts b/codex-rs/app-server-protocol/schema/typescript/v2/CommandExecParams.ts
new file mode 100644
index 0000000000..fc9c6a39ce
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/CommandExecParams.ts
@@ -0,0 +1,6 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { SandboxPolicy } from "./SandboxPolicy";
+
+export type CommandExecParams = { command: Array, timeoutMs: number | null, cwd: string | null, sandboxPolicy: SandboxPolicy | null, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/CommandExecResponse.ts b/codex-rs/app-server-protocol/schema/typescript/v2/CommandExecResponse.ts
new file mode 100644
index 0000000000..6887a3e3c2
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/CommandExecResponse.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type CommandExecResponse = { exitCode: number, stdout: string, stderr: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/CommandExecutionApprovalDecision.ts b/codex-rs/app-server-protocol/schema/typescript/v2/CommandExecutionApprovalDecision.ts
new file mode 100644
index 0000000000..80df9bd02c
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/CommandExecutionApprovalDecision.ts
@@ -0,0 +1,6 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ExecPolicyAmendment } from "./ExecPolicyAmendment";
+
+export type CommandExecutionApprovalDecision = "accept" | "acceptForSession" | { "acceptWithExecpolicyAmendment": { execpolicy_amendment: ExecPolicyAmendment, } } | "decline" | "cancel";
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/CommandExecutionOutputDeltaNotification.ts b/codex-rs/app-server-protocol/schema/typescript/v2/CommandExecutionOutputDeltaNotification.ts
new file mode 100644
index 0000000000..90a4ae17e6
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/CommandExecutionOutputDeltaNotification.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type CommandExecutionOutputDeltaNotification = { threadId: string, turnId: string, itemId: string, delta: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/CommandExecutionRequestApprovalParams.ts b/codex-rs/app-server-protocol/schema/typescript/v2/CommandExecutionRequestApprovalParams.ts
new file mode 100644
index 0000000000..3bad1b467c
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/CommandExecutionRequestApprovalParams.ts
@@ -0,0 +1,27 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { CommandAction } from "./CommandAction";
+import type { ExecPolicyAmendment } from "./ExecPolicyAmendment";
+
+export type CommandExecutionRequestApprovalParams = { threadId: string, turnId: string, itemId: string,
+/**
+ * Optional explanatory reason (e.g. request for network access).
+ */
+reason: string | null,
+/**
+ * The command to be executed.
+ */
+command?: string,
+/**
+ * The command's working directory.
+ */
+cwd?: string,
+/**
+ * Best-effort parsed command actions for friendly display.
+ */
+commandActions?: Array,
+/**
+ * Optional proposed execpolicy amendment to allow similar commands without prompting.
+ */
+proposedExecpolicyAmendment: ExecPolicyAmendment | null, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/CommandExecutionRequestApprovalResponse.ts b/codex-rs/app-server-protocol/schema/typescript/v2/CommandExecutionRequestApprovalResponse.ts
new file mode 100644
index 0000000000..33df225621
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/CommandExecutionRequestApprovalResponse.ts
@@ -0,0 +1,6 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { CommandExecutionApprovalDecision } from "./CommandExecutionApprovalDecision";
+
+export type CommandExecutionRequestApprovalResponse = { decision: CommandExecutionApprovalDecision, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/CommandExecutionStatus.ts b/codex-rs/app-server-protocol/schema/typescript/v2/CommandExecutionStatus.ts
new file mode 100644
index 0000000000..c58b3cc7fa
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/CommandExecutionStatus.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type CommandExecutionStatus = "inProgress" | "completed" | "failed" | "declined";
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/Config.ts b/codex-rs/app-server-protocol/schema/typescript/v2/Config.ts
new file mode 100644
index 0000000000..22e84c8f36
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/Config.ts
@@ -0,0 +1,17 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ForcedLoginMethod } from "../ForcedLoginMethod";
+import type { ReasoningEffort } from "../ReasoningEffort";
+import type { ReasoningSummary } from "../ReasoningSummary";
+import type { Verbosity } from "../Verbosity";
+import type { WebSearchMode } from "../WebSearchMode";
+import type { JsonValue } from "../serde_json/JsonValue";
+import type { AnalyticsConfig } from "./AnalyticsConfig";
+import type { AskForApproval } from "./AskForApproval";
+import type { ProfileV2 } from "./ProfileV2";
+import type { SandboxMode } from "./SandboxMode";
+import type { SandboxWorkspaceWrite } from "./SandboxWorkspaceWrite";
+import type { ToolsV2 } from "./ToolsV2";
+
+export type Config = { model: string | null, review_model: string | null, model_context_window: bigint | null, model_auto_compact_token_limit: bigint | null, model_provider: string | null, approval_policy: AskForApproval | null, sandbox_mode: SandboxMode | null, sandbox_workspace_write: SandboxWorkspaceWrite | null, forced_chatgpt_workspace_id: string | null, forced_login_method: ForcedLoginMethod | null, web_search: WebSearchMode | null, tools: ToolsV2 | null, profile: string | null, profiles: { [key in string]?: ProfileV2 }, instructions: string | null, developer_instructions: string | null, compact_prompt: string | null, model_reasoning_effort: ReasoningEffort | null, model_reasoning_summary: ReasoningSummary | null, model_verbosity: Verbosity | null, analytics: AnalyticsConfig | null, } & ({ [key in string]?: number | string | boolean | Array | { [key in string]?: JsonValue } | null });
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/ConfigBatchWriteParams.ts b/codex-rs/app-server-protocol/schema/typescript/v2/ConfigBatchWriteParams.ts
new file mode 100644
index 0000000000..c4012fc339
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/ConfigBatchWriteParams.ts
@@ -0,0 +1,10 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ConfigEdit } from "./ConfigEdit";
+
+export type ConfigBatchWriteParams = { edits: Array,
+/**
+ * Path to the config file to write; defaults to the user's `config.toml` when omitted.
+ */
+filePath: string | null, expectedVersion: string | null, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/ConfigEdit.ts b/codex-rs/app-server-protocol/schema/typescript/v2/ConfigEdit.ts
new file mode 100644
index 0000000000..fee14aab86
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/ConfigEdit.ts
@@ -0,0 +1,7 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { JsonValue } from "../serde_json/JsonValue";
+import type { MergeStrategy } from "./MergeStrategy";
+
+export type ConfigEdit = { keyPath: string, value: JsonValue, mergeStrategy: MergeStrategy, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/ConfigLayer.ts b/codex-rs/app-server-protocol/schema/typescript/v2/ConfigLayer.ts
new file mode 100644
index 0000000000..6fe7c99130
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/ConfigLayer.ts
@@ -0,0 +1,7 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { JsonValue } from "../serde_json/JsonValue";
+import type { ConfigLayerSource } from "./ConfigLayerSource";
+
+export type ConfigLayer = { name: ConfigLayerSource, version: string, config: JsonValue, disabledReason: string | null, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/ConfigLayerMetadata.ts b/codex-rs/app-server-protocol/schema/typescript/v2/ConfigLayerMetadata.ts
new file mode 100644
index 0000000000..fbb334e5fa
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/ConfigLayerMetadata.ts
@@ -0,0 +1,6 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ConfigLayerSource } from "./ConfigLayerSource";
+
+export type ConfigLayerMetadata = { name: ConfigLayerSource, version: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/ConfigLayerSource.ts b/codex-rs/app-server-protocol/schema/typescript/v2/ConfigLayerSource.ts
new file mode 100644
index 0000000000..b20c373bcb
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/ConfigLayerSource.ts
@@ -0,0 +1,16 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { AbsolutePathBuf } from "../AbsolutePathBuf";
+
+export type ConfigLayerSource = { "type": "mdm", domain: string, key: string, } | { "type": "system",
+/**
+ * This is the path to the system config.toml file, though it is not
+ * guaranteed to exist.
+ */
+file: AbsolutePathBuf, } | { "type": "user",
+/**
+ * This is the path to the user's config.toml file, though it is not
+ * guaranteed to exist.
+ */
+file: AbsolutePathBuf, } | { "type": "project", dotCodexFolder: AbsolutePathBuf, } | { "type": "sessionFlags" } | { "type": "legacyManagedConfigTomlFromFile", file: AbsolutePathBuf, } | { "type": "legacyManagedConfigTomlFromMdm" };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/ConfigReadParams.ts b/codex-rs/app-server-protocol/schema/typescript/v2/ConfigReadParams.ts
new file mode 100644
index 0000000000..3cb2394bc5
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/ConfigReadParams.ts
@@ -0,0 +1,11 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type ConfigReadParams = { includeLayers: boolean,
+/**
+ * Optional working directory to resolve project config layers. If specified,
+ * return the effective config as seen from that directory (i.e., including any
+ * project layers between `cwd` and the project/repo root).
+ */
+cwd: string | null, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/ConfigReadResponse.ts b/codex-rs/app-server-protocol/schema/typescript/v2/ConfigReadResponse.ts
new file mode 100644
index 0000000000..6b9c6a5c9a
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/ConfigReadResponse.ts
@@ -0,0 +1,8 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { Config } from "./Config";
+import type { ConfigLayer } from "./ConfigLayer";
+import type { ConfigLayerMetadata } from "./ConfigLayerMetadata";
+
+export type ConfigReadResponse = { config: Config, origins: { [key in string]?: ConfigLayerMetadata }, layers: Array | null, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/ConfigRequirements.ts b/codex-rs/app-server-protocol/schema/typescript/v2/ConfigRequirements.ts
new file mode 100644
index 0000000000..765d0b86cf
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/ConfigRequirements.ts
@@ -0,0 +1,8 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { AskForApproval } from "./AskForApproval";
+import type { ResidencyRequirement } from "./ResidencyRequirement";
+import type { SandboxMode } from "./SandboxMode";
+
+export type ConfigRequirements = { allowedApprovalPolicies: Array | null, allowedSandboxModes: Array | null, enforceResidency: ResidencyRequirement | null, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/ConfigRequirementsReadResponse.ts b/codex-rs/app-server-protocol/schema/typescript/v2/ConfigRequirementsReadResponse.ts
new file mode 100644
index 0000000000..c2891d939e
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/ConfigRequirementsReadResponse.ts
@@ -0,0 +1,10 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ConfigRequirements } from "./ConfigRequirements";
+
+export type ConfigRequirementsReadResponse = {
+/**
+ * Null if no requirements are configured (e.g. no requirements.toml/MDM entries).
+ */
+requirements: ConfigRequirements | null, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/ConfigValueWriteParams.ts b/codex-rs/app-server-protocol/schema/typescript/v2/ConfigValueWriteParams.ts
new file mode 100644
index 0000000000..2dedfe8d02
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/ConfigValueWriteParams.ts
@@ -0,0 +1,11 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { JsonValue } from "../serde_json/JsonValue";
+import type { MergeStrategy } from "./MergeStrategy";
+
+export type ConfigValueWriteParams = { keyPath: string, value: JsonValue, mergeStrategy: MergeStrategy,
+/**
+ * Path to the config file to write; defaults to the user's `config.toml` when omitted.
+ */
+filePath: string | null, expectedVersion: string | null, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/ConfigWarningNotification.ts b/codex-rs/app-server-protocol/schema/typescript/v2/ConfigWarningNotification.ts
new file mode 100644
index 0000000000..fae64c7a2c
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/ConfigWarningNotification.ts
@@ -0,0 +1,22 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { TextRange } from "./TextRange";
+
+export type ConfigWarningNotification = {
+/**
+ * Concise summary of the warning.
+ */
+summary: string,
+/**
+ * Optional extra guidance or error details.
+ */
+details: string | null,
+/**
+ * Optional path to the config file that triggered the warning.
+ */
+path?: string,
+/**
+ * Optional range for the error location inside the config file.
+ */
+range?: TextRange, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/ConfigWriteResponse.ts b/codex-rs/app-server-protocol/schema/typescript/v2/ConfigWriteResponse.ts
new file mode 100644
index 0000000000..536a680b20
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/ConfigWriteResponse.ts
@@ -0,0 +1,12 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { AbsolutePathBuf } from "../AbsolutePathBuf";
+import type { OverriddenMetadata } from "./OverriddenMetadata";
+import type { WriteStatus } from "./WriteStatus";
+
+export type ConfigWriteResponse = { status: WriteStatus, version: string,
+/**
+ * Canonical path to the config file that was written.
+ */
+filePath: AbsolutePathBuf, overriddenMetadata: OverriddenMetadata | null, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/ContextCompactedNotification.ts b/codex-rs/app-server-protocol/schema/typescript/v2/ContextCompactedNotification.ts
new file mode 100644
index 0000000000..6927609de7
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/ContextCompactedNotification.ts
@@ -0,0 +1,8 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+/**
+ * Deprecated: Use `ContextCompaction` item type instead.
+ */
+export type ContextCompactedNotification = { threadId: string, turnId: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/CreditsSnapshot.ts b/codex-rs/app-server-protocol/schema/typescript/v2/CreditsSnapshot.ts
new file mode 100644
index 0000000000..94577df690
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/CreditsSnapshot.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type CreditsSnapshot = { hasCredits: boolean, unlimited: boolean, balance: string | null, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/DeprecationNoticeNotification.ts b/codex-rs/app-server-protocol/schema/typescript/v2/DeprecationNoticeNotification.ts
new file mode 100644
index 0000000000..e0d2e7d6e6
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/DeprecationNoticeNotification.ts
@@ -0,0 +1,13 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type DeprecationNoticeNotification = {
+/**
+ * Concise summary of what is deprecated.
+ */
+summary: string,
+/**
+ * Optional extra guidance, such as migration steps or rationale.
+ */
+details: string | null, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/DynamicToolCallParams.ts b/codex-rs/app-server-protocol/schema/typescript/v2/DynamicToolCallParams.ts
new file mode 100644
index 0000000000..2659da3505
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/DynamicToolCallParams.ts
@@ -0,0 +1,6 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { JsonValue } from "../serde_json/JsonValue";
+
+export type DynamicToolCallParams = { threadId: string, turnId: string, callId: string, tool: string, arguments: JsonValue, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/DynamicToolCallResponse.ts b/codex-rs/app-server-protocol/schema/typescript/v2/DynamicToolCallResponse.ts
new file mode 100644
index 0000000000..a35b9b394a
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/DynamicToolCallResponse.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type DynamicToolCallResponse = { output: string, success: boolean, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/DynamicToolSpec.ts b/codex-rs/app-server-protocol/schema/typescript/v2/DynamicToolSpec.ts
new file mode 100644
index 0000000000..8b39793f3f
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/DynamicToolSpec.ts
@@ -0,0 +1,6 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { JsonValue } from "../serde_json/JsonValue";
+
+export type DynamicToolSpec = { name: string, description: string, inputSchema: JsonValue, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/ErrorNotification.ts b/codex-rs/app-server-protocol/schema/typescript/v2/ErrorNotification.ts
new file mode 100644
index 0000000000..c3032883d4
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/ErrorNotification.ts
@@ -0,0 +1,6 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { TurnError } from "./TurnError";
+
+export type ErrorNotification = { error: TurnError, willRetry: boolean, threadId: string, turnId: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/ExecPolicyAmendment.ts b/codex-rs/app-server-protocol/schema/typescript/v2/ExecPolicyAmendment.ts
new file mode 100644
index 0000000000..e893dd4477
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/ExecPolicyAmendment.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type ExecPolicyAmendment = Array;
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/FeedbackUploadParams.ts b/codex-rs/app-server-protocol/schema/typescript/v2/FeedbackUploadParams.ts
new file mode 100644
index 0000000000..aeccc45773
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/FeedbackUploadParams.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type FeedbackUploadParams = { classification: string, reason: string | null, threadId: string | null, includeLogs: boolean, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/FeedbackUploadResponse.ts b/codex-rs/app-server-protocol/schema/typescript/v2/FeedbackUploadResponse.ts
new file mode 100644
index 0000000000..f0ad9784c0
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/FeedbackUploadResponse.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type FeedbackUploadResponse = { threadId: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/FileChangeApprovalDecision.ts b/codex-rs/app-server-protocol/schema/typescript/v2/FileChangeApprovalDecision.ts
new file mode 100644
index 0000000000..b74ba004b8
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/FileChangeApprovalDecision.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type FileChangeApprovalDecision = "accept" | "acceptForSession" | "decline" | "cancel";
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/FileChangeOutputDeltaNotification.ts b/codex-rs/app-server-protocol/schema/typescript/v2/FileChangeOutputDeltaNotification.ts
new file mode 100644
index 0000000000..1018bd8a2b
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/FileChangeOutputDeltaNotification.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type FileChangeOutputDeltaNotification = { threadId: string, turnId: string, itemId: string, delta: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/FileChangeRequestApprovalParams.ts b/codex-rs/app-server-protocol/schema/typescript/v2/FileChangeRequestApprovalParams.ts
new file mode 100644
index 0000000000..a7dbfbb7c0
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/FileChangeRequestApprovalParams.ts
@@ -0,0 +1,14 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type FileChangeRequestApprovalParams = { threadId: string, turnId: string, itemId: string,
+/**
+ * Optional explanatory reason (e.g. request for extra write access).
+ */
+reason: string | null,
+/**
+ * [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).
+ */
+grantRoot: string | null, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/FileChangeRequestApprovalResponse.ts b/codex-rs/app-server-protocol/schema/typescript/v2/FileChangeRequestApprovalResponse.ts
new file mode 100644
index 0000000000..6f5de6e958
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/FileChangeRequestApprovalResponse.ts
@@ -0,0 +1,6 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { FileChangeApprovalDecision } from "./FileChangeApprovalDecision";
+
+export type FileChangeRequestApprovalResponse = { decision: FileChangeApprovalDecision, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/FileUpdateChange.ts b/codex-rs/app-server-protocol/schema/typescript/v2/FileUpdateChange.ts
new file mode 100644
index 0000000000..c724db2b10
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/FileUpdateChange.ts
@@ -0,0 +1,6 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { PatchChangeKind } from "./PatchChangeKind";
+
+export type FileUpdateChange = { path: string, kind: PatchChangeKind, diff: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/GetAccountParams.ts b/codex-rs/app-server-protocol/schema/typescript/v2/GetAccountParams.ts
new file mode 100644
index 0000000000..efc646d16d
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/GetAccountParams.ts
@@ -0,0 +1,13 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type GetAccountParams = {
+/**
+ * When `true`, requests a proactive token refresh before returning.
+ *
+ * In managed auth mode this triggers the normal refresh-token flow. In
+ * external auth mode this flag is ignored. Clients should refresh tokens
+ * themselves and call `account/login/start` with `chatgptAuthTokens`.
+ */
+refreshToken: boolean, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/GetAccountRateLimitsResponse.ts b/codex-rs/app-server-protocol/schema/typescript/v2/GetAccountRateLimitsResponse.ts
new file mode 100644
index 0000000000..fe970c1d42
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/GetAccountRateLimitsResponse.ts
@@ -0,0 +1,6 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { RateLimitSnapshot } from "./RateLimitSnapshot";
+
+export type GetAccountRateLimitsResponse = { rateLimits: RateLimitSnapshot, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/GetAccountResponse.ts b/codex-rs/app-server-protocol/schema/typescript/v2/GetAccountResponse.ts
new file mode 100644
index 0000000000..83da4f4e5e
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/GetAccountResponse.ts
@@ -0,0 +1,6 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { Account } from "./Account";
+
+export type GetAccountResponse = { account: Account | null, requiresOpenaiAuth: boolean, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/GitInfo.ts b/codex-rs/app-server-protocol/schema/typescript/v2/GitInfo.ts
new file mode 100644
index 0000000000..9559272a0f
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/GitInfo.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type GitInfo = { sha: string | null, branch: string | null, originUrl: string | null, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/ItemCompletedNotification.ts b/codex-rs/app-server-protocol/schema/typescript/v2/ItemCompletedNotification.ts
new file mode 100644
index 0000000000..96122204b4
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/ItemCompletedNotification.ts
@@ -0,0 +1,6 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ThreadItem } from "./ThreadItem";
+
+export type ItemCompletedNotification = { item: ThreadItem, threadId: string, turnId: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/ItemStartedNotification.ts b/codex-rs/app-server-protocol/schema/typescript/v2/ItemStartedNotification.ts
new file mode 100644
index 0000000000..5cf1e7b918
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/ItemStartedNotification.ts
@@ -0,0 +1,6 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ThreadItem } from "./ThreadItem";
+
+export type ItemStartedNotification = { item: ThreadItem, threadId: string, turnId: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/ListMcpServerStatusParams.ts b/codex-rs/app-server-protocol/schema/typescript/v2/ListMcpServerStatusParams.ts
new file mode 100644
index 0000000000..8027087fd8
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/ListMcpServerStatusParams.ts
@@ -0,0 +1,13 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type ListMcpServerStatusParams = {
+/**
+ * Opaque pagination cursor returned by a previous call.
+ */
+cursor: string | null,
+/**
+ * Optional page size; defaults to a server-defined value.
+ */
+limit: number | null, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/ListMcpServerStatusResponse.ts b/codex-rs/app-server-protocol/schema/typescript/v2/ListMcpServerStatusResponse.ts
new file mode 100644
index 0000000000..35a92bdcb9
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/ListMcpServerStatusResponse.ts
@@ -0,0 +1,11 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { McpServerStatus } from "./McpServerStatus";
+
+export type ListMcpServerStatusResponse = { data: Array,
+/**
+ * Opaque cursor to pass to the next call to continue after the last item.
+ * If None, there are no more items to return.
+ */
+nextCursor: string | null, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/LoginAccountParams.ts b/codex-rs/app-server-protocol/schema/typescript/v2/LoginAccountParams.ts
new file mode 100644
index 0000000000..5c1f4c02a5
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/LoginAccountParams.ts
@@ -0,0 +1,17 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type LoginAccountParams = { "type": "apiKey", apiKey: string, } | { "type": "chatgpt" } | { "type": "chatgptAuthTokens",
+/**
+ * ID token (JWT) supplied by the client.
+ *
+ * This token is used for identity and account metadata (email, plan type,
+ * workspace id).
+ */
+idToken: string,
+/**
+ * Access token (JWT) supplied by the client.
+ * This token is used for backend API requests.
+ */
+accessToken: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/LoginAccountResponse.ts b/codex-rs/app-server-protocol/schema/typescript/v2/LoginAccountResponse.ts
new file mode 100644
index 0000000000..cd79f6c83f
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/LoginAccountResponse.ts
@@ -0,0 +1,9 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type LoginAccountResponse = { "type": "apiKey", } | { "type": "chatgpt", loginId: string,
+/**
+ * URL the client should open in a browser to initiate the OAuth flow.
+ */
+authUrl: string, } | { "type": "chatgptAuthTokens", };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/LogoutAccountResponse.ts b/codex-rs/app-server-protocol/schema/typescript/v2/LogoutAccountResponse.ts
new file mode 100644
index 0000000000..ec85cf0ff7
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/LogoutAccountResponse.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type LogoutAccountResponse = Record;
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/McpAuthStatus.ts b/codex-rs/app-server-protocol/schema/typescript/v2/McpAuthStatus.ts
new file mode 100644
index 0000000000..6903a12321
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/McpAuthStatus.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type McpAuthStatus = "unsupported" | "notLoggedIn" | "bearerToken" | "oAuth";
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/McpServerOauthLoginCompletedNotification.ts b/codex-rs/app-server-protocol/schema/typescript/v2/McpServerOauthLoginCompletedNotification.ts
new file mode 100644
index 0000000000..592860ae39
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/McpServerOauthLoginCompletedNotification.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type McpServerOauthLoginCompletedNotification = { name: string, success: boolean, error?: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/McpServerOauthLoginParams.ts b/codex-rs/app-server-protocol/schema/typescript/v2/McpServerOauthLoginParams.ts
new file mode 100644
index 0000000000..0ad8f3948a
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/McpServerOauthLoginParams.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type McpServerOauthLoginParams = { name: string, scopes?: Array, timeoutSecs?: bigint, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/McpServerOauthLoginResponse.ts b/codex-rs/app-server-protocol/schema/typescript/v2/McpServerOauthLoginResponse.ts
new file mode 100644
index 0000000000..5933574765
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/McpServerOauthLoginResponse.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type McpServerOauthLoginResponse = { authorizationUrl: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/McpServerRefreshResponse.ts b/codex-rs/app-server-protocol/schema/typescript/v2/McpServerRefreshResponse.ts
new file mode 100644
index 0000000000..48a25d2fec
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/McpServerRefreshResponse.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type McpServerRefreshResponse = Record;
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/McpServerStatus.ts b/codex-rs/app-server-protocol/schema/typescript/v2/McpServerStatus.ts
new file mode 100644
index 0000000000..430494e268
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/McpServerStatus.ts
@@ -0,0 +1,9 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { Resource } from "../Resource";
+import type { ResourceTemplate } from "../ResourceTemplate";
+import type { Tool } from "../Tool";
+import type { McpAuthStatus } from "./McpAuthStatus";
+
+export type McpServerStatus = { name: string, tools: { [key in string]?: Tool }, resources: Array, resourceTemplates: Array, authStatus: McpAuthStatus, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/McpToolCallError.ts b/codex-rs/app-server-protocol/schema/typescript/v2/McpToolCallError.ts
new file mode 100644
index 0000000000..5e4ae8391b
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/McpToolCallError.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type McpToolCallError = { message: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/McpToolCallProgressNotification.ts b/codex-rs/app-server-protocol/schema/typescript/v2/McpToolCallProgressNotification.ts
new file mode 100644
index 0000000000..c255de2709
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/McpToolCallProgressNotification.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type McpToolCallProgressNotification = { threadId: string, turnId: string, itemId: string, message: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/McpToolCallResult.ts b/codex-rs/app-server-protocol/schema/typescript/v2/McpToolCallResult.ts
new file mode 100644
index 0000000000..93f942a7f9
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/McpToolCallResult.ts
@@ -0,0 +1,7 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ContentBlock } from "../ContentBlock";
+import type { JsonValue } from "../serde_json/JsonValue";
+
+export type McpToolCallResult = { content: Array, structuredContent: JsonValue | null, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/McpToolCallStatus.ts b/codex-rs/app-server-protocol/schema/typescript/v2/McpToolCallStatus.ts
new file mode 100644
index 0000000000..f46bca07e8
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/McpToolCallStatus.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type McpToolCallStatus = "inProgress" | "completed" | "failed";
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/MergeStrategy.ts b/codex-rs/app-server-protocol/schema/typescript/v2/MergeStrategy.ts
new file mode 100644
index 0000000000..098677f289
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/MergeStrategy.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type MergeStrategy = "replace" | "upsert";
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/Model.ts b/codex-rs/app-server-protocol/schema/typescript/v2/Model.ts
new file mode 100644
index 0000000000..b664024d0a
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/Model.ts
@@ -0,0 +1,7 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ReasoningEffort } from "../ReasoningEffort";
+import type { ReasoningEffortOption } from "./ReasoningEffortOption";
+
+export type Model = { id: string, model: string, displayName: string, description: string, supportedReasoningEfforts: Array, defaultReasoningEffort: ReasoningEffort, supportsPersonality: boolean, isDefault: boolean, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/ModelListParams.ts b/codex-rs/app-server-protocol/schema/typescript/v2/ModelListParams.ts
new file mode 100644
index 0000000000..a2b7214b7b
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/ModelListParams.ts
@@ -0,0 +1,13 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type ModelListParams = {
+/**
+ * Opaque pagination cursor returned by a previous call.
+ */
+cursor: string | null,
+/**
+ * Optional page size; defaults to a reasonable server-side value.
+ */
+limit: number | null, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/ModelListResponse.ts b/codex-rs/app-server-protocol/schema/typescript/v2/ModelListResponse.ts
new file mode 100644
index 0000000000..be5ba25dc8
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/ModelListResponse.ts
@@ -0,0 +1,11 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { Model } from "./Model";
+
+export type ModelListResponse = { data: Array,
+/**
+ * Opaque cursor to pass to the next call to continue after the last item.
+ * If None, there are no more items to return.
+ */
+nextCursor: string | null, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/NetworkAccess.ts b/codex-rs/app-server-protocol/schema/typescript/v2/NetworkAccess.ts
new file mode 100644
index 0000000000..7b697b2314
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/NetworkAccess.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type NetworkAccess = "restricted" | "enabled";
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/OverriddenMetadata.ts b/codex-rs/app-server-protocol/schema/typescript/v2/OverriddenMetadata.ts
new file mode 100644
index 0000000000..0f6396bb54
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/OverriddenMetadata.ts
@@ -0,0 +1,7 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { JsonValue } from "../serde_json/JsonValue";
+import type { ConfigLayerMetadata } from "./ConfigLayerMetadata";
+
+export type OverriddenMetadata = { message: string, overridingLayer: ConfigLayerMetadata, effectiveValue: JsonValue, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/PatchApplyStatus.ts b/codex-rs/app-server-protocol/schema/typescript/v2/PatchApplyStatus.ts
new file mode 100644
index 0000000000..620be789e4
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/PatchApplyStatus.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type PatchApplyStatus = "inProgress" | "completed" | "failed" | "declined";
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/PatchChangeKind.ts b/codex-rs/app-server-protocol/schema/typescript/v2/PatchChangeKind.ts
new file mode 100644
index 0000000000..23dda6cb12
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/PatchChangeKind.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type PatchChangeKind = { "type": "add" } | { "type": "delete" } | { "type": "update", move_path: string | null, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/PlanDeltaNotification.ts b/codex-rs/app-server-protocol/schema/typescript/v2/PlanDeltaNotification.ts
new file mode 100644
index 0000000000..5ab359668e
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/PlanDeltaNotification.ts
@@ -0,0 +1,9 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+/**
+ * EXPERIMENTAL - proposed plan streaming deltas for plan items. Clients should
+ * not assume concatenated deltas match the completed plan item content.
+ */
+export type PlanDeltaNotification = { threadId: string, turnId: string, itemId: string, delta: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/ProfileV2.ts b/codex-rs/app-server-protocol/schema/typescript/v2/ProfileV2.ts
new file mode 100644
index 0000000000..56428ba7ab
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/ProfileV2.ts
@@ -0,0 +1,11 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ReasoningEffort } from "../ReasoningEffort";
+import type { ReasoningSummary } from "../ReasoningSummary";
+import type { Verbosity } from "../Verbosity";
+import type { WebSearchMode } from "../WebSearchMode";
+import type { JsonValue } from "../serde_json/JsonValue";
+import type { AskForApproval } from "./AskForApproval";
+
+export type ProfileV2 = { model: string | null, model_provider: string | null, approval_policy: AskForApproval | null, model_reasoning_effort: ReasoningEffort | null, model_reasoning_summary: ReasoningSummary | null, model_verbosity: Verbosity | null, web_search: WebSearchMode | null, chatgpt_base_url: string | null, } & ({ [key in string]?: number | string | boolean | Array | { [key in string]?: JsonValue } | null });
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/RateLimitSnapshot.ts b/codex-rs/app-server-protocol/schema/typescript/v2/RateLimitSnapshot.ts
new file mode 100644
index 0000000000..f1a33f0b13
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/RateLimitSnapshot.ts
@@ -0,0 +1,8 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { PlanType } from "../PlanType";
+import type { CreditsSnapshot } from "./CreditsSnapshot";
+import type { RateLimitWindow } from "./RateLimitWindow";
+
+export type RateLimitSnapshot = { primary: RateLimitWindow | null, secondary: RateLimitWindow | null, credits: CreditsSnapshot | null, planType: PlanType | null, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/RateLimitWindow.ts b/codex-rs/app-server-protocol/schema/typescript/v2/RateLimitWindow.ts
new file mode 100644
index 0000000000..5031f8d93b
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/RateLimitWindow.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type RateLimitWindow = { usedPercent: number, windowDurationMins: number | null, resetsAt: number | null, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/RawResponseItemCompletedNotification.ts b/codex-rs/app-server-protocol/schema/typescript/v2/RawResponseItemCompletedNotification.ts
new file mode 100644
index 0000000000..430c3a066e
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/RawResponseItemCompletedNotification.ts
@@ -0,0 +1,6 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ResponseItem } from "../ResponseItem";
+
+export type RawResponseItemCompletedNotification = { threadId: string, turnId: string, item: ResponseItem, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/ReasoningEffortOption.ts b/codex-rs/app-server-protocol/schema/typescript/v2/ReasoningEffortOption.ts
new file mode 100644
index 0000000000..ec18adfe43
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/ReasoningEffortOption.ts
@@ -0,0 +1,6 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ReasoningEffort } from "../ReasoningEffort";
+
+export type ReasoningEffortOption = { reasoningEffort: ReasoningEffort, description: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/ReasoningSummaryPartAddedNotification.ts b/codex-rs/app-server-protocol/schema/typescript/v2/ReasoningSummaryPartAddedNotification.ts
new file mode 100644
index 0000000000..3585812505
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/ReasoningSummaryPartAddedNotification.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type ReasoningSummaryPartAddedNotification = { threadId: string, turnId: string, itemId: string, summaryIndex: number, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/ReasoningSummaryTextDeltaNotification.ts b/codex-rs/app-server-protocol/schema/typescript/v2/ReasoningSummaryTextDeltaNotification.ts
new file mode 100644
index 0000000000..aa932fa524
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/ReasoningSummaryTextDeltaNotification.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type ReasoningSummaryTextDeltaNotification = { threadId: string, turnId: string, itemId: string, delta: string, summaryIndex: number, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/ReasoningTextDeltaNotification.ts b/codex-rs/app-server-protocol/schema/typescript/v2/ReasoningTextDeltaNotification.ts
new file mode 100644
index 0000000000..86584ba3b8
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/ReasoningTextDeltaNotification.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type ReasoningTextDeltaNotification = { threadId: string, turnId: string, itemId: string, delta: string, contentIndex: number, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/ResidencyRequirement.ts b/codex-rs/app-server-protocol/schema/typescript/v2/ResidencyRequirement.ts
new file mode 100644
index 0000000000..1699c84e7c
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/ResidencyRequirement.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type ResidencyRequirement = "us";
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/ReviewDelivery.ts b/codex-rs/app-server-protocol/schema/typescript/v2/ReviewDelivery.ts
new file mode 100644
index 0000000000..8fbccd1050
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/ReviewDelivery.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type ReviewDelivery = "inline" | "detached";
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/ReviewStartParams.ts b/codex-rs/app-server-protocol/schema/typescript/v2/ReviewStartParams.ts
new file mode 100644
index 0000000000..c36533f2ec
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/ReviewStartParams.ts
@@ -0,0 +1,12 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ReviewDelivery } from "./ReviewDelivery";
+import type { ReviewTarget } from "./ReviewTarget";
+
+export type ReviewStartParams = { threadId: string, target: ReviewTarget,
+/**
+ * Where to run the review: inline (default) on the current thread or
+ * detached on a new thread (returned in `reviewThreadId`).
+ */
+delivery: ReviewDelivery | null, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/ReviewStartResponse.ts b/codex-rs/app-server-protocol/schema/typescript/v2/ReviewStartResponse.ts
new file mode 100644
index 0000000000..25eb6f82fe
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/ReviewStartResponse.ts
@@ -0,0 +1,13 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { Turn } from "./Turn";
+
+export type ReviewStartResponse = { turn: Turn,
+/**
+ * Identifies the thread where the review runs.
+ *
+ * For inline reviews, this is the original thread id.
+ * For detached reviews, this is the id of the new review thread.
+ */
+reviewThreadId: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/ReviewTarget.ts b/codex-rs/app-server-protocol/schema/typescript/v2/ReviewTarget.ts
new file mode 100644
index 0000000000..a79f1e993c
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/ReviewTarget.ts
@@ -0,0 +1,9 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type ReviewTarget = { "type": "uncommittedChanges" } | { "type": "baseBranch", branch: string, } | { "type": "commit", sha: string,
+/**
+ * Optional human-readable label (e.g., commit subject) for UIs.
+ */
+title: string | null, } | { "type": "custom", instructions: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/SandboxMode.ts b/codex-rs/app-server-protocol/schema/typescript/v2/SandboxMode.ts
new file mode 100644
index 0000000000..b8cf4326b9
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/SandboxMode.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type SandboxMode = "read-only" | "workspace-write" | "danger-full-access";
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/SandboxPolicy.ts b/codex-rs/app-server-protocol/schema/typescript/v2/SandboxPolicy.ts
new file mode 100644
index 0000000000..199d7f2a52
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/SandboxPolicy.ts
@@ -0,0 +1,7 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { AbsolutePathBuf } from "../AbsolutePathBuf";
+import type { NetworkAccess } from "./NetworkAccess";
+
+export type SandboxPolicy = { "type": "dangerFullAccess" } | { "type": "readOnly" } | { "type": "externalSandbox", networkAccess: NetworkAccess, } | { "type": "workspaceWrite", writableRoots: Array, networkAccess: boolean, excludeTmpdirEnvVar: boolean, excludeSlashTmp: boolean, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/SandboxWorkspaceWrite.ts b/codex-rs/app-server-protocol/schema/typescript/v2/SandboxWorkspaceWrite.ts
new file mode 100644
index 0000000000..cd19d83f1f
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/SandboxWorkspaceWrite.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type SandboxWorkspaceWrite = { writable_roots: Array, network_access: boolean, exclude_tmpdir_env_var: boolean, exclude_slash_tmp: boolean, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/SessionSource.ts b/codex-rs/app-server-protocol/schema/typescript/v2/SessionSource.ts
new file mode 100644
index 0000000000..b35b421fcd
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/SessionSource.ts
@@ -0,0 +1,6 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { SubAgentSource } from "../SubAgentSource";
+
+export type SessionSource = "cli" | "vscode" | "exec" | "appServer" | { "subAgent": SubAgentSource } | "unknown";
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/SkillDependencies.ts b/codex-rs/app-server-protocol/schema/typescript/v2/SkillDependencies.ts
new file mode 100644
index 0000000000..e2dd4f4241
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/SkillDependencies.ts
@@ -0,0 +1,6 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { SkillToolDependency } from "./SkillToolDependency";
+
+export type SkillDependencies = { tools: Array, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/SkillErrorInfo.ts b/codex-rs/app-server-protocol/schema/typescript/v2/SkillErrorInfo.ts
new file mode 100644
index 0000000000..6eaf035d8c
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/SkillErrorInfo.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type SkillErrorInfo = { path: string, message: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/SkillInterface.ts b/codex-rs/app-server-protocol/schema/typescript/v2/SkillInterface.ts
new file mode 100644
index 0000000000..86c37a0bd7
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/SkillInterface.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type SkillInterface = { displayName?: string, shortDescription?: string, iconSmall?: string, iconLarge?: string, brandColor?: string, defaultPrompt?: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/SkillMetadata.ts b/codex-rs/app-server-protocol/schema/typescript/v2/SkillMetadata.ts
new file mode 100644
index 0000000000..52c0cd4945
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/SkillMetadata.ts
@@ -0,0 +1,12 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { SkillDependencies } from "./SkillDependencies";
+import type { SkillInterface } from "./SkillInterface";
+import type { SkillScope } from "./SkillScope";
+
+export type SkillMetadata = { name: string, description: string,
+/**
+ * Legacy short_description from SKILL.md. Prefer SKILL.json interface.short_description.
+ */
+shortDescription?: string, interface?: SkillInterface, dependencies?: SkillDependencies, path: string, scope: SkillScope, enabled: boolean, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/SkillScope.ts b/codex-rs/app-server-protocol/schema/typescript/v2/SkillScope.ts
new file mode 100644
index 0000000000..997006f5b8
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/SkillScope.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type SkillScope = "user" | "repo" | "system" | "admin";
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/SkillToolDependency.ts b/codex-rs/app-server-protocol/schema/typescript/v2/SkillToolDependency.ts
new file mode 100644
index 0000000000..a5da45e178
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/SkillToolDependency.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type SkillToolDependency = { type: string, value: string, description?: string, transport?: string, command?: string, url?: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/SkillsConfigWriteParams.ts b/codex-rs/app-server-protocol/schema/typescript/v2/SkillsConfigWriteParams.ts
new file mode 100644
index 0000000000..5a4bcf9bc0
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/SkillsConfigWriteParams.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type SkillsConfigWriteParams = { path: string, enabled: boolean, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/SkillsConfigWriteResponse.ts b/codex-rs/app-server-protocol/schema/typescript/v2/SkillsConfigWriteResponse.ts
new file mode 100644
index 0000000000..c0e8ef7cbd
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/SkillsConfigWriteResponse.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type SkillsConfigWriteResponse = { effectiveEnabled: boolean, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/SkillsListEntry.ts b/codex-rs/app-server-protocol/schema/typescript/v2/SkillsListEntry.ts
new file mode 100644
index 0000000000..3f46c98a4a
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/SkillsListEntry.ts
@@ -0,0 +1,7 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { SkillErrorInfo } from "./SkillErrorInfo";
+import type { SkillMetadata } from "./SkillMetadata";
+
+export type SkillsListEntry = { cwd: string, skills: Array, errors: Array, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/SkillsListParams.ts b/codex-rs/app-server-protocol/schema/typescript/v2/SkillsListParams.ts
new file mode 100644
index 0000000000..d44e6551fd
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/SkillsListParams.ts
@@ -0,0 +1,13 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type SkillsListParams = {
+/**
+ * When empty, defaults to the current session working directory.
+ */
+cwds?: Array,
+/**
+ * When true, bypass the skills cache and re-scan skills from disk.
+ */
+forceReload?: boolean, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/SkillsListResponse.ts b/codex-rs/app-server-protocol/schema/typescript/v2/SkillsListResponse.ts
new file mode 100644
index 0000000000..a27c288a94
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/SkillsListResponse.ts
@@ -0,0 +1,6 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { SkillsListEntry } from "./SkillsListEntry";
+
+export type SkillsListResponse = { data: Array, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/TerminalInteractionNotification.ts b/codex-rs/app-server-protocol/schema/typescript/v2/TerminalInteractionNotification.ts
new file mode 100644
index 0000000000..1631f86174
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/TerminalInteractionNotification.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type TerminalInteractionNotification = { threadId: string, turnId: string, itemId: string, processId: string, stdin: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/TextElement.ts b/codex-rs/app-server-protocol/schema/typescript/v2/TextElement.ts
new file mode 100644
index 0000000000..8841d00499
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/TextElement.ts
@@ -0,0 +1,14 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ByteRange } from "./ByteRange";
+
+export type TextElement = {
+/**
+ * Byte range in the parent `text` buffer that this element occupies.
+ */
+byteRange: ByteRange,
+/**
+ * Optional human-readable placeholder for the element, displayed in the UI.
+ */
+placeholder: string | null, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/TextPosition.ts b/codex-rs/app-server-protocol/schema/typescript/v2/TextPosition.ts
new file mode 100644
index 0000000000..e0a6d11a01
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/TextPosition.ts
@@ -0,0 +1,13 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type TextPosition = {
+/**
+ * 1-based line number.
+ */
+line: number,
+/**
+ * 1-based column number (in Unicode scalar values).
+ */
+column: number, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/TextRange.ts b/codex-rs/app-server-protocol/schema/typescript/v2/TextRange.ts
new file mode 100644
index 0000000000..48b68398f1
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/TextRange.ts
@@ -0,0 +1,6 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { TextPosition } from "./TextPosition";
+
+export type TextRange = { start: TextPosition, end: TextPosition, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/Thread.ts b/codex-rs/app-server-protocol/schema/typescript/v2/Thread.ts
new file mode 100644
index 0000000000..5ef567bd23
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/Thread.ts
@@ -0,0 +1,51 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { GitInfo } from "./GitInfo";
+import type { SessionSource } from "./SessionSource";
+import type { Turn } from "./Turn";
+
+export type Thread = { id: string,
+/**
+ * Usually the first user message in the thread, if available.
+ */
+preview: string,
+/**
+ * Model provider used for this thread (for example, 'openai').
+ */
+modelProvider: string,
+/**
+ * Unix timestamp (in seconds) when the thread was created.
+ */
+createdAt: number,
+/**
+ * Unix timestamp (in seconds) when the thread was last updated.
+ */
+updatedAt: number,
+/**
+ * [UNSTABLE] Path to the thread on disk.
+ */
+path: string | null,
+/**
+ * Working directory captured for the thread.
+ */
+cwd: string,
+/**
+ * Version of the CLI that created the thread.
+ */
+cliVersion: string,
+/**
+ * Origin of the thread (CLI, VSCode, codex exec, codex app-server, etc.).
+ */
+source: SessionSource,
+/**
+ * Optional Git metadata captured when the thread was created.
+ */
+gitInfo: GitInfo | null,
+/**
+ * Only populated on `thread/resume`, `thread/rollback`, `thread/fork`, and `thread/read`
+ * (when `includeTurns` is true) responses.
+ * For all other responses and notifications returning a Thread,
+ * the turns field will be an empty list.
+ */
+turns: Array, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/ThreadArchiveParams.ts b/codex-rs/app-server-protocol/schema/typescript/v2/ThreadArchiveParams.ts
new file mode 100644
index 0000000000..ad4071cbfa
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/ThreadArchiveParams.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type ThreadArchiveParams = { threadId: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/ThreadArchiveResponse.ts b/codex-rs/app-server-protocol/schema/typescript/v2/ThreadArchiveResponse.ts
new file mode 100644
index 0000000000..b5954268e3
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/ThreadArchiveResponse.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type ThreadArchiveResponse = Record;
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/ThreadForkParams.ts b/codex-rs/app-server-protocol/schema/typescript/v2/ThreadForkParams.ts
new file mode 100644
index 0000000000..4ecb1b39df
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/ThreadForkParams.ts
@@ -0,0 +1,26 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { JsonValue } from "../serde_json/JsonValue";
+import type { AskForApproval } from "./AskForApproval";
+import type { SandboxMode } from "./SandboxMode";
+
+/**
+ * There are two ways to fork a thread:
+ * 1. By thread_id: load the thread from disk by thread_id and fork it into a new thread.
+ * 2. By path: load the thread from disk by path and fork it into a new thread.
+ *
+ * If using path, the thread_id param will be ignored.
+ *
+ * Prefer using thread_id whenever possible.
+ */
+export type ThreadForkParams = { threadId: string,
+/**
+ * [UNSTABLE] Specify the rollout path to fork from.
+ * If specified, the thread_id param will be ignored.
+ */
+path: string | null,
+/**
+ * Configuration overrides for the forked thread, if any.
+ */
+model: string | null, modelProvider: string | null, cwd: string | null, approvalPolicy: AskForApproval | null, sandbox: SandboxMode | null, config: { [key in string]?: JsonValue } | null, baseInstructions: string | null, developerInstructions: string | null, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/ThreadForkResponse.ts b/codex-rs/app-server-protocol/schema/typescript/v2/ThreadForkResponse.ts
new file mode 100644
index 0000000000..a46480cb7b
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/ThreadForkResponse.ts
@@ -0,0 +1,9 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ReasoningEffort } from "../ReasoningEffort";
+import type { AskForApproval } from "./AskForApproval";
+import type { SandboxPolicy } from "./SandboxPolicy";
+import type { Thread } from "./Thread";
+
+export type ThreadForkResponse = { thread: Thread, model: string, modelProvider: string, cwd: string, approvalPolicy: AskForApproval, sandbox: SandboxPolicy, reasoningEffort: ReasoningEffort | null, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/ThreadItem.ts b/codex-rs/app-server-protocol/schema/typescript/v2/ThreadItem.ts
new file mode 100644
index 0000000000..cd2faf65be
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/ThreadItem.ts
@@ -0,0 +1,81 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { WebSearchAction } from "../WebSearchAction";
+import type { JsonValue } from "../serde_json/JsonValue";
+import type { CollabAgentState } from "./CollabAgentState";
+import type { CollabAgentTool } from "./CollabAgentTool";
+import type { CollabAgentToolCallStatus } from "./CollabAgentToolCallStatus";
+import type { CommandAction } from "./CommandAction";
+import type { CommandExecutionStatus } from "./CommandExecutionStatus";
+import type { FileUpdateChange } from "./FileUpdateChange";
+import type { McpToolCallError } from "./McpToolCallError";
+import type { McpToolCallResult } from "./McpToolCallResult";
+import type { McpToolCallStatus } from "./McpToolCallStatus";
+import type { PatchApplyStatus } from "./PatchApplyStatus";
+import type { UserInput } from "./UserInput";
+
+export type ThreadItem = { "type": "userMessage", id: string, content: Array, } | { "type": "agentMessage", id: string, text: string, } | { "type": "plan", id: string, text: string, } | { "type": "reasoning", id: string, summary: Array, content: Array, } | { "type": "commandExecution", id: string,
+/**
+ * The command to be executed.
+ */
+command: string,
+/**
+ * The command's working directory.
+ */
+cwd: string,
+/**
+ * Identifier for the underlying PTY process (when available).
+ */
+processId: string | null, status: CommandExecutionStatus,
+/**
+ * A best-effort parsing of the command to understand the action(s) it will perform.
+ * This returns a list of CommandAction objects because a single shell command may
+ * be composed of many commands piped together.
+ */
+commandActions: Array,
+/**
+ * The command's output, aggregated from stdout and stderr.
+ */
+aggregatedOutput: string | null,
+/**
+ * The command's exit code.
+ */
+exitCode: number | null,
+/**
+ * The duration of the command execution in milliseconds.
+ */
+durationMs: number | null, } | { "type": "fileChange", id: string, changes: Array, status: PatchApplyStatus, } | { "type": "mcpToolCall", id: string, server: string, tool: string, status: McpToolCallStatus, arguments: JsonValue, result: McpToolCallResult | null, error: McpToolCallError | null,
+/**
+ * The duration of the MCP tool call in milliseconds.
+ */
+durationMs: number | null, } | { "type": "collabAgentToolCall",
+/**
+ * Unique identifier for this collab tool call.
+ */
+id: string,
+/**
+ * Name of the collab tool that was invoked.
+ */
+tool: CollabAgentTool,
+/**
+ * Current status of the collab tool call.
+ */
+status: CollabAgentToolCallStatus,
+/**
+ * Thread ID of the agent issuing the collab request.
+ */
+senderThreadId: string,
+/**
+ * Thread ID of the receiving agent, when applicable. In case of spawn operation,
+ * this corresponds to the newly spawned agent.
+ */
+receiverThreadIds: Array,
+/**
+ * Prompt text sent as part of the collab tool call, when available.
+ */
+prompt: string | null,
+/**
+ * Last known status of the target agents, when available.
+ */
+agentsStates: { [key in string]?: CollabAgentState }, } | { "type": "webSearch", id: string, query: string, action: WebSearchAction | null, } | { "type": "imageView", id: string, path: string, } | { "type": "enteredReviewMode", id: string, review: string, } | { "type": "exitedReviewMode", id: string, review: string, } | { "type": "contextCompaction", id: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/ThreadListParams.ts b/codex-rs/app-server-protocol/schema/typescript/v2/ThreadListParams.ts
new file mode 100644
index 0000000000..357fdd21cd
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/ThreadListParams.ts
@@ -0,0 +1,34 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ThreadSortKey } from "./ThreadSortKey";
+import type { ThreadSourceKind } from "./ThreadSourceKind";
+
+export type ThreadListParams = {
+/**
+ * Opaque pagination cursor returned by a previous call.
+ */
+cursor: string | null,
+/**
+ * Optional page size; defaults to a reasonable server-side value.
+ */
+limit: number | null,
+/**
+ * Optional sort key; defaults to created_at.
+ */
+sortKey: ThreadSortKey | null,
+/**
+ * Optional provider filter; when set, only sessions recorded under these
+ * providers are returned. When present but empty, includes all providers.
+ */
+modelProviders: Array | null,
+/**
+ * Optional source filter; when set, only sessions from these source kinds
+ * are returned. When omitted or empty, defaults to interactive sources.
+ */
+sourceKinds: Array | null,
+/**
+ * Optional archived filter; when set to true, only archived threads are returned.
+ * If false or null, only non-archived threads are returned.
+ */
+archived: boolean | null, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/ThreadListResponse.ts b/codex-rs/app-server-protocol/schema/typescript/v2/ThreadListResponse.ts
new file mode 100644
index 0000000000..3c0296e5e0
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/ThreadListResponse.ts
@@ -0,0 +1,11 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { Thread } from "./Thread";
+
+export type ThreadListResponse = { data: Array,
+/**
+ * Opaque cursor to pass to the next call to continue after the last item.
+ * if None, there are no more items to return.
+ */
+nextCursor: string | null, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/ThreadLoadedListParams.ts b/codex-rs/app-server-protocol/schema/typescript/v2/ThreadLoadedListParams.ts
new file mode 100644
index 0000000000..5419b00bd1
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/ThreadLoadedListParams.ts
@@ -0,0 +1,13 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type ThreadLoadedListParams = {
+/**
+ * Opaque pagination cursor returned by a previous call.
+ */
+cursor: string | null,
+/**
+ * Optional page size; defaults to no limit.
+ */
+limit: number | null, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/ThreadLoadedListResponse.ts b/codex-rs/app-server-protocol/schema/typescript/v2/ThreadLoadedListResponse.ts
new file mode 100644
index 0000000000..d215a45d01
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/ThreadLoadedListResponse.ts
@@ -0,0 +1,14 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type ThreadLoadedListResponse = {
+/**
+ * Thread ids for sessions currently loaded in memory.
+ */
+data: Array,
+/**
+ * Opaque cursor to pass to the next call to continue after the last item.
+ * if None, there are no more items to return.
+ */
+nextCursor: string | null, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/ThreadNameUpdatedNotification.ts b/codex-rs/app-server-protocol/schema/typescript/v2/ThreadNameUpdatedNotification.ts
new file mode 100644
index 0000000000..c944b5aae3
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/ThreadNameUpdatedNotification.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type ThreadNameUpdatedNotification = { threadId: string, threadName?: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/ThreadReadParams.ts b/codex-rs/app-server-protocol/schema/typescript/v2/ThreadReadParams.ts
new file mode 100644
index 0000000000..b274d1e774
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/ThreadReadParams.ts
@@ -0,0 +1,9 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type ThreadReadParams = { threadId: string,
+/**
+ * When true, include turns and their items from rollout history.
+ */
+includeTurns: boolean, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/ThreadReadResponse.ts b/codex-rs/app-server-protocol/schema/typescript/v2/ThreadReadResponse.ts
new file mode 100644
index 0000000000..a6da50649c
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/ThreadReadResponse.ts
@@ -0,0 +1,6 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { Thread } from "./Thread";
+
+export type ThreadReadResponse = { thread: Thread, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/ThreadResumeParams.ts b/codex-rs/app-server-protocol/schema/typescript/v2/ThreadResumeParams.ts
new file mode 100644
index 0000000000..dca685aa47
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/ThreadResumeParams.ts
@@ -0,0 +1,36 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { Personality } from "../Personality";
+import type { ResponseItem } from "../ResponseItem";
+import type { JsonValue } from "../serde_json/JsonValue";
+import type { AskForApproval } from "./AskForApproval";
+import type { SandboxMode } from "./SandboxMode";
+
+/**
+ * There are three ways to resume a thread:
+ * 1. By thread_id: load the thread from disk by thread_id and resume it.
+ * 2. By history: instantiate the thread from memory and resume it.
+ * 3. By path: load the thread from disk by path and resume it.
+ *
+ * The precedence is: history > path > thread_id.
+ * If using history or path, the thread_id param will be ignored.
+ *
+ * Prefer using thread_id whenever possible.
+ */
+export type ThreadResumeParams = { threadId: string,
+/**
+ * [UNSTABLE] FOR CODEX CLOUD - DO NOT USE.
+ * If specified, the thread will be resumed with the provided history
+ * instead of loaded from disk.
+ */
+history: Array | null,
+/**
+ * [UNSTABLE] Specify the rollout path to resume from.
+ * If specified, the thread_id param will be ignored.
+ */
+path: string | null,
+/**
+ * Configuration overrides for the resumed thread, if any.
+ */
+model: string | null, modelProvider: string | null, cwd: string | null, approvalPolicy: AskForApproval | null, sandbox: SandboxMode | null, config: { [key in string]?: JsonValue } | null, baseInstructions: string | null, developerInstructions: string | null, personality: Personality | null, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/ThreadResumeResponse.ts b/codex-rs/app-server-protocol/schema/typescript/v2/ThreadResumeResponse.ts
new file mode 100644
index 0000000000..6d7a70a6a9
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/ThreadResumeResponse.ts
@@ -0,0 +1,9 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ReasoningEffort } from "../ReasoningEffort";
+import type { AskForApproval } from "./AskForApproval";
+import type { SandboxPolicy } from "./SandboxPolicy";
+import type { Thread } from "./Thread";
+
+export type ThreadResumeResponse = { thread: Thread, model: string, modelProvider: string, cwd: string, approvalPolicy: AskForApproval, sandbox: SandboxPolicy, reasoningEffort: ReasoningEffort | null, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/ThreadRollbackParams.ts b/codex-rs/app-server-protocol/schema/typescript/v2/ThreadRollbackParams.ts
new file mode 100644
index 0000000000..b867978202
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/ThreadRollbackParams.ts
@@ -0,0 +1,12 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type ThreadRollbackParams = { threadId: string,
+/**
+ * The number of turns to drop from the end of the thread. Must be >= 1.
+ *
+ * This only modifies the thread's history and does not revert local file changes
+ * that have been made by the agent. Clients are responsible for reverting these changes.
+ */
+numTurns: number, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/ThreadRollbackResponse.ts b/codex-rs/app-server-protocol/schema/typescript/v2/ThreadRollbackResponse.ts
new file mode 100644
index 0000000000..1f88f17630
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/ThreadRollbackResponse.ts
@@ -0,0 +1,14 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { Thread } from "./Thread";
+
+export type ThreadRollbackResponse = {
+/**
+ * The updated thread after applying the rollback, with `turns` populated.
+ *
+ * The ThreadItems stored in each Turn are lossy since we explicitly do not
+ * persist all agent interactions, such as command executions. This is the same
+ * behavior as `thread/resume`.
+ */
+thread: Thread, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/ThreadSetNameParams.ts b/codex-rs/app-server-protocol/schema/typescript/v2/ThreadSetNameParams.ts
new file mode 100644
index 0000000000..82b9b3a1c6
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/ThreadSetNameParams.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type ThreadSetNameParams = { threadId: string, name: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/ThreadSetNameResponse.ts b/codex-rs/app-server-protocol/schema/typescript/v2/ThreadSetNameResponse.ts
new file mode 100644
index 0000000000..09143d251c
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/ThreadSetNameResponse.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type ThreadSetNameResponse = Record;
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/ThreadSortKey.ts b/codex-rs/app-server-protocol/schema/typescript/v2/ThreadSortKey.ts
new file mode 100644
index 0000000000..dbf1b6c40f
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/ThreadSortKey.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type ThreadSortKey = "created_at" | "updated_at";
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/ThreadSourceKind.ts b/codex-rs/app-server-protocol/schema/typescript/v2/ThreadSourceKind.ts
new file mode 100644
index 0000000000..0a464e3d8d
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/ThreadSourceKind.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type ThreadSourceKind = "cli" | "vscode" | "exec" | "appServer" | "subAgent" | "subAgentReview" | "subAgentCompact" | "subAgentThreadSpawn" | "subAgentOther" | "unknown";
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/ThreadStartParams.ts b/codex-rs/app-server-protocol/schema/typescript/v2/ThreadStartParams.ts
new file mode 100644
index 0000000000..3b4c205901
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/ThreadStartParams.ts
@@ -0,0 +1,15 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { Personality } from "../Personality";
+import type { JsonValue } from "../serde_json/JsonValue";
+import type { AskForApproval } from "./AskForApproval";
+import type { SandboxMode } from "./SandboxMode";
+
+export type ThreadStartParams = {model: string | null, modelProvider: string | null, cwd: string | null, approvalPolicy: AskForApproval | null, sandbox: SandboxMode | null, config: { [key in string]?: JsonValue } | null, baseInstructions: string | null, developerInstructions: string | null, personality: Personality | null, ephemeral: boolean | null, /**
+ * If true, opt into emitting raw response items on the event stream.
+ *
+ * This is for internal use only (e.g. Codex Cloud).
+ * (TODO): Figure out a better way to categorize internal / experimental events & protocols.
+ */
+experimentalRawEvents: boolean};
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/ThreadStartResponse.ts b/codex-rs/app-server-protocol/schema/typescript/v2/ThreadStartResponse.ts
new file mode 100644
index 0000000000..4a76f9af20
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/ThreadStartResponse.ts
@@ -0,0 +1,9 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ReasoningEffort } from "../ReasoningEffort";
+import type { AskForApproval } from "./AskForApproval";
+import type { SandboxPolicy } from "./SandboxPolicy";
+import type { Thread } from "./Thread";
+
+export type ThreadStartResponse = { thread: Thread, model: string, modelProvider: string, cwd: string, approvalPolicy: AskForApproval, sandbox: SandboxPolicy, reasoningEffort: ReasoningEffort | null, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/ThreadStartedNotification.ts b/codex-rs/app-server-protocol/schema/typescript/v2/ThreadStartedNotification.ts
new file mode 100644
index 0000000000..83be55772e
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/ThreadStartedNotification.ts
@@ -0,0 +1,6 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { Thread } from "./Thread";
+
+export type ThreadStartedNotification = { thread: Thread, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/ThreadTokenUsage.ts b/codex-rs/app-server-protocol/schema/typescript/v2/ThreadTokenUsage.ts
new file mode 100644
index 0000000000..b452c408e2
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/ThreadTokenUsage.ts
@@ -0,0 +1,6 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { TokenUsageBreakdown } from "./TokenUsageBreakdown";
+
+export type ThreadTokenUsage = { total: TokenUsageBreakdown, last: TokenUsageBreakdown, modelContextWindow: number | null, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/ThreadTokenUsageUpdatedNotification.ts b/codex-rs/app-server-protocol/schema/typescript/v2/ThreadTokenUsageUpdatedNotification.ts
new file mode 100644
index 0000000000..1be282500c
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/ThreadTokenUsageUpdatedNotification.ts
@@ -0,0 +1,6 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ThreadTokenUsage } from "./ThreadTokenUsage";
+
+export type ThreadTokenUsageUpdatedNotification = { threadId: string, turnId: string, tokenUsage: ThreadTokenUsage, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/ThreadUnarchiveParams.ts b/codex-rs/app-server-protocol/schema/typescript/v2/ThreadUnarchiveParams.ts
new file mode 100644
index 0000000000..4e464989e3
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/ThreadUnarchiveParams.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type ThreadUnarchiveParams = { threadId: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/ThreadUnarchiveResponse.ts b/codex-rs/app-server-protocol/schema/typescript/v2/ThreadUnarchiveResponse.ts
new file mode 100644
index 0000000000..96ea5dcdc7
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/ThreadUnarchiveResponse.ts
@@ -0,0 +1,6 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { Thread } from "./Thread";
+
+export type ThreadUnarchiveResponse = { thread: Thread, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/TokenUsageBreakdown.ts b/codex-rs/app-server-protocol/schema/typescript/v2/TokenUsageBreakdown.ts
new file mode 100644
index 0000000000..1d4e408fad
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/TokenUsageBreakdown.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type TokenUsageBreakdown = { totalTokens: number, inputTokens: number, cachedInputTokens: number, outputTokens: number, reasoningOutputTokens: number, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/ToolRequestUserInputAnswer.ts b/codex-rs/app-server-protocol/schema/typescript/v2/ToolRequestUserInputAnswer.ts
new file mode 100644
index 0000000000..0c912db044
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/ToolRequestUserInputAnswer.ts
@@ -0,0 +1,8 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+/**
+ * EXPERIMENTAL. Captures a user's answer to a request_user_input question.
+ */
+export type ToolRequestUserInputAnswer = { answers: Array, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/ToolRequestUserInputOption.ts b/codex-rs/app-server-protocol/schema/typescript/v2/ToolRequestUserInputOption.ts
new file mode 100644
index 0000000000..ab21aca046
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/ToolRequestUserInputOption.ts
@@ -0,0 +1,8 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+/**
+ * EXPERIMENTAL. Defines a single selectable option for request_user_input.
+ */
+export type ToolRequestUserInputOption = { label: string, description: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/ToolRequestUserInputParams.ts b/codex-rs/app-server-protocol/schema/typescript/v2/ToolRequestUserInputParams.ts
new file mode 100644
index 0000000000..bee81cb8e2
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/ToolRequestUserInputParams.ts
@@ -0,0 +1,9 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ToolRequestUserInputQuestion } from "./ToolRequestUserInputQuestion";
+
+/**
+ * EXPERIMENTAL. Params sent with a request_user_input event.
+ */
+export type ToolRequestUserInputParams = { threadId: string, turnId: string, itemId: string, questions: Array, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/ToolRequestUserInputQuestion.ts b/codex-rs/app-server-protocol/schema/typescript/v2/ToolRequestUserInputQuestion.ts
new file mode 100644
index 0000000000..1afc4e47ba
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/ToolRequestUserInputQuestion.ts
@@ -0,0 +1,9 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ToolRequestUserInputOption } from "./ToolRequestUserInputOption";
+
+/**
+ * EXPERIMENTAL. Represents one request_user_input question and its required options.
+ */
+export type ToolRequestUserInputQuestion = { id: string, header: string, question: string, isOther: boolean, isSecret: boolean, options: Array | null, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/ToolRequestUserInputResponse.ts b/codex-rs/app-server-protocol/schema/typescript/v2/ToolRequestUserInputResponse.ts
new file mode 100644
index 0000000000..e4dd8bbca9
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/ToolRequestUserInputResponse.ts
@@ -0,0 +1,9 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ToolRequestUserInputAnswer } from "./ToolRequestUserInputAnswer";
+
+/**
+ * EXPERIMENTAL. Response payload mapping question ids to answers.
+ */
+export type ToolRequestUserInputResponse = { answers: { [key in string]?: ToolRequestUserInputAnswer }, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/ToolsV2.ts b/codex-rs/app-server-protocol/schema/typescript/v2/ToolsV2.ts
new file mode 100644
index 0000000000..0b1bee5146
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/ToolsV2.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type ToolsV2 = { web_search: boolean | null, view_image: boolean | null, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/Turn.ts b/codex-rs/app-server-protocol/schema/typescript/v2/Turn.ts
new file mode 100644
index 0000000000..709ed5ccbe
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/Turn.ts
@@ -0,0 +1,18 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { ThreadItem } from "./ThreadItem";
+import type { TurnError } from "./TurnError";
+import type { TurnStatus } from "./TurnStatus";
+
+export type Turn = { id: string,
+/**
+ * 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.
+ */
+items: Array, status: TurnStatus,
+/**
+ * Only populated when the Turn's status is failed.
+ */
+error: TurnError | null, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/TurnCompletedNotification.ts b/codex-rs/app-server-protocol/schema/typescript/v2/TurnCompletedNotification.ts
new file mode 100644
index 0000000000..e1b151bfa7
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/TurnCompletedNotification.ts
@@ -0,0 +1,6 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { Turn } from "./Turn";
+
+export type TurnCompletedNotification = { threadId: string, turn: Turn, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/TurnDiffUpdatedNotification.ts b/codex-rs/app-server-protocol/schema/typescript/v2/TurnDiffUpdatedNotification.ts
new file mode 100644
index 0000000000..ec2b33349d
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/TurnDiffUpdatedNotification.ts
@@ -0,0 +1,9 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+/**
+ * Notification that the turn-level unified diff has changed.
+ * Contains the latest aggregated diff across all file changes in the turn.
+ */
+export type TurnDiffUpdatedNotification = { threadId: string, turnId: string, diff: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/TurnError.ts b/codex-rs/app-server-protocol/schema/typescript/v2/TurnError.ts
new file mode 100644
index 0000000000..765a8e050b
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/TurnError.ts
@@ -0,0 +1,6 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { CodexErrorInfo } from "./CodexErrorInfo";
+
+export type TurnError = { message: string, codexErrorInfo: CodexErrorInfo | null, additionalDetails: string | null, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/TurnInterruptParams.ts b/codex-rs/app-server-protocol/schema/typescript/v2/TurnInterruptParams.ts
new file mode 100644
index 0000000000..ec35689e6d
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/TurnInterruptParams.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type TurnInterruptParams = { threadId: string, turnId: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/TurnInterruptResponse.ts b/codex-rs/app-server-protocol/schema/typescript/v2/TurnInterruptResponse.ts
new file mode 100644
index 0000000000..7ce6e35bd6
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/TurnInterruptResponse.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type TurnInterruptResponse = Record;
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/TurnPlanStep.ts b/codex-rs/app-server-protocol/schema/typescript/v2/TurnPlanStep.ts
new file mode 100644
index 0000000000..22d1fbb6b3
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/TurnPlanStep.ts
@@ -0,0 +1,6 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { TurnPlanStepStatus } from "./TurnPlanStepStatus";
+
+export type TurnPlanStep = { step: string, status: TurnPlanStepStatus, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/TurnPlanStepStatus.ts b/codex-rs/app-server-protocol/schema/typescript/v2/TurnPlanStepStatus.ts
new file mode 100644
index 0000000000..f6733a6885
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/TurnPlanStepStatus.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type TurnPlanStepStatus = "pending" | "inProgress" | "completed";
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/TurnPlanUpdatedNotification.ts b/codex-rs/app-server-protocol/schema/typescript/v2/TurnPlanUpdatedNotification.ts
new file mode 100644
index 0000000000..ed13cb4a23
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/TurnPlanUpdatedNotification.ts
@@ -0,0 +1,6 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { TurnPlanStep } from "./TurnPlanStep";
+
+export type TurnPlanUpdatedNotification = { threadId: string, turnId: string, explanation: string | null, plan: Array, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/TurnStartParams.ts b/codex-rs/app-server-protocol/schema/typescript/v2/TurnStartParams.ts
new file mode 100644
index 0000000000..4987c9e5c1
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/TurnStartParams.ts
@@ -0,0 +1,50 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { CollaborationMode } from "../CollaborationMode";
+import type { Personality } from "../Personality";
+import type { ReasoningEffort } from "../ReasoningEffort";
+import type { ReasoningSummary } from "../ReasoningSummary";
+import type { JsonValue } from "../serde_json/JsonValue";
+import type { AskForApproval } from "./AskForApproval";
+import type { SandboxPolicy } from "./SandboxPolicy";
+import type { UserInput } from "./UserInput";
+
+export type TurnStartParams = { threadId: string, input: Array,
+/**
+ * Override the working directory for this turn and subsequent turns.
+ */
+cwd: string | null,
+/**
+ * Override the approval policy for this turn and subsequent turns.
+ */
+approvalPolicy: AskForApproval | null,
+/**
+ * Override the sandbox policy for this turn and subsequent turns.
+ */
+sandboxPolicy: SandboxPolicy | null,
+/**
+ * Override the model for this turn and subsequent turns.
+ */
+model: string | null,
+/**
+ * Override the reasoning effort for this turn and subsequent turns.
+ */
+effort: ReasoningEffort | null,
+/**
+ * Override the reasoning summary for this turn and subsequent turns.
+ */
+summary: ReasoningSummary | null,
+/**
+ * Override the personality for this turn and subsequent turns.
+ */
+personality: Personality | null,
+/**
+ * Optional JSON Schema used to constrain the final assistant message for this turn.
+ */
+outputSchema: JsonValue | null,
+/**
+ * EXPERIMENTAL - set a pre-set collaboration mode.
+ * Takes precedence over model, reasoning_effort, and developer instructions if set.
+ */
+collaborationMode: CollaborationMode | null, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/TurnStartResponse.ts b/codex-rs/app-server-protocol/schema/typescript/v2/TurnStartResponse.ts
new file mode 100644
index 0000000000..cc2ee3772a
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/TurnStartResponse.ts
@@ -0,0 +1,6 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { Turn } from "./Turn";
+
+export type TurnStartResponse = { turn: Turn, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/TurnStartedNotification.ts b/codex-rs/app-server-protocol/schema/typescript/v2/TurnStartedNotification.ts
new file mode 100644
index 0000000000..34f71b2465
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/TurnStartedNotification.ts
@@ -0,0 +1,6 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { Turn } from "./Turn";
+
+export type TurnStartedNotification = { threadId: string, turn: Turn, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/TurnStatus.ts b/codex-rs/app-server-protocol/schema/typescript/v2/TurnStatus.ts
new file mode 100644
index 0000000000..476922edc2
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/TurnStatus.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type TurnStatus = "completed" | "interrupted" | "failed" | "inProgress";
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/UserInput.ts b/codex-rs/app-server-protocol/schema/typescript/v2/UserInput.ts
new file mode 100644
index 0000000000..65196fe5d9
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/UserInput.ts
@@ -0,0 +1,10 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+import type { TextElement } from "./TextElement";
+
+export type UserInput = { "type": "text", text: string,
+/**
+ * UI-defined spans within `text` used to render or persist special elements.
+ */
+text_elements: Array, } | { "type": "image", url: string, } | { "type": "localImage", path: string, } | { "type": "skill", name: string, path: string, } | { "type": "mention", name: string, path: string, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/WindowsWorldWritableWarningNotification.ts b/codex-rs/app-server-protocol/schema/typescript/v2/WindowsWorldWritableWarningNotification.ts
new file mode 100644
index 0000000000..a11e7cef49
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/WindowsWorldWritableWarningNotification.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type WindowsWorldWritableWarningNotification = { samplePaths: Array, extraCount: number, failedScan: boolean, };
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/WriteStatus.ts b/codex-rs/app-server-protocol/schema/typescript/v2/WriteStatus.ts
new file mode 100644
index 0000000000..068eb3bdb9
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/WriteStatus.ts
@@ -0,0 +1,5 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+
+export type WriteStatus = "ok" | "okOverridden";
diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/index.ts b/codex-rs/app-server-protocol/schema/typescript/v2/index.ts
new file mode 100644
index 0000000000..10b60a45fd
--- /dev/null
+++ b/codex-rs/app-server-protocol/schema/typescript/v2/index.ts
@@ -0,0 +1,173 @@
+// GENERATED CODE! DO NOT MODIFY BY HAND!
+
+export type { Account } from "./Account";
+export type { AccountLoginCompletedNotification } from "./AccountLoginCompletedNotification";
+export type { AccountRateLimitsUpdatedNotification } from "./AccountRateLimitsUpdatedNotification";
+export type { AccountUpdatedNotification } from "./AccountUpdatedNotification";
+export type { AgentMessageDeltaNotification } from "./AgentMessageDeltaNotification";
+export type { AnalyticsConfig } from "./AnalyticsConfig";
+export type { AppInfo } from "./AppInfo";
+export type { AppsListParams } from "./AppsListParams";
+export type { AppsListResponse } from "./AppsListResponse";
+export type { AskForApproval } from "./AskForApproval";
+export type { ByteRange } from "./ByteRange";
+export type { CancelLoginAccountParams } from "./CancelLoginAccountParams";
+export type { CancelLoginAccountResponse } from "./CancelLoginAccountResponse";
+export type { CancelLoginAccountStatus } from "./CancelLoginAccountStatus";
+export type { ChatgptAuthTokensRefreshParams } from "./ChatgptAuthTokensRefreshParams";
+export type { ChatgptAuthTokensRefreshReason } from "./ChatgptAuthTokensRefreshReason";
+export type { ChatgptAuthTokensRefreshResponse } from "./ChatgptAuthTokensRefreshResponse";
+export type { CodexErrorInfo } from "./CodexErrorInfo";
+export type { CollabAgentState } from "./CollabAgentState";
+export type { CollabAgentStatus } from "./CollabAgentStatus";
+export type { CollabAgentTool } from "./CollabAgentTool";
+export type { CollabAgentToolCallStatus } from "./CollabAgentToolCallStatus";
+export type { CommandAction } from "./CommandAction";
+export type { CommandExecParams } from "./CommandExecParams";
+export type { CommandExecResponse } from "./CommandExecResponse";
+export type { CommandExecutionApprovalDecision } from "./CommandExecutionApprovalDecision";
+export type { CommandExecutionOutputDeltaNotification } from "./CommandExecutionOutputDeltaNotification";
+export type { CommandExecutionRequestApprovalParams } from "./CommandExecutionRequestApprovalParams";
+export type { CommandExecutionRequestApprovalResponse } from "./CommandExecutionRequestApprovalResponse";
+export type { CommandExecutionStatus } from "./CommandExecutionStatus";
+export type { Config } from "./Config";
+export type { ConfigBatchWriteParams } from "./ConfigBatchWriteParams";
+export type { ConfigEdit } from "./ConfigEdit";
+export type { ConfigLayer } from "./ConfigLayer";
+export type { ConfigLayerMetadata } from "./ConfigLayerMetadata";
+export type { ConfigLayerSource } from "./ConfigLayerSource";
+export type { ConfigReadParams } from "./ConfigReadParams";
+export type { ConfigReadResponse } from "./ConfigReadResponse";
+export type { ConfigRequirements } from "./ConfigRequirements";
+export type { ConfigRequirementsReadResponse } from "./ConfigRequirementsReadResponse";
+export type { ConfigValueWriteParams } from "./ConfigValueWriteParams";
+export type { ConfigWarningNotification } from "./ConfigWarningNotification";
+export type { ConfigWriteResponse } from "./ConfigWriteResponse";
+export type { ContextCompactedNotification } from "./ContextCompactedNotification";
+export type { CreditsSnapshot } from "./CreditsSnapshot";
+export type { DeprecationNoticeNotification } from "./DeprecationNoticeNotification";
+export type { DynamicToolCallParams } from "./DynamicToolCallParams";
+export type { DynamicToolCallResponse } from "./DynamicToolCallResponse";
+export type { DynamicToolSpec } from "./DynamicToolSpec";
+export type { ErrorNotification } from "./ErrorNotification";
+export type { ExecPolicyAmendment } from "./ExecPolicyAmendment";
+export type { FeedbackUploadParams } from "./FeedbackUploadParams";
+export type { FeedbackUploadResponse } from "./FeedbackUploadResponse";
+export type { FileChangeApprovalDecision } from "./FileChangeApprovalDecision";
+export type { FileChangeOutputDeltaNotification } from "./FileChangeOutputDeltaNotification";
+export type { FileChangeRequestApprovalParams } from "./FileChangeRequestApprovalParams";
+export type { FileChangeRequestApprovalResponse } from "./FileChangeRequestApprovalResponse";
+export type { FileUpdateChange } from "./FileUpdateChange";
+export type { GetAccountParams } from "./GetAccountParams";
+export type { GetAccountRateLimitsResponse } from "./GetAccountRateLimitsResponse";
+export type { GetAccountResponse } from "./GetAccountResponse";
+export type { GitInfo } from "./GitInfo";
+export type { ItemCompletedNotification } from "./ItemCompletedNotification";
+export type { ItemStartedNotification } from "./ItemStartedNotification";
+export type { ListMcpServerStatusParams } from "./ListMcpServerStatusParams";
+export type { ListMcpServerStatusResponse } from "./ListMcpServerStatusResponse";
+export type { LoginAccountParams } from "./LoginAccountParams";
+export type { LoginAccountResponse } from "./LoginAccountResponse";
+export type { LogoutAccountResponse } from "./LogoutAccountResponse";
+export type { McpAuthStatus } from "./McpAuthStatus";
+export type { McpServerOauthLoginCompletedNotification } from "./McpServerOauthLoginCompletedNotification";
+export type { McpServerOauthLoginParams } from "./McpServerOauthLoginParams";
+export type { McpServerOauthLoginResponse } from "./McpServerOauthLoginResponse";
+export type { McpServerRefreshResponse } from "./McpServerRefreshResponse";
+export type { McpServerStatus } from "./McpServerStatus";
+export type { McpToolCallError } from "./McpToolCallError";
+export type { McpToolCallProgressNotification } from "./McpToolCallProgressNotification";
+export type { McpToolCallResult } from "./McpToolCallResult";
+export type { McpToolCallStatus } from "./McpToolCallStatus";
+export type { MergeStrategy } from "./MergeStrategy";
+export type { Model } from "./Model";
+export type { ModelListParams } from "./ModelListParams";
+export type { ModelListResponse } from "./ModelListResponse";
+export type { NetworkAccess } from "./NetworkAccess";
+export type { OverriddenMetadata } from "./OverriddenMetadata";
+export type { PatchApplyStatus } from "./PatchApplyStatus";
+export type { PatchChangeKind } from "./PatchChangeKind";
+export type { PlanDeltaNotification } from "./PlanDeltaNotification";
+export type { ProfileV2 } from "./ProfileV2";
+export type { RateLimitSnapshot } from "./RateLimitSnapshot";
+export type { RateLimitWindow } from "./RateLimitWindow";
+export type { RawResponseItemCompletedNotification } from "./RawResponseItemCompletedNotification";
+export type { ReasoningEffortOption } from "./ReasoningEffortOption";
+export type { ReasoningSummaryPartAddedNotification } from "./ReasoningSummaryPartAddedNotification";
+export type { ReasoningSummaryTextDeltaNotification } from "./ReasoningSummaryTextDeltaNotification";
+export type { ReasoningTextDeltaNotification } from "./ReasoningTextDeltaNotification";
+export type { ResidencyRequirement } from "./ResidencyRequirement";
+export type { ReviewDelivery } from "./ReviewDelivery";
+export type { ReviewStartParams } from "./ReviewStartParams";
+export type { ReviewStartResponse } from "./ReviewStartResponse";
+export type { ReviewTarget } from "./ReviewTarget";
+export type { SandboxMode } from "./SandboxMode";
+export type { SandboxPolicy } from "./SandboxPolicy";
+export type { SandboxWorkspaceWrite } from "./SandboxWorkspaceWrite";
+export type { SessionSource } from "./SessionSource";
+export type { SkillDependencies } from "./SkillDependencies";
+export type { SkillErrorInfo } from "./SkillErrorInfo";
+export type { SkillInterface } from "./SkillInterface";
+export type { SkillMetadata } from "./SkillMetadata";
+export type { SkillScope } from "./SkillScope";
+export type { SkillToolDependency } from "./SkillToolDependency";
+export type { SkillsConfigWriteParams } from "./SkillsConfigWriteParams";
+export type { SkillsConfigWriteResponse } from "./SkillsConfigWriteResponse";
+export type { SkillsListEntry } from "./SkillsListEntry";
+export type { SkillsListParams } from "./SkillsListParams";
+export type { SkillsListResponse } from "./SkillsListResponse";
+export type { TerminalInteractionNotification } from "./TerminalInteractionNotification";
+export type { TextElement } from "./TextElement";
+export type { TextPosition } from "./TextPosition";
+export type { TextRange } from "./TextRange";
+export type { Thread } from "./Thread";
+export type { ThreadArchiveParams } from "./ThreadArchiveParams";
+export type { ThreadArchiveResponse } from "./ThreadArchiveResponse";
+export type { ThreadForkParams } from "./ThreadForkParams";
+export type { ThreadForkResponse } from "./ThreadForkResponse";
+export type { ThreadItem } from "./ThreadItem";
+export type { ThreadListParams } from "./ThreadListParams";
+export type { ThreadListResponse } from "./ThreadListResponse";
+export type { ThreadLoadedListParams } from "./ThreadLoadedListParams";
+export type { ThreadLoadedListResponse } from "./ThreadLoadedListResponse";
+export type { ThreadNameUpdatedNotification } from "./ThreadNameUpdatedNotification";
+export type { ThreadReadParams } from "./ThreadReadParams";
+export type { ThreadReadResponse } from "./ThreadReadResponse";
+export type { ThreadResumeParams } from "./ThreadResumeParams";
+export type { ThreadResumeResponse } from "./ThreadResumeResponse";
+export type { ThreadRollbackParams } from "./ThreadRollbackParams";
+export type { ThreadRollbackResponse } from "./ThreadRollbackResponse";
+export type { ThreadSetNameParams } from "./ThreadSetNameParams";
+export type { ThreadSetNameResponse } from "./ThreadSetNameResponse";
+export type { ThreadSortKey } from "./ThreadSortKey";
+export type { ThreadSourceKind } from "./ThreadSourceKind";
+export type { ThreadStartParams } from "./ThreadStartParams";
+export type { ThreadStartResponse } from "./ThreadStartResponse";
+export type { ThreadStartedNotification } from "./ThreadStartedNotification";
+export type { ThreadTokenUsage } from "./ThreadTokenUsage";
+export type { ThreadTokenUsageUpdatedNotification } from "./ThreadTokenUsageUpdatedNotification";
+export type { ThreadUnarchiveParams } from "./ThreadUnarchiveParams";
+export type { ThreadUnarchiveResponse } from "./ThreadUnarchiveResponse";
+export type { TokenUsageBreakdown } from "./TokenUsageBreakdown";
+export type { ToolRequestUserInputAnswer } from "./ToolRequestUserInputAnswer";
+export type { ToolRequestUserInputOption } from "./ToolRequestUserInputOption";
+export type { ToolRequestUserInputParams } from "./ToolRequestUserInputParams";
+export type { ToolRequestUserInputQuestion } from "./ToolRequestUserInputQuestion";
+export type { ToolRequestUserInputResponse } from "./ToolRequestUserInputResponse";
+export type { ToolsV2 } from "./ToolsV2";
+export type { Turn } from "./Turn";
+export type { TurnCompletedNotification } from "./TurnCompletedNotification";
+export type { TurnDiffUpdatedNotification } from "./TurnDiffUpdatedNotification";
+export type { TurnError } from "./TurnError";
+export type { TurnInterruptParams } from "./TurnInterruptParams";
+export type { TurnInterruptResponse } from "./TurnInterruptResponse";
+export type { TurnPlanStep } from "./TurnPlanStep";
+export type { TurnPlanStepStatus } from "./TurnPlanStepStatus";
+export type { TurnPlanUpdatedNotification } from "./TurnPlanUpdatedNotification";
+export type { TurnStartParams } from "./TurnStartParams";
+export type { TurnStartResponse } from "./TurnStartResponse";
+export type { TurnStartedNotification } from "./TurnStartedNotification";
+export type { TurnStatus } from "./TurnStatus";
+export type { UserInput } from "./UserInput";
+export type { WindowsWorldWritableWarningNotification } from "./WindowsWorldWritableWarningNotification";
+export type { WriteStatus } from "./WriteStatus";
diff --git a/codex-rs/app-server-protocol/src/bin/write_schema_fixtures.rs b/codex-rs/app-server-protocol/src/bin/write_schema_fixtures.rs
new file mode 100644
index 0000000000..789d30cea2
--- /dev/null
+++ b/codex-rs/app-server-protocol/src/bin/write_schema_fixtures.rs
@@ -0,0 +1,42 @@
+use anyhow::Context;
+use anyhow::Result;
+use clap::Parser;
+use std::path::PathBuf;
+
+#[derive(Parser, Debug)]
+#[command(about = "Regenerate vendored app-server schema fixtures")]
+struct Args {
+ /// Root directory containing `typescript/` and `json/`.
+ #[arg(long = "schema-root", value_name = "DIR")]
+ schema_root: Option,
+
+ /// Optional path to the Prettier executable to format generated TypeScript files.
+ #[arg(short = 'p', long = "prettier", value_name = "PRETTIER_BIN")]
+ prettier: Option,
+
+ /// Include experimental API methods and fields in generated fixtures.
+ #[arg(long = "experimental")]
+ experimental: bool,
+}
+
+fn main() -> Result<()> {
+ let args = Args::parse();
+
+ let schema_root = args
+ .schema_root
+ .unwrap_or_else(|| PathBuf::from(env!("CARGO_MANIFEST_DIR")).join("schema"));
+
+ codex_app_server_protocol::write_schema_fixtures_with_options(
+ &schema_root,
+ args.prettier.as_deref(),
+ codex_app_server_protocol::SchemaFixtureOptions {
+ experimental_api: args.experimental,
+ },
+ )
+ .with_context(|| {
+ format!(
+ "failed to regenerate schema fixtures under {}",
+ schema_root.display()
+ )
+ })
+}
diff --git a/codex-rs/app-server-protocol/src/experimental_api.rs b/codex-rs/app-server-protocol/src/experimental_api.rs
new file mode 100644
index 0000000000..05f45600d9
--- /dev/null
+++ b/codex-rs/app-server-protocol/src/experimental_api.rs
@@ -0,0 +1,70 @@
+/// Marker trait for protocol types that can signal experimental usage.
+pub trait ExperimentalApi {
+ /// Returns a short reason identifier when an experimental method or field is
+ /// used, or `None` when the value is entirely stable.
+ fn experimental_reason(&self) -> Option<&'static str>;
+}
+
+/// Describes an experimental field on a specific type.
+#[derive(Debug, Clone, Copy, PartialEq, Eq)]
+pub struct ExperimentalField {
+ pub type_name: &'static str,
+ pub field_name: &'static str,
+ /// Stable identifier returned when this field is used.
+ /// Convention: `` for method-level gates or `.` for
+ /// field-level gates.
+ pub reason: &'static str,
+}
+
+inventory::collect!(ExperimentalField);
+
+/// Returns all experimental fields registered across the protocol types.
+pub fn experimental_fields() -> Vec<&'static ExperimentalField> {
+ inventory::iter::.into_iter().collect()
+}
+
+/// Constructs a consistent error message for experimental gating.
+pub fn experimental_required_message(reason: &str) -> String {
+ format!("{reason} requires experimentalApi capability")
+}
+
+#[cfg(test)]
+mod tests {
+ use super::ExperimentalApi as ExperimentalApiTrait;
+ use codex_experimental_api_macros::ExperimentalApi;
+ use pretty_assertions::assert_eq;
+
+ #[allow(dead_code)]
+ #[derive(ExperimentalApi)]
+ enum EnumVariantShapes {
+ #[experimental("enum/unit")]
+ Unit,
+ #[experimental("enum/tuple")]
+ Tuple(u8),
+ #[experimental("enum/named")]
+ Named {
+ value: u8,
+ },
+ StableTuple(u8),
+ }
+
+ #[test]
+ fn derive_supports_all_enum_variant_shapes() {
+ assert_eq!(
+ ExperimentalApiTrait::experimental_reason(&EnumVariantShapes::Unit),
+ Some("enum/unit")
+ );
+ assert_eq!(
+ ExperimentalApiTrait::experimental_reason(&EnumVariantShapes::Tuple(1)),
+ Some("enum/tuple")
+ );
+ assert_eq!(
+ ExperimentalApiTrait::experimental_reason(&EnumVariantShapes::Named { value: 1 }),
+ Some("enum/named")
+ );
+ assert_eq!(
+ ExperimentalApiTrait::experimental_reason(&EnumVariantShapes::StableTuple(1)),
+ None
+ );
+ }
+}
diff --git a/codex-rs/app-server-protocol/src/export.rs b/codex-rs/app-server-protocol/src/export.rs
index a60c1be624..7878f72c04 100644
--- a/codex-rs/app-server-protocol/src/export.rs
+++ b/codex-rs/app-server-protocol/src/export.rs
@@ -2,6 +2,7 @@ use crate::ClientNotification;
use crate::ClientRequest;
use crate::ServerNotification;
use crate::ServerRequest;
+use crate::experimental_api::experimental_fields;
use crate::export_client_notification_schemas;
use crate::export_client_param_schemas;
use crate::export_client_response_schemas;
@@ -10,6 +11,9 @@ use crate::export_server_notification_schemas;
use crate::export_server_param_schemas;
use crate::export_server_response_schemas;
use crate::export_server_responses;
+use crate::protocol::common::EXPERIMENTAL_CLIENT_METHOD_PARAM_TYPES;
+use crate::protocol::common::EXPERIMENTAL_CLIENT_METHOD_RESPONSE_TYPES;
+use crate::protocol::common::EXPERIMENTAL_CLIENT_METHODS;
use anyhow::Context;
use anyhow::Result;
use anyhow::anyhow;
@@ -67,6 +71,7 @@ pub struct GenerateTsOptions {
pub generate_indices: bool,
pub ensure_headers: bool,
pub run_prettier: bool,
+ pub experimental_api: bool,
}
impl Default for GenerateTsOptions {
@@ -75,6 +80,7 @@ impl Default for GenerateTsOptions {
generate_indices: true,
ensure_headers: true,
run_prettier: true,
+ experimental_api: false,
}
}
}
@@ -100,6 +106,10 @@ pub fn generate_ts_with_options(
export_server_responses(out_dir)?;
ServerNotification::export_all_to(out_dir)?;
+ if !options.experimental_api {
+ filter_experimental_ts(out_dir)?;
+ }
+
if options.generate_indices {
generate_index_ts(out_dir)?;
generate_index_ts(&v2_out_dir)?;
@@ -140,8 +150,12 @@ pub fn generate_ts_with_options(
}
pub fn generate_json(out_dir: &Path) -> Result<()> {
+ generate_json_with_experimental(out_dir, false)
+}
+
+pub fn generate_json_with_experimental(out_dir: &Path, experimental_api: bool) -> Result<()> {
ensure_dir(out_dir)?;
- let envelope_emitters: &[JsonSchemaEmitter] = &[
+ let envelope_emitters: Vec = vec![
|d| write_json_schema_with_return::(d, "RequestId"),
|d| write_json_schema_with_return::(d, "JSONRPCMessage"),
|d| write_json_schema_with_return::(d, "JSONRPCRequest"),
@@ -157,7 +171,7 @@ pub fn generate_json(out_dir: &Path) -> Result<()> {
];
let mut schemas: Vec = Vec::new();
- for emit in envelope_emitters {
+ for emit in &envelope_emitters {
schemas.push(emit(out_dir)?);
}
@@ -168,15 +182,654 @@ pub fn generate_json(out_dir: &Path) -> Result<()> {
schemas.extend(export_client_notification_schemas(out_dir)?);
schemas.extend(export_server_notification_schemas(out_dir)?);
- let bundle = build_schema_bundle(schemas)?;
+ let mut bundle = build_schema_bundle(schemas)?;
+ if !experimental_api {
+ filter_experimental_schema(&mut bundle)?;
+ }
write_pretty_json(
out_dir.join("codex_app_server_protocol.schemas.json"),
&bundle,
)?;
+ if !experimental_api {
+ filter_experimental_json_files(out_dir)?;
+ }
+
Ok(())
}
+fn filter_experimental_ts(out_dir: &Path) -> Result<()> {
+ let registered_fields = experimental_fields();
+ let experimental_method_types = experimental_method_types();
+ // Most generated TS files are filtered by schema processing, but
+ // `ClientRequest.ts` and any type with `#[experimental(...)]` fields need
+ // direct post-processing because they encode method/field information in
+ // file-local unions/interfaces.
+ filter_client_request_ts(out_dir, EXPERIMENTAL_CLIENT_METHODS)?;
+ filter_experimental_type_fields_ts(out_dir, ®istered_fields)?;
+ remove_generated_type_files(out_dir, &experimental_method_types, "ts")?;
+ Ok(())
+}
+
+/// Removes union arms from `ClientRequest.ts` for methods marked experimental.
+fn filter_client_request_ts(out_dir: &Path, experimental_methods: &[&str]) -> Result<()> {
+ let path = out_dir.join("ClientRequest.ts");
+ if !path.exists() {
+ return Ok(());
+ }
+ let mut content =
+ fs::read_to_string(&path).with_context(|| format!("Failed to read {}", path.display()))?;
+
+ let Some((prefix, body, suffix)) = split_type_alias(&content) else {
+ return Ok(());
+ };
+ let experimental_methods: HashSet<&str> = experimental_methods
+ .iter()
+ .copied()
+ .filter(|method| !method.is_empty())
+ .collect();
+ let arms = split_top_level(&body, '|');
+ let filtered_arms: Vec = arms
+ .into_iter()
+ .filter(|arm| {
+ extract_method_from_arm(arm)
+ .is_none_or(|method| !experimental_methods.contains(method.as_str()))
+ })
+ .collect();
+ let new_body = filtered_arms.join(" | ");
+ content = format!("{prefix}{new_body}{suffix}");
+ content = prune_unused_type_imports(content, &new_body);
+
+ fs::write(&path, content).with_context(|| format!("Failed to write {}", path.display()))?;
+ Ok(())
+}
+
+/// Removes experimental properties from generated TypeScript type files.
+fn filter_experimental_type_fields_ts(
+ out_dir: &Path,
+ experimental_fields: &[&'static crate::experimental_api::ExperimentalField],
+) -> Result<()> {
+ let mut fields_by_type_name: HashMap> = HashMap::new();
+ for field in experimental_fields {
+ fields_by_type_name
+ .entry(field.type_name.to_string())
+ .or_default()
+ .insert(field.field_name.to_string());
+ }
+ if fields_by_type_name.is_empty() {
+ return Ok(());
+ }
+
+ for path in ts_files_in_recursive(out_dir)? {
+ let Some(type_name) = path.file_stem().and_then(|stem| stem.to_str()) else {
+ continue;
+ };
+ let Some(experimental_field_names) = fields_by_type_name.get(type_name) else {
+ continue;
+ };
+ filter_experimental_fields_in_ts_file(&path, experimental_field_names)?;
+ }
+
+ Ok(())
+}
+
+fn filter_experimental_fields_in_ts_file(
+ path: &Path,
+ experimental_field_names: &HashSet,
+) -> Result<()> {
+ let mut content =
+ fs::read_to_string(path).with_context(|| format!("Failed to read {}", path.display()))?;
+ let Some((open_brace, close_brace)) = type_body_brace_span(&content) else {
+ return Ok(());
+ };
+ let inner = &content[open_brace + 1..close_brace];
+ let fields = split_top_level_multi(inner, &[',', ';']);
+ let filtered_fields: Vec = fields
+ .into_iter()
+ .filter(|field| {
+ let field = strip_leading_block_comments(field);
+ parse_property_name(field)
+ .is_none_or(|name| !experimental_field_names.contains(name.as_str()))
+ })
+ .collect();
+ let new_inner = filtered_fields.join(", ");
+ let prefix = &content[..open_brace + 1];
+ let suffix = &content[close_brace..];
+ content = format!("{prefix}{new_inner}{suffix}");
+ content = prune_unused_type_imports(content, &new_inner);
+ fs::write(path, content).with_context(|| format!("Failed to write {}", path.display()))?;
+ Ok(())
+}
+
+fn filter_experimental_schema(bundle: &mut Value) -> Result<()> {
+ let registered_fields = experimental_fields();
+ filter_experimental_fields_in_root(bundle, ®istered_fields);
+ filter_experimental_fields_in_definitions(bundle, ®istered_fields);
+ prune_experimental_methods(bundle, EXPERIMENTAL_CLIENT_METHODS);
+ remove_experimental_method_type_definitions(bundle);
+ Ok(())
+}
+
+fn filter_experimental_fields_in_root(
+ schema: &mut Value,
+ experimental_fields: &[&'static crate::experimental_api::ExperimentalField],
+) {
+ let Some(title) = schema.get("title").and_then(Value::as_str) else {
+ return;
+ };
+ let title = title.to_string();
+
+ for field in experimental_fields {
+ if title != field.type_name {
+ continue;
+ }
+ remove_property_from_schema(schema, field.field_name);
+ }
+}
+
+fn filter_experimental_fields_in_definitions(
+ bundle: &mut Value,
+ experimental_fields: &[&'static crate::experimental_api::ExperimentalField],
+) {
+ let Some(definitions) = bundle.get_mut("definitions").and_then(Value::as_object_mut) else {
+ return;
+ };
+
+ filter_experimental_fields_in_definitions_map(definitions, experimental_fields);
+}
+
+fn filter_experimental_fields_in_definitions_map(
+ definitions: &mut Map,
+ experimental_fields: &[&'static crate::experimental_api::ExperimentalField],
+) {
+ for (def_name, def_schema) in definitions.iter_mut() {
+ if is_namespace_map(def_schema) {
+ if let Some(namespace_defs) = def_schema.as_object_mut() {
+ filter_experimental_fields_in_definitions_map(namespace_defs, experimental_fields);
+ }
+ continue;
+ }
+
+ for field in experimental_fields {
+ if !definition_matches_type(def_name, field.type_name) {
+ continue;
+ }
+ remove_property_from_schema(def_schema, field.field_name);
+ }
+ }
+}
+
+fn is_namespace_map(value: &Value) -> bool {
+ let Value::Object(map) = value else {
+ return false;
+ };
+
+ if map.keys().any(|key| key.starts_with('$')) {
+ return false;
+ }
+
+ let looks_like_schema = map.contains_key("type")
+ || map.contains_key("properties")
+ || map.contains_key("anyOf")
+ || map.contains_key("oneOf")
+ || map.contains_key("allOf");
+
+ !looks_like_schema && map.values().all(Value::is_object)
+}
+
+fn definition_matches_type(def_name: &str, type_name: &str) -> bool {
+ def_name == type_name || def_name.ends_with(&format!("::{type_name}"))
+}
+
+fn remove_property_from_schema(schema: &mut Value, field_name: &str) {
+ if let Some(properties) = schema.get_mut("properties").and_then(Value::as_object_mut) {
+ properties.remove(field_name);
+ }
+
+ if let Some(required) = schema.get_mut("required").and_then(Value::as_array_mut) {
+ required.retain(|entry| entry.as_str() != Some(field_name));
+ }
+
+ if let Some(inner_schema) = schema.get_mut("schema") {
+ remove_property_from_schema(inner_schema, field_name);
+ }
+}
+
+fn prune_experimental_methods(bundle: &mut Value, experimental_methods: &[&str]) {
+ let experimental_methods: HashSet<&str> = experimental_methods
+ .iter()
+ .copied()
+ .filter(|method| !method.is_empty())
+ .collect();
+ prune_experimental_methods_inner(bundle, &experimental_methods);
+}
+
+fn prune_experimental_methods_inner(value: &mut Value, experimental_methods: &HashSet<&str>) {
+ match value {
+ Value::Array(items) => {
+ items.retain(|item| !is_experimental_method_variant(item, experimental_methods));
+ for item in items {
+ prune_experimental_methods_inner(item, experimental_methods);
+ }
+ }
+ Value::Object(map) => {
+ for entry in map.values_mut() {
+ prune_experimental_methods_inner(entry, experimental_methods);
+ }
+ }
+ Value::Null | Value::Bool(_) | Value::Number(_) | Value::String(_) => {}
+ }
+}
+
+fn is_experimental_method_variant(value: &Value, experimental_methods: &HashSet<&str>) -> bool {
+ let Value::Object(map) = value else {
+ return false;
+ };
+ let Some(properties) = map.get("properties").and_then(Value::as_object) else {
+ return false;
+ };
+ let Some(method_schema) = properties.get("method").and_then(Value::as_object) else {
+ return false;
+ };
+
+ if let Some(method) = method_schema.get("const").and_then(Value::as_str) {
+ return experimental_methods.contains(method);
+ }
+
+ if let Some(values) = method_schema.get("enum").and_then(Value::as_array)
+ && values.len() == 1
+ && let Some(method) = values[0].as_str()
+ {
+ return experimental_methods.contains(method);
+ }
+
+ false
+}
+
+fn filter_experimental_json_files(out_dir: &Path) -> Result<()> {
+ for path in json_files_in_recursive(out_dir)? {
+ let mut value = read_json_value(&path)?;
+ filter_experimental_schema(&mut value)?;
+ write_pretty_json(path, &value)?;
+ }
+ let experimental_method_types = experimental_method_types();
+ remove_generated_type_files(out_dir, &experimental_method_types, "json")?;
+ Ok(())
+}
+
+fn experimental_method_types() -> HashSet {
+ let mut type_names = HashSet::new();
+ collect_experimental_type_names(EXPERIMENTAL_CLIENT_METHOD_PARAM_TYPES, &mut type_names);
+ collect_experimental_type_names(EXPERIMENTAL_CLIENT_METHOD_RESPONSE_TYPES, &mut type_names);
+ type_names
+}
+
+fn collect_experimental_type_names(entries: &[&str], out: &mut HashSet) {
+ for entry in entries {
+ let trimmed = entry.trim();
+ if trimmed.is_empty() {
+ continue;
+ }
+ let name = trimmed.rsplit("::").next().unwrap_or(trimmed);
+ if !name.is_empty() {
+ out.insert(name.to_string());
+ }
+ }
+}
+
+fn remove_generated_type_files(
+ out_dir: &Path,
+ type_names: &HashSet,
+ extension: &str,
+) -> Result<()> {
+ for type_name in type_names {
+ for subdir in ["", "v1", "v2"] {
+ let path = if subdir.is_empty() {
+ out_dir.join(format!("{type_name}.{extension}"))
+ } else {
+ out_dir
+ .join(subdir)
+ .join(format!("{type_name}.{extension}"))
+ };
+ if path.exists() {
+ fs::remove_file(&path)
+ .with_context(|| format!("Failed to remove {}", path.display()))?;
+ }
+ }
+ }
+ Ok(())
+}
+
+fn remove_experimental_method_type_definitions(bundle: &mut Value) {
+ let type_names = experimental_method_types();
+ let Some(definitions) = bundle.get_mut("definitions").and_then(Value::as_object_mut) else {
+ return;
+ };
+ remove_experimental_method_type_definitions_map(definitions, &type_names);
+}
+
+fn remove_experimental_method_type_definitions_map(
+ definitions: &mut Map,
+ experimental_type_names: &HashSet,
+) {
+ let keys_to_remove: Vec = definitions
+ .keys()
+ .filter(|def_name| {
+ experimental_type_names
+ .iter()
+ .any(|type_name| definition_matches_type(def_name, type_name))
+ })
+ .cloned()
+ .collect();
+ for key in keys_to_remove {
+ definitions.remove(&key);
+ }
+
+ for value in definitions.values_mut() {
+ if !is_namespace_map(value) {
+ continue;
+ }
+ if let Some(namespace_defs) = value.as_object_mut() {
+ remove_experimental_method_type_definitions_map(
+ namespace_defs,
+ experimental_type_names,
+ );
+ }
+ }
+}
+
+fn prune_unused_type_imports(content: String, type_alias_body: &str) -> String {
+ let trailing_newline = content.ends_with('\n');
+ let mut lines = Vec::new();
+ for line in content.lines() {
+ if let Some(type_name) = parse_imported_type_name(line)
+ && !type_alias_body.contains(type_name)
+ {
+ continue;
+ }
+ lines.push(line);
+ }
+
+ let mut rewritten = lines.join("\n");
+ if trailing_newline {
+ rewritten.push('\n');
+ }
+ rewritten
+}
+
+fn parse_imported_type_name(line: &str) -> Option<&str> {
+ let line = line.trim();
+ let rest = line.strip_prefix("import type {")?;
+ let (type_name, _) = rest.split_once("} from ")?;
+ let type_name = type_name.trim();
+ if type_name.is_empty() || type_name.contains(',') || type_name.contains(" as ") {
+ return None;
+ }
+ Some(type_name)
+}
+
+fn json_files_in_recursive(dir: &Path) -> Result> {
+ let mut out = Vec::new();
+ let mut stack = vec![dir.to_path_buf()];
+ while let Some(current) = stack.pop() {
+ for entry in fs::read_dir(¤t)? {
+ let entry = entry?;
+ let path = entry.path();
+ if path.is_dir() {
+ stack.push(path);
+ continue;
+ }
+ if matches!(path.extension().and_then(|ext| ext.to_str()), Some("json")) {
+ out.push(path);
+ }
+ }
+ }
+ Ok(out)
+}
+
+fn read_json_value(path: &Path) -> Result {
+ let content =
+ fs::read_to_string(path).with_context(|| format!("Failed to read {}", path.display()))?;
+ serde_json::from_str(&content).with_context(|| format!("Failed to parse {}", path.display()))
+}
+
+fn split_type_alias(content: &str) -> Option<(String, String, String)> {
+ let eq_index = content.find('=')?;
+ let semi_index = content.rfind(';')?;
+ if semi_index <= eq_index {
+ return None;
+ }
+ let prefix = content[..eq_index + 1].to_string();
+ let body = content[eq_index + 1..semi_index].to_string();
+ let suffix = content[semi_index..].to_string();
+ Some((prefix, body, suffix))
+}
+
+fn type_body_brace_span(content: &str) -> Option<(usize, usize)> {
+ if let Some(eq_index) = content.find('=') {
+ let after_eq = &content[eq_index + 1..];
+ let (open_rel, close_rel) = find_top_level_brace_span(after_eq)?;
+ return Some((eq_index + 1 + open_rel, eq_index + 1 + close_rel));
+ }
+
+ const INTERFACE_MARKER: &str = "export interface";
+ let interface_index = content.find(INTERFACE_MARKER)?;
+ let after_interface = &content[interface_index + INTERFACE_MARKER.len()..];
+ let (open_rel, close_rel) = find_top_level_brace_span(after_interface)?;
+ Some((
+ interface_index + INTERFACE_MARKER.len() + open_rel,
+ interface_index + INTERFACE_MARKER.len() + close_rel,
+ ))
+}
+
+fn find_top_level_brace_span(input: &str) -> Option<(usize, usize)> {
+ let mut state = ScanState::default();
+ let mut open_index = None;
+ for (index, ch) in input.char_indices() {
+ if !state.in_string() && ch == '{' && state.depth.is_top_level() {
+ open_index = Some(index);
+ }
+ state.observe(ch);
+ if !state.in_string()
+ && ch == '}'
+ && state.depth.is_top_level()
+ && let Some(open) = open_index
+ {
+ return Some((open, index));
+ }
+ }
+ None
+}
+
+fn split_top_level(input: &str, delimiter: char) -> Vec {
+ split_top_level_multi(input, &[delimiter])
+}
+
+fn split_top_level_multi(input: &str, delimiters: &[char]) -> Vec {
+ let mut state = ScanState::default();
+ let mut start = 0usize;
+ let mut parts = Vec::new();
+ for (index, ch) in input.char_indices() {
+ if !state.in_string() && state.depth.is_top_level() && delimiters.contains(&ch) {
+ let part = input[start..index].trim();
+ if !part.is_empty() {
+ parts.push(part.to_string());
+ }
+ start = index + ch.len_utf8();
+ }
+ state.observe(ch);
+ }
+ let tail = input[start..].trim();
+ if !tail.is_empty() {
+ parts.push(tail.to_string());
+ }
+ parts
+}
+
+fn extract_method_from_arm(arm: &str) -> Option {
+ let (open, close) = find_top_level_brace_span(arm)?;
+ let inner = &arm[open + 1..close];
+ for field in split_top_level(inner, ',') {
+ let Some((name, value)) = parse_property(field.as_str()) else {
+ continue;
+ };
+ if name != "method" {
+ continue;
+ }
+ let value = value.trim_start();
+ let (literal, _) = parse_string_literal(value)?;
+ return Some(literal);
+ }
+ None
+}
+
+fn parse_property(input: &str) -> Option<(String, &str)> {
+ let name = parse_property_name(input)?;
+ let colon_index = input.find(':')?;
+ Some((name, input[colon_index + 1..].trim_start()))
+}
+
+fn strip_leading_block_comments(input: &str) -> &str {
+ let mut rest = input.trim_start();
+ loop {
+ let Some(after_prefix) = rest.strip_prefix("/*") else {
+ return rest;
+ };
+ let Some(end_rel) = after_prefix.find("*/") else {
+ return rest;
+ };
+ rest = after_prefix[end_rel + 2..].trim_start();
+ }
+}
+
+fn parse_property_name(input: &str) -> Option {
+ let trimmed = input.trim_start();
+ if trimmed.is_empty() {
+ return None;
+ }
+ if let Some((literal, consumed)) = parse_string_literal(trimmed) {
+ let rest = trimmed[consumed..].trim_start();
+ if rest.starts_with(':') {
+ return Some(literal);
+ }
+ return None;
+ }
+
+ let mut end = 0usize;
+ for (index, ch) in trimmed.char_indices() {
+ if !is_ident_char(ch) {
+ break;
+ }
+ end = index + ch.len_utf8();
+ }
+ if end == 0 {
+ return None;
+ }
+ let name = &trimmed[..end];
+ let rest = trimmed[end..].trim_start();
+ let rest = if let Some(stripped) = rest.strip_prefix('?') {
+ stripped.trim_start()
+ } else {
+ rest
+ };
+ if rest.starts_with(':') {
+ return Some(name.to_string());
+ }
+ None
+}
+
+fn parse_string_literal(input: &str) -> Option<(String, usize)> {
+ let mut chars = input.char_indices();
+ let (start_index, quote) = chars.next()?;
+ if quote != '"' && quote != '\'' {
+ return None;
+ }
+ let mut escape = false;
+ for (index, ch) in chars {
+ if escape {
+ escape = false;
+ continue;
+ }
+ if ch == '\\' {
+ escape = true;
+ continue;
+ }
+ if ch == quote {
+ let literal = input[start_index + 1..index].to_string();
+ let consumed = index + ch.len_utf8();
+ return Some((literal, consumed));
+ }
+ }
+ None
+}
+
+fn is_ident_char(ch: char) -> bool {
+ ch.is_ascii_alphanumeric() || ch == '_'
+}
+
+#[derive(Default)]
+struct ScanState {
+ depth: Depth,
+ string_delim: Option,
+ escape: bool,
+}
+
+impl ScanState {
+ fn observe(&mut self, ch: char) {
+ if let Some(delim) = self.string_delim {
+ if self.escape {
+ self.escape = false;
+ return;
+ }
+ if ch == '\\' {
+ self.escape = true;
+ return;
+ }
+ if ch == delim {
+ self.string_delim = None;
+ }
+ return;
+ }
+
+ match ch {
+ '"' | '\'' => {
+ self.string_delim = Some(ch);
+ }
+ '{' => self.depth.brace += 1,
+ '}' => self.depth.brace = (self.depth.brace - 1).max(0),
+ '[' => self.depth.bracket += 1,
+ ']' => self.depth.bracket = (self.depth.bracket - 1).max(0),
+ '(' => self.depth.paren += 1,
+ ')' => self.depth.paren = (self.depth.paren - 1).max(0),
+ '<' => self.depth.angle += 1,
+ '>' => {
+ if self.depth.angle > 0 {
+ self.depth.angle -= 1;
+ }
+ }
+ _ => {}
+ }
+ }
+
+ fn in_string(&self) -> bool {
+ self.string_delim.is_some()
+ }
+}
+
+#[derive(Default)]
+struct Depth {
+ brace: i32,
+ bracket: i32,
+ paren: i32,
+ angle: i32,
+}
+
+impl Depth {
+ fn is_top_level(&self) -> bool {
+ self.brace == 0 && self.bracket == 0 && self.paren == 0 && self.angle == 0
+ }
+}
+
fn build_schema_bundle(schemas: Vec) -> Result {
const SPECIAL_DEFINITIONS: &[&str] = &[
"ClientNotification",
@@ -740,7 +1393,9 @@ fn generate_index_ts(out_dir: &Path) -> Result {
#[cfg(test)]
mod tests {
use super::*;
+ use crate::protocol::v2;
use anyhow::Result;
+ use pretty_assertions::assert_eq;
use std::collections::BTreeSet;
use std::fs;
use std::path::PathBuf;
@@ -767,9 +1422,34 @@ mod tests {
generate_indices: false,
ensure_headers: false,
run_prettier: false,
+ experimental_api: false,
};
generate_ts_with_options(&output_dir, None, options)?;
+ let client_request_ts = fs::read_to_string(output_dir.join("ClientRequest.ts"))?;
+ assert_eq!(client_request_ts.contains("mock/experimentalMethod"), false);
+ assert_eq!(
+ client_request_ts.contains("MockExperimentalMethodParams"),
+ false
+ );
+ let thread_start_ts =
+ fs::read_to_string(output_dir.join("v2").join("ThreadStartParams.ts"))?;
+ assert_eq!(thread_start_ts.contains("mockExperimentalField"), false);
+ assert_eq!(
+ output_dir
+ .join("v2")
+ .join("MockExperimentalMethodParams.ts")
+ .exists(),
+ false
+ );
+ assert_eq!(
+ output_dir
+ .join("v2")
+ .join("MockExperimentalMethodResponse.ts")
+ .exists(),
+ false
+ );
+
let mut undefined_offenders = Vec::new();
let mut optional_nullable_offenders = BTreeSet::new();
let mut stack = vec![output_dir];
@@ -943,4 +1623,174 @@ mod tests {
Ok(())
}
+
+ #[test]
+ fn generate_ts_with_experimental_api_retains_experimental_entries() -> Result<()> {
+ let output_dir =
+ std::env::temp_dir().join(format!("codex_ts_types_experimental_{}", Uuid::now_v7()));
+ fs::create_dir(&output_dir)?;
+
+ struct TempDirGuard(PathBuf);
+
+ impl Drop for TempDirGuard {
+ fn drop(&mut self) {
+ let _ = fs::remove_dir_all(&self.0);
+ }
+ }
+
+ let _guard = TempDirGuard(output_dir.clone());
+
+ let options = GenerateTsOptions {
+ generate_indices: false,
+ ensure_headers: false,
+ run_prettier: false,
+ experimental_api: true,
+ };
+ generate_ts_with_options(&output_dir, None, options)?;
+
+ let client_request_ts = fs::read_to_string(output_dir.join("ClientRequest.ts"))?;
+ assert_eq!(client_request_ts.contains("mock/experimentalMethod"), true);
+ assert_eq!(
+ output_dir
+ .join("v2")
+ .join("MockExperimentalMethodParams.ts")
+ .exists(),
+ true
+ );
+ assert_eq!(
+ output_dir
+ .join("v2")
+ .join("MockExperimentalMethodResponse.ts")
+ .exists(),
+ true
+ );
+
+ let thread_start_ts =
+ fs::read_to_string(output_dir.join("v2").join("ThreadStartParams.ts"))?;
+ assert_eq!(thread_start_ts.contains("mockExperimentalField"), true);
+
+ Ok(())
+ }
+
+ #[test]
+ fn stable_schema_filter_removes_mock_thread_start_field() -> Result<()> {
+ let output_dir = std::env::temp_dir().join(format!("codex_schema_{}", Uuid::now_v7()));
+ fs::create_dir(&output_dir)?;
+ let schema = write_json_schema_with_return::(
+ &output_dir,
+ "ThreadStartParams",
+ )?;
+ let mut bundle = build_schema_bundle(vec![schema])?;
+ filter_experimental_schema(&mut bundle)?;
+
+ let definitions = bundle["definitions"]
+ .as_object()
+ .expect("schema bundle should include definitions");
+ let (_, def_schema) = definitions
+ .iter()
+ .find(|(name, _)| definition_matches_type(name, "ThreadStartParams"))
+ .expect("ThreadStartParams definition should exist");
+ let properties = def_schema["properties"]
+ .as_object()
+ .expect("ThreadStartParams should have properties");
+ assert_eq!(properties.contains_key("mockExperimentalField"), false);
+ let _cleanup = fs::remove_dir_all(&output_dir);
+ Ok(())
+ }
+
+ #[test]
+ fn experimental_type_fields_ts_filter_handles_interface_shape() -> Result<()> {
+ let output_dir = std::env::temp_dir().join(format!("codex_ts_filter_{}", Uuid::now_v7()));
+ fs::create_dir_all(&output_dir)?;
+
+ struct TempDirGuard(PathBuf);
+
+ impl Drop for TempDirGuard {
+ fn drop(&mut self) {
+ let _ = fs::remove_dir_all(&self.0);
+ }
+ }
+
+ let _guard = TempDirGuard(output_dir.clone());
+ let path = output_dir.join("CustomParams.ts");
+ let content = r#"export interface CustomParams {
+ stableField: string | null;
+ unstableField: string | null;
+ otherStableField: boolean;
+}
+"#;
+ fs::write(&path, content)?;
+
+ static CUSTOM_FIELD: crate::experimental_api::ExperimentalField =
+ crate::experimental_api::ExperimentalField {
+ type_name: "CustomParams",
+ field_name: "unstableField",
+ reason: "custom/unstableField",
+ };
+ filter_experimental_type_fields_ts(&output_dir, &[&CUSTOM_FIELD])?;
+
+ let filtered = fs::read_to_string(&path)?;
+ assert_eq!(filtered.contains("unstableField"), false);
+ assert_eq!(filtered.contains("stableField"), true);
+ assert_eq!(filtered.contains("otherStableField"), true);
+ Ok(())
+ }
+
+ #[test]
+ fn stable_schema_filter_removes_mock_experimental_method() -> Result<()> {
+ let output_dir = std::env::temp_dir().join(format!("codex_schema_{}", Uuid::now_v7()));
+ fs::create_dir(&output_dir)?;
+ let schema =
+ write_json_schema_with_return::(&output_dir, "ClientRequest")?;
+ let mut bundle = build_schema_bundle(vec![schema])?;
+ filter_experimental_schema(&mut bundle)?;
+
+ let bundle_str = serde_json::to_string(&bundle)?;
+ assert_eq!(bundle_str.contains("mock/experimentalMethod"), false);
+ let _cleanup = fs::remove_dir_all(&output_dir);
+ Ok(())
+ }
+
+ #[test]
+ fn generate_json_filters_experimental_fields_and_methods() -> Result<()> {
+ let output_dir = std::env::temp_dir().join(format!("codex_schema_{}", Uuid::now_v7()));
+ fs::create_dir(&output_dir)?;
+ generate_json_with_experimental(&output_dir, false)?;
+
+ let thread_start_json =
+ fs::read_to_string(output_dir.join("v2").join("ThreadStartParams.json"))?;
+ assert_eq!(thread_start_json.contains("mockExperimentalField"), false);
+
+ let client_request_json = fs::read_to_string(output_dir.join("ClientRequest.json"))?;
+ assert_eq!(
+ client_request_json.contains("mock/experimentalMethod"),
+ false
+ );
+
+ let bundle_json =
+ fs::read_to_string(output_dir.join("codex_app_server_protocol.schemas.json"))?;
+ assert_eq!(bundle_json.contains("mockExperimentalField"), false);
+ assert_eq!(bundle_json.contains("MockExperimentalMethodParams"), false);
+ assert_eq!(
+ bundle_json.contains("MockExperimentalMethodResponse"),
+ false
+ );
+ assert_eq!(
+ output_dir
+ .join("v2")
+ .join("MockExperimentalMethodParams.json")
+ .exists(),
+ false
+ );
+ assert_eq!(
+ output_dir
+ .join("v2")
+ .join("MockExperimentalMethodResponse.json")
+ .exists(),
+ false
+ );
+
+ let _cleanup = fs::remove_dir_all(&output_dir);
+ Ok(())
+ }
}
diff --git a/codex-rs/app-server-protocol/src/lib.rs b/codex-rs/app-server-protocol/src/lib.rs
index 06102083f4..54a933bb74 100644
--- a/codex-rs/app-server-protocol/src/lib.rs
+++ b/codex-rs/app-server-protocol/src/lib.rs
@@ -1,12 +1,22 @@
+mod experimental_api;
mod export;
mod jsonrpc_lite;
mod protocol;
+mod schema_fixtures;
+pub use experimental_api::*;
+pub use export::GenerateTsOptions;
pub use export::generate_json;
+pub use export::generate_json_with_experimental;
pub use export::generate_ts;
+pub use export::generate_ts_with_options;
pub use export::generate_types;
pub use jsonrpc_lite::*;
pub use protocol::common::*;
pub use protocol::thread_history::*;
pub use protocol::v1::*;
pub use protocol::v2::*;
+pub use schema_fixtures::SchemaFixtureOptions;
+pub use schema_fixtures::read_schema_fixture_tree;
+pub use schema_fixtures::write_schema_fixtures;
+pub use schema_fixtures::write_schema_fixtures_with_options;
diff --git a/codex-rs/app-server-protocol/src/protocol/common.rs b/codex-rs/app-server-protocol/src/protocol/common.rs
index eb59480b58..d20f23a88a 100644
--- a/codex-rs/app-server-protocol/src/protocol/common.rs
+++ b/codex-rs/app-server-protocol/src/protocol/common.rs
@@ -41,6 +41,42 @@ pub enum AuthMode {
ChatgptAuthTokens,
}
+macro_rules! experimental_reason_expr {
+ // If a request variant is explicitly marked experimental, that reason wins.
+ (#[experimental($reason:expr)] $params:ident $(, $inspect_params:tt)?) => {
+ Some($reason)
+ };
+ // `inspect_params: true` is used when a method is mostly stable but needs
+ // field-level gating from its params type (for example, ThreadStart).
+ ($params:ident, true) => {
+ crate::experimental_api::ExperimentalApi::experimental_reason($params)
+ };
+ ($params:ident $(, $inspect_params:tt)?) => {
+ None
+ };
+}
+
+macro_rules! experimental_method_entry {
+ (#[experimental($reason:expr)] => $wire:literal) => {
+ $wire
+ };
+ (#[experimental($reason:expr)]) => {
+ $reason
+ };
+ ($($tt:tt)*) => {
+ ""
+ };
+}
+
+macro_rules! experimental_type_entry {
+ (#[experimental($reason:expr)] $ty:ty) => {
+ stringify!($ty)
+ };
+ ($ty:ty) => {
+ ""
+ };
+}
+
/// Generates an `enum ClientRequest` where each variant is a request that the
/// client can send to the server. Each variant has associated `params` and
/// `response` types. Also generates a `export_client_responses()` function to
@@ -48,9 +84,11 @@ pub enum AuthMode {
macro_rules! client_request_definitions {
(
$(
- $(#[$variant_meta:meta])*
+ $(#[experimental($reason:expr)])?
+ $(#[doc = $variant_doc:literal])*
$variant:ident $(=> $wire:literal)? {
params: $(#[$params_meta:meta])* $params:ty,
+ $(inspect_params: $inspect_params:tt,)?
response: $response:ty,
}
),* $(,)?
@@ -60,7 +98,7 @@ macro_rules! client_request_definitions {
#[serde(tag = "method", rename_all = "camelCase")]
pub enum ClientRequest {
$(
- $(#[$variant_meta])*
+ $(#[doc = $variant_doc])*
$(#[serde(rename = $wire)] #[ts(rename = $wire)])?
$variant {
#[serde(rename = "id")]
@@ -71,6 +109,38 @@ macro_rules! client_request_definitions {
)*
}
+ impl crate::experimental_api::ExperimentalApi for ClientRequest {
+ fn experimental_reason(&self) -> Option<&'static str> {
+ match self {
+ $(
+ Self::$variant { params: _params, .. } => {
+ experimental_reason_expr!(
+ $(#[experimental($reason)])?
+ _params
+ $(, $inspect_params)?
+ )
+ }
+ )*
+ }
+ }
+ }
+
+ pub(crate) const EXPERIMENTAL_CLIENT_METHODS: &[&str] = &[
+ $(
+ experimental_method_entry!($(#[experimental($reason)])? $(=> $wire)?),
+ )*
+ ];
+ pub(crate) const EXPERIMENTAL_CLIENT_METHOD_PARAM_TYPES: &[&str] = &[
+ $(
+ experimental_type_entry!($(#[experimental($reason)])? $params),
+ )*
+ ];
+ pub(crate) const EXPERIMENTAL_CLIENT_METHOD_RESPONSE_TYPES: &[&str] = &[
+ $(
+ experimental_type_entry!($(#[experimental($reason)])? $response),
+ )*
+ ];
+
pub fn export_client_responses(
out_dir: &::std::path::Path,
) -> ::std::result::Result<(), ::ts_rs::ExportError> {
@@ -112,8 +182,10 @@ client_request_definitions! {
/// NEW APIs
// Thread lifecycle
+ // Uses `inspect_params` because only some fields are experimental.
ThreadStart => "thread/start" {
params: v2::ThreadStartParams,
+ inspect_params: true,
response: v2::ThreadStartResponse,
},
ThreadResume => "thread/resume" {
@@ -181,11 +253,18 @@ client_request_definitions! {
params: v2::ModelListParams,
response: v2::ModelListResponse,
},
- /// EXPERIMENTAL - list collaboration mode presets.
+ #[experimental("collaborationMode/list")]
+ /// Lists collaboration mode presets.
CollaborationModeList => "collaborationMode/list" {
params: v2::CollaborationModeListParams,
response: v2::CollaborationModeListResponse,
},
+ #[experimental("mock/experimentalMethod")]
+ /// Test-only method used to validate experimental gating.
+ MockExperimentalMethod => "mock/experimentalMethod" {
+ params: v2::MockExperimentalMethodParams,
+ response: v2::MockExperimentalMethodResponse,
+ },
McpServerOauthLogin => "mcpServer/oauth/login" {
params: v2::McpServerOauthLoginParams,
@@ -995,4 +1074,27 @@ mod tests {
);
Ok(())
}
+
+ #[test]
+ fn mock_experimental_method_is_marked_experimental() {
+ let request = ClientRequest::MockExperimentalMethod {
+ request_id: RequestId::Integer(1),
+ params: v2::MockExperimentalMethodParams::default(),
+ };
+ let reason = crate::experimental_api::ExperimentalApi::experimental_reason(&request);
+ assert_eq!(reason, Some("mock/experimentalMethod"));
+ }
+
+ #[test]
+ fn thread_start_mock_field_is_marked_experimental() {
+ let request = ClientRequest::ThreadStart {
+ request_id: RequestId::Integer(1),
+ params: v2::ThreadStartParams {
+ mock_experimental_field: Some("mock".to_string()),
+ ..Default::default()
+ },
+ };
+ let reason = crate::experimental_api::ExperimentalApi::experimental_reason(&request);
+ assert_eq!(reason, Some("thread/start.mockExperimentalField"));
+ }
}
diff --git a/codex-rs/app-server-protocol/src/protocol/v1.rs b/codex-rs/app-server-protocol/src/protocol/v1.rs
index 488862b842..09b4130b5d 100644
--- a/codex-rs/app-server-protocol/src/protocol/v1.rs
+++ b/codex-rs/app-server-protocol/src/protocol/v1.rs
@@ -33,6 +33,8 @@ use crate::protocol::common::GitSha;
#[serde(rename_all = "camelCase")]
pub struct InitializeParams {
pub client_info: ClientInfo,
+ #[serde(skip_serializing_if = "Option::is_none")]
+ pub capabilities: Option,
}
#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, Default, JsonSchema, TS)]
@@ -43,6 +45,15 @@ pub struct ClientInfo {
pub version: String,
}
+/// Client-declared capabilities negotiated during initialize.
+#[derive(Serialize, Deserialize, Debug, Clone, Copy, PartialEq, Eq, Default, JsonSchema, TS)]
+#[serde(rename_all = "camelCase")]
+pub struct InitializeCapabilities {
+ /// Opt into receiving experimental API methods and fields.
+ #[serde(default)]
+ pub experimental_api: bool,
+}
+
#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, JsonSchema, TS)]
#[serde(rename_all = "camelCase")]
pub struct InitializeResponse {
diff --git a/codex-rs/app-server-protocol/src/protocol/v2.rs b/codex-rs/app-server-protocol/src/protocol/v2.rs
index 8164eb5289..3ca344ee49 100644
--- a/codex-rs/app-server-protocol/src/protocol/v2.rs
+++ b/codex-rs/app-server-protocol/src/protocol/v2.rs
@@ -2,6 +2,7 @@ use std::collections::HashMap;
use std::path::PathBuf;
use crate::protocol::common::AuthMode;
+use codex_experimental_api_macros::ExperimentalApi;
use codex_protocol::account::PlanType;
use codex_protocol::approvals::ExecPolicyAmendment as CoreExecPolicyAmendment;
use codex_protocol::config_types::CollaborationMode;
@@ -497,6 +498,14 @@ pub struct ConfigReadResponse {
pub struct ConfigRequirements {
pub allowed_approval_policies: Option>,
pub allowed_sandbox_modes: Option>,
+ pub enforce_residency: Option,
+}
+
+#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, Eq, JsonSchema, TS)]
+#[serde(rename_all = "lowercase")]
+#[ts(export_to = "v2/")]
+pub enum ResidencyRequirement {
+ Us,
}
#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, JsonSchema, TS)]
@@ -1157,7 +1166,9 @@ pub struct CommandExecResponse {
// === Threads, Turns, and Items ===
// Thread APIs
-#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, Default, JsonSchema, TS)]
+#[derive(
+ Serialize, Deserialize, Debug, Clone, PartialEq, Default, JsonSchema, TS, ExperimentalApi,
+)]
#[serde(rename_all = "camelCase")]
#[ts(export_to = "v2/")]
pub struct ThreadStartParams {
@@ -1171,7 +1182,12 @@ pub struct ThreadStartParams {
pub developer_instructions: Option,
pub personality: Option,
pub ephemeral: Option,
+ #[experimental("thread/start.dynamicTools")]
pub dynamic_tools: Option>,
+ /// Test-only experimental field used to validate experimental gating and
+ /// schema filtering behavior in a stable way.
+ #[experimental("thread/start.mockExperimentalField")]
+ pub mock_experimental_field: Option,
/// If true, opt into emitting raw response items on the event stream.
///
/// This is for internal use only (e.g. Codex Cloud).
@@ -1180,6 +1196,22 @@ pub struct ThreadStartParams {
pub experimental_raw_events: bool,
}
+#[derive(Serialize, Deserialize, Debug, Default, Clone, PartialEq, JsonSchema, TS)]
+#[serde(rename_all = "camelCase")]
+#[ts(export_to = "v2/")]
+pub struct MockExperimentalMethodParams {
+ /// Test-only payload field.
+ pub value: Option,
+}
+
+#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, JsonSchema, TS)]
+#[serde(rename_all = "camelCase")]
+#[ts(export_to = "v2/")]
+pub struct MockExperimentalMethodResponse {
+ /// Echoes the input `value`.
+ pub echoed: Option,
+}
+
#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, JsonSchema, TS)]
#[serde(rename_all = "camelCase")]
#[ts(export_to = "v2/")]
@@ -2113,7 +2145,11 @@ pub enum ThreadItem {
},
#[serde(rename_all = "camelCase")]
#[ts(rename_all = "camelCase")]
- WebSearch { id: String, query: String },
+ WebSearch {
+ id: String,
+ query: String,
+ action: Option,
+ },
#[serde(rename_all = "camelCase")]
#[ts(rename_all = "camelCase")]
ImageView { id: String, path: String },
@@ -2128,6 +2164,42 @@ pub enum ThreadItem {
ContextCompaction { id: String },
}
+#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, JsonSchema, TS)]
+#[serde(tag = "type", rename_all = "camelCase")]
+#[ts(tag = "type", rename_all = "camelCase")]
+pub enum WebSearchAction {
+ Search {
+ query: Option,
+ queries: Option>,
+ },
+ OpenPage {
+ url: Option,
+ },
+ FindInPage {
+ url: Option,
+ pattern: Option,
+ },
+ #[serde(other)]
+ Other,
+}
+
+impl From for WebSearchAction {
+ fn from(value: codex_protocol::models::WebSearchAction) -> Self {
+ match value {
+ codex_protocol::models::WebSearchAction::Search { query, queries } => {
+ WebSearchAction::Search { query, queries }
+ }
+ codex_protocol::models::WebSearchAction::OpenPage { url } => {
+ WebSearchAction::OpenPage { url }
+ }
+ codex_protocol::models::WebSearchAction::FindInPage { url, pattern } => {
+ WebSearchAction::FindInPage { url, pattern }
+ }
+ codex_protocol::models::WebSearchAction::Other => WebSearchAction::Other,
+ }
+ }
+}
+
impl From for ThreadItem {
fn from(value: CoreTurnItem) -> Self {
match value {
@@ -2157,6 +2229,7 @@ impl From for ThreadItem {
CoreTurnItem::WebSearch(search) => ThreadItem::WebSearch {
id: search.id,
query: search.query,
+ action: Some(WebSearchAction::from(search.action)),
},
CoreTurnItem::ContextCompaction(compaction) => {
ThreadItem::ContextCompaction { id: compaction.id }
@@ -2810,7 +2883,7 @@ mod tests {
use codex_protocol::items::TurnItem;
use codex_protocol::items::UserMessageItem;
use codex_protocol::items::WebSearchItem;
- use codex_protocol::models::WebSearchAction;
+ use codex_protocol::models::WebSearchAction as CoreWebSearchAction;
use codex_protocol::protocol::NetworkAccess as CoreNetworkAccess;
use codex_protocol::user_input::UserInput as CoreUserInput;
use pretty_assertions::assert_eq;
@@ -2926,8 +2999,9 @@ mod tests {
let search_item = TurnItem::WebSearch(WebSearchItem {
id: "search-1".to_string(),
query: "docs".to_string(),
- action: WebSearchAction::Search {
+ action: CoreWebSearchAction::Search {
query: Some("docs".to_string()),
+ queries: None,
},
});
@@ -2936,6 +3010,10 @@ mod tests {
ThreadItem::WebSearch {
id: "search-1".to_string(),
query: "docs".to_string(),
+ action: Some(WebSearchAction::Search {
+ query: Some("docs".to_string()),
+ queries: None,
+ }),
}
);
}
diff --git a/codex-rs/app-server-protocol/src/schema_fixtures.rs b/codex-rs/app-server-protocol/src/schema_fixtures.rs
new file mode 100644
index 0000000000..918011e95c
--- /dev/null
+++ b/codex-rs/app-server-protocol/src/schema_fixtures.rs
@@ -0,0 +1,148 @@
+use anyhow::Context;
+use anyhow::Result;
+use serde_json::Map;
+use serde_json::Value;
+use std::collections::BTreeMap;
+use std::path::Path;
+use std::path::PathBuf;
+
+#[derive(Clone, Copy, Debug, Default)]
+pub struct SchemaFixtureOptions {
+ pub experimental_api: bool,
+}
+
+pub fn read_schema_fixture_tree(schema_root: &Path) -> Result>> {
+ let typescript_root = schema_root.join("typescript");
+ let json_root = schema_root.join("json");
+
+ let mut all = BTreeMap::new();
+ for (rel, bytes) in collect_files_recursive(&typescript_root)? {
+ all.insert(PathBuf::from("typescript").join(rel), bytes);
+ }
+ for (rel, bytes) in collect_files_recursive(&json_root)? {
+ all.insert(PathBuf::from("json").join(rel), bytes);
+ }
+
+ Ok(all)
+}
+
+/// Regenerates `schema/typescript/` and `schema/json/`.
+///
+/// This is intended to be used by tooling (e.g., `just write-app-server-schema`).
+/// It deletes any previously generated files so stale artifacts are removed.
+pub fn write_schema_fixtures(schema_root: &Path, prettier: Option<&Path>) -> Result<()> {
+ write_schema_fixtures_with_options(schema_root, prettier, SchemaFixtureOptions::default())
+}
+
+/// Regenerates schema fixtures with configurable options.
+pub fn write_schema_fixtures_with_options(
+ schema_root: &Path,
+ prettier: Option<&Path>,
+ options: SchemaFixtureOptions,
+) -> Result<()> {
+ let typescript_out_dir = schema_root.join("typescript");
+ let json_out_dir = schema_root.join("json");
+
+ ensure_empty_dir(&typescript_out_dir)?;
+ ensure_empty_dir(&json_out_dir)?;
+
+ crate::generate_ts_with_options(
+ &typescript_out_dir,
+ prettier,
+ crate::GenerateTsOptions {
+ experimental_api: options.experimental_api,
+ ..crate::GenerateTsOptions::default()
+ },
+ )?;
+ crate::generate_json_with_experimental(&json_out_dir, options.experimental_api)?;
+
+ Ok(())
+}
+
+fn ensure_empty_dir(dir: &Path) -> Result<()> {
+ if dir.exists() {
+ std::fs::remove_dir_all(dir)
+ .with_context(|| format!("failed to remove {}", dir.display()))?;
+ }
+ std::fs::create_dir_all(dir).with_context(|| format!("failed to create {}", dir.display()))?;
+ Ok(())
+}
+
+fn read_file_bytes(path: &Path) -> Result> {
+ let bytes =
+ std::fs::read(path).with_context(|| format!("failed to read {}", path.display()))?;
+ if path.extension().is_some_and(|ext| ext == "json") {
+ let value: Value = serde_json::from_slice(&bytes)
+ .with_context(|| format!("failed to parse JSON in {}", path.display()))?;
+ let value = canonicalize_json(&value);
+ let normalized = serde_json::to_vec_pretty(&value)
+ .with_context(|| format!("failed to reserialize JSON in {}", path.display()))?;
+ return Ok(normalized);
+ }
+ if path.extension().is_some_and(|ext| ext == "ts") {
+ // Windows checkouts (and some generators) may produce CRLF; normalize so the
+ // fixture test is platform-independent.
+ let text = String::from_utf8(bytes)
+ .with_context(|| format!("expected UTF-8 TypeScript in {}", path.display()))?;
+ let text = text.replace("\r\n", "\n").replace('\r', "\n");
+ return Ok(text.into_bytes());
+ }
+ Ok(bytes)
+}
+
+fn canonicalize_json(value: &Value) -> Value {
+ match value {
+ Value::Array(items) => Value::Array(items.iter().map(canonicalize_json).collect()),
+ Value::Object(map) => {
+ let mut entries: Vec<_> = map.iter().collect();
+ entries.sort_by(|(left, _), (right, _)| left.cmp(right));
+ let mut sorted = Map::with_capacity(map.len());
+ for (key, child) in entries {
+ sorted.insert(key.clone(), canonicalize_json(child));
+ }
+ Value::Object(sorted)
+ }
+ _ => value.clone(),
+ }
+}
+
+fn collect_files_recursive(root: &Path) -> Result>> {
+ let mut files = BTreeMap::new();
+
+ let mut stack = vec![root.to_path_buf()];
+ while let Some(dir) = stack.pop() {
+ for entry in std::fs::read_dir(&dir)
+ .with_context(|| format!("failed to read dir {}", dir.display()))?
+ {
+ let entry =
+ entry.with_context(|| format!("failed to read dir entry in {}", dir.display()))?;
+ let path = entry.path();
+ // On some platforms, Bazel runfiles are symlinks. `DirEntry::file_type()` does not
+ // follow symlinks, so use `metadata()` here to treat symlinks as the files/dirs they
+ // point to.
+ let metadata = std::fs::metadata(&path)
+ .with_context(|| format!("failed to stat {}", path.display()))?;
+ if metadata.is_dir() {
+ stack.push(path);
+ continue;
+ } else if !metadata.is_file() {
+ continue;
+ }
+
+ let rel = path
+ .strip_prefix(root)
+ .with_context(|| {
+ format!(
+ "failed to strip prefix {} from {}",
+ root.display(),
+ path.display()
+ )
+ })?
+ .to_path_buf();
+
+ files.insert(rel, read_file_bytes(&path)?);
+ }
+ }
+
+ Ok(files)
+}
diff --git a/codex-rs/app-server-protocol/tests/schema_fixtures.rs b/codex-rs/app-server-protocol/tests/schema_fixtures.rs
new file mode 100644
index 0000000000..12379f7809
--- /dev/null
+++ b/codex-rs/app-server-protocol/tests/schema_fixtures.rs
@@ -0,0 +1,97 @@
+use anyhow::Context;
+use anyhow::Result;
+use codex_app_server_protocol::read_schema_fixture_tree;
+use codex_app_server_protocol::write_schema_fixtures;
+use similar::TextDiff;
+use std::path::Path;
+
+#[test]
+fn schema_fixtures_match_generated() -> Result<()> {
+ let schema_root = schema_root()?;
+ let fixture_tree = read_tree(&schema_root)?;
+
+ let temp_dir = tempfile::tempdir().context("create temp dir")?;
+ write_schema_fixtures(temp_dir.path(), None).context("generate schema fixtures")?;
+ let generated_tree = read_tree(temp_dir.path())?;
+
+ let fixture_paths = fixture_tree
+ .keys()
+ .map(|p| p.display().to_string())
+ .collect::>();
+ let generated_paths = generated_tree
+ .keys()
+ .map(|p| p.display().to_string())
+ .collect::>();
+
+ if fixture_paths != generated_paths {
+ let expected = fixture_paths.join("\n");
+ let actual = generated_paths.join("\n");
+ let diff = TextDiff::from_lines(&expected, &actual)
+ .unified_diff()
+ .header("fixture", "generated")
+ .to_string();
+
+ panic!(
+ "Vendored app-server schema fixture file set doesn't match freshly generated output. \
+Run `just write-app-server-schema` to overwrite with your changes.\n\n{diff}"
+ );
+ }
+
+ // If the file sets match, diff contents for each file for a nicer error.
+ for (path, expected) in &fixture_tree {
+ let actual = generated_tree
+ .get(path)
+ .ok_or_else(|| anyhow::anyhow!("missing generated file: {}", path.display()))?;
+
+ if expected == actual {
+ continue;
+ }
+
+ let expected_str = String::from_utf8_lossy(expected);
+ let actual_str = String::from_utf8_lossy(actual);
+ let diff = TextDiff::from_lines(&expected_str, &actual_str)
+ .unified_diff()
+ .header("fixture", "generated")
+ .to_string();
+ panic!(
+ "Vendored app-server schema fixture {} differs from generated output. \
+Run `just write-app-server-schema` to overwrite with your changes.\n\n{diff}",
+ path.display()
+ );
+ }
+
+ Ok(())
+}
+
+fn schema_root() -> Result {
+ // In Bazel runfiles (especially manifest-only mode), resolving directories is not
+ // reliable. Resolve a known file, then walk up to the schema root.
+ let typescript_index = codex_utils_cargo_bin::find_resource!("schema/typescript/index.ts")
+ .context("resolve TypeScript schema index.ts")?;
+ let schema_root = typescript_index
+ .parent()
+ .and_then(|p| p.parent())
+ .context("derive schema root from schema/typescript/index.ts")?
+ .to_path_buf();
+
+ // Sanity check that the JSON fixtures resolve to the same schema root.
+ let json_bundle =
+ codex_utils_cargo_bin::find_resource!("schema/json/codex_app_server_protocol.schemas.json")
+ .context("resolve JSON schema bundle")?;
+ let json_root = json_bundle
+ .parent()
+ .and_then(|p| p.parent())
+ .context("derive schema root from schema/json/codex_app_server_protocol.schemas.json")?;
+ anyhow::ensure!(
+ schema_root == json_root,
+ "schema roots disagree: typescript={} json={}",
+ schema_root.display(),
+ json_root.display()
+ );
+
+ Ok(schema_root)
+}
+
+fn read_tree(root: &Path) -> Result>> {
+ read_schema_fixture_tree(root).context("read schema fixture tree")
+}
diff --git a/codex-rs/app-server-test-client/src/main.rs b/codex-rs/app-server-test-client/src/main.rs
index 1e2b94bd8f..6d3fc06d81 100644
--- a/codex-rs/app-server-test-client/src/main.rs
+++ b/codex-rs/app-server-test-client/src/main.rs
@@ -1,7 +1,9 @@
use std::collections::VecDeque;
+use std::fs;
use std::io::BufRead;
use std::io::BufReader;
use std::io::Write;
+use std::path::Path;
use std::process::Child;
use std::process::ChildStdin;
use std::process::ChildStdout;
@@ -24,10 +26,12 @@ use codex_app_server_protocol::ClientRequest;
use codex_app_server_protocol::CommandExecutionApprovalDecision;
use codex_app_server_protocol::CommandExecutionRequestApprovalParams;
use codex_app_server_protocol::CommandExecutionRequestApprovalResponse;
+use codex_app_server_protocol::DynamicToolSpec;
use codex_app_server_protocol::FileChangeApprovalDecision;
use codex_app_server_protocol::FileChangeRequestApprovalParams;
use codex_app_server_protocol::FileChangeRequestApprovalResponse;
use codex_app_server_protocol::GetAccountRateLimitsResponse;
+use codex_app_server_protocol::InitializeCapabilities;
use codex_app_server_protocol::InitializeParams;
use codex_app_server_protocol::InitializeResponse;
use codex_app_server_protocol::InputItem;
@@ -82,6 +86,15 @@ struct Cli {
)]
config_overrides: Vec,
+ /// JSON array of dynamic tool specs or a single tool object.
+ /// Prefix a filename with '@' to read from a file.
+ ///
+ /// Example:
+ /// --dynamic-tools '[{"name":"demo","description":"Demo","inputSchema":{"type":"object"}}]'
+ /// --dynamic-tools @/path/to/tools.json
+ #[arg(long, value_name = "json-or-@file", global = true)]
+ dynamic_tools: Option,
+
#[command(subcommand)]
command: CliCommand,
}
@@ -139,23 +152,29 @@ fn main() -> Result<()> {
let Cli {
codex_bin,
config_overrides,
+ dynamic_tools,
command,
} = Cli::parse();
+ let dynamic_tools = parse_dynamic_tools_arg(&dynamic_tools)?;
+
match command {
CliCommand::SendMessage { user_message } => {
+ ensure_dynamic_tools_unused(&dynamic_tools, "send-message")?;
send_message(&codex_bin, &config_overrides, user_message)
}
CliCommand::SendMessageV2 { user_message } => {
- send_message_v2(&codex_bin, &config_overrides, user_message)
+ send_message_v2(&codex_bin, &config_overrides, user_message, &dynamic_tools)
}
CliCommand::TriggerCmdApproval { user_message } => {
- trigger_cmd_approval(&codex_bin, &config_overrides, user_message)
+ trigger_cmd_approval(&codex_bin, &config_overrides, user_message, &dynamic_tools)
}
CliCommand::TriggerPatchApproval { user_message } => {
- trigger_patch_approval(&codex_bin, &config_overrides, user_message)
+ trigger_patch_approval(&codex_bin, &config_overrides, user_message, &dynamic_tools)
+ }
+ CliCommand::NoTriggerCmdApproval => {
+ no_trigger_cmd_approval(&codex_bin, &config_overrides, &dynamic_tools)
}
- CliCommand::NoTriggerCmdApproval => no_trigger_cmd_approval(&codex_bin, &config_overrides),
CliCommand::SendFollowUpV2 {
first_message,
follow_up_message,
@@ -164,10 +183,20 @@ fn main() -> Result<()> {
&config_overrides,
first_message,
follow_up_message,
+ &dynamic_tools,
),
- CliCommand::TestLogin => test_login(&codex_bin, &config_overrides),
- CliCommand::GetAccountRateLimits => get_account_rate_limits(&codex_bin, &config_overrides),
- CliCommand::ModelList => model_list(&codex_bin, &config_overrides),
+ CliCommand::TestLogin => {
+ ensure_dynamic_tools_unused(&dynamic_tools, "test-login")?;
+ test_login(&codex_bin, &config_overrides)
+ }
+ CliCommand::GetAccountRateLimits => {
+ ensure_dynamic_tools_unused(&dynamic_tools, "get-account-rate-limits")?;
+ get_account_rate_limits(&codex_bin, &config_overrides)
+ }
+ CliCommand::ModelList => {
+ ensure_dynamic_tools_unused(&dynamic_tools, "model-list")?;
+ model_list(&codex_bin, &config_overrides)
+ }
}
}
@@ -197,14 +226,23 @@ fn send_message_v2(
codex_bin: &str,
config_overrides: &[String],
user_message: String,
+ dynamic_tools: &Option>,
) -> Result<()> {
- send_message_v2_with_policies(codex_bin, config_overrides, user_message, None, None)
+ send_message_v2_with_policies(
+ codex_bin,
+ config_overrides,
+ user_message,
+ None,
+ None,
+ dynamic_tools,
+ )
}
fn trigger_cmd_approval(
codex_bin: &str,
config_overrides: &[String],
user_message: Option,
+ dynamic_tools: &Option>,
) -> Result<()> {
let default_prompt =
"Run `touch /tmp/should-trigger-approval` so I can confirm the file exists.";
@@ -215,6 +253,7 @@ fn trigger_cmd_approval(
message,
Some(AskForApproval::OnRequest),
Some(SandboxPolicy::ReadOnly),
+ dynamic_tools,
)
}
@@ -222,6 +261,7 @@ fn trigger_patch_approval(
codex_bin: &str,
config_overrides: &[String],
user_message: Option,
+ dynamic_tools: &Option>,
) -> Result<()> {
let default_prompt =
"Create a file named APPROVAL_DEMO.txt containing a short hello message using apply_patch.";
@@ -232,12 +272,24 @@ fn trigger_patch_approval(
message,
Some(AskForApproval::OnRequest),
Some(SandboxPolicy::ReadOnly),
+ dynamic_tools,
)
}
-fn no_trigger_cmd_approval(codex_bin: &str, config_overrides: &[String]) -> Result<()> {
+fn no_trigger_cmd_approval(
+ codex_bin: &str,
+ config_overrides: &[String],
+ dynamic_tools: &Option>,
+) -> Result<()> {
let prompt = "Run `touch should_not_trigger_approval.txt`";
- send_message_v2_with_policies(codex_bin, config_overrides, prompt.to_string(), None, None)
+ send_message_v2_with_policies(
+ codex_bin,
+ config_overrides,
+ prompt.to_string(),
+ None,
+ None,
+ dynamic_tools,
+ )
}
fn send_message_v2_with_policies(
@@ -246,13 +298,17 @@ fn send_message_v2_with_policies(
user_message: String,
approval_policy: Option,
sandbox_policy: Option,
+ dynamic_tools: &Option>,
) -> Result<()> {
let mut client = CodexClient::spawn(codex_bin, config_overrides)?;
let initialize = client.initialize()?;
println!("< initialize response: {initialize:?}");
- let thread_response = client.thread_start(ThreadStartParams::default())?;
+ let thread_response = client.thread_start(ThreadStartParams {
+ dynamic_tools: dynamic_tools.clone(),
+ ..Default::default()
+ })?;
println!("< thread/start response: {thread_response:?}");
let mut turn_params = TurnStartParams {
thread_id: thread_response.thread.id.clone(),
@@ -279,13 +335,17 @@ fn send_follow_up_v2(
config_overrides: &[String],
first_message: String,
follow_up_message: String,
+ dynamic_tools: &Option>,
) -> Result<()> {
let mut client = CodexClient::spawn(codex_bin, config_overrides)?;
let initialize = client.initialize()?;
println!("< initialize response: {initialize:?}");
- let thread_response = client.thread_start(ThreadStartParams::default())?;
+ let thread_response = client.thread_start(ThreadStartParams {
+ dynamic_tools: dynamic_tools.clone(),
+ ..Default::default()
+ })?;
println!("< thread/start response: {thread_response:?}");
let first_turn_params = TurnStartParams {
@@ -371,6 +431,40 @@ fn model_list(codex_bin: &str, config_overrides: &[String]) -> Result<()> {
Ok(())
}
+fn ensure_dynamic_tools_unused(
+ dynamic_tools: &Option>,
+ command: &str,
+) -> Result<()> {
+ if dynamic_tools.is_some() {
+ bail!(
+ "dynamic tools are only supported for v2 thread/start; remove --dynamic-tools for {command} or use send-message-v2"
+ );
+ }
+ Ok(())
+}
+
+fn parse_dynamic_tools_arg(dynamic_tools: &Option) -> Result>> {
+ let Some(raw_arg) = dynamic_tools.as_deref() else {
+ return Ok(None);
+ };
+
+ let raw_json = if let Some(path) = raw_arg.strip_prefix('@') {
+ fs::read_to_string(Path::new(path))
+ .with_context(|| format!("read dynamic tools file {path}"))?
+ } else {
+ raw_arg.to_string()
+ };
+
+ let value: Value = serde_json::from_str(&raw_json).context("parse dynamic tools JSON")?;
+ let tools = match value {
+ Value::Array(_) => serde_json::from_value(value).context("decode dynamic tools array")?,
+ Value::Object(_) => vec![serde_json::from_value(value).context("decode dynamic tool")?],
+ _ => bail!("dynamic tools JSON must be an object or array"),
+ };
+
+ Ok(Some(tools))
+}
+
struct CodexClient {
child: Child,
stdin: Option,
@@ -419,6 +513,9 @@ impl CodexClient {
title: Some("Codex Toy App Server".to_string()),
version: env!("CARGO_PKG_VERSION").to_string(),
},
+ capabilities: Some(InitializeCapabilities {
+ experimental_api: true,
+ }),
},
};
diff --git a/codex-rs/app-server/Cargo.toml b/codex-rs/app-server/Cargo.toml
index 820edf59c2..11c57ebbc8 100644
--- a/codex-rs/app-server/Cargo.toml
+++ b/codex-rs/app-server/Cargo.toml
@@ -19,6 +19,7 @@ workspace = true
anyhow = { workspace = true }
async-trait = { workspace = true }
codex-arg0 = { workspace = true }
+codex-cloud-requirements = { workspace = true }
codex-common = { workspace = true, features = ["cli"] }
codex-core = { workspace = true }
codex-backend-client = { workspace = true }
diff --git a/codex-rs/app-server/README.md b/codex-rs/app-server/README.md
index 76d1131a2e..1d5b6d15fd 100644
--- a/codex-rs/app-server/README.md
+++ b/codex-rs/app-server/README.md
@@ -15,6 +15,7 @@
- [Skills](#skills)
- [Apps](#apps)
- [Auth endpoints](#auth-endpoints)
+- [Adding an experimental field](#adding-an-experimental-field)
## Protocol
@@ -103,7 +104,7 @@ Example (from OpenAI's official VSCode extension):
- `config/read` — fetch the effective config on disk after resolving config layering.
- `config/value/write` — write a single config key/value to the user's config.toml on disk.
- `config/batchWrite` — apply multiple config edits atomically to the user's config.toml on disk.
-- `configRequirements/read` — fetch the loaded requirements allow-lists from `requirements.toml` and/or MDM (or `null` if none are configured).
+- `configRequirements/read` — fetch the loaded requirements allow-lists and `enforceResidency` from `requirements.toml` and/or MDM (or `null` if none are configured).
### Example: Start or resume a thread
@@ -450,7 +451,7 @@ Today both notifications carry an empty `items` array even when item events were
- `fileChange` — `{id, changes, status}` describing proposed edits; `changes` list `{path, kind, diff}` and `status` is `inProgress`, `completed`, `failed`, or `declined`.
- `mcpToolCall` — `{id, server, tool, status, arguments, result?, error?}` describing MCP calls; `status` is `inProgress`, `completed`, or `failed`.
- `collabToolCall` — `{id, tool, status, senderThreadId, receiverThreadId?, newThreadId?, prompt?, agentStatus?}` describing collab tool calls (`spawn_agent`, `send_input`, `wait`, `close_agent`); `status` is `inProgress`, `completed`, or `failed`.
-- `webSearch` — `{id, query}` for a web search request issued by the agent.
+- `webSearch` — `{id, query, action?}` for a web search request issued by the agent; `action` mirrors the Responses API web_search action payload (`search`, `open_page`, `find_in_page`) and may be omitted until completion.
- `imageView` — `{id, path}` emitted when the agent invokes the image viewer tool.
- `enteredReviewMode` — `{id, review}` sent when the reviewer starts; `review` is a short user-facing label such as `"current changes"` or the requested target description.
- `exitedReviewMode` — `{id, review}` emitted when the reviewer finishes; `review` is the full plain-text review (usually, overall notes plus bullet point findings).
@@ -768,3 +769,31 @@ Field notes:
- `usedPercent` is current usage within the OpenAI quota window.
- `windowDurationMins` is the quota window length.
- `resetsAt` is a Unix timestamp (seconds) for the next reset.
+
+## Adding an experimental field
+Use this checklist when introducing a field/method that should only be available when the client opts into experimental APIs.
+
+At runtime, clients must send `initialize` with `capabilities.experimentalApi = true` to use experimental methods or fields.
+
+1. Annotate the field in the protocol type (usually `app-server-protocol/src/protocol/v2.rs`) with:
+ ```rust
+ #[experimental("thread/start.myField")]
+ pub my_field: Option,
+ ```
+2. Ensure the params type derives `ExperimentalApi` so field-level gating can be detected at runtime.
+
+3. In `app-server-protocol/src/protocol/common.rs`, keep the method stable and use `inspect_params: true` when only some fields are experimental (like `thread/start`). If the entire method is experimental, annotate the method variant with `#[experimental("method/name")]`.
+
+4. Regenerate protocol fixtures:
+
+ ```bash
+ just write-app-server-schema
+ # Include experimental API fields/methods in fixtures.
+ just write-app-server-schema --experimental
+ ```
+
+5. Verify the protocol crate:
+
+ ```bash
+ cargo test -p codex-app-server-protocol
+ ```
diff --git a/codex-rs/app-server/src/codex_message_processor.rs b/codex-rs/app-server/src/codex_message_processor.rs
index 78f670c049..9e462ca431 100644
--- a/codex-rs/app-server/src/codex_message_processor.rs
+++ b/codex-rs/app-server/src/codex_message_processor.rs
@@ -69,6 +69,8 @@ use codex_app_server_protocol::McpServerOauthLoginParams;
use codex_app_server_protocol::McpServerOauthLoginResponse;
use codex_app_server_protocol::McpServerRefreshResponse;
use codex_app_server_protocol::McpServerStatus;
+use codex_app_server_protocol::MockExperimentalMethodParams;
+use codex_app_server_protocol::MockExperimentalMethodResponse;
use codex_app_server_protocol::ModelListParams;
use codex_app_server_protocol::ModelListResponse;
use codex_app_server_protocol::NewConversationParams;
@@ -152,6 +154,7 @@ use codex_core::config::ConfigService;
use codex_core::config::edit::ConfigEdit;
use codex_core::config::edit::ConfigEditsBuilder;
use codex_core::config::types::McpServerTransportConfig;
+use codex_core::config_loader::CloudRequirementsLoader;
use codex_core::default_client::get_codex_user_agent;
use codex_core::error::CodexErr;
use codex_core::exec::ExecParams;
@@ -201,6 +204,8 @@ use codex_utils_json_to_toml::json_to_toml;
use std::collections::HashMap;
use std::collections::HashSet;
use std::ffi::OsStr;
+use std::fs::FileTimes;
+use std::fs::OpenOptions;
use std::io::Error as IoError;
use std::path::Path;
use std::path::PathBuf;
@@ -208,6 +213,7 @@ use std::sync::Arc;
use std::sync::atomic::AtomicBool;
use std::sync::atomic::Ordering;
use std::time::Duration;
+use std::time::SystemTime;
use tokio::sync::Mutex;
use tokio::sync::broadcast;
use tokio::sync::oneshot;
@@ -263,6 +269,7 @@ pub(crate) struct CodexMessageProcessor {
codex_linux_sandbox_exe: Option,
config: Arc,
cli_overrides: Vec<(String, TomlValue)>,
+ cloud_requirements: CloudRequirementsLoader,
conversation_listeners: HashMap>,
listener_thread_ids_by_subscription: HashMap,
active_login: Arc>>,
@@ -281,6 +288,17 @@ pub(crate) enum ApiVersion {
V2,
}
+pub(crate) struct CodexMessageProcessorArgs {
+ pub(crate) auth_manager: Arc,
+ pub(crate) thread_manager: Arc,
+ pub(crate) outgoing: Arc,
+ pub(crate) codex_linux_sandbox_exe: Option,
+ pub(crate) config: Arc,
+ pub(crate) cli_overrides: Vec<(String, TomlValue)>,
+ pub(crate) cloud_requirements: CloudRequirementsLoader,
+ pub(crate) feedback: CodexFeedback,
+}
+
impl CodexMessageProcessor {
async fn load_thread(
&self,
@@ -305,15 +323,17 @@ impl CodexMessageProcessor {
Ok((thread_id, thread))
}
- pub fn new(
- auth_manager: Arc,
- thread_manager: Arc,
- outgoing: Arc,
- codex_linux_sandbox_exe: Option,
- config: Arc,
- cli_overrides: Vec<(String, TomlValue)>,
- feedback: CodexFeedback,
- ) -> Self {
+ pub fn new(args: CodexMessageProcessorArgs) -> Self {
+ let CodexMessageProcessorArgs {
+ auth_manager,
+ thread_manager,
+ outgoing,
+ codex_linux_sandbox_exe,
+ config,
+ cli_overrides,
+ cloud_requirements,
+ feedback,
+ } = args;
Self {
auth_manager,
thread_manager,
@@ -321,6 +341,7 @@ impl CodexMessageProcessor {
codex_linux_sandbox_exe,
config,
cli_overrides,
+ cloud_requirements,
conversation_listeners: HashMap::new(),
listener_thread_ids_by_subscription: HashMap::new(),
active_login: Arc::new(Mutex::new(None)),
@@ -333,7 +354,10 @@ impl CodexMessageProcessor {
}
async fn load_latest_config(&self) -> Result {
- Config::load_with_cli_overrides(self.cli_overrides.clone())
+ codex_core::config::ConfigBuilder::default()
+ .cli_overrides(self.cli_overrides.clone())
+ .cloud_requirements(self.cloud_requirements.clone())
+ .build()
.await
.map_err(|err| JSONRPCErrorError {
code: INTERNAL_ERROR_CODE,
@@ -485,6 +509,9 @@ impl CodexMessageProcessor {
.await;
});
}
+ ClientRequest::MockExperimentalMethod { request_id, params } => {
+ self.mock_experimental_method(request_id, params).await;
+ }
ClientRequest::McpServerOauthLogin { request_id, params } => {
self.mcp_server_oauth_login(request_id, params).await;
}
@@ -1519,6 +1546,7 @@ impl CodexMessageProcessor {
&self.cli_overrides,
Some(request_overrides),
typesafe_overrides,
+ &self.cloud_requirements,
)
.await
{
@@ -1583,6 +1611,7 @@ impl CodexMessageProcessor {
base_instructions,
developer_instructions,
dynamic_tools,
+ mock_experimental_field: _mock_experimental_field,
experimental_raw_events,
personality,
ephemeral,
@@ -1603,6 +1632,7 @@ impl CodexMessageProcessor {
&self.cli_overrides,
config,
typesafe_overrides,
+ &self.cloud_requirements,
)
.await
{
@@ -1749,7 +1779,7 @@ impl CodexMessageProcessor {
codex_linux_sandbox_exe: self.codex_linux_sandbox_exe.clone(),
base_instructions,
developer_instructions,
- model_personality: personality,
+ personality,
..Default::default()
}
}
@@ -1957,6 +1987,28 @@ impl CodexMessageProcessor {
message: format!("failed to unarchive thread: {err}"),
data: None,
})?;
+ tokio::task::spawn_blocking({
+ let restored_path = restored_path.clone();
+ move || -> std::io::Result<()> {
+ let times = FileTimes::new().set_modified(SystemTime::now());
+ OpenOptions::new()
+ .append(true)
+ .open(&restored_path)?
+ .set_times(times)?;
+ Ok(())
+ }
+ })
+ .await
+ .map_err(|err| JSONRPCErrorError {
+ code: INTERNAL_ERROR_CODE,
+ message: format!("failed to update unarchived thread timestamp: {err}"),
+ data: None,
+ })?
+ .map_err(|err| JSONRPCErrorError {
+ code: INTERNAL_ERROR_CODE,
+ message: format!("failed to update unarchived thread timestamp: {err}"),
+ data: None,
+ })?;
if let Some(ctx) = state_db_ctx {
let _ = ctx
.mark_unarchived(thread_id, restored_path.as_path())
@@ -2350,6 +2402,7 @@ impl CodexMessageProcessor {
request_overrides,
typesafe_overrides,
history_cwd,
+ &self.cloud_requirements,
)
.await
{
@@ -2542,6 +2595,7 @@ impl CodexMessageProcessor {
request_overrides,
typesafe_overrides,
history_cwd,
+ &self.cloud_requirements,
)
.await
{
@@ -2953,6 +3007,16 @@ impl CodexMessageProcessor {
outgoing.send_response(request_id, response).await;
}
+ async fn mock_experimental_method(
+ &self,
+ request_id: RequestId,
+ params: MockExperimentalMethodParams,
+ ) {
+ let MockExperimentalMethodParams { value } = params;
+ let response = MockExperimentalMethodResponse { echoed: value };
+ self.outgoing.send_response(request_id, response).await;
+ }
+
async fn mcp_server_refresh(&self, request_id: RequestId, _params: Option<()>) {
let config = match self.load_latest_config().await {
Ok(config) => config,
@@ -3336,6 +3400,7 @@ impl CodexMessageProcessor {
request_overrides,
typesafe_overrides,
history_cwd,
+ &self.cloud_requirements,
)
.await
{
@@ -3524,6 +3589,7 @@ impl CodexMessageProcessor {
request_overrides,
typesafe_overrides,
history_cwd,
+ &self.cloud_requirements,
)
.await
{
@@ -4794,6 +4860,7 @@ async fn derive_config_from_params(
cli_overrides: &[(String, TomlValue)],
request_overrides: Option>,
typesafe_overrides: ConfigOverrides,
+ cloud_requirements: &CloudRequirementsLoader,
) -> std::io::Result {
let merged_cli_overrides = cli_overrides
.iter()
@@ -4806,7 +4873,11 @@ async fn derive_config_from_params(
)
.collect::>();
- Config::load_with_cli_overrides_and_harness_overrides(merged_cli_overrides, typesafe_overrides)
+ codex_core::config::ConfigBuilder::default()
+ .cli_overrides(merged_cli_overrides)
+ .harness_overrides(typesafe_overrides)
+ .cloud_requirements(cloud_requirements.clone())
+ .build()
.await
}
@@ -4815,6 +4886,7 @@ async fn derive_config_for_cwd(
request_overrides: Option>,
typesafe_overrides: ConfigOverrides,
cwd: Option,
+ cloud_requirements: &CloudRequirementsLoader,
) -> std::io::Result {
let merged_cli_overrides = cli_overrides
.iter()
@@ -4831,6 +4903,7 @@ async fn derive_config_for_cwd(
.cli_overrides(merged_cli_overrides)
.harness_overrides(typesafe_overrides)
.fallback_cwd(cwd)
+ .cloud_requirements(cloud_requirements.clone())
.build()
.await
}
diff --git a/codex-rs/app-server/src/config_api.rs b/codex-rs/app-server/src/config_api.rs
index 9207668486..5a43d6e528 100644
--- a/codex-rs/app-server/src/config_api.rs
+++ b/codex-rs/app-server/src/config_api.rs
@@ -12,8 +12,10 @@ use codex_app_server_protocol::JSONRPCErrorError;
use codex_app_server_protocol::SandboxMode;
use codex_core::config::ConfigService;
use codex_core::config::ConfigServiceError;
+use codex_core::config_loader::CloudRequirementsLoader;
use codex_core::config_loader::ConfigRequirementsToml;
use codex_core::config_loader::LoaderOverrides;
+use codex_core::config_loader::ResidencyRequirement as CoreResidencyRequirement;
use codex_core::config_loader::SandboxModeRequirement as CoreSandboxModeRequirement;
use serde_json::json;
use std::path::PathBuf;
@@ -29,9 +31,15 @@ impl ConfigApi {
codex_home: PathBuf,
cli_overrides: Vec<(String, TomlValue)>,
loader_overrides: LoaderOverrides,
+ cloud_requirements: CloudRequirementsLoader,
) -> Self {
Self {
- service: ConfigService::new(codex_home, cli_overrides, loader_overrides),
+ service: ConfigService::new(
+ codex_home,
+ cli_overrides,
+ loader_overrides,
+ cloud_requirements,
+ ),
}
}
@@ -84,6 +92,9 @@ fn map_requirements_toml_to_api(requirements: ConfigRequirementsToml) -> ConfigR
.filter_map(map_sandbox_mode_requirement_to_api)
.collect()
}),
+ enforce_residency: requirements
+ .enforce_residency
+ .map(map_residency_requirement_to_api),
}
}
@@ -96,6 +107,14 @@ fn map_sandbox_mode_requirement_to_api(mode: CoreSandboxModeRequirement) -> Opti
}
}
+fn map_residency_requirement_to_api(
+ residency: CoreResidencyRequirement,
+) -> codex_app_server_protocol::ResidencyRequirement {
+ match residency {
+ CoreResidencyRequirement::Us => codex_app_server_protocol::ResidencyRequirement::Us,
+ }
+}
+
fn map_error(err: ConfigServiceError) -> JSONRPCErrorError {
if let Some(code) = err.write_error_code() {
return config_write_error(code, err.to_string());
@@ -137,6 +156,7 @@ mod tests {
]),
mcp_servers: None,
rules: None,
+ enforce_residency: Some(CoreResidencyRequirement::Us),
};
let mapped = map_requirements_toml_to_api(requirements);
@@ -152,5 +172,9 @@ mod tests {
mapped.allowed_sandbox_modes,
Some(vec![SandboxMode::ReadOnly]),
);
+ assert_eq!(
+ mapped.enforce_residency,
+ Some(codex_app_server_protocol::ResidencyRequirement::Us),
+ );
}
}
diff --git a/codex-rs/app-server/src/lib.rs b/codex-rs/app-server/src/lib.rs
index 54fce1d077..65f5b605c6 100644
--- a/codex-rs/app-server/src/lib.rs
+++ b/codex-rs/app-server/src/lib.rs
@@ -1,8 +1,11 @@
#![deny(clippy::print_stdout, clippy::print_stderr)]
+use codex_cloud_requirements::cloud_requirements_loader;
use codex_common::CliConfigOverrides;
+use codex_core::AuthManager;
use codex_core::config::Config;
use codex_core::config::ConfigBuilder;
+use codex_core::config_loader::CloudRequirementsLoader;
use codex_core::config_loader::ConfigLayerStackOrdering;
use codex_core::config_loader::LoaderOverrides;
use std::io::ErrorKind;
@@ -10,6 +13,7 @@ use std::io::Result as IoResult;
use std::path::PathBuf;
use crate::message_processor::MessageProcessor;
+use crate::message_processor::MessageProcessorArgs;
use crate::outgoing_message::OutgoingMessage;
use crate::outgoing_message::OutgoingMessageSender;
use codex_app_server_protocol::ConfigLayerSource;
@@ -219,11 +223,49 @@ pub async fn run_main(
format!("error parsing -c overrides: {e}"),
)
})?;
+ let cloud_requirements = match ConfigBuilder::default()
+ .cli_overrides(cli_kv_overrides.clone())
+ .loader_overrides(loader_overrides.clone())
+ .build()
+ .await
+ {
+ Ok(config) => {
+ let effective_toml = config.config_layer_stack.effective_config();
+ match effective_toml.try_into() {
+ Ok(config_toml) => {
+ if let Err(err) = codex_core::personality_migration::maybe_migrate_personality(
+ &config.codex_home,
+ &config_toml,
+ )
+ .await
+ {
+ warn!(error = %err, "Failed to run personality migration");
+ }
+ }
+ Err(err) => {
+ warn!(error = %err, "Failed to deserialize config for personality migration");
+ }
+ }
+
+ let auth_manager = AuthManager::shared(
+ config.codex_home.clone(),
+ false,
+ config.cli_auth_credentials_store_mode,
+ );
+ cloud_requirements_loader(auth_manager, config.chatgpt_base_url)
+ }
+ Err(err) => {
+ warn!(error = %err, "Failed to preload config for cloud requirements");
+ // TODO(gt): Make cloud requirements preload failures blocking once we can fail-closed.
+ CloudRequirementsLoader::default()
+ }
+ };
let loader_overrides_for_config_api = loader_overrides.clone();
let mut config_warnings = Vec::new();
let config = match ConfigBuilder::default()
.cli_overrides(cli_kv_overrides.clone())
.loader_overrides(loader_overrides)
+ .cloud_requirements(cloud_requirements.clone())
.build()
.await
{
@@ -308,15 +350,16 @@ pub async fn run_main(
let outgoing_message_sender = OutgoingMessageSender::new(outgoing_tx);
let cli_overrides: Vec<(String, TomlValue)> = cli_kv_overrides.clone();
let loader_overrides = loader_overrides_for_config_api;
- let mut processor = MessageProcessor::new(
- outgoing_message_sender,
+ let mut processor = MessageProcessor::new(MessageProcessorArgs {
+ outgoing: outgoing_message_sender,
codex_linux_sandbox_exe,
- std::sync::Arc::new(config),
+ config: std::sync::Arc::new(config),
cli_overrides,
loader_overrides,
- feedback.clone(),
+ cloud_requirements: cloud_requirements.clone(),
+ feedback: feedback.clone(),
config_warnings,
- );
+ });
let mut thread_created_rx = processor.thread_created_receiver();
async move {
let mut listen_for_threads = true;
diff --git a/codex-rs/app-server/src/message_processor.rs b/codex-rs/app-server/src/message_processor.rs
index ced93c3bdd..db6275dcaf 100644
--- a/codex-rs/app-server/src/message_processor.rs
+++ b/codex-rs/app-server/src/message_processor.rs
@@ -1,7 +1,10 @@
use std::path::PathBuf;
use std::sync::Arc;
+use std::sync::atomic::AtomicBool;
+use std::sync::atomic::Ordering;
use crate::codex_message_processor::CodexMessageProcessor;
+use crate::codex_message_processor::CodexMessageProcessorArgs;
use crate::config_api::ConfigApi;
use crate::error_code::INVALID_REQUEST_ERROR_CODE;
use crate::outgoing_message::OutgoingMessageSender;
@@ -15,6 +18,7 @@ use codex_app_server_protocol::ConfigBatchWriteParams;
use codex_app_server_protocol::ConfigReadParams;
use codex_app_server_protocol::ConfigValueWriteParams;
use codex_app_server_protocol::ConfigWarningNotification;
+use codex_app_server_protocol::ExperimentalApi;
use codex_app_server_protocol::InitializeResponse;
use codex_app_server_protocol::JSONRPCError;
use codex_app_server_protocol::JSONRPCErrorError;
@@ -24,6 +28,7 @@ use codex_app_server_protocol::JSONRPCResponse;
use codex_app_server_protocol::RequestId;
use codex_app_server_protocol::ServerNotification;
use codex_app_server_protocol::ServerRequestPayload;
+use codex_app_server_protocol::experimental_required_message;
use codex_core::AuthManager;
use codex_core::ThreadManager;
use codex_core::auth::ExternalAuthRefreshContext;
@@ -31,10 +36,12 @@ use codex_core::auth::ExternalAuthRefreshReason;
use codex_core::auth::ExternalAuthRefresher;
use codex_core::auth::ExternalAuthTokens;
use codex_core::config::Config;
+use codex_core::config_loader::CloudRequirementsLoader;
use codex_core::config_loader::LoaderOverrides;
use codex_core::default_client::SetOriginatorError;
use codex_core::default_client::USER_AGENT_SUFFIX;
use codex_core::default_client::get_codex_user_agent;
+use codex_core::default_client::set_default_client_residency_requirement;
use codex_core::default_client::set_default_originator;
use codex_feedback::CodexFeedback;
use codex_protocol::ThreadId;
@@ -102,23 +109,39 @@ pub(crate) struct MessageProcessor {
outgoing: Arc,
codex_message_processor: CodexMessageProcessor,
config_api: ConfigApi,
+ config: Arc,
initialized: bool,
+ experimental_api_enabled: Arc,
config_warnings: Vec,
}
+pub(crate) struct MessageProcessorArgs {
+ pub(crate) outgoing: OutgoingMessageSender,
+ pub(crate) codex_linux_sandbox_exe: Option,
+ pub(crate) config: Arc,
+ pub(crate) cli_overrides: Vec<(String, TomlValue)>,
+ pub(crate) loader_overrides: LoaderOverrides,
+ pub(crate) cloud_requirements: CloudRequirementsLoader,
+ pub(crate) feedback: CodexFeedback,
+ pub(crate) config_warnings: Vec,
+}
+
impl MessageProcessor {
/// Create a new `MessageProcessor`, retaining a handle to the outgoing
/// `Sender` so handlers can enqueue messages to be written to stdout.
- pub(crate) fn new(
- outgoing: OutgoingMessageSender,
- codex_linux_sandbox_exe: Option,
- config: Arc,
- cli_overrides: Vec<(String, TomlValue)>,
- loader_overrides: LoaderOverrides,
- feedback: CodexFeedback,
- config_warnings: Vec,
- ) -> Self {
+ pub(crate) fn new(args: MessageProcessorArgs) -> Self {
+ let MessageProcessorArgs {
+ outgoing,
+ codex_linux_sandbox_exe,
+ config,
+ cli_overrides,
+ loader_overrides,
+ cloud_requirements,
+ feedback,
+ config_warnings,
+ } = args;
let outgoing = Arc::new(outgoing);
+ let experimental_api_enabled = Arc::new(AtomicBool::new(false));
let auth_manager = AuthManager::shared(
config.codex_home.clone(),
false,
@@ -133,22 +156,30 @@ impl MessageProcessor {
auth_manager.clone(),
SessionSource::VSCode,
));
- let codex_message_processor = CodexMessageProcessor::new(
+ let codex_message_processor = CodexMessageProcessor::new(CodexMessageProcessorArgs {
auth_manager,
thread_manager,
- outgoing.clone(),
+ outgoing: outgoing.clone(),
codex_linux_sandbox_exe,
- Arc::clone(&config),
- cli_overrides.clone(),
+ config: Arc::clone(&config),
+ cli_overrides: cli_overrides.clone(),
+ cloud_requirements: cloud_requirements.clone(),
feedback,
+ });
+ let config_api = ConfigApi::new(
+ config.codex_home.clone(),
+ cli_overrides,
+ loader_overrides,
+ cloud_requirements,
);
- let config_api = ConfigApi::new(config.codex_home.clone(), cli_overrides, loader_overrides);
Self {
outgoing,
codex_message_processor,
config_api,
+ config,
initialized: false,
+ experimental_api_enabled,
config_warnings,
}
}
@@ -194,6 +225,12 @@ impl MessageProcessor {
self.outgoing.send_error(request_id, error).await;
return;
} else {
+ let experimental_api_enabled = params
+ .capabilities
+ .as_ref()
+ .is_some_and(|cap| cap.experimental_api);
+ self.experimental_api_enabled
+ .store(experimental_api_enabled, Ordering::Relaxed);
let ClientInfo {
name,
title: _title,
@@ -220,6 +257,7 @@ impl MessageProcessor {
}
}
}
+ set_default_client_residency_requirement(self.config.enforce_residency.value());
let user_agent_suffix = format!("{name}; {version}");
if let Ok(mut suffix) = USER_AGENT_SUFFIX.lock() {
*suffix = Some(user_agent_suffix);
@@ -256,6 +294,18 @@ impl MessageProcessor {
}
}
+ if let Some(reason) = codex_request.experimental_reason()
+ && !self.experimental_api_enabled.load(Ordering::Relaxed)
+ {
+ let error = JSONRPCErrorError {
+ code: INVALID_REQUEST_ERROR_CODE,
+ message: experimental_required_message(reason),
+ data: None,
+ };
+ self.outgoing.send_error(request_id, error).await;
+ return;
+ }
+
match codex_request {
ClientRequest::ConfigRead { request_id, params } => {
self.handle_config_read(request_id, params).await;
diff --git a/codex-rs/app-server/tests/common/mcp_process.rs b/codex-rs/app-server/tests/common/mcp_process.rs
index 90cd7635a3..4804a8cd37 100644
--- a/codex-rs/app-server/tests/common/mcp_process.rs
+++ b/codex-rs/app-server/tests/common/mcp_process.rs
@@ -26,6 +26,7 @@ use codex_app_server_protocol::FeedbackUploadParams;
use codex_app_server_protocol::ForkConversationParams;
use codex_app_server_protocol::GetAccountParams;
use codex_app_server_protocol::GetAuthStatusParams;
+use codex_app_server_protocol::InitializeCapabilities;
use codex_app_server_protocol::InitializeParams;
use codex_app_server_protocol::InterruptConversationParams;
use codex_app_server_protocol::JSONRPCError;
@@ -37,6 +38,7 @@ use codex_app_server_protocol::JSONRPCResponse;
use codex_app_server_protocol::ListConversationsParams;
use codex_app_server_protocol::LoginAccountParams;
use codex_app_server_protocol::LoginApiKeyParams;
+use codex_app_server_protocol::MockExperimentalMethodParams;
use codex_app_server_protocol::ModelListParams;
use codex_app_server_protocol::NewConversationParams;
use codex_app_server_protocol::RemoveConversationListenerParams;
@@ -164,7 +166,32 @@ impl McpProcess {
&mut self,
client_info: ClientInfo,
) -> anyhow::Result {
- let params = Some(serde_json::to_value(InitializeParams { client_info })?);
+ self.initialize_with_capabilities(
+ client_info,
+ Some(InitializeCapabilities {
+ experimental_api: true,
+ }),
+ )
+ .await
+ }
+
+ pub async fn initialize_with_capabilities(
+ &mut self,
+ client_info: ClientInfo,
+ capabilities: Option,
+ ) -> anyhow::Result {
+ self.initialize_with_params(InitializeParams {
+ client_info,
+ capabilities,
+ })
+ .await
+ }
+
+ async fn initialize_with_params(
+ &mut self,
+ params: InitializeParams,
+ ) -> anyhow::Result {
+ let params = Some(serde_json::to_value(params)?);
let request_id = self.send_request("initialize", params).await?;
let message = self.read_jsonrpc_message().await?;
match message {
@@ -451,6 +478,15 @@ impl McpProcess {
self.send_request("collaborationMode/list", params).await
}
+ /// Send a `mock/experimentalMethod` JSON-RPC request.
+ pub async fn send_mock_experimental_method_request(
+ &mut self,
+ params: MockExperimentalMethodParams,
+ ) -> anyhow::Result {
+ let params = Some(serde_json::to_value(params)?);
+ self.send_request("mock/experimentalMethod", params).await
+ }
+
/// Send a `resumeConversation` JSON-RPC request.
pub async fn send_resume_conversation_request(
&mut self,
diff --git a/codex-rs/app-server/tests/suite/v2/experimental_api.rs b/codex-rs/app-server/tests/suite/v2/experimental_api.rs
new file mode 100644
index 0000000000..5116633a48
--- /dev/null
+++ b/codex-rs/app-server/tests/suite/v2/experimental_api.rs
@@ -0,0 +1,160 @@
+use anyhow::Result;
+use app_test_support::DEFAULT_CLIENT_NAME;
+use app_test_support::McpProcess;
+use app_test_support::create_mock_responses_server_sequence_unchecked;
+use app_test_support::to_response;
+use codex_app_server_protocol::ClientInfo;
+use codex_app_server_protocol::InitializeCapabilities;
+use codex_app_server_protocol::JSONRPCError;
+use codex_app_server_protocol::JSONRPCMessage;
+use codex_app_server_protocol::JSONRPCResponse;
+use codex_app_server_protocol::MockExperimentalMethodParams;
+use codex_app_server_protocol::RequestId;
+use codex_app_server_protocol::ThreadStartParams;
+use codex_app_server_protocol::ThreadStartResponse;
+use pretty_assertions::assert_eq;
+use std::path::Path;
+use std::time::Duration;
+use tempfile::TempDir;
+use tokio::time::timeout;
+
+const DEFAULT_TIMEOUT: Duration = Duration::from_secs(10);
+
+#[tokio::test]
+async fn mock_experimental_method_requires_experimental_api_capability() -> Result<()> {
+ let codex_home = TempDir::new()?;
+ let mut mcp = McpProcess::new(codex_home.path()).await?;
+
+ let init = mcp
+ .initialize_with_capabilities(
+ default_client_info(),
+ Some(InitializeCapabilities {
+ experimental_api: false,
+ }),
+ )
+ .await?;
+ let JSONRPCMessage::Response(_) = init else {
+ anyhow::bail!("expected initialize response, got {init:?}");
+ };
+
+ let request_id = mcp
+ .send_mock_experimental_method_request(MockExperimentalMethodParams::default())
+ .await?;
+ let error = timeout(
+ DEFAULT_TIMEOUT,
+ mcp.read_stream_until_error_message(RequestId::Integer(request_id)),
+ )
+ .await??;
+ assert_experimental_capability_error(error, "mock/experimentalMethod");
+ Ok(())
+}
+
+#[tokio::test]
+async fn thread_start_mock_field_requires_experimental_api_capability() -> Result<()> {
+ let server = create_mock_responses_server_sequence_unchecked(Vec::new()).await;
+ let codex_home = TempDir::new()?;
+ create_config_toml(codex_home.path(), &server.uri())?;
+
+ let mut mcp = McpProcess::new(codex_home.path()).await?;
+ let init = mcp
+ .initialize_with_capabilities(
+ default_client_info(),
+ Some(InitializeCapabilities {
+ experimental_api: false,
+ }),
+ )
+ .await?;
+ let JSONRPCMessage::Response(_) = init else {
+ anyhow::bail!("expected initialize response, got {init:?}");
+ };
+
+ let request_id = mcp
+ .send_thread_start_request(ThreadStartParams {
+ mock_experimental_field: Some("mock".to_string()),
+ ..Default::default()
+ })
+ .await?;
+
+ let error = timeout(
+ DEFAULT_TIMEOUT,
+ mcp.read_stream_until_error_message(RequestId::Integer(request_id)),
+ )
+ .await??;
+ assert_experimental_capability_error(error, "thread/start.mockExperimentalField");
+ Ok(())
+}
+
+#[tokio::test]
+async fn thread_start_without_dynamic_tools_allows_without_experimental_api_capability()
+-> Result<()> {
+ let server = create_mock_responses_server_sequence_unchecked(Vec::new()).await;
+ let codex_home = TempDir::new()?;
+ create_config_toml(codex_home.path(), &server.uri())?;
+
+ let mut mcp = McpProcess::new(codex_home.path()).await?;
+ let init = mcp
+ .initialize_with_capabilities(
+ default_client_info(),
+ Some(InitializeCapabilities {
+ experimental_api: false,
+ }),
+ )
+ .await?;
+ let JSONRPCMessage::Response(_) = init else {
+ anyhow::bail!("expected initialize response, got {init:?}");
+ };
+
+ let request_id = mcp
+ .send_thread_start_request(ThreadStartParams {
+ model: Some("mock-model".to_string()),
+ ..Default::default()
+ })
+ .await?;
+ let response: JSONRPCResponse = timeout(
+ DEFAULT_TIMEOUT,
+ mcp.read_stream_until_response_message(RequestId::Integer(request_id)),
+ )
+ .await??;
+ let _: ThreadStartResponse = to_response(response)?;
+ Ok(())
+}
+
+fn default_client_info() -> ClientInfo {
+ ClientInfo {
+ name: DEFAULT_CLIENT_NAME.to_string(),
+ title: None,
+ version: "0.1.0".to_string(),
+ }
+}
+
+fn assert_experimental_capability_error(error: JSONRPCError, reason: &str) {
+ assert_eq!(error.error.code, -32600);
+ assert_eq!(
+ error.error.message,
+ format!("{reason} requires experimentalApi capability")
+ );
+ assert_eq!(error.error.data, None);
+}
+
+fn create_config_toml(codex_home: &Path, server_uri: &str) -> std::io::Result<()> {
+ let config_toml = codex_home.join("config.toml");
+ std::fs::write(
+ config_toml,
+ format!(
+ r#"
+model = "mock-model"
+approval_policy = "never"
+sandbox_mode = "read-only"
+
+model_provider = "mock_provider"
+
+[model_providers.mock_provider]
+name = "Mock provider for test"
+base_url = "{server_uri}/v1"
+wire_api = "responses"
+request_max_retries = 0
+stream_max_retries = 0
+"#
+ ),
+ )
+}
diff --git a/codex-rs/app-server/tests/suite/v2/mod.rs b/codex-rs/app-server/tests/suite/v2/mod.rs
index b67c3e5c33..3a84e48b9e 100644
--- a/codex-rs/app-server/tests/suite/v2/mod.rs
+++ b/codex-rs/app-server/tests/suite/v2/mod.rs
@@ -5,6 +5,7 @@ mod collaboration_mode_list;
mod compaction;
mod config_rpc;
mod dynamic_tools;
+mod experimental_api;
mod initialize;
mod model_list;
mod output_schema;
diff --git a/codex-rs/app-server/tests/suite/v2/thread_resume.rs b/codex-rs/app-server/tests/suite/v2/thread_resume.rs
index 6ad0a14b30..efa51573cb 100644
--- a/codex-rs/app-server/tests/suite/v2/thread_resume.rs
+++ b/codex-rs/app-server/tests/suite/v2/thread_resume.rs
@@ -402,7 +402,7 @@ async fn thread_resume_accepts_personality_override() -> Result<()> {
.send_thread_resume_request(ThreadResumeParams {
thread_id: thread.id.clone(),
model: Some("gpt-5.2-codex".to_string()),
- personality: Some(Personality::Friendly),
+ personality: Some(Personality::Pragmatic),
..Default::default()
})
.await?;
diff --git a/codex-rs/app-server/tests/suite/v2/thread_unarchive.rs b/codex-rs/app-server/tests/suite/v2/thread_unarchive.rs
index c56b39e33b..dada1cbf20 100644
--- a/codex-rs/app-server/tests/suite/v2/thread_unarchive.rs
+++ b/codex-rs/app-server/tests/suite/v2/thread_unarchive.rs
@@ -11,7 +11,11 @@ use codex_app_server_protocol::ThreadUnarchiveParams;
use codex_app_server_protocol::ThreadUnarchiveResponse;
use codex_core::find_archived_thread_path_by_id_str;
use codex_core::find_thread_path_by_id_str;
+use std::fs::FileTimes;
+use std::fs::OpenOptions;
use std::path::Path;
+use std::time::Duration;
+use std::time::SystemTime;
use tempfile::TempDir;
use tokio::time::timeout;
@@ -62,6 +66,16 @@ async fn thread_unarchive_moves_rollout_back_into_sessions_directory() -> Result
archived_path.exists(),
"expected {archived_path_display} to exist"
);
+ let old_time = SystemTime::UNIX_EPOCH + Duration::from_secs(1);
+ let old_timestamp = old_time
+ .duration_since(SystemTime::UNIX_EPOCH)
+ .expect("old timestamp")
+ .as_secs() as i64;
+ let times = FileTimes::new().set_modified(old_time);
+ OpenOptions::new()
+ .append(true)
+ .open(&archived_path)?
+ .set_times(times)?;
let unarchive_id = mcp
.send_thread_unarchive_request(ThreadUnarchiveParams {
@@ -73,7 +87,13 @@ async fn thread_unarchive_moves_rollout_back_into_sessions_directory() -> Result
mcp.read_stream_until_response_message(RequestId::Integer(unarchive_id)),
)
.await??;
- let _: ThreadUnarchiveResponse = to_response::(unarchive_resp)?;
+ let ThreadUnarchiveResponse {
+ thread: unarchived_thread,
+ } = to_response::(unarchive_resp)?;
+ assert!(
+ unarchived_thread.updated_at > old_timestamp,
+ "expected updated_at to be bumped on unarchive"
+ );
let rollout_path_display = rollout_path.display();
assert!(
diff --git a/codex-rs/app-server/tests/suite/v2/turn_start.rs b/codex-rs/app-server/tests/suite/v2/turn_start.rs
index 99eff9ecb2..1b53a5cfef 100644
--- a/codex-rs/app-server/tests/suite/v2/turn_start.rs
+++ b/codex-rs/app-server/tests/suite/v2/turn_start.rs
@@ -451,7 +451,7 @@ async fn turn_start_accepts_personality_override_v2() -> Result<()> {
text: "Hello".to_string(),
text_elements: Vec::new(),
}],
- personality: Some(Personality::Friendly),
+ personality: Some(Personality::Pragmatic),
..Default::default()
})
.await?;
@@ -484,6 +484,117 @@ async fn turn_start_accepts_personality_override_v2() -> Result<()> {
Ok(())
}
+#[tokio::test]
+async fn turn_start_change_personality_mid_thread_v2() -> Result<()> {
+ skip_if_no_network!(Ok(()));
+
+ let server = responses::start_mock_server().await;
+ let sse1 = responses::sse(vec![
+ responses::ev_response_created("resp-1"),
+ responses::ev_assistant_message("msg-1", "Done"),
+ responses::ev_completed("resp-1"),
+ ]);
+ let sse2 = responses::sse(vec![
+ responses::ev_response_created("resp-2"),
+ responses::ev_assistant_message("msg-2", "Done"),
+ responses::ev_completed("resp-2"),
+ ]);
+ let response_mock = responses::mount_sse_sequence(&server, vec![sse1, sse2]).await;
+
+ let codex_home = TempDir::new()?;
+ create_config_toml(
+ codex_home.path(),
+ &server.uri(),
+ "never",
+ &BTreeMap::from([(Feature::Personality, true)]),
+ )?;
+
+ let mut mcp = McpProcess::new(codex_home.path()).await?;
+ timeout(DEFAULT_READ_TIMEOUT, mcp.initialize()).await??;
+
+ let thread_req = mcp
+ .send_thread_start_request(ThreadStartParams {
+ model: Some("exp-codex-personality".to_string()),
+ ..Default::default()
+ })
+ .await?;
+ let thread_resp: JSONRPCResponse = timeout(
+ DEFAULT_READ_TIMEOUT,
+ mcp.read_stream_until_response_message(RequestId::Integer(thread_req)),
+ )
+ .await??;
+ let ThreadStartResponse { thread, .. } = to_response::(thread_resp)?;
+
+ let turn_req = mcp
+ .send_turn_start_request(TurnStartParams {
+ thread_id: thread.id.clone(),
+ input: vec![V2UserInput::Text {
+ text: "Hello".to_string(),
+ text_elements: Vec::new(),
+ }],
+ personality: None,
+ ..Default::default()
+ })
+ .await?;
+ let turn_resp: JSONRPCResponse = timeout(
+ DEFAULT_READ_TIMEOUT,
+ mcp.read_stream_until_response_message(RequestId::Integer(turn_req)),
+ )
+ .await??;
+ let _turn: TurnStartResponse = to_response::(turn_resp)?;
+
+ timeout(
+ DEFAULT_READ_TIMEOUT,
+ mcp.read_stream_until_notification_message("turn/completed"),
+ )
+ .await??;
+
+ let turn_req2 = mcp
+ .send_turn_start_request(TurnStartParams {
+ thread_id: thread.id.clone(),
+ input: vec![V2UserInput::Text {
+ text: "Hello again".to_string(),
+ text_elements: Vec::new(),
+ }],
+ personality: Some(Personality::Pragmatic),
+ ..Default::default()
+ })
+ .await?;
+ let turn_resp2: JSONRPCResponse = timeout(
+ DEFAULT_READ_TIMEOUT,
+ mcp.read_stream_until_response_message(RequestId::Integer(turn_req2)),
+ )
+ .await??;
+ let _turn2: TurnStartResponse = to_response::(turn_resp2)?;
+
+ timeout(
+ DEFAULT_READ_TIMEOUT,
+ mcp.read_stream_until_notification_message("turn/completed"),
+ )
+ .await??;
+
+ let requests = response_mock.requests();
+ assert_eq!(requests.len(), 2, "expected two requests");
+
+ let first_developer_texts = requests[0].message_input_texts("developer");
+ assert!(
+ first_developer_texts
+ .iter()
+ .all(|text| !text.contains("")),
+ "expected no personality update message in first request, got {first_developer_texts:?}"
+ );
+
+ let second_developer_texts = requests[1].message_input_texts("developer");
+ assert!(
+ second_developer_texts
+ .iter()
+ .any(|text| text.contains("")),
+ "expected personality update message in second request, got {second_developer_texts:?}"
+ );
+
+ Ok(())
+}
+
#[tokio::test]
async fn turn_start_accepts_local_image_input() -> Result<()> {
// Two Codex turns hit the mock model (session start + turn/start).
diff --git a/codex-rs/apply-patch/src/standalone_executable.rs b/codex-rs/apply-patch/src/standalone_executable.rs
index ba31465c8d..d77a82fa95 100644
--- a/codex-rs/apply-patch/src/standalone_executable.rs
+++ b/codex-rs/apply-patch/src/standalone_executable.rs
@@ -27,7 +27,7 @@ pub fn run_main() -> i32 {
match std::io::stdin().read_to_string(&mut buf) {
Ok(_) => {
if buf.is_empty() {
- eprintln!("Usage: apply_patch 'PATCH'\n echo 'PATCH' | apply-patch");
+ eprintln!("Usage: apply_patch 'PATCH'\n echo 'PATCH' | apply_patch");
return 2;
}
buf
diff --git a/codex-rs/cli/src/main.rs b/codex-rs/cli/src/main.rs
index 7ab8bc937a..01aef19176 100644
--- a/codex-rs/cli/src/main.rs
+++ b/codex-rs/cli/src/main.rs
@@ -303,6 +303,10 @@ struct GenerateTsCommand {
/// Optional path to the Prettier executable to format generated files
#[arg(short = 'p', long = "prettier", value_name = "PRETTIER_BIN")]
prettier: Option,
+
+ /// Include experimental methods and fields in the generated output
+ #[arg(long = "experimental", default_value_t = false)]
+ experimental: bool,
}
#[derive(Debug, Args)]
@@ -310,6 +314,10 @@ struct GenerateJsonSchemaCommand {
/// Output directory where the schema bundle will be written
#[arg(short = 'o', long = "out", value_name = "DIR")]
out_dir: PathBuf,
+
+ /// Include experimental methods and fields in the generated output
+ #[arg(long = "experimental", default_value_t = false)]
+ experimental: bool,
}
#[derive(Debug, Parser)]
@@ -539,13 +547,21 @@ async fn cli_main(codex_linux_sandbox_exe: Option) -> anyhow::Result<()
.await?;
}
Some(AppServerSubcommand::GenerateTs(gen_cli)) => {
- codex_app_server_protocol::generate_ts(
+ let options = codex_app_server_protocol::GenerateTsOptions {
+ experimental_api: gen_cli.experimental,
+ ..Default::default()
+ };
+ codex_app_server_protocol::generate_ts_with_options(
&gen_cli.out_dir,
gen_cli.prettier.as_deref(),
+ options,
)?;
}
Some(AppServerSubcommand::GenerateJsonSchema(gen_cli)) => {
- codex_app_server_protocol::generate_json(&gen_cli.out_dir)?;
+ codex_app_server_protocol::generate_json_with_experimental(
+ &gen_cli.out_dir,
+ gen_cli.experimental,
+ )?;
}
},
Some(Subcommand::Resume(ResumeCommand {
diff --git a/codex-rs/cloud-requirements/src/lib.rs b/codex-rs/cloud-requirements/src/lib.rs
index ed1bb051d5..535fef3876 100644
--- a/codex-rs/cloud-requirements/src/lib.rs
+++ b/codex-rs/cloud-requirements/src/lib.rs
@@ -1,7 +1,8 @@
//! Cloud-hosted config requirements for Codex.
//!
//! This crate fetches `requirements.toml` data from the backend as an alternative to loading it
-//! from the local filesystem. It only applies to Enterprise ChatGPT customers.
+//! from the local filesystem. It only applies to Business (aka Enterprise CBP) or Enterprise ChatGPT
+//! customers.
//!
//! Today, fetching is best-effort: on error or timeout, Codex continues without cloud requirements.
//! We expect to tighten this so that Enterprise ChatGPT customers must successfully fetch these
@@ -19,7 +20,7 @@ use std::time::Duration;
use std::time::Instant;
use tokio::time::timeout;
-/// This blocks codecs startup, so must be short.
+/// This blocks codex startup, so must be short.
const CLOUD_REQUIREMENTS_TIMEOUT: Duration = Duration::from_secs(5);
#[async_trait]
@@ -119,7 +120,12 @@ impl CloudRequirementsService {
async fn fetch(&self) -> Option {
let auth = self.auth_manager.auth().await?;
- if !(auth.is_chatgpt_auth() && auth.account_plan_type() == Some(PlanType::Enterprise)) {
+ if !auth.is_chatgpt_auth()
+ || !matches!(
+ auth.account_plan_type(),
+ Some(PlanType::Business | PlanType::Enterprise)
+ )
+ {
return None;
}
@@ -269,10 +275,9 @@ mod tests {
}
#[tokio::test]
- async fn fetch_cloud_requirements_skips_non_enterprise_plan() {
- let auth_manager = auth_manager_with_plan("pro");
+ async fn fetch_cloud_requirements_skips_non_business_or_enterprise_plan() {
let service = CloudRequirementsService::new(
- auth_manager,
+ auth_manager_with_plan("pro"),
Arc::new(StaticFetcher { contents: None }),
CLOUD_REQUIREMENTS_TIMEOUT,
);
@@ -280,6 +285,27 @@ mod tests {
assert!(result.is_none());
}
+ #[tokio::test]
+ async fn fetch_cloud_requirements_allows_business_plan() {
+ let service = CloudRequirementsService::new(
+ auth_manager_with_plan("business"),
+ Arc::new(StaticFetcher {
+ contents: Some("allowed_approval_policies = [\"never\"]".to_string()),
+ }),
+ CLOUD_REQUIREMENTS_TIMEOUT,
+ );
+ assert_eq!(
+ service.fetch().await,
+ Some(ConfigRequirementsToml {
+ allowed_approval_policies: Some(vec![AskForApproval::Never]),
+ allowed_sandbox_modes: None,
+ mcp_servers: None,
+ rules: None,
+ enforce_residency: None,
+ })
+ );
+ }
+
#[tokio::test]
async fn fetch_cloud_requirements_handles_missing_contents() {
let result = parse_for_fetch(None);
@@ -315,6 +341,7 @@ mod tests {
allowed_sandbox_modes: None,
mcp_servers: None,
rules: None,
+ enforce_residency: None,
})
);
}
diff --git a/codex-rs/codex-api/src/endpoint/responses_websocket.rs b/codex-rs/codex-api/src/endpoint/responses_websocket.rs
index b088374b89..2a7d8726f1 100644
--- a/codex-rs/codex-api/src/endpoint/responses_websocket.rs
+++ b/codex-rs/codex-api/src/endpoint/responses_websocket.rs
@@ -6,6 +6,7 @@ use crate::error::ApiError;
use crate::provider::Provider;
use crate::sse::responses::ResponsesStreamEvent;
use crate::sse::responses::process_responses_event;
+use crate::telemetry::WebsocketTelemetry;
use codex_client::TransportError;
use futures::SinkExt;
use futures::StreamExt;
@@ -18,6 +19,7 @@ use std::time::Duration;
use tokio::net::TcpStream;
use tokio::sync::Mutex;
use tokio::sync::mpsc;
+use tokio::time::Instant;
use tokio_tungstenite::MaybeTlsStream;
use tokio_tungstenite::WebSocketStream;
use tokio_tungstenite::tungstenite::Error as WsError;
@@ -38,14 +40,21 @@ pub struct ResponsesWebsocketConnection {
// TODO (pakrym): is this the right place for timeout?
idle_timeout: Duration,
server_reasoning_included: bool,
+ telemetry: Option>,
}
impl ResponsesWebsocketConnection {
- fn new(stream: WsStream, idle_timeout: Duration, server_reasoning_included: bool) -> Self {
+ fn new(
+ stream: WsStream,
+ idle_timeout: Duration,
+ server_reasoning_included: bool,
+ telemetry: Option>,
+ ) -> Self {
Self {
stream: Arc::new(Mutex::new(Some(stream))),
idle_timeout,
server_reasoning_included,
+ telemetry,
}
}
@@ -62,6 +71,7 @@ impl ResponsesWebsocketConnection {
let stream = Arc::clone(&self.stream);
let idle_timeout = self.idle_timeout;
let server_reasoning_included = self.server_reasoning_included;
+ let telemetry = self.telemetry.clone();
let request_body = serde_json::to_value(&request).map_err(|err| {
ApiError::Stream(format!("failed to encode websocket request: {err}"))
})?;
@@ -87,6 +97,7 @@ impl ResponsesWebsocketConnection {
tx_event.clone(),
request_body,
idle_timeout,
+ telemetry,
)
.await
{
@@ -114,6 +125,7 @@ impl ResponsesWebsocketClient {
&self,
extra_headers: HeaderMap,
turn_state: Option>>,
+ telemetry: Option>,
) -> Result {
let ws_url = self
.provider
@@ -130,6 +142,7 @@ impl ResponsesWebsocketClient