prefect-client 3.8.9.dev6__tar.gz → 3.9.0__tar.gz

{prefect_client-3.8.9.dev6 → prefect_client-3.9.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: prefect-client
-Version: 3.8.9.dev6
+Version: 3.9.0
 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.dev6 → prefect_client-3.9.0}/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.0/src/prefect/_build_info.py

@@ -0,0 +1,5 @@
+# Generated by versioningit
+__version__ = "3.9.0"
+__build_date__ = "2026-10-21 03:27:58.819332+00:00"
+__git_commit__ = "1ef3e516d3b3449d19f65b30c45d1e0bff656396"
+__dirty__ = False

{prefect_client-3.8.9.dev6 → prefect_client-3.9.0}/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.dev6 → prefect_client-3.9.0}/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.dev6 → prefect_client-3.9.0}/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.dev6 → prefect_client-3.9.0}/src/prefect/events/__init__.py

@@ -42,6 +42,7 @@ from .actions import (
     PauseAutomation,
     ResumeAutomation,
     DeclareIncident,
+    UnknownAction,
 )
 from .clients import get_events_client, get_events_subscriber
 from .subscribers import FlowRunSubscriber
@@ -90,6 +91,7 @@ __all__ = [
     "PauseAutomation",
     "ResumeAutomation",
     "DeclareIncident",
+    "UnknownAction",
     "emit_event",
     "get_events_client",
     "get_events_subscriber",

{prefect_client-3.8.9.dev6 → prefect_client-3.9.0}/src/prefect/events/actions.py

@@ -1,9 +1,16 @@
 import abc
 from datetime import timedelta
-from typing import Any, Dict, Optional, Union
+from typing import Annotated, Any, ClassVar, Dict, Optional, Union, get_args
 from uuid import UUID
 
-from pydantic import Field, model_validator
+from pydantic import (
+    ConfigDict,
+    Discriminator,
+    Field,
+    Tag,
+    field_validator,
+    model_validator,
+)
 from typing_extensions import Literal, Self, TypeAlias
 
 from prefect._internal.schemas.bases import PrefectBaseModel
@@ -314,3 +321,56 @@ ActionTypes: TypeAlias = Union[
     # Prefect Cloud only
     DeclareIncident,
 ]
+
+_KNOWN_ACTION_TYPES: frozenset[str] = frozenset(
+    action.model_fields["type"].default for action in get_args(ActionTypes)
+)
+
+
+class UnknownAction(Action):
+    """An action whose type this version of Prefect does not recognize.
+
+    Prefect Cloud can add action types before a client release knows about
+    them. Reading an automation that uses one of these types returns this
+    model instead of failing. The model keeps every field of the action, so
+    updating the automation sends the action back unchanged.
+    """
+
+    model_config: ClassVar[ConfigDict] = ConfigDict(extra="allow")
+
+    type: str = Field(
+        json_schema_extra={"not": {"enum": sorted(_KNOWN_ACTION_TYPES)}},
+    )
+
+    @field_validator("type")
+    @classmethod
+    def _type_is_not_known(cls, value: str) -> str:
+        if value in _KNOWN_ACTION_TYPES:
+            raise ValueError(
+                f"{value!r} is a known action type and cannot be an UnknownAction"
+            )
+        return value
+
+
+def _action_discriminator(value: Any) -> str:
+    """Sends an action with an unrecognized `type` to `UnknownAction` and every
+    other action, including one with no `type`, to `ActionTypes`."""
+    if isinstance(value, UnknownAction):
+        return "unknown"
+    action_type = (
+        value.get("type") if isinstance(value, dict) else getattr(value, "type", None)
+    )
+    if isinstance(action_type, str) and action_type not in _KNOWN_ACTION_TYPES:
+        return "unknown"
+    return "known"
+
+
+ActionTypesOrUnknown: TypeAlias = Annotated[
+    Union[
+        Annotated[ActionTypes, Tag("known")],
+        Annotated[UnknownAction, Tag("unknown")],
+    ],
+    Discriminator(_action_discriminator),
+]
+"""The action types an automation read from the API may contain: any of
+`ActionTypes`, or an `UnknownAction` for a type this version does not know"""

{prefect_client-3.8.9.dev6 → prefect_client-3.9.0}/src/prefect/events/schemas/automations.py

@@ -22,17 +22,22 @@ from pydantic import (
     Field,
     PrivateAttr,
     Tag,
+    TypeAdapter,
+    ValidationError,
     field_validator,
     model_validator,
 )
 from typing_extensions import Self, TypeAlias
 
 from prefect._internal.schemas.bases import PrefectBaseModel
-from prefect.events.actions import ActionTypes, RunDeployment
+from prefect.events.actions import ActionTypes, ActionTypesOrUnknown, RunDeployment
+from prefect.types import DurationOrSecondsTimeDelta
 from prefect.utilities.collections import AutoEnum
 
 from .events import ResourceSpecification
 
+_timedelta_adapter: TypeAdapter[timedelta] = TypeAdapter(timedelta)
+
 # Dict form accepted by ResourceSpecification via Pydantic coercion
 ResourceSpecificationDict: TypeAlias = Dict[str, Union[str, List[str]]]
 
@@ -96,7 +101,7 @@ class Trigger(PrefectBaseModel, abc.ABC, extra="ignore"):  # type: ignore[call-a
             description=getattr(self, "description", ""),
             enabled=getattr(self, "enabled", True),
             trigger=trigger,
-            actions=self.actions(),
+            actions=list(self.actions()),
             owner_resource=self.owner_resource(),
         )
 
