You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit 9181cce
Browse filesBrowse the repository at this point in the historyBrowse files
feat: add a client-neutral recommended config value
A client opts in at initialize with clientCapabilities._meta.recommendedConfigValue { version: 1 }, under ACP v1 only. The model and reasoning effort selectors then carry _meta.recommendedConfigValue { version, value }: the isDefault model and the defaultReasoningEffort of the current model, sent only when the selector offers the value and computed again on a model switch.
The record never changes the current value. The AIR form is unchanged, and a client that declares both gets both.
Copy file name to clipboardExpand all lines: docs/air-extensions.md
+6Lines changed: 6 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -852,6 +852,12 @@ When the client declares `recommendedValue`, a selector with a recommendation ca
852
852
853
853
Without the capability, the config options keep their old shape and carry no recommendation.
854
854
855
+
### Client-neutral form
856
+
857
+
A client that isn't AIR can opt in with `clientCapabilities._meta.recommendedConfigValue: { "version": 1 }`, an object whose `version` is an integer of at least 1, and gets `_meta.recommendedConfigValue: { "version": 1 }` back from `initialize`. ACP v2 ignores the opt-in.
858
+
859
+
A selector with a recommendation then carries `_meta.recommendedConfigValue: { "version": 1, "value": "medium" }`, under the same rules as above. A client that declares AIR too gets both records.
860
+
855
861
## Async tasks
856
862
857
863
Codex app-server owns shell commands that keep running after their tool call.
it.each(['permissionPresentation','questionCustomAnswer'])('advertises the client-neutral %s only to a client that opts in',async(key)=>{
264
+
it.each(['permissionPresentation','questionCustomAnswer','recommendedConfigValue'])('advertises the client-neutral %s only to a client that opts in',async(key)=>{
0 commit comments