@superdurable/dex 1.20.0 → 1.25.0

package/dist/src/grpc-status.d.ts

@@ -1,7 +1,6 @@
 import { status, type ServiceError as GrpcServiceError } from "@grpc/grpc-js";
 import { WorkerErrorResponse } from "./gen/dex.js";
 import { DexServiceError } from "./errors.js";
-export declare function workerServiceError(failure: unknown): GrpcServiceError;
 export declare function workerErrorResponse(failure: unknown, grpcStatus?: status): WorkerErrorResponse;
 export type FlowTargetRequirement = "none" | "existing" | "active";
 export declare function translateServiceError(error: GrpcServiceError, operation: string, flowId: string | undefined, requirement: FlowTargetRequirement): DexServiceError;

package/dist/src/grpc-status.js

@@ -5,8 +5,8 @@
 // See the LICENSE file in the repository root.
 //
 // SPDX-License-Identifier: LicenseRef-Sustainable-Use-1.0
-import { BinaryReader, BinaryWriter } from "@bufbuild/protobuf/wire";
-import { Metadata, status } from "@grpc/grpc-js";
+import { BinaryReader } from "@bufbuild/protobuf/wire";
+import { status } from "@grpc/grpc-js";
 import { ServiceErrorResponse, ErrorSubStatus as ProtoErrorSubStatus, WorkerErrorResponse, } from "./gen/dex.js";
 import { DexServiceError, ErrorSubStatus, FlowAlreadyStartedError, FlowClosingError, FlowNotActiveOrNotFoundError, FlowNotFoundError, LongPollTimeoutError, RequestTimeoutError, ChannelMessageNotFoundError, RpcLockConflictError, WorkerInvocationError, } from "./errors.js";
 import { RetryAfterError } from "./retry-after.js";
@@ -17,19 +17,6 @@ const maxWorkerStackTraceBytes = 4 * 1024;
 const errorDetailTruncationMarker = Buffer.from("\n... error detail truncated by Dex TypeScript SDK ...");
 const errorTypeTruncationMarker = Buffer.from("\n... error type truncated by Dex TypeScript SDK ...");
 const stackTraceTruncationMarker = Buffer.from("\n... stack trace truncated by Dex TypeScript SDK ...");
-export function workerServiceError(failure) {
-    const response = workerErrorResponse(failure);
-    const worker = WorkerErrorResponse.encode(response).finish();
-    const metadata = new Metadata();
-    metadata.set(statusDetailsKey, Buffer.from(encodeStatus(response.grpcStatus, response.detail, [
-        { typeUrl: "type.googleapis.com/dex.WorkerErrorResponse", value: worker },
-    ])));
-    return Object.assign(new Error(response.detail), {
-        code: response.grpcStatus,
-        details: response.detail,
-        metadata,
-    });
-}
 export function workerErrorResponse(failure, grpcStatus = status.UNKNOWN) {
     const retryAfterError = failure instanceof RetryAfterError ? failure : undefined;
     const cause = retryAfterError?.cause instanceof Error
@@ -141,22 +128,6 @@ function mapSubStatus(value) {
             return ErrorSubStatus.UNCATEGORIZED;
     }
 }
