temporalio 1.7.0-x86_64-linux → 1.8.0-x86_64-linux

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cf8eb367ec609eb27a2532584c08900bb6ddb83c9e557a4e0b56f4ebce771315
-  data.tar.gz: b7c440941d105ffb8777b0c14a5c98246e9acb490cfa44e709577e7edc1115a8
+  metadata.gz: 9c8d32b494a1d9b5783705d25806b2344eea22a0215b5bae6cc1d50fa46e9b2f
+  data.tar.gz: 00772da1220ca6a4c3808f0d372c8674e7465c0e725ad7ae4d9bfb5b473d7be4
 SHA512:
-  metadata.gz: 077d14a59deac377895e790cce96e284fb00b4e2c5eb7dc9f77a28e9ecc17b38d5e31a0ca0feb8f61def330c7d5d75c0e1542460b6a55a8a750647bef31c0595
-  data.tar.gz: 286d6d7a4ac4e97de19725f63a5f4bf20e8eda52c44918c0f0ec274e5528f889ae92101068e6196c72baac0f0119da188d9cfe124515d0af59e4ea1f799ea2cd
+  metadata.gz: a8556bdbe97f3c82dfe673b9896e8de669f7f89c4b859fd66ba02f5bc9dabc7e135168939b0a0f3f51cf0e02f53023562d2df5d3c44fa2059adf9aa5942493cc
+  data.tar.gz: f20a985e37fe1fcb76a34de2a6a7706c602caba82eb166d66e47d887af7fa40f307bbf0356b4743bd28bc6bf16eb9caba6f7524e9b13da0c1ff9f8a762e1c6c7

data/Rakefile

@@ -27,6 +27,25 @@ Rake::TestTask.new(:test) do |t|
   t.test_files = FileList['test/**/*_test.rb', 'extra/release/test/**/*_test.rb']
 end
 
+namespace :test do
+  desc 'List tests excluded from Temporal Cloud by reason'
+  task :cloud_inventory do
+    ENV['TESTOPTS'] = [
+      ENV.fetch('TESTOPTS', nil),
+      '--cloud-inventory',
+      '--name=/CloudTestInventoryTest#test_report/'
+    ].compact.join(' ')
+    Rake::Task[:test].invoke
+  end
+
+  desc 'Run tests eligible for Temporal Cloud using envconfig'
+  task :cloud do
+    ENV['TEMPORAL_TEST_ENV_CONFIG_SERVER'] = '1'
+    ENV['TESTOPTS'] = [ENV.fetch('TESTOPTS', nil), '--cloud'].compact.join(' ')
+    Rake::Task[:test].invoke
+  end
+end
+
 require 'rubocop/rake_task'
 
 RuboCop::RakeTask.new

data/lib/temporalio/client/activity_execution.rb

@@ -46,6 +46,12 @@ module Temporalio
         Internal::ProtoUtils.timestamp_to_time(@raw_info.schedule_time)
       end
 
+      # @return [Time, nil] When the first activity task was made available for dispatch. Equals
+      #   schedule_time + start_delay; equal to schedule_time when no start delay is set.
+      def execution_time
+        Internal::ProtoUtils.timestamp_to_time(@raw_info.execution_time)
+      end
+
       # @return [Time, nil] When the activity reached a terminal state.
       def close_time
         Internal::ProtoUtils.timestamp_to_time(@raw_info.close_time)
@@ -112,7 +118,17 @@ module Temporalio
           Internal::ProtoUtils.duration_to_seconds(@raw_info.heartbeat_timeout)
         end
 
-        # @return [Boolean] Whether the activity has recorded any heartbeat details.
+        # @return [Float, nil] Delay in seconds before the first activity task is made available for
+        #   dispatch. Not applied to retry attempts.
+        def start_delay
+          Internal::ProtoUtils.duration_to_seconds(@raw_info.start_delay)
+        end
+
+        # Whether heartbeat details are present on this description. False when the activity
+        # recorded none, and also when {ActivityHandle#describe} was called without
+        # `include_heartbeat_details:`.
+        #
+        # @return [Boolean] Whether heartbeat details are present.
         def has_heartbeat_details? # rubocop:disable Naming/PredicatePrefix
           !@raw_info.heartbeat_details&.payloads.nil? && !@raw_info.heartbeat_details.payloads.empty?
         end
@@ -125,6 +141,57 @@ module Temporalio
           @data_converter.from_payloads(@raw_info.heartbeat_details, hints:)
         end
 
