Files
codex/codex-rs/app-server-protocol/schema/json/v2/StartupGatewayOAuthChangedNotification.json
T
arnavpatidar-OAI b392250f48 Define the startup OAuth protocol for config servers (#62859)
## What changed

Add the optional `target` field to `account/gatewayOAuth/login`.
The startup protocol defines `{"kind":"configServer"}` as a target
for `--startup-oauth`, mutually exclusive with `modelProvider`.
The regular app-server login handler rejects explicit targets.

Define `StartupGatewayOAuthChangedNotification` with the target,
status, and authorization URL for the browser handoff. Export the
new types in the JSON schemas, TypeScript bindings, and Python SDK.

## Testing

Update the TUI device login regression test to expect `target: null`
when signing in to a resumed thread's saved gateway.

GitOrigin-RevId: fb3ce66a143cad9ad56c93f3ac37f8b6f1abdb0e
2026-11-20 23:24:10 +00:00

53 lines
1.1 KiB
JSON
Generated

{
"$schema": "http://json-schema.org/draft-07/schema#",
"definitions": {
"GatewayOAuthStatus": {
"enum": [
"notReady",
"started",
"succeeded",
"failed"
],
"type": "string"
},
"GatewayOAuthTarget": {
"description": "An explicit service to authorize instead of the selected model provider.",
"oneOf": [
{
"properties": {
"kind": {
"enum": [
"configServer"
],
"type": "string"
}
},
"required": [
"kind"
],
"title": "ConfigServerGatewayOAuthTarget",
"type": "object"
}
]
}
},
"description": "Browser handoff on the dedicated `--startup-oauth` connection.",
"properties": {
"authUrl": {
"type": "string"
},
"status": {
"$ref": "#/definitions/GatewayOAuthStatus"
},
"target": {
"$ref": "#/definitions/GatewayOAuthTarget"
}
},
"required": [
"authUrl",
"status",
"target"
],
"title": "StartupGatewayOAuthChangedNotification",
"type": "object"
}