Refresh generated Python app-server SDK types (#18862)

This is the first step in splitting the Python SDK PyPI publish work
into reviewable layers: land the generated SDK refresh by itself before
changing packaging mechanics. The next PRs will make the runtime wheel
publishable, then wire the SDK package/version pinning to that runtime.

## Summary
- Refresh generated Python app-server v2 models and notification
registry from the current schema.
- Update the public API signature expectations for the newly generated
kwargs.

## Stack
- PR 1 of 3 for the Python SDK PyPI publishing split.
- Follow-up PRs will handle runtime wheel publishing mechanics, then
SDK/package version pinning.

## Tests
- `uv run --extra dev pytest` in `sdk/python` -> 51 passed, 37 skipped.

sdk/python/src/codex_app_server/api.py

@@ -105,7 +105,11 @@ class Codex:
 
         normalized_server_name = (server_name or "").strip()
         normalized_server_version = (server_version or "").strip()
-        if not user_agent or not normalized_server_name or not normalized_server_version:
+        if (
+            not user_agent
+            or not normalized_server_name
+            or not normalized_server_version
+        ):
             raise RuntimeError(
                 "initialize response missing required metadata "
                 f"(user_agent={user_agent!r}, server_name={normalized_server_name!r}, server_version={normalized_server_version!r})"
@@ -146,6 +150,7 @@ class Codex:
         sandbox: SandboxMode | None = None,
         service_name: str | None = None,
         service_tier: ServiceTier | None = None,
+        session_start_source: ThreadStartSource | None = None,
     ) -> Thread:
         params = ThreadStartParams(
             approval_policy=approval_policy,
@@ -161,6 +166,7 @@ class Codex:
             sandbox=sandbox,
             service_name=service_name,
             service_tier=service_tier,
+            session_start_source=session_start_source,
         )
         started = self._client.thread_start(params)
         return Thread(self._client, started.thread.id)
@@ -174,6 +180,7 @@ class Codex:
         limit: int | None = None,
         model_providers: list[str] | None = None,
         search_term: str | None = None,
+        sort_direction: SortDirection | None = None,
         sort_key: ThreadSortKey | None = None,
         source_kinds: list[ThreadSourceKind] | None = None,
     ) -> ThreadListResponse:
@@ -184,6 +191,7 @@ class Codex:
             limit=limit,
             model_providers=model_providers,
             search_term=search_term,
+            sort_direction=sort_direction,
             sort_key=sort_key,
             source_kinds=source_kinds,
         )
@@ -336,6 +344,7 @@ class AsyncCodex:
         sandbox: SandboxMode | None = None,
         service_name: str | None = None,
         service_tier: ServiceTier | None = None,
+        session_start_source: ThreadStartSource | None = None,
     ) -> AsyncThread:
         await self._ensure_initialized()
         params = ThreadStartParams(
@@ -352,6 +361,7 @@ class AsyncCodex:
             sandbox=sandbox,
             service_name=service_name,
             service_tier=service_tier,
+            session_start_source=session_start_source,
         )
         started = await self._client.thread_start(params)
         return AsyncThread(self, started.thread.id)
@@ -365,6 +375,7 @@ class AsyncCodex:
         limit: int | None = None,
         model_providers: list[str] | None = None,
         search_term: str | None = None,
+        sort_direction: SortDirection | None = None,
         sort_key: ThreadSortKey | None = None,
         source_kinds: list[ThreadSourceKind] | None = None,
     ) -> ThreadListResponse:
@@ -376,6 +387,7 @@ class AsyncCodex:
             limit=limit,
             model_providers=model_providers,
             search_term=search_term,
+            sort_direction=sort_direction,
             sort_key=sort_key,
             source_kinds=source_kinds,
         )
@@ -629,7 +641,9 @@ class AsyncThread:
 
     async def read(self, *, include_turns: bool = False) -> ThreadReadResponse:
         await self._codex._ensure_initialized()
-        return await self._codex._client.thread_read(self.id, include_turns=include_turns)
+        return await self._codex._client.thread_read(
+            self.id, include_turns=include_turns
+        )
 
     async def set_name(self, name: str) -> ThreadSetNameResponse:
         await self._codex._ensure_initialized()
@@ -674,7 +688,10 @@ class TurnHandle:
         try:
             for event in stream:
                 payload = event.payload
-                if isinstance(payload, TurnCompletedNotification) and payload.turn.id == self.id:
+                if (
+                    isinstance(payload, TurnCompletedNotification)
+                    and payload.turn.id == self.id
+                ):
                     completed = payload
         finally:
             stream.close()
@@ -725,7 +742,10 @@ class AsyncTurnHandle:
         try:
             async for event in stream:
                 payload = event.payload
