temporalio 1.8.0 → 1.10.0

data/rbi/temporalio/internal/bridge/api/workflow_activation/workflow_activation.rbi

@@ -704,7 +704,8 @@ class Temporalio::Internal::Bridge::Api::WorkflowActivation::InitializeWorkflow
       search_attributes: T.nilable(Temporalio::Api::Common::V1::SearchAttributes),
       start_time: T.nilable(Google::Protobuf::Timestamp),
       root_workflow: T.nilable(Temporalio::Api::Common::V1::WorkflowExecution),
-      priority: T.nilable(Temporalio::Api::Common::V1::Priority)
+      priority: T.nilable(Temporalio::Api::Common::V1::Priority),
+      original_execution_run_id: T.nilable(String)
     ).void
   end
   def initialize(
@@ -732,7 +733,8 @@ class Temporalio::Internal::Bridge::Api::WorkflowActivation::InitializeWorkflow
     search_attributes: nil,
     start_time: nil,
     root_workflow: nil,
-    priority: nil
+    priority: nil,
+    original_execution_run_id: ""
   )
   end
 
@@ -1150,6 +1152,27 @@ class Temporalio::Internal::Bridge::Api::WorkflowActivation::InitializeWorkflow
   def clear_priority
   end
 
+  # The run id recorded on the `WORKFLOW_EXECUTION_STARTED` event. Unlike the execution's current
+# run id, this value is preserved across workflow resets. Mirrors the `original_execution_run_id`
+# field from `WorkflowExecutionStartedEventAttributes`.
+  sig { returns(String) }
+  def original_execution_run_id
+  end
+
+  # The run id recorded on the `WORKFLOW_EXECUTION_STARTED` event. Unlike the execution's current
+# run id, this value is preserved across workflow resets. Mirrors the `original_execution_run_id`
+# field from `WorkflowExecutionStartedEventAttributes`.
+  sig { params(value: String).void }
+  def original_execution_run_id=(value)
+  end
+
+  # The run id recorded on the `WORKFLOW_EXECUTION_STARTED` event. Unlike the execution's current
+# run id, this value is preserved across workflow resets. Mirrors the `original_execution_run_id`
+# field from `WorkflowExecutionStartedEventAttributes`.
+  sig { void }
+  def clear_original_execution_run_id
+  end
+
   sig { params(field: String).returns(T.untyped) }
   def [](field)
   end
@@ -1995,14 +2018,16 @@ class Temporalio::Internal::Bridge::Api::WorkflowActivation::SignalWorkflow
       signal_name: T.nilable(String),
       input: T.nilable(T::Array[T.nilable(Temporalio::Api::Common::V1::Payload)]),
       identity: T.nilable(String),
-      headers: T.nilable(T::Hash[String, T.nilable(Temporalio::Api::Common::V1::Payload)])
+      headers: T.nilable(T::Hash[String, T.nilable(Temporalio::Api::Common::V1::Payload)]),
+      originating_event_id: T.nilable(Integer)
     ).void
   end
   def initialize(
     signal_name: "",
     input: [],
     identity: "",
-    headers: ::Google::Protobuf::Map.new(:string, :message, Temporalio::Api::Common::V1::Payload)
+    headers: ::Google::Protobuf::Map.new(:string, :message, Temporalio::Api::Common::V1::Payload),
+    originating_event_id: 0
   )
   end
 
@@ -2060,6 +2085,21 @@ class Temporalio::Internal::Bridge::Api::WorkflowActivation::SignalWorkflow
   def clear_headers
   end
 
+  # Event ID of the `WORKFLOW_EXECUTION_SIGNALED` history event that produced this job.
+  sig { returns(Integer) }
+  def originating_event_id
+  end
+
+  # Event ID of the `WORKFLOW_EXECUTION_SIGNALED` history event that produced this job.
+  sig { params(value: Integer).void }
+  def originating_event_id=(value)
+  end
+
+  # Event ID of the `WORKFLOW_EXECUTION_SIGNALED` history event that produced this job.
+  sig { void }
+  def clear_originating_event_id
+  end
+
   sig { params(field: String).returns(T.untyped) }
   def [](field)
   end
