Eric Traut 6c874f9b34 Add goal app-server API (2 / 5) (#18074) ...

Adds the app-server v2 goal API on top of the persisted goal state from
PR 1.

## Why

Clients need a stable app-server surface for reading and controlling
materialized thread goals before the model tools and TUI can use them.
Goal changes also need to be observable by app-server clients, including
clients that resume an existing thread.

## What changed

- Added v2 `thread/goal/get`, `thread/goal/set`, and `thread/goal/clear`
RPCs for materialized threads.
- Added `thread/goal/updated` and `thread/goal/cleared` notifications so
clients can keep local goal state in sync.
- Added resume/snapshot wiring so reconnecting clients see the current
goal state for a thread.
- Added app-server handlers that reconcile persisted rollout state
before direct goal mutations.
- Updated the app-server README plus generated JSON and TypeScript
schema fixtures for the new API surface.

## Verification

- Added app-server v2 coverage for goal get/set/clear behavior,
notification emission, resume snapshots, and non-local thread-store
interactions.

2026-04-24 20:53:41 -07:00

..

AccountLoginCompletedNotification.json

…

AccountRateLimitsUpdatedNotification.json

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

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

AccountUpdatedNotification.json

feat: add explicit AgentIdentity auth mode (#18785)

2026-04-21 22:33:24 -07:00

AgentMessageDeltaNotification.json

…

AppListUpdatedNotification.json

add @plugin mentions (#13510)

2026-03-06 00:03:39 +00:00

AppsListParams.json

[apps] Add thread_id param to optionally load thread config for apps feature check. (#11279)

2026-02-09 23:10:26 -08:00

AppsListResponse.json

add @plugin mentions (#13510)

2026-03-06 00:03:39 +00:00

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

permissions: remove legacy read-only access modes (#19449)

2026-04-24 17:16:58 -07: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

Rebrand approvals reviewer config to auto-review (#18504)

2026-04-22 15:45:35 -07:00

ConfigRequirementsReadResponse.json

codex: support hooks in config.toml and requirements.toml (#18893)

2026-04-22 21:20:09 -07:00

ConfigValueWriteParams.json

…

ConfigWarningNotification.json

…

ConfigWriteResponse.json

…

ContextCompactedNotification.json

…

DeprecationNoticeNotification.json

…

DeviceKeyCreateParams.json

app-server: define device key v2 protocol (#18428)

2026-04-21 10:08:42 -07:00

DeviceKeyCreateResponse.json

app-server: define device key v2 protocol (#18428)

2026-04-21 10:08:42 -07:00

DeviceKeyPublicParams.json

app-server: define device key v2 protocol (#18428)

2026-04-21 10:08:42 -07:00

DeviceKeyPublicResponse.json

app-server: define device key v2 protocol (#18428)

2026-04-21 10:08:42 -07:00

DeviceKeySignParams.json

app-server: define device key v2 protocol (#18428)

2026-04-21 10:08:42 -07:00

DeviceKeySignResponse.json

app-server: define device key v2 protocol (#18428)

2026-04-21 10:08:42 -07:00

ErrorNotification.json

Add safety check notification and error handling (#19055)

2026-04-22 22:24:12 -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

Support external agent config detect and import (#12660)

2026-02-25 02:11:51 -08:00

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

Support external agent config detect and import (#12660)

2026-02-25 02:11:51 -08:00

FeedbackUploadParams.json

Pass turn id with feedback uploads (#17314)

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

FeedbackUploadResponse.json

…

FileChangeOutputDeltaNotification.json

…

FileChangePatchUpdatedNotification.json

Wire the PatchUpdated events through app_server (#18289)

2026-04-20 10:44:03 -07:00

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

feat: expose AWS account state from account/read (#19048)

2026-04-24 01:53:13 +00:00

GuardianWarningNotification.json

feat(auto-review) short-circuit (#18890)

2026-04-22 20:34:15 +00: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

[tool search] support namespaced deferred dynamic tools (#18413)

2026-04-21 14:13:08 +08:00

ItemGuardianApprovalReviewCompletedNotification.json

app-server: include filesystem entries in permission requests (#19086)

2026-04-23 00:21:59 -07:00

ItemGuardianApprovalReviewStartedNotification.json

app-server: include filesystem entries in permission requests (#19086)

2026-04-23 00:21:59 -07:00

ItemStartedNotification.json

[tool search] support namespaced deferred dynamic tools (#18413)

2026-04-21 14:13:08 +08: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

MarketplaceRemoveParams.json

[codex] Add marketplace/remove app-server RPC (#17751)

2026-04-19 23:22:49 -07:00

MarketplaceRemoveResponse.json

[codex] Add marketplace/remove app-server RPC (#17751)

2026-04-19 23:22:49 -07:00

MarketplaceUpgradeParams.json

Add app-server marketplace upgrade RPC (#19074)

2026-04-23 13:00:46 -07:00

MarketplaceUpgradeResponse.json

Add app-server marketplace upgrade RPC (#19074)

2026-04-23 13:00:46 -07:00

McpResourceReadParams.json

Make MCP resource read threadless (#18292)

2026-04-20 19:59:36 -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

fix: send unfiltered models over model/list (#11793)

2026-02-13 16:26:32 -08:00

ModelListResponse.json

Use model metadata for Fast Mode status (#16949)

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

ModelReroutedNotification.json

Feat: add model reroute notification (#12001)

2026-02-17 11:02:23 -08:00

ModelVerificationNotification.json

Add safety check notification and error handling (#19055)

2026-04-22 22:24:12 -07:00

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: Support remote plugin list/read. (#18452)

2026-04-21 18:39:07 -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

Update image outputs to default to high detail (#18386)

2026-04-18 11:01:12 -07:00

ReasoningSummaryPartAddedNotification.json

…

ReasoningSummaryTextDeltaNotification.json

…

ReasoningTextDeltaNotification.json

…

ReviewStartParams.json

…

ReviewStartResponse.json

Add safety check notification and error handling (#19055)

2026-04-22 22:24:12 -07: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

app-server: Replay pending item requests on thread/resume (#12560)

2026-02-27 12:45:59 -08:00

SkillsChangedNotification.json

feat(app-server): add a skills/changed v2 notification (#13414)

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

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

…

ThreadApproveGuardianDeniedActionParams.json

Add plumbing to approve stored Auto-Review denials (#18955)

2026-04-22 10:38:19 -07:00

ThreadApproveGuardianDeniedActionResponse.json

Add plumbing to approve stored Auto-Review denials (#18955)

2026-04-22 10:38:19 -07:00

ThreadArchivedNotification.json

app-server: Emit thread archive/unarchive notifications (#12030)

2026-02-17 14:53:58 -08:00

ThreadArchiveParams.json

…

ThreadArchiveResponse.json

…

ThreadClosedNotification.json

feat(app-server): thread/unsubscribe API (#10954)

2026-02-25 13:14:30 -08:00

ThreadCompactStartParams.json

…

ThreadCompactStartResponse.json

…

ThreadForkParams.json

permissions: make profiles represent enforcement (#19231)

2026-04-23 23:02:18 -07:00

ThreadForkResponse.json

permissions: remove legacy read-only access modes (#19449)

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

ThreadGoalClearedNotification.json

Add goal app-server API (2 / 5) (#18074)

2026-04-24 20:53:41 -07:00

ThreadGoalUpdatedNotification.json

Add goal app-server API (2 / 5) (#18074)

2026-04-24 20:53:41 -07: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

Support multiple cwd filters for thread list (#18502)

2026-04-22 06:10:09 -04:00

ThreadListResponse.json

Add safety check notification and error handling (#19055)

2026-04-22 22:24:12 -07:00

ThreadLoadedListParams.json

…

ThreadLoadedListResponse.json

…

ThreadMetadataUpdateParams.json

Add thread metadata update endpoint to app server (#13280)

2026-03-03 15:56:11 -08:00

ThreadMetadataUpdateResponse.json

Add safety check notification and error handling (#19055)

2026-04-22 22:24:12 -07:00

ThreadNameUpdatedNotification.json

…

ThreadReadParams.json

…

ThreadReadResponse.json

Add safety check notification and error handling (#19055)

2026-04-22 22:24:12 -07:00

ThreadRealtimeClosedNotification.json

Add app-server v2 thread realtime API (#12715)

2026-02-25 09:59:10 -08:00

ThreadRealtimeErrorNotification.json

Add app-server v2 thread realtime API (#12715)

2026-02-25 09:59:10 -08:00

ThreadRealtimeItemAddedNotification.json

Add app-server v2 thread realtime API (#12715)

2026-02-25 09:59:10 -08:00

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

permissions: make profiles represent enforcement (#19231)

2026-04-23 23:02:18 -07:00

ThreadResumeResponse.json

permissions: remove legacy read-only access modes (#19449)

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

ThreadRollbackParams.json

…

ThreadRollbackResponse.json

Add safety check notification and error handling (#19055)

2026-04-22 22:24:12 -07: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

Add safety check notification and error handling (#19055)

2026-04-22 22:24:12 -07:00

ThreadStartParams.json

permissions: make profiles represent enforcement (#19231)

2026-04-23 23:02:18 -07:00

ThreadStartResponse.json

permissions: remove legacy read-only access modes (#19449)

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

ThreadStatusChangedNotification.json

app-server: expose loaded thread status via read/list and notifications (#11786)

2026-02-18 15:20:03 -08:00

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 safety check notification and error handling (#19055)

2026-04-22 22:24:12 -07:00

ThreadUnarchivedNotification.json

app-server: Emit thread archive/unarchive notifications (#12030)

2026-02-17 14:53:58 -08:00

ThreadUnarchiveParams.json

…

ThreadUnarchiveResponse.json

Add safety check notification and error handling (#19055)

2026-04-22 22:24:12 -07:00

ThreadUnsubscribeParams.json

feat(app-server): thread/unsubscribe API (#10954)

2026-02-25 13:14:30 -08:00

ThreadUnsubscribeResponse.json

feat(app-server): thread/unsubscribe API (#10954)

2026-02-25 13:14:30 -08:00

TurnCompletedNotification.json

Add safety check notification and error handling (#19055)

2026-04-22 22:24:12 -07:00

TurnDiffUpdatedNotification.json

…

TurnInterruptParams.json

…

TurnInterruptResponse.json

…

TurnPlanUpdatedNotification.json

…

TurnStartedNotification.json

Add safety check notification and error handling (#19055)

2026-04-22 22:24:12 -07:00

TurnStartParams.json

permissions: remove legacy read-only access modes (#19449)

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

TurnStartResponse.json

Add safety check notification and error handling (#19055)

2026-04-22 22:24:12 -07: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

app-server support for Windows sandbox setup. (#12025)

2026-02-18 13:03:16 -08:00

WindowsSandboxSetupStartParams.json

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

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

WindowsSandboxSetupStartResponse.json

app-server support for Windows sandbox setup. (#12025)

2026-02-18 13:03:16 -08:00

WindowsWorldWritableWarningNotification.json

…