prefect-client 3.7.3.dev4__tar.gz → 3.7.3.dev5__tar.gz

{prefect_client-3.7.3.dev4 → prefect_client-3.7.3.dev5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: prefect-client
-Version: 3.7.3.dev4
+Version: 3.7.3.dev5
 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.3.dev4 → prefect_client-3.7.3.dev5}/src/prefect/AGENTS.md

@@ -32,6 +32,7 @@ There is no formal public/private boundary beyond the `_` prefix convention. Mod
 - **Nested task submissions on a bounded `ThreadPoolTaskRunner` can deadlock.** When a worker task submits children and blocks on `.result()` while all `max_workers` threads are busy, the pool starves. `_warn_if_nested_submit_would_deadlock` detects this and emits a one-time warning — preserve this detection when changing pool management.
 - **Result storage resolves through three tiers, potentially making an API call.** `get_default_result_storage()` checks: (1) `PREFECT_DEFAULT_RESULT_STORAGE_BLOCK` setting, (2) server-configured default block (API call to the server's Configuration store), (3) local storage path. The API call is silently suppressed on any HTTP error. Engines use `_get_default_persist_result()` — not `should_persist_result()` — at context setup time to auto-enable persistence when a server default block is configured. Do not swap `_get_default_persist_result()` back to `should_persist_result()` in engine initialization paths; `should_persist_result()` does not consult the server default.
 - **`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.
 
 ## Logging

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

@@ -0,0 +1,5 @@
+# Generated by versioningit
+__version__ = "3.7.3.dev5"
+__build_date__ = "2026-05-28 09:23:34.780141+00:00"
+__git_commit__ = "f7d76f21e9731cedf0462e3f9632133e1c23a439"
+__dirty__ = False

{prefect_client-3.7.3.dev4 → prefect_client-3.7.3.dev5}/src/prefect/_internal/result_records.py

@@ -16,6 +16,7 @@ from uuid import UUID
 from pydantic import (
     BaseModel,
     Field,
+    PrivateAttr,
     ValidationError,
     field_validator,
     model_validator,
@@ -105,6 +106,14 @@ class ResultRecord(BaseModel, Generic[R]):
 
     metadata: ResultRecordMetadata
     result: R
+    _persisted: bool = PrivateAttr(default=False)
+
+    @property
+    def is_persisted(self) -> bool:
+        return self._persisted
+
+    def mark_persisted(self) -> None:
+        self._persisted = True
 
     @property
     def expiration(self) -> DateTime | None:

{prefect_client-3.7.3.dev4 → prefect_client-3.7.3.dev5}/src/prefect/results.py

@@ -867,6 +867,7 @@ class ResultStore(BaseModel):
 
         if self.cache_result_in_memory:
             self.cache[resolved_key_path] = result_record
+        result_record.mark_persisted()
         return result_record
 
     def _read(self, key: str, holder: str) -> "ResultRecord[Any]":
@@ -936,6 +937,7 @@ class ResultStore(BaseModel):
 
         if self.cache_result_in_memory:
             self.cache[resolved_key_path] = result_record
+        result_record.mark_persisted()
         return result_record
 
     def read(
@@ -1122,6 +1124,7 @@ class ResultStore(BaseModel):
                 (result_record.metadata.storage_key,),
                 {"content": result_record.serialize()},
             )
+        result_record.mark_persisted()
         if self.cache_result_in_memory:
             self.cache[key] = result_record
 
@@ -1185,6 +1188,7 @@ class ResultStore(BaseModel):
                 (result_record.metadata.storage_key,),
                 {"content": result_record.serialize()},
             )
+        result_record.mark_persisted()
         if self.cache_result_in_memory:
             self.cache[key] = result_record
 

{prefect_client-3.7.3.dev4 → prefect_client-3.7.3.dev5}/src/prefect/runner/AGENTS.md

@@ -138,7 +138,11 @@ These validations exist to prevent git argument injection. Do not bypass them wh
 
 **Env/sys.path isolation:** `_prepared_workspace_context` mutates `os.environ` and `sys.path` in the caller process but does NOT change `os.getcwd()`. The parent working directory is preserved.
 
-**Automatic `uv` command selection:** When no explicit command is passed, `WorkspaceResolvingEngineCommandStarter` auto-selects `uv run --project <project_root> -m prefect.flow_engine` — but only when all three conditions hold: `pyproject.toml` exists at `project_root`, the `project.dependencies` list includes `prefect`, and `uv` is found via the workspace's `PATH` env var (not the system PATH). If any condition fails, the command falls back to `None`. Explicit commands always take precedence.
+**Local path in-place execution:** When no pull steps are configured and the entrypoint file exists at `deployment.path` but not in the workspace root, `prepare_workspace` sets `working_directory` to the local path — not under `workspace_root`. The workspace directory is still created but is not the execution root. This is the "image-baked" pattern: code lives at a fixed local path (e.g., inside a container), not in object storage.
+
+**Pull-step directory fallback:** When pull steps run but none produces a `directory` output or changes CWD, `_ensure_entrypoint_in_workspace` copies storage into the workspace root as a fallback. This handles setup-only pull steps (e.g., `run_shell_script` for environment prep) that do not control the working directory themselves.
+
+**Automatic dependency installation:** By default, `WorkspaceResolvingEngineCommandStarter` does not install dependencies before starting a flow run. When no explicit command is passed and `PREFECT_RUNNER_AUTO_INSTALL_DEPENDENCIES` is true, it auto-selects `uv run --no-default-groups --project <project_root> -m prefect.flow_engine` — but only when all three conditions hold: `pyproject.toml` exists at `project_root`, the `project.dependencies` list includes `prefect`, and `uv` is found via the workspace's `PATH` env var (not the system PATH). If the setting is false or any condition fails, the command falls back to `None`. Explicit commands always take precedence.
 
 ## Reference
 

{prefect_client-3.7.3.dev4 → prefect_client-3.7.3.dev5}/src/prefect/runner/_workspace_starter.py

@@ -167,6 +167,9 @@ def _pyproject_declares_prefect_dependency(pyproject: Path) -> bool:
 
 
 def _uv_run_command(workspace: PreparedWorkspace) -> str | None:
+    if not get_current_settings().runner.auto_install_dependencies:
+        return None
+
     project_root = workspace.project_root
     if project_root is None:
         return None
@@ -188,6 +191,7 @@ def _uv_run_command(workspace: PreparedWorkspace) -> str | None:
         [
             uv_executable,
             "run",
+            "--no-default-groups",
             "--project",
             str(project_root),
             "-m",

prefect_client-3.7.3.dev5/src/prefect/server/api/__init__.py

@@ -0,0 +1,86 @@
+from __future__ import annotations
+
+import importlib
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from prefect.server.api import (
+        admin,
+        artifacts,
+        automations,
+        block_capabilities,
+        block_documents,
+        block_schemas,
+        block_types,
+        collections,
+        concurrency_limits,
+        concurrency_limits_v2,
+        csrf_token,
+        dependencies,
+        deployments,
+        events,
+        flow_run_states,
+        flow_runs,
+        flows,
+        logs,
+        middleware,
+        root,
+        run_history,
+        saved_searches,
+        server,
+        task_run_states,
+        task_runs,
+        task_workers,
+        templates,
+        ui,
+        variables,
+        work_queues,
+        workers,
+    )
+
+__all__ = [
+    "admin",
+    "artifacts",
+    "automations",
+    "block_capabilities",
+    "block_documents",
+    "block_schemas",
+    "block_types",
+    "collections",
+    "concurrency_limits",
+    "concurrency_limits_v2",
+    "csrf_token",
+    "dependencies",
+    "deployments",
+    "events",
+    "flow_run_states",
+    "flow_runs",
+    "flows",
+    "logs",
+    "middleware",
+    "root",
+    "run_history",
+    "saved_searches",
+    "server",
+    "task_run_states",
+    "task_runs",
+    "task_workers",
+    "templates",
+    "ui",
+    "variables",
+    "work_queues",
+    "workers",
+]
+
+
+def __getattr__(name: str) -> object:
+    module_name = f"{__name__}.{name}"
+    try:
+        module = importlib.import_module(module_name)
+    except ModuleNotFoundError as exc:
+        if exc.name != module_name:
+            raise
+        raise AttributeError(f"module {__name__!r} has no attribute {name!r}") from None
+
+    globals()[name] = module
+    return module

prefect_client-3.7.3.dev5/src/prefect/settings/_types.py

@@ -0,0 +1,225 @@
+# This file is generated by `scripts/generate_settings_types.py`.
+# Update the generation script to update this file.
+from typing import Literal, TypeAlias
+
+SettingAccessor: TypeAlias = Literal[
+    "api.auth_string",
+    "api.enable_http2",
+    "api.key",
+    "api.request_timeout",
+    "api.ssl_cert_file",
+    "api.tls_insecure_skip_verify",
+    "api.url",
+    "cli.colors",
+    "cli.prompt",
+    "cli.wrap_lines",
+    "client.csrf_support_enabled",
+    "client.custom_headers",
+    "client.max_retries",
+    "client.metrics.enabled",
+    "client.metrics.port",
+    "client.retry_extra_codes",
+    "client.retry_jitter_factor",
+    "client.server_version_check_enabled",
+    "cloud.api_url",
+    "cloud.enable_orchestration_telemetry",
+    "cloud.max_log_size",
+    "cloud.ui_url",
+    "debug_mode",
+    "deployments.default_docker_build_namespace",
+    "deployments.default_work_pool_name",
+    "events.worker_max_queue_size",
+    "experiments.warn",
+    "flows.default_retries",
+    "flows.default_retry_delay_seconds",
+    "flows.heartbeat_frequency",
+    "home",
+    "internal.logging_level",
+    "logging.colors",
+    "logging.config_path",
+    "logging.extra_loggers",
+    "logging.level",
+    "logging.log_prints",
+    "logging.markup",
+    "logging.to_api.batch_interval",
+    "logging.to_api.batch_size",
+    "logging.to_api.enabled",
+    "logging.to_api.max_log_size",
+    "logging.to_api.when_missing_flow",
+    "plugins.allow",
+    "plugins.deny",
+    "plugins.enabled",
+    "plugins.safe_mode",
+    "plugins.setup_timeout_seconds",
+    "plugins.strict",
+    "profiles_path",
+    "results.default_serializer",
+    "results.default_storage_block",
+    "results.local_storage_path",
+    "results.persist_by_default",
+    "runner.crash_on_cancellation_failure",
+    "runner.poll_frequency",
+    "runner.process_limit",
+    "runner.server.enable",
+    "runner.server.host",
+    "runner.server.log_level",
+    "runner.server.missed_polls_tolerance",
+    "runner.server.port",
+    "server.analytics_enabled",
+    "server.api.auth_string",
+    "server.api.base_path",
+    "server.api.cors_allowed_headers",
+    "server.api.cors_allowed_methods",
+    "server.api.cors_allowed_origins",
+    "server.api.csrf_protection_enabled",
+    "server.api.csrf_token_expiration",
+    "server.api.default_limit",
+    "server.api.host",
+    "server.api.keepalive_timeout",
+    "server.api.max_parameter_size",
+    "server.api.port",
+    "server.api.websocket_ping_interval",
+    "server.api.websocket_ping_timeout",
+    "server.concurrency.initial_deployment_lease_duration",
+    "server.concurrency.lease_storage",
+    "server.concurrency.maximum_concurrency_slot_wait_seconds",
+    "server.database.connection_timeout",
+    "server.database.connection_url",
+    "server.database.driver",
+    "server.database.echo",
+    "server.database.host",
+    "server.database.migrate_on_start",
+    "server.database.name",
+    "server.database.password",
+    "server.database.port",
+    "server.database.sqlalchemy.connect_args.application_name",
+    "server.database.sqlalchemy.connect_args.prepared_statement_cache_size",
+    "server.database.sqlalchemy.connect_args.search_path",
+    "server.database.sqlalchemy.connect_args.statement_cache_size",
+    "server.database.sqlalchemy.connect_args.tls.ca_file",
+    "server.database.sqlalchemy.connect_args.tls.cert_file",
+    "server.database.sqlalchemy.connect_args.tls.check_hostname",
+    "server.database.sqlalchemy.connect_args.tls.enabled",
+    "server.database.sqlalchemy.connect_args.tls.key_file",
+    "server.database.sqlalchemy.max_overflow",
+    "server.database.sqlalchemy.pool_recycle",
+    "server.database.sqlalchemy.pool_size",
+    "server.database.sqlalchemy.pool_timeout",
+    "server.database.timeout",
+    "server.database.user",
+    "server.deployment_schedule_max_scheduled_runs",
+    "server.deployments.concurrency_slot_wait_seconds",
+    "server.docket.name",
+    "server.docket.url",
+    "server.ephemeral.enabled",
+    "server.ephemeral.startup_timeout_seconds",
+    "server.events.causal_ordering",
+    "server.events.expired_bucket_buffer",
+    "server.events.maximum_event_name_length",
+    "server.events.maximum_labels_per_resource",
+    "server.events.maximum_related_resources",
+    "server.events.maximum_size_bytes",
+    "server.events.maximum_websocket_backfill",
+    "server.events.messaging_broker",
+    "server.events.messaging_cache",
+    "server.events.proactive_granularity",
+    "server.events.related_resource_cache_ttl",
+    "server.events.retention_period",
+    "server.events.stream_out_enabled",
+    "server.events.websocket_backfill_page_size",
+    "server.flow_run_graph.max_artifacts",
+    "server.flow_run_graph.max_nodes",
+    "server.log_retryable_errors",
+    "server.logging_level",
+    "server.logs.stream_out_enabled",
+    "server.logs.stream_publishing_enabled",
+    "server.memo_store_path",
+    "server.memoize_block_auto_registration",
+    "server.metrics_enabled",
+    "server.register_blocks_on_start",
+    "server.services.cancellation_cleanup.enabled",
+    "server.services.cancellation_cleanup.loop_seconds",
+    "server.services.db_vacuum.batch_size",
+    "server.services.db_vacuum.enabled",
+    "server.services.db_vacuum.event_retention_overrides",
+    "server.services.db_vacuum.loop_seconds",
+    "server.services.db_vacuum.retention_period",
+    "server.services.event_logger.enabled",
+    "server.services.event_persister.batch_size",
+    "server.services.event_persister.enabled",
+    "server.services.event_persister.flush_interval",
+    "server.services.event_persister.max_flush_retries",
+    "server.services.event_persister.queue_max_size",
+    "server.services.event_persister.read_batch_size",
+    "server.services.foreman.deployment_last_polled_timeout_seconds",
+    "server.services.foreman.enabled",
+    "server.services.foreman.fallback_heartbeat_interval_seconds",
+    "server.services.foreman.inactivity_heartbeat_multiple",
+    "server.services.foreman.loop_seconds",
+    "server.services.foreman.work_queue_last_polled_timeout_seconds",
+    "server.services.late_runs.after_seconds",
+    "server.services.late_runs.enabled",
+    "server.services.late_runs.loop_seconds",
+    "server.services.pause_expirations.enabled",
+    "server.services.pause_expirations.loop_seconds",
+    "server.services.repossessor.enabled",
+    "server.services.repossessor.loop_seconds",
+    "server.services.scheduler.deployment_batch_size",
+    "server.services.scheduler.enabled",
+    "server.services.scheduler.insert_batch_size",
+    "server.services.scheduler.loop_seconds",
+    "server.services.scheduler.max_runs",
+    "server.services.scheduler.max_scheduled_time",
+    "server.services.scheduler.min_runs",
+    "server.services.scheduler.min_scheduled_time",
+    "server.services.scheduler.recent_deployments_loop_seconds",
+    "server.services.task_run_recorder.batch_size",
+    "server.services.task_run_recorder.enabled",
+    "server.services.task_run_recorder.flush_interval",
+    "server.services.task_run_recorder.read_batch_size",
+    "server.services.triggers.enabled",
+    "server.services.triggers.pg_notify_heartbeat_interval_seconds",
+    "server.services.triggers.pg_notify_reconnect_interval_seconds",
+    "server.services.triggers.read_batch_size",
+    "server.tasks.max_cache_key_length",
+    "server.tasks.scheduling.max_retry_queue_size",
+    "server.tasks.scheduling.max_scheduled_queue_size",
+    "server.tasks.scheduling.pending_task_timeout",
+    "server.tasks.tag_concurrency_slot_wait_seconds",
+    "server.ui.api_url",
+    "server.ui.enabled",
+    "server.ui.serve_base",
+    "server.ui.show_promotional_content",
+    "server.ui.static_directory",
+    "server.ui.v2_enabled",
+    "server.worker_channel.cleanup_completed_idempotency_retention_seconds",
+    "server.worker_channel.cleanup_lease_seconds",
+    "server.worker_channel.cleanup_max_delivery_attempts",
+    "server.worker_channel.cleanup_queue_storage",
+    "silence_api_url_misconfiguration",
+    "tasks.default_no_cache",
+    "tasks.default_persist_result",
+    "tasks.default_retries",
+    "tasks.default_retry_delay_seconds",
+    "tasks.disable_caching",
+    "tasks.refresh_cache",
+    "tasks.runner.process_pool_max_workers",
+    "tasks.runner.thread_pool_max_workers",
+    "tasks.scheduling.default_storage_block",
+    "tasks.scheduling.delete_failed_submissions",
+    "telemetry.enable_resource_metrics",
+    "telemetry.resource_metrics_interval_seconds",
+    "testing.test_mode",
+    "testing.test_setting",
+    "testing.unit_test_loop_debug",
+    "testing.unit_test_mode",
+    "ui_url",
+    "worker.cancellation_poll_seconds",
+    "worker.debug_mode",
+    "worker.enable_cancellation",
+    "worker.heartbeat_seconds",
+    "worker.prefetch_seconds",
+    "worker.query_seconds",
+    "worker.webserver.host",
+    "worker.webserver.port",
+]

{prefect_client-3.7.3.dev4 → prefect_client-3.7.3.dev5}/src/prefect/settings/context.py

@@ -4,8 +4,11 @@ from typing import TYPE_CHECKING, Any, Generator, Iterable, Mapping, Optional
 from prefect.settings.models.root import Settings
 
 if TYPE_CHECKING:
+    from prefect.settings._types import SettingAccessor
     from prefect.settings.legacy import Setting
 
+    SettingKey = Setting | SettingAccessor
+
 
 def get_current_settings() -> Settings:
     """
@@ -23,9 +26,9 @@ def get_current_settings() -> Settings:
 
 @contextmanager
 def temporary_settings(
-    updates: Optional[Mapping["Setting", Any]] = None,
-    set_defaults: Optional[Mapping["Setting", Any]] = None,
-    restore_defaults: Optional[Iterable["Setting"]] = None,
+    updates: Optional[Mapping["SettingKey", Any]] = None,
+    set_defaults: Optional[Mapping["SettingKey", Any]] = None,
+    restore_defaults: Optional[Iterable["SettingKey"]] = None,
 ) -> Generator[Settings, None, None]:
     """
     Temporarily override the current settings by entering a new profile.
@@ -40,6 +43,9 @@ def temporary_settings(
         with temporary_settings(updates={PREFECT_API_URL: "foo"}):
            assert PREFECT_API_URL.value() == "foo"
 
+           with temporary_settings(updates={"api.url": "bar"}):
+                assert get_current_settings().api.url == "bar"
+
            with temporary_settings(set_defaults={PREFECT_API_URL: "bar"}):
                 assert PREFECT_API_URL.value() == "foo"
 

{prefect_client-3.7.3.dev4 → prefect_client-3.7.3.dev5}/src/prefect/settings/models/root.py

@@ -1,4 +1,6 @@
+import inspect
 import warnings
+from functools import cache
 from pathlib import Path
 from typing import (
     TYPE_CHECKING,
@@ -11,7 +13,7 @@ from typing import (
 )
 from urllib.parse import urlparse
 
-from pydantic import BeforeValidator, Field, SecretStr, model_validator
+from pydantic import AliasChoices, BeforeValidator, Field, SecretStr, model_validator
 from pydantic_settings import SettingsConfigDict
 from typing_extensions import Self
 
@@ -44,9 +46,51 @@ from .server import ServerSettings
 from .telemetry import TelemetrySettings
 
 if TYPE_CHECKING:
+    from prefect.settings._types import SettingAccessor
     from prefect.settings.legacy import Setting
 
 
+@cache
+def _get_settings_accessors(
+    settings: type[PrefectBaseSettings], accessor_prefix: Optional[str] = None
+) -> dict[str, str]:
+    settings_accessors: dict[str, str] = {}
+    for field_name, field in settings.model_fields.items():
+        accessor = (
+            field_name if accessor_prefix is None else f"{accessor_prefix}.{field_name}"
+        )
+        if inspect.isclass(field.annotation) and issubclass(
+            field.annotation, PrefectBaseSettings
+        ):
+            settings_accessors.update(
+                _get_settings_accessors(field.annotation, accessor)
+            )
+        else:
+            settings_accessors[accessor] = accessor
+            if field.validation_alias and isinstance(
+                field.validation_alias, AliasChoices
+            ):
+                for alias in field.validation_alias.choices:
+                    if isinstance(alias, str):
+                        settings_accessors[alias.upper()] = accessor
+            else:
+                settings_accessors[
+                    f"{settings.model_config.get('env_prefix')}{field_name.upper()}"
+                ] = accessor
+
+    return settings_accessors
+
+
+def _get_setting_accessor(setting: "Setting | str") -> str:
+    if not isinstance(setting, str):
+        return setting.accessor
+
+    try:
+        return _get_settings_accessors(Settings)[setting]
+    except KeyError:
+        raise ValueError(f"Unknown setting: {setting!r}") from None
+
+
 class Settings(PrefectBaseSettings):
     """
     Settings for Prefect using Pydantic settings.
@@ -336,9 +380,9 @@ class Settings(PrefectBaseSettings):
 
     def copy_with_update(
         self: Self,
-        updates: Optional[Mapping["Setting", Any]] = None,
-        set_defaults: Optional[Mapping["Setting", Any]] = None,
-        restore_defaults: Optional[Iterable["Setting"]] = None,
+        updates: Optional[Mapping["Setting | SettingAccessor", Any]] = None,
+        set_defaults: Optional[Mapping["Setting | SettingAccessor", Any]] = None,
+        restore_defaults: Optional[Iterable["Setting | SettingAccessor"]] = None,
     ) -> Self:
         """
         Create a new Settings object with validation.
@@ -358,7 +402,8 @@ class Settings(PrefectBaseSettings):
         # defaults, all settings sources will be ignored.
         restore_defaults_obj: dict[str, Any] = {}
         for r in restore_defaults or []:
-            path = r.accessor.split(".")
+            accessor = _get_setting_accessor(r)
+            path = accessor.split(".")
             model = self
             model_cls = model.__class__
             model_fields = model_cls.model_fields
@@ -366,11 +411,11 @@ class Settings(PrefectBaseSettings):
                 model_field = model_fields[key]
                 model_cls = model_field.annotation
                 if model_cls is None:
-                    raise ValueError(f"Invalid setting path: {r.accessor}")
+                    raise ValueError(f"Invalid setting path: {accessor}")
                 model_fields = model_cls.model_fields
 
             model_field = model_fields[path[-1]]
-            assert model_field is not None, f"Invalid setting path: {r.accessor}"
+            assert model_field is not None, f"Invalid setting path: {accessor}"
             if hasattr(model_field, "default"):
                 default = model_field.default
             elif (
@@ -378,10 +423,10 @@ class Settings(PrefectBaseSettings):
             ):
                 default = model_field.default_factory()
             else:
-                raise ValueError(f"No default value for setting: {r.accessor}")
+                raise ValueError(f"No default value for setting: {accessor}")
             set_in_dict(
                 restore_defaults_obj,
-                r.accessor,
+                accessor,
                 default,
             )
         updates = updates or {}
@@ -389,11 +434,11 @@ class Settings(PrefectBaseSettings):
 
         set_defaults_obj: dict[str, Any] = {}
         for setting, value in set_defaults.items():
-            set_in_dict(set_defaults_obj, setting.accessor, value)
+            set_in_dict(set_defaults_obj, _get_setting_accessor(setting), value)
 
         updates_obj: dict[str, Any] = {}
         for setting, value in updates.items():
-            set_in_dict(updates_obj, setting.accessor, value)
+            set_in_dict(updates_obj, _get_setting_accessor(setting), value)
 
         new_settings = self.__class__.model_validate(
             deep_merge_dicts(

{prefect_client-3.7.3.dev4 → prefect_client-3.7.3.dev5}/src/prefect/settings/models/runner.py

@@ -71,6 +71,15 @@ class RunnerSettings(PrefectBaseSettings):
         ),
     )
 
+    auto_install_dependencies: bool = Field(
+        default=False,
+        description=(
+            "Whether runners may install dependencies before executing flow runs. "
+            "Enable this when deployments pull code that needs dependencies prepared "
+            "at runtime."
+        ),
+    )
+
     server: RunnerServerSettings = Field(
         default_factory=RunnerServerSettings,
         description="Settings for controlling runner server behavior",

{prefect_client-3.7.3.dev4 → prefect_client-3.7.3.dev5}/src/prefect/settings/models/server/api.py

@@ -144,6 +144,16 @@ class ServerAPISettings(PrefectBaseSettings):
         ),
     )
 
+    websocket_ping_interval: float = Field(
+        default=20.0,
+        description="WebSocket ping interval in seconds. Only applies when starting the server with `prefect server start`.",
+    )
+
+    websocket_ping_timeout: float = Field(
+        default=20.0,
+        description="WebSocket ping timeout in seconds. Only applies when starting the server with `prefect server start`.",
+    )
+
     max_parameter_size: int = Field(
         default=524_288,
         description="The maximum size of parameters (in bytes, JSON-serialized) that can be stored on a flow run or deployment. Set to 0 to disable the limit.",

{prefect_client-3.7.3.dev4 → prefect_client-3.7.3.dev5}/src/prefect/settings/models/server/root.py

@@ -22,6 +22,7 @@ from .logs import ServerLogsSettings
 from .services import ServerServicesSettings
 from .tasks import ServerTasksSettings
 from .ui import ServerUISettings
+from .worker_channel import ServerWorkerChannelSettings
 
 
 class ServerSettings(PrefectBaseSettings):
@@ -157,3 +158,7 @@ class ServerSettings(PrefectBaseSettings):
         default_factory=ServerUISettings,
         description="Settings for controlling server UI behavior",
     )
+    worker_channel: ServerWorkerChannelSettings = Field(
+        default_factory=ServerWorkerChannelSettings,
+        description="Settings for controlling server worker channel behavior",
+    )