+        # Whether the activity's input is present. False unless {ActivityHandle#describe} was
+        # called with `include_input:`.
+        #
+        # @return [Boolean] Whether input is present.
+        def has_input? # rubocop:disable Naming/PredicatePrefix
+          !@raw_description.input.nil?
+        end
+
+        # Deserialized activity input, one element per argument. Empty when no input is present.
+        #
+        # @param hints [Array<Object>, nil] Hints, if any, to assist conversion.
+        # @return [Array<Object>] Converted arguments.
+        def input(hints: nil)
+          @data_converter.from_payloads(@raw_description.input, hints:)
+        end
+
+        # Whether the activity closed with a successful result. False while the activity is still
+        # running, when it closed with a failure, and when {ActivityHandle#describe} was called
+        # without `include_outcome:`.
+        #
+        # @return [Boolean] Whether a result is present.
+        def has_result? # rubocop:disable Naming/PredicatePrefix
+          @raw_description.outcome&.value == :result
+        end
+
+        # Deserialized result the activity closed with. Nil when no result is present (still
+        # running, closed with a failure, or `include_outcome:` was not requested).
+        #
+        # @param result_hint [Object, nil] Hint, if any, to assist conversion.
+        # @return [Object, nil] Converted result.
+        def result(result_hint: nil)
+          return nil unless has_result?
+
+          @data_converter.from_payloads(
+            @raw_description.outcome.result, hints: Array(result_hint)
+          ).first
+        end
+
+        # Failure the activity closed with. Nil when the activity did not close with a failure or
+        # when {ActivityHandle#describe} was called without `include_outcome:`.
+        #
+        # This is the terminal outcome; {#last_failure} is the failure of the most recent attempt,
+        # which may be set while the activity is still retrying.
+        #
+        # @return [Error::Failure, nil] Converted failure.
+        def failure
+          return nil unless @raw_description.outcome&.value == :failure
+
+          @data_converter.from_failure(@raw_description.outcome.failure)
+        end
+
         # @return [RetryPolicy] Retry policy in effect for this activity.
         def retry_policy
           RetryPolicy._from_proto(@raw_info.retry_policy)
@@ -145,6 +212,20 @@ module Temporalio
           @raw_info.attempt
         end
 
+        # @return [Integer] Total number of heartbeats recorded across all attempts.
+        def total_heartbeat_count
+          @raw_info.total_heartbeat_count
+        end
+
+        # Whether a last failure is present on this description. False when the activity has no
+        # failed attempt, and also when {ActivityHandle#describe} was called without
+        # `include_last_failure:`.
+        #
+        # @return [Boolean] Whether a last failure is present.
+        def has_last_failure? # rubocop:disable Naming/PredicatePrefix
+          !@raw_info.last_failure.nil?
+        end
+
         # @return [Error::Failure, nil] Failure of the last failed attempt if any.
         def last_failure
           return nil unless @raw_info.last_failure

data/lib/temporalio/client/activity_execution_options.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+require 'temporalio/internal/proto_utils'
+require 'temporalio/priority'
+require 'temporalio/retry_policy'
+
+module Temporalio
+  class Client
+    # The resolved options of a standalone activity execution, as returned by
+    # {ActivityHandle#update_options}. Reflects the activity's options as the server resolved them
+    # after the update was applied.
+    #
+    # WARNING: Standalone Activities are experimental.
+    ActivityExecutionOptions = Data.define(
+      :task_queue,
+      :schedule_to_close_timeout,
+      :schedule_to_start_timeout,
+      :start_to_close_timeout,
+      :heartbeat_timeout,
+      :retry_policy,
+      :priority,
+      :start_delay
+    ) do
+      # @!visibility private
+      def self._from_proto(options)
+        new(
+          task_queue: Internal::ProtoUtils.string_or(options.task_queue&.name, nil),
+          schedule_to_close_timeout: Internal::ProtoUtils.duration_to_seconds(options.schedule_to_close_timeout),
+          schedule_to_start_timeout: Internal::ProtoUtils.duration_to_seconds(options.schedule_to_start_timeout),
+          start_to_close_timeout: Internal::ProtoUtils.duration_to_seconds(options.start_to_close_timeout),
+          heartbeat_timeout: Internal::ProtoUtils.duration_to_seconds(options.heartbeat_timeout),
+          retry_policy: options.retry_policy ? RetryPolicy._from_proto(options.retry_policy) : nil,
+          priority: Priority._from_proto(options.priority),
+          start_delay: Internal::ProtoUtils.duration_to_seconds(options.start_delay)
+        )
+      end
+    end
+  end
+end