@@ -2161,12 +2201,14 @@ class Temporalio::Internal::Bridge::Api::WorkflowActivation::ResolveSignalExtern
   sig do
     params(
       seq: T.nilable(Integer),
-      failure: T.nilable(Temporalio::Api::Failure::V1::Failure)
+      failure: T.nilable(Temporalio::Api::Failure::V1::Failure),
+      cause: T.nilable(T.any(Symbol, String, Integer))
     ).void
   end
   def initialize(
     seq: 0,
-    failure: nil
+    failure: nil,
+    cause: :SIGNAL_EXTERNAL_WORKFLOW_EXECUTION_FAILED_CAUSE_UNSPECIFIED
   )
   end
 
@@ -2206,6 +2248,24 @@ class Temporalio::Internal::Bridge::Api::WorkflowActivation::ResolveSignalExtern
   def clear_failure
   end
 
+  # The server-reported cause when the signal failed. Unspecified when the signal succeeded or
+# was cancelled before being sent.
+  sig { returns(T.any(Symbol, Integer)) }
+  def cause
+  end
+
+  # The server-reported cause when the signal failed. Unspecified when the signal succeeded or
+# was cancelled before being sent.
+  sig { params(value: T.any(Symbol, String, Integer)).void }
+  def cause=(value)
+  end
+
+  # The server-reported cause when the signal failed. Unspecified when the signal succeeded or
+# was cancelled before being sent.
+  sig { void }
+  def clear_cause
+  end
+
   sig { params(field: String).returns(T.untyped) }
   def [](field)
   end
@@ -2246,12 +2306,14 @@ class Temporalio::Internal::Bridge::Api::WorkflowActivation::ResolveRequestCance
   sig do
     params(
       seq: T.nilable(Integer),
-      failure: T.nilable(Temporalio::Api::Failure::V1::Failure)
+      failure: T.nilable(Temporalio::Api::Failure::V1::Failure),
+      cause: T.nilable(T.any(Symbol, String, Integer))
     ).void
   end
   def initialize(
     seq: 0,
-    failure: nil
+    failure: nil,
+    cause: :CANCEL_EXTERNAL_WORKFLOW_EXECUTION_FAILED_CAUSE_UNSPECIFIED
   )
   end
 
@@ -2273,24 +2335,36 @@ class Temporalio::Internal::Bridge::Api::WorkflowActivation::ResolveRequestCance
   def clear_seq
   end
 
-  # If populated, this signal either failed to be sent or was cancelled depending on failure
-# type / info.
+  # If populated, the cancellation request failed.
   sig { returns(T.nilable(Temporalio::Api::Failure::V1::Failure)) }
   def failure
   end
 
-  # If populated, this signal either failed to be sent or was cancelled depending on failure
-# type / info.
+  # If populated, the cancellation request failed.
   sig { params(value: T.nilable(Temporalio::Api::Failure::V1::Failure)).void }
   def failure=(value)
   end
 
-  # If populated, this signal either failed to be sent or was cancelled depending on failure
-# type / info.
+  # If populated, the cancellation request failed.
   sig { void }
   def clear_failure
   end
 
+  # The server-reported cause when the cancellation request failed.
+  sig { returns(T.any(Symbol, Integer)) }
+  def cause
+  end
+
+  # The server-reported cause when the cancellation request failed.
+  sig { params(value: T.any(Symbol, String, Integer)).void }
+  def cause=(value)
+  end
+
+  # The server-reported cause when the cancellation request failed.
+  sig { void }
+  def clear_cause
+  end
+
   sig { params(field: String).returns(T.untyped) }
   def [](field)
   end

data/rbi/temporalio/internal/bridge/api/workflow_commands/workflow_commands.rbi

