@superdurable/dex 1.14.1 → 1.16.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -4,6 +4,24 @@ import { Duration } from "./google/protobuf/duration.js";
4
4
  import { Empty } from "./google/protobuf/empty.js";
5
5
  import { NullValue } from "./google/protobuf/struct.js";
6
6
  export declare const protobufPackage = "dex";
7
+ /**
8
+ * Identifies the engine behind a Dex Server. Clients use it only to adapt behavior that differs
9
+ * between engines.
10
+ */
11
+ export declare enum ServerEngine {
12
+ /**
13
+ * SERVER_ENGINE_UNSPECIFIED - The Server does not report its engine. Servers released before this field existed are the
14
+ * Go Server on Temporal or Cadence.
15
+ */
16
+ SERVER_ENGINE_UNSPECIFIED = 0,
17
+ /** SERVER_ENGINE_TEMPORAL - The Go Server running on Temporal. */
18
+ SERVER_ENGINE_TEMPORAL = 1,
19
+ /** SERVER_ENGINE_CADENCE - The Go Server running on Cadence. */
20
+ SERVER_ENGINE_CADENCE = 2,
21
+ /** SERVER_ENGINE_ZD - server-zd: the zero-dependency Server that keeps all state in object storage. */
22
+ SERVER_ENGINE_ZD = 3,
23
+ UNRECOGNIZED = -1
24
+ }
7
25
  /** Explains why a Worker declined a task. */
