Skip to content

Commit 7d3bfb7

Browse files
committed
Simplify proto comments, reference YAML for service definition
1 parent 7456a50 commit 7d3bfb7

File tree

1 file changed

+3
-24
lines changed

1 file changed

+3
-24
lines changed

temporal/api/worker/v1/worker_nexus_service_commands.proto

Lines changed: 3 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -10,40 +10,19 @@ option ruby_package = "Temporalio::Api::Worker::V1";
1010
option csharp_namespace = "Temporalio.Api.Worker.V1";
1111

1212
// (--
13-
/////////////////////////////////////////////////////////////////////
14-
// This file contains:
15-
// - Conventions between server and worker.
16-
// - Definitions for commands and payloads for server-worker communication via Nexus
17-
//
18-
// COMMUNICATION PROTOCOL:
19-
// - Transport: Nexus tasks on task queue
20-
// - Service name: "temporal.api.worker.v1.WorkerService"
21-
// - Task queue: /temporal-sys/worker-commands/{namespace}/{worker_grouping_key}
22-
//
23-
// WORKER COMMANDS CONVENTIONS:
24-
//
25-
// - Worker commands are used to manage worker configurations, operations, etc.
26-
// - Command names should match names defined in the server API.
27-
// - Command names are provided in StartOperationRequest.Operation field.
28-
//
29-
// PAYLOAD CONVENTIONS:
30-
//
31-
// - In/out payloads namings follow the same convention as the regular API:
32-
// - CommandNameRequest (input payload)
33-
// - CommandNameResponse (output payload).
34-
// - Empty payload if response is not needed/not expected
13+
// Internal Nexus service for server-to-worker communication.
14+
// See worker_service.nexusrpc.yaml for the service definition.
3515
//
16+
// Task queue format: /temporal-sys/worker-commands/{namespace}/{worker_grouping_key}
3617
// --)
3718

3819
// Request payload for the "cancel-activities" Nexus operation.
3920
message CancelActivitiesRequest {
4021
// Task tokens identifying the activities to cancel.
41-
// Each token corresponds to a specific activity task that the worker received.
4222
repeated bytes task_tokens = 1;
4323
}
4424

4525
// Response payload for the "cancel-activities" Nexus operation.
4626
message CancelActivitiesResponse {
47-
// Empty for now. Can be extended to include cancellation status per activity.
4827
}
4928

0 commit comments

Comments
 (0)