Lightweight coding agent that runs in your terminal
Rust
Notify subscribers when thread read state changes (#52384)
Brent Traut82883da25e3b
diff --git a/codex-rs/app-server-protocol/schema/json/ServerNotification.json b/codex-rs/app-server-protocol/schema/json/ServerNotification.jsonindex 51707eddfd..ed40f2f769 100644--- a/codex-rs/app-server-protocol/schema/json/ServerNotification.json+++ b/codex-rs/app-server-protocol/schema/json/ServerNotification.json@@ -5602,6 +5602,43 @@],"type": "object"},+ "ThreadReadState": {+ "description": "The first unread position in a durable local thread. A null position means read. The opaque revision guards edits against activity or marks the caller has not seen.",+ "properties": {+ "firstUnread": {+ "anyOf": [+ {+ "$ref": "#/definitions/ThreadUnreadPosition"+ },+ {+ "type": "null"+ }+ ]+ },+ "revision": {+ "type": "string"+ }+ },+ "required": [+ "revision"+ ],+ "type": "object"+ },+ "ThreadReadStateChangedNotification": {+ "properties": {+ "readState": {+ "$ref": "#/definitions/ThreadReadState"+ },+ "threadId": {+ "type": "string"+ }+ },+ "required": [+ "readState",+ "threadId"+ ],+ "type": "object"+ },"ThreadRealtimeAudioChunk": {"description": "EXPERIMENTAL - thread realtime audio chunk.","properties": {@@ -6335,6 +6372,48 @@],"type": "object"},+ "ThreadUnreadPosition": {+ "oneOf": [+ {+ "description": "Explicitly marked unread, including when the thread has no turns.",+ "properties": {+ "type": {+ "enum": [+ "threadStart"+ ],+ "title": "ThreadStartThreadUnreadPositionType",+ "type": "string"+ }+ },+ "required": [+ "type"+ ],+ "title": "ThreadStartThreadUnreadPosition",+ "type": "object"+ },+ {+ "description": "The earliest completed result needing attention.",+ "properties": {+ "turnId": {+ "type": "string"+ },+ "type": {+ "enum": [+ "turn"+ ],+ "title": "TurnThreadUnreadPositionType",+ "type": "string"+ }+ },+ "required": [+ "turnId",+ "type"+ ],+ "title": "TurnThreadUnreadPosition",+ "type": "object"+ }+ ]+ },"TokenUsageBreakdown": {"properties": {"cacheWriteInputTokens": {@@ -7079,6 +7158,26 @@"title": "Thread/status/changedNotification","type": "object"},+ {+ "properties": {+ "method": {+ "enum": [+ "thread/readState/changed"+ ],+ "title": "Thread/readState/changedNotificationMethod",+ "type": "string"+ },+ "params": {+ "$ref": "#/definitions/ThreadReadStateChangedNotification"+ }+ },+ "required": [+ "method",+ "params"+ ],+ "title": "Thread/readState/changedNotification",+ "type": "object"+ },{"properties": {"method": {diff --git a/codex-rs/app-server-protocol/schema/json/codex_app_server_protocol.schemas.json b/codex-rs/app-server-protocol/schema/json/codex_app_server_protocol.schemas.jsonindex 8422227abe..3a91f47408 100644--- a/codex-rs/app-server-protocol/schema/json/codex_app_server_protocol.schemas.json+++ b/codex-rs/app-server-protocol/schema/json/codex_app_server_protocol.schemas.json@@ -4683,6 +4683,26 @@"title": "Thread/status/changedNotification","type": "object"},+ {+ "properties": {+ "method": {+ "enum": [+ "thread/readState/changed"+ ],+ "title": "Thread/readState/changedNotificationMethod",+ "type": "string"+ },+ "params": {+ "$ref": "#/definitions/v2/ThreadReadStateChangedNotification"+ }+ },+ "required": [+ "method",+ "params"+ ],+ "title": "Thread/readState/changedNotification",+ "type": "object"+ },{"properties": {"method": {@@ -23480,6 +23500,23 @@],"type": "object"},+ "ThreadReadStateChangedNotification": {+ "$schema": "http://json-schema.org/draft-07/schema#",+ "properties": {+ "readState": {+ "$ref": "#/definitions/v2/ThreadReadState"+ },+ "threadId": {+ "type": "string"+ }+ },+ "required": [+ "readState",+ "threadId"+ ],+ "title": "ThreadReadStateChangedNotification",+ "type": "object"+ },"ThreadRealtimeAudioChunk": {"description": "EXPERIMENTAL - thread realtime audio chunk.","properties": {diff --git a/codex-rs/app-server-protocol/schema/json/codex_app_server_protocol.v2.schemas.json b/codex-rs/app-server-protocol/schema/json/codex_app_server_protocol.v2.schemas.jsonindex d6e977f5fc..8147a4ed26 100644--- a/codex-rs/app-server-protocol/schema/json/codex_app_server_protocol.v2.schemas.json+++ b/codex-rs/app-server-protocol/schema/json/codex_app_server_protocol.v2.schemas.json@@ -16257,6 +16257,26 @@"title": "Thread/status/changedNotification","type": "object"},+ {+ "properties": {+ "method": {+ "enum": [+ "thread/readState/changed"+ ],+ "title": "Thread/readState/changedNotificationMethod",+ "type": "string"+ },+ "params": {+ "$ref": "#/definitions/ThreadReadStateChangedNotification"+ }+ },+ "required": [+ "method",+ "params"+ ],+ "title": "Thread/readState/changedNotification",+ "type": "object"+ },{"properties": {"method": {@@ -21194,6 +21214,23 @@],"type": "object"},+ "ThreadReadStateChangedNotification": {+ "$schema": "http://json-schema.org/draft-07/schema#",+ "properties": {+ "readState": {+ "$ref": "#/definitions/ThreadReadState"+ },+ "threadId": {+ "type": "string"+ }+ },+ "required": [+ "readState",+ "threadId"+ ],+ "title": "ThreadReadStateChangedNotification",+ "type": "object"+ },"ThreadRealtimeAudioChunk": {"description": "EXPERIMENTAL - thread realtime audio chunk.","properties": {diff --git a/codex-rs/app-server-protocol/schema/json/v2/ThreadReadStateChangedNotification.json b/codex-rs/app-server-protocol/schema/json/v2/ThreadReadStateChangedNotification.jsonnew file mode 100644index 0000000000..86ceedef1f--- /dev/null+++ b/codex-rs/app-server-protocol/schema/json/v2/ThreadReadStateChangedNotification.json@@ -0,0 +1,83 @@+{+ "$schema": "http://json-schema.org/draft-07/schema#",+ "definitions": {+ "ThreadReadState": {+ "description": "The first unread position in a durable local thread. A null position means read. The opaque revision guards edits against activity or marks the caller has not seen.",+ "properties": {+ "firstUnread": {+ "anyOf": [+ {+ "$ref": "#/definitions/ThreadUnreadPosition"+ },+ {+ "type": "null"+ }+ ]+ },+ "revision": {+ "type": "string"+ }+ },+ "required": [+ "revision"+ ],+ "type": "object"+ },+ "ThreadUnreadPosition": {+ "oneOf": [+ {+ "description": "Explicitly marked unread, including when the thread has no turns.",+ "properties": {+ "type": {+ "enum": [+ "threadStart"+ ],+ "title": "ThreadStartThreadUnreadPositionType",+ "type": "string"+ }+ },+ "required": [+ "type"+ ],+ "title": "ThreadStartThreadUnreadPosition",+ "type": "object"+ },+ {+ "description": "The earliest completed result needing attention.",+ "properties": {+ "turnId": {+ "type": "string"+ },+ "type": {+ "enum": [+ "turn"+ ],+ "title": "TurnThreadUnreadPositionType",+ "type": "string"+ }+ },+ "required": [+ "turnId",+ "type"+ ],+ "title": "TurnThreadUnreadPosition",+ "type": "object"+ }+ ]+ }+ },+ "properties": {+ "readState": {+ "$ref": "#/definitions/ThreadReadState"+ },+ "threadId": {+ "type": "string"+ }+ },+ "required": [+ "readState",+ "threadId"+ ],+ "title": "ThreadReadStateChangedNotification",+ "type": "object"+}\ No newline at end of filediff --git a/codex-rs/app-server-protocol/schema/precomputed/app-server-exports-experimental.json.zst b/codex-rs/app-server-protocol/schema/precomputed/app-server-exports-experimental.json.zstindex 51a9f56341..71f272c2f6 100644Binary files a/codex-rs/app-server-protocol/schema/precomputed/app-server-exports-experimental.json.zst and b/codex-rs/app-server-protocol/schema/precomputed/app-server-exports-experimental.json.zst differdiff --git a/codex-rs/app-server-protocol/schema/precomputed/app-server-exports-stable.json.zst b/codex-rs/app-server-protocol/schema/precomputed/app-server-exports-stable.json.zstindex 5019d2ffad..6bdbd16795 100644Binary files a/codex-rs/app-server-protocol/schema/precomputed/app-server-exports-stable.json.zst and b/codex-rs/app-server-protocol/schema/precomputed/app-server-exports-stable.json.zst differdiff --git a/codex-rs/app-server-protocol/schema/typescript/ServerNotification.ts b/codex-rs/app-server-protocol/schema/typescript/ServerNotification.tsindex 50cc33acf3..4af7a4307a 100644--- a/codex-rs/app-server-protocol/schema/typescript/ServerNotification.ts+++ b/codex-rs/app-server-protocol/schema/typescript/ServerNotification.ts@@ -60,6 +60,7 @@ import type { ThreadNameUpdatedNotification } from "./v2/ThreadNameUpdatedNotifiimport type { ThreadPredictionUpdatedNotification } from "./v2/ThreadPredictionUpdatedNotification";import type { ThreadProjectUpdatedNotification } from "./v2/ThreadProjectUpdatedNotification";import type { ThreadQueueChangedNotification } from "./v2/ThreadQueueChangedNotification";+import type { ThreadReadStateChangedNotification } from "./v2/ThreadReadStateChangedNotification";import type { ThreadRealtimeClosedNotification } from "./v2/ThreadRealtimeClosedNotification";import type { ThreadRealtimeErrorNotification } from "./v2/ThreadRealtimeErrorNotification";import type { ThreadRealtimeItemAddedNotification } from "./v2/ThreadRealtimeItemAddedNotification";@@ -89,4 +90,4 @@ import type { WindowsWorldWritableWarningNotification } from "./v2/WindowsWorldW/*** Notification sent from the server to the client.*/-export type ServerNotification = { "method": "error", "params": ErrorNotification } | { "method": "thread/started", "params": ThreadStartedNotification } | { "method": "thread/status/changed", "params": ThreadStatusChangedNotification } | { "method": "thread/archived", "params": ThreadArchivedNotification } | { "method": "thread/deleted", "params": ThreadDeletedNotification } | { "method": "thread/unarchived", "params": ThreadUnarchivedNotification } | { "method": "thread/closed", "params": ThreadClosedNotification } | { "method": "thread/reverted", "params": ThreadRevertedNotification } | { "method": "skills/changed", "params": SkillsChangedNotification } | { "method": "thread/name/updated", "params": ThreadNameUpdatedNotification } | { "method": "thread/attachment/updated", "params": ThreadAttachmentUpdatedNotification } | { "method": "thread/goal/updated", "params": ThreadGoalUpdatedNotification } | { "method": "thread/prediction/updated", "params": ThreadPredictionUpdatedNotification } | { "method": "thread/goal/cleared", "params": ThreadGoalClearedNotification } | { "method": "thread/queue/changed", "params": ThreadQueueChangedNotification } | { "method": "project/changed", "params": ProjectChangedNotification } | { "method": "thread/project/updated", "params": ThreadProjectUpdatedNotification } | { "method": "thread/environment/connected", "params": EnvironmentConnectionNotification } | { "method": "thread/environment/disconnected", "params": EnvironmentConnectionNotification } | { "method": "thread/settings/updated", "params": ThreadSettingsUpdatedNotification } | { "method": "thread/tokenUsage/updated", "params": ThreadTokenUsageUpdatedNotification } | { "method": "turn/started", "params": TurnStartedNotification } | { "method": "hook/started", "params": HookStartedNotification } | { "method": "turn/completed", "params": TurnCompletedNotification } | { "method": "hook/completed", "params": HookCompletedNotification } | { "method": "turn/diff/updated", "params": TurnDiffUpdatedNotification } | { "method": "turn/plan/updated", "params": TurnPlanUpdatedNotification } | { "method": "item/started", "params": ItemStartedNotification } | { "method": "item/autoApprovalReview/started", "params": ItemGuardianApprovalReviewStartedNotification } | { "method": "item/autoApprovalReview/completed", "params": ItemGuardianApprovalReviewCompletedNotification } | { "method": "autoApprovalReview/strictReviewRequired", "params": StrictReviewRequiredNotification } | { "method": "item/completed", "params": ItemCompletedNotification } | { "method": "rawResponseItem/completed", "params": RawResponseItemCompletedNotification } | { "method": "rawResponse/completed", "params": RawResponseCompletedNotification } | { "method": "item/agentMessage/delta", "params": AgentMessageDeltaNotification } | { "method": "item/plan/delta", "params": PlanDeltaNotification } | { "method": "command/exec/outputDelta", "params": CommandExecOutputDeltaNotification } | { "method": "process/outputDelta", "params": ProcessOutputDeltaNotification } | { "method": "process/exited", "params": ProcessExitedNotification } | { "method": "item/commandExecution/outputDelta", "params": CommandExecutionOutputDeltaNotification } | { "method": "item/commandExecution/terminalInteraction", "params": TerminalInteractionNotification } | { "method": "item/fileChange/outputDelta", "params": FileChangeOutputDeltaNotification } | { "method": "item/fileChange/patchUpdated", "params": FileChangePatchUpdatedNotification } | { "method": "serverRequest/resolved", "params": ServerRequestResolvedNotification } | { "method": "item/mcpToolCall/progress", "params": McpToolCallProgressNotification } | { "method": "mcpServer/oauthLogin/completed", "params": McpServerOauthLoginCompletedNotification } | { "method": "mcpServer/startupStatus/updated", "params": McpServerStatusUpdatedNotification } | { "method": "mcpServer/event/stream/notification", "params": McpServerEventStreamNotification } | { "method": "account/updated", "params": AccountUpdatedNotification } | { "method": "account/gatewayOAuth/changed", "params": GatewayOAuthChangedNotification } | { "method": "account/rateLimits/updated", "params": AccountRateLimitsUpdatedNotification } | { "method": "app/list/updated", "params": AppListUpdatedNotification } | { "method": "remoteControl/status/changed", "params": RemoteControlStatusChangedNotification } | { "method": "externalAgentConfig/import/progress", "params": ExternalAgentConfigImportProgressNotification } | { "method": "externalAgentConfig/import/completed", "params": ExternalAgentConfigImportCompletedNotification } | { "method": "fs/changed", "params": FsChangedNotification } | { "method": "item/reasoning/summaryTextDelta", "params": ReasoningSummaryTextDeltaNotification } | { "method": "item/reasoning/summaryPartAdded", "params": ReasoningSummaryPartAddedNotification } | { "method": "item/reasoning/textDelta", "params": ReasoningTextDeltaNotification } | { "method": "thread/compacted", "params": ContextCompactedNotification } | { "method": "model/rerouted", "params": ModelReroutedNotification } | { "method": "model/verification", "params": ModelVerificationNotification } | { "method": "modelProvider/authRecoveryStarted", "params": AuthRecoveryNotification } | { "method": "modelProvider/authRecoveryCompleted", "params": AuthRecoveryNotification } | { "method": "turn/moderationMetadata", "params": TurnModerationMetadataNotification } | { "method": "model/safetyBuffering/updated", "params": ModelSafetyBufferingUpdatedNotification } | { "method": "warning", "params": WarningNotification } | { "method": "guardianWarning", "params": GuardianWarningNotification } | { "method": "deprecationNotice", "params": DeprecationNoticeNotification } | { "method": "configWarning", "params": ConfigWarningNotification } | { "method": "fuzzyFileSearch/sessionUpdated", "params": FuzzyFileSearchSessionUpdatedNotification } | { "method": "fuzzyFileSearch/sessionCompleted", "params": FuzzyFileSearchSessionCompletedNotification } | { "method": "thread/realtime/started", "params": ThreadRealtimeStartedNotification } | { "method": "thread/realtime/itemAdded", "params": ThreadRealtimeItemAddedNotification } | { "method": "thread/realtime/item/started", "params": ThreadRealtimeItemStartedNotification } | { "method": "thread/realtime/item/transcript/delta", "params": ThreadRealtimeItemTranscriptDeltaNotification } | { "method": "thread/realtime/item/completed", "params": ThreadRealtimeItemCompletedNotification } | { "method": "thread/realtime/transcript/delta", "params": ThreadRealtimeTranscriptDeltaNotification } | { "method": "thread/realtime/transcript/done", "params": ThreadRealtimeTranscriptDoneNotification } | { "method": "thread/realtime/outputAudio/delta", "params": ThreadRealtimeOutputAudioDeltaNotification } | { "method": "thread/realtime/sdp", "params": ThreadRealtimeSdpNotification } | { "method": "thread/realtime/error", "params": ThreadRealtimeErrorNotification } | { "method": "thread/realtime/closed", "params": ThreadRealtimeClosedNotification } | { "method": "windows/worldWritableWarning", "params": WindowsWorldWritableWarningNotification } | { "method": "windowsSandbox/setupCompleted", "params": WindowsSandboxSetupCompletedNotification } | { "method": "account/login/completed", "params": AccountLoginCompletedNotification };+export type ServerNotification = { "method": "error", "params": ErrorNotification } | { "method": "thread/started", "params": ThreadStartedNotification } | { "method": "thread/status/changed", "params": ThreadStatusChangedNotification } | { "method": "thread/readState/changed", "params": ThreadReadStateChangedNotification } | { "method": "thread/archived", "params": ThreadArchivedNotification } | { "method": "thread/deleted", "params": ThreadDeletedNotification } | { "method": "thread/unarchived", "params": ThreadUnarchivedNotification } | { "method": "thread/closed", "params": ThreadClosedNotification } | { "method": "thread/reverted", "params": ThreadRevertedNotification } | { "method": "skills/changed", "params": SkillsChangedNotification } | { "method": "thread/name/updated", "params": ThreadNameUpdatedNotification } | { "method": "thread/attachment/updated", "params": ThreadAttachmentUpdatedNotification } | { "method": "thread/goal/updated", "params": ThreadGoalUpdatedNotification } | { "method": "thread/prediction/updated", "params": ThreadPredictionUpdatedNotification } | { "method": "thread/goal/cleared", "params": ThreadGoalClearedNotification } | { "method": "thread/queue/changed", "params": ThreadQueueChangedNotification } | { "method": "project/changed", "params": ProjectChangedNotification } | { "method": "thread/project/updated", "params": ThreadProjectUpdatedNotification } | { "method": "thread/environment/connected", "params": EnvironmentConnectionNotification } | { "method": "thread/environment/disconnected", "params": EnvironmentConnectionNotification } | { "method": "thread/settings/updated", "params": ThreadSettingsUpdatedNotification } | { "method": "thread/tokenUsage/updated", "params": ThreadTokenUsageUpdatedNotification } | { "method": "turn/started", "params": TurnStartedNotification } | { "method": "hook/started", "params": HookStartedNotification } | { "method": "turn/completed", "params": TurnCompletedNotification } | { "method": "hook/completed", "params": HookCompletedNotification } | { "method": "turn/diff/updated", "params": TurnDiffUpdatedNotification } | { "method": "turn/plan/updated", "params": TurnPlanUpdatedNotification } | { "method": "item/started", "params": ItemStartedNotification } | { "method": "item/autoApprovalReview/started", "params": ItemGuardianApprovalReviewStartedNotification } | { "method": "item/autoApprovalReview/completed", "params": ItemGuardianApprovalReviewCompletedNotification } | { "method": "autoApprovalReview/strictReviewRequired", "params": StrictReviewRequiredNotification } | { "method": "item/completed", "params": ItemCompletedNotification } | { "method": "rawResponseItem/completed", "params": RawResponseItemCompletedNotification } | { "method": "rawResponse/completed", "params": RawResponseCompletedNotification } | { "method": "item/agentMessage/delta", "params": AgentMessageDeltaNotification } | { "method": "item/plan/delta", "params": PlanDeltaNotification } | { "method": "command/exec/outputDelta", "params": CommandExecOutputDeltaNotification } | { "method": "process/outputDelta", "params": ProcessOutputDeltaNotification } | { "method": "process/exited", "params": ProcessExitedNotification } | { "method": "item/commandExecution/outputDelta", "params": CommandExecutionOutputDeltaNotification } | { "method": "item/commandExecution/terminalInteraction", "params": TerminalInteractionNotification } | { "method": "item/fileChange/outputDelta", "params": FileChangeOutputDeltaNotification } | { "method": "item/fileChange/patchUpdated", "params": FileChangePatchUpdatedNotification } | { "method": "serverRequest/resolved", "params": ServerRequestResolvedNotification } | { "method": "item/mcpToolCall/progress", "params": McpToolCallProgressNotification } | { "method": "mcpServer/oauthLogin/completed", "params": McpServerOauthLoginCompletedNotification } | { "method": "mcpServer/startupStatus/updated", "params": McpServerStatusUpdatedNotification } | { "method": "mcpServer/event/stream/notification", "params": McpServerEventStreamNotification } | { "method": "account/updated", "params": AccountUpdatedNotification } | { "method": "account/gatewayOAuth/changed", "params": GatewayOAuthChangedNotification } | { "method": "account/rateLimits/updated", "params": AccountRateLimitsUpdatedNotification } | { "method": "app/list/updated", "params": AppListUpdatedNotification } | { "method": "remoteControl/status/changed", "params": RemoteControlStatusChangedNotification } | { "method": "externalAgentConfig/import/progress", "params": ExternalAgentConfigImportProgressNotification } | { "method": "externalAgentConfig/import/completed", "params": ExternalAgentConfigImportCompletedNotification } | { "method": "fs/changed", "params": FsChangedNotification } | { "method": "item/reasoning/summaryTextDelta", "params": ReasoningSummaryTextDeltaNotification } | { "method": "item/reasoning/summaryPartAdded", "params": ReasoningSummaryPartAddedNotification } | { "method": "item/reasoning/textDelta", "params": ReasoningTextDeltaNotification } | { "method": "thread/compacted", "params": ContextCompactedNotification } | { "method": "model/rerouted", "params": ModelReroutedNotification } | { "method": "model/verification", "params": ModelVerificationNotification } | { "method": "modelProvider/authRecoveryStarted", "params": AuthRecoveryNotification } | { "method": "modelProvider/authRecoveryCompleted", "params": AuthRecoveryNotification } | { "method": "turn/moderationMetadata", "params": TurnModerationMetadataNotification } | { "method": "model/safetyBuffering/updated", "params": ModelSafetyBufferingUpdatedNotification } | { "method": "warning", "params": WarningNotification } | { "method": "guardianWarning", "params": GuardianWarningNotification } | { "method": "deprecationNotice", "params": DeprecationNoticeNotification } | { "method": "configWarning", "params": ConfigWarningNotification } | { "method": "fuzzyFileSearch/sessionUpdated", "params": FuzzyFileSearchSessionUpdatedNotification } | { "method": "fuzzyFileSearch/sessionCompleted", "params": FuzzyFileSearchSessionCompletedNotification } | { "method": "thread/realtime/started", "params": ThreadRealtimeStartedNotification } | { "method": "thread/realtime/itemAdded", "params": ThreadRealtimeItemAddedNotification } | { "method": "thread/realtime/item/started", "params": ThreadRealtimeItemStartedNotification } | { "method": "thread/realtime/item/transcript/delta", "params": ThreadRealtimeItemTranscriptDeltaNotification } | { "method": "thread/realtime/item/completed", "params": ThreadRealtimeItemCompletedNotification } | { "method": "thread/realtime/transcript/delta", "params": ThreadRealtimeTranscriptDeltaNotification } | { "method": "thread/realtime/transcript/done", "params": ThreadRealtimeTranscriptDoneNotification } | { "method": "thread/realtime/outputAudio/delta", "params": ThreadRealtimeOutputAudioDeltaNotification } | { "method": "thread/realtime/sdp", "params": ThreadRealtimeSdpNotification } | { "method": "thread/realtime/error", "params": ThreadRealtimeErrorNotification } | { "method": "thread/realtime/closed", "params": ThreadRealtimeClosedNotification } | { "method": "windows/worldWritableWarning", "params": WindowsWorldWritableWarningNotification } | { "method": "windowsSandbox/setupCompleted", "params": WindowsSandboxSetupCompletedNotification } | { "method": "account/login/completed", "params": AccountLoginCompletedNotification };diff --git a/codex-rs/app-server-protocol/schema/typescript/ServerNotificationEnvelope.ts b/codex-rs/app-server-protocol/schema/typescript/ServerNotificationEnvelope.tsindex f3c6d2c2e6..a5b07d304d 100644--- a/codex-rs/app-server-protocol/schema/typescript/ServerNotificationEnvelope.ts+++ b/codex-rs/app-server-protocol/schema/typescript/ServerNotificationEnvelope.ts@@ -60,6 +60,7 @@ import type { ThreadNameUpdatedNotification } from "./v2/ThreadNameUpdatedNotifiimport type { ThreadPredictionUpdatedNotification } from "./v2/ThreadPredictionUpdatedNotification";import type { ThreadProjectUpdatedNotification } from "./v2/ThreadProjectUpdatedNotification";import type { ThreadQueueChangedNotification } from "./v2/ThreadQueueChangedNotification";+import type { ThreadReadStateChangedNotification } from "./v2/ThreadReadStateChangedNotification";import type { ThreadRealtimeClosedNotification } from "./v2/ThreadRealtimeClosedNotification";import type { ThreadRealtimeErrorNotification } from "./v2/ThreadRealtimeErrorNotification";import type { ThreadRealtimeItemAddedNotification } from "./v2/ThreadRealtimeItemAddedNotification";@@ -99,4 +100,4 @@ export type ServerNotificationEnvelope = {* Optional so clients can decode notifications from older app-server* versions. Current app-server versions always populate it.*/-emittedAtMs?: number, } & ({ "method": "error", "params": ErrorNotification } | { "method": "thread/started", "params": ThreadStartedNotification } | { "method": "thread/status/changed", "params": ThreadStatusChangedNotification } | { "method": "thread/archived", "params": ThreadArchivedNotification } | { "method": "thread/deleted", "params": ThreadDeletedNotification } | { "method": "thread/unarchived", "params": ThreadUnarchivedNotification } | { "method": "thread/closed", "params": ThreadClosedNotification } | { "method": "thread/reverted", "params": ThreadRevertedNotification } | { "method": "skills/changed", "params": SkillsChangedNotification } | { "method": "thread/name/updated", "params": ThreadNameUpdatedNotification } | { "method": "thread/attachment/updated", "params": ThreadAttachmentUpdatedNotification } | { "method": "thread/goal/updated", "params": ThreadGoalUpdatedNotification } | { "method": "thread/prediction/updated", "params": ThreadPredictionUpdatedNotification } | { "method": "thread/goal/cleared", "params": ThreadGoalClearedNotification } | { "method": "thread/queue/changed", "params": ThreadQueueChangedNotification } | { "method": "project/changed", "params": ProjectChangedNotification } | { "method": "thread/project/updated", "params": ThreadProjectUpdatedNotification } | { "method": "thread/environment/connected", "params": EnvironmentConnectionNotification } | { "method": "thread/environment/disconnected", "params": EnvironmentConnectionNotification } | { "method": "thread/settings/updated", "params": ThreadSettingsUpdatedNotification } | { "method": "thread/tokenUsage/updated", "params": ThreadTokenUsageUpdatedNotification } | { "method": "turn/started", "params": TurnStartedNotification } | { "method": "hook/started", "params": HookStartedNotification } | { "method": "turn/completed", "params": TurnCompletedNotification } | { "method": "hook/completed", "params": HookCompletedNotification } | { "method": "turn/diff/updated", "params": TurnDiffUpdatedNotification } | { "method": "turn/plan/updated", "params": TurnPlanUpdatedNotification } | { "method": "item/started", "params": ItemStartedNotification } | { "method": "item/autoApprovalReview/started", "params": ItemGuardianApprovalReviewStartedNotification } | { "method": "item/autoApprovalReview/completed", "params": ItemGuardianApprovalReviewCompletedNotification } | { "method": "autoApprovalReview/strictReviewRequired", "params": StrictReviewRequiredNotification } | { "method": "item/completed", "params": ItemCompletedNotification } | { "method": "rawResponseItem/completed", "params": RawResponseItemCompletedNotification } | { "method": "rawResponse/completed", "params": RawResponseCompletedNotification } | { "method": "item/agentMessage/delta", "params": AgentMessageDeltaNotification } | { "method": "item/plan/delta", "params": PlanDeltaNotification } | { "method": "command/exec/outputDelta", "params": CommandExecOutputDeltaNotification } | { "method": "process/outputDelta", "params": ProcessOutputDeltaNotification } | { "method": "process/exited", "params": ProcessExitedNotification } | { "method": "item/commandExecution/outputDelta", "params": CommandExecutionOutputDeltaNotification } | { "method": "item/commandExecution/terminalInteraction", "params": TerminalInteractionNotification } | { "method": "item/fileChange/outputDelta", "params": FileChangeOutputDeltaNotification } | { "method": "item/fileChange/patchUpdated", "params": FileChangePatchUpdatedNotification } | { "method": "serverRequest/resolved", "params": ServerRequestResolvedNotification } | { "method": "item/mcpToolCall/progress", "params": McpToolCallProgressNotification } | { "method": "mcpServer/oauthLogin/completed", "params": McpServerOauthLoginCompletedNotification } | { "method": "mcpServer/startupStatus/updated", "params": McpServerStatusUpdatedNotification } | { "method": "mcpServer/event/stream/notification", "params": McpServerEventStreamNotification } | { "method": "account/updated", "params": AccountUpdatedNotification } | { "method": "account/gatewayOAuth/changed", "params": GatewayOAuthChangedNotification } | { "method": "account/rateLimits/updated", "params": AccountRateLimitsUpdatedNotification } | { "method": "app/list/updated", "params": AppListUpdatedNotification } | { "method": "remoteControl/status/changed", "params": RemoteControlStatusChangedNotification } | { "method": "externalAgentConfig/import/progress", "params": ExternalAgentConfigImportProgressNotification } | { "method": "externalAgentConfig/import/completed", "params": ExternalAgentConfigImportCompletedNotification } | { "method": "fs/changed", "params": FsChangedNotification } | { "method": "item/reasoning/summaryTextDelta", "params": ReasoningSummaryTextDeltaNotification } | { "method": "item/reasoning/summaryPartAdded", "params": ReasoningSummaryPartAddedNotification } | { "method": "item/reasoning/textDelta", "params": ReasoningTextDeltaNotification } | { "method": "thread/compacted", "params": ContextCompactedNotification } | { "method": "model/rerouted", "params": ModelReroutedNotification } | { "method": "model/verification", "params": ModelVerificationNotification } | { "method": "modelProvider/authRecoveryStarted", "params": AuthRecoveryNotification } | { "method": "modelProvider/authRecoveryCompleted", "params": AuthRecoveryNotification } | { "method": "turn/moderationMetadata", "params": TurnModerationMetadataNotification } | { "method": "model/safetyBuffering/updated", "params": ModelSafetyBufferingUpdatedNotification } | { "method": "warning", "params": WarningNotification } | { "method": "guardianWarning", "params": GuardianWarningNotification } | { "method": "deprecationNotice", "params": DeprecationNoticeNotification } | { "method": "configWarning", "params": ConfigWarningNotification } | { "method": "fuzzyFileSearch/sessionUpdated", "params": FuzzyFileSearchSessionUpdatedNotification } | { "method": "fuzzyFileSearch/sessionCompleted", "params": FuzzyFileSearchSessionCompletedNotification } | { "method": "thread/realtime/started", "params": ThreadRealtimeStartedNotification } | { "method": "thread/realtime/itemAdded", "params": ThreadRealtimeItemAddedNotification } | { "method": "thread/realtime/item/started", "params": ThreadRealtimeItemStartedNotification } | { "method": "thread/realtime/item/transcript/delta", "params": ThreadRealtimeItemTranscriptDeltaNotification } | { "method": "thread/realtime/item/completed", "params": ThreadRealtimeItemCompletedNotification } | { "method": "thread/realtime/transcript/delta", "params": ThreadRealtimeTranscriptDeltaNotification } | { "method": "thread/realtime/transcript/done", "params": ThreadRealtimeTranscriptDoneNotification } | { "method": "thread/realtime/outputAudio/delta", "params": ThreadRealtimeOutputAudioDeltaNotification } | { "method": "thread/realtime/sdp", "params": ThreadRealtimeSdpNotification } | { "method": "thread/realtime/error", "params": ThreadRealtimeErrorNotification } | { "method": "thread/realtime/closed", "params": ThreadRealtimeClosedNotification } | { "method": "windows/worldWritableWarning", "params": WindowsWorldWritableWarningNotification } | { "method": "windowsSandbox/setupCompleted", "params": WindowsSandboxSetupCompletedNotification } | { "method": "account/login/completed", "params": AccountLoginCompletedNotification });+emittedAtMs?: number, } & ({ "method": "error", "params": ErrorNotification } | { "method": "thread/started", "params": ThreadStartedNotification } | { "method": "thread/status/changed", "params": ThreadStatusChangedNotification } | { "method": "thread/readState/changed", "params": ThreadReadStateChangedNotification } | { "method": "thread/archived", "params": ThreadArchivedNotification } | { "method": "thread/deleted", "params": ThreadDeletedNotification } | { "method": "thread/unarchived", "params": ThreadUnarchivedNotification } | { "method": "thread/closed", "params": ThreadClosedNotification } | { "method": "thread/reverted", "params": ThreadRevertedNotification } | { "method": "skills/changed", "params": SkillsChangedNotification } | { "method": "thread/name/updated", "params": ThreadNameUpdatedNotification } | { "method": "thread/attachment/updated", "params": ThreadAttachmentUpdatedNotification } | { "method": "thread/goal/updated", "params": ThreadGoalUpdatedNotification } | { "method": "thread/prediction/updated", "params": ThreadPredictionUpdatedNotification } | { "method": "thread/goal/cleared", "params": ThreadGoalClearedNotification } | { "method": "thread/queue/changed", "params": ThreadQueueChangedNotification } | { "method": "project/changed", "params": ProjectChangedNotification } | { "method": "thread/project/updated", "params": ThreadProjectUpdatedNotification } | { "method": "thread/environment/connected", "params": EnvironmentConnectionNotification } | { "method": "thread/environment/disconnected", "params": EnvironmentConnectionNotification } | { "method": "thread/settings/updated", "params": ThreadSettingsUpdatedNotification } | { "method": "thread/tokenUsage/updated", "params": ThreadTokenUsageUpdatedNotification } | { "method": "turn/started", "params": TurnStartedNotification } | { "method": "hook/started", "params": HookStartedNotification } | { "method": "turn/completed", "params": TurnCompletedNotification } | { "method": "hook/completed", "params": HookCompletedNotification } | { "method": "turn/diff/updated", "params": TurnDiffUpdatedNotification } | { "method": "turn/plan/updated", "params": TurnPlanUpdatedNotification } | { "method": "item/started", "params": ItemStartedNotification } | { "method": "item/autoApprovalReview/started", "params": ItemGuardianApprovalReviewStartedNotification } | { "method": "item/autoApprovalReview/completed", "params": ItemGuardianApprovalReviewCompletedNotification } | { "method": "autoApprovalReview/strictReviewRequired", "params": StrictReviewRequiredNotification } | { "method": "item/completed", "params": ItemCompletedNotification } | { "method": "rawResponseItem/completed", "params": RawResponseItemCompletedNotification } | { "method": "rawResponse/completed", "params": RawResponseCompletedNotification } | { "method": "item/agentMessage/delta", "params": AgentMessageDeltaNotification } | { "method": "item/plan/delta", "params": PlanDeltaNotification } | { "method": "command/exec/outputDelta", "params": CommandExecOutputDeltaNotification } | { "method": "process/outputDelta", "params": ProcessOutputDeltaNotification } | { "method": "process/exited", "params": ProcessExitedNotification } | { "method": "item/commandExecution/outputDelta", "params": CommandExecutionOutputDeltaNotification } | { "method": "item/commandExecution/terminalInteraction", "params": TerminalInteractionNotification } | { "method": "item/fileChange/outputDelta", "params": FileChangeOutputDeltaNotification } | { "method": "item/fileChange/patchUpdated", "params": FileChangePatchUpdatedNotification } | { "method": "serverRequest/resolved", "params": ServerRequestResolvedNotification } | { "method": "item/mcpToolCall/progress", "params": McpToolCallProgressNotification } | { "method": "mcpServer/oauthLogin/completed", "params": McpServerOauthLoginCompletedNotification } | { "method": "mcpServer/startupStatus/updated", "params": McpServerStatusUpdatedNotification } | { "method": "mcpServer/event/stream/notification", "params": McpServerEventStreamNotification } | { "method": "account/updated", "params": AccountUpdatedNotification } | { "method": "account/gatewayOAuth/changed", "params": GatewayOAuthChangedNotification } | { "method": "account/rateLimits/updated", "params": AccountRateLimitsUpdatedNotification } | { "method": "app/list/updated", "params": AppListUpdatedNotification } | { "method": "remoteControl/status/changed", "params": RemoteControlStatusChangedNotification } | { "method": "externalAgentConfig/import/progress", "params": ExternalAgentConfigImportProgressNotification } | { "method": "externalAgentConfig/import/completed", "params": ExternalAgentConfigImportCompletedNotification } | { "method": "fs/changed", "params": FsChangedNotification } | { "method": "item/reasoning/summaryTextDelta", "params": ReasoningSummaryTextDeltaNotification } | { "method": "item/reasoning/summaryPartAdded", "params": ReasoningSummaryPartAddedNotification } | { "method": "item/reasoning/textDelta", "params": ReasoningTextDeltaNotification } | { "method": "thread/compacted", "params": ContextCompactedNotification } | { "method": "model/rerouted", "params": ModelReroutedNotification } | { "method": "model/verification", "params": ModelVerificationNotification } | { "method": "modelProvider/authRecoveryStarted", "params": AuthRecoveryNotification } | { "method": "modelProvider/authRecoveryCompleted", "params": AuthRecoveryNotification } | { "method": "turn/moderationMetadata", "params": TurnModerationMetadataNotification } | { "method": "model/safetyBuffering/updated", "params": ModelSafetyBufferingUpdatedNotification } | { "method": "warning", "params": WarningNotification } | { "method": "guardianWarning", "params": GuardianWarningNotification } | { "method": "deprecationNotice", "params": DeprecationNoticeNotification } | { "method": "configWarning", "params": ConfigWarningNotification } | { "method": "fuzzyFileSearch/sessionUpdated", "params": FuzzyFileSearchSessionUpdatedNotification } | { "method": "fuzzyFileSearch/sessionCompleted", "params": FuzzyFileSearchSessionCompletedNotification } | { "method": "thread/realtime/started", "params": ThreadRealtimeStartedNotification } | { "method": "thread/realtime/itemAdded", "params": ThreadRealtimeItemAddedNotification } | { "method": "thread/realtime/item/started", "params": ThreadRealtimeItemStartedNotification } | { "method": "thread/realtime/item/transcript/delta", "params": ThreadRealtimeItemTranscriptDeltaNotification } | { "method": "thread/realtime/item/completed", "params": ThreadRealtimeItemCompletedNotification } | { "method": "thread/realtime/transcript/delta", "params": ThreadRealtimeTranscriptDeltaNotification } | { "method": "thread/realtime/transcript/done", "params": ThreadRealtimeTranscriptDoneNotification } | { "method": "thread/realtime/outputAudio/delta", "params": ThreadRealtimeOutputAudioDeltaNotification } | { "method": "thread/realtime/sdp", "params": ThreadRealtimeSdpNotification } | { "method": "thread/realtime/error", "params": ThreadRealtimeErrorNotification } | { "method": "thread/realtime/closed", "params": ThreadRealtimeClosedNotification } | { "method": "windows/worldWritableWarning", "params": WindowsWorldWritableWarningNotification } | { "method": "windowsSandbox/setupCompleted", "params": WindowsSandboxSetupCompletedNotification } | { "method": "account/login/completed", "params": AccountLoginCompletedNotification });diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/ThreadReadStateChangedNotification.ts b/codex-rs/app-server-protocol/schema/typescript/v2/ThreadReadStateChangedNotification.tsnew file mode 100644index 0000000000..c640b4f9ab--- /dev/null+++ b/codex-rs/app-server-protocol/schema/typescript/v2/ThreadReadStateChangedNotification.ts@@ -0,0 +1,6 @@+// GENERATED CODE! DO NOT MODIFY BY HAND!++// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.+import type { ThreadReadState } from "./ThreadReadState";++export type ThreadReadStateChangedNotification = { threadId: string, readState: ThreadReadState, };diff --git a/codex-rs/app-server-protocol/schema/typescript/v2/index.ts b/codex-rs/app-server-protocol/schema/typescript/v2/index.tsindex acc4e3c9e8..26ee4dcc7e 100644--- a/codex-rs/app-server-protocol/schema/typescript/v2/index.ts+++ b/codex-rs/app-server-protocol/schema/typescript/v2/index.ts@@ -540,6 +540,7 @@ export type { ThreadQueueChangedNotification } from "./ThreadQueueChangedNotificexport type { ThreadReadParams } from "./ThreadReadParams";export type { ThreadReadResponse } from "./ThreadReadResponse";export type { ThreadReadState } from "./ThreadReadState";+export type { ThreadReadStateChangedNotification } from "./ThreadReadStateChangedNotification";export type { ThreadRealtimeAudioChunk } from "./ThreadRealtimeAudioChunk";export type { ThreadRealtimeBemItemPresentation } from "./ThreadRealtimeBemItemPresentation";export type { ThreadRealtimeClosedNotification } from "./ThreadRealtimeClosedNotification";diff --git a/codex-rs/app-server-protocol/src/protocol/common.rs b/codex-rs/app-server-protocol/src/protocol/common.rsindex 4cc1fde439..262464aede 100644--- a/codex-rs/app-server-protocol/src/protocol/common.rs+++ b/codex-rs/app-server-protocol/src/protocol/common.rs@@ -1937,6 +1937,8 @@ server_notification_definitions! {Error => "error" (v2::ErrorNotification),ThreadStarted => "thread/started" (v2::ThreadStartedNotification),ThreadStatusChanged => "thread/status/changed" (v2::ThreadStatusChangedNotification),+ #[experimental("thread/readState/changed")]+ ThreadReadStateChanged => "thread/readState/changed" (v2::ThreadReadStateChangedNotification),ThreadArchived => "thread/archived" (v2::ThreadArchivedNotification),ThreadDeleted => "thread/deleted" (v2::ThreadDeletedNotification),ThreadUnarchived => "thread/unarchived" (v2::ThreadUnarchivedNotification),diff --git a/codex-rs/app-server-protocol/src/protocol/v2/thread.rs b/codex-rs/app-server-protocol/src/protocol/v2/thread.rsindex 609e266a07..4495fd0fa7 100644--- a/codex-rs/app-server-protocol/src/protocol/v2/thread.rs+++ b/codex-rs/app-server-protocol/src/protocol/v2/thread.rs@@ -2042,6 +2042,14 @@ pub enum ThreadUnreadPosition {},}+#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, Eq, JsonSchema, TS)]+#[serde(rename_all = "camelCase")]+#[ts(export_to = "v2/")]+pub struct ThreadReadStateChangedNotification {+ pub thread_id: String,+ pub read_state: ThreadReadState,+}+#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, JsonSchema, TS)]#[serde(rename_all = "camelCase")]#[ts(export_to = "v2/")]diff --git a/codex-rs/app-server/README.md b/codex-rs/app-server/README.mdindex b88d0c87ff..3c8e4f6ffd 100644--- a/codex-rs/app-server/README.md+++ b/codex-rs/app-server/README.md@@ -27,7 +27,8 @@ thread IDs on the returned page to their receipts. Null (or absent on older servmeans durable read state is unavailable; a missing map entry means that row isineligible. Ephemeral, not-yet-persisted, service and product-owned threads areineligible. Shared `Thread` objects, including search and lifecycle responses,-carry no receipts. After start, resume or fork, refresh with `thread/read`.+carry no receipts. After start, resume or fork, use `thread/read` to obtain the+current receipt.Each local thread has one receipt, with the same storage ownership as the thread.A read state is `{firstUnread, revision}`. `firstUnread` is null when read,@@ -42,6 +43,16 @@ clears a removed position; explicit thread-start marks survive. Loading snapshotnever acknowledges activity; empty threads start read and forked history doesnot publish inherited turns as new results.+Enabling `initialize.capabilities.experimentalApi` permits receiving read-state+notifications.++Started, resumed or forked threads send `thread/readState/changed` alongside+ordinary thread events; thread/unsubscribe or disconnect stops delivery.+Clients can filter this method with the existing notification opt-out setting.+Revisions are equality tokens, not clocks: never compare or merge them across+threads or hosts. When concurrent responses disagree, refresh with `thread/read`.+Offscreen threads converge on page refresh.+# Guardian circuit-breaker errorsSet `auto_review.circuit_break_action = "strict"` to include `TooManyDenials` indiff --git a/codex-rs/app-server/src/notification_media.rs b/codex-rs/app-server/src/notification_media.rsindex 4223ea796d..a1572cbaf7 100644--- a/codex-rs/app-server/src/notification_media.rs+++ b/codex-rs/app-server/src/notification_media.rs@@ -57,6 +57,7 @@ pub(crate) fn without_notification_media(notification: ServerNotification) -> SeServerNotification::Error(_)| ServerNotification::ThreadStarted(_)| ServerNotification::ThreadStatusChanged(_)+ | ServerNotification::ThreadReadStateChanged(_)| ServerNotification::ThreadArchived(_)| ServerNotification::ThreadDeleted(_)| ServerNotification::ThreadUnarchived(_)diff --git a/codex-rs/app-server/src/request_processors/thread_lifecycle.rs b/codex-rs/app-server/src/request_processors/thread_lifecycle.rsindex 2b455908cc..a7754975b5 100644--- a/codex-rs/app-server/src/request_processors/thread_lifecycle.rs+++ b/codex-rs/app-server/src/request_processors/thread_lifecycle.rs@@ -364,10 +364,16 @@ pub(super) async fn ensure_listener_task_running(conversation_id,);- // Make reads after turn/completed reflect the committed frontier.- if let Some(summary) = terminal_summary {- super::thread_read_state::publish(+ // Publish the committed receipt before turn/completed so completion+ // remains the last notification for this terminal result.+ if let Some(summary) = terminal_summary+ && let Some(db) = super::thread_read_state::publish(&event, conversation_id, &conversation, &summary,+ ).await+ {+ super::thread_read_state::notify(+ &db, &thread_state_manager,+ &outgoing_for_task, conversation_id,).await;}apply_bespoke_event_handling(diff --git a/codex-rs/app-server/src/request_processors/thread_processor.rs b/codex-rs/app-server/src/request_processors/thread_processor.rsindex d9ba44f647..bea69d7cf6 100644--- a/codex-rs/app-server/src/request_processors/thread_processor.rs+++ b/codex-rs/app-server/src/request_processors/thread_processor.rs@@ -2303,12 +2303,24 @@ impl ThreadRequestProcessor {codex_state::ReadStateOperation::Read,).await- .map(|_| ()),- Ok(None) => Ok(()),+ .map(|update| matches!(update, codex_state::ReadStateUpdate::Applied(_))),+ Ok(None) => Ok(false),Err(err) => Err(err),};- if let Err(err) = retirement {- tracing::warn!("reverted history but could not update unread position: {err}")+ match retirement {+ Ok(true) => {+ super::thread_read_state::notify(+ db,+ &self.thread_state_manager,+ &self.outgoing,+ thread_id,+ )+ .await;+ }+ Ok(false) => {}+ Err(err) => {+ tracing::warn!("reverted history but could not update unread position: {err}")+ }}}let response = selfdiff --git a/codex-rs/app-server/src/request_processors/thread_read_state.rs b/codex-rs/app-server/src/request_processors/thread_read_state.rsindex 5f3d8aeadf..33bb9f090a 100644--- a/codex-rs/app-server/src/request_processors/thread_read_state.rs+++ b/codex-rs/app-server/src/request_processors/thread_read_state.rs@@ -1,7 +1,8 @@-//! Read state for durable local threads returned by the thread store.+//! Read state for durable local threads. Receipt changes use the thread's usual subscribers.use super::*;use codex_app_server_protocol::ThreadReadState;+use codex_app_server_protocol::ThreadReadStateChangedNotification;use codex_app_server_protocol::ThreadUnreadPosition;// These scopes have product notification policy the local server cannot resolve.@@ -57,6 +58,30 @@ pub(super) async fn snapshots(}}+pub(super) async fn notify(+ db: &StateDbHandle,+ manager: &ThreadStateManager,+ outgoing: &Arc<OutgoingMessageSender>,+ id: ThreadId,+) {+ match db.thread_read_states(&[id]).await {+ Ok(mut states) => {+ if let Some(state) = states.remove(&id) {+ let subscribers = manager.subscribed_connection_ids(id).await;+ ThreadScopedOutgoingMessageSender::new(Arc::clone(outgoing), subscribers, id)+ .send_server_notification(ServerNotification::ThreadReadStateChanged(+ ThreadReadStateChangedNotification {+ thread_id: id.to_string(),+ read_state: to_api(state),+ },+ ))+ .await;+ }+ }+ Err(err) => tracing::warn!("could not project committed read state: {err}"),+ }+}+/// Runs only on newly delivered Core events, never on history decoding or replay.pub(super) async fn publish(event: &codex_protocol::protocol::Event,diff --git a/codex-rs/app-server/tests/suite/v2/thread_read_state.rs b/codex-rs/app-server/tests/suite/v2/thread_read_state.rsindex ccc01fef0b..32fe3923d0 100644--- a/codex-rs/app-server/tests/suite/v2/thread_read_state.rs+++ b/codex-rs/app-server/tests/suite/v2/thread_read_state.rs@@ -8,6 +8,7 @@ use codex_app_server_protocol::ThreadHistoryMode;use codex_app_server_protocol::ThreadListResponse;use codex_app_server_protocol::ThreadReadParams;use codex_app_server_protocol::ThreadReadResponse;+use codex_app_server_protocol::ThreadReadStateChangedNotification;use codex_app_server_protocol::ThreadRevertParams;use codex_app_server_protocol::ThreadRevertResponse;use codex_app_server_protocol::ThreadStartParams;@@ -96,6 +97,13 @@ async fn read_state_tracks_terminal_activity_and_reverted_history() -> Result<()assert_eq!(listed.data[0].id, thread_id);assert_eq!(receipts, [(thread_id.clone(), first.clone())].into());+ let changed: ThreadReadStateChangedNotification = timeout(+ TIMEOUT,+ server.read_notification("thread/readState/changed"),+ )+ .await??;+ assert_eq!(changed.read_state, first);+let _: ThreadRevertResponse = server.request(|request_id| ClientRequest::ThreadRevert {request_id,diff --git a/codex-rs/tui/src/app/app_server_event_targets.rs b/codex-rs/tui/src/app/app_server_event_targets.rsindex 9e5b60bd83..13d30c273f 100644--- a/codex-rs/tui/src/app/app_server_event_targets.rs+++ b/codex-rs/tui/src/app/app_server_event_targets.rs@@ -202,6 +202,7 @@ pub(super) fn server_notification_thread_target(ServerNotification::ProjectChanged(_)| ServerNotification::SkillsChanged(_)| ServerNotification::AccountUpdated(_)+ | ServerNotification::ThreadReadStateChanged(_)| ServerNotification::GatewayOAuthChanged(_)| ServerNotification::AccountRateLimitsUpdated(_)| ServerNotification::AppListUpdated(_)diff --git a/codex-rs/tui/src/chatwidget/protocol.rs b/codex-rs/tui/src/chatwidget/protocol.rsindex 85ea551334..9e884d213c 100644--- a/codex-rs/tui/src/chatwidget/protocol.rs+++ b/codex-rs/tui/src/chatwidget/protocol.rs@@ -359,6 +359,7 @@ impl ChatWidget {| ServerNotification::AccountRateLimitsUpdated(_)| ServerNotification::ThreadStarted(_)| ServerNotification::ThreadStatusChanged(_)+ | ServerNotification::ThreadReadStateChanged(_)| ServerNotification::ThreadReverted(_)| ServerNotification::ThreadQueueChanged(_)| ServerNotification::ThreadPredictionUpdated(_)diff --git a/sdk/python/src/openai_codex/generated/notification_registry.py b/sdk/python/src/openai_codex/generated/notification_registry.pyindex af2d3590ab..2c1212bd8a 100644--- a/sdk/python/src/openai_codex/generated/notification_registry.py+++ b/sdk/python/src/openai_codex/generated/notification_registry.py@@ -64,6 +64,7 @@ from .v2_all import ThreadNameUpdatedNotificationfrom .v2_all import ThreadPredictionUpdatedNotificationfrom .v2_all import ThreadProjectUpdatedNotificationfrom .v2_all import ThreadQueueChangedNotification+from .v2_all import ThreadReadStateChangedNotificationfrom .v2_all import ThreadRealtimeClosedNotificationfrom .v2_all import ThreadRealtimeErrorNotificationfrom .v2_all import ThreadRealtimeItemAddedNotification@@ -148,6 +149,7 @@ KnownNotificationPayload: TypeAlias = (| ThreadPredictionUpdatedNotification| ThreadProjectUpdatedNotification| ThreadQueueChangedNotification+ | ThreadReadStateChangedNotification| ThreadRealtimeClosedNotification| ThreadRealtimeErrorNotification| ThreadRealtimeItemAddedNotification@@ -235,6 +237,7 @@ NOTIFICATION_MODELS: dict[str, type[KnownNotificationPayload]] = {"thread/prediction/updated": ThreadPredictionUpdatedNotification,"thread/project/updated": ThreadProjectUpdatedNotification,"thread/queue/changed": ThreadQueueChangedNotification,+ "thread/readState/changed": ThreadReadStateChangedNotification,"thread/realtime/closed": ThreadRealtimeClosedNotification,"thread/realtime/error": ThreadRealtimeErrorNotification,"thread/realtime/item/completed": ThreadRealtimeItemCompletedNotification,diff --git a/sdk/python/src/openai_codex/generated/v2_all.py b/sdk/python/src/openai_codex/generated/v2_all.pyindex b864dd0f33..394f97bf99 100644--- a/sdk/python/src/openai_codex/generated/v2_all.py+++ b/sdk/python/src/openai_codex/generated/v2_all.py@@ -10249,6 +10249,14 @@ class ThreadReadState(BaseModel):revision: str+class ThreadReadStateChangedNotification(BaseModel):+ model_config = ConfigDict(+ populate_by_name=True,+ )+ read_state: Annotated[ThreadReadState, Field(alias="readState")]+ thread_id: Annotated[str, Field(alias="threadId")]++class TranscriptSegmentThreadRealtimeItem(BaseModel):model_config = ConfigDict(populate_by_name=True,@@ -11317,6 +11325,24 @@ class ErrorServerNotification(BaseModel):params: ErrorNotification+class ThreadReadStateChangedServerNotification(BaseModel):+ model_config = ConfigDict(+ populate_by_name=True,+ )+ emitted_at_ms: Annotated[+ int | None,+ Field(+ alias="emittedAtMs",+ description="Unix timestamp (in milliseconds) when app-server emitted this notification.",+ ),+ ] = None+ method: Annotated[+ Literal["thread/readState/changed"],+ Field(title="Thread/readState/changedNotificationMethod"),+ ]+ params: ThreadReadStateChangedNotification++class ThreadGoalUpdatedServerNotification(BaseModel):model_config = ConfigDict(populate_by_name=True,@@ -13116,6 +13142,7 @@ class ServerNotification(ErrorServerNotification| ThreadStartedServerNotification| ThreadStatusChangedServerNotification+ | ThreadReadStateChangedServerNotification| ThreadArchivedServerNotification| ThreadDeletedServerNotification| ThreadUnarchivedServerNotification@@ -13206,6 +13233,7 @@ class ServerNotification(ErrorServerNotification| ThreadStartedServerNotification| ThreadStatusChangedServerNotification+ | ThreadReadStateChangedServerNotification| ThreadArchivedServerNotification| ThreadDeletedServerNotification| ThreadUnarchivedServerNotification