Skip to content

Add support for more timeouts to Nexus operations #1276

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
Quinn-With-Two-Ns wants to merge 4 commits into
base: main
Choose a base branch
from
Draft

Add support for more timeouts to Nexus operations #1276

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
c333bc7
Add support for more timeouts to Nexus operations
Quinn-With-Two-Ns Jan 14, 2026
eb22efc
fix format
Quinn-With-Two-Ns Jan 14, 2026
039ffb0
regen proto
Quinn-With-Two-Ns Jan 14, 2026
0b541a2
fic workflow ABC
Quinn-With-Two-Ns Jan 14, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 8 additions & 8 deletions temporalio/api/command/v1/message_pb2.py
View file
Open in desktop

Large diffs are not rendered by default.

40 changes: 39 additions & 1 deletion temporalio/api/command/v1/message_pb2.pyi
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -944,6 +944,8 @@ class ScheduleNexusOperationCommandAttributes(google.protobuf.message.Message):
INPUT_FIELD_NUMBER: builtins.int
SCHEDULE_TO_CLOSE_TIMEOUT_FIELD_NUMBER: builtins.int
NEXUS_HEADER_FIELD_NUMBER: builtins.int
SCHEDULE_TO_START_TIMEOUT_FIELD_NUMBER: builtins.int
START_TO_CLOSE_TIMEOUT_FIELD_NUMBER: builtins.int
endpoint: builtins.str
"""Endpoint name, must exist in the endpoint registry or this command will fail."""
service: builtins.str
Expand Down Expand Up @@ -975,6 +977,29 @@ class ScheduleNexusOperationCommandAttributes(google.protobuf.message.Message):
Note these headers are not the same as Temporal headers on internal activities and child workflows, these are
transmitted to Nexus operations that may be external and are not traditional payloads.
"""
@property
def schedule_to_start_timeout(self) -> google.protobuf.duration_pb2.Duration:
"""Schedule-to-start timeout for this operation.
Indicates how long the caller is willing to wait for the operation to be started (or completed if synchronous)
by the handler. If the operation is not started within this timeout, it will fail with
TIMEOUT_TYPE_SCHEDULE_TO_START.
If not set or zero, no schedule-to-start timeout is enforced.
(-- api-linter: core::0140::prepositions=disabled
aip.dev/not-precedent: "to" is used to indicate interval. --)
Requires server version 1.31.0 or later.
"""
@property
def start_to_close_timeout(self) -> google.protobuf.duration_pb2.Duration:
"""Start-to-close timeout for this operation.
Indicates how long the caller is willing to wait for an asynchronous operation to complete after it has been
started. If the operation does not complete within this timeout after starting, it will fail with
TIMEOUT_TYPE_START_TO_CLOSE.
Only applies to asynchronous operations. Synchronous operations ignore this timeout.
If not set or zero, no start-to-close timeout is enforced.
(-- api-linter: core::0140::prepositions=disabled
aip.dev/not-precedent: "to" is used to indicate interval. --)
Requires server version 1.31.0 or later.
"""
def __init__(
self,
*,
Expand All @@ -984,11 +1009,20 @@ class ScheduleNexusOperationCommandAttributes(google.protobuf.message.Message):
input: temporalio.api.common.v1.message_pb2.Payload | None = ...,
schedule_to_close_timeout: google.protobuf.duration_pb2.Duration | None = ...,
nexus_header: collections.abc.Mapping[builtins.str, builtins.str] | None = ...,
schedule_to_start_timeout: google.protobuf.duration_pb2.Duration | None = ...,
start_to_close_timeout: google.protobuf.duration_pb2.Duration | None = ...,
) -> None: ...
def HasField(
self,
field_name: typing_extensions.Literal[
"input", b"input", "schedule_to_close_timeout", b"schedule_to_close_timeout"
"input",
b"input",
"schedule_to_close_timeout",
b"schedule_to_close_timeout",
"schedule_to_start_timeout",
b"schedule_to_start_timeout",
"start_to_close_timeout",
b"start_to_close_timeout",
],
) -> builtins.bool: ...
def ClearField(
Expand All @@ -1004,8 +1038,12 @@ class ScheduleNexusOperationCommandAttributes(google.protobuf.message.Message):
b"operation",
"schedule_to_close_timeout",
b"schedule_to_close_timeout",
"schedule_to_start_timeout",
b"schedule_to_start_timeout",
"service",
b"service",
"start_to_close_timeout",
b"start_to_close_timeout",
],
) -> None: ...

Expand Down
48 changes: 24 additions & 24 deletions temporalio/api/history/v1/message_pb2.py
View file
Open in desktop

Large diffs are not rendered by default.

31 changes: 30 additions & 1 deletion temporalio/api/history/v1/message_pb2.pyi
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3650,6 +3650,8 @@ class NexusOperationScheduledEventAttributes(google.protobuf.message.Message):
WORKFLOW_TASK_COMPLETED_EVENT_ID_FIELD_NUMBER: builtins.int
REQUEST_ID_FIELD_NUMBER: builtins.int
ENDPOINT_ID_FIELD_NUMBER: builtins.int
SCHEDULE_TO_START_TIMEOUT_FIELD_NUMBER: builtins.int
START_TO_CLOSE_TIMEOUT_FIELD_NUMBER: builtins.int
endpoint: builtins.str
"""Endpoint name, must exist in the endpoint registry."""
service: builtins.str
Expand Down Expand Up @@ -3689,6 +3691,20 @@ class NexusOperationScheduledEventAttributes(google.protobuf.message.Message):
This is stored on the event and used internally by the server in case the endpoint is renamed from the time the
event was originally scheduled.
"""
@property
def schedule_to_start_timeout(self) -> google.protobuf.duration_pb2.Duration:
"""Schedule-to-start timeout for this operation.
See ScheduleNexusOperationCommandAttributes.schedule_to_start_timeout for details.
(-- api-linter: core::0140::prepositions=disabled
aip.dev/not-precedent: "to" is used to indicate interval. --)
"""
@property
def start_to_close_timeout(self) -> google.protobuf.duration_pb2.Duration:
"""Start-to-close timeout for this operation.
See ScheduleNexusOperationCommandAttributes.start_to_close_timeout for details.
(-- api-linter: core::0140::prepositions=disabled
aip.dev/not-precedent: "to" is used to indicate interval. --)
"""
def __init__(
self,
*,
Expand All @@ -3701,11 +3717,20 @@ class NexusOperationScheduledEventAttributes(google.protobuf.message.Message):
workflow_task_completed_event_id: builtins.int = ...,
request_id: builtins.str = ...,
endpoint_id: builtins.str = ...,
schedule_to_start_timeout: google.protobuf.duration_pb2.Duration | None = ...,
start_to_close_timeout: google.protobuf.duration_pb2.Duration | None = ...,
) -> None: ...
def HasField(
self,
field_name: typing_extensions.Literal[
"input", b"input", "schedule_to_close_timeout", b"schedule_to_close_timeout"
"input",
b"input",
"schedule_to_close_timeout",
b"schedule_to_close_timeout",
"schedule_to_start_timeout",
b"schedule_to_start_timeout",
"start_to_close_timeout",
b"start_to_close_timeout",
],
) -> builtins.bool: ...
def ClearField(
Expand All @@ -3725,8 +3750,12 @@ class NexusOperationScheduledEventAttributes(google.protobuf.message.Message):
b"request_id",
"schedule_to_close_timeout",
b"schedule_to_close_timeout",
"schedule_to_start_timeout",
b"schedule_to_start_timeout",
"service",
b"service",
"start_to_close_timeout",
b"start_to_close_timeout",
"workflow_task_completed_event_id",
b"workflow_task_completed_event_id",
],
Expand Down
Loading