@@ -9,6 +9,7 @@ class Temporalio::Internal::Bridge::Api::WorkflowCommands::WorkflowCommand
   sig do
     params(
       user_metadata: T.nilable(Temporalio::Api::Sdk::V1::UserMetadata),
+      event_group_markers: T.nilable(T::Array[T.nilable(Temporalio::Api::Sdk::V1::EventGroupMarker)]),
       start_timer: T.nilable(Temporalio::Internal::Bridge::Api::WorkflowCommands::StartTimer),
       schedule_activity: T.nilable(Temporalio::Internal::Bridge::Api::WorkflowCommands::ScheduleActivity),
       respond_to_query: T.nilable(Temporalio::Internal::Bridge::Api::WorkflowCommands::QueryResult),
@@ -35,6 +36,7 @@ class Temporalio::Internal::Bridge::Api::WorkflowCommands::WorkflowCommand
   end
   def initialize(
     user_metadata: nil,
+    event_group_markers: [],
     start_timer: nil,
     schedule_activity: nil,
     respond_to_query: nil,
@@ -81,6 +83,27 @@ class Temporalio::Internal::Bridge::Api::WorkflowCommands::WorkflowCommand
   def clear_user_metadata
   end
 
+  # Event group markers attached to the command. These are forwarded onto
+# the corresponding server-side Command, and consequently surfaced on the
+# resulting HistoryEvent. See `temporal/api/sdk/v1/event_group_marker.proto`.
+  sig { returns(T::Array[T.nilable(Temporalio::Api::Sdk::V1::EventGroupMarker)]) }
+  def event_group_markers
+  end
+
+  # Event group markers attached to the command. These are forwarded onto
+# the corresponding server-side Command, and consequently surfaced on the
+# resulting HistoryEvent. See `temporal/api/sdk/v1/event_group_marker.proto`.
+  sig { params(value: ::Google::Protobuf::RepeatedField).void }
+  def event_group_markers=(value)
+  end
+
+  # Event group markers attached to the command. These are forwarded onto
+# the corresponding server-side Command, and consequently surfaced on the
+# resulting HistoryEvent. See `temporal/api/sdk/v1/event_group_marker.proto`.
+  sig { void }
+  def clear_event_group_markers
+  end
+
   sig { returns(T.nilable(Temporalio::Internal::Bridge::Api::WorkflowCommands::StartTimer)) }
   def start_timer
   end
@@ -856,7 +879,8 @@ class Temporalio::Internal::Bridge::Api::WorkflowCommands::ScheduleLocalActivity
       start_to_close_timeout: T.nilable(Google::Protobuf::Duration),
       retry_policy: T.nilable(Temporalio::Api::Common::V1::RetryPolicy),
       local_retry_threshold: T.nilable(Google::Protobuf::Duration),
-      cancellation_type: T.nilable(T.any(Symbol, String, Integer))
+      cancellation_type: T.nilable(T.any(Symbol, String, Integer)),
+      include_arguments_in_marker: T.nilable(T::Boolean)
     ).void
   end
   def initialize(
@@ -872,7 +896,8 @@ class Temporalio::Internal::Bridge::Api::WorkflowCommands::ScheduleLocalActivity
     start_to_close_timeout: nil,
     retry_policy: nil,
     local_retry_threshold: nil,
-    cancellation_type: :TRY_CANCEL
+    cancellation_type: :TRY_CANCEL,
+    include_arguments_in_marker: false
   )
   end
 
@@ -1113,6 +1138,27 @@ class Temporalio::Internal::Bridge::Api::WorkflowCommands::ScheduleLocalActivity
   def clear_cancellation_type
   end
 
+  # If set, the local activity arguments will be included in the resulting marker under the
+# `input` key. This is disabled by default to avoid increasing history size unless the lang
+# SDK explicitly chooses to expose it.
+  sig { returns(T::Boolean) }
+  def include_arguments_in_marker
+  end
+
+  # If set, the local activity arguments will be included in the resulting marker under the
+# `input` key. This is disabled by default to avoid increasing history size unless the lang
+# SDK explicitly chooses to expose it.
+  sig { params(value: T::Boolean).void }
+  def include_arguments_in_marker=(value)
+  end
+
+  # If set, the local activity arguments will be included in the resulting marker under the
+# `input` key. This is disabled by default to avoid increasing history size unless the lang
+# SDK explicitly chooses to expose it.
+  sig { void }
+  def clear_include_arguments_in_marker
+  end
+
   sig { params(field: String).returns(T.untyped) }
   def [](field)
   end
@@ -1817,8 +1863,27 @@ class Temporalio::Internal::Bridge::Api::WorkflowCommands::CancelWorkflowExecuti
   include ::Google::Protobuf::MessageExts
   extend ::Google::Protobuf::MessageExts::ClassMethods
 
-  sig {void}
-  def initialize; end
+  sig do
+    params(
+      details: T.nilable(Temporalio::Api::Common::V1::Payloads)
+    ).void
+  end
+  def initialize(
+    details: nil
+  )
+  end
+
+  sig { returns(T.nilable(Temporalio::Api::Common::V1::Payloads)) }
+  def details
+  end
+
+  sig { params(value: T.nilable(Temporalio::Api::Common::V1::Payloads)).void }
+  def details=(value)
+  end
+
+  sig { void }
+  def clear_details
+  end
 
   sig { params(field: String).returns(T.untyped) }
   def [](field)
@@ -1967,7 +2032,8 @@ class Temporalio::Internal::Bridge::Api::WorkflowCommands::StartChildWorkflowExe
       search_attributes: T.nilable(Temporalio::Api::Common::V1::SearchAttributes),
       cancellation_type: T.nilable(T.any(Symbol, String, Integer)),
       versioning_intent: T.nilable(T.any(Symbol, String, Integer)),
-      priority: T.nilable(Temporalio::Api::Common::V1::Priority)
+      priority: T.nilable(Temporalio::Api::Common::V1::Priority),
+      versioning_override: T.nilable(Temporalio::Api::Workflow::V1::VersioningOverride)
     ).void
   end
   def initialize(
@@ -1989,7 +2055,8 @@ class Temporalio::Internal::Bridge::Api::WorkflowCommands::StartChildWorkflowExe
     search_attributes: nil,
     cancellation_type: :ABANDON,
     versioning_intent: :UNSPECIFIED,
-    priority: nil
+    priority: nil,
+    versioning_override: nil
   )
   end
 
