temporalio 0.3.0 → 0.4.0

data/lib/temporalio/client/connection/workflow_service.rb

@@ -841,6 +841,201 @@ module Temporalio
           )
         end
 
+        # Calls WorkflowService.DescribeDeployment API call.
+        #
+        # @param request [Temporalio::Api::WorkflowService::V1::DescribeDeploymentRequest] API request.
+        # @param rpc_options [RPCOptions, nil] Advanced RPC options.
+        # @return [Temporalio::Api::WorkflowService::V1::DescribeDeploymentResponse] API response.
+        def describe_deployment(request, rpc_options: nil)
+          invoke_rpc(
+            rpc: 'describe_deployment',
+            request_class: Temporalio::Api::WorkflowService::V1::DescribeDeploymentRequest,
+            response_class: Temporalio::Api::WorkflowService::V1::DescribeDeploymentResponse,
+            request:,
+            rpc_options:
+          )
+        end
+
+        # Calls WorkflowService.DescribeWorkerDeploymentVersion API call.
+        #
+        # @param request [Temporalio::Api::WorkflowService::V1::DescribeWorkerDeploymentVersionRequest] API request.
+        # @param rpc_options [RPCOptions, nil] Advanced RPC options.
+        # @return [Temporalio::Api::WorkflowService::V1::DescribeWorkerDeploymentVersionResponse] API response.
+        def describe_worker_deployment_version(request, rpc_options: nil)
+          invoke_rpc(
+            rpc: 'describe_worker_deployment_version',
+            request_class: Temporalio::Api::WorkflowService::V1::DescribeWorkerDeploymentVersionRequest,
+            response_class: Temporalio::Api::WorkflowService::V1::DescribeWorkerDeploymentVersionResponse,
+            request:,
+            rpc_options:
+          )
+        end
+
+        # Calls WorkflowService.ListDeployments API call.
+        #
+        # @param request [Temporalio::Api::WorkflowService::V1::ListDeploymentsRequest] API request.
+        # @param rpc_options [RPCOptions, nil] Advanced RPC options.
+        # @return [Temporalio::Api::WorkflowService::V1::ListDeploymentsResponse] API response.
+        def list_deployments(request, rpc_options: nil)
+          invoke_rpc(
+            rpc: 'list_deployments',
+            request_class: Temporalio::Api::WorkflowService::V1::ListDeploymentsRequest,
+            response_class: Temporalio::Api::WorkflowService::V1::ListDeploymentsResponse,
+            request:,
+            rpc_options:
+          )
+        end
+
+        # Calls WorkflowService.GetDeploymentReachability API call.
+        #
+        # @param request [Temporalio::Api::WorkflowService::V1::GetDeploymentReachabilityRequest] API request.
+        # @param rpc_options [RPCOptions, nil] Advanced RPC options.
+        # @return [Temporalio::Api::WorkflowService::V1::GetDeploymentReachabilityResponse] API response.
+        def get_deployment_reachability(request, rpc_options: nil)
+          invoke_rpc(
+            rpc: 'get_deployment_reachability',
+            request_class: Temporalio::Api::WorkflowService::V1::GetDeploymentReachabilityRequest,
+            response_class: Temporalio::Api::WorkflowService::V1::GetDeploymentReachabilityResponse,
+            request:,
+            rpc_options:
+          )
+        end
+
+        # Calls WorkflowService.GetCurrentDeployment API call.
+        #
+        # @param request [Temporalio::Api::WorkflowService::V1::GetCurrentDeploymentRequest] API request.
+        # @param rpc_options [RPCOptions, nil] Advanced RPC options.
+        # @return [Temporalio::Api::WorkflowService::V1::GetCurrentDeploymentResponse] API response.
+        def get_current_deployment(request, rpc_options: nil)
+          invoke_rpc(
+            rpc: 'get_current_deployment',
+            request_class: Temporalio::Api::WorkflowService::V1::GetCurrentDeploymentRequest,
+            response_class: Temporalio::Api::WorkflowService::V1::GetCurrentDeploymentResponse,
+            request:,
+            rpc_options:
+          )
+        end
+
+        # Calls WorkflowService.SetCurrentDeployment API call.
+        #
+        # @param request [Temporalio::Api::WorkflowService::V1::SetCurrentDeploymentRequest] API request.
+        # @param rpc_options [RPCOptions, nil] Advanced RPC options.
+        # @return [Temporalio::Api::WorkflowService::V1::SetCurrentDeploymentResponse] API response.
+        def set_current_deployment(request, rpc_options: nil)
+          invoke_rpc(
+            rpc: 'set_current_deployment',
+            request_class: Temporalio::Api::WorkflowService::V1::SetCurrentDeploymentRequest,
+            response_class: Temporalio::Api::WorkflowService::V1::SetCurrentDeploymentResponse,
+            request:,
+            rpc_options:
+          )
+        end
+
+        # Calls WorkflowService.SetWorkerDeploymentCurrentVersion API call.
+        #
+        # @param request [Temporalio::Api::WorkflowService::V1::SetWorkerDeploymentCurrentVersionRequest] API request.
+        # @param rpc_options [RPCOptions, nil] Advanced RPC options.
+        # @return [Temporalio::Api::WorkflowService::V1::SetWorkerDeploymentCurrentVersionResponse] API response.
+        def set_worker_deployment_current_version(request, rpc_options: nil)
+          invoke_rpc(
+            rpc: 'set_worker_deployment_current_version',
+            request_class: Temporalio::Api::WorkflowService::V1::SetWorkerDeploymentCurrentVersionRequest,
+            response_class: Temporalio::Api::WorkflowService::V1::SetWorkerDeploymentCurrentVersionResponse,
+            request:,
+            rpc_options:
+          )
+        end
+
+        # Calls WorkflowService.DescribeWorkerDeployment API call.
+        #
+        # @param request [Temporalio::Api::WorkflowService::V1::DescribeWorkerDeploymentRequest] API request.
+        # @param rpc_options [RPCOptions, nil] Advanced RPC options.
+        # @return [Temporalio::Api::WorkflowService::V1::DescribeWorkerDeploymentResponse] API response.
+        def describe_worker_deployment(request, rpc_options: nil)
+          invoke_rpc(
+            rpc: 'describe_worker_deployment',
+            request_class: Temporalio::Api::WorkflowService::V1::DescribeWorkerDeploymentRequest,
+            response_class: Temporalio::Api::WorkflowService::V1::DescribeWorkerDeploymentResponse,
+            request:,
+            rpc_options:
+          )
+        end
+
+        # Calls WorkflowService.DeleteWorkerDeployment API call.
+        #
+        # @param request [Temporalio::Api::WorkflowService::V1::DeleteWorkerDeploymentRequest] API request.
+        # @param rpc_options [RPCOptions, nil] Advanced RPC options.
+        # @return [Temporalio::Api::WorkflowService::V1::DeleteWorkerDeploymentResponse] API response.
+        def delete_worker_deployment(request, rpc_options: nil)
+          invoke_rpc(
+            rpc: 'delete_worker_deployment',
+            request_class: Temporalio::Api::WorkflowService::V1::DeleteWorkerDeploymentRequest,
+            response_class: Temporalio::Api::WorkflowService::V1::DeleteWorkerDeploymentResponse,
+            request:,
+            rpc_options:
+          )
+        end
+
+        # Calls WorkflowService.DeleteWorkerDeploymentVersion API call.
+        #
+        # @param request [Temporalio::Api::WorkflowService::V1::DeleteWorkerDeploymentVersionRequest] API request.
+        # @param rpc_options [RPCOptions, nil] Advanced RPC options.
+        # @return [Temporalio::Api::WorkflowService::V1::DeleteWorkerDeploymentVersionResponse] API response.
+        def delete_worker_deployment_version(request, rpc_options: nil)
+          invoke_rpc(
+            rpc: 'delete_worker_deployment_version',
+            request_class: Temporalio::Api::WorkflowService::V1::DeleteWorkerDeploymentVersionRequest,
+            response_class: Temporalio::Api::WorkflowService::V1::DeleteWorkerDeploymentVersionResponse,
+            request:,
+            rpc_options:
+          )
+        end
+
+        # Calls WorkflowService.SetWorkerDeploymentRampingVersion API call.
+        #
+        # @param request [Temporalio::Api::WorkflowService::V1::SetWorkerDeploymentRampingVersionRequest] API request.
+        # @param rpc_options [RPCOptions, nil] Advanced RPC options.
+        # @return [Temporalio::Api::WorkflowService::V1::SetWorkerDeploymentRampingVersionResponse] API response.
+        def set_worker_deployment_ramping_version(request, rpc_options: nil)
+          invoke_rpc(
+            rpc: 'set_worker_deployment_ramping_version',
+            request_class: Temporalio::Api::WorkflowService::V1::SetWorkerDeploymentRampingVersionRequest,
+            response_class: Temporalio::Api::WorkflowService::V1::SetWorkerDeploymentRampingVersionResponse,
+            request:,
+            rpc_options:
+          )
+        end
+
+        # Calls WorkflowService.ListWorkerDeployments API call.
+        #
+        # @param request [Temporalio::Api::WorkflowService::V1::ListWorkerDeploymentsRequest] API request.
+        # @param rpc_options [RPCOptions, nil] Advanced RPC options.
+        # @return [Temporalio::Api::WorkflowService::V1::ListWorkerDeploymentsResponse] API response.
+        def list_worker_deployments(request, rpc_options: nil)
+          invoke_rpc(
+            rpc: 'list_worker_deployments',
+            request_class: Temporalio::Api::WorkflowService::V1::ListWorkerDeploymentsRequest,
+            response_class: Temporalio::Api::WorkflowService::V1::ListWorkerDeploymentsResponse,
+            request:,
+            rpc_options:
+          )
+        end
+
+        # Calls WorkflowService.UpdateWorkerDeploymentVersionMetadata API call.
+        #
+        # @param request [Temporalio::Api::WorkflowService::V1::UpdateWorkerDeploymentVersionMetadataRequest] API request.
+        # @param rpc_options [RPCOptions, nil] Advanced RPC options.
+        # @return [Temporalio::Api::WorkflowService::V1::UpdateWorkerDeploymentVersionMetadataResponse] API response.
+        def update_worker_deployment_version_metadata(request, rpc_options: nil)
+          invoke_rpc(
+            rpc: 'update_worker_deployment_version_metadata',
+            request_class: Temporalio::Api::WorkflowService::V1::UpdateWorkerDeploymentVersionMetadataRequest,
+            response_class: Temporalio::Api::WorkflowService::V1::UpdateWorkerDeploymentVersionMetadataResponse,
+            request:,
+            rpc_options:
+          )
+        end
+
         # Calls WorkflowService.UpdateWorkflowExecution API call.
         #
         # @param request [Temporalio::Api::WorkflowService::V1::UpdateWorkflowExecutionRequest] API request.
