richardopenai 6b39d0c657 [codex] Add owner nudge app-server API (#18220) ...

## Summary

Second PR in the split from #17956. Stacked on #18227.

- adds app-server v2 protocol/schema support for
`account/sendAddCreditsNudgeEmail`
- adds the backend-client `send_add_credits_nudge_email` request and
request body mapping
- handles the app-server request with auth checks, backend call, and
cooldown mapping
- adds the disabled `workspace_owner_usage_nudge` feature flag and
focused app-server/backend tests

## Validation

- `cargo test -p codex-backend-client`
- `cargo test -p codex-app-server-protocol`
- `cargo test -p codex-app-server rate_limits`
- `cargo test -p codex-tui workspace_`
- `cargo test -p codex-tui status_`
- `just fmt`
- `just fix -p codex-backend-client`
- `just fix -p codex-app-server-protocol`
- `just fix -p codex-app-server`
- `just fix -p codex-tui`

2026-04-17 21:41:57 -07:00

..

AccountLoginCompletedNotification.json

…

AccountRateLimitsUpdatedNotification.json

[codex] Propagate rate limit reached type (#18227)

2026-04-17 13:37:25 -07:00

AccountUpdatedNotification.json

Support prolite plan type (#17419)

2026-04-11 13:58:16 -07:00

AgentMessageDeltaNotification.json

…

AppListUpdatedNotification.json

…

AppsListParams.json

…

AppsListResponse.json

…

CancelLoginAccountParams.json

…

CancelLoginAccountResponse.json

…

CommandExecOutputDeltaNotification.json

app-server: Add streaming and tty/pty capabilities to command/exec (#13640)

2026-03-06 17:30:17 -08:00

CommandExecParams.json

app-server: Add streaming and tty/pty capabilities to command/exec (#13640)

2026-03-06 17:30:17 -08:00

CommandExecResizeParams.json

app-server: Add streaming and tty/pty capabilities to command/exec (#13640)

2026-03-06 17:30:17 -08:00

CommandExecResizeResponse.json

app-server: Add streaming and tty/pty capabilities to command/exec (#13640)

2026-03-06 17:30:17 -08:00

CommandExecResponse.json

app-server: Add streaming and tty/pty capabilities to command/exec (#13640)

2026-03-06 17:30:17 -08:00

CommandExecTerminateParams.json

app-server: Add streaming and tty/pty capabilities to command/exec (#13640)

2026-03-06 17:30:17 -08:00

CommandExecTerminateResponse.json

app-server: Add streaming and tty/pty capabilities to command/exec (#13640)

2026-03-06 17:30:17 -08:00

CommandExecutionOutputDeltaNotification.json

…

CommandExecWriteParams.json

app-server: Add streaming and tty/pty capabilities to command/exec (#13640)

2026-03-06 17:30:17 -08:00

CommandExecWriteResponse.json

app-server: Add streaming and tty/pty capabilities to command/exec (#13640)

2026-03-06 17:30:17 -08:00

ConfigBatchWriteParams.json

[app-server] Support hot-reload user config when batch writing config. (#13839)

2026-03-08 17:38:01 -07:00

ConfigReadParams.json

…

ConfigReadResponse.json

Add Smart Approvals guardian review across core, app-server, and TUI (#13860)

2026-03-13 15:27:00 -07:00

ConfigRequirementsReadResponse.json

fix: Revert danger-full-access denylist-only mode (#17732)

2026-04-14 09:50:14 -07:00

ConfigValueWriteParams.json

…

ConfigWarningNotification.json

…

ConfigWriteResponse.json

…

ContextCompactedNotification.json

…

DeprecationNoticeNotification.json

…

ErrorNotification.json

tui: queue follow-ups during manual /compact (#15259)

2026-03-23 10:19:44 -07:00

ExperimentalFeatureEnablementSetParams.json

[app-server] Add a method to override feature flags. (#15601)

2026-03-25 02:27:00 +00:00

ExperimentalFeatureEnablementSetResponse.json

[app-server] Add a method to override feature flags. (#15601)

2026-03-25 02:27:00 +00:00

ExperimentalFeatureListParams.json

…

ExperimentalFeatureListResponse.json

…

ExternalAgentConfigDetectParams.json

…

ExternalAgentConfigDetectResponse.json

support plugins in external agent config migration (#17855)

2026-04-14 19:39:10 -07:00

ExternalAgentConfigImportCompletedNotification.json

Sync local plugin imports, async remote imports, refresh caches after… (#18246)

2026-04-17 09:34:55 +00:00

ExternalAgentConfigImportParams.json

support plugins in external agent config migration (#17855)

2026-04-14 19:39:10 -07:00

ExternalAgentConfigImportResponse.json

…

FeedbackUploadParams.json

Pass turn id with feedback uploads (#17314)

2026-04-11 00:23:50 -07:00

FeedbackUploadResponse.json

…

FileChangeOutputDeltaNotification.json

…

FsChangedNotification.json

app-server: Move watch_id to request of fs/watch (#17026)

2026-04-07 11:22:28 -07:00

FsCopyParams.json

app-server: add v2 filesystem APIs (#14245)

2026-03-13 14:42:20 -07:00

FsCopyResponse.json

app-server: add v2 filesystem APIs (#14245)

2026-03-13 14:42:20 -07:00

FsCreateDirectoryParams.json

app-server: add v2 filesystem APIs (#14245)

2026-03-13 14:42:20 -07:00

FsCreateDirectoryResponse.json

app-server: add v2 filesystem APIs (#14245)

2026-03-13 14:42:20 -07:00

FsGetMetadataParams.json

app-server: add v2 filesystem APIs (#14245)

2026-03-13 14:42:20 -07:00

FsGetMetadataResponse.json

[codex] Add symlink flag to fs metadata (#17719)

2026-04-13 17:46:56 -07:00

FsReadDirectoryParams.json

app-server: add v2 filesystem APIs (#14245)

2026-03-13 14:42:20 -07:00

FsReadDirectoryResponse.json

app-server: add v2 filesystem APIs (#14245)

2026-03-13 14:42:20 -07:00

FsReadFileParams.json

app-server: add v2 filesystem APIs (#14245)

2026-03-13 14:42:20 -07:00

FsReadFileResponse.json

app-server: add v2 filesystem APIs (#14245)

2026-03-13 14:42:20 -07:00

FsRemoveParams.json

app-server: add v2 filesystem APIs (#14245)

2026-03-13 14:42:20 -07:00

FsRemoveResponse.json

app-server: add v2 filesystem APIs (#14245)

2026-03-13 14:42:20 -07:00

FsUnwatchParams.json

app-server: Move watch_id to request of fs/watch (#17026)

2026-04-07 11:22:28 -07:00

FsUnwatchResponse.json

app-server: add filesystem watch support (#14533)

2026-03-24 15:52:13 -07:00

FsWatchParams.json

app-server: Move watch_id to request of fs/watch (#17026)

2026-04-07 11:22:28 -07:00

FsWatchResponse.json

app-server: Move watch_id to request of fs/watch (#17026)

2026-04-07 11:22:28 -07:00

FsWriteFileParams.json

app-server: add v2 filesystem APIs (#14245)

2026-03-13 14:42:20 -07:00

FsWriteFileResponse.json

app-server: add v2 filesystem APIs (#14245)

2026-03-13 14:42:20 -07:00

GetAccountParams.json

…

GetAccountRateLimitsResponse.json

[codex] Propagate rate limit reached type (#18227)

2026-04-17 13:37:25 -07:00

GetAccountResponse.json

Support prolite plan type (#17419)

2026-04-11 13:58:16 -07:00

HookCompletedNotification.json

Add PermissionRequest hooks support (#17563)

2026-04-17 14:45:47 +00:00

HookStartedNotification.json

Add PermissionRequest hooks support (#17563)

2026-04-17 14:45:47 +00:00

ItemCompletedNotification.json

[codex][mcp] Add resource uri meta to tool call item. (#17831)

2026-04-16 05:09:17 +00:00

ItemGuardianApprovalReviewCompletedNotification.json

Guardian -> Auto-Review (#18021)

2026-04-17 09:56:24 -07:00

ItemGuardianApprovalReviewStartedNotification.json

Guardian -> Auto-Review (#18021)

2026-04-17 09:56:24 -07:00

ItemStartedNotification.json

[codex][mcp] Add resource uri meta to tool call item. (#17831)

2026-04-16 05:09:17 +00:00

ListMcpServerStatusParams.json

Speed up /mcp inventory listing (#16831)

2026-04-06 16:27:02 -07:00

ListMcpServerStatusResponse.json

…

LoginAccountParams.json

Add ChatGPT device-code login to app server (#15525)

2026-03-27 00:27:15 -07:00

LoginAccountResponse.json

Add ChatGPT device-code login to app server (#15525)

2026-03-27 00:27:15 -07:00

LogoutAccountResponse.json

…

MarketplaceAddParams.json

[codex] Refactor marketplace add into shared core flow (#17717)

2026-04-13 20:37:11 -07:00

MarketplaceAddResponse.json

[codex] Refactor marketplace add into shared core flow (#17717)

2026-04-13 20:37:11 -07:00

McpResourceReadParams.json

[mcp] Support MCP Apps part 1. (#16082)

2026-04-06 19:17:14 -07:00

McpResourceReadResponse.json

[mcp] Support MCP Apps part 1. (#16082)

2026-04-06 19:17:14 -07:00

McpServerOauthLoginCompletedNotification.json

…

McpServerOauthLoginParams.json

…

McpServerOauthLoginResponse.json

…

McpServerRefreshResponse.json

…

McpServerStatusUpdatedNotification.json

feat(app-server): add mcpServer/startupStatus/updated notification (#15220)

2026-03-19 15:09:59 -07:00

McpServerToolCallParams.json

[mcp] Support MCP Apps part 3 - Add mcp tool call support. (#17364)

2026-04-11 04:39:19 +00:00

McpServerToolCallResponse.json

[mcp] Support MCP Apps part 3 - Add mcp tool call support. (#17364)

2026-04-11 04:39:19 +00:00

McpToolCallProgressNotification.json

…

ModelListParams.json

…

ModelListResponse.json

Use model metadata for Fast Mode status (#16949)

2026-04-07 17:55:40 -07:00

ModelReroutedNotification.json

…

PlanDeltaNotification.json

…

PluginInstallParams.json

feat: Add remote plugin fields to plugin API (#17277)

2026-04-17 16:47:58 -07:00

PluginInstallResponse.json

feat: expose needs_auth for plugin/read. (#15217)

2026-03-19 15:02:45 -07:00

PluginListParams.json

feat: Add remote plugin fields to plugin API (#17277)

2026-04-17 16:47:58 -07:00

PluginListResponse.json

feat: Add remote plugin fields to plugin API (#17277)

2026-04-17 16:47:58 -07:00

PluginReadParams.json

feat: Add remote plugin fields to plugin API (#17277)

2026-04-17 16:47:58 -07:00

PluginReadResponse.json

feat: Add remote plugin fields to plugin API (#17277)

2026-04-17 16:47:58 -07:00

PluginUninstallParams.json

feat: Add remote plugin fields to plugin API (#17277)

2026-04-17 16:47:58 -07:00

PluginUninstallResponse.json

chore: plugin/uninstall endpoint (#14111)

2026-03-09 12:40:25 -07:00

RawResponseItemCompletedNotification.json

Add notify to code-mode (#14842)

2026-03-18 09:37:13 -07:00

ReasoningSummaryPartAddedNotification.json

…

ReasoningSummaryTextDeltaNotification.json

…

ReasoningTextDeltaNotification.json

…

ReviewStartParams.json

…

ReviewStartResponse.json

[codex][mcp] Add resource uri meta to tool call item. (#17831)

2026-04-16 05:09:17 +00:00

SendAddCreditsNudgeEmailParams.json

[codex] Add owner nudge app-server API (#18220)

2026-04-17 21:41:57 -07:00

SendAddCreditsNudgeEmailResponse.json

[codex] Add owner nudge app-server API (#18220)

2026-04-17 21:41:57 -07:00

ServerRequestResolvedNotification.json

…

SkillsChangedNotification.json

…

SkillsConfigWriteParams.json

feat: support disable skills by name. (#15378)

2026-03-23 12:57:40 -07:00

SkillsConfigWriteResponse.json

…

SkillsListParams.json

…

SkillsListResponse.json

Spread AbsolutePathBuf (#17792)

2026-04-14 14:26:10 -07:00

TerminalInteractionNotification.json

…

ThreadArchivedNotification.json

…

ThreadArchiveParams.json

…

ThreadArchiveResponse.json

…

ThreadClosedNotification.json

…

ThreadCompactStartParams.json

…

ThreadCompactStartResponse.json

…

ThreadForkParams.json

Add Smart Approvals guardian review across core, app-server, and TUI (#13860)

2026-03-13 15:27:00 -07:00

ThreadForkResponse.json

[codex][mcp] Add resource uri meta to tool call item. (#17831)

2026-04-16 05:09:17 +00:00

ThreadInjectItemsParams.json

Add turn item injection API (#17703)

2026-04-13 16:11:05 -07:00

ThreadInjectItemsResponse.json

Add turn item injection API (#17703)

2026-04-13 16:11:05 -07:00

ThreadListParams.json

Add sorting/backwardsCursor to thread/list and new thread/turns/list api (#17305)

2026-04-17 11:49:02 -07:00

ThreadListResponse.json

Add sorting/backwardsCursor to thread/list and new thread/turns/list api (#17305)

2026-04-17 11:49:02 -07:00

ThreadLoadedListParams.json

…

ThreadLoadedListResponse.json

…

ThreadMetadataUpdateParams.json

…

ThreadMetadataUpdateResponse.json

[codex][mcp] Add resource uri meta to tool call item. (#17831)

2026-04-16 05:09:17 +00:00

ThreadNameUpdatedNotification.json

…

ThreadReadParams.json

…

ThreadReadResponse.json

[codex][mcp] Add resource uri meta to tool call item. (#17831)

2026-04-16 05:09:17 +00:00

ThreadRealtimeClosedNotification.json

…

ThreadRealtimeErrorNotification.json

…

ThreadRealtimeItemAddedNotification.json

…

ThreadRealtimeOutputAudioDeltaNotification.json

[stack 2/4] Align main realtime v2 wire and runtime flow (#14830)

2026-03-16 21:38:07 -07:00

ThreadRealtimeSdpNotification.json

Add WebRTC transport to realtime start (#16960)

2026-04-07 15:43:38 -07:00

ThreadRealtimeStartedNotification.json

Gate realtime audio interruption logic to v2 (#14984)

2026-03-17 15:24:37 -07:00

ThreadRealtimeTranscriptDeltaNotification.json

Add realtime output modality and transcript events (#17701)

2026-04-14 00:13:13 -07:00

ThreadRealtimeTranscriptDoneNotification.json

Add realtime output modality and transcript events (#17701)

2026-04-14 00:13:13 -07:00

ThreadResumeParams.json

Add notify to code-mode (#14842)

2026-03-18 09:37:13 -07:00

ThreadResumeResponse.json

[codex][mcp] Add resource uri meta to tool call item. (#17831)

2026-04-16 05:09:17 +00:00

ThreadRollbackParams.json

…

ThreadRollbackResponse.json

[codex][mcp] Add resource uri meta to tool call item. (#17831)

2026-04-16 05:09:17 +00:00

ThreadSetNameParams.json

…

ThreadSetNameResponse.json

…

ThreadShellCommandParams.json

Add thread/shellCommand to app server API surface (#14988)

2026-03-18 23:42:40 -06:00

ThreadShellCommandResponse.json

Add thread/shellCommand to app server API surface (#14988)

2026-03-18 23:42:40 -06:00

ThreadStartedNotification.json

[codex][mcp] Add resource uri meta to tool call item. (#17831)

2026-04-16 05:09:17 +00:00

ThreadStartParams.json

Support clear SessionStart source (#17073)

2026-04-10 16:05:21 -07:00

ThreadStartResponse.json

[codex][mcp] Add resource uri meta to tool call item. (#17831)

2026-04-16 05:09:17 +00:00

ThreadStatusChangedNotification.json

…

ThreadTokenUsageUpdatedNotification.json

…

ThreadTurnsListParams.json

Add sorting/backwardsCursor to thread/list and new thread/turns/list api (#17305)

2026-04-17 11:49:02 -07:00

ThreadTurnsListResponse.json

Add sorting/backwardsCursor to thread/list and new thread/turns/list api (#17305)

2026-04-17 11:49:02 -07:00

ThreadUnarchivedNotification.json

…

ThreadUnarchiveParams.json

…

ThreadUnarchiveResponse.json

[codex][mcp] Add resource uri meta to tool call item. (#17831)

2026-04-16 05:09:17 +00:00

ThreadUnsubscribeParams.json

…

ThreadUnsubscribeResponse.json

…

TurnCompletedNotification.json

[codex][mcp] Add resource uri meta to tool call item. (#17831)

2026-04-16 05:09:17 +00:00

TurnDiffUpdatedNotification.json

…

TurnInterruptParams.json

…

TurnInterruptResponse.json

…

TurnPlanUpdatedNotification.json

…

TurnStartedNotification.json

[codex][mcp] Add resource uri meta to tool call item. (#17831)

2026-04-16 05:09:17 +00:00

TurnStartParams.json

Add Smart Approvals guardian review across core, app-server, and TUI (#13860)

2026-03-13 15:27:00 -07:00

TurnStartResponse.json

[codex][mcp] Add resource uri meta to tool call item. (#17831)

2026-04-16 05:09:17 +00:00

TurnSteerParams.json

…

TurnSteerResponse.json

…

WarningNotification.json

feat: Budget skill metadata and surface trimming as a warning (#18298)

2026-04-17 18:11:47 -07:00

WindowsSandboxSetupCompletedNotification.json

…

WindowsSandboxSetupStartParams.json

app-server: include experimental skill metadata in exec approval requests (#13929)

2026-03-08 18:07:46 -07:00

WindowsSandboxSetupStartResponse.json

…

WindowsWorldWritableWarningNotification.json

…