prefect-client 3.7.5.dev5__tar.gz → 3.7.6.dev1__tar.gz

{prefect_client-3.7.5.dev5 → prefect_client-3.7.6.dev1}/PKG-INFO

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

{prefect_client-3.7.5.dev5 → prefect_client-3.7.6.dev1}/src/prefect/AGENTS.md

@@ -34,6 +34,7 @@ There is no formal public/private boundary beyond the `_` prefix convention. Mod
 - **`ResultRecordMetadata` tolerates unknown serializer types.** When loading persisted metadata, an unrecognized serializer `type` is converted to an `UnknownSerializer` placeholder rather than raising `ValidationError`. This allows inspecting result metadata when the serializer implementation is unavailable in the current environment. However, known serializer types with invalid fields still raise `ValidationError`. `UnknownSerializer.dumps()` and `UnknownSerializer.loads()` raise `RuntimeError` — the tolerance is for inspection only, not actual serialization/deserialization.
 - **`ResultRecord` must be marked persisted after every storage write.** `ResultStore` calls `mark_persisted()` on every record it writes; `to_state_create` in `states.py` consults `is_persisted` as a fallback when `should_persist_result()` returns `False` (e.g., after run context teardown). Any new sync or async persist path that omits `mark_persisted()` will silently drop state metadata for already-written results.
 - **Flow-run suspension is enforced at orchestration boundaries.** Suspension is delivered via `FlowRunSuspensionRequest` and raised with `raise_if_flow_run_suspension_requested()`. When changing engines, futures, task runners, or generator execution, check before returning control to flow user code or proposing a flow state that could leave `Suspended`; keep sync/async paths aligned and avoid per-boundary API reads.
+- **Subflow tracking tasks use UUID dynamic keys when called from within a submitted task.** `flow_engine.py` marks the synthetic tracking `Task` with `_is_subflow_tracking_task=True`; `tasks.py` checks this flag to assign UUID-based (unstable) `dynamic_key` values when the tracking task runs inside a submitted task context. This prevents key collisions between concurrent sibling subflows on parent-flow retry. Direct subflow calls (no enclosing task context) keep stable sequential keys to preserve the retry optimization that reuses completed subflow results.
 
 ## Logging
 

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

@@ -0,0 +1,5 @@
+# Generated by versioningit
+__version__ = "3.7.6.dev1"
+__build_date__ = "2026-06-20 09:10:07.376417+00:00"
+__git_commit__ = "441d5e112d263706d963612aabc8f252df94a42e"
+__dirty__ = False

{prefect_client-3.7.5.dev5 → prefect_client-3.7.6.dev1}/src/prefect/flow_engine.py

@@ -972,6 +972,7 @@ class FlowRunEngine(BaseFlowRunEngine[P, R]):
             parent_task = Task(
                 name=self.flow.name, fn=self.flow.fn, version=self.flow.version
             )