data/lib/temporalio/client/activity_execution_status.rb

@@ -15,6 +15,7 @@ module Temporalio
       CANCELED = Api::Enums::V1::ActivityExecutionStatus::ACTIVITY_EXECUTION_STATUS_CANCELED
       TERMINATED = Api::Enums::V1::ActivityExecutionStatus::ACTIVITY_EXECUTION_STATUS_TERMINATED
       TIMED_OUT = Api::Enums::V1::ActivityExecutionStatus::ACTIVITY_EXECUTION_STATUS_TIMED_OUT
+      PAUSED = Api::Enums::V1::ActivityExecutionStatus::ACTIVITY_EXECUTION_STATUS_PAUSED
     end
   end
 end

data/lib/temporalio/client/activity_handle.rb

@@ -2,8 +2,13 @@
 
 require 'temporalio/api'
 require 'temporalio/client/activity_execution'
+require 'temporalio/client/activity_execution_options'
+require 'temporalio/client/activity_options'
 require 'temporalio/client/interceptor'
 require 'temporalio/error'
+require 'temporalio/internal/proto_utils'
+require 'temporalio/priority'
+require 'temporalio/retry_policy'
 
 module Temporalio
   class Client
@@ -55,15 +60,35 @@ module Temporalio
 
       # Describe the activity.
       #
+      # The payload-bearing fields are opt-in because they can be arbitrarily large; request them
+      # only when needed. Each has a corresponding predicate on the returned description that
+      # reports whether the server supplied it.
+      #
+      # @param include_input [Boolean] If true and the activity received input, include the input.
+      # @param include_outcome [Boolean] If true and the activity is closed, include the outcome.
+      # @param include_heartbeat_details [Boolean] If true and the activity recorded heartbeat
+      #   details, include them.
+      # @param include_last_failure [Boolean] If true and the activity has a failed attempt, include
+      #   the last failure.
       # @param rpc_options [RPCOptions, nil] Advanced RPC options.
       #
       # @return [ActivityExecution::Description] Activity description.
       # @raise [Error::RPCError] RPC error from call.
-      def describe(rpc_options: nil)
+      def describe(
+        include_input: false,
+        include_outcome: false,
+        include_heartbeat_details: false,
+        include_last_failure: false,
+        rpc_options: nil
+      )
         @client._impl.describe_activity(
           Interceptor::DescribeActivityInput.new(
             activity_id: id,
             activity_run_id: run_id,
+            include_input:,
+            include_outcome:,
+            include_heartbeat_details:,
+            include_last_failure:,
             rpc_options:
           )
         )
@@ -103,6 +128,102 @@ module Temporalio
         nil
       end
 