@@ -976,61 +1171,76 @@ module Temporalio
           )
         end
 
-        # Calls WorkflowService.UpdateActivityOptionsById API call.
+        # Calls WorkflowService.UpdateActivityOptions API call.
+        #
+        # @param request [Temporalio::Api::WorkflowService::V1::UpdateActivityOptionsRequest] API request.
+        # @param rpc_options [RPCOptions, nil] Advanced RPC options.
+        # @return [Temporalio::Api::WorkflowService::V1::UpdateActivityOptionsResponse] API response.
+        def update_activity_options(request, rpc_options: nil)
+          invoke_rpc(
+            rpc: 'update_activity_options',
+            request_class: Temporalio::Api::WorkflowService::V1::UpdateActivityOptionsRequest,
+            response_class: Temporalio::Api::WorkflowService::V1::UpdateActivityOptionsResponse,
+            request:,
+            rpc_options:
+          )
+        end
+
+        # Calls WorkflowService.UpdateWorkflowExecutionOptions API call.
         #
-        # @param request [Temporalio::Api::WorkflowService::V1::UpdateActivityOptionsByIdRequest] API request.
+        # @param request [Temporalio::Api::WorkflowService::V1::UpdateWorkflowExecutionOptionsRequest] API request.
         # @param rpc_options [RPCOptions, nil] Advanced RPC options.
