prefect-client 3.8.9.dev1__tar.gz → 3.8.9.dev2__tar.gz

{prefect_client-3.8.9.dev1 → prefect_client-3.8.9.dev2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: prefect-client
-Version: 3.8.9.dev1
+Version: 3.8.9.dev2
 Summary: Workflow orchestration and management.
 Project-URL: Changelog, https://github.com/PrefectHQ/prefect/releases
 Project-URL: Documentation, https://docs.prefect.io

prefect_client-3.8.9.dev2/src/prefect/_build_info.py

@@ -0,0 +1,5 @@
+# Generated by versioningit
+__version__ = "3.8.9.dev2"
+__build_date__ = "2026-10-10 08:18:57.182238+00:00"
+__git_commit__ = "e9bc08239af12f2bbfccab7a8e15b9f0a0ec6865"
+__dirty__ = False

{prefect_client-3.8.9.dev1 → prefect_client-3.8.9.dev2}/src/prefect/_internal/server_maintenance.py

@@ -39,6 +39,18 @@ def maintenance_backoff_ends_at() -> datetime.datetime | None:
         return _backoff_ends_at
 
 
+def polling_window_start(last_polled: datetime.datetime) -> datetime.datetime:
+    """
+    When the polling window of a process that last polled at `last_polled`
+    starts: the later of `last_polled` and the end of the latest maintenance
+    back-off, since a poll cannot complete while it waits out maintenance.
+    """
+    backoff_ends_at = maintenance_backoff_ends_at()
+    if backoff_ends_at is not None and backoff_ends_at > last_polled:
+        return backoff_ends_at
+    return last_polled
+
+
 def reset_maintenance_backoff() -> None:
     """Forget any recorded maintenance back-off (for tests)."""
     global _backoff_ends_at

{prefect_client-3.8.9.dev1 → prefect_client-3.8.9.dev2}/src/prefect/deployments/base.py

@@ -47,6 +47,12 @@ def create_default_prefect_yaml(
 
     import prefect
 
+    if name is None:
+        name = path.resolve().name
+
+    if contents is None:
+        contents = {}
+
     contents["prefect-version"] = prefect.__version__
     contents["name"] = name
 

{prefect_client-3.8.9.dev1 → prefect_client-3.8.9.dev2}/src/prefect/runner/AGENTS.md

@@ -47,6 +47,10 @@ Thin facade over single-responsibility extracted classes. New behavior belongs i
 
 These will be removed once internal callers are migrated. Direct ProcessWorker flow runs already use `FlowRunExecutorContext`; generated commands use `WorkspaceResolvingEngineCommandStarter`, while explicitly configured commands use `EngineCommandStarter`. Only the ad hoc bundle path still calls deprecated `Runner.execute_bundle()`. Keep lifecycle behavior in the extracted classes and do not route direct worker execution back through Runner.
 
+## Webserver Health Check
+
+The health check must not count a maintenance wait as a missed poll. Requests answered with `Prefect-Maintenance: true` retry indefinitely, so a poll can block for an entire Cloud maintenance window. `perform_health_check()` in `server.py` measures from `polling_window_start()` (`prefect._internal.server_maintenance`), the same rule the worker health check uses. `last_polled` is `None` until the first poll completes, so the health check measures from its own creation until then.
+
 ## EventEmitter WebSocket Degradation
 
 `EventEmitter.__aenter__` catches connection failures and silently swaps the failed client for a `NullEventsClient` — events are non-critical telemetry (the runner emits only `prefect.runner.cancelled-flow-run`), so the flow run must not crash when the events WebSocket is unreachable. Two failure classes are caught (`_NONFATAL_CONNECTION_EXCEPTIONS`): permanent rejections (`websockets.exceptions.InvalidStatus`, i.e. HTTP 4xx — e.g. a client ≤3.6.13 connecting to a server ≥3.6.14 with `PREFECT_SERVER_API_AUTH_STRING` configured) and transient failures (`RETRYABLE_EXCEPTIONS` from `events/clients.py`: `ConnectionClosed`, `TimeoutError`, `OSError`) that outlive the events client's own reconnection attempts. A `WARNING` is logged. If `__aenter__` raises, `__aexit__` is **not** called on the original client (it was never successfully entered); the replacement `NullEventsClient` is entered instead.

{prefect_client-3.8.9.dev1 → prefect_client-3.8.9.dev2}/src/prefect/runner/server.py

@@ -8,6 +8,7 @@ from fastapi import APIRouter, FastAPI, status
 from fastapi.responses import JSONResponse
 from typing_extensions import Literal
 
+from prefect._internal.server_maintenance import polling_window_start
 from prefect.logging import get_logger
 from prefect.settings import (
     PREFECT_RUNNER_POLL_FREQUENCY,
@@ -46,9 +47,13 @@ def perform_health_check(
             * PREFECT_RUNNER_POLL_FREQUENCY.value()
         )
 
+    # Until the first poll completes, measure from when the health check
+    # started: startup and the first poll may be waiting out API maintenance.
+    started_at = now_fn("UTC")
+
     def _health_check():
-        now = now_fn("UTC")
-        poll_delay = (now - runner.last_polled).total_seconds()
+        last_polled = runner.last_polled or started_at
+        poll_delay = (now_fn("UTC") - polling_window_start(last_polled)).total_seconds()
 
         if TYPE_CHECKING:
             assert delay_threshold is not None

{prefect_client-3.8.9.dev1 → prefect_client-3.8.9.dev2}/src/prefect/workers/base.py

@@ -38,7 +38,7 @@ from prefect._internal.infrastructure_exit_codes import get_infrastructure_exit_
 from prefect._internal.launchers import resolve_bundle_step_with_launcher
 from prefect._internal.observers import FlowRunCancellingObserver
 from prefect._internal.schemas.validators import return_v_or_none
-from prefect._internal.server_maintenance import maintenance_backoff_ends_at
+from prefect._internal.server_maintenance import polling_window_start
 from prefect.client.orchestration import PrefectClient, get_client
 from prefect.client.schemas.objects import Flow as APIFlow
 from prefect.client.schemas.objects import (
@@ -137,13 +137,8 @@ def _is_within_polling_window(
     it sends, so the window counts from the later of `last_polled_time` and the
     end of the latest maintenance back-off.
     """
-    window_start = last_polled_time
-    backoff_ends_at = maintenance_backoff_ends_at()
-    if backoff_ends_at is not None and backoff_ends_at > window_start:
-        window_start = backoff_ends_at
-
     seconds_since_window_start = (
-        prefect.types._datetime.now("UTC") - window_start
+        prefect.types._datetime.now("UTC") - polling_window_start(last_polled_time)
     ).total_seconds()
     return seconds_since_window_start <= query_interval_seconds * 30
 
@@ -1548,6 +1543,14 @@ class BaseWorker(abc.ABC, Generic[C, V, R]):
                     " in progress."
                 )
                 break
+            except RuntimeError as exc:
+                if "already holding" not in str(exc):
+                    raise
+                self._logger.warning(
+                    f"Duplicate submission of flow run '{flow_run.id}' detected. Worker"
+                    " will not re-submit flow run."
+                )
+                continue
             else:
                 run_logger = self.get_flow_run_logger(flow_run)
                 run_logger.info(

prefect_client-3.8.9.dev1/src/prefect/_build_info.py

@@ -1,5 +0,0 @@
-# Generated by versioningit
-__version__ = "3.8.9.dev1"
-__build_date__ = "2026-10-07 08:22:05.387495+00:00"
-__git_commit__ = "6c7fefcb8729546e9a7b5b63e310669370348106"
-__dirty__ = False