@@ -2260,6 +2327,24 @@ class Temporalio::Internal::Bridge::Api::WorkflowCommands::StartChildWorkflowExe
   def clear_priority
   end
 
+  # Allows routing the child independently of the parent's worker deployment version.
+# Requires Temporal Server 1.32+.
+  sig { returns(T.nilable(Temporalio::Api::Workflow::V1::VersioningOverride)) }
+  def versioning_override
+  end
+
+  # Allows routing the child independently of the parent's worker deployment version.
+# Requires Temporal Server 1.32+.
+  sig { params(value: T.nilable(Temporalio::Api::Workflow::V1::VersioningOverride)).void }
+  def versioning_override=(value)
+  end
+
+  # Allows routing the child independently of the parent's worker deployment version.
+# Requires Temporal Server 1.32+.
+  sig { void }
+  def clear_versioning_override
+  end
+
   sig { params(field: String).returns(T.untyped) }
   def [](field)
   end

data/rbi/temporalio/internal/external_storage_references.rbi

@@ -0,0 +1,26 @@
+# typed: true
+
+module Temporalio::Internal::ExternalStorageReferences
+  extend T::Sig
+
+  ENCODING = T.let(T.unsafe(nil), String)
+  MESSAGE_TYPE = T.let(T.unsafe(nil), String)
+
+  sig { params(payload: Temporalio::Api::Common::V1::Payload).returns(T::Boolean) }
+  def self.reference?(payload); end
+
+  sig do
+    params(payload: Temporalio::Api::Common::V1::Payload)
+      .returns(T.nilable(Temporalio::Api::Sdk::V1::ExternalStorageReference))
+  end
+  def self.parse_reference(payload); end
+
+  sig do
+    params(
+      driver_name: String,
+      claim_data: T::Hash[String, String],
+      original_size_bytes: Integer
+    ).returns(Temporalio::Api::Common::V1::Payload)
+  end
+  def self.create_reference_payload(driver_name:, claim_data:, original_size_bytes:); end
+end

data/rbi/temporalio/internal/worker/workflow_instance/context.rbi

@@ -200,6 +200,7 @@ class Temporalio::Internal::Worker::WorkflowInstance::Context
       memo: T.nilable(T::Hash[T.any(String, Symbol), T.nilable(Object)]),
       search_attributes: T.nilable(Temporalio::SearchAttributes),
       priority: Temporalio::Priority,