-function encodeStatus(code, message, details) {
-    const writer = new BinaryWriter();
-    if (code !== 0) {
-        writer.uint32(8).int32(code);
-    }
-    if (message !== "") {
-        writer.uint32(18).string(message);
-    }
-    for (const detail of details) {
-        writer.uint32(26).fork();
-        writer.uint32(10).string(detail.typeUrl);
-        writer.uint32(18).bytes(detail.value);
-        writer.join();
-    }
-    return writer.finish();
-}
 function decodeStatus(input) {
     const reader = new BinaryReader(input);
     const details = [];

package/dist/src/grpc-status.js.map

@@ -1 +1 @@
-{"version":3,"file":"grpc-status.js","sourceRoot":"","sources":["../../src/grpc-status.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"grpc-status.js","sourceRoot":"","sources":["../../src/grpc-status.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,EAAE;AACF,kDAAkD;AAClD,mEAAmE;AACnE,+CAA+C;AAC/C,EAAE;AACF,0DAA0D;AAE1D,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAY,MAAM,EAAyC,MAAM,eAAe,CAAC;AAExF,OAAO,EACL,oBAAoB,EACpB,cAAc,IAAI,mBAAmB,EACrC,mBAAmB,GACpB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,eAAe,EACf,cAAc,EACd,uBAAuB,EACvB,gBAAgB,EAChB,4BAA4B,EAC5B,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,EACnB,2BAA2B,EAC3B,oBAAoB,EACpB,qBAAqB,GAEtB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEnD,MAAM,gBAAgB,GAAG,yBAAyB,CAAC;AACnD,MAAM,yBAAyB,GAAG,IAAI,CAAC;AACvC,MAAM,uBAAuB,GAAG,GAAG,CAAC;AACpC,MAAM,wBAAwB,GAAG,CAAC,GAAG,IAAI,CAAC;AAC1C,MAAM,2BAA2B,GAAG,MAAM,CAAC,IAAI,CAAC,wDAAwD,CAAC,CAAC;AAC1G,MAAM,yBAAyB,GAAG,MAAM,CAAC,IAAI,CAAC,sDAAsD,CAAC,CAAC;AACtG,MAAM,0BAA0B,GAAG,MAAM,CAAC,IAAI,CAAC,uDAAuD,CAAC,CAAC;AAOxG,MAAM,UAAU,mBAAmB,CAAC,OAAgB,EAAE,aAAqB,MAAM,CAAC,OAAO;IACvF,MAAM,eAAe,GAAG,OAAO,YAAY,eAAe,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;IACjF,MAAM,KAAK,GACT,eAAe,EAAE,KAAK,YAAY,KAAK;QACrC,CAAC,CAAC,eAAe,CAAC,KAAK;QACvB,CAAC,CAAC,OAAO,YAAY,KAAK;YACxB,CAAC,CAAC,OAAO;YACT,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;IACnC,MAAM,MAAM,GAAG,0BAA0B,CACvC,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,IAAI,EAC3B,yBAAyB,EACzB,2BAA2B,CAC5B,CAAC;IACF,OAAO,mBAAmB,CAAC,MAAM,CAAC;QAChC,MAAM;QACN,SAAS,EAAE,0BAA0B,CACnC,KAAK,CAAC,IAAI,EACV,uBAAuB,EACvB,yBAAyB,CAC1B;QACD,UAAU,EAAE,0BAA0B,CACpC,KAAK,CAAC,KAAK,IAAI,EAAE,EACjB,wBAAwB,EACxB,0BAA0B,CAC3B;QACD,iBAAiB,EAAE,eAAe,EAAE,YAAY,IAAI,CAAC;QACrD,UAAU;KACX,CAAC,CAAC;AACL,CAAC;AAED,SAAS,0BAA0B,CACjC,KAAa,EACb,YAAoB,EACpB,gBAA4B;IAE5B,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACnC,IAAI,OAAO,CAAC,MAAM,IAAI,YAAY,EAAE,CAAC;QACnC,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,YAAY,GAAG,YAAY,GAAG,gBAAgB,CAAC,MAAM,CAAC;IAC1D,OAAO,YAAY,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,CAAE,GAAG,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;QACpE,YAAY,IAAI,CAAC,CAAC;IACpB,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,EAAE,YAAY,CAAC,EAAE,gBAAgB,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AAC/F,CAAC;AAID,MAAM,UAAU,qBAAqB,CACnC,KAAuB,EACvB,SAAiB,EACjB,MAA0B,EAC1B,WAAkC;IAElC,IAAI,QAA0C,CAAC;IAC/C,IAAI,CAAC;QACH,QAAQ,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;IACzC,CAAC;IAAC,OAAO,OAAO,EAAE,CAAC;QACjB,OAAO,IAAI,eAAe,CACxB,KAAK,CAAC,IAAI,EACV,cAAc,CAAC,aAAa,EAC5B,yCAAyC,OAAO,YAAY,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,EACvG,SAAS,EACT,MAAM,EACN,EAAE,KAAK,EAAE,KAAK,EAAE,CACjB,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAAG,QAAQ,EAAE,MAAM,IAAI,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC;IAClE,MAAM,SAAS,GACb,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,cAAc,CAAC,aAAa,CAAC,CAAC,CAAC,YAAY,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IAC3F,MAAM,UAAU,GAAG;QACjB,KAAK,CAAC,IAAI;QACV,SAAS;QACT,MAAM;QACN,SAAS;QACT,MAAM;QACN,EAAE,KAAK,EAAE,KAAK,EAAE;KACR,CAAC;IACX,QAAQ,SAAS,EAAE,CAAC;QAClB,KAAK,cAAc,CAAC,oBAAoB;YACtC,OAAO,IAAI,uBAAuB,CAAC,GAAG,UAAU,CAAC,CAAC;QACpD,KAAK,cAAc,CAAC,YAAY;YAC9B,OAAO,IAAI,gBAAgB,CAAC,GAAG,UAAU,CAAC,CAAC;QAC7C,KAAK,cAAc,CAAC,eAAe;YACjC,IAAI,WAAW,KAAK,UAAU,EAAE,CAAC;gBAC/B,OAAO,IAAI,iBAAiB,CAAC,GAAG,UAAU,CAAC,CAAC;YAC9C,CAAC;YACD,IAAI,WAAW,KAAK,QAAQ,EAAE,CAAC;gBAC7B,OAAO,IAAI,4BAA4B,CAAC,GAAG,UAAU,CAAC,CAAC;YACzD,CAAC;YACD,OAAO,IAAI,eAAe,CAAC,GAAG,UAAU,CAAC,CAAC;QAC5C,KAAK,cAAc,CAAC,gBAAgB;YAClC,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,CAAC,OAAO,EAAE,CAAC;gBAClC,OAAO,IAAI,oBAAoB,CAAC,GAAG,UAAU,CAAC,CAAC;YACjD,CAAC;YACD,OAAO,IAAI,qBAAqB,CAC9B,KAAK,CAAC,IAAI,EACV,SAAS,EACT,MAAM,EACN,SAAS,EACT,MAAM,EACN,UAAU,CAAC,QAAQ,CAAC,EACpB,QAAQ,EAAE,uBAAuB,IAAI,EAAE,EACvC,QAAQ,EAAE,yBAAyB,IAAI,EAAE,EACzC,EAAE,KAAK,EAAE,KAAK,EAAE,CACjB,CAAC;QACJ,KAAK,cAAc,CAAC,iBAAiB;YACnC,OAAO,IAAI,oBAAoB,CAAC,GAAG,UAAU,CAAC,CAAC;QACjD,KAAK,cAAc,CAAC,yBAAyB;YAC3C,OAAO,IAAI,2BAA2B,CAAC,GAAG,UAAU,CAAC,CAAC;QACxD,KAAK,cAAc,CAAC,eAAe;YACjC,OAAO,IAAI,mBAAmB,CAAC,GAAG,UAAU,CAAC,CAAC;QAChD;YACE,OAAO,IAAI,eAAe,CAAC,GAAG,UAAU,CAAC,CAAC;IAC9C,CAAC;AACH,CAAC;AAED,SAAS,oBAAoB,CAAC,KAAuB;IACnD,MAAM,OAAO,GAAG,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC;IACxD,IAAI,CAAC,CAAC,OAAO,YAAY,MAAM,CAAC,EAAE,CAAC;QACjC,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;IACtC,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAChD,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,2BAA2B,CAAC,CACxD,CAAC;IACF,OAAO,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,oBAAoB,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACtF,CAAC;AAED,SAAS,UAAU,CAAC,QAA0C;IAC5D,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,CAAC,yBAAyB,KAAK,CAAC,EAAE,CAAC;QACvE,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,IAAI,GAAG,QAAQ,CAAC,yBAAmC,CAAC;IAC1D,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;AACtE,CAAC;AAED,SAAS,YAAY,CAAC,KAA0B;IAC9C,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,mBAAmB,CAAC,8BAA8B;YACrD,OAAO,cAAc,CAAC,aAAa,CAAC;QACtC,KAAK,mBAAmB,CAAC,qCAAqC;YAC5D,OAAO,cAAc,CAAC,oBAAoB,CAAC;QAC7C,KAAK,mBAAmB,CAAC,gCAAgC;YACvD,OAAO,cAAc,CAAC,eAAe,CAAC;QACxC,KAAK,mBAAmB,CAAC,iCAAiC;YACxD,OAAO,cAAc,CAAC,gBAAgB,CAAC;QACzC,KAAK,mBAAmB,CAAC,mCAAmC;YAC1D,OAAO,cAAc,CAAC,iBAAiB,CAAC;QAC1C,KAAK,mBAAmB,CAAC,0CAA0C;YACjE,OAAO,cAAc,CAAC,yBAAyB,CAAC;QAClD,KAAK,mBAAmB,CAAC,gCAAgC;YACvD,OAAO,cAAc,CAAC,eAAe,CAAC;QACxC,KAAK,mBAAmB,CAAC,6BAA6B;YACpD,OAAO,cAAc,CAAC,YAAY,CAAC;QACrC;YACE,OAAO,cAAc,CAAC,aAAa,CAAC;IACxC,CAAC;AACH,CAAC;AAED,SAAS,YAAY,CAAC,KAAiB;IACrC,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC,KAAK,CAAC,CAAC;IACvC,MAAM,OAAO,GAAgB,EAAE,CAAC;IAChC,OAAO,MAAM,CAAC,GAAG,GAAG,MAAM,CAAC,GAAG,EAAE,CAAC;QAC/B,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;QAC5B,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;YACpB,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QACnD,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,CAAC;AACrB,CAAC;AAED,SAAS,SAAS,CAAC,MAAoB,EAAE,MAAc;IACrD,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,GAAG,MAAM,CAAC;IAChC,IAAI,OAAO,GAAG,EAAE,CAAC;IACjB,IAAI,KAAK,GAAgC,IAAI,UAAU,EAAE,CAAC;IAC1D,OAAO,MAAM,CAAC,GAAG,GAAG,GAAG,EAAE,CAAC;QACxB,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;QAC5B,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;YACpB,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;QAC5B,CAAC;aAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3B,KAAK,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC;QACzB,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;AAC5B,CAAC"}

package/dist/src/options.d.ts

@@ -2,14 +2,12 @@ import type { Credential } from "./credential.js";
 import type { Attribute, AttributeLock, AttributeMap, AttributeMapLoad } from "./persistence.js";
 import type { RetryPolicy, StepClass, StepDurability, StepOptions } from "./step.js";
 import type { Channel, ChannelMap, ChannelMapLoad } from "./wait.js";
-/** Configures FlowService connectivity and default Flow routing. */
+/** Configures FlowService connectivity and bearer credentials. */
 export interface ClientOptions {
     /** Plaintext Dex gRPC target; defaults to `localhost:8801`. */
     readonly serverAddress?: string;
     /** Bearer token provider for every FlowService call; omitted sends no authorization metadata. */
     readonly credential?: Credential;
-    /** Worker endpoint advertised by `startFlow` unless a Flow overrides it; use `{ pull: true }` for pull Workers. */
-    readonly workerTarget?: WorkerTarget | PullWorkerTarget;
 }
 /**
  * Configures one durable Step completion wait.
@@ -151,8 +149,6 @@ export interface FlowConfig {
     readonly continueAsNewPageSizeBytes?: number;
     /** Default durability for later Step handler results. */
     readonly stepDurability?: StepDurability;
-    /** Worker endpoint used for later handler calls; use `{ pull: true }` for pull routing. */
-    readonly workerTarget?: WorkerTarget | PullWorkerTarget;
 }
 /**
  * Describes one Attribute value written atomically when a Flow starts.
@@ -387,18 +383,14 @@ export interface StopFlowOptions {
     readonly reason?: string;
 }
 /**
- * Configures Worker startup and either a listening endpoint or outbound pull streams.
+ * Configures Worker startup and outbound task streams.
  *
- * Set `pull: {}` to execute tasks without a listener. A pull Worker cannot set
- * `bindAddress` or `workerTarget`. See {@link PullWorkerOptions} for capacity and shutdown.
+ * Every Worker pulls tasks over an outbound connection to the Dex Server.
+ * See {@link PullWorkerOptions} for capacity and shutdown settings.
  */
 export interface WorkerOptions {
-    /** Enables outbound polling when supplied; omitted to listen for WorkerService calls. */
+    /** Task capacity and shutdown settings; omitted uses the defaults in {@link PullWorkerOptions}. */
     readonly pull?: PullWorkerOptions;
-    /** Local plaintext WorkerService listener; defaults to `127.0.0.1:8803` outside pull mode. */
-    readonly bindAddress?: string;
-    /** Endpoint advertised to Dex; derived from `bindAddress` when omitted. */
-    readonly workerTarget?: WorkerTarget;
     /** Dex FlowService target; defaults to `localhost:8801`. */
     readonly serverAddress?: string;
     /** Bearer token provider for startup, hydration, and pull streams; omitted sends no authorization metadata. */
@@ -409,14 +401,14 @@ export interface WorkerOptions {
 /**
  * Configures an outbound pull Worker.
  *
- * Pass this as `WorkerOptions.pull`, then advertise `worker.workerTarget` to a Client.
+ * Pass this as `WorkerOptions.pull` to customize task capacity and shutdown.
  * Each stream handles one task, while handlers on different streams can run concurrently.
  *
  * @example
  * ```ts
  * const worker = new Worker(registry, cache, { pull: { maxConcurrentTasks: 8 } });
  * await worker.start();
- * const client = new Client(registry, cache, { workerTarget: worker.workerTarget });
+ * const client = new Client(registry, cache);
  * try { await client.startFlow(flow, flowId); } finally { await client.close(); await worker.close(); }
  * ```
  */
@@ -430,7 +422,7 @@ export interface PullWorkerOptions {
      * Unset reserves one slot when resolved capacity is at least two, otherwise zero.
      * With the CPU-count default, Steps get one fewer slot than before. Set zero to opt out.
      * With one slot and no explicit reserve, start warns once that RPCs may wait behind Steps.
-     * Flows must stay responsive; Dex cannot prioritize synchronous RPCs like workflow engines prioritize reads.
+     * Flows must stay responsive because RPCs share Worker task capacity with Steps.
      * WaitFor and Execute tasks, including local attempts, are declined
      * when total busy handlers reach maxConcurrentTasks minus this reserve. RPCs can
      * use the full task limit, including API-direct and transactional RPCs. Requires an integer at least zero and below the task
@@ -441,57 +433,21 @@ export interface PullWorkerOptions {
      * then fall back according to their policy.
      * Declines emit a node:util debuglog message under dex:pull with the Flow type.
      * The pullReservedRpcDeclines counter increments; registration readiness is unaffected.
+     * A queue keeps one extra idle stream for 30 seconds after its last reserve decline.
+     * The Worker does not open it while all task slots are busy.
      * @example
      * ```ts
      * const pull: PullWorkerOptions = { maxConcurrentTasks: 8, reservedRpcTasks: 2 };
      * ```
      */
     readonly reservedRpcTasks?: number;
-    /** Waiting streams on the sticky queue and each Flow type queue; zero or omission uses one. Negative values are invalid. */
+    /** Waiting streams on each queue; zero or omission uses one. A queue keeps one more after a recent reserve decline. Use at least two for heavy Step backlogs. Negative values are invalid. */
     readonly idleStreamsPerQueue?: number;
     /** Process-unique Worker ID; defaults to host identity plus eight random base32 characters. Use a new ID after every restart. Values contain 1-63 ASCII letters, digits, dots, underscores, or hyphens and cannot equal a registered Flow type. */
     readonly appWorkerID?: string;
     /** Milliseconds allowed for graceful shutdown and busy Reconnect final-frame delivery; defaults to 30000. Requires a non-negative finite value. After shutdown expiry, Worker.close cancels active handlers and waits for them to return. */
     readonly stopDrainTimeoutMs?: number;
 }
-/**
- * Selects the listening endpoint used for Step and RPC work.
- *
- * Use this for a WorkerService listener. Use {@link PullWorkerTarget} for
- * outbound pull routing.
- *
- * @example
- * ```ts
- * const client = new Client(registry, cache, { workerTarget: { address: "worker.example:8803" } });
- * ```
- */
-export interface WorkerTarget {
-    /** Plaintext gRPC target; headless targets must use `host:port`. */
-    readonly address: string;
-    /** Whether Dex connects directly without service discovery. */
-    readonly headless?: boolean;
-}
-/**
- * Routes Step and RPC work through Dex task queues to an outbound pull Worker.
- *
- * Supply this target as a Client default, StartFlow configuration override, or
- * SubFlow configuration override. The Worker must have `WorkerOptions.pull` enabled.
- * Pull cannot include a nonempty address or enable headless routing.
- *
- * @example
- * ```ts
- * const client = new Client(registry, cache, { workerTarget: { pull: true } });
- * await client.startFlow(flow, flowId, input);
- * ```
- */
-export interface PullWorkerTarget {
-    /** Enables routing through Dex task queues. */
-    readonly pull: true;
-    /** Omit this field or use an empty string; pull Workers do not listen. */
-    readonly address?: "";
-    /** Omit this field or use false; headless routing requires a listener. */
-    readonly headless?: false;
-}
 /** Selects whether a visibility search includes earlier Continue-as-New runs. */
 export interface SearchFlowsOptions {
     /** Disable default exclusion while retaining every explicit query filter. Defaults to false. */

package/dist/src/options.js.map

@@ -1 +1 @@
-{"version":3,"file":"options.js","sourceRoot":"","sources":["../../src/options.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../../src/options.ts"],"names":[],"mappings":"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"}

package/dist/src/pull-registration.d.ts

@@ -23,7 +23,7 @@ export interface PullQueueRegistrationState {
 export interface PullRegistrationState {
     /** Latches after all queues register; false while a queue has a permanent error and no registered stream. */
     readonly isReady: boolean;
-    /** Queue snapshots in registration order; empty for a listening Worker. */
+    /** Queue snapshots in registration order, including the process queue and every registered Flow type. */
     readonly queues: readonly PullQueueRegistrationState[];
 }
 /** Optional cancellation and deadline for Worker.waitPullRegistered. */

package/dist/src/pull-worker.d.ts

@@ -7,6 +7,7 @@ export declare class PullWorker {
     private readonly dispatcher;
     private readonly options;
     private readonly onPermanentRejection;
+    private readonly reservePressureLingerMs;
     readonly appWorkerID: string;
     readonly registration: PullRegistration;
     private readonly client;
@@ -17,6 +18,8 @@ export declare class PullWorker {
     private readonly maxConcurrentTasks;
     private readonly reservedRpcTasks;
     private reservedRpcDeclineCount;
+    private readonly lastReserveDeclineMs;
+    private readonly reservePressureTimers;
     private hasWarnedRpcCapacity;
     private readonly idleStreamsPerQueue;
     private readonly stopDrainTimeoutMs;
@@ -26,20 +29,24 @@ export declare class PullWorker {
     private stopDeadlineMs;
     private hasLoggedUnsupportedServer;
     private busyTaskCount;
-    constructor(registry: Registry, dispatcher: WorkerDispatcher, serverAddress: string, options: PullWorkerOptions, credential?: Credential, onPermanentRejection?: () => void);
+    constructor(registry: Registry, dispatcher: WorkerDispatcher, serverAddress: string, options: PullWorkerOptions, credential?: Credential, onPermanentRejection?: () => void, reservePressureLingerMs?: number);
     get reservedRpcDeclines(): number;
     start(): void;
     close(): Promise<void>;
     private reconcile;
+    private desiredIdleStreamsPerQueue;
     private openStream;
     private handleFrame;
     private startTask;
+    private scheduleReservePressureExpiry;
+    private expireReservePressure;
     private unknownTaskReason;
     private rejectTask;
     private executeTask;
     private finishTask;
     private hasRegisteredIdleReplacements;
     private sendTaskFrame;
+    private stopKeepalive;
     private send;
     private disconnect;
     private onStreamClosed;

package/dist/src/pull-worker.js

@@ -16,10 +16,12 @@ import { workerErrorResponse } from "./grpc-status.js";
 import { PullRegistration } from "./pull-registration.js";
 import { sdkVersion } from "./sdk-version.generated.js";
 const debug = debuglog("dex:pull");
+const BUSY_PULL_STREAM_KEEPALIVE_MS = 20_000;
 export class PullWorker {
     dispatcher;
     options;
     onPermanentRejection;
+    reservePressureLingerMs;
     appWorkerID;
     registration;
     client;
@@ -30,6 +32,8 @@ export class PullWorker {
     maxConcurrentTasks;
     reservedRpcTasks;
     reservedRpcDeclineCount = 0;
+    lastReserveDeclineMs = new Map();
+    reservePressureTimers = new Map();
     hasWarnedRpcCapacity = false;
     idleStreamsPerQueue;
     stopDrainTimeoutMs;
@@ -39,10 +43,11 @@ export class PullWorker {
     stopDeadlineMs;
     hasLoggedUnsupportedServer = false;
     busyTaskCount = 0;
-    constructor(registry, dispatcher, serverAddress, options, credential, onPermanentRejection = () => { }) {
+    constructor(registry, dispatcher, serverAddress, options, credential, onPermanentRejection = () => { }, reservePressureLingerMs = 30_000) {
         this.dispatcher = dispatcher;
         this.options = options;
         this.onPermanentRejection = onPermanentRejection;
+        this.reservePressureLingerMs = reservePressureLingerMs;
         this.maxConcurrentTasks = positiveOption(options.maxConcurrentTasks, availableParallelism(), "maxConcurrentTasks");
         this.reservedRpcTasks = options.reservedRpcTasks ?? (this.maxConcurrentTasks >= 2 ? 1 : 0);
         if (!Number.isInteger(this.reservedRpcTasks) || this.reservedRpcTasks < 0 || this.reservedRpcTasks >= this.maxConcurrentTasks) {
@@ -84,6 +89,9 @@ export class PullWorker {
     async close() {
         const stopDeadlineMs = this.stopDeadlineMs ??= Date.now() + this.stopDrainTimeoutMs;
         this.isStopping = true;
+        for (const timer of this.reservePressureTimers.values())
+            clearTimeout(timer);
+        this.reservePressureTimers.clear();
         this.registration.stopped();
         for (const poll of this.streams) {
             poll.isDraining = true;
@@ -143,11 +151,13 @@ export class PullWorker {
                 if (poll.queue === queue && poll.task === undefined && !poll.isDraining)
                     idleCount++;
             }
-            while (idleCount < this.idleStreamsPerQueue) {
+            const desiredIdle = this.desiredIdleStreamsPerQueue(queue);
+            const creationTarget = this.busyTaskCount === this.maxConcurrentTasks ? this.idleStreamsPerQueue : desiredIdle;
+            while (idleCount < creationTarget) {
                 const poll = {
                     queue, stream: undefined, task: undefined, retryTimer: undefined,
-                    halfCloseTimer: undefined, halfClosePromise: undefined, resolveHalfClose: undefined,
-                    isRegistered: false, hasRecordedResult: false, supportsUnknownNameRejection: false, isDisconnected: false, isHalfClosed: false, isDraining: false, isRetiring: false,
+                    halfCloseTimer: undefined, keepaliveTimer: undefined, halfClosePromise: undefined, resolveHalfClose: undefined,
+                    isRegistered: false, hasRecordedResult: false, supportsUnknownNameRejection: false, isDisconnected: false, isHalfClosed: false, isFinalFrameSent: false, isDraining: false, isRetiring: false,
                     isReconnectRequested: false, hasRetriedRejectedToken: false,
                     backoffMs: 100, failure: undefined,
                 };
@@ -157,6 +167,11 @@ export class PullWorker {
             }
         }
     }
+    desiredIdleStreamsPerQueue(queue) {
+        const lastDeclineMs = this.lastReserveDeclineMs.get(queue);
+        return this.idleStreamsPerQueue + Number(this.reservedRpcTasks > 0 && lastDeclineMs !== undefined
+            && performance.now() - lastDeclineMs < this.reservePressureLingerMs);
+    }
     openStream(poll) {
         if (this.isStopping)
             return;
@@ -165,6 +180,7 @@ export class PullWorker {
         poll.supportsUnknownNameRejection = false;
         poll.isDisconnected = false;
         poll.isHalfClosed = false;
+        poll.isFinalFrameSent = false;
         poll.failure = undefined;
         poll.isDraining = false;
         poll.isReconnectRequested = false;
@@ -231,6 +247,8 @@ export class PullWorker {
                     poll.task.controller.abort();
                 break;
             case "ping":
+                if (poll.task !== undefined && poll.isFinalFrameSent)
+                    break;
                 try {
                     this.send(poll, { frame: { $case: "pong", value: {} } });
                 }
@@ -266,8 +284,14 @@ export class PullWorker {
         const isStepTask = task.request?.$case === "waitFor" || task.request?.$case === "execute";
         if (isStepTask && this.reservedRpcTasks > 0 && this.busyTaskCount >= this.maxConcurrentTasks - this.reservedRpcTasks && unknownReason === undefined) {
             this.reservedRpcDeclineCount++;
+            this.lastReserveDeclineMs.set(poll.queue, performance.now());
+            const existingTimer = this.reservePressureTimers.get(poll.queue);
+            if (existingTimer !== undefined)
+                clearTimeout(existingTimer);
+            this.scheduleReservePressureExpiry(poll.queue, this.reservePressureLingerMs);
             debug("decline Step task for reserved RPC capacity: %s", task.request?.value.flowType);
             this.rejectTask(poll, task.taskId, PollWorkerTaskRejectReason.POLL_WORKER_TASK_REJECT_REASON_NO_CAPACITY);
+            this.reconcile();
             return;
         }
         const controller = new AbortController();
@@ -275,12 +299,43 @@ export class PullWorker {
         const deadlineCancellation = deadlineMs === undefined
             ? undefined
             : new DeadlineCancellation(deadlineMs, controller);
+        poll.isFinalFrameSent = false;
+        poll.keepaliveTimer = setInterval(() => {
+            if (poll.isDisconnected || poll.isFinalFrameSent || poll.task === undefined)
+                return;
+            try {
+                this.send(poll, { frame: { $case: "pong", value: {} } });
+            }
+            catch (failure) {
+                console.error("send Worker keepalive Pong", failure);
+                this.disconnect(poll);
+            }
+        }, BUSY_PULL_STREAM_KEEPALIVE_MS);
+        poll.keepaliveTimer.unref();
         const completion = this.executeTask(poll, task, controller.signal).finally(() => this.finishTask(poll));
         poll.task = { id: task.taskId, controller, completion, deadlineCancellation };
         this.activeTasks.add(completion);
         this.busyTaskCount++;
         this.reconcile();
     }
+    scheduleReservePressureExpiry(queue, delayMs) {
+        const timer = setTimeout(() => this.expireReservePressure(queue), delayMs);
+        timer.unref();
+        this.reservePressureTimers.set(queue, timer);
+    }
+    expireReservePressure(queue) {
+        const lastDeclineMs = this.lastReserveDeclineMs.get(queue);
+        if (lastDeclineMs === undefined)
+            return;
+        const remainingMs = this.reservePressureLingerMs - (performance.now() - lastDeclineMs);
+        if (remainingMs > 0) {
+            this.scheduleReservePressureExpiry(queue, remainingMs);
+            return;
+        }
+        this.lastReserveDeclineMs.delete(queue);
+        this.reservePressureTimers.delete(queue);
+        this.reconcile();
+    }
     unknownTaskReason(task) {
         switch (task.request?.$case) {
             case "waitFor":
@@ -314,10 +369,11 @@ export class PullWorker {
         }
     }
     async executeTask(poll, task, signal) {
+        let emitter;
         try {
             switch (task.request?.$case) {
                 case "waitFor": {
-                    const emitter = new PullStepOutputEmitter(poll, task.taskId, "waitFor", (frame) => this.sendTaskFrame(poll, frame));
+                    emitter = new PullStepOutputEmitter(poll, task.taskId, "waitFor", signal, (frame) => this.sendTaskFrame(poll, frame));
                     const result = await this.dispatcher.invokeWaitFor(task.request.value, signal, emitter);
                     this.sendTaskFrame(poll, { taskId: task.taskId, output: {
                             $case: "waitFor", value: InvokeWaitForMethodOutput.create({ output: { $case: "result", value: result } }),
@@ -325,7 +381,7 @@ export class PullWorker {
                     break;
                 }
                 case "execute": {
-                    const emitter = new PullStepOutputEmitter(poll, task.taskId, "execute", (frame) => this.sendTaskFrame(poll, frame));
+                    emitter = new PullStepOutputEmitter(poll, task.taskId, "execute", signal, (frame) => this.sendTaskFrame(poll, frame));
                     const result = await this.dispatcher.invokeExecute(task.request.value, signal, emitter);
                     this.sendTaskFrame(poll, { taskId: task.taskId, output: {
                             $case: "execute", value: InvokeExecuteMethodOutput.create({ output: { $case: "result", value: result } }),
@@ -356,13 +412,18 @@ export class PullWorker {
                 }
             }
         }
+        finally {
+            emitter?.close();
+        }
     }
     finishTask(poll) {
+        this.stopKeepalive(poll);
         const task = poll.task;
         if (task === undefined)
             return;
         task.deadlineCancellation?.stop();
         poll.task = undefined;
+        poll.isFinalFrameSent = false;
         this.activeTasks.delete(task.completion);
         this.busyTaskCount--;
         if (!poll.isDisconnected && !poll.isDraining && this.hasRegisteredIdleReplacements(poll)) {
@@ -380,11 +441,22 @@ export class PullWorker {
     }
     hasRegisteredIdleReplacements(poll) {
         return [...this.streams].filter((candidate) => candidate !== poll && candidate.queue === poll.queue && candidate.isRegistered
-            && candidate.task === undefined && !candidate.isDraining && !candidate.isDisconnected).length >= this.idleStreamsPerQueue;
+            && candidate.task === undefined && !candidate.isDraining && !candidate.isDisconnected).length >= this.desiredIdleStreamsPerQueue(poll.queue);
     }
     sendTaskFrame(poll, frame) {
+        if (frame.output?.$case === "rpc" || frame.output?.$case === "workerError"
+            || frame.output?.$case === "waitFor" && frame.output.value.output?.$case === "result"
+            || frame.output?.$case === "execute" && frame.output.value.output?.$case === "result") {
+            this.stopKeepalive(poll);
+            poll.isFinalFrameSent = true;
+        }
         this.send(poll, { frame: { $case: "taskFrame", value: frame } });
     }
+    stopKeepalive(poll) {
+        if (poll.keepaliveTimer !== undefined)
+            clearInterval(poll.keepaliveTimer);
+        poll.keepaliveTimer = undefined;
+    }
     send(poll, request) {
         if (poll.isDisconnected || poll.stream === undefined) {
             throw new Error("Worker task stream is closed");
@@ -392,6 +464,7 @@ export class PullWorker {
         poll.stream.write(request);
     }
     disconnect(poll) {
+        this.stopKeepalive(poll);
         if (poll.isDisconnected)
             return;
         this.recordStreamResult(poll);
@@ -404,6 +477,7 @@ export class PullWorker {
             this.scheduleReconnect(poll);
     }
     onStreamClosed(poll) {
+        this.stopKeepalive(poll);
         if (poll.isHalfClosed) {
             this.completeHalfClose(poll);
             return;
@@ -417,6 +491,7 @@ export class PullWorker {
             this.scheduleReconnect(poll);
     }
     halfCloseStream(poll) {
+        this.stopKeepalive(poll);
         if (poll.isHalfClosed || poll.stream === undefined)
             return;
         poll.isDisconnected = true;
@@ -456,7 +531,7 @@ export class PullWorker {
         poll.stream = undefined;
         if (!this.isStopping) {
             const idleStreamCount = [...this.streams].filter((candidate) => candidate !== poll && candidate.queue === poll.queue && candidate.task === undefined && !candidate.isDraining).length;
-            if (poll.isRetiring || poll.isReconnectRequested && idleStreamCount >= this.idleStreamsPerQueue) {
+            if (poll.isRetiring || poll.isReconnectRequested && idleStreamCount >= this.desiredIdleStreamsPerQueue(poll.queue)) {
                 this.streams.delete(poll);
             }
             else {
@@ -535,13 +610,19 @@ class PullStepOutputEmitter {
     poll;
     taskID;
     method;
+    signal;
     sendFrame;
-    constructor(poll, taskID, method, sendFrame) {
+    isActive = true;
+    constructor(poll, taskID, method, signal, sendFrame) {
         this.poll = poll;
         this.taskID = taskID;
         this.method = method;
+        this.signal = signal;
         this.sendFrame = sendFrame;
     }
+    close() {
+        this.isActive = false;
+    }
     recordHeartbeat(value) {
         this.sendOutput({ $case: "heartbeat", value: { value } });
         return Promise.resolve();
@@ -550,6 +631,8 @@ class PullStepOutputEmitter {
         this.sendOutput({ $case: "streamWrite", value: write });
     }
     sendOutput(output) {
+        if (!this.isActive || this.signal.aborted)
+            throw new Error("Worker task is no longer active");
         if (this.poll.isDisconnected)
             throw new Error("Worker task stream is closed");
         const value = this.method === "waitFor"