-        # @return [Temporalio::Api::WorkflowService::V1::UpdateActivityOptionsByIdResponse] API response.
-        def update_activity_options_by_id(request, rpc_options: nil)
+        # @return [Temporalio::Api::WorkflowService::V1::UpdateWorkflowExecutionOptionsResponse] API response.
+        def update_workflow_execution_options(request, rpc_options: nil)
           invoke_rpc(
-            rpc: 'update_activity_options_by_id',
-            request_class: Temporalio::Api::WorkflowService::V1::UpdateActivityOptionsByIdRequest,
-            response_class: Temporalio::Api::WorkflowService::V1::UpdateActivityOptionsByIdResponse,
+            rpc: 'update_workflow_execution_options',
+            request_class: Temporalio::Api::WorkflowService::V1::UpdateWorkflowExecutionOptionsRequest,
+            response_class: Temporalio::Api::WorkflowService::V1::UpdateWorkflowExecutionOptionsResponse,
             request:,
             rpc_options:
           )
         end
 
-        # Calls WorkflowService.PauseActivityById API call.
+        # Calls WorkflowService.PauseActivity API call.
         #
-        # @param request [Temporalio::Api::WorkflowService::V1::PauseActivityByIdRequest] API request.
+        # @param request [Temporalio::Api::WorkflowService::V1::PauseActivityRequest] API request.
         # @param rpc_options [RPCOptions, nil] Advanced RPC options.