8
26
  export declare enum PollWorkerTaskRejectReason {
9
27
  /** POLL_WORKER_TASK_REJECT_REASON_UNSPECIFIED - No rejection reason was supplied. */
@@ -16,7 +34,10 @@ export declare enum PollWorkerTaskRejectReason {
16
34
  POLL_WORKER_TASK_REJECT_REASON_UNKNOWN_RPC = 3,
17
35
  UNRECOGNIZED = -1
18
36
  }
19
- /** Distinguishes no available Worker, a disconnected Worker, and a missing Step or RPC registration. */
37
+ /**
38
+ * Distinguishes no available Worker, a disconnected Worker, and a missing Step or RPC registration.
39
+ * Go Server internals; server-zd does not serve or persist them.
40
+ */
20
41
  export declare enum DispatchTaskErrorReason {
21
42
  DISPATCH_TASK_ERROR_REASON_UNSPECIFIED = 0,
22
43
  DISPATCH_TASK_ERROR_REASON_NO_WORKER_AVAILABLE = 1,
@@ -41,12 +62,20 @@ export declare enum IndexType {
41
62
  export declare enum WaitForMethodFailurePolicy {
42
63
  WAIT_FOR_METHOD_FAILURE_POLICY_UNSPECIFIED = 0,
43
64
  WAIT_FOR_METHOD_FAILURE_POLICY_FAIL_FLOW_ON_FAILURE = 1,
65
+ /**
66
+ * WAIT_FOR_METHOD_FAILURE_POLICY_PROCEED_ON_FAILURE - server-zd does not support this yet. StartFlow and SubFlow reject it with INVALID_ARGUMENT.
67
+ * A Step decision that uses it fails the attempt without retry.
68
+ */
44
69
  WAIT_FOR_METHOD_FAILURE_POLICY_PROCEED_ON_FAILURE = 2,
45
70
  UNRECOGNIZED = -1
46
71
  }
47
72
  export declare enum ExecuteMethodFailurePolicy {
48
73
  EXECUTE_METHOD_FAILURE_POLICY_UNSPECIFIED = 0,
49
74
  EXECUTE_METHOD_FAILURE_POLICY_FAIL_FLOW_ON_EXECUTE_METHOD_FAILURE = 1,
75
+ /**
76
+ * EXECUTE_METHOD_FAILURE_POLICY_PROCEED_TO_CONFIGURED_STEP - server-zd does not support this yet. StartFlow and SubFlow reject it with INVALID_ARGUMENT.
77
+ * A Step decision that uses it fails the attempt without retry.
78
+ */
50
79
  EXECUTE_METHOD_FAILURE_POLICY_PROCEED_TO_CONFIGURED_STEP = 2,
51
80
  UNRECOGNIZED = -1
52
81
  }
@@ -65,7 +94,10 @@ export declare enum ActiveStepSearchMode {
65
94
  ACTIVE_STEP_SEARCH_MODE_DISABLED = 3,
66
95
  UNRECOGNIZED = -1
67
96
  }
68
- /** Was optimize_activity: false=SYNC, true=ASYNC. Timer is always optimized by the server. */
97
+ /**
98
+ * Was optimize_activity: false=SYNC, true=ASYNC. Timer is always optimized by the server.
99
+ * On server-zd both durabilities record the same events. ASYNC advances without waiting for the commit; there is no local phase.
100
+ */
69
101
  export declare enum StepDurability {
70
102
  STEP_DURABILITY_UNSPECIFIED = 0,
71
103
  STEP_DURABILITY_SYNC = 1,
@@ -91,10 +123,14 @@ export declare enum FlowStatus {
91
123
  FLOW_STATUS_RUNNING = 1,
92
124
  FLOW_STATUS_COMPLETED = 2,
93
125
  FLOW_STATUS_FAILED = 3,
94
- /** FLOW_STATUS_SERVER_SIDE_TIMEOUT_INTERNAL_ONLY - Reserved for reporting a backend hard timeout; applications must not depend on this status. */
126
+ /**
127
+ * FLOW_STATUS_SERVER_SIDE_TIMEOUT_INTERNAL_ONLY - Reserved for reporting a backend hard timeout; applications must not depend on this status.
128
+ * server-zd never returns this status.
129
+ */
95
130
  FLOW_STATUS_SERVER_SIDE_TIMEOUT_INTERNAL_ONLY = 4,
96
131
  FLOW_STATUS_TERMINATED = 5,
97
132
  FLOW_STATUS_CANCELED = 6,
133
+ /** FLOW_STATUS_CONTINUED_AS_NEW - server-zd never returns this status. */
98
134
  FLOW_STATUS_CONTINUED_AS_NEW = 7,
99
135
  UNRECOGNIZED = -1
100
136
  }
@@ -110,13 +146,22 @@ export declare enum FlowErrorType {
110
146
  FLOW_ERROR_TYPE_INTERNAL = 6,
111
147
  UNRECOGNIZED = -1
112
148
  }
113
- /** PendingStepMethodPhase reports the latest persisted backend lifecycle event. */
149
+ /**
150
+ * PendingStepMethodPhase reports the latest persisted backend lifecycle event.
151
+ * On server-zd, SCHEDULED waits for locks or dispatch. STARTED means an attempt is running.
152
+ */
114
153
  export declare enum PendingStepMethodPhase {
115
154
  PENDING_STEP_METHOD_PHASE_UNSPECIFIED = 0,
116
155
  PENDING_STEP_METHOD_PHASE_SCHEDULED = 1,
117
156
  PENDING_STEP_METHOD_PHASE_STARTED = 2,
118
157
  UNRECOGNIZED = -1
119
158
  }
159
+ export declare enum PullRoutingSource {
160
+ PULL_ROUTING_SOURCE_UNSPECIFIED = 0,
161
+ PULL_ROUTING_SOURCE_STICKY_QUEUE = 1,
162
+ PULL_ROUTING_SOURCE_FLOW_TYPE_QUEUE = 2,
163
+ UNRECOGNIZED = -1
164
+ }
120
165
  export declare enum ActiveStepPhase {
121
166
  ACTIVE_STEP_PHASE_UNSPECIFIED = 0,
122
167
  ACTIVE_STEP_PHASE_ACTIVE = 1,
@@ -219,6 +264,8 @@ export interface ServerInfo {
219
264
  minimumSupportedProtocolVersion: number;
220
265
  /** Newest protocol version implemented by this Server. */
221
266
  currentProtocolVersion: number;
267
+ /** The engine behind this Server. */
268
+ serverEngine: ServerEngine;
222
269
  }
223
270
  /** Carries one Worker frame on a pull stream. Register must be the first frame. */
224
271
  export interface PollWorkerTaskRequest {
@@ -363,7 +410,10 @@ export interface PollWorkerTaskReconnect {
363
410
  /** Checks that an idle pull stream remains responsive. */
364
411
  export interface PollWorkerTaskPing {
365
412
  }
366
- /** Describes one task dispatched to a Dex task queue. */
413
+ /**
414
+ * Describes one task dispatched to a Dex task queue.
415
+ * Go Server internals; server-zd does not serve or persist them.
416
+ */
367
417
  export interface DispatchTaskRequest {
368
418
  /** Selects the initial queue: a sticky Worker ID or a Flow type. */
369
419
  queue: string;
@@ -400,7 +450,10 @@ export interface DispatchTaskRequest {
400
450
  /** Allows matching to return UNKNOWN_NAME after a Worker rejects an unknown Step type or RPC name. */
401
451
  supportsUnknownNameError: boolean;
402
452
  }
403
- /** Reports assignment changes, relays Worker output, then ends with a result, Worker error, or dispatch error. */
453
+ /**
454
+ * Reports assignment changes, relays Worker output, then ends with a result, Worker error, or dispatch error.
455
+ * Go Server internals; server-zd does not serve or persist them.
456
+ */
404
457
  export interface DispatchTaskResponse {
405
458
  output: {
406
459
  $case: "waitFor";
@@ -433,19 +486,28 @@ export interface DispatchTaskResponse {
433
486
  /** Identifies a Worker that rejected the task's Step type or RPC name. */
434
487
  rejectedByAppWorkerId: string;
435
488
  }
436
- /** Reports a failure before Dex receives a Worker result. */
489
+ /**
490
+ * Reports a failure before Dex receives a Worker result.
491
+ * Go Server internals; server-zd does not serve or persist them.
492
+ */
437
493
  export interface DispatchTaskError {
438
494
  reason: DispatchTaskErrorReason;
439
495
  detail: string;
440
496
  }
441
497
  export interface Value {
442
498
  kind: //
443
- /** Hydrate from blob storage, then replace with string_value. */
499
+ /**
500
+ * Hydrate from blob storage, then replace with string_value.
501
+ * The Server chooses this reference text; clients must treat it as opaque.
502
+ */
444
503
  {
445
504
  $case: "internalBlobIdForStringValue";
446
505
  value: string;
447
506
  } | //
448
- /** Hydrate from blob storage, then replace with obj_value. */
507
+ /**
508
+ * Hydrate from blob storage, then replace with obj_value.
509
+ * The Server chooses this reference text; clients must treat it as opaque.
510
+ */
449
511
  {
450
512
  $case: "internalBlobIdForObjValue";
451
513
  value: string;
@@ -526,7 +588,14 @@ export interface Context {
526
588
  /** Previous Step method failure supplied only to its configured recovery method. */
527
589
  recoveryError: RecoveryErrorInfo | undefined;
528
590
  lastHeartbeatValue: Value | undefined;
591
+ /**
592
+ * server-zd only: the run attempt that dispatched this invocation. It starts at 1 and
593
+ * increases on each time travel. On server-zd, run_id stays the same across run attempts,
594
+ * so combine both when an idempotency key must change after time travel.
595
+ */
596
+ runAttempt: number;
529
597
  }
598
+ /** server-zd never sets this. */
530
599
  export interface LocalActivityMetadata {
531
600
  currentStepExecutionId: string;
532
601
  fromStepExecutionId: string;
@@ -538,6 +607,7 @@ export interface RetryPolicy {
538
607
  maximumAttempts: number;
539
608
  totalDurationSeconds: number;
540
609
  }
610
+ /** server-zd does not support Flow retry and rejects a set policy with INVALID_ARGUMENT. */
541
611
  export interface FlowRetryPolicy {
542
612
  initialIntervalSeconds: number;
543
613
  backoffCoefficient: number;
@@ -551,7 +621,15 @@ export interface StepOptions {
551
621
  executeRetryPolicy: RetryPolicy | undefined;
552
622
  waitForFailurePolicy: WaitForMethodFailurePolicy;
553
623
  executeFailurePolicy: ExecuteMethodFailurePolicy;
624
+ /**
625
+ * server-zd does not support this yet. StartFlow and SubFlow reject it with INVALID_ARGUMENT.
626
+ * A Step decision that uses it fails the attempt without retry.
627
+ */
554
628
  executeFailureProceedStepType: string;
629
+ /**
630
+ * server-zd does not support this yet. StartFlow and SubFlow reject it with INVALID_ARGUMENT.
631
+ * A Step decision that uses it fails the attempt without retry.
632
+ */
555
633
  executeFailureProceedStepOptions: StepOptions | undefined;
556
634
  skipWaitFor: boolean;
557
635
  waitForDurabilityOverride: StepDurability;
@@ -571,7 +649,15 @@ export interface FlowTimeoutHandlerOptions {
571
649
  heartbeatTimeoutSeconds: number;
572
650
  retryPolicy: RetryPolicy | undefined;
573
651
  failurePolicy: ExecuteMethodFailurePolicy;
652
+ /**
653
+ * server-zd does not support this yet. StartFlow and SubFlow reject it with INVALID_ARGUMENT.
654
+ * A Step decision that uses it fails the attempt without retry.
655
+ */
574
656
  failureProceedStepType: string;
657
+ /**
658
+ * server-zd does not support this yet. StartFlow and SubFlow reject it with INVALID_ARGUMENT.
659
+ * A Step decision that uses it fails the attempt without retry.
660
+ */
575
661
  failureProceedStepOptions: StepOptions | undefined;
576
662
  durabilityOverride: StepDurability;
577
663
  lockAttributeKeys: string[];
@@ -584,7 +670,9 @@ export interface FlowAlreadyStartedOptions {
584
670
  }
585
671
  export interface FlowStartOptions {
586
672
  idReusePolicy: IdReusePolicy;
673
+ /** server-zd rejects a positive start delay with INVALID_ARGUMENT. */
587
674
  flowStartDelaySeconds: number;
675
+ /** server-zd rejects a set policy with INVALID_ARGUMENT. */
588
676
  retryPolicy: FlowRetryPolicy | undefined;
589
677
  attributes: AttributeWrite[];
590
678
  flowConfigOverride: FlowConfig | undefined;
@@ -593,7 +681,9 @@ export interface FlowStartOptions {
593
681
  }
594
682
  export interface FlowConfig {
595
683
  activeStepSearchMode?: ActiveStepSearchMode | undefined;
684
+ /** server-zd ignores this field. */
596
685
  continueAsNewThreshold?: number | undefined;
686
+ /** server-zd ignores this field. */
597
687
  continueAsNewPageSizeInBytes?: number | undefined;
598
688
  stepDurability?: StepDurability | undefined;
599
689
  workerTarget: WorkerTarget | undefined;
@@ -604,8 +694,12 @@ export interface AttributeStoreNames {
604
694
  names: string[];
605
695
  }
606
696
  export interface WorkerTarget {
607
- /** Plaintext gRPC dial target, not an HTTP URL. */
697
+ /**
698
+ * Plaintext gRPC dial target, not an HTTP URL.
699
+ * server-zd accepts only is_pull_mode and rejects address targets with INVALID_ARGUMENT.
700
+ */
608
701
  address: string;
702
+ /** server-zd accepts only is_pull_mode and rejects address targets with INVALID_ARGUMENT. */
609
703
  isHeadlessAddress: boolean;
610
704
  /** Routes work through a connected pull Worker; mutually exclusive with address. */
611
705
  isPullMode: boolean;
@@ -752,6 +846,7 @@ export interface SearchFlowsRequest {
752
846
  query: string;
753
847
  pageSize: number;
754
848
  nextPageToken: string;
849
+ /** server-zd ignores this field. */
755
850
  includeContinuedAsNew: boolean;
756
851
  }
757
852
  export interface SearchFlowsResponse {
@@ -788,12 +883,15 @@ export interface GetFlowSummaryRequest {
788
883
  }
789
884
  export interface GetFlowSummaryResponse {
790
885
  flowExecutionId: FlowExecutionID | undefined;
886
+ /** On server-zd this always equals run_id. */
791
887
  firstRunId: string;
792
888
  requestId: string;
793
889
  flowType: string;
794
890
  flowStatus: FlowStatus;
795
891
  startTime: Date | undefined;
796
892
  closeTime: Date | undefined;
893
+ /** server-zd only: the current run attempt of this run. */
894
+ runAttempt: number;
797
895
  }
798
896
  export interface InternalAsyncStepInputSnapshot {
799
897
  methodOptions: StepMethodOptions | undefined;
@@ -815,6 +913,11 @@ export interface GetHistoryEventsRequest {
815
913
  startInternalEventId: bigint;
816
914
  estimatePageSize: number;
817
915
  nextPageToken: Uint8Array;
916
+ /**
917
+ * server-zd only: selects the run attempt whose lineage is returned. Zero selects the current
918
+ * run attempt.
919
+ */
920
+ runAttempt: number;
818
921
  }
819
922
  export interface GetHistoryEventsResponse {
820
923
  events: FlowHistoryEvent[];
@@ -824,6 +927,8 @@ export interface GetHistoryEventsResponse {
824
927
  export interface FlowHistoryEvent {
825
928
  eventId: bigint;
826
929
  eventTime: Date | undefined;
930
+ /** server-zd only: the run attempt that recorded this event. */
931
+ runAttempt: number;
827
932
  payload: {
828
933
  $case: "flowStartedOrContinued";
829
934
  value: FlowStartedOrContinuedHistoryEvent;
@@ -866,6 +971,12 @@ export interface FlowHistoryEvent {
866
971
  export interface TimeTravelForkHistoryEvent {
867
972
  /** Previous run containing the original history branch. */
868
973
  previousRunId: string;
974
+ /** server-zd only: the run attempt that was current before this time travel. */
975
+ previousRunAttempt: number;
976
+ /** server-zd only: the run attempt of the point this time travel returned to. */
977
+ targetRunAttempt: number;
978
+ /** server-zd only: the event ID of the point this time travel returned to. */
979
+ targetEventId: bigint;
869
980
  }
870
981
  export interface FlowStartedOrContinuedHistoryEvent {
871
982
  flowExecutionId: FlowExecutionID | undefined;
@@ -877,7 +988,9 @@ export interface FlowStartedOrContinuedHistoryEvent {
877
988
  startOrContinue: {
878
989
  $case: "initialStart";
879
990
  value: FlowInitialStart;
880
- } | {
991
+ } | //
992
+ /** server-zd never sets this. */
993
+ {
881
994
  $case: "continuedStart";
882
995
  value: FlowContinuedStart;
883
996
  } | undefined;
@@ -888,6 +1001,7 @@ export interface FlowInitialStart {
888
1001
  stepOptions: StepOptions | undefined;
889
1002
  initialAttributes: KV[];
890
1003
  }
1004
+ /** server-zd never sets this. */
891
1005
  export interface FlowContinuedStart {
892
1006
  previousRunId: string;
893
1007
  stepsToStart: StepMovement[];
@@ -897,6 +1011,7 @@ export interface FlowContinuedStart {
897
1011
  };
898
1012
  attributes: KV[];
899
1013
  completedSteps: StepCompletionOutput[];
1014
+ stickyAppWorkerId: string;
900
1015
  }
901
1016
  export interface FlowContinuedStart_PendingChannelMessagesEntry {
902
1017
  key: string;
@@ -907,7 +1022,9 @@ export interface FlowClosedHistoryEvent {
907
1022
  results: StepCompletionOutput[];
908
1023
  errorType: FlowErrorType;
909
1024
  errorMessage: string;
1025
+ /** server-zd never sets this. */
910
1026
  continuedToRunId: string;
1027
+ stickyAppWorkerId: string;
911
1028
  }
912
1029
  /** StepMethodPendingEvent describes a regular Step activity unresolved at flow closure. */
913
1030
  export interface StepMethodPendingEvent {
@@ -919,6 +1036,7 @@ export interface StepMethodFailure {
919
1036
  backendError: string;
920
1037
  details: ServiceErrorResponse | undefined;
921
1038
  attempt: number;
1039
+ pullRouting: PullRouting | undefined;
922
1040
  }
923
1041
  export interface StepMethodOptions {
924
1042
  timeoutSeconds: number;
@@ -932,6 +1050,11 @@ export interface StepMethodEventInput {
932
1050
  attributes: KV[];
933
1051
  stepExecutionLocals: KV[];
934
1052
  }
1053
+ export interface PullRouting {
1054
+ stickyAppWorkerId: string;
1055
+ servedByAppWorkerId: string;
1056
+ source: PullRoutingSource;
1057
+ }
935
1058
  export interface StepMethodEventContext {
936
1059
  stepExecutionId: string;
937
1060
  fromStepExecutionId: string;
@@ -942,6 +1065,7 @@ export interface StepMethodEventContext {
942
1065
  duration: Duration | undefined;
943
1066
  methodOptions: StepMethodOptions | undefined;
944
1067
  lastFailureInfo: StepMethodFailure | undefined;
1068
+ pullRouting: PullRouting | undefined;
945
1069
  }
946
1070
  export interface StepWaitForCompletedOutput {
947
1071
  waitForCondition: WaitingCondition | undefined;
@@ -996,6 +1120,7 @@ export interface RpcExecutionCompletedEvent {
996
1120
  publishToChannel: ChannelMessage[];
997
1121
  isSetAttributeApi: boolean;
998
1122
  deleteFromChannel: ChannelMessageDeletion[];
1123
+ servedByAppWorkerId: string;
999
1124
  }
1000
1125
  export interface ChannelExternalPublishEvent {
1001
1126
  messages: ChannelMessage[];
@@ -1024,6 +1149,8 @@ export interface ActiveStepExecutionState {
1024
1149
  stepExecutionLocals: KV[];
1025
1150
  timers: TimerInfo[];
1026
1151
  lastFailureInfo: StepMethodFailure | undefined;
1152
+ waitForPullRouting: PullRouting | undefined;
1153
+ executePullRouting: PullRouting | undefined;
1027
1154
  }
1028
1155
  export interface GetFlowStateRequest {
1029
1156
  flowId: string;
@@ -1038,6 +1165,7 @@ export interface GetFlowStateResponse {
1038
1165
  [key: string]: ChannelValues;
1039
1166
  };
1040
1167
  completedSteps: StepCompletionOutput[];
1168
+ stickyAppWorkerId: string;
1041
1169
  }
1042
1170
  export interface GetFlowStateResponse_PendingChannelMessagesEntry {
1043
1171
  key: string;
@@ -1054,9 +1182,16 @@ export interface ResetFlowRequest {
1054
1182
  /** Skips reapplying RPCs, Channel publications, and Attribute writes after the reset point. */
1055
1183
  skipWritesReapply: boolean;
1056
1184
  stepMethod: FlowResetStepMethod;
1185
+ /**
1186
+ * server-zd only: selects the run attempt whose history is searched for the reset point.
1187
+ * Zero selects the current run attempt.
1188
+ */
1189
+ runAttempt: number;
1057
1190
  }
1058
1191
  export interface ResetFlowResponse {
1059
1192
  runId: string;
1193
+ /** server-zd only: the run attempt created by this time travel. run_id does not change there. */
1194
+ runAttempt: number;
1060
1195
  }
1061
1196
  export interface InvokeRPCRequest {
1062
1197
  flowId: string;
@@ -1070,7 +1205,10 @@ export interface InvokeRPCRequest {
1070
1205
  * read-modify-write. Empty means no locking and uses the configured RPC path.
1071
1206
  */
1072
1207
  lockAttributeKeys: string[];
1073
- /** Per-call UUID, SDK-generated and future-overridable; identical retries reuse it. Temporal Update paths use it as the run-scoped Update ID; Continue-as-New resets scope. */
1208
+ /**
1209
+ * Per-call UUID, SDK-generated and future-overridable; identical retries reuse it. Temporal Update paths use it as the run-scoped Update ID; Continue-as-New resets scope.
1210
+ * server-zd deduplicates it for the whole run.
1211
+ */
1074
1212
  requestId: string;
1075
1213
  /**
1076
1214
  * Requests transactional reads and writes. Attribute locking enables it
@@ -1120,6 +1258,7 @@ export interface WaitForStepCompletionRequest {
1120
1258
  * Use a positive value only to reclaim accepted waits left in flight after callers exit.
1121
1259
  * Temporal permits 10 in-flight Updates per Workflow Execution. Active callers transparently
1122
1260
  * start a new generation. Zero disables rollover; each rollover adds Update history.
1261
+ * server-zd ignores this field.
1123
1262
  */
1124
1263
  internalHandlerTimeoutSeconds: number;
1125
1264
  /** Optional logical idempotency key. Empty derives wait-for-step-completion:{Step execution ID}. */
@@ -1140,6 +1279,7 @@ export interface WaitForAttributeRequest {
1140
1279
  * Use a positive value only to reclaim accepted waits left in flight after callers exit.
1141
1280
  * Temporal permits 10 in-flight Updates per Workflow Execution. Active callers transparently
1142
1281
  * start a new generation. Zero disables rollover; each rollover adds Update history.
1282
+ * server-zd ignores this field.
1143
1283
  */
1144
1284
  internalHandlerTimeoutSeconds: number;
1145
1285
  /** Optional logical idempotency key. Empty derives wait-for-attribute:{encoded condition}. */
@@ -1182,6 +1322,7 @@ export interface InternalActivityError {
1182
1322
  serverDetail: string;
1183
1323
  workerGrpcStatus: number;
1184
1324
  workerError: InternalWorkerError | undefined;
1325
+ pullRouting: PullRouting | undefined;
1185
1326
  }
1186
1327
  export interface InternalWorkerError {
1187
1328
  detail: string;
@@ -1225,7 +1366,10 @@ export interface InvokeWaitForMethodRequest_LoadedChannelMessagesEntry {
1225
1366
  value: ChannelValues | undefined;
1226
1367
  }
1227
1368
  export interface InvokeWaitForMethodResponse {
1228
- /** Server-populated lineage input for local activity history. */
1369
+ /**
1370
+ * Server-populated lineage input for local activity history.
1371
+ * server-zd never sets this.
1372
+ */
1229
1373
  localActivityMetadata: LocalActivityMetadata | undefined;
1230
1374
  upsertAttributes: AttributeWrite[];
1231
1375
  waitingCondition: WaitingCondition | undefined;
@@ -1282,7 +1426,10 @@ export interface InvokeExecuteMethodRequest_LoadedChannelMessagesEntry {
1282
1426
  value: ChannelValues | undefined;
1283
1427
  }
1284
1428
  export interface InvokeExecuteMethodResponse {
1285
- /** Server-populated lineage input for local activity history. */
1429
+ /**
1430
+ * Server-populated lineage input for local activity history.
1431
+ * server-zd never sets this.
1432
+ */
1286
1433
  localActivityMetadata: LocalActivityMetadata | undefined;
1287
1434
  stepDecision: StepDecision | undefined;
1288
1435
  upsertAttributes: AttributeWrite[];
@@ -1377,7 +1524,9 @@ export interface WaitingConditionState {
1377
1524
  export interface SubFlowOptions {
1378
1525
  reusePolicy: SubFlowReusePolicy;
1379
1526
  flowTimeoutSeconds: number;
1527
+ /** server-zd rejects a positive start delay with INVALID_ARGUMENT. */
1380
1528
  flowStartDelaySeconds: number;
1529
+ /** server-zd rejects a set policy with INVALID_ARGUMENT. */
1381
1530
  retryPolicy: FlowRetryPolicy | undefined;
1382
1531
  attributes: AttributeWrite[];
1383
1532
  flowConfigOverride: FlowConfig | undefined;
@@ -1468,6 +1617,7 @@ export interface StepExecutionResumeInfo {
1468
1617
  completedConditions: StepExecutionCompletedConditions | undefined;
1469
1618
  waitingCondition: WaitingConditionState | undefined;
1470
1619
  stepExeLocals: KV[];
1620
+ waitForPullRouting: PullRouting | undefined;
1471
1621
  }
1472
1622
  export interface StepExecutionCounterInfo {
1473
1623
  stepTypeStartedCount: {
@@ -1557,6 +1707,7 @@ export interface InvokeWaitForMethodActivityOutput {
1557
1707
  response: InvokeWaitForMethodResponse | undefined;
1558
1708
  /** Identifies the Worker that completed this pull task for sticky routing. */
1559
1709
  servedByAppWorkerId: string;
1710
+ pullRouting: PullRouting | undefined;
1560
1711
  }
1561
1712
  export interface InvokeExecuteMethodActivityInput {
1562
1713
  workerTarget: WorkerTarget | undefined;
@@ -1573,16 +1724,19 @@ export interface RecoveryErrorInfo {
1573
1724
  errorType: string;
1574
1725
  }
1575
1726
  export interface InternalLocalStepActivityFailure {
1727
+ /** server-zd never sets this. */
1576
1728
  localActivityMetadata: LocalActivityMetadata | undefined;
1577
1729
  firstAttemptTimestamp: bigint;
1578
1730
  methodOptions: StepMethodOptions | undefined;
1579
1731
  attempt: number;
1580
1732
  activityError: InternalActivityError | undefined;
1733
+ pullRouting: PullRouting | undefined;
1581
1734
  }
1582
1735
  export interface InvokeExecuteMethodActivityOutput {
1583
1736
  response: InvokeExecuteMethodResponse | undefined;
1584
1737
  /** Identifies the Worker that completed this pull task for sticky routing. */
1585
1738
  servedByAppWorkerId: string;
1739
+ pullRouting: PullRouting | undefined;
1586
1740
  }
1587
1741
  export interface DumpFlowForContinueAsNewActivityInput {
1588
1742
  request: ContinueAsNewDumpRequest | undefined;
@@ -1648,6 +1802,7 @@ export interface ExecuteRpcSignalRequest {
1648
1802
  deleteFromChannel: ChannelMessageDeletion[];
1649
1803
  isDeleteChannelMessageApi: boolean;
1650
1804
  actionPermissionMappings: ActionPermissionMappings | undefined;
1805
+ servedByAppWorkerId: string;
1651
1806
  }
1652
1807
  export interface SkipTimerSignalRequest {
1653
1808
  stepExecutionId: string;
@@ -1814,6 +1969,7 @@ export declare const StepMethodPendingEvent: MessageFns<StepMethodPendingEvent>;
1814
1969
  export declare const StepMethodFailure: MessageFns<StepMethodFailure>;
1815
1970
  export declare const StepMethodOptions: MessageFns<StepMethodOptions>;
1816
1971
  export declare const StepMethodEventInput: MessageFns<StepMethodEventInput>;
1972
+ export declare const PullRouting: MessageFns<PullRouting>;
1817
1973
  export declare const StepMethodEventContext: MessageFns<StepMethodEventContext>;
1818
1974
  export declare const StepWaitForCompletedOutput: MessageFns<StepWaitForCompletedOutput>;
1819
1975
  export declare const StepExecuteCompletedOutput: MessageFns<StepExecuteCompletedOutput>;
@@ -2164,6 +2320,7 @@ export declare const FlowServiceService: {
2164
2320
  readonly responseSerialize: (value: WaitForAttributeResponse) => Buffer;
2165
2321
  readonly responseDeserialize: (value: Buffer) => WaitForAttributeResponse;
2166
2322
  };
2323
+ /** server-zd returns UNIMPLEMENTED. */
2167
2324
  readonly triggerContinueAsNew: {
2168
2325
  readonly path: "/dex.FlowService/TriggerContinueAsNew";
2169
2326
  readonly requestStream: false;
@@ -2210,6 +2367,7 @@ export interface FlowServiceServer extends UntypedServiceImplementation {
2210
2367
  updateFlowConfig: handleUnaryCall<UpdateFlowConfigRequest, Empty>;
2211
2368
  waitForStepCompletion: handleUnaryCall<WaitForStepCompletionRequest, WaitForStepCompletionResponse>;
2212
2369
  waitForAttribute: handleUnaryCall<WaitForAttributeRequest, WaitForAttributeResponse>;
2370
+ /** server-zd returns UNIMPLEMENTED. */
2213
2371
  triggerContinueAsNew: handleUnaryCall<TriggerContinueAsNewRequest, Empty>;
2214
2372
  healthCheck: handleUnaryCall<Empty, HealthInfo>;
2215
2373
  }
@@ -2290,6 +2448,7 @@ export interface FlowServiceClient extends Client {
2290
2448
  waitForAttribute(request: WaitForAttributeRequest, callback: (error: ServiceError | null, response: WaitForAttributeResponse) => void): ClientUnaryCall;
2291
2449
  waitForAttribute(request: WaitForAttributeRequest, metadata: Metadata, callback: (error: ServiceError | null, response: WaitForAttributeResponse) => void): ClientUnaryCall;
2292
2450
  waitForAttribute(request: WaitForAttributeRequest, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: WaitForAttributeResponse) => void): ClientUnaryCall;
2451
+ /** server-zd returns UNIMPLEMENTED. */
2293
2452
  triggerContinueAsNew(request: TriggerContinueAsNewRequest, callback: (error: ServiceError | null, response: Empty) => void): ClientUnaryCall;
2294
2453
  triggerContinueAsNew(request: TriggerContinueAsNewRequest, metadata: Metadata, callback: (error: ServiceError | null, response: Empty) => void): ClientUnaryCall;
2295
2454
  triggerContinueAsNew(request: TriggerContinueAsNewRequest, metadata: Metadata, options: Partial<CallOptions>, callback: (error: ServiceError | null, response: Empty) => void): ClientUnaryCall;
@@ -2302,7 +2461,10 @@ export declare const FlowServiceClient: {
2302
2461
  service: typeof FlowServiceService;
2303
2462
  serviceName: string;
2304
2463
  };
2305
- /** Hosted by Dex worker; server calls these RPCs. */
2464
+ /**
2465
+ * Hosted by Dex worker; server calls these RPCs.
2466
+ * server-zd supports only pull Workers and never calls WorkerService.
2467
+ */
2306
2468
  export type WorkerServiceService = typeof WorkerServiceService;
2307
2469
  export declare const WorkerServiceService: {
2308
2470
  readonly invokeWaitForMethod: {
@@ -2381,7 +2543,10 @@ export declare const WorkerTaskServiceClient: {
2381
2543
  service: typeof WorkerTaskServiceService;
2382
2544
  serviceName: string;
2383
2545
  };
2384
- /** Hosted on the internal listener; server instances route tasks and Worker streams to queue owners. */
2546
+ /**
2547
+ * Hosted on the internal listener; server instances route tasks and Worker streams to queue owners.
2548
+ * Go Server internals; server-zd does not serve or persist them.
2549
+ */
2385
2550
  export type MatchingServiceService = typeof MatchingServiceService;
2386
2551
  export declare const MatchingServiceService: {
2387
2552
  /** Streams Worker output frames and a final result or dispatch error. */
@@ -2425,7 +2590,10 @@ export declare const MatchingServiceClient: {
2425
2590
  service: typeof MatchingServiceService;
2426
2591
  serviceName: string;
2427
2592
  };
2428
- /** Server-internal only (interpreter CAN activity → API). Not SDK-facing. */
2593
+ /**
2594
+ * Server-internal only (interpreter CAN activity → API). Not SDK-facing.
2595
+ * Go Server internals; server-zd does not serve or persist them.
2596
+ */
2429
2597
  export type InternalServiceService = typeof InternalServiceService;
2430
2598
  export declare const InternalServiceService: {
2431
2599
  readonly dumpFlowForContinueAsNew: {