+      versioning_override: T.nilable(Temporalio::VersioningOverride),
       arg_hints: T.nilable(T::Array[Object]),
       result_hint: T.nilable(Object)
     ).returns(Temporalio::Internal::Worker::WorkflowInstance::ChildWorkflowHandle)
@@ -223,6 +224,7 @@ class Temporalio::Internal::Worker::WorkflowInstance::Context
     memo:,
     search_attributes:,
     priority:,
+    versioning_override:,
     arg_hints:,
     result_hint:
   ); end

data/rbi/temporalio/versioning_override.rbi

@@ -11,3 +11,11 @@ class Temporalio::VersioningOverride::Pinned < ::Temporalio::VersioningOverride
 end
 
 class Temporalio::VersioningOverride::AutoUpgrade < ::Temporalio::VersioningOverride; end
+
+class Temporalio::VersioningOverride::OneTime < ::Temporalio::VersioningOverride
+  sig { params(target_version: Temporalio::WorkerDeploymentVersion).void }
+  def initialize(target_version); end
+
+  sig { returns(Temporalio::WorkerDeploymentVersion) }
+  attr_reader :target_version
+end

data/rbi/temporalio/worker/interceptor.rbi

@@ -398,6 +398,9 @@ class Temporalio::Worker::Interceptor::Workflow::StartChildWorkflowInput < ::Dat
   sig { returns(Temporalio::Priority) }
   def priority; end
 
+  sig { returns(T.nilable(Temporalio::VersioningOverride)) }
+  def versioning_override; end
+
   sig { returns(T.nilable(T::Array[Object])) }
   def arg_hints; end
 

data/rbi/temporalio/workflow.rbi

@@ -102,6 +102,7 @@ module Temporalio::Workflow
         memo: T.nilable(T::Hash[T.any(String, Symbol), T.nilable(Object)]),
         search_attributes: T.nilable(Temporalio::SearchAttributes),
         priority: Temporalio::Priority,
+        versioning_override: T.nilable(Temporalio::VersioningOverride),
         arg_hints: T.nilable(T::Array[Object]),
         result_hint: T.nilable(Object)
       ).returns(T.nilable(Object))
@@ -125,6 +126,7 @@ module Temporalio::Workflow
       memo: T.unsafe(nil),
       search_attributes: T.unsafe(nil),
       priority: T.unsafe(nil),
+      versioning_override: nil,
       arg_hints: T.unsafe(nil),
       result_hint: T.unsafe(nil)
     ); end
@@ -227,6 +229,7 @@ module Temporalio::Workflow
         memo: T.nilable(T::Hash[T.any(String, Symbol), T.nilable(Object)]),
         search_attributes: T.nilable(Temporalio::SearchAttributes),
         priority: Temporalio::Priority,
+        versioning_override: T.nilable(Temporalio::VersioningOverride),
         arg_hints: T.nilable(T::Array[Object]),
         result_hint: T.nilable(Object)
       ).returns(Temporalio::Workflow::ChildWorkflowHandle)
@@ -250,6 +253,7 @@ module Temporalio::Workflow
       memo: T.unsafe(nil),
       search_attributes: T.unsafe(nil),
       priority: T.unsafe(nil),
+      versioning_override: nil,
       arg_hints: T.unsafe(nil),
       result_hint: T.unsafe(nil)
     ); end

data/sig/temporalio/api/activity/v1/message.rbs

@@ -385,6 +385,16 @@ module Temporalio
           def has_execution_time?: () -> bool
           def clear_execution_time: () -> void
 