-        # @return [Temporalio::Api::WorkflowService::V1::PauseActivityByIdResponse] API response.
-        def pause_activity_by_id(request, rpc_options: nil)
+        # @return [Temporalio::Api::WorkflowService::V1::PauseActivityResponse] API response.
+        def pause_activity(request, rpc_options: nil)
           invoke_rpc(
-            rpc: 'pause_activity_by_id',
-            request_class: Temporalio::Api::WorkflowService::V1::PauseActivityByIdRequest,
-            response_class: Temporalio::Api::WorkflowService::V1::PauseActivityByIdResponse,
+            rpc: 'pause_activity',
+            request_class: Temporalio::Api::WorkflowService::V1::PauseActivityRequest,
+            response_class: Temporalio::Api::WorkflowService::V1::PauseActivityResponse,
             request:,
             rpc_options:
           )
         end
 
-        # Calls WorkflowService.UnpauseActivityById API call.
+        # Calls WorkflowService.UnpauseActivity API call.
         #
-        # @param request [Temporalio::Api::WorkflowService::V1::UnpauseActivityByIdRequest] API request.
+        # @param request [Temporalio::Api::WorkflowService::V1::UnpauseActivityRequest] API request.
         # @param rpc_options [RPCOptions, nil] Advanced RPC options.
-        # @return [Temporalio::Api::WorkflowService::V1::UnpauseActivityByIdResponse] API response.
-        def unpause_activity_by_id(request, rpc_options: nil)
+        # @return [Temporalio::Api::WorkflowService::V1::UnpauseActivityResponse] API response.
+        def unpause_activity(request, rpc_options: nil)
           invoke_rpc(
-            rpc: 'unpause_activity_by_id',
-            request_class: Temporalio::Api::WorkflowService::V1::UnpauseActivityByIdRequest,
-            response_class: Temporalio::Api::WorkflowService::V1::UnpauseActivityByIdResponse,
+            rpc: 'unpause_activity',
+            request_class: Temporalio::Api::WorkflowService::V1::UnpauseActivityRequest,
+            response_class: Temporalio::Api::WorkflowService::V1::UnpauseActivityResponse,
             request:,
             rpc_options:
           )
         end
 
-        # Calls WorkflowService.ResetActivityById API call.
+        # Calls WorkflowService.ResetActivity API call.
         #
-        # @param request [Temporalio::Api::WorkflowService::V1::ResetActivityByIdRequest] API request.
+        # @param request [Temporalio::Api::WorkflowService::V1::ResetActivityRequest] API request.
         # @param rpc_options [RPCOptions, nil] Advanced RPC options.
