@temporalio/core-bridge 1.15.0 → 1.16.1

package/sdk-core/crates/common/src/worker.rs

@@ -1,22 +1,15 @@
 //! Contains types that are needed by both the client and the sdk when configuring / interacting
 //! with workers.
 
-use crate::{
-    errors::WorkflowErrorType,
-    protos::{
-        coresdk,
-        coresdk::{ActivitySlotInfo, LocalActivitySlotInfo, NexusSlotInfo, WorkflowSlotInfo},
-        temporal,
-        temporal::api::{enums::v1::VersioningBehavior, worker::v1::PluginInfo},
-    },
-    telemetry::metrics::TemporalMeter,
+use crate::protos::{
+    coresdk, temporal,
+    temporal::api::enums::v1::{TaskQueueType, VersioningBehavior},
 };
 use std::{
-    any::Any,
-    collections::{HashMap, HashSet},
+    fs::File,
+    io::{self, BufReader, Read},
     str::FromStr,
-    sync::Arc,
-    time::Duration,
+    sync::OnceLock,
 };
 
 /// Specifies which task types a worker will poll for.
@@ -24,9 +17,13 @@ use std::{
 /// Workers can be configured to handle any combination of workflows, activities, and nexus operations.
 #[derive(Clone, Copy, Debug, PartialEq, Eq, Hash)]
 pub struct WorkerTaskTypes {
+    /// Whether workflow tasks are enabled.
     pub enable_workflows: bool,
+    /// Whether local activity tasks are enabled.
     pub enable_local_activities: bool,
+    /// Whether remote activity tasks are enabled.
     pub enable_remote_activities: bool,
+    /// Whether nexus tasks are enabled.
     pub enable_nexus: bool,
 }
 
@@ -79,609 +76,31 @@ impl WorkerTaskTypes {
         }
     }
 
+    /// Returns true if any task type is enabled in both configs.
     pub fn overlaps_with(&self, other: &WorkerTaskTypes) -> bool {
         (self.enable_workflows && other.enable_workflows)
             || (self.enable_local_activities && other.enable_local_activities)
             || (self.enable_remote_activities && other.enable_remote_activities)
             || (self.enable_nexus && other.enable_nexus)
     }
-}
-
-/// Defines per-worker configuration options
-#[derive(Clone, bon::Builder)]
-#[builder(on(String, into), state_mod(vis = "pub"), finish_fn(vis = "", name = build_internal))]
-#[non_exhaustive]
-pub struct WorkerConfig {
-    /// The Temporal service namespace this worker is bound to
-    pub namespace: String,
-    /// What task queue will this worker poll from? This task queue name will be used for both
-    /// workflow and activity polling.
-    pub task_queue: String,
-    /// A human-readable string that can identify this worker. Using something like sdk version
-    /// and host name is a good default. If set, overrides the identity set (if any) on the client
-    /// used by this worker.
-    pub client_identity_override: Option<String>,
-    /// If set nonzero, workflows will be cached and sticky task queues will be used, meaning that
-    /// history updates are applied incrementally to suspended instances of workflow execution.
-    /// Workflows are evicted according to a least-recently-used policy one the cache maximum is
-    /// reached. Workflows may also be explicitly evicted at any time, or as a result of errors
-    /// or failures.
-    #[builder(default = 0)]
-    pub max_cached_workflows: usize,
-    /// Set a [WorkerTuner] for this worker. Either this or at least one of the `max_outstanding_*`
-    /// fields must be set.
-    pub tuner: Option<Arc<dyn WorkerTuner + Send + Sync>>,
-    /// Maximum number of concurrent poll workflow task requests we will perform at a time on this
-    /// worker's task queue. See also [WorkerConfig::nonsticky_to_sticky_poll_ratio].
-    /// If using SimpleMaximum, Must be at least 2 when `max_cached_workflows` > 0, or is an error.
-    #[builder(default = PollerBehavior::SimpleMaximum(5))]
-    pub workflow_task_poller_behavior: PollerBehavior,
-    /// Only applies when using [PollerBehavior::SimpleMaximum]
-    ///
-    /// (max workflow task polls * this number) = the number of max pollers that will be allowed for
-    /// the nonsticky queue when sticky tasks are enabled. If both defaults are used, the sticky
-    /// queue will allow 4 max pollers while the nonsticky queue will allow one. The minimum for
-    /// either poller is 1, so if the maximum allowed is 1 and sticky queues are enabled, there will
-    /// be 2 concurrent polls.
-    #[builder(default = 0.2)]
-    pub nonsticky_to_sticky_poll_ratio: f32,
-    /// Maximum number of concurrent poll activity task requests we will perform at a time on this
-    /// worker's task queue
-    #[builder(default = PollerBehavior::SimpleMaximum(5))]
-    pub activity_task_poller_behavior: PollerBehavior,
-    /// Maximum number of concurrent poll nexus task requests we will perform at a time on this
-    /// worker's task queue
-    #[builder(default = PollerBehavior::SimpleMaximum(5))]
-    pub nexus_task_poller_behavior: PollerBehavior,
-    /// Specifies which task types this worker will poll for.
-    ///
-    /// Note: At least one task type must be specified or the worker will fail validation.
-    pub task_types: WorkerTaskTypes,
-    /// How long a workflow task is allowed to sit on the sticky queue before it is timed out
-    /// and moved to the non-sticky queue where it may be picked up by any worker.
-    #[builder(default = Duration::from_secs(10))]
-    pub sticky_queue_schedule_to_start_timeout: Duration,
-
-    /// Longest interval for throttling activity heartbeats
-    #[builder(default = Duration::from_secs(60))]
-    pub max_heartbeat_throttle_interval: Duration,
-
-    /// Default interval for throttling activity heartbeats in case
-    /// `ActivityOptions.heartbeat_timeout` is unset.
-    /// When the timeout *is* set in the `ActivityOptions`, throttling is set to
-    /// `heartbeat_timeout * 0.8`.
-    #[builder(default = Duration::from_secs(30))]
-    pub default_heartbeat_throttle_interval: Duration,
-
-    /// Sets the maximum number of activities per second the task queue will dispatch, controlled
-    /// server-side. Note that this only takes effect upon an activity poll request. If multiple
-    /// workers on the same queue have different values set, they will thrash with the last poller
-    /// winning.
-    ///
-    /// Setting this to a nonzero value will also disable eager activity execution.
-    pub max_task_queue_activities_per_second: Option<f64>,
-
-    /// Limits the number of activities per second that this worker will process. The worker will
-    /// not poll for new activities if by doing so it might receive and execute an activity which
-    /// would cause it to exceed this limit. Negative, zero, or NaN values will cause building
-    /// the options to fail.
-    pub max_worker_activities_per_second: Option<f64>,
-
-    /// If set false (default), shutdown will not finish until all pending evictions have been
-    /// issued and replied to. If set true shutdown will be considered complete when the only
-    /// remaining work is pending evictions.
-    ///
-    /// This flag is useful during tests to avoid needing to deal with lots of uninteresting
-    /// evictions during shutdown. Alternatively, if a lang implementation finds it easy to clean
-    /// up during shutdown, setting this true saves some back-and-forth.
-    #[builder(default = false)]
-    pub ignore_evicts_on_shutdown: bool,
-
-    /// Maximum number of next page (or initial) history event listing requests we'll make
-    /// concurrently. I don't this it's worth exposing this to users until we encounter a reason.
-    #[builder(default = 5)]
-    pub fetching_concurrency: usize,
-
-    /// If set, core will issue cancels for all outstanding activities and nexus operations after
-    /// shutdown has been initiated and this amount of time has elapsed.
-    pub graceful_shutdown_period: Option<Duration>,
-
-    /// The amount of time core will wait before timing out activities using its own local timers
-    /// after one of them elapses. This is to avoid racing with server's own tracking of the
-    /// timeout.
-    #[builder(default = Duration::from_secs(5))]
-    pub local_timeout_buffer_for_activities: Duration,
-
-    /// Any error types listed here will cause any workflow being processed by this worker to fail,
-    /// rather than simply failing the workflow task.
-    #[builder(default)]
-    pub workflow_failure_errors: HashSet<WorkflowErrorType>,
-
-    /// Like [WorkerConfig::workflow_failure_errors], but specific to certain workflow types (the
-    /// map key).
-    #[builder(default)]
-    pub workflow_types_to_failure_errors: HashMap<String, HashSet<WorkflowErrorType>>,
-
-    /// The maximum allowed number of workflow tasks that will ever be given to this worker at one
-    /// time. Note that one workflow task may require multiple activations - so the WFT counts as
-    /// "outstanding" until all activations it requires have been completed. Must be at least 2 if
-    /// `max_cached_workflows` is > 0, or is an error.
-    ///
-    /// Mutually exclusive with `tuner`
-    #[builder(into)]
-    pub max_outstanding_workflow_tasks: Option<usize>,
-    /// The maximum number of activity tasks that will ever be given to this worker concurrently.
-    ///
-    /// Mutually exclusive with `tuner`
-    #[builder(into)]
-    pub max_outstanding_activities: Option<usize>,
-    /// The maximum number of local activity tasks that will ever be given to this worker
-    /// concurrently.
-    ///
-    /// Mutually exclusive with `tuner`
-    #[builder(into)]
-    pub max_outstanding_local_activities: Option<usize>,
-    /// The maximum number of nexus tasks that will ever be given to this worker
-    /// concurrently.
-    ///
-    /// Mutually exclusive with `tuner`
-    #[builder(into)]
-    pub max_outstanding_nexus_tasks: Option<usize>,
-
-    /// A versioning strategy for this worker.
-    pub versioning_strategy: WorkerVersioningStrategy,
-
-    /// List of plugins used by lang.
-    #[builder(default)]
-    pub plugins: HashSet<PluginInfo>,
-
-    /// Skips the single worker+client+namespace+task_queue check
-    #[builder(default = false)]
-    pub skip_client_worker_set_check: bool,
-}
-
-impl WorkerConfig {
-    /// Returns true if the configuration specifies we should fail a workflow on a certain error
-    /// type rather than failing the workflow task.
-    pub fn should_fail_workflow(
-        &self,
-        workflow_type: &str,
-        error_type: &WorkflowErrorType,
-    ) -> bool {
-        self.workflow_failure_errors.contains(error_type)
-            || self
-                .workflow_types_to_failure_errors
-                .get(workflow_type)
-                .map(|s| s.contains(error_type))
-                .unwrap_or(false)
-    }
-
-    pub fn computed_deployment_version(&self) -> Option<WorkerDeploymentVersion> {
-        let wdv = match self.versioning_strategy {
-            WorkerVersioningStrategy::None { ref build_id } => WorkerDeploymentVersion {
-                deployment_name: "".to_owned(),
-                build_id: build_id.clone(),
-            },
-            WorkerVersioningStrategy::WorkerDeploymentBased(ref opts) => opts.version.clone(),
-            WorkerVersioningStrategy::LegacyBuildIdBased { ref build_id } => {
-                WorkerDeploymentVersion {
-                    deployment_name: "".to_owned(),
-                    build_id: build_id.clone(),
-                }
-            }
-        };
-        if wdv.is_empty() { None } else { Some(wdv) }
-    }
-}
-
-impl<S: worker_config_builder::IsComplete> WorkerConfigBuilder<S> {
-    pub fn build(self) -> Result<WorkerConfig, String> {
-        let config = self.build_internal();
-        let task_types = &config.task_types;
-        if task_types.is_empty() {
-            return Err("At least one task type must be enabled in `task_types`".to_string());
-        }
-        if !task_types.enable_workflows && task_types.enable_local_activities {
-            return Err(
-                "`task_types` cannot enable local activities without workflows".to_string(),
-            );
-        }
-
-        config.workflow_task_poller_behavior.validate()?;
-        config.activity_task_poller_behavior.validate()?;
-        config.nexus_task_poller_behavior.validate()?;
-
-        if let Some(ref x) = config.max_worker_activities_per_second
-            && (!x.is_normal() || x.is_sign_negative())
-        {
-            return Err(
-                "`max_worker_activities_per_second` must be positive and nonzero".to_string(),
-            );
-        }
-
-        if matches!(config.max_outstanding_workflow_tasks, Some(v) if v == 0) {
-            return Err("`max_outstanding_workflow_tasks` must be > 0".to_string());
-        }
-        if matches!(config.max_outstanding_activities, Some(v) if v == 0) {
-            return Err("`max_outstanding_activities` must be > 0".to_string());
-        }
-        if matches!(config.max_outstanding_local_activities, Some(v) if v == 0) {
-            return Err("`max_outstanding_local_activities` must be > 0".to_string());
-        }
-        if matches!(config.max_outstanding_nexus_tasks, Some(v) if v == 0) {
-            return Err("`max_outstanding_nexus_tasks` must be > 0".to_string());
-        }
-
-        if config.max_cached_workflows > 0 {
-            if let Some(max_wft) = config.max_outstanding_workflow_tasks
-                && max_wft < 2
-            {
-                return Err(
-                    "`max_cached_workflows` > 0 requires `max_outstanding_workflow_tasks` >= 2"
-                        .to_string(),
-                );
-            }
-            if matches!(config.workflow_task_poller_behavior, PollerBehavior::SimpleMaximum(u) if u < 2)
-            {
-                return Err("`max_cached_workflows` > 0 requires `workflow_task_poller_behavior` to be at least 2".to_string());
-            }
-        }
-
-        if config.tuner.is_some()
-            && (config.max_outstanding_workflow_tasks.is_some()
-                || config.max_outstanding_activities.is_some()
-                || config.max_outstanding_local_activities.is_some())
-        {
-            return Err("max_outstanding_* fields are mutually exclusive with `tuner`".to_string());
-        }
-
-        match &config.versioning_strategy {
-            WorkerVersioningStrategy::None { .. } => {}
-            WorkerVersioningStrategy::WorkerDeploymentBased(d) => {
-                if d.use_worker_versioning
-                    && (d.version.build_id.is_empty() || d.version.deployment_name.is_empty())
-                {
-                    return Err("WorkerDeploymentVersion must have a non-empty build_id and deployment_name when deployment-based versioning is enabled".to_string());
-                }
-            }
-            WorkerVersioningStrategy::LegacyBuildIdBased { build_id } => {
-                if build_id.is_empty() {
-                    return Err(
-                        "Legacy build id-based versioning must have a non-empty build_id"
-                            .to_string(),
-                    );
-                }
-            }
-        }
-
-        Ok(config)
-    }
-}
-
-/// This trait allows users to customize the performance characteristics of workers dynamically.
-/// For more, see the docstrings of the traits in the return types of its functions.
-pub trait WorkerTuner {
-    /// Return a [SlotSupplier] for workflow tasks. Note that workflow task slot suppliers must be
-    /// willing to hand out a minimum of one non-sticky slot and one sticky slot if workflow caching
-    /// is enabled, otherwise the worker may fail to process new tasks.
-    fn workflow_task_slot_supplier(
-        &self,
-    ) -> Arc<dyn SlotSupplier<SlotKind = WorkflowSlotKind> + Send + Sync>;
-
-    /// Return a [SlotSupplier] for activity tasks
-    fn activity_task_slot_supplier(
-        &self,
-    ) -> Arc<dyn SlotSupplier<SlotKind = ActivitySlotKind> + Send + Sync>;
-
-    /// Return a [SlotSupplier] for local activities
-    fn local_activity_slot_supplier(
-        &self,
-    ) -> Arc<dyn SlotSupplier<SlotKind = LocalActivitySlotKind> + Send + Sync>;
-
-    /// Return a [SlotSupplier] for nexus tasks
-    fn nexus_task_slot_supplier(
-        &self,
-    ) -> Arc<dyn SlotSupplier<SlotKind = NexusSlotKind> + Send + Sync>;
-}
-
-/// Implementing this trait allows users to customize how many tasks of certain kinds the worker
-/// will perform concurrently.
-///
-/// Note that, for implementations on workflow tasks ([WorkflowSlotKind]), workers that have the
-/// workflow cache enabled should be willing to hand out _at least_ two slots, to avoid the worker
-/// becoming stuck only polling on the worker's sticky queue.
-#[async_trait::async_trait]
-pub trait SlotSupplier {
-    type SlotKind: SlotKind;
-    /// Block until a slot is available, then return a permit for the slot.
-    async fn reserve_slot(&self, ctx: &dyn SlotReservationContext) -> SlotSupplierPermit;
-
-    /// Try to immediately reserve a slot, returning None if one is not available. Implementations
-    /// must not block, or risk blocking the async event loop.
-    fn try_reserve_slot(&self, ctx: &dyn SlotReservationContext) -> Option<SlotSupplierPermit>;
-
-    /// Marks a slot as actually now being used. This is separate from reserving one because the
-    /// pollers need to reserve a slot before they have actually obtained work from server. Once
-    /// that task is obtained (and validated) then the slot can actually be used to work on the
-    /// task.
-    ///
-    /// Users' implementation of this can choose to emit metrics, or otherwise leverage the
-    /// information provided by the `info` parameter to be better able to make future decisions
-    /// about whether a slot should be handed out.
-    fn mark_slot_used(&self, ctx: &dyn SlotMarkUsedContext<SlotKind = Self::SlotKind>);
-
-    /// Frees a slot.
-    fn release_slot(&self, ctx: &dyn SlotReleaseContext<SlotKind = Self::SlotKind>);
-
-    /// If this implementation knows how many slots are available at any moment, it should return
-    /// that here.
-    fn available_slots(&self) -> Option<usize> {
-        None
-    }
-
-    /// Returns a human-friendly identifier describing this supplier implementation for
-    /// diagnostics and telemetry.
-    fn slot_supplier_kind(&self) -> String {
-        "Custom".to_string()
-    }
-}
-
-pub trait SlotReservationContext: Send + Sync {
-    /// Returns the name of the task queue this worker is polling
-    fn task_queue(&self) -> &str;
-
-    /// Returns the identity of the worker
-    fn worker_identity(&self) -> &str;
-
-    /// Returns the deployment version of the worker, if one is set.
-    fn worker_deployment_version(&self) -> &Option<WorkerDeploymentVersion>;
-
-    /// Returns the number of currently outstanding slot permits, whether used or un-used.
-    fn num_issued_slots(&self) -> usize;
-
-    /// Returns true iff this is a sticky poll for a workflow task
-    fn is_sticky(&self) -> bool;
-
-    /// Returns the metrics meter if metrics are enabled
-    fn get_metrics_meter(&self) -> Option<TemporalMeter> {
-        None
-    }
-}
-
-pub trait SlotMarkUsedContext: Send + Sync {
-    type SlotKind: SlotKind;
-    /// The slot permit that is being used
-    fn permit(&self) -> &SlotSupplierPermit;
-    /// Returns the info of slot that was marked as used
-    fn info(&self) -> &<Self::SlotKind as SlotKind>::Info;
-
-    /// Returns the metrics meter if metrics are enabled
-    fn get_metrics_meter(&self) -> Option<TemporalMeter> {
-        None
-    }
-}
-
-pub trait SlotReleaseContext: Send + Sync {
-    type SlotKind: SlotKind;
-    /// The slot permit that is being used
-    fn permit(&self) -> &SlotSupplierPermit;
-    /// Returns the info of slot that was released, if it was used
-    fn info(&self) -> Option<&<Self::SlotKind as SlotKind>::Info>;
-
-    /// Returns the metrics meter if metrics are enabled
-    fn get_metrics_meter(&self) -> Option<TemporalMeter> {
-        None
-    }
-}
-
-#[derive(Default, Debug)]
-pub struct SlotSupplierPermit {
-    user_data: Option<Box<dyn Any + Send + Sync>>,
-}
-impl SlotSupplierPermit {
-    pub fn with_user_data<T: Any + Send + Sync>(user_data: T) -> Self {
-        Self {
-            user_data: Some(Box::new(user_data)),
-        }
-    }
-    /// Attempts to downcast the inner data, if any, into the provided type and returns it.
-    /// Returns none if there is no data or the data is not of the appropriate type.
-    pub fn user_data<T: Any + Send + Sync>(&self) -> Option<&T> {
-        self.user_data.as_ref().and_then(|b| b.downcast_ref())
-    }
-    /// Attempts to downcast the inner data, if any, into the provided type and returns it mutably.
-    /// Returns none if there is no data or the data is not of the appropriate type.
-    pub fn user_data_mut<T: Any + Send + Sync>(&mut self) -> Option<&mut T> {
-        self.user_data.as_mut().and_then(|b| b.downcast_mut())
-    }
-}
-
-#[derive(Debug, Copy, Clone, derive_more::Display, Eq, PartialEq)]
-pub enum SlotKindType {
-    Workflow,
-    Activity,
-    LocalActivity,
-    Nexus,
-}
-
-#[derive(Debug, Copy, Clone)]
-pub struct WorkflowSlotKind {}
-#[derive(Debug, Copy, Clone)]
-pub struct ActivitySlotKind {}
-#[derive(Debug, Copy, Clone)]
-pub struct LocalActivitySlotKind {}
-#[derive(Debug, Copy, Clone)]
-pub struct NexusSlotKind {}
-
-pub enum SlotInfo<'a> {
-    Workflow(&'a WorkflowSlotInfo),
-    Activity(&'a ActivitySlotInfo),
-    LocalActivity(&'a LocalActivitySlotInfo),
-    Nexus(&'a NexusSlotInfo),
-}
-
-pub trait SlotInfoTrait: prost::Message {
-    fn downcast(&self) -> SlotInfo<'_>;
-}
-impl SlotInfoTrait for WorkflowSlotInfo {
-    fn downcast(&self) -> SlotInfo<'_> {
-        SlotInfo::Workflow(self)
-    }
-}
-impl SlotInfoTrait for ActivitySlotInfo {
-    fn downcast(&self) -> SlotInfo<'_> {
-        SlotInfo::Activity(self)
-    }
-}
-impl SlotInfoTrait for LocalActivitySlotInfo {
-    fn downcast(&self) -> SlotInfo<'_> {
-        SlotInfo::LocalActivity(self)
-    }
-}
-impl SlotInfoTrait for NexusSlotInfo {
-    fn downcast(&self) -> SlotInfo<'_> {
-        SlotInfo::Nexus(self)
-    }
-}
-
-pub trait SlotKind {
-    type Info: SlotInfoTrait;
-
-    fn kind() -> SlotKindType;
-}
-impl SlotKind for WorkflowSlotKind {
-    type Info = WorkflowSlotInfo;
-
-    fn kind() -> SlotKindType {
-        SlotKindType::Workflow
-    }
-}
-impl SlotKind for ActivitySlotKind {
-    type Info = ActivitySlotInfo;
-
-    fn kind() -> SlotKindType {
-        SlotKindType::Activity
-    }
-}
-impl SlotKind for LocalActivitySlotKind {
-    type Info = LocalActivitySlotInfo;
-
-    fn kind() -> SlotKindType {
-        SlotKindType::LocalActivity
-    }
-}
-impl SlotKind for NexusSlotKind {
-    type Info = NexusSlotInfo;
-
-    fn kind() -> SlotKindType {
-        SlotKindType::Nexus
-    }
-}
-
-/// Different strategies for task polling
-#[derive(Clone, Copy, Debug, PartialEq)]
-pub enum PollerBehavior {
-    /// Will attempt to poll as long as a slot is available, up to the provided maximum. Cannot
-    /// be less than two for workflow tasks, or one for other tasks.
-    SimpleMaximum(usize),
-    /// Will automatically scale the number of pollers based on feedback from the server. Still
-    /// requires a slot to be available before beginning polling.
-    Autoscaling {
-        /// At least this many poll calls will always be attempted (assuming slots are available).
-        /// Cannot be zero.
-        minimum: usize,
-        /// At most this many poll calls will ever be open at once. Must be >= `minimum`.
-        maximum: usize,
-        /// This many polls will be attempted initially before scaling kicks in. Must be between
-        /// `minimum` and `maximum`.
-        initial: usize,
-    },
-}
-
-impl PollerBehavior {
-    /// Returns true if the behavior is using autoscaling
-    pub fn is_autoscaling(&self) -> bool {
-        matches!(self, PollerBehavior::Autoscaling { .. })
-    }
 
-    fn validate(&self) -> Result<(), String> {
-        match self {
-            PollerBehavior::SimpleMaximum(x) => {
-                if *x < 1 {
-                    return Err("SimpleMaximum poller behavior must be at least 1".to_owned());
-                }
-            }
-            PollerBehavior::Autoscaling {
-                minimum,
-                maximum,
-                initial,
-            } => {
-                if *minimum < 1 {
-                    return Err("Autoscaling minimum poller behavior must be at least 1".to_owned());
-                }
-                if *maximum < *minimum {
-                    return Err(
-                        "Autoscaling maximum must be greater than or equal to minimum".to_owned(),
-                    );
-                }
-                if *initial < *minimum || *initial > *maximum {
-                    return Err(
-                        "Autoscaling initial must be between minimum and maximum".to_owned()
-                    );
-                }
-            }
+    /// Converts the enabled task types into the corresponding [`TaskQueueType`] values.
+    pub fn to_task_queue_types(&self) -> Vec<TaskQueueType> {
+        let mut types = Vec::new();
+        if self.enable_workflows {
+            types.push(TaskQueueType::Workflow);
         }
-        Ok(())
-    }
-}
-
-#[derive(Clone, Debug)]
-pub enum WorkerVersioningStrategy {
-    /// Don't enable any versioning
-    None {
-        /// Build ID may still be passed as a way to identify the worker, or may be left empty.
-        build_id: String,
-    },
-    /// Maybe use the modern deployment-based versioning, or just pass a deployment version.
-    WorkerDeploymentBased(WorkerDeploymentOptions),
-    /// Use the legacy build-id-based whole worker versioning.
-    LegacyBuildIdBased {
-        /// A Build ID to use, must be non-empty.
-        build_id: String,
-    },
-}
-
-impl Default for WorkerVersioningStrategy {
-    fn default() -> Self {
-        WorkerVersioningStrategy::None {
-            build_id: String::new(),
-        }
-    }
-}
-
-impl WorkerVersioningStrategy {
-    pub fn build_id(&self) -> &str {
-        match self {
-            WorkerVersioningStrategy::None { build_id } => build_id,
-            WorkerVersioningStrategy::WorkerDeploymentBased(opts) => &opts.version.build_id,
-            WorkerVersioningStrategy::LegacyBuildIdBased { build_id } => build_id,
+        if self.enable_remote_activities {
+            types.push(TaskQueueType::Activity);
         }
-    }
-
-    pub fn uses_build_id_based(&self) -> bool {
-        matches!(self, WorkerVersioningStrategy::LegacyBuildIdBased { .. })
-    }
-
-    pub fn default_versioning_behavior(&self) -> Option<VersioningBehavior> {
-        match self {
-            WorkerVersioningStrategy::WorkerDeploymentBased(opts) => {
-                opts.default_versioning_behavior
-            }
-            _ => None,
+        if self.enable_nexus {
+            types.push(TaskQueueType::Nexus);
         }
+        types
     }
 }
 
+/// Configuration for worker deployment versioning.
 #[derive(Clone, Debug, Eq, PartialEq, Hash)]
 pub struct WorkerDeploymentOptions {
     /// The deployment version of this worker.
@@ -694,6 +113,21 @@ pub struct WorkerDeploymentOptions {
     pub default_versioning_behavior: Option<VersioningBehavior>,
 }
 
+impl WorkerDeploymentOptions {
+    /// Create deployment options from just a build ID, without opting into worker versioning.
+    pub fn from_build_id(build_id: String) -> Self {
+        Self {
+            version: WorkerDeploymentVersion {
+                deployment_name: "".to_owned(),
+                build_id,
+            },
+            use_worker_versioning: false,
+            default_versioning_behavior: None,
+        }
+    }
+}
+
+/// Identifies a specific version of a worker deployment.
 #[derive(Clone, Debug, Eq, PartialEq, Hash)]
 pub struct WorkerDeploymentVersion {
     /// Name of the deployment
@@ -703,6 +137,7 @@ pub struct WorkerDeploymentVersion {
 }
 
 impl WorkerDeploymentVersion {
+    /// Returns true if both the deployment name and build ID are empty.
     pub fn is_empty(&self) -> bool {
         self.deployment_name.is_empty() && self.build_id.is_empty()
     }
@@ -748,3 +183,33 @@ impl From<temporal::api::deployment::v1::WorkerDeploymentVersion> for WorkerDepl
         }
     }
 }
+
+static CACHED_BUILD_ID: OnceLock<String> = OnceLock::new();
+
+/// Build ID derived from hashing the on-disk bytes of the current executable.
+/// Deterministic across machines for the same binary. Cached per-process.
+pub fn build_id_from_current_exe() -> &'static str {
+    CACHED_BUILD_ID
+        .get_or_init(|| compute_crc32_exe_id().unwrap_or_else(|_| "undetermined".to_owned()))
+}
+
+fn compute_crc32_exe_id() -> io::Result<String> {
+    let exe_path = std::env::current_exe()?;
+    let file = File::open(exe_path)?;
+    let mut reader = BufReader::new(file);
+
+    let mut hasher = crc32fast::Hasher::new();
+    let mut buf = [0u8; 128 * 1024];
+
+    loop {
+        let n = reader.read(&mut buf)?;
+        if n == 0 {
+            break;
+        }
+        hasher.update(&buf[..n]);
+    }
+
+    let crc = hasher.finalize();
+
+    Ok(format!("{:08x}", crc))
+}