+          # Serialization context propagated from the Nexus caller that started this activity.
+          attr_accessor propagated_nexus_serialization_context(): ::Temporalio::Api::Nexus::V1::PropagatedSerializationContext?
+          def has_propagated_nexus_serialization_context?: () -> bool
+          def clear_propagated_nexus_serialization_context: () -> void
+
+          # Indicates whether eager execution was requested for this activity and accepted by the server
+          # for its first task.
+          attr_accessor eager_execution_accepted(): bool
+          def clear_eager_execution_accepted: () -> void
+
           type init_map = {
             activity_id: (::String | ::Symbol)?,
             "activity_id" => (::String | ::Symbol)?,
@@ -462,6 +472,10 @@ module Temporalio
             "start_delay" => (::Google::Protobuf::Duration | ::Google::Protobuf::Duration)?,
             execution_time: (::Google::Protobuf::Timestamp | ::Google::Protobuf::Timestamp)?,
             "execution_time" => (::Google::Protobuf::Timestamp | ::Google::Protobuf::Timestamp)?,
+            propagated_nexus_serialization_context: (::Temporalio::Api::Nexus::V1::PropagatedSerializationContext | ::Temporalio::Api::Nexus::V1::PropagatedSerializationContext::init_map)?,
+            "propagated_nexus_serialization_context" => (::Temporalio::Api::Nexus::V1::PropagatedSerializationContext | ::Temporalio::Api::Nexus::V1::PropagatedSerializationContext::init_map)?,
+            eager_execution_accepted: bool?,
+            "eager_execution_accepted" => bool?,
           }
 
           def initialize: (?init_map initial_value) -> void
@@ -505,6 +519,8 @@ module Temporalio
             | ("sdk_version" name) -> ::String
             | ("start_delay" name) -> ::Google::Protobuf::Duration?
             | ("execution_time" name) -> ::Google::Protobuf::Timestamp?
+            | ("propagated_nexus_serialization_context" name) -> ::Temporalio::Api::Nexus::V1::PropagatedSerializationContext?
+            | ("eager_execution_accepted" name) -> bool
 
           def []=:
               ("activity_id" name, (::String | ::Symbol) value) -> void
@@ -545,6 +561,8 @@ module Temporalio
             | ("sdk_version" name, (::String | ::Symbol) value) -> void
             | ("start_delay" name, ((::Google::Protobuf::Duration | ::int)?) value) -> void
             | ("execution_time" name, ((::Google::Protobuf::Timestamp | ::Time)?) value) -> void
+            | ("propagated_nexus_serialization_context" name, ::Temporalio::Api::Nexus::V1::PropagatedSerializationContext? value) -> void
+            | ("eager_execution_accepted" name, bool value) -> void
         end
 
         # Limited activity information returned in the list response.

data/sig/temporalio/api/callback/v1/message.rbs

@@ -57,6 +57,12 @@ module Temporalio
           attr_writer blocked_reason(): ::String | ::Symbol
           def clear_blocked_reason: () -> void
 
+          # Server-generated request ID used as an idempotency token when invoking callbacks.
+          # It has no relation to caller-side request_id sent in operations like StartNexusOperationExecutionRequest.
+          attr_reader request_id(): ::String
+          attr_writer request_id(): ::String | ::Symbol
+          def clear_request_id: () -> void
+
           type init_map = {
             callback: (::Temporalio::Api::Common::V1::Callback | ::Temporalio::Api::Common::V1::Callback::init_map)?,
             "callback" => (::Temporalio::Api::Common::V1::Callback | ::Temporalio::Api::Common::V1::Callback::init_map)?,
@@ -74,6 +80,8 @@ module Temporalio
             "next_attempt_schedule_time" => (::Google::Protobuf::Timestamp | ::Google::Protobuf::Timestamp)?,
             blocked_reason: (::String | ::Symbol)?,
             "blocked_reason" => (::String | ::Symbol)?,
+            request_id: (::String | ::Symbol)?,
+            "request_id" => (::String | ::Symbol)?,
           }
 
           def initialize: (?init_map initial_value) -> void
@@ -87,6 +95,7 @@ module Temporalio
             | ("last_attempt_failure" name) -> ::Temporalio::Api::Failure::V1::Failure?
             | ("next_attempt_schedule_time" name) -> ::Google::Protobuf::Timestamp?
             | ("blocked_reason" name) -> ::String
+            | ("request_id" name) -> ::String
 
           def []=:
               ("callback" name, ::Temporalio::Api::Common::V1::Callback? value) -> void
@@ -97,6 +106,7 @@ module Temporalio
             | ("last_attempt_failure" name, ::Temporalio::Api::Failure::V1::Failure? value) -> void
             | ("next_attempt_schedule_time" name, ((::Google::Protobuf::Timestamp | ::Time)?) value) -> void
             | ("blocked_reason" name, (::String | ::Symbol) value) -> void
+            | ("request_id" name, (::String | ::Symbol) value) -> void
         end
       end
     end