+            setattr(parent_task, "_is_subflow_tracking_task", True)
 
             parent_task_run = run_coro_as_sync(
                 parent_task.create_run(
@@ -1667,6 +1668,7 @@ class AsyncFlowRunEngine(BaseFlowRunEngine[P, R]):
             parent_task = Task(
                 name=self.flow.name, fn=self.flow.fn, version=self.flow.version
             )
+            setattr(parent_task, "_is_subflow_tracking_task", True)
 
             parent_task_run = await parent_task.create_run(
                 flow_run_context=flow_run_ctx,

{prefect_client-3.7.5.dev5 → prefect_client-3.7.6.dev1}/src/prefect/server/api/server.py

@@ -843,6 +843,22 @@ def _memoize_block_auto_registration(
     return wrapper
 
 
+def _log_worker_channel_config() -> None:
+    """Log worker channel queue backend and key configuration at startup."""
+    wc_settings = prefect.settings.get_current_settings().server.worker_channel
+    logger.debug(
+        "Worker channel configuration: "
+        "cleanup_queue_storage=%s "
+        "cleanup_lease_seconds=%s "
+        "cleanup_max_delivery_attempts=%s "
+        "cleanup_completed_idempotency_retention_seconds=%s",
+        wc_settings.cleanup_queue_storage,
+        wc_settings.cleanup_lease_seconds,
+        wc_settings.cleanup_max_delivery_attempts,
+        wc_settings.cleanup_completed_idempotency_retention_seconds,
+    )
+
+
 def create_app(
     settings: Optional[prefect.settings.Settings] = None,
     ephemeral: bool = False,
@@ -912,6 +928,8 @@ def create_app(
         await run_migrations()
         await add_block_types()
 
+        _log_worker_channel_config()
+
         Services: type[Service] | None = (
             RunInWebservers
             if webserver_only

{prefect_client-3.7.5.dev5 → prefect_client-3.7.6.dev1}/src/prefect/server/api/workers.py

@@ -409,6 +409,15 @@ async def _build_worker_ready_frame(
         if capability not in accepted_set
     ]
 
+    if rejected:
+        logger.debug(
+            "Worker channel capabilities rejected: "
+            "work_pool=%s worker_name=%s rejected=%s",
+            work_pool_name,
+            hello.payload.worker_name,
+            rejected,
+        )
+
     return (
         WorkerReadyFrame(
             type="worker.ready.v1",
@@ -1154,17 +1163,41 @@ async def worker_channel_connect(
             await connection.run(ready, consumer_kwargs)
 
     except WorkerChannelSetupError as exc:
-        logger.info("Worker channel setup failed: %s", exc.detail)
+        logger.debug(
+            "Worker channel setup failed: work_pool=%s reason=%s detail=%s",
+            work_pool_name,
+            exc.close_reason.value,
+            exc.detail,
+        )
+        if worker_channel_utils.WORKER_CHANNEL_CONNECTIONS is not None:
+            worker_channel_utils.WORKER_CHANNEL_CONNECTIONS.labels(
+                event="setup_failed"
+            ).inc()
         await worker_channel_utils.close_worker_channel(websocket, exc.close_reason)
     except HTTPException as exc:
-        logger.info("Worker channel setup failed HTTP validation: %s", exc.detail)
+        logger.debug(
+            "Worker channel setup failed HTTP validation: work_pool=%s detail=%s",
+            work_pool_name,
+            exc.detail,
+        )
+        if worker_channel_utils.WORKER_CHANNEL_CONNECTIONS is not None:
+            worker_channel_utils.WORKER_CHANNEL_CONNECTIONS.labels(
+                event="setup_failed"
+            ).inc()
         await worker_channel_utils.close_worker_channel(
             websocket, WorkerChannelCloseReason.PROTOCOL_ERROR
         )
     except subscriptions.NORMAL_DISCONNECT_EXCEPTIONS:
         return
     except Exception:
-        logger.exception("Worker channel setup failed due to a transient server error")
+        logger.exception(
+            "Worker channel setup failed due to a transient server error: work_pool=%s",
+            work_pool_name,
+        )
+        if worker_channel_utils.WORKER_CHANNEL_CONNECTIONS is not None:
+            worker_channel_utils.WORKER_CHANNEL_CONNECTIONS.labels(
+                event="setup_failed"
+            ).inc()
         await worker_channel_utils.close_worker_channel(
             websocket, WorkerChannelCloseReason.TRANSIENT_SERVER_ERROR
         )

{prefect_client-3.7.5.dev5 → prefect_client-3.7.6.dev1}/src/prefect/tasks.py

@@ -900,6 +900,19 @@ class Task(Generic[P, R]):
             if not flow_run_context:
                 dynamic_key = f"{self.task_key}-{str(uuid4().hex)}"
                 task_run_name = self.name
+            elif (
+                getattr(self, "_is_subflow_tracking_task", False)
+                and parent_task_run_context
+                and flow_run_context.flow_run
+                and parent_task_run_context.task_run.flow_run_id
+                == flow_run_context.flow_run.id
+            ):
+                # Subflows called from a task context need UUID keys because
+                # sibling call order is not a reliable identity across retries.
+                dynamic_key = dynamic_key_for_task_run(
+                    context=flow_run_context, task=self, stable=False
+                )
+                task_run_name = f"{self.name}-{dynamic_key}"
             else:
                 dynamic_key = dynamic_key_for_task_run(
                     context=flow_run_context, task=self

{prefect_client-3.7.5.dev5 → prefect_client-3.7.6.dev1}/src/prefect/utilities/asyncutils/__init__.py

@@ -8,7 +8,7 @@ import threading
 import warnings
 from collections.abc import AsyncGenerator, Awaitable, Coroutine
 from contextlib import AbstractAsyncContextManager, asynccontextmanager
-from contextvars import ContextVar
+from contextvars import Context, ContextVar
 from functools import partial, wraps
 from logging import Logger
 from typing import TYPE_CHECKING, Any, Callable, NoReturn, Optional, Union, overload
@@ -474,6 +474,10 @@ class GatherTaskGroup(anyio.abc.TaskGroup):
         # The concrete task group implementation to use
         self._task_group: anyio.abc.TaskGroup = task_group
 
+    @property
+    def cancel_scope(self) -> Any:
+        return self._task_group.cancel_scope
+
     async def _run_and_store(
         self,
         key: UUID,
@@ -494,6 +498,20 @@ class GatherTaskGroup(anyio.abc.TaskGroup):
         self._task_group.start_soon(self._run_and_store, key, func, *args, name=name)
         return key
 
+    def create_task(
+        self,
+        coro: Coroutine[Any, Any, T],
+        *,
+        name: object = None,
+        context: Context | None = None,
+    ) -> Any:
+        create_task = getattr(self._task_group, "create_task", None)
+        if create_task is None:
+            coro.close()
+            raise RuntimeError("`create_task` requires AnyIO 4.14.0 or newer.")
+
+        return create_task(coro, name=name, context=context)
+
     async def start(self, func: object, *args: object, name: object = None) -> NoReturn:
         """
         Since `start` returns the result of `task_status.started()` but here we must

prefect_client-3.7.5.dev5/src/prefect/_build_info.py

@@ -1,5 +0,0 @@
-# Generated by versioningit
-__version__ = "3.7.5.dev5"
-__build_date__ = "2026-06-17 09:45:07.057987+00:00"
-__git_commit__ = "7107dafe23e062b1f8eb4239e85a0a9ef756e79e"
-__dirty__ = False