-        # @return [Temporalio::Api::WorkflowService::V1::ResetActivityByIdResponse] API response.
-        def reset_activity_by_id(request, rpc_options: nil)
+        # @return [Temporalio::Api::WorkflowService::V1::ResetActivityResponse] API response.
+        def reset_activity(request, rpc_options: nil)
           invoke_rpc(
-            rpc: 'reset_activity_by_id',
-            request_class: Temporalio::Api::WorkflowService::V1::ResetActivityByIdRequest,
-            response_class: Temporalio::Api::WorkflowService::V1::ResetActivityByIdResponse,
+            rpc: 'reset_activity',
+            request_class: Temporalio::Api::WorkflowService::V1::ResetActivityRequest,
+            response_class: Temporalio::Api::WorkflowService::V1::ResetActivityResponse,
             request:,
             rpc_options:
           )

data/lib/temporalio/client/interceptor.rb

@@ -23,6 +23,8 @@ module Temporalio
         :args,
         :workflow_id,
         :task_queue,
+        :static_summary,
+        :static_details,
         :execution_timeout,
         :run_timeout,
         :task_timeout,
@@ -38,6 +40,26 @@ module Temporalio
         :rpc_options
       )
 
+      # Input for {Outbound.start_update_with_start_workflow}.
+      StartUpdateWithStartWorkflowInput = Data.define(
+        :update_id,
+        :update,
+        :args,
+        :wait_for_stage,
+        :start_workflow_operation,
+        :headers,
+        :rpc_options
+      )
+
+      # Input for {Outbound.signal_with_start_workflow}.
+      SignalWithStartWorkflowInput = Data.define(
+        :signal,
+        :args,
+        :start_workflow_operation,
+        # Headers intentionally not defined here, because they are not separate from start_workflow_operation
+        :rpc_options
+      )
+
       # Input for {Outbound.list_workflows}.
       ListWorkflowsInput = Data.define(
         :query,
@@ -240,6 +262,23 @@ module Temporalio
           next_interceptor.start_workflow(input)
         end
 
+        # Called for every {Client.start_update_with_start_workflow} and {Client.execute_update_with_start_workflow}
+        # call.
+        #
+        # @param input [StartUpdateWithStartWorkflowInput] Input.
+        # @return [WorkflowUpdateHandle] Workflow update handle.
+        def start_update_with_start_workflow(input)
+          next_interceptor.start_update_with_start_workflow(input)
+        end
+
+        # Called for every {Client.signal_with_start_workflow}.
+        #
+        # @param input [SignalWithStartWorkflowInput] Input.
+        # @return [WorkflowHandle] Workflow handle.
+        def signal_with_start_workflow(input)
+          next_interceptor.signal_with_start_workflow(input)
+        end
+
         # Called for every {Client.list_workflows} call.
         #
         # @param input [ListWorkflowsInput] Input.

data/lib/temporalio/client/schedule.rb

@@ -167,6 +167,8 @@ module Temporalio
           :args,
           :id,
           :task_queue,
+          :static_summary,
+          :static_details,
           :execution_timeout,
           :run_timeout,
           :task_timeout,
@@ -186,6 +188,14 @@ module Temporalio
         #   @return [String] Unique identifier for the workflow execution.
         # @!attribute task_queue
         #   @return [String] Task queue to run the workflow on.
+        # @!attribute static_summary
+        #   @return [String, nil] Fixed single-line summary for this workflow execution that may appear in CLI/UI.
+        #     This can be in single-line Temporal markdown format. This is currently experimental.
+        # @!attribute static_details
+        #   @return [String, nil] Fixed details for this workflow execution that may appear in CLI/UI. This can be in
+        #     Temporal markdown format and can be multiple lines. This is a fixed value on the workflow that cannot be
+        #     updated. For details that can be updated, use {Workflow.current_details=} within the workflow. This is
+        #     currently experimental.
         # @!attribute execution_timeout
         #   @return [Float, nil] Total workflow execution timeout in seconds including retries and continue as new.
         # @!attribute run_timeout
@@ -212,6 +222,12 @@ module Temporalio
             # @param args [Array<Object>] Arguments to the workflow.
             # @param id [String] Unique identifier for the workflow execution.
             # @param task_queue [String] Task queue to run the workflow on.
+            # @param static_summary [String, nil] Fixed single-line summary for this workflow execution that may appear
+            #   in CLI/UI. This can be in single-line Temporal markdown format. This is currently experimental.
+            # @param static_details [String, nil] Fixed details for this workflow execution that may appear in CLI/UI.
+            #   This can be in Temporal markdown format and can be multiple lines. This is a fixed value on the workflow
+            #   that cannot be updated. For details that can be updated, use {Workflow.current_details=} within the
+            #   workflow. This is currently experimental.
             # @param execution_timeout [Float, nil] Total workflow execution timeout in seconds including retries and
             #   continue as new.
             # @param run_timeout [Float, nil] Timeout of a single workflow run in seconds.
@@ -225,6 +241,8 @@ module Temporalio
               *args,
               id:,
               task_queue:,
+              static_summary: nil,
+              static_details: nil,
               execution_timeout: nil,
               run_timeout: nil,
               task_timeout: nil,
@@ -238,6 +256,8 @@ module Temporalio
                 args:,
                 id:,
                 task_queue:,
+                static_summary:,
+                static_details:,
                 execution_timeout:,
                 run_timeout:,
                 task_timeout:,
@@ -251,11 +271,14 @@ module Temporalio
 
           # @!visibility private
           def self._from_proto(raw_info, data_converter)
+            (summary, details) = Internal::ProtoUtils.from_user_metadata(raw_info.user_metadata, data_converter)
             StartWorkflow.new(
               raw_info.workflow_type.name,
               *data_converter.from_payloads(raw_info.input),
               id: raw_info.workflow_id,
               task_queue: raw_info.task_queue.name,
+              static_summary: summary,
+              static_details: details,
               execution_timeout: Internal::ProtoUtils.duration_to_seconds(raw_info.workflow_execution_timeout),
               run_timeout: Internal::ProtoUtils.duration_to_seconds(raw_info.workflow_run_timeout),
               task_timeout: Internal::ProtoUtils.duration_to_seconds(raw_info.workflow_task_timeout),
@@ -280,7 +303,8 @@ module Temporalio
                 retry_policy: retry_policy&._to_proto,
                 memo: Internal::ProtoUtils.memo_to_proto(memo, data_converter),
                 search_attributes: search_attributes&._to_proto,
-                header: Internal::ProtoUtils.headers_to_proto(headers, data_converter)
+                header: Internal::ProtoUtils.headers_to_proto(headers, data_converter),
+                user_metadata: Internal::ProtoUtils.to_user_metadata(static_summary, static_details, data_converter)
               )
             )
           end