@@ -196,7 +201,7 @@ class EventTrigger(ResourceTrigger):
             "triggers)"
         ),
     )
-    within: timedelta = Field(
+    within: DurationOrSecondsTimeDelta = Field(
         default=timedelta(seconds=0),
         ge=timedelta(seconds=0),
         description=(
@@ -220,8 +225,15 @@ class EventTrigger(ResourceTrigger):
         posture: Optional[Posture] = data.get("posture")
         within: Optional[timedelta] = data.get("within")
 
-        if isinstance(within, (int, float)):
-            within = timedelta(seconds=within)
+        if within is not None and not isinstance(within, timedelta):
+            # Parse the raw value the same way the field would, so that every
+            # form pydantic accepts for a timedelta reaches the comparisons
+            # below as a timedelta.
+            try:
+                within = _timedelta_adapter.validate_python(within)
+            except ValidationError:
+                # The field validation reports the unparsable value.
+                return data
 
         if posture == Posture.Proactive:
             if not within or within == timedelta(0):
@@ -294,7 +306,7 @@ class MetricTriggerQuery(PrefectBaseModel):
             "the query result against the threshold value."
         ),
     )
-    range: timedelta = Field(
+    range: DurationOrSecondsTimeDelta = Field(
         timedelta(seconds=300),  # defaults to 5 minutes
         description=(
             "The lookback duration (seconds) for a metric query. This duration is "
@@ -302,7 +314,7 @@ class MetricTriggerQuery(PrefectBaseModel):
             "The minimum value is 300 seconds (5 minutes)."
         ),
     )
-    firing_for: timedelta = Field(
+    firing_for: DurationOrSecondsTimeDelta = Field(
         timedelta(seconds=300),  # defaults to 5 minutes
         description=(
             "The duration (seconds) for which the metric query must breach "
@@ -356,7 +368,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, "
@@ -486,17 +498,17 @@ class AutomationCore(PrefectBaseModel, extra="ignore"):  # type: ignore[call-arg
         ),
     )
 
-    actions: List[ActionTypes] = Field(
+    actions: List[ActionTypesOrUnknown] = Field(
         default=...,
         description="The actions to perform when this Automation triggers",
     )
 
-    actions_on_trigger: List[ActionTypes] = Field(
+    actions_on_trigger: List[ActionTypesOrUnknown] = Field(
         default_factory=list,
         description="The actions to perform when an Automation goes into a triggered state",
     )
 
-    actions_on_resolve: List[ActionTypes] = Field(
+    actions_on_resolve: List[ActionTypesOrUnknown] = Field(
         default_factory=list,
         description="The actions to perform when an Automation goes into a resolving state",
     )

{prefect_client-3.8.9.dev6 → prefect_client-3.9.0}/src/prefect/flow_runs.py

@@ -273,7 +273,7 @@ async def apause_flow_run(
             if wait_for_input:
                 # The flow run wanted input, so we need to load it and return it
                 # to the user.
-                await wait_for_input.aload(run_input_keyset)
+                return await wait_for_input.aload(run_input_keyset)
 
             return
 

{prefect_client-3.8.9.dev6 → prefect_client-3.9.0}/src/prefect/flows.py

@@ -578,11 +578,11 @@ class Flow(Generic[P, R]):
                 else self.cache_result_in_memory
             ),
             log_prints=log_prints if log_prints is not NotSet else self.log_prints,
-            on_completion=on_completion or self.on_completion_hooks,
-            on_failure=on_failure or self.on_failure_hooks,
-            on_cancellation=on_cancellation or self.on_cancellation_hooks,
-            on_crashed=on_crashed or self.on_crashed_hooks,
-            on_running=on_running or self.on_running_hooks,
+            on_completion=on_completion or copy(self.on_completion_hooks),
+            on_failure=on_failure or copy(self.on_failure_hooks),
+            on_cancellation=on_cancellation or copy(self.on_cancellation_hooks),
+            on_crashed=on_crashed or copy(self.on_crashed_hooks),
+            on_running=on_running or copy(self.on_running_hooks),
         )
         new_flow._storage = self._storage
         new_flow._entrypoint = self._entrypoint

{prefect_client-3.8.9.dev6 → prefect_client-3.9.0}/src/prefect/futures.py

@@ -584,7 +584,7 @@ class PrefectFutureList(list[PrefectFuture[R]], Iterator[PrefectFuture[R]]):
         timeout_message = (
             f"Timed out waiting for all futures to complete within {timeout} seconds"
         )
-        deadline = time.monotonic() + timeout if timeout is not None else None
+        deadline = time.monotonic() + timeout if timeout else None
 
         try:
             # `as_completed` de-duplicates internally; each unique future is
@@ -638,7 +638,7 @@ def as_completed(
     pending = unique_futures
     deadline: float | None = None
     try:
-        with timeout_context(timeout, timeout_exc_type=_WaitTimeoutError):
+        with timeout_context(timeout or None, timeout_exc_type=_WaitTimeoutError):
             done = {f for f in unique_futures if f._final_state}  # type: ignore[privateUsage]
             pending = unique_futures - done
             yield from done

{prefect_client-3.8.9.dev6 → prefect_client-3.9.0}/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.