+      # Pause the activity. A paused activity is not scheduled or retried until it is unpaused via
+      # {#unpause}.
+      #
+      # WARNING: Standalone Activities are experimental.
+      #
+      # @param reason [String, nil] Optional reason recorded on the server.
+      # @param rpc_options [RPCOptions, nil] Advanced RPC options.
+      # @raise [Error::RPCError] RPC error from call.
+      def pause(reason = nil, rpc_options: nil)
+        @client._impl.pause_activity(
+          Interceptor::PauseActivityInput.new(
+            activity_id: id,
+            activity_run_id: run_id,
+            reason:,
+            rpc_options:
+          )
+        )
+        nil
+      end
+
+      # Unpause the activity, allowing it to be scheduled or retried again.
+      #
+      # WARNING: Standalone Activities are experimental.
+      #
+      # @param reason [String, nil] Optional reason recorded on the server.
+      # @param jitter [Float, nil] If set, the activity will start at a random time within this
+      #   duration (in seconds).
+      # @param rpc_options [RPCOptions, nil] Advanced RPC options.
+      # @raise [Error::RPCError] RPC error from call.
+      def unpause(reason: nil, jitter: nil, rpc_options: nil)
+        @client._impl.unpause_activity(
+          Interceptor::UnpauseActivityInput.new(
+            activity_id: id,
+            activity_run_id: run_id,
+            reason:,
+            jitter:,
+            rpc_options:
+          )
+        )
+        nil
+      end
+
+      # Update the activity's options. Only the options named by `updates` are changed; anything
+      # not named is left as-is.
+      #
+      # Updates are created from the keys on {ActivityOptions}, via {ActivityOptions::Key#value_set}
+      # to set an option or {ActivityOptions::Key#value_unset} to clear it.
+      #
+      # WARNING: Standalone Activities are experimental.
+      #
+      # @param updates [Array<ActivityOptions::Update>] The option updates to apply. At least one is
+      #   required unless `restore_original` is true.
+      # @param restore_original [Boolean] If true, restore the options to the originals the activity
+      #   was created with. Mutually exclusive with any update.
+      # @param rpc_options [RPCOptions, nil] Advanced RPC options.
+      #
+      # @return [ActivityExecutionOptions] The activity options after the update.
+      #
+      # @raise [ArgumentError] If a non-update is given, if `restore_original` is combined with any
+      #   update, or if no update is provided and `restore_original` is false.
+      # @raise [Error::RPCError] RPC error from call.
+      def update_options(*updates, restore_original: false, rpc_options: nil)
+        unless updates.all?(ActivityOptions::Update)
+          raise ArgumentError,
+                'Updates must be created via ActivityOptions::Key#value_set or #value_unset'
+        end
+
+        if restore_original && !updates.empty?
+          raise ArgumentError, 'restore_original cannot be combined with any option update'
+        elsif !restore_original && updates.empty?
+          raise ArgumentError,
+                'At least one option update must be given, or restore_original must be used'
+        end
+
+        # For repeated keys, later values override previous ones.
+        by_path = updates.to_h { |update| [update.key.name, update] }
+
+        proto = Api::Activity::V1::ActivityOptions.new
+        by_path.each_value do |update|
+          # An unset update names its path but leaves the field absent, which is how the server is
+          # told to clear the option rather than set it to a value.
+          update.key._apply(proto, update.value) unless update.value.nil?
+        end
+
+        @client._impl.update_activity_options(
+          Interceptor::UpdateActivityOptionsInput.new(
+            activity_id: id,
+            activity_run_id: run_id,
+            activity_options: proto,
+            update_mask: Google::Protobuf::FieldMask.new(paths: by_path.keys),
+            restore_original:,
+            rpc_options:
+          )
+        )
+      end
+
       private
 
       def _process_outcome(outcome, hint)

data/lib/temporalio/client/activity_options.rb

@@ -0,0 +1,113 @@
+# frozen_string_literal: true
+
+require 'temporalio/api'
+require 'temporalio/internal/proto_utils'
+
+module Temporalio
+  class Client
+    # The activity options that {ActivityHandle#update_options} can change.
+    #
+    # Updates are created from the keys below, via {Key#value_set} to set an option or
+    # {Key#value_unset} to clear it. An option with no update is left untouched.
+    #
+    # WARNING: Standalone Activities are experimental.
+    module ActivityOptions
+      # Typed key for one updatable activity option. Use the keys on {ActivityOptions} rather than
+      # constructing these directly.
+      class Key
+        # @return [String] Field-mask path this key updates.
+        attr_reader :name
+
+        # @!visibility private
+        def initialize(name, &to_proto)
+          @name = name
+          @to_proto = to_proto
+          freeze
+        end
+
+        # Create an update that sets this option to the given value.
+        #
+        # @param value [Object] Value to set. Cannot be nil.
+        # @return [Update] Created update.
+        def value_set(value)
+          raise ArgumentError, 'Value cannot be nil, use value_unset' if value.nil?
+
+          Update.new(self, value)
+        end
+
+        # Create an update that clears this option server-side.
+        #
+        # @return [Update] Created update.
+        def value_unset
+          Update.new(self, nil)
+        end
+
+        # @!visibility private
+        def _apply(proto, value)
+          @to_proto.call(proto, value)
+        end
+      end
+
+      # A single change to an activity's options that can be separately applied.
+      class Update
+        # @return [Key] Key this update applies to.
+        attr_reader :key
+
+        # @return [Object, nil] Value to set, or `nil` to clear the option.
+        attr_reader :value
+
+        # Create an update. Users may find it easier to use {Key#value_set} and {Key#value_unset}.
+        #
+        # @param key [Key] Key to update.
+        # @param value [Object, nil] Value to set, or nil to clear the option.
+        def initialize(key, value)
+          raise ArgumentError, 'Key must be a key' unless key.is_a?(Key)
+
+          @key = key
+          @value = value
+          freeze
+        end
+      end
+
+      # @return [Key] New task queue.
+      TASK_QUEUE = Key.new('task_queue.name') do |proto, value|
+        proto.task_queue = Api::TaskQueue::V1::TaskQueue.new(name: value.to_s)
+      end
+
+      # @return [Key] New schedule-to-close timeout in seconds.
+      SCHEDULE_TO_CLOSE_TIMEOUT = Key.new('schedule_to_close_timeout') do |proto, value|
+        proto.schedule_to_close_timeout = Internal::ProtoUtils.seconds_to_duration(value)
+      end
+
+      # @return [Key] New schedule-to-start timeout in seconds.
+      SCHEDULE_TO_START_TIMEOUT = Key.new('schedule_to_start_timeout') do |proto, value|
+        proto.schedule_to_start_timeout = Internal::ProtoUtils.seconds_to_duration(value)
+      end
+
+      # @return [Key] New start-to-close timeout in seconds.
+      START_TO_CLOSE_TIMEOUT = Key.new('start_to_close_timeout') do |proto, value|
+        proto.start_to_close_timeout = Internal::ProtoUtils.seconds_to_duration(value)
+      end
+
+      # @return [Key] New heartbeat timeout in seconds.
+      HEARTBEAT_TIMEOUT = Key.new('heartbeat_timeout') do |proto, value|
+        proto.heartbeat_timeout = Internal::ProtoUtils.seconds_to_duration(value)
+      end
+
+      # @return [Key] New start delay in seconds.
+      START_DELAY = Key.new('start_delay') do |proto, value|
+        proto.start_delay = Internal::ProtoUtils.seconds_to_duration(value)
+      end
+
+      # @return [Key] New retry policy.
+      RETRY_POLICY = Key.new('retry_policy') do |proto, value|
+        proto.retry_policy = value._to_proto
+      end
+
+      # @return [Key] New priority.
+      PRIORITY = Key.new('priority') do |proto, value|
+        proto.priority = value._to_proto
+      end
+    end
+  end
+end

