codex-backend-sdk 0.5.2__tar.gz → 0.5.3__tar.gz

{codex_backend_sdk-0.5.2 → codex_backend_sdk-0.5.3}/CHANGELOG.md

@@ -2,7 +2,25 @@
 
 All notable changes to this project will be documented in this file.
 
-## Unreleased
+## [0.5.3] - 2026-09-18
+
+### Added
+- Added the OpenAI-shaped `client.live.create(...)` and
+  `client.live.sideband.connect(...)` surfaces over the existing Codex OAuth
+  Realtime v3 transport, including the public response shape and lazy
+  sideband context-manager idiom.
+- Added current Codex workspace usage, task-usage, turn-estimate, plugin/skill
+  analytics, and reset-credit history resources discovered by the refreshed
+  source scan.
+- Added the current Desktop plugin home feed and explicit plugin/skill
+  enable-disable mutations.
+
+### Changed
+- Updated the compatibility baseline to `openai-python` 3.16.1 while retaining
+  the additive low-level `client.realtime` API.
+- Reconciled the endpoint inventory with the refreshed Codex and official
+  Desktop checkouts, and tightened validation of plugin catalog responses and
+  pagination state.
 
 ## [0.5.1] - 2026-08-14
 

{codex_backend_sdk-0.5.2 → codex_backend_sdk-0.5.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: codex-backend-sdk
-Version: 0.5.2
+Version: 0.5.3
 Summary: Unofficial Python SDK for the ChatGPT Codex backend API
 License: MIT
 License-File: LICENSE
@@ -19,12 +19,12 @@ Requires-Dist: pydantic>=2.0
 Requires-Dist: requests>=2.28
 Requires-Dist: websocket-client>=1.8
 Provides-Extra: dev
-Requires-Dist: openai<2.53.0,>=1.0; (python_version < '3.10') and extra == 'dev'
-Requires-Dist: openai>=2.53.0; (python_version >= '3.10') and extra == 'dev'
+Requires-Dist: openai<3.0,>=1.0; (python_version < '3.10') and extra == 'dev'
+Requires-Dist: openai>=3.16.1; (python_version >= '3.10') and extra == 'dev'
 Requires-Dist: pytest>=7.0; extra == 'dev'
 Provides-Extra: openai
-Requires-Dist: openai<2.53.0,>=1.0; (python_version < '3.10') and extra == 'openai'
-Requires-Dist: openai>=2.53.0; (python_version >= '3.10') and extra == 'openai'
+Requires-Dist: openai<3.0,>=1.0; (python_version < '3.10') and extra == 'openai'
+Requires-Dist: openai>=3.16.1; (python_version >= '3.10') and extra == 'openai'
 Description-Content-Type: text/markdown
 
 # codex-backend-sdk
@@ -65,7 +65,7 @@ from codex_backend_sdk import OpenAI
 client = OpenAI().authenticate()
 
 response = client.responses.create(
-    model="gpt-5.4",
+    model="gpt-5.5",
     input="Explain quicksort in one paragraph.",
 )
 
@@ -89,7 +89,8 @@ client.files           # upload files for Apps/MCP parameters
 client.images          # Codex-backed image generation and editing
 client.audio           # ChatGPT-backed transcription
 client.embeddings      # OpenAI embeddings endpoint through OAuth
-client.realtime        # WebRTC call creation and Realtime connection headers
+client.live            # OpenAI-shaped GPT-Live creation and sideband attachment
+client.realtime        # additive low-level Codex Realtime v3 transport
 ```
 
 These resources follow `openai-python` conventions where the backend overlaps
@@ -142,7 +143,7 @@ dictionaries or raw streams when imposing a stable model would be misleading.
 
 ```python
 response = client.responses.create(
-    model="gpt-5.4",
+    model="gpt-5.5",
     instructions="Be concise.",
     input="Summarize the CAP theorem.",
     reasoning={"effort": "medium", "summary": "auto"},
@@ -173,7 +174,7 @@ connection reusable across sequential turns:
 
 ```python
 with client.responses.websocket.connect() as ws:
-    for event in ws.create({"model": "gpt-5.4", "input": "Say hello."}):
+    for event in ws.create({"model": "gpt-5.5", "input": "Say hello."}):
         if event.get("type") == "response.output_text.delta":
             print(event.get("delta", ""), end="")
 ```
@@ -197,7 +198,7 @@ print(client.responses.create(input=history).output_text)
 
 ```python
 compacted = client.responses.compact(
-    model="gpt-5.4",
+    model="gpt-5.5",
     instructions="Preserve task-critical decisions and unresolved work.",
     input=history,
 )
@@ -268,7 +269,7 @@ print(result.output_parsed)
 for model in client.models.list():
     print(model.id, model.context_window, model.supported_reasoning_levels)
 
-model = client.models.retrieve("gpt-5.4")
+model = client.models.retrieve("gpt-5.5")
 ```
 
 ### Upload a file
@@ -340,6 +341,10 @@ sports, and time commands. See the API reference for command validation.
 quota = client.codex.usage()
 daily = client.codex.usage_details.daily_token_breakdown()
 credits = client.codex.usage_details.credit_events()
+plugin_metrics = client.codex.usage_details.plugin_usage_metrics(
+    start_date="2026-09-01",
+    end_date="2026-09-18",
+)
 
 print(quota.get("rate_limit", {}).get("primary_window"))
 ```
@@ -443,6 +448,7 @@ tool annotations and own user confirmation; the SDK never auto-invokes tools.
 plugins = client.chatgpt.plugins.list_all(scope="GLOBAL")
 installed = client.chatgpt.plugins.installed_all()
 suggested = client.chatgpt.plugins.suggested()
+home = client.chatgpt.plugins.home()
 skill = client.chatgpt.plugins.skill("plugins~...", "skill-name")
 
 checkout = client.chatgpt.plugins.bundles.extract_plugin(
@@ -491,33 +497,42 @@ return a typed in-memory object, bytes, `BytesIO`, a data URI, or a file path.
 ### Realtime voice
 
 ```python
-answer = client.realtime.calls.create_v3(
-    sdp=offer_sdp,
+live = client.live.create(
     session={
         "model": "gpt-live-1-codex",
         "instructions": "Speak naturally and stay concise.",
+        "delegation": {"type": "client"},
     },
+    transport={"type": "webrtc", "sdp": offer_sdp},
 )
-print(answer.answer_sdp)
+apply_remote_sdp(live.transport.sdp)
+
+with client.live.sideband.connect(session_id=live.session.id) as sideband:
+    for event in sideband:
+        print(event.type)
 ```
 
 Live probes confirmed `gpt-live-1-codex` and
 `gpt-live-1-boulder-alpha`. They are Codex Realtime v3 snapshots, not aliases
-for the public `gpt-realtime` family. The call response exposes `call_id`; join
-its OAuth-authenticated control and delegation channel with:
+for the public `gpt-live-1` model. `client.live` follows the current
+`openai-python` creation, response, and sideband idioms while adapting them to
+the ChatGPT OAuth call transport.
+
+The earlier low-level surface remains available for backend-specific code:
 
 ```python
-sideband = client.realtime.sideband.connect(
-    call_id=answer.call_id,
-    session_id="voice-session",
+answer = client.realtime.calls.create_v3(
+    sdp=offer_sdp,
+    session={"model": "gpt-live-1-codex"},
 )
-sideband.send({"type": "delegation.context.append", "content": []})
-event = sideband.recv()
-sideband.close()
+with client.realtime.sideband.connect(call_id=answer.call_id) as sideband:
+    sideband.send({"type": "session.close"})
 ```
 
-The SDK intentionally exposes only the ChatGPT-authenticated v3 transport. It
-does not retain the separately billed API-key Voice v2 WebSocket helpers.
+The OAuth backend's event dialect is still experimental and is exposed
+forward-compatibly through `LiveEvent` rather than rewritten into invented
+public fields. The public primary `client.live.connect()` WebSocket is not
+available through ChatGPT OAuth; use WebRTC plus the attached sideband.
 
 ### Embeddings
 

{codex_backend_sdk-0.5.2 → codex_backend_sdk-0.5.3}/README.md

@@ -36,7 +36,7 @@ from codex_backend_sdk import OpenAI
 client = OpenAI().authenticate()
 
 response = client.responses.create(
-    model="gpt-5.4",
+    model="gpt-5.5",
     input="Explain quicksort in one paragraph.",
 )
 
@@ -60,7 +60,8 @@ client.files           # upload files for Apps/MCP parameters
 client.images          # Codex-backed image generation and editing
 client.audio           # ChatGPT-backed transcription
 client.embeddings      # OpenAI embeddings endpoint through OAuth
-client.realtime        # WebRTC call creation and Realtime connection headers
+client.live            # OpenAI-shaped GPT-Live creation and sideband attachment
+client.realtime        # additive low-level Codex Realtime v3 transport
 ```
 
 These resources follow `openai-python` conventions where the backend overlaps
@@ -113,7 +114,7 @@ dictionaries or raw streams when imposing a stable model would be misleading.
 
 ```python
 response = client.responses.create(
-    model="gpt-5.4",
+    model="gpt-5.5",
     instructions="Be concise.",
     input="Summarize the CAP theorem.",
     reasoning={"effort": "medium", "summary": "auto"},
@@ -144,7 +145,7 @@ connection reusable across sequential turns:
 
 ```python
 with client.responses.websocket.connect() as ws:
-    for event in ws.create({"model": "gpt-5.4", "input": "Say hello."}):
+    for event in ws.create({"model": "gpt-5.5", "input": "Say hello."}):
         if event.get("type") == "response.output_text.delta":
             print(event.get("delta", ""), end="")
 ```
@@ -168,7 +169,7 @@ print(client.responses.create(input=history).output_text)
 
 ```python
 compacted = client.responses.compact(
-    model="gpt-5.4",
+    model="gpt-5.5",
     instructions="Preserve task-critical decisions and unresolved work.",
     input=history,
 )
@@ -239,7 +240,7 @@ print(result.output_parsed)
 for model in client.models.list():
     print(model.id, model.context_window, model.supported_reasoning_levels)
 
-model = client.models.retrieve("gpt-5.4")
+model = client.models.retrieve("gpt-5.5")
 ```
 
 ### Upload a file
@@ -311,6 +312,10 @@ sports, and time commands. See the API reference for command validation.
 quota = client.codex.usage()
 daily = client.codex.usage_details.daily_token_breakdown()
 credits = client.codex.usage_details.credit_events()
+plugin_metrics = client.codex.usage_details.plugin_usage_metrics(
+    start_date="2026-09-01",
+    end_date="2026-09-18",
+)
 
 print(quota.get("rate_limit", {}).get("primary_window"))
 ```
@@ -414,6 +419,7 @@ tool annotations and own user confirmation; the SDK never auto-invokes tools.
 plugins = client.chatgpt.plugins.list_all(scope="GLOBAL")
 installed = client.chatgpt.plugins.installed_all()
 suggested = client.chatgpt.plugins.suggested()
+home = client.chatgpt.plugins.home()
 skill = client.chatgpt.plugins.skill("plugins~...", "skill-name")
 
 checkout = client.chatgpt.plugins.bundles.extract_plugin(
@@ -462,33 +468,42 @@ return a typed in-memory object, bytes, `BytesIO`, a data URI, or a file path.
 ### Realtime voice
 
 ```python
-answer = client.realtime.calls.create_v3(
-    sdp=offer_sdp,
+live = client.live.create(
     session={
         "model": "gpt-live-1-codex",
         "instructions": "Speak naturally and stay concise.",
+        "delegation": {"type": "client"},
     },
+    transport={"type": "webrtc", "sdp": offer_sdp},
 )
-print(answer.answer_sdp)
+apply_remote_sdp(live.transport.sdp)
+
+with client.live.sideband.connect(session_id=live.session.id) as sideband:
+    for event in sideband:
+        print(event.type)
 ```
 
 Live probes confirmed `gpt-live-1-codex` and
 `gpt-live-1-boulder-alpha`. They are Codex Realtime v3 snapshots, not aliases
-for the public `gpt-realtime` family. The call response exposes `call_id`; join
-its OAuth-authenticated control and delegation channel with:
+for the public `gpt-live-1` model. `client.live` follows the current
+`openai-python` creation, response, and sideband idioms while adapting them to
+the ChatGPT OAuth call transport.
+
+The earlier low-level surface remains available for backend-specific code:
 
 ```python
-sideband = client.realtime.sideband.connect(
-    call_id=answer.call_id,
-    session_id="voice-session",
+answer = client.realtime.calls.create_v3(
+    sdp=offer_sdp,
+    session={"model": "gpt-live-1-codex"},
 )
-sideband.send({"type": "delegation.context.append", "content": []})
-event = sideband.recv()
-sideband.close()
+with client.realtime.sideband.connect(call_id=answer.call_id) as sideband:
+    sideband.send({"type": "session.close"})
 ```
 
-The SDK intentionally exposes only the ChatGPT-authenticated v3 transport. It
-does not retain the separately billed API-key Voice v2 WebSocket helpers.
+The OAuth backend's event dialect is still experimental and is exposed
+forward-compatibly through `LiveEvent` rather than rewritten into invented
+public fields. The public primary `client.live.connect()` WebSocket is not
+available through ChatGPT OAuth; use WebRTC plus the attached sideband.
 
 ### Embeddings
 

{codex_backend_sdk-0.5.2 → codex_backend_sdk-0.5.3}/codex_backend_sdk/__init__.py

@@ -17,7 +17,7 @@ Quickstart:
     print(response.output_text)
 """
 
-__version__ = "0.5.2"
+__version__ = "0.5.3"
 
 from .oauth import (
     DeviceCode,
@@ -57,6 +57,10 @@ from .codex_client import (
     Image,
     ImageResponse,
     ImagesResponse,
+    LiveCreateResponse,
+    LiveEvent,
+    LiveSession,
+    LiveTransport,
     RateLimitResetCredit,
     RateLimitResetCredits,
     ConsumeRateLimitResetCreditResponse,
@@ -102,6 +106,10 @@ __all__ = [
     "Image",
     "ImageResponse",
     "ImagesResponse",
+    "LiveCreateResponse",
+    "LiveEvent",
+    "LiveSession",
+    "LiveTransport",
     "RateLimitResetCredit",
     "RateLimitResetCredits",
     "ConsumeRateLimitResetCreditResponse",

{codex_backend_sdk-0.5.2 → codex_backend_sdk-0.5.3}/codex_backend_sdk/_client.py

@@ -30,7 +30,7 @@ class CodexClient:
         self,
         *,
         store: Optional[TokenStore] = None,
-        model: str = "gpt-5.4",
+        model: str = "gpt-5.5",
         instructions: Optional[str] = None,
         timeout: float = 120,
         max_retries: int = 2,
@@ -44,7 +44,7 @@ class CodexClient:
         from .resources.openai_oauth import Audio, Embeddings
         from .resources.files import Files
         from .resources.images import Images
-        from .resources.realtime import Realtime
+        from .resources.realtime import Live, Realtime
         from .resources.responses import Responses
 
         self._store = store
@@ -66,6 +66,7 @@ class CodexClient:
         self.responses = Responses(self)
         self.models = Models(self)
         self.realtime = Realtime(self)
+        self.live = Live(self)
         self.embeddings = Embeddings(self)
         self.audio = Audio(self)
         self.images = Images(self)

{codex_backend_sdk-0.5.2 → codex_backend_sdk-0.5.3}/codex_backend_sdk/_models.py

@@ -435,6 +435,32 @@ class RealtimeCallResponse(BinaryResponseContent):
         )
 
 
+class LiveSession(CodexBaseModel):
+    """Resolved Live session identity returned by the OAuth adapter."""
+
+    id: str
+
+
+class LiveTransport(CodexBaseModel):
+    """WebRTC answer using the public OpenAI Live response shape."""
+
+    type: Literal["webrtc"] = "webrtc"
+    sdp: str
+
+
+class LiveCreateResponse(CodexBaseModel):
+    """OpenAI-compatible view of a Codex OAuth Realtime call response."""
+
+    session: LiveSession
+    transport: LiveTransport
+
+
+class LiveEvent(CodexBaseModel):
+    """Forward-compatible Live sideband event with attribute access."""
+
+    type: str
+
+
 def _is_uuid(value: str) -> bool:
     if len(value) != 36:
         return False

{codex_backend_sdk-0.5.2 → codex_backend_sdk-0.5.3}/codex_backend_sdk/codex_client.py

@@ -18,6 +18,10 @@ from ._models import (
     ImageData,
     ImageResponse,
     ImagesResponse,
+    LiveCreateResponse,
+    LiveEvent,
+    LiveSession,
+    LiveTransport,
     Model,
     MemorySummarizeOutput,
     MemorySummarizeResponse,
@@ -55,6 +59,10 @@ __all__ = [
     "ImageData",
     "ImageResponse",
     "ImagesResponse",
+    "LiveCreateResponse",
+    "LiveEvent",
+    "LiveSession",
+    "LiveTransport",
     "CompactedResponse",
     "MemorySummarizeOutput",
     "MemorySummarizeResponse",

{codex_backend_sdk-0.5.2 → codex_backend_sdk-0.5.3}/codex_backend_sdk/resources/chatgpt_plugins.py

@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-from typing import Any, Literal, TYPE_CHECKING
+from typing import TYPE_CHECKING, Any, Literal
 from urllib.parse import quote
 
 if TYPE_CHECKING:
@@ -23,13 +23,18 @@ class ChatGPTPlugins:
         payload = self._client._get_chatgpt(
             "/plugins/featured", params={"platform": platform}
         )
-        if not isinstance(payload, list) or not all(isinstance(item, str) for item in payload):
+        if not isinstance(payload, list) or not all(
+            isinstance(item, str) for item in payload
+        ):
             raise RuntimeError("Featured plugins returned an invalid plugin-id list.")
         return payload
 
     def curated_export(self) -> dict[str, Any]:
         payload = self._client._get_chatgpt("/plugins/export/curated")
-        if not isinstance(payload.get("download_url"), str) or not payload["download_url"]:
+        if (
+            not isinstance(payload.get("download_url"), str)
+            or not payload["download_url"]
+        ):
             raise RuntimeError("Curated plugin export is missing its download URL.")
         return payload
 
@@ -46,8 +51,16 @@ class ChatGPTPlugins:
             params={
                 "scope": _scope(scope),
                 "limit": _positive(limit, "limit"),
-                **({} if collection is None else {"collection": _required(collection, "collection")}),
-                **({} if page_token is None else {"pageToken": _required(page_token, "page_token")}),
+                **(
+                    {}
+                    if collection is None
+                    else {"collection": _required(collection, "collection")}
+                ),
+                **(
+                    {}
+                    if page_token is None
+                    else {"pageToken": _required(page_token, "page_token")}
+                ),
             },
         )
 
@@ -77,7 +90,11 @@ class ChatGPTPlugins:
                 "q": _required(query, "query"),
                 "limit": _positive(limit, "limit"),
                 **({} if scope is None else {"scope": _scope(scope)}),
-                **({} if page_token is None else {"pageToken": _required(page_token, "page_token")}),
+                **(
+                    {}
+                    if page_token is None
+                    else {"pageToken": _required(page_token, "page_token")}
+                ),
             },
         )
 
@@ -124,22 +141,35 @@ class ChatGPTPlugins:
             "/ps/plugins/workspace/shared",
             params={
                 "limit": _positive(limit, "limit"),
-                **({} if page_token is None else {"pageToken": _required(page_token, "page_token")}),
+                **(
+                    {}
+                    if page_token is None
+                    else {"pageToken": _required(page_token, "page_token")}
+                ),
             },
         )
 
+    def home(self) -> dict[str, Any]:
+        """Return the curated plugin home sections used by current Desktop."""
+        payload = self._client._get_chatgpt("/ps/plugins/home", headers=_headers())
+        if not isinstance(payload.get("sections"), list):
+            raise TypeError("Plugin home response contains invalid sections.")
+        return payload
+
     def suggested(
         self,
         *,
         scope: Literal["GLOBAL", "USER", "WORKSPACE"] = "GLOBAL",
     ) -> dict[str, Any]:
         payload = self._client._get_chatgpt(
-            "/ps/plugins/suggested",
+            "/ps/plugins/suggested/codex",
             params={"scope": _scope(scope)},
             headers=_headers(),
         )
         if not isinstance(payload.get("plugins"), list):
-            raise RuntimeError("Suggested plugins response contains an invalid plugin list.")
+            raise RuntimeError(
+                "Suggested plugins response contains an invalid plugin list."
+            )
         return payload
 
     def retrieve(
@@ -150,9 +180,7 @@ class ChatGPTPlugins:
     ) -> dict[str, Any]:
         payload = self._client._get_chatgpt(
             f"/ps/plugins/{_path(plugin_id, 'plugin_id')}",
-            params=(
-                {"includeDownloadUrls": True} if include_download_urls else None
-            ),
+            params=({"includeDownloadUrls": True} if include_download_urls else None),
             headers=_headers(),
         )
         if not isinstance(payload.get("id"), str):
@@ -170,12 +198,18 @@ class ChatGPTPlugins:
             headers=_headers(),
         )
         if payload.get("plugin_id") != expected_id:
-            raise RuntimeError("Plugin skill response returned an unexpected plugin ID.")
+            raise RuntimeError(
+                "Plugin skill response returned an unexpected plugin ID."
+            )
         if payload.get("name") != expected_name:
-            raise RuntimeError("Plugin skill response returned an unexpected skill name.")
+            raise RuntimeError(
+                "Plugin skill response returned an unexpected skill name."
+            )
         contents = payload.get("skill_md_contents")
         if contents is not None and not isinstance(contents, str):
-            raise RuntimeError("Plugin skill response returned invalid Markdown contents.")
+            raise RuntimeError(
+                "Plugin skill response returned invalid Markdown contents."
+            )
         return payload
 
     def _page(self, path: str, *, params: dict[str, Any]) -> dict[str, Any]:
@@ -195,9 +229,13 @@ class ChatGPTPlugins:
             if token_value is None:
                 return plugins
             if not isinstance(token_value, str) or not token_value:
-                raise RuntimeError("Plugin catalog returned an invalid next page token.")
+                raise RuntimeError(
+                    "Plugin catalog returned an invalid next page token."
+                )
             if token_value in seen:
-                raise RuntimeError("Plugin catalog returned a repeated next page token.")
+                raise RuntimeError(
+                    "Plugin catalog returned a repeated next page token."
+                )
             seen.add(token_value)
             token = token_value
 
@@ -224,6 +262,46 @@ class ChatGPTPluginInstallation:
     def uninstall(self, plugin_id: str) -> dict[str, Any]:
         return self._mutate(plugin_id, "uninstall", expected_enabled=False)
 
+    def enable(self, plugin_id: str) -> dict[str, Any]:
+        return self._set_enabled(plugin_id, "enable")
+
+    def disable(self, plugin_id: str) -> dict[str, Any]:
+        return self._set_enabled(plugin_id, "disable")
+
+    def enable_skill(self, plugin_id: str, skill_name: str) -> dict[str, Any]:
+        return self._set_skill_enabled(plugin_id, skill_name, "enable")
+
+    def disable_skill(self, plugin_id: str, skill_name: str) -> dict[str, Any]:
+        return self._set_skill_enabled(plugin_id, skill_name, "disable")
+
+    def _set_enabled(self, plugin_id: str, action: str) -> dict[str, Any]:
+        expected_id = _required(plugin_id, "plugin_id")
+        payload = self._client._request_chatgpt(
+            "POST",
+            f"/ps/plugins/{_path(expected_id, 'plugin_id')}/{action}",
+            headers=_headers(),
+        ).json()
+        if not isinstance(payload, dict):
+            raise TypeError("Plugin state mutation returned an invalid response.")
+        return payload
+
+    def _set_skill_enabled(
+        self, plugin_id: str, skill_name: str, action: str
+    ) -> dict[str, Any]:
+        expected_id = _required(plugin_id, "plugin_id")
+        expected_name = _required(skill_name, "skill_name")
+        payload = self._client._request_chatgpt(
+            "POST",
+            (
+                f"/ps/plugins/{_path(expected_id, 'plugin_id')}/skills/"
+                f"{_path(expected_name, 'skill_name')}/{action}"
+            ),
+            headers=_headers(),
+        ).json()
+        if not isinstance(payload, dict):
+            raise TypeError("Plugin skill mutation returned an invalid response.")
+        return payload
+
     def _mutate(
         self,
         plugin_id: str,
@@ -252,7 +330,9 @@ def _headers() -> dict[str, str]:
 
 def _required(value: str, name: str) -> str:
     if not value:
-        raise ValueError(f"Expected a non-empty value for `{name}` but received {value!r}")
+        raise ValueError(
+            f"Expected a non-empty value for `{name}` but received {value!r}"
+        )
     return value
 
 
@@ -275,7 +355,9 @@ def _path(value: str, name: str) -> str:
 def _validate_page(payload: dict[str, Any]) -> None:
     plugins = payload.get("plugins")
     pagination = payload.get("pagination")
-    if not isinstance(plugins, list) or not all(isinstance(item, dict) for item in plugins):
+    if not isinstance(plugins, list) or not all(
+        isinstance(item, dict) for item in plugins
+    ):
         raise RuntimeError("Plugin catalog response contains an invalid plugin list.")
     if not isinstance(pagination, dict):
         raise RuntimeError("Plugin catalog response contains invalid pagination.")