prefect-client 3.9.1.dev4__tar.gz → 3.9.1.dev6__tar.gz

{prefect_client-3.9.1.dev4 → prefect_client-3.9.1.dev6}/PKG-INFO

@@ -1,9 +1,9 @@
 Metadata-Version: 2.5
 Name: prefect-client
-Version: 3.9.1.dev4
+Version: 3.9.1.dev6
 Summary: Workflow orchestration and management.
 Project-URL: Changelog, https://github.com/PrefectHQ/prefect/releases
-Project-URL: Documentation, https://docs.prefect.io
+Project-URL: Documentation, https://www.prefect.io/docs
 Project-URL: Source, https://github.com/PrefectHQ/prefect
 Project-URL: Tracker, https://github.com/PrefectHQ/prefect/issues
 Author-email: "Prefect Technologies, Inc." <help@prefect.io>
@@ -163,7 +163,7 @@ describing the functionality you are interested in using and we will do our best
 ## Next steps
 
 There's lots more you can do to orchestrate and observe your workflows with Prefect!
-Start with our [friendly tutorial](https://docs.prefect.io/tutorials) or explore the [core concepts of Prefect workflows](https://docs.prefect.io/concepts/).
+Start with our [friendly tutorial](https://www.prefect.io/docs/tutorials) or explore the [core concepts of Prefect workflows](https://www.prefect.io/docs/concepts/).
 
 ## Join the community
 
@@ -173,6 +173,6 @@ All community forums, including code contributions, issue discussions, and Slack
 
 ## Contribute
 
-See our [documentation on contributing to Prefect](https://docs.prefect.io/contributing/overview/).
+See our [documentation on contributing to Prefect](https://www.prefect.io/docs/contributing/overview/).
 
 Thanks for being part of the mission to build a new kind of workflow system and, of course, **happy engineering!**

{prefect_client-3.9.1.dev4 → prefect_client-3.9.1.dev6}/README.md

@@ -94,7 +94,7 @@ describing the functionality you are interested in using and we will do our best
 ## Next steps
 
 There's lots more you can do to orchestrate and observe your workflows with Prefect!
-Start with our [friendly tutorial](https://docs.prefect.io/tutorials) or explore the [core concepts of Prefect workflows](https://docs.prefect.io/concepts/).
+Start with our [friendly tutorial](https://www.prefect.io/docs/tutorials) or explore the [core concepts of Prefect workflows](https://www.prefect.io/docs/concepts/).
 
 ## Join the community
 
@@ -104,6 +104,6 @@ All community forums, including code contributions, issue discussions, and Slack
 
 ## Contribute
 
-See our [documentation on contributing to Prefect](https://docs.prefect.io/contributing/overview/).
+See our [documentation on contributing to Prefect](https://www.prefect.io/docs/contributing/overview/).
 
 Thanks for being part of the mission to build a new kind of workflow system and, of course, **happy engineering!**

{prefect_client-3.9.1.dev4 → prefect_client-3.9.1.dev6}/pyproject.toml

@@ -71,7 +71,7 @@ dependencies = [
 ]
 [project.urls]
 Changelog = "https://github.com/PrefectHQ/prefect/releases"
-Documentation = "https://docs.prefect.io"
+Documentation = "https://www.prefect.io/docs"
 Source = "https://github.com/PrefectHQ/prefect"
 Tracker = "https://github.com/PrefectHQ/prefect/issues"
 [project.optional-dependencies]

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

@@ -0,0 +1,5 @@
+# Generated by versioningit
+__version__ = "3.9.1.dev6"
+__build_date__ = "2026-10-28 08:14:48.771478+00:00"
+__git_commit__ = "bdc282844dd7ad54b0734dcc48d0a597881591c0"
+__dirty__ = False

{prefect_client-3.9.1.dev4 → prefect_client-3.9.1.dev6}/src/prefect/_internal/analytics/notice.py

@@ -14,7 +14,7 @@ from prefect.settings import get_current_settings
 NOTICE_TEXT = """
 Prefect collects anonymous usage data to improve the product.
 To opt out: set PREFECT_SERVER_ANALYTICS_ENABLED=false on the server, or DO_NOT_TRACK=1 in the client.
-Learn more: https://docs.prefect.io/concepts/telemetry
+Learn more: https://www.prefect.io/docs/concepts/telemetry
 """
 
 

{prefect_client-3.9.1.dev4 → prefect_client-3.9.1.dev6}/src/prefect/_internal/compatibility/migration.py

@@ -59,7 +59,7 @@ MOVED_IN_V3 = {
     "prefect.client:get_client": "prefect.client.orchestration:get_client",
 }
 
-upgrade_guide_msg = "Refer to the upgrade guide for more information: https://docs.prefect.io/v3/how-to-guides/migrate/upgrade-agents-to-workers."
+upgrade_guide_msg = "Refer to the upgrade guide for more information: https://www.prefect.io/docs/v3/how-to-guides/migrate/upgrade-agents-to-workers."
 
 REMOVED_IN_V3 = {
     "prefect.client.schemas.objects:MinimalDeploymentSchedule": "Use `prefect.client.schemas.actions.DeploymentScheduleCreate` instead.",

{prefect_client-3.9.1.dev4 → prefect_client-3.9.1.dev6}/src/prefect/_internal/result_records.py

@@ -37,6 +37,7 @@ if TYPE_CHECKING:
 ResultSerializer = Union[Serializer, str]
 LITERAL_TYPES: set[type] = {type(None), bool, UUID}
 R = TypeVar("R")
+_LEGACY_RESULT_BLOB_KEYS = {"serializer", "data", "prefect_version", "expiration"}
 
 
 class ResultRecordMetadata(BaseModel):
@@ -173,16 +174,19 @@ class ResultRecord(BaseModel, Generic[R]):
         if isinstance(value, dict):
             if TYPE_CHECKING:  # TODO: # isintance doesn't accept generic parameters
                 value = cast(dict[str, Any], value)
-            if "data" in value:
+            # Only coerce the exact legacy `PersistedResultBlob` shape so that raw
+            # JSON results that happen to contain a `data` key aren't misread
+            if (
+                {"data", "serializer"} <= value.keys() <= _LEGACY_RESULT_BLOB_KEYS
+                and isinstance(value["data"], str)
+                and isinstance(value["serializer"], dict)
+            ):
                 value["result"] = value.pop("data")
-            if "metadata" not in value:
-                value["metadata"] = {}
-            if "expiration" in value:
-                value["metadata"]["expiration"] = value.pop("expiration")
-            if "serializer" in value:
-                value["metadata"]["serializer"] = value.pop("serializer")
-            if "prefect_version" in value:
-                value["metadata"]["prefect_version"] = value.pop("prefect_version")
+                value["metadata"] = {"serializer": value.pop("serializer")}
+                if "expiration" in value:
+                    value["metadata"]["expiration"] = value.pop("expiration")
+                if "prefect_version" in value:
+                    value["metadata"]["prefect_version"] = value.pop("prefect_version")
         return value
 
     def serialize_metadata(self) -> bytes:

{prefect_client-3.9.1.dev4 → prefect_client-3.9.1.dev6}/src/prefect/artifacts.py

@@ -34,7 +34,7 @@ logger: "logging.Logger" = get_logger("artifacts")
 class Artifact(ArtifactRequest):
     """
     An artifact is a piece of data that is created by a flow or task run.
-    https://docs.prefect.io/latest/develop/artifacts
+    https://www.prefect.io/docs/latest/develop/artifacts
 
     Arguments:
         type: A string identifying the type of artifact.

{prefect_client-3.9.1.dev4 → prefect_client-3.9.1.dev6}/src/prefect/blocks/notifications.py

@@ -104,7 +104,7 @@ class AppriseNotificationBlock(AbstractAppriseNotificationBlock, ABC):
     """
 
     _documentation_url = HttpUrl(
-        "https://docs.prefect.io/latest/automate/events/automations-triggers#sending-notifications-with-automations"
+        "https://www.prefect.io/docs/latest/automate/events/automations-triggers#sending-notifications-with-automations"
     )
     url: SecretStr = Field(
         default=...,
@@ -173,7 +173,7 @@ class SlackWebhook(AppriseNotificationBlock):
         "https://raw.githubusercontent.com/PrefectHQ/prefect/420d0d6a78bb6df1fc18bcf188fdad43c1d22ea9/assets/block-logos/slack.png"
     )
     _documentation_url = HttpUrl(
-        "https://docs.prefect.io/latest/automate/events/automations-triggers#sending-notifications-with-automations"
+        "https://www.prefect.io/docs/latest/automate/events/automations-triggers#sending-notifications-with-automations"
     )
 
     url: SecretStr = Field(
@@ -270,7 +270,7 @@ class MicrosoftTeamsWebhook(AppriseNotificationBlock):
         "https://raw.githubusercontent.com/PrefectHQ/prefect/420d0d6a78bb6df1fc18bcf188fdad43c1d22ea9/assets/block-logos/microsoft-teams.png"
     )
     _documentation_url = HttpUrl(
-        "https://docs.prefect.io/latest/automate/events/automations-triggers#sending-notifications-with-automations"
+        "https://www.prefect.io/docs/latest/automate/events/automations-triggers#sending-notifications-with-automations"
     )
 
     url: SecretStr = Field(
@@ -332,7 +332,7 @@ class PagerDutyWebHook(AbstractAppriseNotificationBlock):
         "https://raw.githubusercontent.com/PrefectHQ/prefect/420d0d6a78bb6df1fc18bcf188fdad43c1d22ea9/assets/block-logos/pagerduty.png"
     )
     _documentation_url = HttpUrl(
-        "https://docs.prefect.io/latest/automate/events/automations-triggers#sending-notifications-with-automations"
+        "https://www.prefect.io/docs/latest/automate/events/automations-triggers#sending-notifications-with-automations"
     )
 
     # PagerDuty requires a valid severity level from its PAGERDUTY_SEVERITY_MAP
@@ -488,7 +488,7 @@ class TwilioSMS(AbstractAppriseNotificationBlock):
         "https://raw.githubusercontent.com/PrefectHQ/prefect/420d0d6a78bb6df1fc18bcf188fdad43c1d22ea9/assets/block-logos/twilio.png"
     )  # noqa
     _documentation_url = HttpUrl(
-        "https://docs.prefect.io/latest/automate/events/automations-triggers#sending-notifications-with-automations"
+        "https://www.prefect.io/docs/latest/automate/events/automations-triggers#sending-notifications-with-automations"
     )
 
     account_sid: str = Field(
@@ -563,7 +563,7 @@ class OpsgenieWebhook(AbstractAppriseNotificationBlock):
         "https://raw.githubusercontent.com/PrefectHQ/prefect/420d0d6a78bb6df1fc18bcf188fdad43c1d22ea9/assets/block-logos/opsgenie.png"
     )
     _documentation_url = HttpUrl(
-        "https://docs.prefect.io/latest/automate/events/automations-triggers#sending-notifications-with-automations"
+        "https://www.prefect.io/docs/latest/automate/events/automations-triggers#sending-notifications-with-automations"
     )
 
     apikey: SecretStr = Field(
@@ -688,7 +688,7 @@ class MattermostWebhook(AbstractAppriseNotificationBlock):
         "https://raw.githubusercontent.com/PrefectHQ/prefect/420d0d6a78bb6df1fc18bcf188fdad43c1d22ea9/assets/block-logos/mattermost.png"
     )
     _documentation_url = HttpUrl(
-        "https://docs.prefect.io/latest/automate/events/automations-triggers#sending-notifications-with-automations"
+        "https://www.prefect.io/docs/latest/automate/events/automations-triggers#sending-notifications-with-automations"
     )
 
     hostname: str = Field(
@@ -790,7 +790,7 @@ class DiscordWebhook(AbstractAppriseNotificationBlock):
         "https://raw.githubusercontent.com/PrefectHQ/prefect/420d0d6a78bb6df1fc18bcf188fdad43c1d22ea9/assets/block-logos/discord.png"
     )
     _documentation_url = HttpUrl(
-        "https://docs.prefect.io/latest/automate/events/automations-triggers#sending-notifications-with-automations"
+        "https://www.prefect.io/docs/latest/automate/events/automations-triggers#sending-notifications-with-automations"
     )
 
     webhook_id: SecretStr = Field(
@@ -895,7 +895,7 @@ class CustomWebhookNotificationBlock(NotificationBlock):
         "https://raw.githubusercontent.com/PrefectHQ/prefect/420d0d6a78bb6df1fc18bcf188fdad43c1d22ea9/assets/block-logos/webhook.png"
     )
     _documentation_url = HttpUrl(
-        "https://docs.prefect.io/latest/automate/events/automations-triggers#sending-notifications-with-automations"
+        "https://www.prefect.io/docs/latest/automate/events/automations-triggers#sending-notifications-with-automations"
     )
 
     name: str = Field(title="Name", description="Name of the webhook.")
@@ -1065,7 +1065,7 @@ class SendgridEmail(AbstractAppriseNotificationBlock):
         "https://raw.githubusercontent.com/PrefectHQ/prefect/420d0d6a78bb6df1fc18bcf188fdad43c1d22ea9/assets/block-logos/email.png"
     )
     _documentation_url = HttpUrl(
-        "https://docs.prefect.io/latest/automate/events/automations-triggers#sending-notifications-with-automations"
+        "https://www.prefect.io/docs/latest/automate/events/automations-triggers#sending-notifications-with-automations"
     )
 
     api_key: SecretStr = Field(

{prefect_client-3.9.1.dev4 → prefect_client-3.9.1.dev6}/src/prefect/blocks/system.py

@@ -47,7 +47,7 @@ class Secret(Block, Generic[T]):
     _logo_url = HttpUrl(
         "https://raw.githubusercontent.com/PrefectHQ/prefect/420d0d6a78bb6df1fc18bcf188fdad43c1d22ea9/assets/block-logos/secret.png"
     )
-    _documentation_url = HttpUrl("https://docs.prefect.io/latest/develop/blocks")
+    _documentation_url = HttpUrl("https://www.prefect.io/docs/latest/develop/blocks")
     _description = "A block that represents a secret value. The value stored in this block will be obfuscated when this block is viewed or edited in the UI."
 
     value: Union[SecretStr, PydanticSecret[T]] = Field(

{prefect_client-3.9.1.dev4 → prefect_client-3.9.1.dev6}/src/prefect/blocks/webhook.py

@@ -33,7 +33,7 @@ class Webhook(Block):
     _block_type_name = "Webhook"
     _logo_url = "https://raw.githubusercontent.com/PrefectHQ/prefect/420d0d6a78bb6df1fc18bcf188fdad43c1d22ea9/assets/block-logos/webhook.png"  # type: ignore
     _documentation_url = HttpUrl(
-        "https://docs.prefect.io/latest/automate/events/webhook-triggers"
+        "https://www.prefect.io/docs/latest/automate/events/webhook-triggers"
     )
 
     method: Literal["GET", "POST", "PUT", "PATCH", "DELETE"] = Field(

{prefect_client-3.9.1.dev4 → prefect_client-3.9.1.dev6}/src/prefect/cache_policies.py

@@ -4,6 +4,7 @@ from copy import deepcopy
 from dataclasses import dataclass, field, replace
 from logging import Logger
 from pathlib import Path
+from types import CodeType
 from typing import (
     TYPE_CHECKING,
     Any,
@@ -45,9 +46,10 @@ def _register_stable_transforms() -> None:
     if sys.modules.get("pandas") is not None:
         import pandas as pd  # pyright: ignore
 
-        STABLE_TRANSFORMS[pd.DataFrame] = lambda df: [  # pyright: ignore
-            df[col] for col in sorted(df.columns)
-        ]
+        STABLE_TRANSFORMS[pd.DataFrame] = lambda df: (  # pyright: ignore
+            list(df.columns),
+            [df.iloc[:, i] for i in range(len(df.columns))],
+        )
 
 
 @dataclass
@@ -282,6 +284,19 @@ class _None(CachePolicy):
         return other
 
 
+def _normalize_code_location(code: CodeType) -> CodeType:
+    """Remove compilation locations, including those in nested code constants."""
+    return code.replace(
+        co_filename="",
+        co_firstlineno=1,
+        co_linetable=b"",
+        co_consts=tuple(
+            _normalize_code_location(const) if isinstance(const, CodeType) else const
+            for const in code.co_consts
+        ),
+    )
+
+
 @dataclass
 class TaskSource(CachePolicy):
     """
@@ -312,7 +327,10 @@ class TaskSource(CachePolicy):
             lines = inspect.getsource(task_ctx.task.fn.__class__)
         except OSError as exc:
             if "source code" in str(exc):
-                lines = task_ctx.task.fn.__code__.co_code
+                return hash_objects(
+                    _normalize_code_location(task_ctx.task.fn.__code__),
+                    raise_on_failure=True,
+                )
             else:
                 raise
 

{prefect_client-3.9.1.dev4 → prefect_client-3.9.1.dev6}/src/prefect/client/__init__.py

@@ -1,5 +1,5 @@
 """
-Asynchronous client implementation for communicating with the [Prefect REST API](https://docs.prefect.io/v3/api-ref/rest-api/).
+Asynchronous client implementation for communicating with the [Prefect REST API](https://www.prefect.io/docs/v3/api-ref/rest-api/).
 
 Explore the client by communicating with an in-memory webserver - no setup required:
 

{prefect_client-3.9.1.dev4 → prefect_client-3.9.1.dev6}/src/prefect/client/orchestration/__init__.py

@@ -296,7 +296,7 @@ class PrefectClient(
     EventAsyncClient,
 ):
     """
-    An asynchronous client for interacting with the [Prefect REST API](https://docs.prefect.io/v3/api-ref/rest-api/).
+    An asynchronous client for interacting with the [Prefect REST API](https://www.prefect.io/docs/v3/api-ref/rest-api/).
 
     Args:
         api: the REST API URL or FastAPI application to connect to
@@ -1243,7 +1243,7 @@ class SyncPrefectClient(
     EventClient,
 ):
     """
-    A synchronous client for interacting with the [Prefect REST API](https://docs.prefect.io/v3/api-ref/rest-api/).
+    A synchronous client for interacting with the [Prefect REST API](https://www.prefect.io/docs/v3/api-ref/rest-api/).
 
     Args:
         api: the REST API URL or FastAPI application to connect to

{prefect_client-3.9.1.dev4 → prefect_client-3.9.1.dev6}/src/prefect/client/orchestration/_work_pools/client.py

@@ -525,6 +525,8 @@ class WorkPoolAsyncClient(BaseAsyncClient):
                 json=work_pool.model_dump(mode="json", exclude_unset=True),
             )
         except HTTPStatusError as e:
+            if e.response.status_code == 403 and "plan does not support" in str(e):
+                raise ObjectUnsupported(http_exc=e) from e
             if e.response.status_code == 409:
                 if overwrite:
                     existing_work_pool = await self.read_work_pool(

{prefect_client-3.9.1.dev4 → prefect_client-3.9.1.dev6}/src/prefect/client/schemas/sorting.py

@@ -25,6 +25,8 @@ class TaskRunSort(AutoEnum):
     NAME_DESC = AutoEnum.auto()
     NEXT_SCHEDULED_START_TIME_ASC = AutoEnum.auto()
     END_TIME_DESC = AutoEnum.auto()
+    DURATION_DESC = AutoEnum.auto()
+    DURATION_ASC = AutoEnum.auto()
 
 
 class AutomationSort(AutoEnum):

{prefect_client-3.9.1.dev4 → prefect_client-3.9.1.dev6}/src/prefect/context.py

@@ -3,7 +3,7 @@ Async and thread safe models for passing runtime context data.
 
 These contexts should never be directly mutated by the user.
 
-For more user-accessible information about the current run, see [`prefect.runtime`](https://docs.prefect.io/v3/api-ref/python/prefect-runtime-flow_run).
+For more user-accessible information about the current run, see [`prefect.runtime`](https://www.prefect.io/docs/v3/api-ref/python/prefect-runtime-flow_run).
 """
 
 import asyncio

{prefect_client-3.9.1.dev4 → prefect_client-3.9.1.dev6}/src/prefect/deployments/base.py

@@ -2,7 +2,7 @@
 Core primitives for managing Prefect deployments via `prefect deploy`, providing a minimally opinionated
 build system for managing flows and deployments.
 
-To get started, follow along with [the deployments tutorial](https://docs.prefect.io/v3/how-to-guides/deployments/create-deployments).
+To get started, follow along with [the deployments tutorial](https://www.prefect.io/docs/v3/how-to-guides/deployments/create-deployments).
 """
 
 from __future__ import annotations

{prefect_client-3.9.1.dev4 → prefect_client-3.9.1.dev6}/src/prefect/deployments/runner.py

@@ -1126,7 +1126,7 @@ class RunnerDeployment(BaseModel):
             no_file_location_error = (
                 "Flows defined interactively cannot be deployed. Check out the"
                 " quickstart guide for help getting started:"
-                " https://docs.prefect.io/latest/get-started/quickstart"
+                " https://www.prefect.io/docs/latest/get-started/quickstart"
             )
             ## first see if an entrypoint can be determined
             flow_file = getattr(flow, "__globals__", {}).get("__file__")
@@ -1671,14 +1671,14 @@ async def adeploy(
                 " or specify a remote storage location for the flow with `.from_source`."
                 " If you are attempting to deploy a flow to a local process work pool,"
                 " consider using `flow.serve` instead. See the documentation for more"
-                " information: https://docs.prefect.io/latest/how-to-guides/deployments/run-flows-in-local-processes"
+                " information: https://www.prefect.io/docs/latest/how-to-guides/deployments/run-flows-in-local-processes"
             )
         elif work_pool.type == "process" and not ignore_warnings:
             console.print(
                 "Looks like you're deploying to a process work pool. If you're creating a"
                 " deployment for local development, calling `.serve` on your flow is a great"
                 " way to get started. See the documentation for more information:"
-                " https://docs.prefect.io/latest/how-to-guides/deployments/run-flows-in-local-processes "
+                " https://www.prefect.io/docs/latest/how-to-guides/deployments/run-flows-in-local-processes "
                 " Set `ignore_warnings=True` to suppress this message.",
                 style="yellow",
             )
@@ -1912,14 +1912,14 @@ def deploy(
                 " or specify a remote storage location for the flow with `.from_source`."
                 " If you are attempting to deploy a flow to a local process work pool,"
                 " consider using `flow.serve` instead. See the documentation for more"
-                " information: https://docs.prefect.io/latest/how-to-guides/deployments/run-flows-in-local-processes"
+                " information: https://www.prefect.io/docs/latest/how-to-guides/deployments/run-flows-in-local-processes"
             )
         elif work_pool.type == "process" and not ignore_warnings:
             console.print(
                 "Looks like you're deploying to a process work pool. If you're creating a"
                 " deployment for local development, calling `.serve` on your flow is a great"
                 " way to get started. See the documentation for more information:"
-                " https://docs.prefect.io/latest/how-to-guides/deployments/run-flows-in-local-processes "
+                " https://www.prefect.io/docs/latest/how-to-guides/deployments/run-flows-in-local-processes "
                 " Set `ignore_warnings=True` to suppress this message.",
                 style="yellow",
             )

{prefect_client-3.9.1.dev4 → prefect_client-3.9.1.dev6}/src/prefect/deployments/steps/core.py

@@ -5,7 +5,7 @@ Deployment steps are YAML representations of Python functions along with their i
 
 Whenever a step is run, the following actions are taken:
 
-- The step's inputs and block / variable references are resolved (see [the `prefect deploy` documentation](https://docs.prefect.io/v3/how-to-guides/deployments/prefect-yaml#templating-options) for more details)
+- The step's inputs and block / variable references are resolved (see [the `prefect deploy` documentation](https://www.prefect.io/docs/v3/how-to-guides/deployments/prefect-yaml#templating-options) for more details)
 - The step's function is imported; if it cannot be found, the `requires` keyword is used to install the necessary packages
 - The step's function is called with the resolved inputs
 - The step's output is returned and used to resolve inputs for subsequent steps

{prefect_client-3.9.1.dev4 → prefect_client-3.9.1.dev6}/src/prefect/deployments/steps/pull.py

@@ -169,7 +169,7 @@ def git_clone(
                 repository: https://github.com/org/repo.git
                 access_token: "{{ prefect.blocks.secret.github-access-token }}" # Requires creation of a Secret block
         ```
-        Note that you will need to [create a Secret block](https://docs.prefect.io/v3/concepts/blocks/#pre-registered-blocks) to store the
+        Note that you will need to [create a Secret block](https://www.prefect.io/docs/v3/concepts/blocks/#pre-registered-blocks) to store the
         value of your git credentials. You can also store a username/password combo or token prefix (e.g. `x-token-auth`)
         in your secret block. Refer to your git providers documentation for the correct authentication schema.
 

{prefect_client-3.9.1.dev4 → prefect_client-3.9.1.dev6}/src/prefect/events/schemas/events.py

@@ -31,6 +31,7 @@ from prefect.logging import get_logger
 from prefect.settings import (
     PREFECT_EVENTS_MAXIMUM_LABELS_PER_RESOURCE,
 )
+from prefect.utilities.urls import url_for
 
 from .labelling import Labelled
 
@@ -194,6 +195,12 @@ class ReceivedEvent(Event):
         description="When the event was received by Prefect Cloud",
     )
 
+    @property
+    def url(self) -> Optional[str]:
+        """Returns the UI URL for this event, allowing users to link to events
+        in automation templates without parsing date strings."""
+        return url_for(self, url_type="ui")
+
 
 def matches(expected: str, value: Optional[str]) -> bool:
     """Returns true if the given value matches the expected string, which may

{prefect_client-3.9.1.dev4 → prefect_client-3.9.1.dev6}/src/prefect/filesystems.py

@@ -86,9 +86,7 @@ class LocalFileSystem(WritableFileSystem, WritableDeploymentStorage):
 
     _block_type_name = "Local File System"
     _logo_url = "https://raw.githubusercontent.com/PrefectHQ/prefect/420d0d6a78bb6df1fc18bcf188fdad43c1d22ea9/assets/block-logos/filesystem.png"
-    _documentation_url = (
-        "https://docs.prefect.io/latest/develop/results#specifying-a-default-filesystem"
-    )
+    _documentation_url = "https://www.prefect.io/docs/latest/develop/results#specifying-a-default-filesystem"
 
     basepath: Optional[str] = Field(
         default=None, description="Default local path for this block to write to."
@@ -389,9 +387,7 @@ class RemoteFileSystem(WritableFileSystem, WritableDeploymentStorage):
 
     _block_type_name = "Remote File System"
     _logo_url = "https://raw.githubusercontent.com/PrefectHQ/prefect/420d0d6a78bb6df1fc18bcf188fdad43c1d22ea9/assets/block-logos/filesystem.png"
-    _documentation_url = (
-        "https://docs.prefect.io/latest/develop/results#specifying-a-default-filesystem"
-    )
+    _documentation_url = "https://www.prefect.io/docs/latest/develop/results#specifying-a-default-filesystem"
 
     basepath: str = Field(
         default=...,
@@ -708,9 +704,7 @@ class SMB(WritableFileSystem, WritableDeploymentStorage):
 
     _block_type_name = "SMB"
     _logo_url = "https://raw.githubusercontent.com/PrefectHQ/prefect/420d0d6a78bb6df1fc18bcf188fdad43c1d22ea9/assets/block-logos/smb.png"
-    _documentation_url = (
-        "https://docs.prefect.io/latest/develop/results#specifying-a-default-filesystem"
-    )
+    _documentation_url = "https://www.prefect.io/docs/latest/develop/results#specifying-a-default-filesystem"
 
     share_path: str = Field(
         default=...,

{prefect_client-3.9.1.dev4 → prefect_client-3.9.1.dev6}/src/prefect/server/api/artifacts.py

@@ -29,7 +29,7 @@ async def create_artifact(
     """
     Create an artifact.
 
-    For more information, see https://docs.prefect.io/v3/concepts/artifacts.
+    For more information, see https://www.prefect.io/docs/v3/concepts/artifacts.
     """
     artifact = core.Artifact(**artifact.model_dump())
 

{prefect_client-3.9.1.dev4 → prefect_client-3.9.1.dev6}/src/prefect/server/api/automations.py

@@ -43,7 +43,7 @@ async def create_automation(
     """
     Create an automation.
 
-    For more information, see https://docs.prefect.io/v3/concepts/automations.
+    For more information, see https://www.prefect.io/docs/v3/concepts/automations.
     """
     # reset any client-provided IDs on the provided triggers
     automation.trigger.reset_ids()

{prefect_client-3.9.1.dev4 → prefect_client-3.9.1.dev6}/src/prefect/server/api/block_capabilities.py

@@ -22,7 +22,7 @@ async def read_available_block_capabilities(
     """
     Get available block capabilities.
 
-    For more information, see https://docs.prefect.io/v3/concepts/blocks.
+    For more information, see https://www.prefect.io/docs/v3/concepts/blocks.
     """
     async with db.session_context() as session:
         return await models.block_schemas.read_available_block_capabilities(

{prefect_client-3.9.1.dev4 → prefect_client-3.9.1.dev6}/src/prefect/server/api/block_documents.py

@@ -25,7 +25,7 @@ async def create_block_document(
     """
     Create a new block document.
 
-    For more information, see https://docs.prefect.io/v3/concepts/blocks.
+    For more information, see https://www.prefect.io/docs/v3/concepts/blocks.
     """
     async with db.session_context(begin_transaction=True) as session:
         if block_document.name is not None:

{prefect_client-3.9.1.dev4 → prefect_client-3.9.1.dev6}/src/prefect/server/api/block_schemas.py

@@ -33,7 +33,7 @@ async def create_block_schema(
     """
     Create a block schema.
 
-    For more information, see https://docs.prefect.io/v3/concepts/blocks.
+    For more information, see https://www.prefect.io/docs/v3/concepts/blocks.
     """
     from prefect.blocks.core import Block
 

{prefect_client-3.9.1.dev4 → prefect_client-3.9.1.dev6}/src/prefect/server/api/block_types.py

@@ -21,7 +21,7 @@ async def create_block_type(
     """
     Create a new block type.
 
-    For more information, see https://docs.prefect.io/v3/concepts/blocks.
+    For more information, see https://www.prefect.io/docs/v3/concepts/blocks.
     """
     # API-created blocks cannot start with the word "Prefect"
     # as it is reserved for system use

{prefect_client-3.9.1.dev4 → prefect_client-3.9.1.dev6}/src/prefect/server/api/clients.py

@@ -1,13 +1,22 @@
 from __future__ import annotations
 
 import base64
-from typing import TYPE_CHECKING, Any, Dict, List, Optional
+import contextvars
+from contextlib import asynccontextmanager
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    AsyncIterator,
+    Dict,
+    List,
+    Optional,
+)
 from urllib.parse import quote
 from uuid import UUID
 
 import httpx
 import pydantic
-from httpx import Response
+from httpx import Request, Response
 from starlette import status
 from typing_extensions import Self
 
@@ -27,6 +36,29 @@ if TYPE_CHECKING:
 logger: "logging.Logger" = get_logger(__name__)
 
 
+_request_scoped_headers: contextvars.ContextVar[Optional[Dict[str, str]]] = (
+    contextvars.ContextVar("_request_scoped_headers", default=None)
+)
+
+
+async def _apply_scoped_headers(request: Request) -> None:
+    extras = _request_scoped_headers.get()
+    if not extras:
+        return
+    for name, value in extras.items():
+        request.headers[name] = value
+
+
+@asynccontextmanager
+async def scoped_headers(headers: Dict[str, str]) -> AsyncIterator[None]:
+    """Attach headers to every request sent by a shared client in this scope."""
+    token = _request_scoped_headers.set(headers)
+    try:
+        yield
+    finally:
+        _request_scoped_headers.reset(token)
+
+
 class BaseClient:
     _http_client: PrefectHttpxAsyncClient
 
@@ -53,6 +85,7 @@ class BaseClient:
             base_url=f"http://prefect-in-memory{settings.server.api.base_path or '/api'}",
             enable_csrf_support=settings.server.api.csrf_protection_enabled,
             raise_on_all_errors=False,
+            event_hooks={"request": [_apply_scoped_headers]},
         )
 
     async def __aenter__(self) -> Self:

{prefect_client-3.9.1.dev4 → prefect_client-3.9.1.dev6}/src/prefect/server/api/collections_data/views/aggregate-worker-metadata.json

@@ -56,7 +56,7 @@
       },
       "description": "Execute flow runs as subprocesses on a worker. Works well for local execution when first getting started.",
       "display_name": "Process",
-      "documentation_url": "https://docs.prefect.io/latest/api-ref/prefect/workers/process/",
+      "documentation_url": "https://www.prefect.io/docs/latest/api-ref/prefect/workers/process/",
       "install_command": "pip install prefect",
       "is_beta": false,
       "logo_url": "https://raw.githubusercontent.com/PrefectHQ/prefect/420d0d6a78bb6df1fc18bcf188fdad43c1d22ea9/assets/block-logos/process.png",

{prefect_client-3.9.1.dev4 → prefect_client-3.9.1.dev6}/src/prefect/server/api/concurrency_limits.py

@@ -48,7 +48,7 @@ async def create_concurrency_limit(
     """
     Create a task run concurrency limit.
 
-    For more information, see https://docs.prefect.io/v3/concepts/tag-based-concurrency-limits.
+    For more information, see https://www.prefect.io/docs/v3/concepts/tag-based-concurrency-limits.
     """
     # Always create V2 limits (no V1 record)
     v2_name = f"tag:{concurrency_limit.tag}"