data/lib/temporalio/client/interceptor.rb

@@ -291,6 +291,10 @@ module Temporalio
       DescribeActivityInput = Data.define(
         :activity_id,
         :activity_run_id,
+        :include_input,
+        :include_outcome,
+        :include_heartbeat_details,
+        :include_last_failure,
         :rpc_options
       )
 
@@ -314,6 +318,39 @@ module Temporalio
         :rpc_options
       )
 
+      # Input for {Outbound.pause_activity}.
+      #
+      # WARNING: Standalone Activities are experimental.
+      PauseActivityInput = Data.define(
+        :activity_id,
+        :activity_run_id,
+        :reason,
+        :rpc_options
+      )
+
+      # Input for {Outbound.unpause_activity}.
+      #
+      # WARNING: Standalone Activities are experimental.
+      UnpauseActivityInput = Data.define(
+        :activity_id,
+        :activity_run_id,
+        :reason,
+        :jitter,
+        :rpc_options
+      )
+
+      # Input for {Outbound.update_activity_options}.
+      #
+      # WARNING: Standalone Activities are experimental.
+      UpdateActivityOptionsInput = Data.define(
+        :activity_id,
+        :activity_run_id,
+        :activity_options,
+        :update_mask,
+        :restore_original,
+        :rpc_options
+      )
+
       # Input for {Outbound.list_activities}.
       #
       # WARNING: Standalone Activities are experimental.
@@ -587,6 +624,34 @@ module Temporalio
           next_interceptor.terminate_activity(input)
         end
 
+        # Called for every {ActivityHandle.pause} call.
+        #
+        # WARNING: Standalone Activities are experimental.
+        #
+        # @param input [PauseActivityInput] Input.
+        def pause_activity(input)
+          next_interceptor.pause_activity(input)
+        end
+
+        # Called for every {ActivityHandle.unpause} call.
+        #
+        # WARNING: Standalone Activities are experimental.
+        #
+        # @param input [UnpauseActivityInput] Input.
+        def unpause_activity(input)
+          next_interceptor.unpause_activity(input)
+        end
+
+        # Called for every {ActivityHandle.update_options} call.
+        #
+        # WARNING: Standalone Activities are experimental.
+        #
+        # @param input [UpdateActivityOptionsInput] Input.
+        # @return [Api::Activity::V1::ActivityOptions] Activity options after the update.
+        def update_activity_options(input)
+          next_interceptor.update_activity_options(input)
+        end
+
         # Called for every {Client.list_activities} call.
         #
         # WARNING: Standalone Activities are experimental.

data/lib/temporalio/internal/client/implementation.rb

