temporalio 1.0.0-x86_64-linux → 1.1.0-x86_64-linux

data/lib/temporalio/client/connection.rb

@@ -154,8 +154,9 @@ module Temporalio
       #   +localhost:7233+.
       # @param api_key [String, nil] API key for Temporal. This becomes the +Authorization+ HTTP header with +"Bearer "+
       #   prepended. This is only set if RPC metadata doesn't already have an +authorization+ key.
-      # @param tls [Boolean, TLSOptions] If false, do not use TLS. If true, use system default TLS options. If TLS
-      #   options are present, those TLS options will be used.
+      # @param tls [Boolean, TLSOptions, nil] If false, do not use TLS. If true, use system default TLS options. If TLS
+      #   options are present, those TLS options will be used. If nil (the default), TLS will be auto-enabled if
+      #   api_key is provided.
       # @param rpc_metadata [Hash<String, String>] Headers to use for all calls to the server. Keys here can be
       #   overriden by per-call RPC metadata keys.
       # @param rpc_retry [RPCRetryOptions] Retry options for direct service calls (when opted in) or all high-level
@@ -173,7 +174,7 @@ module Temporalio
       def initialize(
         target_host:,
         api_key: nil,
-        tls: false,
+        tls: nil,
         rpc_metadata: {},
         rpc_retry: RPCRetryOptions.new,
         identity: "#{Process.pid}@#{Socket.gethostname}",
@@ -285,13 +286,17 @@ module Temporalio
           ),
           identity: @options.identity || "#{Process.pid}@#{Socket.gethostname}"
         )
-        if @options.tls
-          options.tls = if @options.tls.is_a?(TLSOptions)
+        # Auto-enable TLS when API key is provided and tls not explicitly set
+        tls = @options.tls
+        tls = true if tls.nil? && @options.api_key
+
+        if tls
+          options.tls = if tls.is_a?(TLSOptions)
                           Internal::Bridge::Client::TLSOptions.new(
-                            client_cert: @options.tls.client_cert, # steep:ignore
-                            client_private_key: @options.tls.client_private_key, # steep:ignore
-                            server_root_ca_cert: @options.tls.server_root_ca_cert, # steep:ignore
-                            domain: @options.tls.domain # steep:ignore
+                            client_cert: tls.client_cert, # steep:ignore
+                            client_private_key: tls.client_private_key, # steep:ignore
+                            server_root_ca_cert: tls.server_root_ca_cert, # steep:ignore
+                            domain: tls.domain # steep:ignore
                           )
                         else
                           Internal::Bridge::Client::TLSOptions.new

data/lib/temporalio/client.rb

@@ -99,7 +99,7 @@ module Temporalio
       target_host,
       namespace,
       api_key: nil,
-      tls: false,
+      tls: nil,
       data_converter: Converters::DataConverter.default,
       interceptors: [],
       logger: Logger.new($stdout, level: Logger::WARN),

data/lib/temporalio/contrib/open_telemetry.rb

@@ -86,10 +86,24 @@ module Temporalio
           attributes: nil,
           outbound_input: nil
         )
-          tracer.in_span(name, attributes:, kind:) do
+          # We cannot use tracer.in_span because it always assumes we want to set the status as error on exception, but
+          # we do not want to do that for benign exceptions. This is effectively a copy of the source of in_span with
+          # that change.
+          span = nil
+          span = tracer.start_span(name, attributes:, kind:)
+          ::OpenTelemetry::Trace.with_span(span) do
             _apply_context_to_headers(outbound_input.headers) if outbound_input
             yield
           end
+        rescue Exception => e # rubocop:disable Lint/RescueException
+          span&.record_exception(e)
+          # Only set the status if it is not a benign application error
+          unless e.is_a?(Error::ApplicationError) && e.category == Error::ApplicationError::Category::BENIGN
+            span&.status = ::OpenTelemetry::Trace::Status.error("Unhandled exception of type: #{e.class}")
+          end
+          raise e
+        ensure
+          span&.finish
         end
 
         # @!visibility private
@@ -217,7 +231,7 @@ module Temporalio
 
           # @!visibility private
           def execute(input)
-            @root._attach_context(Temporalio::Workflow.info.headers)
+            _attach_context(Temporalio::Workflow.info.headers)
             Workflow.with_completed_span("RunWorkflow:#{Temporalio::Workflow.info.workflow_type}", kind: :server) do
               super
             ensure
@@ -231,7 +245,7 @@ module Temporalio
 
           # @!visibility private
           def handle_signal(input)
