felixxia-oai
a6d20ed297
[codex] Surface MCP reauthentication-required startup failures ( #29877 )
...
## Summary
- distinguish expired, non-refreshable stored MCP OAuth credentials from
first-time missing credentials
- carry a typed `failureReason: "reauthenticationRequired"` on the
existing `mcpServer/startupStatus/updated` notification only when user
action is required
- keep the public MCP auth-status API unchanged and regenerate the
app-server protocol schemas and documentation
## Why
An MCP server with an expired access token and no usable refresh token
currently fails startup without giving clients a reliable, typed
recovery signal.
The existing startup-status notification is the natural place to carry
this state. Its nullable `failureReason` keeps the recovery reason
attached to the failed startup transition without adding a one-off
notification. Internally, Codex distinguishes first-time login from
reauthentication and emits the reason only when the startup error itself
requires authentication.
## User impact
App clients can prompt an existing user to reconnect an MCP server when
automatic recovery is impossible by handling a failed
`mcpServer/startupStatus/updated` notification whose `failureReason` is
`reauthenticationRequired`. Starting, ready, cancelled, unrelated
failures, and first-time setup carry no reauthentication reason.
## Companion app PR
- openai/openai#1069582
## Validation
- `just test -p codex-app-server-protocol` โ 248 passed; schema fixture
tests passed
- `cargo check -p codex-app-server -p codex-tui`
- `just test -p codex-rmcp-client -p codex-mcp` โ 184 passed, 2 skipped
- `just test -p codex-protocol -p codex-app-server-protocol -p
codex-mcp` โ 579 passed
- `just write-app-server-schema`
- `just fmt`
History
..
2026-02-01 23:38:43 -08:00
2026-06-01 21:25:42 -07:00
2026-06-10 20:42:38 -07:00
2026-02-01 23:38:43 -08:00
2026-06-24 13:25:44 -07:00
2026-02-09 23:10:26 -08:00
2026-06-24 13:25:44 -07:00
2026-02-01 23:38:43 -08:00
2026-02-01 23:38:43 -08:00
2026-03-06 17:30:17 -08:00
2026-05-18 17:28:50 -07:00
2026-03-06 17:30:17 -08:00
2026-03-06 17:30:17 -08:00
2026-03-06 17:30:17 -08:00
2026-03-06 17:30:17 -08:00
2026-03-06 17:30:17 -08:00
2026-02-01 23:38:43 -08:00
2026-03-06 17:30:17 -08:00
2026-03-06 17:30:17 -08:00
2026-03-08 17:38:01 -07:00
2026-05-22 16:52:53 +00:00
2026-06-23 12:13:54 -07:00
2026-06-23 12:13:54 -07:00
2026-02-01 23:38:43 -08:00
2026-02-01 23:38:43 -08:00
2026-05-31 15:54:31 -07:00
2026-06-15 21:54:01 +00:00
2026-06-15 21:54:01 +00:00
2026-02-01 23:38:43 -08:00
2026-02-01 23:38:43 -08:00
2026-06-23 16:49:13 -07:00
2026-03-25 02:27:00 +00:00
2026-03-25 02:27:00 +00:00
2026-05-18 12:12:14 -07:00
2026-02-05 23:31:04 +00:00
2026-06-17 13:16:34 -07:00
2026-06-24 08:56:57 -07:00
2026-06-15 23:17:24 -07:00
2026-06-15 23:17:24 -07:00
2026-06-24 08:56:57 -07:00
2026-06-15 23:17:24 -07:00
2026-06-15 13:25:42 -07:00
2026-05-22 16:52:53 +00:00
2026-02-01 23:38:43 -08:00
2026-04-30 11:42:07 -07:00
2026-04-20 10:44:03 -07:00
2026-04-07 11:22:28 -07:00
2026-03-13 14:42:20 -07:00
2026-03-13 14:42:20 -07:00
2026-03-13 14:42:20 -07:00
2026-03-13 14:42:20 -07:00
2026-03-13 14:42:20 -07:00
2026-04-13 17:46:56 -07:00
2026-03-13 14:42:20 -07:00
2026-03-13 14:42:20 -07:00
2026-03-13 14:42:20 -07:00
2026-03-13 14:42:20 -07:00
2026-03-13 14:42:20 -07:00
2026-03-13 14:42:20 -07:00
2026-04-07 11:22:28 -07:00
2026-03-24 15:52:13 -07:00
2026-04-07 11:22:28 -07:00
2026-04-07 11:22:28 -07:00
2026-03-13 14:42:20 -07:00
2026-03-13 14:42:20 -07:00
2026-05-22 16:52:53 +00:00
2026-06-15 21:54:01 +00:00
2026-06-22 13:19:40 -07:00
2026-06-05 14:43:44 +00:00
2026-06-22 04:25:07 -07:00
2026-04-22 20:34:15 +00:00
2026-05-31 15:54:31 -07:00
2026-04-29 23:39:57 +00:00
2026-05-31 15:54:31 -07:00
2026-05-31 15:54:31 -07:00
2026-06-23 19:52:37 +00:00
2026-06-16 20:47:43 +00:00
2026-06-16 20:47:43 +00:00
2026-06-23 19:52:37 +00:00
2026-05-26 07:44:04 -07:00
2026-05-28 09:38:34 -07:00
2026-04-29 19:14:53 -04:00
2026-03-27 00:27:15 -07:00
2026-02-01 23:38:43 -08:00
2026-04-13 20:37:11 -07:00
2026-04-13 20:37:11 -07:00
2026-04-19 23:22:49 -07:00
2026-04-19 23:22:49 -07:00
2026-04-23 13:00:46 -07:00
2026-04-23 13:00:46 -07:00
2026-04-20 19:59:36 -07:00
2026-04-06 19:17:14 -07:00
2026-06-25 10:31:17 +01:00
2026-06-25 10:31:17 +01:00
2026-02-01 23:38:43 -08:00
2026-02-01 23:38:43 -08:00
2026-06-25 21:50:36 +00:00
2026-04-11 04:39:19 +00:00
2026-04-11 04:39:19 +00:00
2026-02-01 23:38:43 -08:00
2026-02-13 16:26:32 -08:00
2026-06-04 13:36:24 -07:00
2026-04-29 01:36:19 +00:00
2026-04-29 01:36:19 +00:00
2026-02-17 11:02:23 -08:00
2026-06-22 19:51:03 -07:00
2026-04-22 22:24:12 -07:00
2026-05-20 02:42:56 +00:00
2026-06-22 13:48:09 -07:00
2026-02-01 23:38:43 -08:00
2026-05-18 03:11:54 -07:00
2026-06-22 16:01:27 -07:00
2026-04-17 16:47:58 -07:00
2026-06-11 10:34:41 -07:00
2026-06-15 22:07:07 +00:00
2026-06-22 16:01:27 -07:00
2026-04-17 16:47:58 -07:00
2026-06-22 16:01:27 -07:00
2026-05-13 00:50:29 -07:00
2026-05-13 00:50:29 -07:00
2026-04-29 23:49:20 -07:00
2026-04-29 23:49:20 -07:00
2026-04-29 23:49:20 -07:00
2026-06-22 16:01:27 -07:00
2026-05-08 20:46:39 -07:00
2026-04-29 23:49:20 -07:00
2026-05-08 20:46:39 -07:00
2026-05-08 20:46:39 -07:00
2026-05-01 00:16:25 -07:00
2026-05-01 00:16:25 -07:00
2026-04-17 16:47:58 -07:00
2026-03-09 12:40:25 -07:00
2026-05-04 16:43:58 -07:00
2026-05-04 16:43:58 -07:00
2026-06-22 16:45:14 -07:00
2026-02-01 23:38:43 -08:00
2026-02-01 23:38:43 -08:00
2026-02-01 23:38:43 -08:00
2026-05-15 14:33:24 -07:00
2026-02-01 23:38:43 -08:00
2026-06-23 16:49:13 -07:00
2026-04-17 21:41:57 -07:00
2026-04-17 21:41:57 -07:00
2026-02-27 12:45:59 -08:00
2026-03-03 17:01:00 -08:00
2026-03-23 12:57:40 -07:00
2026-02-01 23:38:43 -08:00
2026-05-28 21:14:34 -07:00
2026-05-28 21:14:34 -07:00
2026-05-07 20:56:42 -07:00
2026-04-14 14:26:10 -07:00
2026-02-01 23:38:43 -08:00
2026-04-22 10:38:19 -07:00
2026-04-22 10:38:19 -07:00
2026-02-17 14:53:58 -08:00
2026-02-01 23:38:43 -08:00
2026-02-01 23:38:43 -08:00
2026-02-25 13:14:30 -08:00
2026-02-03 18:15:55 -08:00
2026-02-03 18:15:55 -08:00
2026-06-10 11:22:12 -07:00
2026-06-10 11:22:12 -07:00
2026-06-10 11:22:12 -07:00
2026-06-23 12:13:54 -07:00
2026-06-23 16:49:13 -07:00
2026-04-24 20:53:41 -07:00
2026-05-20 15:07:35 -07:00
2026-05-20 15:07:35 -07:00
2026-05-20 15:07:35 -07:00
2026-05-20 15:07:35 -07:00
2026-05-20 15:07:35 -07:00
2026-05-20 15:07:35 -07:00
2026-05-18 11:28:53 -07:00
2026-04-13 16:11:05 -07:00
2026-04-13 16:11:05 -07:00
2026-06-17 18:52:18 +00:00
2026-06-23 16:49:13 -07:00
2026-02-01 23:38:43 -08:00
2026-02-01 23:38:43 -08:00
2026-03-03 15:56:11 -08:00
2026-06-23 16:49:13 -07:00
2026-02-01 23:38:43 -08:00
2026-05-22 16:52:53 +00:00
2026-06-23 16:49:13 -07:00
2026-02-25 09:59:10 -08:00
2026-02-25 09:59:10 -08:00
2026-02-25 09:59:10 -08:00
2026-03-16 21:38:07 -07:00
2026-04-07 15:43:38 -07:00
2026-04-30 13:39:48 +03:00
2026-04-14 00:13:13 -07:00
2026-04-14 00:13:13 -07:00
2026-06-23 12:13:54 -07:00
2026-06-23 16:49:13 -07:00
2026-06-25 17:15:46 +00:00
2026-06-23 16:49:13 -07:00
2026-02-01 23:38:43 -08:00
2026-02-01 23:38:43 -08:00
2026-06-23 12:13:54 -07:00
2026-03-18 23:42:40 -06:00
2026-03-18 23:42:40 -06:00
2026-06-23 16:49:13 -07:00
2026-06-23 22:37:31 +00:00
2026-06-23 16:49:13 -07:00
2026-02-18 15:20:03 -08:00
2026-02-01 23:38:43 -08:00
2026-02-17 14:53:58 -08:00
2026-02-01 23:38:43 -08:00
2026-06-23 16:49:13 -07:00
2026-02-25 13:14:30 -08:00
2026-02-25 13:14:30 -08:00
2026-06-23 16:49:13 -07:00
2026-02-01 23:38:43 -08:00
2026-02-01 23:38:43 -08:00
2026-02-01 23:38:43 -08:00
2026-06-05 02:41:06 -07:00
2026-02-01 23:38:43 -08:00
2026-06-23 16:49:13 -07:00
2026-06-23 12:13:54 -07:00
2026-06-23 16:49:13 -07:00
2026-05-28 14:54:39 -07:00
2026-02-06 00:35:04 +00:00
2026-04-17 18:11:47 -07:00
2026-05-05 09:58:23 -07:00
2026-02-18 13:03:16 -08:00
2026-03-08 18:07:46 -07:00
2026-02-18 13:03:16 -08:00
2026-02-01 23:38:43 -08:00