data/lib/temporalio/client/with_start_workflow_operation.rb

@@ -0,0 +1,115 @@
+# frozen_string_literal: true
+
+require 'temporalio/common_enums'
+
+module Temporalio
+  class Client
+    # Start operation used by {Client.start_update_with_start_workflow}, {Client.execute_update_with_start_workflow},
+    # and {Client.signal_with_start_workflow}.
+    class WithStartWorkflowOperation
+      Options = Data.define(
+        :workflow,
+        :args,
+        :id,
+        :task_queue,
+        :static_summary,
+        :static_details,
+        :execution_timeout,
+        :run_timeout,
+        :task_timeout,
+        :id_reuse_policy,
+        :id_conflict_policy,
+        :retry_policy,
+        :cron_schedule,
+        :memo,
+        :search_attributes,
+        :start_delay,
+        :headers
+      )
+
+      # Options the operation was created with.
+      class Options; end # rubocop:disable Lint/EmptyClass
+
+      # @return [Options] Options the operation was created with.
+      attr_accessor :options
+
+      # Create a with-start workflow operation. These are mostly the same options as {Client.start_workflow}, see that
+      # documentation for more details.
+      #
+      # Note, for {Client.start_update_with_start_workflow} and {Client.execute_update_with_start_workflow},
+      # `id_conflict_policy` is required.
+      def initialize(
+        workflow,
+        *args,
+        id:,
+        task_queue:,
+        static_summary: nil,
+        static_details: nil,
+        execution_timeout: nil,
+        run_timeout: nil,
+        task_timeout: nil,
+        id_reuse_policy: WorkflowIDReusePolicy::ALLOW_DUPLICATE,
+        id_conflict_policy: WorkflowIDConflictPolicy::UNSPECIFIED,
+        retry_policy: nil,
+        cron_schedule: nil,
+        memo: nil,
+        search_attributes: nil,
+        start_delay: nil,
+        headers: {}
+      )
+        @options = Options.new(
+          workflow: Workflow::Definition._workflow_type_from_workflow_parameter(workflow),
+          args:,
+          id:,
+          task_queue:,
+          static_summary:,
+          static_details:,
+          execution_timeout:,
+          run_timeout:,
+          task_timeout:,
+          id_reuse_policy:,
+          id_conflict_policy:,
+          retry_policy:,
+          cron_schedule:,
+          memo:,
+          search_attributes:,
+          start_delay:,
+          headers:
+        )
+        @workflow_handle_mutex = Mutex.new
+        @workflow_handle_cond_var = ConditionVariable.new
+      end
+
+      # Get the workflow handle, possibly waiting until set, or raise an error if the workflow start was unsuccessful.
+      #
+      # @param wait [Boolean] True to wait until it is set, false to return immediately.
+      #
+      # @return [WorkflowHandle, nil] The workflow handle when available or `nil` if `wait` is false and it is not set
+      #   yet.
+      # @raise [Error] Any error that occurred during the call before the workflow start returned.
+      def workflow_handle(wait: true)
+        @workflow_handle_mutex.synchronize do
+          @workflow_handle_cond_var.wait(@workflow_handle_mutex) unless @workflow_handle || !wait
+          raise @workflow_handle if @workflow_handle.is_a?(Exception)
+
+          @workflow_handle
+        end
+      end
+
+      # @!visibility private
+      def _set_workflow_handle(value)
+        @workflow_handle_mutex.synchronize do
+          @workflow_handle ||= value
+          @workflow_handle_cond_var.broadcast
+        end
+      end
+
+      # @!visibility private
+      def _mark_used
+        raise 'Start operation already used' if @in_use
+
+        @in_use = true
+      end
+    end
+  end
+end

