@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.
- package/README.md +82 -0
- package/dist/src/client.js +1 -0
- package/dist/src/client.js.map +1 -1
- package/dist/src/credential.d.ts +86 -0
- package/dist/src/credential.js +373 -7
- package/dist/src/credential.js.map +1 -1
- package/dist/src/gen/dex.d.ts +185 -17
- package/dist/src/gen/dex.js +431 -14
- package/dist/src/gen/dex.js.map +1 -1
- package/dist/src/index.d.ts +2 -2
- package/dist/src/index.js +1 -1
- package/dist/src/index.js.map +1 -1
- package/dist/src/options.d.ts +50 -2
- package/dist/src/options.js.map +1 -1
- package/dist/src/pull-worker.d.ts +5 -0
- package/dist/src/pull-worker.js +38 -5
- package/dist/src/pull-worker.js.map +1 -1
- package/dist/src/sdk-version.generated.d.ts +1 -1
- package/dist/src/sdk-version.generated.js +1 -1
- package/dist/src/worker.d.ts +12 -0
- package/dist/src/worker.js +14 -0
- package/dist/src/worker.js.map +1 -1
- package/native/linux-aarch64/dex_blob_cache_node.node +0 -0
- package/native/linux-x86_64/dex_blob_cache_node.node +0 -0
- package/native/macos-aarch64/dex_blob_cache_node.node +0 -0
- package/native/macos-x86_64/dex_blob_cache_node.node +0 -0
- package/native/windows-x86_64/dex_blob_cache_node.node +0 -0
- package/package.json +1 -1
package/dist/src/gen/dex.d.ts
CHANGED
|
@@ -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
|
-
/**
|
|
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
|
-
/**
|
|
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
|
-
/**
|
|
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
|
-
/**
|
|
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
|
-
/**
|
|
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
|
-
/**
|
|
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
|
-
/**
|
|
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
|
-
/**
|
|
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
|
-
/**
|
|
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
|
-
/**
|
|
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
|
-
/**
|
|
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
|
-
/**
|
|
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
|
-
/**
|
|
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
|
-
/**
|
|
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
|
-
/**
|
|
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
|
-
/**
|
|
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: {
|