-            @root._attach_context(Temporalio::Workflow.info.headers)
+            _attach_context(Temporalio::Workflow.info.headers)
             Workflow.with_completed_span(
               "HandleSignal:#{input.signal}",
               links: _links_from_headers(input.headers),
@@ -246,7 +260,7 @@ module Temporalio
 
           # @!visibility private
           def handle_query(input)
-            @root._attach_context(Temporalio::Workflow.info.headers)
+            _attach_context(Temporalio::Workflow.info.headers)
             Workflow.with_completed_span(
               "HandleQuery:#{input.query}",
               links: _links_from_headers(input.headers),
@@ -267,7 +281,7 @@ module Temporalio
 
           # @!visibility private
           def validate_update(input)
-            @root._attach_context(Temporalio::Workflow.info.headers)
+            _attach_context(Temporalio::Workflow.info.headers)
             Workflow.with_completed_span(
               "ValidateUpdate:#{input.update}",
               attributes: { 'temporalUpdateID' => input.id },
@@ -290,7 +304,7 @@ module Temporalio
 
           # @!visibility private
           def handle_update(input)
-            @root._attach_context(Temporalio::Workflow.info.headers)
+            _attach_context(Temporalio::Workflow.info.headers)
             Workflow.with_completed_span(
               "HandleUpdate:#{input.update}",
               attributes: { 'temporalUpdateID' => input.id },
@@ -309,14 +323,30 @@ module Temporalio
             end
           end
 
+          # @!visibility private
+          def _attach_context(headers)
+            # We have to disable the durable scheduler _even_ for something simple like attach context. For most OTel
+            # implementations, such a procedure is completely deterministic, but unfortunately some implementations like
+            # DataDog monkey patch OpenTelemetry (see
+            # https://github.com/DataDog/dd-trace-rb/blob/f88393d0571806b9980bb2cf5066eba60cfea177/lib/datadog/opentelemetry/api/context.rb#L184)
+            # to make even OpenTelemetry::Context.current non-deterministic because it uses mutexes. And a simple text
+            # map propagation extraction accesses Context.current.
+            Temporalio::Workflow::Unsafe.durable_scheduler_disabled do
+              @root._attach_context(headers)
+            end
+          end
+
           # @!visibility private
           def _links_from_headers(headers)
-            context = @root._context_from_headers(headers)
-            span = ::OpenTelemetry::Trace.current_span(context) if context
-            if span && span != ::OpenTelemetry::Trace::Span::INVALID
-              [::OpenTelemetry::Trace::Link.new(span.context)]
-            else
-              []
+            # See _attach_context above for why we have to disable scheduler even for these simple operations
+            Temporalio::Workflow::Unsafe.durable_scheduler_disabled do
+              context = @root._context_from_headers(headers)
+              span = ::OpenTelemetry::Trace.current_span(context) if context
+              if span && span != ::OpenTelemetry::Trace::Span::INVALID
+                [::OpenTelemetry::Trace::Link.new(span.context)]
+              else
+                []
+              end
             end
           end
         end
@@ -345,7 +375,9 @@ module Temporalio
           # @!visibility private
           def initialize_continue_as_new_error(input)
             # Just apply the current context to headers
-            @root._apply_context_to_headers(input.error.headers)
+            Temporalio::Workflow::Unsafe.durable_scheduler_disabled do
+              @root._apply_context_to_headers(input.error.headers)
+            end
             super
           end
 
@@ -372,7 +404,11 @@ module Temporalio
 
           # @!visibility private
           def _apply_span_to_headers(headers, span)
-            @root._apply_context_to_headers(headers, context: ::OpenTelemetry::Trace.context_with_span(span)) if span
+            # See WorkflowInbound#_attach_context comments for why we have to disable scheduler even for these simple
+            # operations
+            Temporalio::Workflow::Unsafe.durable_scheduler_disabled do
+              @root._apply_context_to_headers(headers, context: ::OpenTelemetry::Trace.context_with_span(span)) if span
+            end
           end
         end
 
@@ -405,9 +441,19 @@ module Temporalio
         )
           span = completed_span(name, attributes:, links:, kind:, exception:, even_during_replay:)
           if span
-            ::OpenTelemetry::Trace.with_span(span) do # rubocop:disable Style/ExplicitBlockArgument
+            # We cannot use ::OpenTelemetry::Trace.with_span here unfortunately. We need to disable the durable
+            # scheduler for just the span attach/detach but leave it enabled for the user code (see
+            # WorkflowInbound#_attach_current for why we have to disable scheduler even for these simple operations).
+            token = Temporalio::Workflow::Unsafe.durable_scheduler_disabled do
+              ::OpenTelemetry::Context.attach(::OpenTelemetry::Trace.context_with_span(span))
+            end
+            begin
               # Yield with no parameters
               yield
+            ensure
+              Temporalio::Workflow::Unsafe.durable_scheduler_disabled do
+                ::OpenTelemetry::Context.detach(token)
+              end
             end
           else
             yield
@@ -441,25 +487,32 @@ module Temporalio
           # Do nothing if replaying and not wanted during replay
           return nil if !even_during_replay && Temporalio::Workflow::Unsafe.replaying?
 
-          # If there is no span on the context and the user hasn't opted in to always creating, do not create. This
-          # prevents orphans if there was no span originally created from the client start-workflow call.
-          if ::OpenTelemetry::Trace.current_span == ::OpenTelemetry::Trace::Span::INVALID &&
-             !root._always_create_workflow_spans
-            return nil
-          end
-
           # Create attributes, adding user-defined ones
           attributes = { 'temporalWorkflowID' => Temporalio::Workflow.info.workflow_id,
                          'temporalRunID' => Temporalio::Workflow.info.run_id }.merge(attributes)
 
           time = Temporalio::Workflow.now.dup
           # Disable durable scheduler because 1) synchronous/non-batch span processors in OTel use network (though could
-          # have just used Unafe.io_enabled for this if not for the next point) and 2) OTel uses Ruby Timeout which we
+          # have just used Unsafe.io_enabled for this if not for the next point) and 2) OTel uses Ruby Timeout which we
           # don't want to use durable timers.
           Temporalio::Workflow::Unsafe.durable_scheduler_disabled do
+            # If there is no span on the context and the user hasn't opted in to always creating, do not create. This
+            # prevents orphans if there was no span originally created from the client start-workflow call.
+            if ::OpenTelemetry::Trace.current_span == ::OpenTelemetry::Trace::Span::INVALID &&
+               !root._always_create_workflow_spans
+              return nil
+            end
+
             span = root.tracer.start_span(name, attributes:, links:, start_timestamp: time, kind:) # steep:ignore
-            # Record exception if present
-            span.record_exception(exception) if exception
+            # Record exception and set status if present
+            if exception
+              span.record_exception(exception)
+              # Only set the status if it is not a benign application error
+              unless exception.is_a?(Error::ApplicationError) &&
+                     exception.category == Error::ApplicationError::Category::BENIGN
+                span.status = ::OpenTelemetry::Trace::Status.error("Unhandled exception of type: #{exception.class}")
+              end
+            end
             # Finish the span (returns self)
             span.finish(end_timestamp: time)
           end

data/lib/temporalio/converters/payload_converter/composite.rb

@@ -3,6 +3,7 @@
 require 'temporalio/api'
 require 'temporalio/converters/payload_converter'
 require 'temporalio/converters/raw_value'
+require 'temporalio/error'
 
 module Temporalio
   module Converters

data/lib/temporalio/converters/payload_converter/json_protobuf.rb

@@ -22,7 +22,7 @@ module Temporalio
 
           Api::Common::V1::Payload.new(
             metadata: { 'encoding' => ENCODING, 'messageType' => value.class.descriptor.name },
-            data: value.to_json
+            data: value.to_json.b
           )
         end
 

data/lib/temporalio/env_config.rb

@@ -212,7 +212,7 @@ module Temporalio
       # Create a client connect config from this profile
       # @return [Array] Tuple of [positional_args, keyword_args] that can be splatted to Client.connect
       def to_client_connect_options
-        positional_args = [address, namespace].compact
+        positional_args = [address, namespace]
         tls_value = false
         if tls
           tls_value = tls.to_client_tls_options

data/lib/temporalio/internal/bridge/api/workflow_activation/workflow_activation.rb

@@ -17,7 +17,7 @@ require 'temporalio/internal/bridge/api/common/common'
 require 'temporalio/internal/bridge/api/nexus/nexus'
 
 
-descriptor_data = "\n?temporal/sdk/core/workflow_activation/workflow_activation.proto\x12\x1b\x63oresdk.workflow_activation\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x1egoogle/protobuf/duration.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a%temporal/api/failure/v1/message.proto\x1a$temporal/api/update/v1/message.proto\x1a$temporal/api/common/v1/message.proto\x1a$temporal/api/enums/v1/workflow.proto\x1a\x37temporal/sdk/core/activity_result/activity_result.proto\x1a\x35temporal/sdk/core/child_workflow/child_workflow.proto\x1a%temporal/sdk/core/common/common.proto\x1a#temporal/sdk/core/nexus/nexus.proto\"\xfa\x02\n\x12WorkflowActivation\x12\x0e\n\x06run_id\x18\x01 \x01(\t\x12-\n\ttimestamp\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x14\n\x0cis_replaying\x18\x03 \x01(\x08\x12\x16\n\x0ehistory_length\x18\x04 \x01(\r\x12@\n\x04jobs\x18\x05 \x03(\x0b\x32\x32.coresdk.workflow_activation.WorkflowActivationJob\x12 \n\x18\x61vailable_internal_flags\x18\x06 \x03(\r\x12\x1a\n\x12history_size_bytes\x18\x07 \x01(\x04\x12!\n\x19\x63ontinue_as_new_suggested\x18\x08 \x01(\x08\x12T\n#deployment_version_for_current_task\x18\t \x01(\x0b\x32\'.coresdk.common.WorkerDeploymentVersion\"\xe0\n\n\x15WorkflowActivationJob\x12N\n\x13initialize_workflow\x18\x01 \x01(\x0b\x32/.coresdk.workflow_activation.InitializeWorkflowH\x00\x12<\n\nfire_timer\x18\x02 \x01(\x0b\x32&.coresdk.workflow_activation.FireTimerH\x00\x12K\n\x12update_random_seed\x18\x04 \x01(\x0b\x32-.coresdk.workflow_activation.UpdateRandomSeedH\x00\x12\x44\n\x0equery_workflow\x18\x05 \x01(\x0b\x32*.coresdk.workflow_activation.QueryWorkflowH\x00\x12\x46\n\x0f\x63\x61ncel_workflow\x18\x06 \x01(\x0b\x32+.coresdk.workflow_activation.CancelWorkflowH\x00\x12\x46\n\x0fsignal_workflow\x18\x07 \x01(\x0b\x32+.coresdk.workflow_activation.SignalWorkflowH\x00\x12H\n\x10resolve_activity\x18\x08 \x01(\x0b\x32,.coresdk.workflow_activation.ResolveActivityH\x00\x12G\n\x10notify_has_patch\x18\t \x01(\x0b\x32+.coresdk.workflow_activation.NotifyHasPatchH\x00\x12q\n&resolve_child_workflow_execution_start\x18\n \x01(\x0b\x32?.coresdk.workflow_activation.ResolveChildWorkflowExecutionStartH\x00\x12\x66\n resolve_child_workflow_execution\x18\x0b \x01(\x0b\x32:.coresdk.workflow_activation.ResolveChildWorkflowExecutionH\x00\x12\x66\n resolve_signal_external_workflow\x18\x0c \x01(\x0b\x32:.coresdk.workflow_activation.ResolveSignalExternalWorkflowH\x00\x12u\n(resolve_request_cancel_external_workflow\x18\r \x01(\x0b\x32\x41.coresdk.workflow_activation.ResolveRequestCancelExternalWorkflowH\x00\x12:\n\tdo_update\x18\x0e \x01(\x0b\x32%.coresdk.workflow_activation.DoUpdateH\x00\x12`\n\x1dresolve_nexus_operation_start\x18\x0f \x01(\x0b\x32\x37.coresdk.workflow_activation.ResolveNexusOperationStartH\x00\x12U\n\x17resolve_nexus_operation\x18\x10 \x01(\x0b\x32\x32.coresdk.workflow_activation.ResolveNexusOperationH\x00\x12I\n\x11remove_from_cache\x18\x32 \x01(\x0b\x32,.coresdk.workflow_activation.RemoveFromCacheH\x00\x42\t\n\x07variant\"\xd9\n\n\x12InitializeWorkflow\x12\x15\n\rworkflow_type\x18\x01 \x01(\t\x12\x13\n\x0bworkflow_id\x18\x02 \x01(\t\x12\x32\n\targuments\x18\x03 \x03(\x0b\x32\x1f.temporal.api.common.v1.Payload\x12\x17\n\x0frandomness_seed\x18\x04 \x01(\x04\x12M\n\x07headers\x18\x05 \x03(\x0b\x32<.coresdk.workflow_activation.InitializeWorkflow.HeadersEntry\x12\x10\n\x08identity\x18\x06 \x01(\t\x12I\n\x14parent_workflow_info\x18\x07 \x01(\x0b\x32+.coresdk.common.NamespacedWorkflowExecution\x12=\n\x1aworkflow_execution_timeout\x18\x08 \x01(\x0b\x32\x19.google.protobuf.Duration\x12\x37\n\x14workflow_run_timeout\x18\t \x01(\x0b\x32\x19.google.protobuf.Duration\x12\x38\n\x15workflow_task_timeout\x18\n \x01(\x0b\x32\x19.google.protobuf.Duration\x12\'\n\x1f\x63ontinued_from_execution_run_id\x18\x0b \x01(\t\x12J\n\x13\x63ontinued_initiator\x18\x0c \x01(\x0e\x32-.temporal.api.enums.v1.ContinueAsNewInitiator\x12;\n\x11\x63ontinued_failure\x18\r \x01(\x0b\x32 .temporal.api.failure.v1.Failure\x12@\n\x16last_completion_result\x18\x0e \x01(\x0b\x32 .temporal.api.common.v1.Payloads\x12\x1e\n\x16\x66irst_execution_run_id\x18\x0f \x01(\t\x12\x39\n\x0cretry_policy\x18\x10 \x01(\x0b\x32#.temporal.api.common.v1.RetryPolicy\x12\x0f\n\x07\x61ttempt\x18\x11 \x01(\x05\x12\x15\n\rcron_schedule\x18\x12 \x01(\t\x12\x46\n\"workflow_execution_expiration_time\x18\x13 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x45\n\"cron_schedule_to_schedule_interval\x18\x14 \x01(\x0b\x32\x19.google.protobuf.Duration\x12*\n\x04memo\x18\x15 \x01(\x0b\x32\x1c.temporal.api.common.v1.Memo\x12\x43\n\x11search_attributes\x18\x16 \x01(\x0b\x32(.temporal.api.common.v1.SearchAttributes\x12.\n\nstart_time\x18\x17 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12@\n\rroot_workflow\x18\x18 \x01(\x0b\x32).temporal.api.common.v1.WorkflowExecution\x12\x32\n\x08priority\x18\x19 \x01(\x0b\x32 .temporal.api.common.v1.Priority\x1aO\n\x0cHeadersEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12.\n\x05value\x18\x02 \x01(\x0b\x32\x1f.temporal.api.common.v1.Payload:\x02\x38\x01\"\x18\n\tFireTimer\x12\x0b\n\x03seq\x18\x01 \x01(\r\"m\n\x0fResolveActivity\x12\x0b\n\x03seq\x18\x01 \x01(\r\x12;\n\x06result\x18\x02 \x01(\x0b\x32+.coresdk.activity_result.ActivityResolution\x12\x10\n\x08is_local\x18\x03 \x01(\x08\"\xd1\x02\n\"ResolveChildWorkflowExecutionStart\x12\x0b\n\x03seq\x18\x01 \x01(\r\x12[\n\tsucceeded\x18\x02 \x01(\x0b\x32\x46.coresdk.workflow_activation.ResolveChildWorkflowExecutionStartSuccessH\x00\x12X\n\x06\x66\x61iled\x18\x03 \x01(\x0b\x32\x46.coresdk.workflow_activation.ResolveChildWorkflowExecutionStartFailureH\x00\x12]\n\tcancelled\x18\x04 \x01(\x0b\x32H.coresdk.workflow_activation.ResolveChildWorkflowExecutionStartCancelledH\x00\x42\x08\n\x06status\";\n)ResolveChildWorkflowExecutionStartSuccess\x12\x0e\n\x06run_id\x18\x01 \x01(\t\"\xa6\x01\n)ResolveChildWorkflowExecutionStartFailure\x12\x13\n\x0bworkflow_id\x18\x01 \x01(\t\x12\x15\n\rworkflow_type\x18\x02 \x01(\t\x12M\n\x05\x63\x61use\x18\x03 \x01(\x0e\x32>.coresdk.child_workflow.StartChildWorkflowExecutionFailedCause\"`\n+ResolveChildWorkflowExecutionStartCancelled\x12\x31\n\x07\x66\x61ilure\x18\x01 \x01(\x0b\x32 .temporal.api.failure.v1.Failure\"i\n\x1dResolveChildWorkflowExecution\x12\x0b\n\x03seq\x18\x01 \x01(\r\x12;\n\x06result\x18\x02 \x01(\x0b\x32+.coresdk.child_workflow.ChildWorkflowResult\"+\n\x10UpdateRandomSeed\x12\x17\n\x0frandomness_seed\x18\x01 \x01(\x04\"\x84\x02\n\rQueryWorkflow\x12\x10\n\x08query_id\x18\x01 \x01(\t\x12\x12\n\nquery_type\x18\x02 \x01(\t\x12\x32\n\targuments\x18\x03 \x03(\x0b\x32\x1f.temporal.api.common.v1.Payload\x12H\n\x07headers\x18\x05 \x03(\x0b\x32\x37.coresdk.workflow_activation.QueryWorkflow.HeadersEntry\x1aO\n\x0cHeadersEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12.\n\x05value\x18\x02 \x01(\x0b\x32\x1f.temporal.api.common.v1.Payload:\x02\x38\x01\" \n\x0e\x43\x61ncelWorkflow\x12\x0e\n\x06reason\x18\x01 \x01(\t\"\x83\x02\n\x0eSignalWorkflow\x12\x13\n\x0bsignal_name\x18\x01 \x01(\t\x12.\n\x05input\x18\x02 \x03(\x0b\x32\x1f.temporal.api.common.v1.Payload\x12\x10\n\x08identity\x18\x03 \x01(\t\x12I\n\x07headers\x18\x05 \x03(\x0b\x32\x38.coresdk.workflow_activation.SignalWorkflow.HeadersEntry\x1aO\n\x0cHeadersEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12.\n\x05value\x18\x02 \x01(\x0b\x32\x1f.temporal.api.common.v1.Payload:\x02\x38\x01\"\"\n\x0eNotifyHasPatch\x12\x10\n\x08patch_id\x18\x01 \x01(\t\"_\n\x1dResolveSignalExternalWorkflow\x12\x0b\n\x03seq\x18\x01 \x01(\r\x12\x31\n\x07\x66\x61ilure\x18\x02 \x01(\x0b\x32 .temporal.api.failure.v1.Failure\"f\n$ResolveRequestCancelExternalWorkflow\x12\x0b\n\x03seq\x18\x01 \x01(\r\x12\x31\n\x07\x66\x61ilure\x18\x02 \x01(\x0b\x32 .temporal.api.failure.v1.Failure\"\xcb\x02\n\x08\x44oUpdate\x12\n\n\x02id\x18\x01 \x01(\t\x12\x1c\n\x14protocol_instance_id\x18\x02 \x01(\t\x12\x0c\n\x04name\x18\x03 \x01(\t\x12.\n\x05input\x18\x04 \x03(\x0b\x32\x1f.temporal.api.common.v1.Payload\x12\x43\n\x07headers\x18\x05 \x03(\x0b\x32\x32.coresdk.workflow_activation.DoUpdate.HeadersEntry\x12*\n\x04meta\x18\x06 \x01(\x0b\x32\x1c.temporal.api.update.v1.Meta\x12\x15\n\rrun_validator\x18\x07 \x01(\x08\x1aO\n\x0cHeadersEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12.\n\x05value\x18\x02 \x01(\x0b\x32\x1f.temporal.api.common.v1.Payload:\x02\x38\x01\"\x9a\x01\n\x1aResolveNexusOperationStart\x12\x0b\n\x03seq\x18\x01 \x01(\r\x12\x19\n\x0foperation_token\x18\x02 \x01(\tH\x00\x12\x16\n\x0cstarted_sync\x18\x03 \x01(\x08H\x00\x12\x32\n\x06\x66\x61iled\x18\x04 \x01(\x0b\x32 .temporal.api.failure.v1.FailureH\x00\x42\x08\n\x06status\"Y\n\x15ResolveNexusOperation\x12\x0b\n\x03seq\x18\x01 \x01(\r\x12\x33\n\x06result\x18\x02 \x01(\x0b\x32#.coresdk.nexus.NexusOperationResult\"\xe0\x02\n\x0fRemoveFromCache\x12\x0f\n\x07message\x18\x01 \x01(\t\x12K\n\x06reason\x18\x02 \x01(\x0e\x32;.coresdk.workflow_activation.RemoveFromCache.EvictionReason\"\xee\x01\n\x0e\x45victionReason\x12\x0f\n\x0bUNSPECIFIED\x10\x00\x12\x0e\n\nCACHE_FULL\x10\x01\x12\x0e\n\nCACHE_MISS\x10\x02\x12\x12\n\x0eNONDETERMINISM\x10\x03\x12\r\n\tLANG_FAIL\x10\x04\x12\x12\n\x0eLANG_REQUESTED\x10\x05\x12\x12\n\x0eTASK_NOT_FOUND\x10\x06\x12\x15\n\x11UNHANDLED_COMMAND\x10\x07\x12\t\n\x05\x46\x41TAL\x10\x08\x12\x1f\n\x1bPAGINATION_OR_HISTORY_FETCH\x10\t\x12\x1d\n\x19WORKFLOW_EXECUTION_ENDING\x10\nB8\xea\x02\x35Temporalio::Internal::Bridge::Api::WorkflowActivationb\x06proto3"
+descriptor_data = "\n?temporal/sdk/core/workflow_activation/workflow_activation.proto\x12\x1b\x63oresdk.workflow_activation\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x1egoogle/protobuf/duration.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a%temporal/api/failure/v1/message.proto\x1a$temporal/api/update/v1/message.proto\x1a$temporal/api/common/v1/message.proto\x1a$temporal/api/enums/v1/workflow.proto\x1a\x37temporal/sdk/core/activity_result/activity_result.proto\x1a\x35temporal/sdk/core/child_workflow/child_workflow.proto\x1a%temporal/sdk/core/common/common.proto\x1a#temporal/sdk/core/nexus/nexus.proto\"\x94\x03\n\x12WorkflowActivation\x12\x0e\n\x06run_id\x18\x01 \x01(\t\x12-\n\ttimestamp\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x14\n\x0cis_replaying\x18\x03 \x01(\x08\x12\x16\n\x0ehistory_length\x18\x04 \x01(\r\x12@\n\x04jobs\x18\x05 \x03(\x0b\x32\x32.coresdk.workflow_activation.WorkflowActivationJob\x12 \n\x18\x61vailable_internal_flags\x18\x06 \x03(\r\x12\x1a\n\x12history_size_bytes\x18\x07 \x01(\x04\x12!\n\x19\x63ontinue_as_new_suggested\x18\x08 \x01(\x08\x12T\n#deployment_version_for_current_task\x18\t \x01(\x0b\x32\'.coresdk.common.WorkerDeploymentVersion\x12\x18\n\x10last_sdk_version\x18\n \x01(\t\"\xe0\n\n\x15WorkflowActivationJob\x12N\n\x13initialize_workflow\x18\x01 \x01(\x0b\x32/.coresdk.workflow_activation.InitializeWorkflowH\x00\x12<\n\nfire_timer\x18\x02 \x01(\x0b\x32&.coresdk.workflow_activation.FireTimerH\x00\x12K\n\x12update_random_seed\x18\x04 \x01(\x0b\x32-.coresdk.workflow_activation.UpdateRandomSeedH\x00\x12\x44\n\x0equery_workflow\x18\x05 \x01(\x0b\x32*.coresdk.workflow_activation.QueryWorkflowH\x00\x12\x46\n\x0f\x63\x61ncel_workflow\x18\x06 \x01(\x0b\x32+.coresdk.workflow_activation.CancelWorkflowH\x00\x12\x46\n\x0fsignal_workflow\x18\x07 \x01(\x0b\x32+.coresdk.workflow_activation.SignalWorkflowH\x00\x12H\n\x10resolve_activity\x18\x08 \x01(\x0b\x32,.coresdk.workflow_activation.ResolveActivityH\x00\x12G\n\x10notify_has_patch\x18\t \x01(\x0b\x32+.coresdk.workflow_activation.NotifyHasPatchH\x00\x12q\n&resolve_child_workflow_execution_start\x18\n \x01(\x0b\x32?.coresdk.workflow_activation.ResolveChildWorkflowExecutionStartH\x00\x12\x66\n resolve_child_workflow_execution\x18\x0b \x01(\x0b\x32:.coresdk.workflow_activation.ResolveChildWorkflowExecutionH\x00\x12\x66\n resolve_signal_external_workflow\x18\x0c \x01(\x0b\x32:.coresdk.workflow_activation.ResolveSignalExternalWorkflowH\x00\x12u\n(resolve_request_cancel_external_workflow\x18\r \x01(\x0b\x32\x41.coresdk.workflow_activation.ResolveRequestCancelExternalWorkflowH\x00\x12:\n\tdo_update\x18\x0e \x01(\x0b\x32%.coresdk.workflow_activation.DoUpdateH\x00\x12`\n\x1dresolve_nexus_operation_start\x18\x0f \x01(\x0b\x32\x37.coresdk.workflow_activation.ResolveNexusOperationStartH\x00\x12U\n\x17resolve_nexus_operation\x18\x10 \x01(\x0b\x32\x32.coresdk.workflow_activation.ResolveNexusOperationH\x00\x12I\n\x11remove_from_cache\x18\x32 \x01(\x0b\x32,.coresdk.workflow_activation.RemoveFromCacheH\x00\x42\t\n\x07variant\"\xd9\n\n\x12InitializeWorkflow\x12\x15\n\rworkflow_type\x18\x01 \x01(\t\x12\x13\n\x0bworkflow_id\x18\x02 \x01(\t\x12\x32\n\targuments\x18\x03 \x03(\x0b\x32\x1f.temporal.api.common.v1.Payload\x12\x17\n\x0frandomness_seed\x18\x04 \x01(\x04\x12M\n\x07headers\x18\x05 \x03(\x0b\x32<.coresdk.workflow_activation.InitializeWorkflow.HeadersEntry\x12\x10\n\x08identity\x18\x06 \x01(\t\x12I\n\x14parent_workflow_info\x18\x07 \x01(\x0b\x32+.coresdk.common.NamespacedWorkflowExecution\x12=\n\x1aworkflow_execution_timeout\x18\x08 \x01(\x0b\x32\x19.google.protobuf.Duration\x12\x37\n\x14workflow_run_timeout\x18\t \x01(\x0b\x32\x19.google.protobuf.Duration\x12\x38\n\x15workflow_task_timeout\x18\n \x01(\x0b\x32\x19.google.protobuf.Duration\x12\'\n\x1f\x63ontinued_from_execution_run_id\x18\x0b \x01(\t\x12J\n\x13\x63ontinued_initiator\x18\x0c \x01(\x0e\x32-.temporal.api.enums.v1.ContinueAsNewInitiator\x12;\n\x11\x63ontinued_failure\x18\r \x01(\x0b\x32 .temporal.api.failure.v1.Failure\x12@\n\x16last_completion_result\x18\x0e \x01(\x0b\x32 .temporal.api.common.v1.Payloads\x12\x1e\n\x16\x66irst_execution_run_id\x18\x0f \x01(\t\x12\x39\n\x0cretry_policy\x18\x10 \x01(\x0b\x32#.temporal.api.common.v1.RetryPolicy\x12\x0f\n\x07\x61ttempt\x18\x11 \x01(\x05\x12\x15\n\rcron_schedule\x18\x12 \x01(\t\x12\x46\n\"workflow_execution_expiration_time\x18\x13 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x45\n\"cron_schedule_to_schedule_interval\x18\x14 \x01(\x0b\x32\x19.google.protobuf.Duration\x12*\n\x04memo\x18\x15 \x01(\x0b\x32\x1c.temporal.api.common.v1.Memo\x12\x43\n\x11search_attributes\x18\x16 \x01(\x0b\x32(.temporal.api.common.v1.SearchAttributes\x12.\n\nstart_time\x18\x17 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12@\n\rroot_workflow\x18\x18 \x01(\x0b\x32).temporal.api.common.v1.WorkflowExecution\x12\x32\n\x08priority\x18\x19 \x01(\x0b\x32 .temporal.api.common.v1.Priority\x1aO\n\x0cHeadersEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12.\n\x05value\x18\x02 \x01(\x0b\x32\x1f.temporal.api.common.v1.Payload:\x02\x38\x01\"\x18\n\tFireTimer\x12\x0b\n\x03seq\x18\x01 \x01(\r\"m\n\x0fResolveActivity\x12\x0b\n\x03seq\x18\x01 \x01(\r\x12;\n\x06result\x18\x02 \x01(\x0b\x32+.coresdk.activity_result.ActivityResolution\x12\x10\n\x08is_local\x18\x03 \x01(\x08\"\xd1\x02\n\"ResolveChildWorkflowExecutionStart\x12\x0b\n\x03seq\x18\x01 \x01(\r\x12[\n\tsucceeded\x18\x02 \x01(\x0b\x32\x46.coresdk.workflow_activation.ResolveChildWorkflowExecutionStartSuccessH\x00\x12X\n\x06\x66\x61iled\x18\x03 \x01(\x0b\x32\x46.coresdk.workflow_activation.ResolveChildWorkflowExecutionStartFailureH\x00\x12]\n\tcancelled\x18\x04 \x01(\x0b\x32H.coresdk.workflow_activation.ResolveChildWorkflowExecutionStartCancelledH\x00\x42\x08\n\x06status\";\n)ResolveChildWorkflowExecutionStartSuccess\x12\x0e\n\x06run_id\x18\x01 \x01(\t\"\xa6\x01\n)ResolveChildWorkflowExecutionStartFailure\x12\x13\n\x0bworkflow_id\x18\x01 \x01(\t\x12\x15\n\rworkflow_type\x18\x02 \x01(\t\x12M\n\x05\x63\x61use\x18\x03 \x01(\x0e\x32>.coresdk.child_workflow.StartChildWorkflowExecutionFailedCause\"`\n+ResolveChildWorkflowExecutionStartCancelled\x12\x31\n\x07\x66\x61ilure\x18\x01 \x01(\x0b\x32 .temporal.api.failure.v1.Failure\"i\n\x1dResolveChildWorkflowExecution\x12\x0b\n\x03seq\x18\x01 \x01(\r\x12;\n\x06result\x18\x02 \x01(\x0b\x32+.coresdk.child_workflow.ChildWorkflowResult\"+\n\x10UpdateRandomSeed\x12\x17\n\x0frandomness_seed\x18\x01 \x01(\x04\"\x84\x02\n\rQueryWorkflow\x12\x10\n\x08query_id\x18\x01 \x01(\t\x12\x12\n\nquery_type\x18\x02 \x01(\t\x12\x32\n\targuments\x18\x03 \x03(\x0b\x32\x1f.temporal.api.common.v1.Payload\x12H\n\x07headers\x18\x05 \x03(\x0b\x32\x37.coresdk.workflow_activation.QueryWorkflow.HeadersEntry\x1aO\n\x0cHeadersEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12.\n\x05value\x18\x02 \x01(\x0b\x32\x1f.temporal.api.common.v1.Payload:\x02\x38\x01\" \n\x0e\x43\x61ncelWorkflow\x12\x0e\n\x06reason\x18\x01 \x01(\t\"\x83\x02\n\x0eSignalWorkflow\x12\x13\n\x0bsignal_name\x18\x01 \x01(\t\x12.\n\x05input\x18\x02 \x03(\x0b\x32\x1f.temporal.api.common.v1.Payload\x12\x10\n\x08identity\x18\x03 \x01(\t\x12I\n\x07headers\x18\x05 \x03(\x0b\x32\x38.coresdk.workflow_activation.SignalWorkflow.HeadersEntry\x1aO\n\x0cHeadersEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12.\n\x05value\x18\x02 \x01(\x0b\x32\x1f.temporal.api.common.v1.Payload:\x02\x38\x01\"\"\n\x0eNotifyHasPatch\x12\x10\n\x08patch_id\x18\x01 \x01(\t\"_\n\x1dResolveSignalExternalWorkflow\x12\x0b\n\x03seq\x18\x01 \x01(\r\x12\x31\n\x07\x66\x61ilure\x18\x02 \x01(\x0b\x32 .temporal.api.failure.v1.Failure\"f\n$ResolveRequestCancelExternalWorkflow\x12\x0b\n\x03seq\x18\x01 \x01(\r\x12\x31\n\x07\x66\x61ilure\x18\x02 \x01(\x0b\x32 .temporal.api.failure.v1.Failure\"\xcb\x02\n\x08\x44oUpdate\x12\n\n\x02id\x18\x01 \x01(\t\x12\x1c\n\x14protocol_instance_id\x18\x02 \x01(\t\x12\x0c\n\x04name\x18\x03 \x01(\t\x12.\n\x05input\x18\x04 \x03(\x0b\x32\x1f.temporal.api.common.v1.Payload\x12\x43\n\x07headers\x18\x05 \x03(\x0b\x32\x32.coresdk.workflow_activation.DoUpdate.HeadersEntry\x12*\n\x04meta\x18\x06 \x01(\x0b\x32\x1c.temporal.api.update.v1.Meta\x12\x15\n\rrun_validator\x18\x07 \x01(\x08\x1aO\n\x0cHeadersEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12.\n\x05value\x18\x02 \x01(\x0b\x32\x1f.temporal.api.common.v1.Payload:\x02\x38\x01\"\x9a\x01\n\x1aResolveNexusOperationStart\x12\x0b\n\x03seq\x18\x01 \x01(\r\x12\x19\n\x0foperation_token\x18\x02 \x01(\tH\x00\x12\x16\n\x0cstarted_sync\x18\x03 \x01(\x08H\x00\x12\x32\n\x06\x66\x61iled\x18\x04 \x01(\x0b\x32 .temporal.api.failure.v1.FailureH\x00\x42\x08\n\x06status\"Y\n\x15ResolveNexusOperation\x12\x0b\n\x03seq\x18\x01 \x01(\r\x12\x33\n\x06result\x18\x02 \x01(\x0b\x32#.coresdk.nexus.NexusOperationResult\"\xe0\x02\n\x0fRemoveFromCache\x12\x0f\n\x07message\x18\x01 \x01(\t\x12K\n\x06reason\x18\x02 \x01(\x0e\x32;.coresdk.workflow_activation.RemoveFromCache.EvictionReason\"\xee\x01\n\x0e\x45victionReason\x12\x0f\n\x0bUNSPECIFIED\x10\x00\x12\x0e\n\nCACHE_FULL\x10\x01\x12\x0e\n\nCACHE_MISS\x10\x02\x12\x12\n\x0eNONDETERMINISM\x10\x03\x12\r\n\tLANG_FAIL\x10\x04\x12\x12\n\x0eLANG_REQUESTED\x10\x05\x12\x12\n\x0eTASK_NOT_FOUND\x10\x06\x12\x15\n\x11UNHANDLED_COMMAND\x10\x07\x12\t\n\x05\x46\x41TAL\x10\x08\x12\x1f\n\x1bPAGINATION_OR_HISTORY_FETCH\x10\t\x12\x1d\n\x19WORKFLOW_EXECUTION_ENDING\x10\nB8\xea\x02\x35Temporalio::Internal::Bridge::Api::WorkflowActivationb\x06proto3"
 
 pool = ::Google::Protobuf::DescriptorPool.generated_pool
 pool.add_serialized_file(descriptor_data)

data/lib/temporalio/internal/bridge/runtime.rb

@@ -6,6 +6,7 @@ module Temporalio
       class Runtime
         Options = Struct.new(
           :telemetry,
+          :worker_heartbeat_interval,
           keyword_init: true
         )
 

data/lib/temporalio/internal/bridge/worker.rb

@@ -7,8 +7,6 @@ module Temporalio
     module Bridge
       class Worker
         Options = Struct.new(
-          :activity,
-          :workflow,
           :namespace,
           :task_queue,
           :tuner,
@@ -17,7 +15,10 @@ module Temporalio
           :workflow_task_poller_behavior,
           :nonsticky_to_sticky_poll_ratio,
           :activity_task_poller_behavior,
-          :no_remote_activities,
+          :enable_workflows,
+          :enable_local_activities,
+          :enable_remote_activities,
+          :enable_nexus,
           :sticky_queue_schedule_to_start_timeout,
           :max_heartbeat_throttle_interval,
           :default_heartbeat_throttle_interval,

data/lib/temporalio/internal/worker/workflow_instance.rb

@@ -133,6 +133,7 @@ module Temporalio
               last_result: if @init_job.last_completion_result
                              @payload_converter.from_payloads(@init_job.last_completion_result).first
                            end,
+              has_last_result?: !@init_job.last_completion_result.nil?,
               namespace: details.namespace,
               parent: if @init_job.parent_workflow_info
                         Workflow::Info::ParentInfo.new(

data/lib/temporalio/runtime.rb

@@ -101,7 +101,8 @@ module Temporalio
       # @!visibility private
       def _to_bridge
         # @type self: LoggingFilterOptions
-        "#{other_level},temporal_sdk_core=#{core_level},temporal_client=#{core_level},temporal_sdk=#{core_level}"
+        "#{other_level},temporalio_sdk_core=#{core_level},temporalio_client=#{core_level}," \
+          "temporalio_sdk=#{core_level},temporalio_bridge=#{core_level}"
       end
     end
 
@@ -329,12 +330,24 @@ module Temporalio
     # pool, this also consumes a Ruby thread for its lifetime.
     #
     # @param telemetry [TelemetryOptions] Telemetry options to set.
-    def initialize(telemetry: TelemetryOptions.new)
+    # @param worker_heartbeat_interval [Float, nil] Interval for worker heartbeats in seconds. Can be nil to disable
+    #   heartbeating. Interval must be between 1s and 60s.
+    def initialize(
+      telemetry: TelemetryOptions.new,
+      worker_heartbeat_interval: 60
+    )
+      if !worker_heartbeat_interval.nil? && !worker_heartbeat_interval.positive?
+        raise 'Worker heartbeat interval must be positive'
+      end
+
       # Set runtime on the buffer which will fail if the buffer is used on another runtime
       telemetry.metrics&.buffer&._set_runtime(self)
 
       @core_runtime = Internal::Bridge::Runtime.new(
-        Internal::Bridge::Runtime::Options.new(telemetry: telemetry._to_bridge)
+        Internal::Bridge::Runtime::Options.new(
+          telemetry: telemetry._to_bridge,
+          worker_heartbeat_interval:
+        )
       )
       @metric_meter = Internal::Metric::Meter.create_from_runtime(self) || Metric::Meter.null
       # We need a thread to run the command loop

data/lib/temporalio/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Temporalio
-  VERSION = '1.0.0'
+  VERSION = '1.1.0'
 end

data/lib/temporalio/worker/tuner.rb

@@ -32,8 +32,6 @@ module Temporalio
         end
 
         # A slot supplier that will dynamically adjust the number of slots based on resource usage.
-        #
-        # @note WARNING: This API is experimental.
         class ResourceBased < SlotSupplier
           attr_reader :tuner_options, :slot_options
 
@@ -66,8 +64,6 @@ module Temporalio
         #
         # Users should be cautious when implementing this and make sure it is heavily tested and the documentation for
         # every method is well understood.
-        #
-        # @note WARNING: This API is experimental.
         class Custom < SlotSupplier
           # Context provided for slot reservation on custom slot supplier.
           #

data/lib/temporalio/worker/workflow_replayer.rb

@@ -197,8 +197,6 @@ module Temporalio
           @bridge_replayer, @bridge_worker = Internal::Bridge::Worker::WorkflowReplayer.new(
             options.runtime._core_runtime,
             Internal::Bridge::Worker::Options.new(
-              activity: false,
-              workflow: true,
               namespace: options.namespace,
               task_queue: options.task_queue,
               tuner: Tuner.create_fixed(
@@ -211,7 +209,10 @@ module Temporalio
               nonsticky_to_sticky_poll_ratio: 1.0,
               activity_task_poller_behavior:
                 Temporalio::Worker::PollerBehavior::SimpleMaximum.new(1)._to_bridge_options,
-              no_remote_activities: true,
+              enable_workflows: true,
+              enable_local_activities: false,
+              enable_remote_activities: false,
+              enable_nexus: false,
               sticky_queue_schedule_to_start_timeout: 1.0,
               max_heartbeat_throttle_interval: 1.0,
               default_heartbeat_throttle_interval: 1.0,

data/lib/temporalio/worker.rb

@@ -465,8 +465,6 @@ module Temporalio
       @bridge_worker = Internal::Bridge::Worker.new(
         client.connection._core_client,
         Internal::Bridge::Worker::Options.new(
-          activity: !activities.empty?,
-          workflow: !workflows.empty?,
           namespace: client.namespace,
           task_queue:,
           tuner: tuner._to_bridge_options,
@@ -475,9 +473,10 @@ module Temporalio
           workflow_task_poller_behavior: workflow_task_poller_behavior._to_bridge_options,
           nonsticky_to_sticky_poll_ratio:,
           activity_task_poller_behavior: activity_task_poller_behavior._to_bridge_options,
-          # For shutdown to work properly, we must disable remote activities
-          # ourselves if there are no activities
-          no_remote_activities: no_remote_activities || activities.empty?,
+          enable_workflows: !workflows.empty?,
+          enable_local_activities: !workflows.empty? && !activities.empty?,
+          enable_remote_activities: !activities.empty? && !no_remote_activities,
+          enable_nexus: false,
           sticky_queue_schedule_to_start_timeout:,
           max_heartbeat_throttle_interval:,
           default_heartbeat_throttle_interval:,

data/lib/temporalio/workflow/info.rb

@@ -11,6 +11,7 @@ module Temporalio
       :headers,
       :last_failure,
       :last_result,
+      :has_last_result?,
       :namespace,
       :parent,
       :priority,
@@ -44,6 +45,9 @@ module Temporalio
     #   @return [Exception, nil] Failure if this workflow run is a continuation of a failure.
     # @!attribute last_result
     #   @return [Object, nil] Successful result if this workflow is a continuation of a success.
+    # @!attribute has_last_result?
+    #   @return [Boolean] Successful result if this workflow is a continuation of a success.
+
     # @!attribute namespace
     #   @return [String] Namespace for the workflow.
     # @!attribute parent

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: temporalio
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.1.0
 platform: x86_64-linux
 authors:
 - Temporal Technologies Inc
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2025-09-29 00:00:00.000000000 Z
+date: 2025-12-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-protobuf