data/lib/temporalio/client/workflow_execution.rb

@@ -93,6 +93,25 @@ module Temporalio
         def initialize(raw_description, data_converter)
           super(raw_description.workflow_execution_info, data_converter)
           @raw_description = raw_description
+          @data_converter = data_converter
+        end
+
+        # @return [String, nil] Static summary configured on the workflow. This is currently experimental.
+        def static_summary
+          user_metadata.first
+        end
+
+        # @return [String, nil] Static details configured on the workflow. This is currently experimental.
+        def static_details
+          user_metadata.last
+        end
+
+        private
+
+        def user_metadata
+          @user_metadata ||= Internal::ProtoUtils.from_user_metadata(
+            @raw_description.execution_config&.user_metadata, @data_converter
+          )
         end
       end
     end

data/lib/temporalio/client/workflow_handle.rb

@@ -222,7 +222,7 @@ module Temporalio
         @client._impl.signal_workflow(Interceptor::SignalWorkflowInput.new(
                                         workflow_id: id,
                                         run_id:,
-                                        signal:,
+                                        signal: Workflow::Definition::Signal._name_from_parameter(signal),
                                         args:,
                                         headers: {},
                                         rpc_options:
@@ -254,7 +254,7 @@ module Temporalio
         @client._impl.query_workflow(Interceptor::QueryWorkflowInput.new(
                                        workflow_id: id,
                                        run_id:,
-                                       query:,
+                                       query: Workflow::Definition::Query._name_from_parameter(query),
                                        args:,
                                        reject_condition:,
                                        headers: {},
@@ -291,7 +291,7 @@ module Temporalio
                                               workflow_id: self.id,
                                               run_id:,
                                               update_id: id,
-                                              update:,
+                                              update: Workflow::Definition::Update._name_from_parameter(update),
                                               args:,
                                               wait_for_stage:,
                                               headers: {},