prefect-client 3.8.9.dev7__tar.gz → 3.9.1.dev1__tar.gz

{prefect_client-3.8.9.dev7 → prefect_client-3.9.1.dev1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: prefect-client
-Version: 3.8.9.dev7
+Version: 3.9.1.dev1
 Summary: Workflow orchestration and management.
 Project-URL: Changelog, https://github.com/PrefectHQ/prefect/releases
 Project-URL: Documentation, https://docs.prefect.io
@@ -18,17 +18,19 @@ Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3.15
 Classifier: Topic :: Software Development :: Libraries
-Requires-Python: <3.15,>=3.11
+Requires-Python: <3.16,>=3.11
 Requires-Dist: amplitude-analytics<2.0.0,>=1.2.1
 Requires-Dist: anyio<5.0.0,>=4.4.0
 Requires-Dist: asgi-lifespan<3.0,>=1.0
 Requires-Dist: cachetools<8.0,>=5.3
+Requires-Dist: certifi>=2026.10.19
 Requires-Dist: cloudpickle<4.0,>=2.0
 Requires-Dist: coolname<6.0.0,>=1.0.4
 Requires-Dist: dateparser<2.0.0,>=1.1.1
 Requires-Dist: exceptiongroup>=1.0.0
-Requires-Dist: fastapi<1.0.0,>=0.139.0
+Requires-Dist: fastapi<0.151,>=0.139.0
 Requires-Dist: fsspec>=2022.5.0
 Requires-Dist: graphviz>=0.20.1
 Requires-Dist: griffe<3.0.0,>=0.49.0
@@ -53,15 +55,14 @@ Requires-Dist: pytz<2027,>=2021.1
 Requires-Dist: pyyaml<7.0.0,>=5.4.1
 Requires-Dist: rfc3339-validator<0.2.0,>=0.1.4
 Requires-Dist: rich<16.0,>=11.0
-Requires-Dist: ruamel-yaml-clib>=0.2.8; platform_python_implementation == 'CPython'
-Requires-Dist: ruamel-yaml>=0.17.0
+Requires-Dist: ruamel-yaml!=0.19.0,>=0.17.0
 Requires-Dist: sniffio<2.0.0,>=1.3.0
 Requires-Dist: starlette>=1.0.1
 Requires-Dist: toml>=0.10.0
 Requires-Dist: typing-extensions<5.0.0,>=4.10.0
 Requires-Dist: uvicorn!=0.29.0,>=0.14.0
 Requires-Dist: websockets<17.0,>=15.0.1
-Requires-Dist: whenever<0.11.0,>=0.7.3; python_version >= '3.13'
+Requires-Dist: whenever<0.11.0,>=0.10.5; python_version >= '3.13'
 Provides-Extra: notifications
 Requires-Dist: apprise<2.0.0,>=1.13.0; extra == 'notifications'
 Description-Content-Type: text/markdown

{prefect_client-3.8.9.dev7 → prefect_client-3.9.1.dev1}/pyproject.toml

@@ -7,7 +7,7 @@ name = "prefect-client"
 dynamic = ["version"]
 description = "Workflow orchestration and management."
 readme = "README.md"
-requires-python = ">=3.11,<3.15"
+requires-python = ">=3.11,<3.16"
 license = { text = "Apache-2.0" }
 authors = [{ name = "Prefect Technologies, Inc.", email = "help@prefect.io" }]
 classifiers = [
@@ -20,6 +20,7 @@ classifiers = [
     "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
     "Programming Language :: Python :: 3.14",
+    "Programming Language :: Python :: 3.15",
     "Topic :: Software Development :: Libraries",
 ]
 dependencies = [
@@ -28,11 +29,13 @@ dependencies = [
     "anyio>=4.4.0,<5.0.0",
     "asgi-lifespan>=1.0,<3.0",
     "cachetools>=5.3,<8.0",
+    "certifi>=2026.10.19",
     "cloudpickle>=2.0,<4.0",
     "coolname>=1.0.4,<6.0.0",
     "dateparser>=1.1.1,<2.0.0",
     "exceptiongroup>=1.0.0",
-    "fastapi>=0.139.0,<1.0.0",
+    # 0.151 rejects an explicit null for a body param with a default, and released clients send null
+    "fastapi>=0.139.0,<0.151",
     "fsspec>=2022.5.0",
     "graphviz>=0.20.1",
     "griffe>=0.49.0,<3.0.0",
@@ -57,15 +60,14 @@ dependencies = [
     "pyyaml>=5.4.1,<7.0.0",
     "rfc3339-validator>=0.1.4,<0.2.0",
     "rich>=11.0,<16.0",
-    "ruamel.yaml>=0.17.0",
-    "ruamel.yaml.clib>=0.2.8; platform_python_implementation == 'CPython'",
+    "ruamel.yaml>=0.17.0,!=0.19.0",
     "sniffio>=1.3.0,<2.0.0",
     "starlette>=1.0.1",
     "toml>=0.10.0",
     "typing_extensions>=4.10.0,<5.0.0",
     "uvicorn>=0.14.0,!=0.29.0",
     "websockets>=15.0.1,<17.0",
-    "whenever>=0.7.3,<0.11.0; python_version>='3.13'",
+    "whenever>=0.10.5,<0.11.0; python_version>='3.13'",
 ]
 [project.urls]
 Changelog = "https://github.com/PrefectHQ/prefect/releases"

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

@@ -0,0 +1,5 @@
+# Generated by versioningit
+__version__ = "3.9.1.dev1"
+__build_date__ = "2026-10-22 08:19:36.634713+00:00"
+__git_commit__ = "7d1688ff034a89a47c900c0e2951c78ff1979f0d"
+__dirty__ = False

{prefect_client-3.8.9.dev7 → prefect_client-3.9.1.dev1}/src/prefect/_internal/compatibility/deprecated.py

@@ -21,7 +21,7 @@ from typing import TYPE_CHECKING, Any, Callable, Optional, Union
 from pydantic import BaseModel
 from typing_extensions import ParamSpec, TypeAlias, TypeVar
 
-from prefect.types._datetime import now
+from prefect.types._datetime import _pendulum_call, now
 from prefect.utilities.callables import get_call_parameters
 from prefect.utilities.importtools import (
     AliasedModuleDefinition,
@@ -96,14 +96,16 @@ def generate_deprecation_message(
                 if hasattr(PlainDateTime, "to_stdlib")
                 else PlainDateTime.from_py_datetime
             )
-            _dt = _pdt_from_dt(start_date).add(months=6)
+            # PlainDateTime requires a naive datetime; the warning only renders
+            # month and year, so any tzinfo on start_date is dropped.
+            _dt = _pdt_from_dt(start_date.replace(tzinfo=None)).add(months=6)
             end_date = (
                 _dt.to_stdlib() if hasattr(_dt, "to_stdlib") else _dt.py_datetime()
             )
         else:
             import pendulum
 
-            end_date = pendulum.instance(start_date).add(months=6)
+            end_date = _pendulum_call(pendulum.instance(start_date), "add", months=6)
 
     if when:
         when = " when " + when

{prefect_client-3.8.9.dev7 → prefect_client-3.9.1.dev1}/src/prefect/_internal/concurrency/services.py

@@ -27,6 +27,11 @@ R = TypeVar("R", infer_variance=True)
 # Track all active services for fork handling
 _active_services: weakref.WeakSet[_QueueServiceBase[Any]] = weakref.WeakSet()
 
+# Services take items that are already queued without leaving the event loop.
+# Other services share the global loop, so a service working through a backlog
+# yields to them after this many items in a row.
+_READY_ITEMS_PER_YIELD = 256
+
 
 def _reset_services_after_fork():
     """
@@ -73,6 +78,7 @@ class _QueueServiceBase(abc.ABC, Generic[T]):
         self._started: bool = False
         self._key = hash((self.__class__, *args))
         self._lock = threading.Lock()
+        self._ready_items_since_yield = 0
         self._queue_get_thread = WorkerThread(
             # TODO: This thread should not need to be a daemon but when it is not, it
             #       can prevent the interpreter from exiting.
@@ -184,14 +190,37 @@ class _QueueServiceBase(abc.ABC, Generic[T]):
             assert self._done_event is not None
             self._done_event.set()
 
+    async def _get_item(self, timeout: Optional[float] = None) -> Optional[T]:
+        """
+        Take the next item from the queue.
+
+        An item that is already queued is taken on the event loop. Only an empty
+        queue waits on the queue thread, which raises `queue.Empty` if `timeout`
+        passes first.
+        """
+        if self._ready_items_since_yield >= _READY_ITEMS_PER_YIELD:
+            self._ready_items_since_yield = 0
+            await asyncio.sleep(0)
+
+        try:
+            item = self._queue.get_nowait()
+        except queue.Empty:
+            pass
+        else:
+            self._ready_items_since_yield += 1
+            return item
+
+        self._ready_items_since_yield = 0
+        return await self._queue_get_thread.submit(
+            create_call(self._queue.get, timeout=timeout)
+        ).aresult()
+
     async def _main_loop(self) -> None:
         last_log_time = 0
         log_interval = 4  # log every 4 seconds
 
         while True:
-            item: Optional[T] = await self._queue_get_thread.submit(
-                create_call(self._queue.get)
-            ).aresult()
+            item: Optional[T] = await self._get_item()
 
             if self._stopped:
                 current_time = asyncio.get_event_loop().time()
@@ -500,9 +529,7 @@ class BatchedQueueService(QueueService[T]):
             deadline = get_deadline(self.min_interval)
             while batch_size < self.max_batch_size:
                 try:
-                    item = await self._queue_get_thread.submit(
-                        create_call(self._queue.get, timeout=get_timeout(deadline))
-                    ).aresult()
+                    item = await self._get_item(timeout=get_timeout(deadline))
 
                     if item is None:
                         done = True

{prefect_client-3.8.9.dev7 → prefect_client-3.9.1.dev1}/src/prefect/deployments/runner.py

@@ -35,6 +35,8 @@ import importlib
 import os
 import sys
 import tempfile
+import warnings
+from contextlib import suppress
 from datetime import datetime, timedelta
 from pathlib import Path
 from typing import (
@@ -103,6 +105,7 @@ from prefect.schedules import Schedule
 from prefect.settings import (
     PREFECT_DEPLOYMENTS_DEFAULT_WORK_POOL_NAME,
     PREFECT_UI_URL,
+    get_current_settings,
 )
 from prefect.types import ListOfNonEmptyStrings
 from prefect.types.entrypoint import EntrypointType
@@ -125,6 +128,25 @@ if TYPE_CHECKING:
 
 __all__ = ["RunnerDeployment"]
 
+
+def _should_clear_empty_schedules() -> bool:
+    if get_current_settings().deployments.clear_schedules_on_empty:
+        return True
+
+    warnings.warn(
+        "Preserving existing schedules when an empty schedules list is provided "
+        "on redeployment is deprecated. A future release will clear schedules "
+        "by default after at least six months or three minor releases, whichever "
+        "is longer. The opt-in setting and this warning will then be removed. "
+        "Set PREFECT_DEPLOYMENTS_CLEAR_SCHEDULES_ON_EMPTY=true to opt in now. "
+        "To preserve existing schedules, omit schedules or use schedules=None "
+        "(schedules: null in prefect.yaml).",
+        FutureWarning,
+        stacklevel=3,
+    )
+    return False
+
+
 _DEPLOYMENT_PARAMETER_SERIALIZER = TypeAdapter(
     dict[str, Any],
     config=ConfigDict(ser_json_timedelta="float"),
@@ -617,15 +639,21 @@ class RunnerDeployment(BaseModel):
         deployment_id: UUID,
         client: PrefectClient,
         version_info: VersionInfo | None,
+        *,
+        preserve_schedules: bool = False,
     ):
         parameter_openapi_schema = self._parameter_openapi_schema.model_dump(
             exclude_unset=True
         )
 
+        exclude = {"storage", "name", "flow_name", "triggers", "version_type"}
+        if preserve_schedules:
+            # Explicitly set schedules survive exclude_unset, even when empty.
+            exclude.add("schedules")
         update_payload = self.model_dump(
             mode="json",
             exclude_unset=True,
-            exclude={"storage", "name", "flow_name", "triggers", "version_type"},
+            exclude=exclude,
         )
 
         if self.storage:
@@ -636,7 +664,7 @@ class RunnerDeployment(BaseModel):
         else:
             update_payload["pull_steps"] = None
 
-        if self.schedules:
+        if self.schedules and not preserve_schedules:
             update_payload["schedules"] = [
                 schedule.model_dump(mode="json", exclude_unset=True)
                 for schedule in self._schedules_with_serialized_block_parameters() or []
@@ -669,15 +697,21 @@ class RunnerDeployment(BaseModel):
         deployment_id: UUID,
         client: SyncPrefectClient,
         version_info: VersionInfo | None,
+        *,
+        preserve_schedules: bool = False,
     ):
         parameter_openapi_schema = self._parameter_openapi_schema.model_dump(
             exclude_unset=True
         )
 
+        exclude = {"storage", "name", "flow_name", "triggers", "version_type"}
+        if preserve_schedules:
+            # Keep schedule exclusion in sync with _update above.
+            exclude.add("schedules")
         update_payload = self.model_dump(
             mode="json",
             exclude_unset=True,
-            exclude={"storage", "name", "flow_name", "triggers", "version_type"},
+            exclude=exclude,
         )
 
         if self.storage:
@@ -688,7 +722,7 @@ class RunnerDeployment(BaseModel):
         else:
             update_payload["pull_steps"] = None
 
-        if self.schedules:
+        if self.schedules and not preserve_schedules:
             update_payload["schedules"] = [
                 schedule.model_dump(mode="json", exclude_unset=True)
                 for schedule in self._schedules_with_serialized_block_parameters() or []
@@ -756,6 +790,9 @@ class RunnerDeployment(BaseModel):
         Registers this deployment with the API and returns the deployment's ID.
 
         Args:
+            schedules: Override the schedules for this deployment. On redeployment,
+                an empty list preserves schedules by default and emits a warning.
+                Set `PREFECT_DEPLOYMENTS_CLEAR_SCHEDULES_ON_EMPTY=true` to clear them.
             work_pool_name: The name of the work pool to use for this
                 deployment.
             image: The registry, name, and tag of the Docker image to
@@ -784,11 +821,29 @@ class RunnerDeployment(BaseModel):
                     self.job_variables["image"] = image
                 if work_pool_name:
                     self.work_pool_name = work_pool_name
-                if schedules:
+                clear_schedules = schedules == [] and _should_clear_empty_schedules()
+                if schedules or clear_schedules:
                     self.schedules = [
-                        DeploymentScheduleUpdate(**schedule) for schedule in schedules
+                        DeploymentScheduleUpdate(**schedule)
+                        for schedule in schedules or []
                     ]
-                return await self._update(deployment.id, client, version_info)
+                await self._update(
+                    deployment.id,
+                    client,
+                    version_info,
+                    preserve_schedules=schedules == [] and not clear_schedules,
+                )
+                # The update API preserves empty-list updates when all existing
+                # schedules have slugs. Clear those explicitly after a successful update.
+                if clear_schedules and all(
+                    schedule.slug is not None for schedule in deployment.schedules
+                ):
+                    for schedule in deployment.schedules:
+                        with suppress(ObjectNotFound):
+                            await client.delete_deployment_schedule(
+                                deployment.id, schedule.id
+                            )
+                return deployment.id
 
     @async_dispatch(aapply)
     def apply(
@@ -802,6 +857,9 @@ class RunnerDeployment(BaseModel):
         Registers this deployment with the API and returns the deployment's ID.
 
         Args:
+            schedules: Override the schedules for this deployment. On redeployment,
+                an empty list preserves schedules by default and emits a warning.
+                Set `PREFECT_DEPLOYMENTS_CLEAR_SCHEDULES_ON_EMPTY=true` to clear them.
             work_pool_name: The name of the work pool to use for this
                 deployment.
             image: The registry, name, and tag of the Docker image to
@@ -829,11 +887,28 @@ class RunnerDeployment(BaseModel):
                     self.job_variables["image"] = image
                 if work_pool_name:
                     self.work_pool_name = work_pool_name
-                if schedules:
+                clear_schedules = schedules == [] and _should_clear_empty_schedules()
+                if schedules or clear_schedules:
                     self.schedules = [
-                        DeploymentScheduleUpdate(**schedule) for schedule in schedules
+                        DeploymentScheduleUpdate(**schedule)
+                        for schedule in schedules or []
                     ]
-                return self._update_sync(deployment.id, client, version_info)
+                self._update_sync(
+                    deployment.id,
+                    client,
+                    version_info,
+                    preserve_schedules=schedules == [] and not clear_schedules,
+                )
+                # Keep explicit clearing in sync with aapply above.
+                if clear_schedules and all(
+                    schedule.slug is not None for schedule in deployment.schedules
+                ):
+                    for schedule in deployment.schedules:
+                        with suppress(ObjectNotFound):
+                            client.delete_deployment_schedule(
+                                deployment.id, schedule.id
+                            )
+                return deployment.id
 
     async def _create_slas(self, deployment_id: UUID, client: PrefectClient):
         if not isinstance(self._sla, list):

{prefect_client-3.8.9.dev7 → prefect_client-3.9.1.dev1}/src/prefect/events/schemas/automations.py

@@ -31,6 +31,7 @@ from typing_extensions import Self, TypeAlias
 
 from prefect._internal.schemas.bases import PrefectBaseModel
 from prefect.events.actions import ActionTypes, ActionTypesOrUnknown, RunDeployment
+from prefect.types import DurationOrSecondsTimeDelta
 from prefect.utilities.collections import AutoEnum
 
 from .events import ResourceSpecification
@@ -200,9 +201,10 @@ class EventTrigger(ResourceTrigger):
             "triggers)"
         ),
     )
-    within: timedelta = Field(
+    within: DurationOrSecondsTimeDelta = Field(
         default=timedelta(seconds=0),
         ge=timedelta(seconds=0),
+        json_schema_extra={"minimum": 0},
         description=(
             "The time period over which the events must occur.  For Reactive triggers, "
             "this may be as low as 0 seconds, but must be at least 10 seconds for "
@@ -305,16 +307,18 @@ class MetricTriggerQuery(PrefectBaseModel):
             "the query result against the threshold value."
         ),
     )
-    range: timedelta = Field(
+    range: DurationOrSecondsTimeDelta = Field(
         timedelta(seconds=300),  # defaults to 5 minutes
+        json_schema_extra={"minimum": 300},
         description=(
             "The lookback duration (seconds) for a metric query. This duration is "
             "used to determine the time range over which the query will be executed. "
             "The minimum value is 300 seconds (5 minutes)."
         ),
     )
-    firing_for: timedelta = Field(
+    firing_for: DurationOrSecondsTimeDelta = Field(
         timedelta(seconds=300),  # defaults to 5 minutes
+        json_schema_extra={"minimum": 300},
         description=(
             "The duration (seconds) for which the metric query must breach "
             "or resolve continuously before the state is updated and the "
@@ -367,7 +371,7 @@ class CompositeTrigger(Trigger, abc.ABC):
 
     type: Literal["compound", "sequence"]
     triggers: List["TriggerTypes"]
-    within: Optional[timedelta] = Field(
+    within: Optional[DurationOrSecondsTimeDelta] = Field(
         None,
         description=(
             "The time period over which the events must occur.  For Reactive triggers, "

{prefect_client-3.8.9.dev7 → prefect_client-3.9.1.dev1}/src/prefect/logging/AGENTS.md

@@ -41,7 +41,8 @@ Key invariants:
 
 `APILogWorker` is a **singleton per unique settings tuple** `(BATCH_SIZE, API_URL, MAX_LOG_SIZE)`. A new settings combination creates a new worker instance.
 
-- `max_batch_size = max(BATCH_SIZE - MAX_LOG_SIZE, MAX_LOG_SIZE)` — defensive: ensures a single max-size log can always fit
+- `max_batch_size = max(BATCH_SIZE - MAX_LOG_SIZE - 1, 1)` — a batch stops taking logs at this size, which leaves room for one more max-size log and the request body's opening bracket. Requests stay within `BATCH_SIZE` whenever `BATCH_SIZE >= MAX_LOG_SIZE + 2`; below that, each request holds one log.
+- `APILogWorker.send()` serializes each log dict to compact JSON (orjson) right away, dropping the `__payload_size__` key that `prepare()` adds. The queue holds only those bytes, and `_handle_batch` posts them joined, without serializing again. Changes to a dict after `send()` are not sent. Process-pool workers still forward dicts through `_api_log_sink`; the parent serializes them when it calls `send()`.
 - `APILogHandler.prepare()` truncates oversized logs with a buffer; `WorkerAPILogHandler.prepare()` raises `ValueError` instead (no truncation)
 
 **Flush deadlock guard:** `APILogHandler.flush()` detects if called from within an event loop and avoids blocking via `from_sync.call_soon_in_new_thread()`. Do not call `flush()` synchronously from async code without this guard.

{prefect_client-3.8.9.dev7 → prefect_client-3.9.1.dev1}/src/prefect/logging/handlers.py

@@ -1,7 +1,6 @@
 from __future__ import annotations
 
 import inspect
-import json
 import logging
 import sys
 import time
@@ -11,6 +10,7 @@ import warnings
 from contextlib import asynccontextmanager
 from typing import TYPE_CHECKING, Any, Callable, Dict, TextIO, Type, cast
 
+import orjson
 from rich.console import Console
 from rich.highlighter import Highlighter, NullHighlighter
 from rich.theme import Theme
@@ -64,22 +64,51 @@ def emit_api_log(log: Dict[str, Any]) -> None:
     APILogWorker.instance().send(log)
 
 
-class APILogWorker(BatchedQueueService[Dict[str, Any]]):
+class APILogWorker(BatchedQueueService[bytes]):
     @property
     def max_batch_size(self) -> int:
+        # A batch takes logs until it reaches this size, and the last log it takes
+        # can be a maximum size log. Leave room for that log and for the opening
+        # bracket of the request body, so the request fits in the configured
+        # batch size. A batch always takes at least one log.
         return max(
             PREFECT_LOGGING_TO_API_BATCH_SIZE.value()
-            - PREFECT_LOGGING_TO_API_MAX_LOG_SIZE.value(),
-            PREFECT_LOGGING_TO_API_MAX_LOG_SIZE.value(),
+            - PREFECT_LOGGING_TO_API_MAX_LOG_SIZE.value()
+            - 1,
+            1,
         )
 
     @property
     def min_interval(self) -> float | None:
         return PREFECT_LOGGING_TO_API_BATCH_INTERVAL.value()
 
-    async def _handle_batch(self, items: list[dict[str, Any]]):
+    def send(self, item: Dict[str, Any] | bytes) -> None:
+        """
+        Queue a log to send to the API.
+
+        Accepts a `LogCreate`-compatible dict, such as one returned by
+        `APILogHandler.prepare`, or its serialized JSON. Logs are queued as JSON
+        so each one is held once and is not serialized again when its batch is
+        sent.
+        """
+        if isinstance(item, dict):
+            payload = orjson.dumps(
+                {key: value for key, value in item.items() if key != "__payload_size__"}
+            )
+            # orjson output can take far more memory than its length, about 1 KiB
+            # for a short log. Copy it so a backlog of queued logs holds only the
+            # JSON.
+            item = memoryview(payload).tobytes()
+        super().send(item)
+
+    async def _handle_batch(self, items: list[bytes]):
         try:
-            await self._client.create_logs(items)
+            await self._client.request(
+                "POST",
+                "/logs/",
+                content=b"[" + b",".join(items) + b"]",
+                headers={"Content-Type": "application/json"},
+            )
         except Exception as e:
             # Roughly replicate the behavior of the stdlib logger error handling
             if logging.raiseExceptions and sys.stderr:
@@ -106,8 +135,10 @@ class APILogWorker(BatchedQueueService[Dict[str, Any]]):
         # Ensure a unique worker is retrieved per relevant logging settings
         return super().instance(*settings, *args)
 
-    def _get_size(self, item: Dict[str, Any]) -> int:
-        return item.pop("__payload_size__", None) or len(json.dumps(item).encode())
+    def _get_size(self, item: bytes) -> int:
+        # Count the comma or closing bracket that follows each log in the request
+        # body, so a full batch stays within the configured batch size
+        return len(item) + 1
 
 
 class APILogHandler(logging.Handler):
@@ -286,7 +317,7 @@ class APILogHandler(logging.Handler):
         return log
 
     def _get_payload_size(self, log: Dict[str, Any]) -> int:
-        return len(json.dumps(log).encode())
+        return len(orjson.dumps(log))
 
 
 class WorkerAPILogHandler(APILogHandler):

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

@@ -35,17 +35,7 @@ Thin facade over single-responsibility extracted classes. New behavior belongs i
 - Cancellation -> CancellationManager
 - Hooks -> HookRunner
 
-**Legacy methods on Runner exist only for backward compatibility.** Do not add new behavior to:
-- `_submit_run_and_capture_errors()` -- replaced by FlowRunExecutor.submit()
-- `_run_process()` -- replaced by ProcessStarter implementations
-- `_flow_run_process_map` dict -- replaced by ProcessManager
-- `_kill_process()` -- replaced by ProcessManager.kill()
-- `_run_on_crashed_hooks()` / `_run_on_cancellation_hooks()` -- replaced by HookRunner
-- `execute_flow_run()` -- deprecated (Mar 2026); use `FlowRunExecutorContext` + `WorkspaceResolvingEngineCommandStarter`
-- `execute_bundle()` -- deprecated (Mar 2026); use `execute_bundle()` from `prefect.bundles.execute`
-- `reschedule_current_flow_runs()` -- deprecated (Mar 2026); SIGTERM rescheduling is now handled inline by the CLI execute path
-
-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.
+**Runner has no execution path of its own.** Served runs go through `ScheduledRunPoller` -> `FlowRunExecutor`; one-shot callers (workers, `prefect flow-run execute`, `prefect.bundles.execute`) use `FlowRunExecutorContext` with a `ProcessStarter`. `Runner.execute_flow_run()`, `Runner.execute_bundle()` and `Runner.reschedule_current_flow_runs()` were removed after their deprecation period, along with the facade's own process map and kill/hook helpers. Do not reintroduce a second execution or process-tracking path on Runner: `Runner._cancel_run()` only delegates to `CancellationManager` for runs tracked by `ProcessManager`.
 
 ## Webserver Health Check
 
@@ -103,8 +93,9 @@ Each execution mode has a ProcessStarter implementation. To add a new execution
 
 `ScheduledRunPoller` now calls `propose_pending` (Scheduled → Pending) before handing off to `FlowRunExecutor`. `FlowRunExecutor` then calls `propose_submitting` (Pending → Submitting sub-state) as step 1 of its lifecycle **when `propose_submitting=True` (the default)**. These are two separate transitions — do not collapse them. The split exists so automations listening for the Pending state fire correctly before the executor begins.
 
-**Three callers set `propose_submitting=False`** via `FlowRunExecutorContext.create_executor(propose_submitting=False)` — all have already advanced the flow run past the Pending state, so proposing Submitting again would be wrong:
+**Four callers set `propose_submitting=False`** via `FlowRunExecutorContext.create_executor(propose_submitting=False)` — all have already advanced the flow run past the Pending state, so proposing Submitting again would be wrong:
 - direct `ProcessWorker.run()` execution (`BaseWorker` already proposed Submitting)
+- ad hoc `ProcessWorker._submit_adhoc_run()` execution (the worker created or reset the run as Pending)
 - `prefect flow-run execute` CLI path (invoked by a worker)
 - `execute_bundle()` in `prefect.bundles.execute` (invoked by bundle dispatch)
 
@@ -112,7 +103,7 @@ The cancelling precheck (step 1a) still runs unconditionally even when `propose_
 
 ## ProcessWorker Execution Paths
 
-Direct ProcessWorker runs use `FlowRunExecutorContext` with `propose_submitting=False`. Generated commands use `WorkspaceResolvingEngineCommandStarter` so command selection follows workspace preparation; explicitly configured commands use `EngineCommandStarter` and retain their own pull-step semantics. The executor owns process tracking, cancellation, Attempt Control Session evidence, crash inference, and normalized infrastructure status. Ad hoc ProcessWorker submissions still call deprecated `Runner.execute_bundle()` and remain a migration target.
+Direct ProcessWorker runs use `FlowRunExecutorContext` with `propose_submitting=False`. Generated commands use `WorkspaceResolvingEngineCommandStarter` so command selection follows workspace preparation; explicitly configured commands use `EngineCommandStarter` and retain their own pull-step semantics. Ad hoc submissions (`_submit_adhoc_run`, used by `InfrastructureBoundFlow`) open their own `FlowRunExecutorContext` with `BundleExecutionStarter` and `propose_submitting=False`, passing the job configuration's `working_dir` and `env`. The executor owns process tracking, cancellation, Attempt Control Session evidence, crash inference, and normalized infrastructure status in every path.
 
 ## BlockStorageAdapter Pull Behavior
 

{prefect_client-3.8.9.dev7 → prefect_client-3.9.1.dev1}/src/prefect/runner/_process_manager.py

@@ -368,6 +368,15 @@ class ProcessManager:
         """
         return set(self._process_map.keys())
 
+    def flow_run_count(self) -> int:
+        """Return the number of tracked flow runs.
+
+        Reads the map's length without iterating it, so callers on another
+        thread, such as the runner webserver, cannot fail while runs are added
+        or removed.
+        """
+        return len(self._process_map)
+
     async def wait_for_exit(self, flow_run_id: UUID, grace_seconds: float = 30) -> bool:
         """Wait for a tracked process to exit without sending a signal.
 

{prefect_client-3.8.9.dev7 → prefect_client-3.9.1.dev1}/src/prefect/runner/_scheduled_run_poller.py

@@ -173,8 +173,7 @@ class ScheduledRunPoller:
             starter = self._resolve_starter(flow_run)
 
             # Adhoc storage pull: if the deployment has storage with a
-            # pull_interval, pull code before starting the process (mirrors
-            # original Runner._run_process adhoc pull logic).
+            # pull_interval, pull code before starting the process.
             storage = (
                 self._deployment_registry.get_storage(flow_run.deployment_id)
                 if flow_run.deployment_id

{prefect_client-3.8.9.dev7 → prefect_client-3.9.1.dev1}/src/prefect/runner/_starter_bundle.py

@@ -18,7 +18,6 @@ if TYPE_CHECKING:
 class BundleExecutionStarter:
     """Executes a pre-serialized bundle in a subprocess via `SpawnProcess`.
 
-    Source: runner.py lines 771-841.
     Uses module-level `execute_bundle_in_subprocess` reference -- patch the
     module to override.
 

{prefect_client-3.8.9.dev7 → prefect_client-3.9.1.dev1}/src/prefect/runner/_starter_direct.py

@@ -17,7 +17,6 @@ if TYPE_CHECKING:
 class DirectSubprocessStarter:
     """Runs a flow object directly in a subprocess via `run_flow_in_subprocess`.
 
-    Source: runner.py lines 874-889.
     Uses module-level `run_flow_in_subprocess` reference -- patch the module
     to override.
     """