v1.8.9 — verbose ERROR log when Server error retries exhausted

Author: TimmekHW

CHANGELOG.md

@@ -5,6 +5,11 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/),
 and this project adheres to [Semantic Versioning](https://semver.org/).
 
+## [1.8.9] - 2026-03-05
+
+### Improved
+- After all retry attempts exhausted on `"Server error"`, an **ERROR**-level log is now emitted with method name, attempt count, error description, and request params (token excluded) — makes debugging server-side failures much easier
+
 ## [1.8.8] - 2026-03-04
 
 ### Fixed

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "vkworkspace"
-version = "1.8.8"
+version = "1.8.9"
 description = "Fully async framework for building VK Teams (VK Workspace) bots, inspired by aiogram 3"
 readme = "README.md"
 license = { text = "MIT" }

vkworkspace/__meta__.py

@@ -1,2 +1,2 @@
-__version__ = "1.8.8"
+__version__ = "1.8.9"
 __api_version__ = "v1"

vkworkspace/client/bot.py

@@ -212,18 +212,27 @@ async def _request(
                     description = data.get("description", "Unknown error")
                     err = VKTeamsAPIError(method=endpoint, message=description)
                     # "Server error: id=0x..." = server-side crash, retry like 5xx
-                    if description.startswith("Server error") and attempt < max_attempts - 1:
-                        last_exc = err
-                        delay = min(2**attempt, 8)
-                        logger.warning(
-                            "Server error from %s (attempt %d/%d), retrying in %ds...",
+                    if description.startswith("Server error"):
+                        if attempt < max_attempts - 1:
+                            last_exc = err
+                            delay = min(2**attempt, 8)
+                            logger.warning(
+                                "Server error from %s (attempt %d/%d), retrying in %ds...",
+                                endpoint,
+                                attempt + 1,
+                                max_attempts,
+                                delay,
+                            )
+                            await asyncio.sleep(delay)
+                            continue
+                        logger.error(
+                            "Server error from %s persisted after %d attempts: %s "
+                            "(params: %s)",
                             endpoint,
-                            attempt + 1,
                             max_attempts,
-                            delay,
+                            description,
+                            {k: v for k, v in params.items() if k != "token"},
                         )
-                        await asyncio.sleep(delay)
-                        continue
                     raise err
                 return data
             except httpx.HTTPStatusError as exc: