temporalio 1.8.0 → 1.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: eab42914a8505489221304731b5e794855699374913e2ceda6b37dc446d175b7
-  data.tar.gz: ec78f3ae4a518ba34d8086d372684b9f71f2de89b380e639a7f4e83a44e8b6f5
+  metadata.gz: 83bdaf2665c0e0870da1ad032bc014bb2a99970eee632c7349b5ebd35611bea3
+  data.tar.gz: 8bd6f029572ee2b46477306283a33480eaea57bf8bdac45ed094bcd6bc2110c8
 SHA512:
-  metadata.gz: aafa0d2a6640601bf031ce18029c5135a53c5127056e0c423c1ade397069e746f4d96278cc282286f28213b32aa5248c7fcc2a9f3c71579caa68d1a8cf59774b
-  data.tar.gz: 7a4054f79dbcb27a9f27a9d6d16e9275d7cfd4663f04775c9525a9b63a234df70986fc9c9db40fcacac58ec272e401c59f552fadb4d782d21a277f1d5fe1e154
+  metadata.gz: bc6cad44f81d64124fb61c16605f011ebace9a6121ef8e7d63b81dd88e4050da7e5aac376e326679c6d4da2f44d1a3a3fdcc4a5c21fd8335a3c5f22d40eeb27b
+  data.tar.gz: a04e3cebf85f26728de6445268cd3f88adc3614f4c02bc9bae3e05a566f2a0848cb6a8d61eba595d14eb651f6db5c89b471ef3fb4f71ad98e0d47591a2599dbf

data/lib/temporalio/activity/info.rb

@@ -35,7 +35,6 @@ module Temporalio
     #   @return [String] ID for the activity.
     # @!attribute activity_run_id
     #   @return [String, nil] Run ID for a standalone activity execution. nil for activities scheduled from a workflow.
-    #     WARNING: Standalone Activities are experimental.
     # @!attribute activity_type
     #   @return [String] Type name for the activity.
     # @!attribute attempt
@@ -85,8 +84,6 @@ module Temporalio
     #   class or it may break in incompatible ways.
     class Info
       # @return [Boolean] True if this activity was scheduled by a workflow execution; false for standalone activities.
-      #
-      # WARNING: Standalone Activities are experimental.
       def in_workflow?
         !workflow_id.nil?
       end

data/lib/temporalio/client/activity_execution.rb

@@ -13,8 +13,6 @@ module Temporalio
   class Client
     # Info for a standalone activity execution. Returned by list_activities; extended by {Description}
     # for describe results.
-    #
-    # WARNING: Standalone Activities are experimental.
     class ActivityExecution
       # @return [Api::Activity::V1::ActivityExecutionListInfo, Api::Activity::V1::ActivityExecutionInfo]
       #   Underlying protobuf info.
@@ -78,8 +76,6 @@ module Temporalio
       end
 
       # Rich description of a standalone activity execution; returned by {ActivityHandle#describe}.
-      #
-      # WARNING: Standalone Activities are experimental.
       class Description < ActivityExecution
         # @return [Api::WorkflowService::V1::DescribeActivityExecutionResponse] Underlying protobuf response.
         attr_reader :raw_description
@@ -280,7 +276,7 @@ module Temporalio
         end
 
         # @return [String, nil] Static user-metadata summary on the activity.
-        def static_summary
+        def summary
           user_metadata.first
         end
 

data/lib/temporalio/client/activity_execution_count.rb

@@ -3,8 +3,6 @@
 module Temporalio
   class Client
     # Result of a {Client#count_activities} call.
-    #
-    # WARNING: Standalone Activities are experimental.
     class ActivityExecutionCount
       # @return [Integer] Approximate number of activities matching the query. If the query had a group-by clause,
       #   this is the sum of all the counts in {groups}.
@@ -20,8 +18,6 @@ module Temporalio
       end
 
       # Aggregation group if the activity count query had a group-by clause.
-      #
-      # WARNING: Standalone Activities are experimental.
       class AggregationGroup
         # @return [Integer] Approximate number of activities matching the query for this group.
         attr_reader :count

data/lib/temporalio/client/activity_execution_status.rb

@@ -5,8 +5,6 @@ require 'temporalio/api'
 module Temporalio
   class Client
     # Status of a standalone activity execution.
-    #
-    # WARNING: Standalone Activities are experimental.
     module ActivityExecutionStatus
       UNSPECIFIED = Api::Enums::V1::ActivityExecutionStatus::ACTIVITY_EXECUTION_STATUS_UNSPECIFIED
       RUNNING = Api::Enums::V1::ActivityExecutionStatus::ACTIVITY_EXECUTION_STATUS_RUNNING

data/lib/temporalio/client/activity_handle.rb

@@ -14,8 +14,6 @@ module Temporalio
   class Client
     # Handle for interacting with a standalone activity. Usually created via {Client.activity_handle}
     # or {Client#start_activity}.
-    #
-    # WARNING: Standalone Activities are experimental.
     class ActivityHandle
       # @return [String] ID for the activity.
       attr_reader :id
@@ -179,7 +177,7 @@ module Temporalio
       # 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.
+      #   required unless `restore_original` is true. Each option may be named at most once.
       # @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.
@@ -187,7 +185,8 @@ module Temporalio
       # @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.
+      #   update, if no update is provided and `restore_original` is false, or if the same option is
+      #   named more than once.
       # @raise [Error::RPCError] RPC error from call.
       def update_options(*updates, restore_original: false, rpc_options: nil)
         unless updates.all?(ActivityOptions::Update)
@@ -202,8 +201,12 @@ module Temporalio
                 '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] }
+        by_path = updates.each_with_object({}) do |update, acc|
+          name = update.key.name
+          raise ArgumentError, "More than one update given for option #{name}" if acc.key?(name)
+
+          acc[name] = update
+        end
 
         proto = Api::Activity::V1::ActivityOptions.new
         by_path.each_value do |update|

data/lib/temporalio/client/activity_id_reference.rb

@@ -29,8 +29,6 @@ module Temporalio
 
       # Construct a standalone activity reference.
       #
-      # WARNING: Standalone Activities are experimental.
-      #
       # @param activity_id [String] ID for the activity.
       # @param activity_run_id [String, nil] Run ID for the activity execution. nil targets the latest run.
       # @return [ActivityIDReference] A reference suitable for {Client#async_activity_handle}.
@@ -57,8 +55,6 @@ module Temporalio
       end
 
       # @return [Boolean] True if this reference is the standalone-form (activity_run_id without workflow_id).
-      #
-      # WARNING: Standalone Activities are experimental.
       def standalone?
         @workflow_id.nil?
       end

data/lib/temporalio/client/interceptor.rb

@@ -260,8 +260,6 @@ module Temporalio
       )
 
       # Input for {Outbound.start_activity}.
-      #
-      # WARNING: Standalone Activities are experimental.
       StartActivityInput = Data.define(
         :activity,
         :args,
@@ -275,7 +273,7 @@ module Temporalio
         :id_conflict_policy,
         :retry_policy,
         :search_attributes,
-        :static_summary,
+        :summary,
         :static_details,
         :headers,
         :priority,
@@ -286,8 +284,6 @@ module Temporalio
       )
 
       # Input for {Outbound.describe_activity}.
-      #
-      # WARNING: Standalone Activities are experimental.
       DescribeActivityInput = Data.define(
         :activity_id,
         :activity_run_id,
@@ -299,8 +295,6 @@ module Temporalio
       )
 
       # Input for {Outbound.cancel_activity}.
-      #
-      # WARNING: Standalone Activities are experimental.
       CancelActivityInput = Data.define(
         :activity_id,
         :activity_run_id,
@@ -309,8 +303,6 @@ module Temporalio
       )
 
       # Input for {Outbound.terminate_activity}.
-      #
-      # WARNING: Standalone Activities are experimental.
       TerminateActivityInput = Data.define(
         :activity_id,
         :activity_run_id,
@@ -352,16 +344,12 @@ module Temporalio
       )
 
       # Input for {Outbound.list_activities}.
-      #
-      # WARNING: Standalone Activities are experimental.
       ListActivitiesInput = Data.define(
         :query,
         :rpc_options
       )
 
       # Input for {Outbound.count_activities}.
-      #
-      # WARNING: Standalone Activities are experimental.
       CountActivitiesInput = Data.define(
         :query,
         :rpc_options
@@ -369,8 +357,6 @@ module Temporalio
 
       # Input for {Outbound.fetch_activity_outcome}. Used by `ActivityHandle#result` for long-polling
       # the activity outcome via `PollActivityExecution`.
-      #
-      # WARNING: Standalone Activities are experimental.
       FetchActivityOutcomeInput = Data.define(
         :activity_id,
         :activity_run_id,
@@ -588,8 +574,6 @@ module Temporalio
 
         # Called for every {Client.start_activity} and {Client.execute_activity} call.
         #
-        # WARNING: Standalone Activities are experimental.
-        #
         # @param input [StartActivityInput] Input.
         # @return [ActivityHandle] Activity handle.
         def start_activity(input)
@@ -598,8 +582,6 @@ module Temporalio
 
         # Called for every {ActivityHandle.describe} call.
         #
-        # WARNING: Standalone Activities are experimental.
-        #
         # @param input [DescribeActivityInput] Input.
         # @return [ActivityExecution::Description] Activity description.
         def describe_activity(input)
@@ -608,8 +590,6 @@ module Temporalio
 
         # Called for every {ActivityHandle.cancel} call.
         #
-        # WARNING: Standalone Activities are experimental.
-        #
         # @param input [CancelActivityInput] Input.
         def cancel_activity(input)
           next_interceptor.cancel_activity(input)
@@ -617,8 +597,6 @@ module Temporalio
 
         # Called for every {ActivityHandle.terminate} call.
         #
-        # WARNING: Standalone Activities are experimental.
-        #
         # @param input [TerminateActivityInput] Input.
         def terminate_activity(input)
           next_interceptor.terminate_activity(input)
@@ -654,8 +632,6 @@ module Temporalio
 
         # Called for every {Client.list_activities} call.
         #
-        # WARNING: Standalone Activities are experimental.
-        #
         # @param input [ListActivitiesInput] Input.
         # @return [Enumerator<ActivityExecution>] Activity executions.
         def list_activities(input)
@@ -664,8 +640,6 @@ module Temporalio
 
         # Called for every {Client.count_activities} call.
         #
-        # WARNING: Standalone Activities are experimental.
-        #
         # @param input [CountActivitiesInput] Input.
         # @return [ActivityExecutionCount] Activity count.
         def count_activities(input)
@@ -674,8 +648,6 @@ module Temporalio
 
         # Called by {ActivityHandle.result} to long-poll the activity outcome.
         #
-        # WARNING: Standalone Activities are experimental.
-        #
         # @param input [FetchActivityOutcomeInput] Input.
         # @return [Api::Activity::V1::ActivityExecutionOutcome] Activity outcome.
         def fetch_activity_outcome(input)

data/lib/temporalio/client/pending_activity_state.rb

@@ -5,8 +5,6 @@ require 'temporalio/api'
 module Temporalio
   class Client
     # More detailed breakdown of a running activity's state.
-    #
-    # WARNING: Standalone Activities are experimental.
     module PendingActivityState
       SCHEDULED = Api::Enums::V1::PendingActivityState::PENDING_ACTIVITY_STATE_SCHEDULED
       STARTED = Api::Enums::V1::PendingActivityState::PENDING_ACTIVITY_STATE_STARTED

data/lib/temporalio/client.rb

@@ -485,8 +485,6 @@ module Temporalio
     # Get a handle for an existing standalone activity. Useful when the activity was started elsewhere
     # (a different process, or by another client) and you have only its ID.
     #
-    # WARNING: Standalone Activities are experimental.
-    #
     # @param activity_id [String] ID for the activity.
     # @param activity_run_id [String, nil] Run ID for the activity execution. If nil, operations target the
     #   latest run of the given activity ID.
@@ -500,8 +498,6 @@ module Temporalio
 
     # Start a standalone activity execution and return its handle.
     #
-    # WARNING: Standalone Activities are experimental.
-    #
     # @param activity [Class<Activity::Definition>, Activity::Definition, Activity::Definition::Info, Symbol, String]
     #   Activity definition, definition class or activity name.
     # @param args [Array<Object>] Arguments to the activity.
@@ -519,7 +515,7 @@ module Temporalio
     #   is currently running. Defaults to `FAIL` (reject the start attempt).
     # @param retry_policy [RetryPolicy, nil] Retry policy for the activity.
     # @param search_attributes [SearchAttributes, nil] Search attributes for the activity.
-    # @param static_summary [String, nil] Fixed single-line summary for this activity execution.
+    # @param summary [String, nil] Fixed single-line summary for this activity execution.
     # @param static_details [String, nil] Fixed details for this activity execution. May be in markdown format.
     # @param priority [Priority] Priority for the activity. This is currently experimental.
     # @param start_delay [Float, nil] Time (in seconds) to wait before dispatching the first activity task. This delay
@@ -545,7 +541,7 @@ module Temporalio
       id_conflict_policy: ActivityIDConflictPolicy::FAIL,
       retry_policy: nil,
       search_attributes: nil,
-      static_summary: nil,
+      summary: nil,
       static_details: nil,
       priority: Priority.default,
       start_delay: nil,
@@ -568,7 +564,7 @@ module Temporalio
                              id_conflict_policy:,
                              retry_policy:,
                              search_attributes:,
-                             static_summary:,
+                             summary:,
                              static_details:,
                              headers: {},
                              priority:,
@@ -582,8 +578,6 @@ module Temporalio
     # Start a standalone activity execution and wait for its result. Shortcut for
     # {start_activity} + {ActivityHandle#result}.
     #
-    # WARNING: Standalone Activities are experimental.
-    #
     # @param activity [Class<Activity::Definition>, Activity::Definition, Activity::Definition::Info, Symbol, String]
     #   Activity definition, definition class or activity name.
     # @param args [Array<Object>] Arguments to the activity.
@@ -601,7 +595,7 @@ module Temporalio
     #   is currently running. Defaults to `FAIL` (reject the start attempt).
     # @param retry_policy [RetryPolicy, nil] Retry policy for the activity.
     # @param search_attributes [SearchAttributes, nil] Search attributes for the activity.
-    # @param static_summary [String, nil] Fixed single-line summary for this activity execution.
+    # @param summary [String, nil] Fixed single-line summary for this activity execution.
     # @param static_details [String, nil] Fixed details for this activity execution. May be in markdown format.
     # @param priority [Priority] Priority for the activity. This is currently experimental.
     # @param start_delay [Float, nil] Time (in seconds) to wait before dispatching the first activity task. This delay
@@ -628,7 +622,7 @@ module Temporalio
       id_conflict_policy: ActivityIDConflictPolicy::FAIL,
       retry_policy: nil,
       search_attributes: nil,
-      static_summary: nil,
+      summary: nil,
       static_details: nil,
       priority: Priority.default,
       start_delay: nil,
@@ -649,7 +643,7 @@ module Temporalio
         id_conflict_policy:,
         retry_policy:,
         search_attributes:,
-        static_summary:,
+        summary:,
         static_details:,
         priority:,
         start_delay:,
@@ -661,8 +655,6 @@ module Temporalio
 
     # List standalone activities matching a visibility query.
     #
-    # WARNING: Standalone Activities are experimental.
-    #
     # @param query [String] Visibility list filter.
     # @param rpc_options [RPCOptions, nil] Advanced RPC options.
     #
@@ -674,8 +666,6 @@ module Temporalio
 
     # Count standalone activities matching a visibility query.
     #
-    # WARNING: Standalone Activities are experimental.
-    #
     # @param query [String] Visibility list filter.
     # @param rpc_options [RPCOptions, nil] Advanced RPC options.
     #

data/lib/temporalio/common_enums.rb

@@ -86,8 +86,6 @@ module Temporalio
 
   # Controls behavior when an activity with the same ID was previously run and is now closed.
   #
-  # WARNING: Standalone Activities are experimental.
-  #
   # @see https://docs.temporal.io/activities
   module ActivityIDReusePolicy
     # Always allow starting an activity using the same activity ID.
@@ -102,8 +100,6 @@ module Temporalio
 
   # Controls behavior when an activity with the same ID is currently running.
   #
-  # WARNING: Standalone Activities are experimental.
-  #
   # @see https://docs.temporal.io/activities
   module ActivityIDConflictPolicy
     # Don't start a new activity; instead fail with already-started error.

data/lib/temporalio/error/failure.rb

@@ -30,8 +30,6 @@ module Temporalio
     end
 
     # Error raised by a client when a standalone activity execution has already started.
-    #
-    # WARNING: Standalone Activities are experimental.
     class ActivityAlreadyStartedError < Failure
       # @return [String] ID of the already-started activity.
       attr_reader :activity_id

data/lib/temporalio/error.rb

@@ -42,8 +42,6 @@ module Temporalio
 
     # Error returned from {Client::ActivityHandle#result} when the activity did not complete successfully.
     # The specific activity failure can be accessed via `cause`.
-    #
-    # WARNING: Standalone Activities are experimental.
     class ActivityFailedError < Error
       # @!visibility private
       def initialize(message = 'Activity execution failed')

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

@@ -984,7 +984,7 @@ module Temporalio
             retry_policy: input.retry_policy&._to_proto,
             search_attributes: input.search_attributes&._to_proto,
             user_metadata: ProtoUtils.to_user_metadata(
-              input.static_summary, input.static_details, @client.data_converter
+              input.summary, input.static_details, @client.data_converter
             ),
             header: ProtoUtils.headers_to_proto(input.headers, @client.data_converter),
             priority: input.priority._to_proto,
@@ -1098,6 +1098,11 @@ module Temporalio
         end
 
         def update_activity_options(input)
+          # The handle rejects a repeated option, but an interceptor could still add one.
+          paths = input.update_mask&.paths || []
+          dupe = paths.tally.find { |_, count| count > 1 }&.first
+          raise ArgumentError, "More than one update given for option #{dupe}" if dupe
+
           resp = @client.workflow_service.update_activity_execution_options(
             Api::WorkflowService::V1::UpdateActivityExecutionOptionsRequest.new(
               namespace: @client.namespace,

data/lib/temporalio/version.rb

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

data/rbi/temporalio/client/activity_execution.rbi

@@ -149,7 +149,7 @@ class Temporalio::Client::ActivityExecution::Description < ::Temporalio::Client:
   def canceled_reason; end
 
   sig { returns(T.nilable(String)) }
-  def static_summary; end
+  def summary; end
 
   sig { returns(T.nilable(String)) }
   def static_details; end

data/rbi/temporalio/client/interceptor.rbi

@@ -792,7 +792,7 @@ class Temporalio::Client::Interceptor::StartActivityInput < ::Data
   def search_attributes; end
 
   sig { returns(T.nilable(String)) }
-  def static_summary; end
+  def summary; end
 
   sig { returns(T.nilable(String)) }
   def static_details; end

data/rbi/temporalio/client.rbi

@@ -179,7 +179,7 @@ class Temporalio::Client
       id_conflict_policy: Integer,
       retry_policy: T.nilable(Temporalio::RetryPolicy),
       search_attributes: T.nilable(Temporalio::SearchAttributes),
-      static_summary: T.nilable(String),
+      summary: T.nilable(String),
       static_details: T.nilable(String),
       priority: Temporalio::Priority,
       start_delay: T.nilable(T.any(Integer, Float)),
@@ -201,7 +201,7 @@ class Temporalio::Client
     id_conflict_policy: T.unsafe(nil),
     retry_policy: T.unsafe(nil),
     search_attributes: T.unsafe(nil),
-    static_summary: T.unsafe(nil),
+    summary: T.unsafe(nil),
     static_details: T.unsafe(nil),
     priority: T.unsafe(nil),
     start_delay: T.unsafe(nil),
@@ -225,7 +225,7 @@ class Temporalio::Client
       id_conflict_policy: Integer,
       retry_policy: T.nilable(Temporalio::RetryPolicy),
       search_attributes: T.nilable(Temporalio::SearchAttributes),
-      static_summary: T.nilable(String),
+      summary: T.nilable(String),
       static_details: T.nilable(String),
       priority: Temporalio::Priority,
       start_delay: T.nilable(T.any(Integer, Float)),
@@ -247,7 +247,7 @@ class Temporalio::Client
     id_conflict_policy: T.unsafe(nil),
     retry_policy: T.unsafe(nil),
     search_attributes: T.unsafe(nil),
-    static_summary: T.unsafe(nil),
+    summary: T.unsafe(nil),
     static_details: T.unsafe(nil),
     priority: T.unsafe(nil),
     start_delay: T.unsafe(nil),

data/sig/temporalio/client/activity_execution.rbs

@@ -50,7 +50,7 @@ module Temporalio
         def last_deployment_version: -> WorkerDeploymentVersion?
         def priority: -> Priority
         def canceled_reason: -> String?
-        def static_summary: -> String?
+        def summary: -> String?
         def static_details: -> String?
 
         private def user_metadata: -> [String?, String?]

data/sig/temporalio/client/interceptor.rbs

@@ -445,7 +445,7 @@ module Temporalio
         attr_reader id_conflict_policy: ActivityIDConflictPolicy::enum
         attr_reader retry_policy: RetryPolicy?
         attr_reader search_attributes: SearchAttributes?
-        attr_reader static_summary: String?
+        attr_reader summary: String?
         attr_reader static_details: String?
         attr_reader headers: Hash[String, Object?]
         attr_reader priority: Priority
@@ -467,7 +467,7 @@ module Temporalio
           id_conflict_policy: ActivityIDConflictPolicy::enum,
           retry_policy: RetryPolicy?,
           search_attributes: SearchAttributes?,
-          static_summary: String?,
+          summary: String?,
           static_details: String?,
           headers: Hash[String, Object?],
           priority: Priority,

data/sig/temporalio/client.rbs

@@ -152,7 +152,7 @@ module Temporalio
       ?id_conflict_policy: ActivityIDConflictPolicy::enum,
       ?retry_policy: RetryPolicy?,
       ?search_attributes: SearchAttributes?,
-      ?static_summary: String?,
+      ?summary: String?,
       ?static_details: String?,
       ?priority: Priority,
       ?start_delay: duration?,
@@ -174,7 +174,7 @@ module Temporalio
       ?id_conflict_policy: ActivityIDConflictPolicy::enum,
       ?retry_policy: RetryPolicy?,
       ?search_attributes: SearchAttributes?,
-      ?static_summary: String?,
+      ?summary: String?,
       ?static_details: String?,
       ?priority: Priority,
       ?start_delay: duration?,

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: temporalio
 version: !ruby/object:Gem::Version
-  version: 1.8.0
+  version: 1.9.0
 platform: ruby
 authors:
 - Temporal Technologies Inc