-                if isinstance(payload, TurnCompletedNotification) and payload.turn.id == self.id:
+                if (
+                    isinstance(payload, TurnCompletedNotification)
+                    and payload.turn.id == self.id
+                ):
                     completed = payload
         finally:
             await stream.aclose()

sdk/python/src/codex_app_server/generated/notification_registry.py

@@ -16,7 +16,9 @@ from .v2_all import ConfigWarningNotification
 from .v2_all import ContextCompactedNotification
 from .v2_all import DeprecationNoticeNotification
 from .v2_all import ErrorNotification
+from .v2_all import ExternalAgentConfigImportCompletedNotification
 from .v2_all import FileChangeOutputDeltaNotification
+from .v2_all import FileChangePatchUpdatedNotification
 from .v2_all import FsChangedNotification
 from .v2_all import FuzzyFileSearchSessionCompletedNotification
 from .v2_all import FuzzyFileSearchSessionUpdatedNotification
@@ -44,8 +46,10 @@ from .v2_all import ThreadRealtimeClosedNotification
 from .v2_all import ThreadRealtimeErrorNotification
 from .v2_all import ThreadRealtimeItemAddedNotification
 from .v2_all import ThreadRealtimeOutputAudioDeltaNotification
+from .v2_all import ThreadRealtimeSdpNotification
 from .v2_all import ThreadRealtimeStartedNotification
-from .v2_all import ThreadRealtimeTranscriptUpdatedNotification
+from .v2_all import ThreadRealtimeTranscriptDeltaNotification
+from .v2_all import ThreadRealtimeTranscriptDoneNotification
 from .v2_all import ThreadStartedNotification
 from .v2_all import ThreadStatusChangedNotification
 from .v2_all import ThreadTokenUsageUpdatedNotification
@@ -54,6 +58,7 @@ from .v2_all import TurnCompletedNotification
 from .v2_all import TurnDiffUpdatedNotification
 from .v2_all import TurnPlanUpdatedNotification
 from .v2_all import TurnStartedNotification
+from .v2_all import WarningNotification
 from .v2_all import WindowsSandboxSetupCompletedNotification
 from .v2_all import WindowsWorldWritableWarningNotification
 
@@ -66,6 +71,7 @@ NOTIFICATION_MODELS: dict[str, type[BaseModel]] = {
     "configWarning": ConfigWarningNotification,
     "deprecationNotice": DeprecationNoticeNotification,
     "error": ErrorNotification,
+    "externalAgentConfig/import/completed": ExternalAgentConfigImportCompletedNotification,
     "fs/changed": FsChangedNotification,
     "fuzzyFileSearch/sessionCompleted": FuzzyFileSearchSessionCompletedNotification,
     "fuzzyFileSearch/sessionUpdated": FuzzyFileSearchSessionUpdatedNotification,
@@ -78,6 +84,7 @@ NOTIFICATION_MODELS: dict[str, type[BaseModel]] = {
     "item/commandExecution/terminalInteraction": TerminalInteractionNotification,
     "item/completed": ItemCompletedNotification,
     "item/fileChange/outputDelta": FileChangeOutputDeltaNotification,
+    "item/fileChange/patchUpdated": FileChangePatchUpdatedNotification,
     "item/mcpToolCall/progress": McpToolCallProgressNotification,
     "item/plan/delta": PlanDeltaNotification,
     "item/reasoning/summaryPartAdded": ReasoningSummaryPartAddedNotification,
@@ -97,8 +104,10 @@ NOTIFICATION_MODELS: dict[str, type[BaseModel]] = {
     "thread/realtime/error": ThreadRealtimeErrorNotification,
     "thread/realtime/itemAdded": ThreadRealtimeItemAddedNotification,
     "thread/realtime/outputAudio/delta": ThreadRealtimeOutputAudioDeltaNotification,
+    "thread/realtime/sdp": ThreadRealtimeSdpNotification,
     "thread/realtime/started": ThreadRealtimeStartedNotification,
-    "thread/realtime/transcriptUpdated": ThreadRealtimeTranscriptUpdatedNotification,
+    "thread/realtime/transcript/delta": ThreadRealtimeTranscriptDeltaNotification,
+    "thread/realtime/transcript/done": ThreadRealtimeTranscriptDoneNotification,
     "thread/started": ThreadStartedNotification,
     "thread/status/changed": ThreadStatusChangedNotification,
     "thread/tokenUsage/updated": ThreadTokenUsageUpdatedNotification,
@@ -107,6 +116,7 @@ NOTIFICATION_MODELS: dict[str, type[BaseModel]] = {
     "turn/diff/updated": TurnDiffUpdatedNotification,
     "turn/plan/updated": TurnPlanUpdatedNotification,
     "turn/started": TurnStartedNotification,
+    "warning": WarningNotification,
     "windows/worldWritableWarning": WindowsWorldWritableWarningNotification,
     "windowsSandbox/setupCompleted": WindowsSandboxSetupCompletedNotification,
 }