@@ -29,7 +29,7 @@ require 'temporalio/workflow/definition'
 module Temporalio
   module Internal
     module Client
-      class Implementation < Temporalio::Client::Interceptor::Outbound
+      class Implementation < Temporalio::Client::Interceptor::Outbound # rubocop:disable Metrics/ClassLength
         # Proto routing convention for standalone activity completion: `*_by_id` requests carry
         # `resource_id = "activity:<activity_id>"`. See the resource_id field comment on
         # `RecordActivityTaskHeartbeatByIdRequest` (and the analogous Completed/Failed/Canceled
@@ -1025,7 +1025,11 @@ module Temporalio
             Api::WorkflowService::V1::DescribeActivityExecutionRequest.new(
               namespace: @client.namespace,
               activity_id: input.activity_id,
-              run_id: input.activity_run_id || ''
+              run_id: input.activity_run_id || '',
+              include_input: input.include_input,
+              include_outcome: input.include_outcome,
+              include_heartbeat_details: input.include_heartbeat_details,
+              include_last_failure: input.include_last_failure
             ),
             rpc_options: Implementation.with_default_rpc_options(input.rpc_options)
           )
@@ -1062,6 +1066,54 @@ module Temporalio
           nil
         end
 
+        def pause_activity(input)
+          @client.workflow_service.pause_activity_execution(
+            Api::WorkflowService::V1::PauseActivityExecutionRequest.new(
+              namespace: @client.namespace,
+              activity_id: input.activity_id,
+              run_id: input.activity_run_id || '',
+              identity: @client.connection.identity,
+              request_id: SecureRandom.uuid,
+              reason: input.reason || ''
+            ),
+            rpc_options: Implementation.with_default_rpc_options(input.rpc_options)
+          )
+          nil
+        end
+
+        def unpause_activity(input)
+          @client.workflow_service.unpause_activity_execution(
+            Api::WorkflowService::V1::UnpauseActivityExecutionRequest.new(
+              namespace: @client.namespace,
+              activity_id: input.activity_id,
+              run_id: input.activity_run_id || '',
+              identity: @client.connection.identity,
+              request_id: SecureRandom.uuid,
+              reason: input.reason || '',
+              jitter: ProtoUtils.seconds_to_duration(input.jitter)
+            ),
+            rpc_options: Implementation.with_default_rpc_options(input.rpc_options)
+          )
+          nil
+        end
+
+        def update_activity_options(input)
+          resp = @client.workflow_service.update_activity_execution_options(
+            Api::WorkflowService::V1::UpdateActivityExecutionOptionsRequest.new(
+              namespace: @client.namespace,
+              activity_id: input.activity_id,
+              run_id: input.activity_run_id || '',
+              identity: @client.connection.identity,
+              request_id: SecureRandom.uuid,
+              activity_options: input.activity_options,
+              update_mask: input.update_mask,
+              restore_original: input.restore_original
+            ),
+            rpc_options: Implementation.with_default_rpc_options(input.rpc_options)
+          )
+          Temporalio::Client::ActivityExecutionOptions._from_proto(resp.activity_options)
+        end
+
         def list_activities(input)
           Enumerator.new do |yielder|
             req = Api::WorkflowService::V1::ListActivityExecutionsRequest.new(

data/lib/temporalio/scoped_logger.rb

@@ -106,6 +106,9 @@ module Temporalio
         message_str = message.is_a?(String) ? message : message.inspect
         "#{message_str} #{scoped_values}"
       end
+
+      # @return [String] The log message.
+      alias to_s message
     end
   end
 end

data/lib/temporalio/version.rb

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

data/lib/temporalio/worker/activity_executor/fiber.rb

@@ -39,8 +39,18 @@ module Temporalio
           return unless defn.cancel_raise
 
           fiber = ::Fiber.current
+          scheduler = ::Fiber.scheduler
+          scheduler = nil unless scheduler.respond_to?(:fiber_interrupt)
           context&.cancellation&.add_cancel_callback do
-            fiber.raise(Error::CanceledError.new('Activity canceled'))
+            error = Error::CanceledError.new('Activity canceled')
+            # Directly raising from another fiber can strand a `Fiber#transfer`
+            # based scheduler's current fiber, so we defer to the scheduler to interrupt.
+            # If on the same fiber, we can just raise directly.
+            if scheduler.nil? || ::Fiber.current.equal?(fiber)
+              fiber.raise(error)
+            else
+              scheduler.fiber_interrupt(fiber, error)
+            end
           end
         end
       end