@superdurable/dex 0.1.5 → 0.1.6

package/dist/src/subflow.js

@@ -0,0 +1,62 @@
+// Copyright (c) 2026 Super Durable, Inc.
+//
+// Licensed under the Super Durable Source License 1.0.
+// You may not use this file except in compliance with the License.
+// See the LICENSE file in the repository root.
+//
+// SPDX-License-Identifier: LicenseRef-Super-Durable-1.0
+import { InvocationContext } from "./invocation-context.js";
+/** Controls how a generated SubFlow Flow ID resolves an existing execution. */
+export const SubFlowReusePolicy = Object.freeze({
+    /** Attaches to a running execution or returns its existing terminal result. */
+    ATTACH: "attach",
+    /** Restarts abnormal executions, attaches while running, and returns completed results. */
+    RESTART_IF_PREVIOUS_EXITS_ABNORMALLY: "restartIfPreviousExitsAbnormally",
+    /** Replaces any different existing execution, including a running one. */
+    ALWAYS_RESTART: "alwaysRestart",
+});
+/** Creates durable SubFlow conditions and reads their Execute results. */
+export const SubFlow = Object.freeze({
+    /**
+     * Creates a condition that starts or reuses a registered Flow and awaits completion.
+     * @typeParam Input - Target starting Step input type.
+     * @param flow - Exact target Flow instance registered by the Worker.
+     * @param input - Input accepted by its starting Step.
+     * @param options - Optional timing, retry, Attribute, configuration, reuse, and ID settings.
+     * @returns A durable SubFlow condition accepted by Wait factories.
+     */
+    run(flow, input, options = {}) {
+        return Object.freeze({
+            kind: "subFlow",
+            subFlow: flow,
+            subFlowInput: input,
+            subFlowOptions: options,
+            ...(options.conditionId === undefined ? {} : { conditionId: options.conditionId }),
+        });
+    },
+    /**
+     * Returns one stable-indexed SubFlow result during Step execute.
+     * @param context - Current Dex Execute context.
+     * @param index - Zero-based SubFlow order; defaults to zero.
+     * @returns A terminal result or an AnyOf loser's running snapshot.
+     */
+    getConditionResults(context, index = 0) {
+        return invocation(context).subFlowResult(index);
+    },
+    /**
+     * Returns one generated SubFlow Flow ID during Step execute.
+     * @param context - Current Dex Execute context.
+     * @param index - Zero-based SubFlow order; defaults to zero.
+     * @returns An addressable Flow ID suitable for `Client.stopFlow`.
+     */
+    getFlowId(context, index = 0) {
+        return invocation(context).subFlowId(index);
+    },
+});
+function invocation(context) {
+    if (!(context instanceof InvocationContext)) {
+        throw new TypeError("SubFlow access requires a Dex invocation Context");
+    }
+    return context;
+}
+//# sourceMappingURL=subflow.js.map

package/dist/src/subflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subflow.js","sourceRoot":"","sources":["../../src/subflow.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,EAAE;AACF,uDAAuD;AACvD,mEAAmE;AACnE,+CAA+C;AAC/C,EAAE;AACF,wDAAwD;AAKxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAK5D,+EAA+E;AAC/E,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,CAAC;IAC9C,+EAA+E;IAC/E,MAAM,EAAE,QAAQ;IAChB,2FAA2F;IAC3F,oCAAoC,EAAE,kCAAkC;IACxE,0EAA0E;IAC1E,cAAc,EAAE,eAAe;CACvB,CAAC,CAAC;AA0BZ,0EAA0E;AAC1E,MAAM,CAAC,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC;IACnC;;;;;;;OAOG;IACH,GAAG,CAAQ,IAAiB,EAAE,KAAY,EAAE,UAA0B,EAAE;QACtE,OAAO,MAAM,CAAC,MAAM,CAAC;YACnB,IAAI,EAAE,SAAkB;YACxB,OAAO,EAAE,IAAI;YACb,YAAY,EAAE,KAAK;YACnB,cAAc,EAAE,OAAO;YACvB,GAAG,CAAC,OAAO,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC;SACnF,CAAC,CAAC;IACL,CAAC;IACD;;;;;OAKG;IACH,mBAAmB,CAAC,OAAgB,EAAE,KAAK,GAAG,CAAC;QAC7C,OAAO,UAAU,CAAC,OAAO,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;IAClD,CAAC;IACD;;;;;OAKG;IACH,SAAS,CAAC,OAAgB,EAAE,KAAK,GAAG,CAAC;QACnC,OAAO,UAAU,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC9C,CAAC;CACF,CAAC,CAAC;AAEH,SAAS,UAAU,CAAC,OAAgB;IAClC,IAAI,CAAC,CAAC,OAAO,YAAY,iBAAiB,CAAC,EAAE,CAAC;QAC5C,MAAM,IAAI,SAAS,CAAC,kDAAkD,CAAC,CAAC;IAC1E,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/src/wait.d.ts

@@ -1,9 +1,11 @@
 import type { Codec } from "./codec.js";
 import type { Context } from "./context.js";
-/** Describes one durable Timer or Channel readiness condition. */
+import type { Flow } from "./flow.js";
+import type { SubFlowOptions } from "./subflow.js";
+/** Describes one durable Timer, Channel, or SubFlow readiness condition. */
 export interface Condition {
     /** Condition family interpreted by Dex. */
-    readonly kind: "timer" | "channel";
+    readonly kind: "timer" | "channel" | "subFlow";
     /** Optional stable ID unique within the Wait tree. */
     readonly conditionId?: string;
     /** Timer delay in non-negative milliseconds. */
@@ -16,6 +18,12 @@ export interface Condition {
     readonly atLeast?: number;
     /** Inclusive upper queued-value bound. */
     readonly atMost?: number;
+    /** Exact registered Flow instance targeted by a SubFlow condition. */
+    readonly subFlow?: Flow<any>;
+    /** Starting Step input for a SubFlow condition. */
+    readonly subFlowInput?: unknown;
+    /** Start, reuse, and condition options for a SubFlow condition. */
+    readonly subFlowOptions?: SubFlowOptions;
 }
 /** Groups Conditions that must become ready together. */
 export interface ConditionCombination {

package/dist/src/wait.js.map

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

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

@@ -5,9 +5,10 @@ export declare class WorkerDispatcher {
     private readonly registry;
     private readonly hydrator;
     constructor(registry: Registry, hydrator: ValueHydrator);
-    invokeWaitFor(original: InvokeWaitForMethodRequest): Promise<InvokeWaitForMethodResponse>;
-    invokeExecute(original: InvokeExecuteMethodRequest): Promise<InvokeExecuteMethodResponse>;
-    invokeRPC(original: InvokeWorkerRPCRequest): Promise<InvokeWorkerRPCResponse>;
+    invokeWaitFor(original: InvokeWaitForMethodRequest, cancellationSignal?: AbortSignal): Promise<InvokeWaitForMethodResponse>;
+    invokeExecute(original: InvokeExecuteMethodRequest, cancellationSignal?: AbortSignal): Promise<InvokeExecuteMethodResponse>;
+    private invokeTimeoutHandler;
+    invokeRPC(original: InvokeWorkerRPCRequest, cancellationSignal?: AbortSignal): Promise<InvokeWorkerRPCResponse>;
     private hydrateWaitFor;
     private hydrateExecute;
     private hydrateRPC;

package/dist/src/worker-dispatcher.js

@@ -5,12 +5,17 @@
 // See the LICENSE file in the repository root.
 //
 // SPDX-License-Identifier: LicenseRef-Super-Durable-1.0
-import { ChannelCondition, CloseDecision, CloseDecisionType, ConditionCombination as ProtoConditionCombination, ExecuteMethodFailurePolicy, InvokeExecuteMethodResponse, InvokeWaitForMethodResponse, InvokeWorkerRPCResponse, StepDecision as ProtoStepDecision, StepMovement as ProtoStepMovement, StepOptions as ProtoStepOptions, TimerCondition, WaitForMethodFailurePolicy, WaitingCondition, WaitingConditionType, } from "./gen/dex.js";
+import { ChannelCondition, CloseDecision, CloseDecisionType, ConditionCombination as ProtoConditionCombination, ExecuteMethodFailurePolicy, InvokeExecuteMethodResponse, InvokeWaitForMethodResponse, InvokeWorkerRPCResponse, StepDecision as ProtoStepDecision, StepMovement as ProtoStepMovement, StepOptions as ProtoStepOptions, TimerCondition, SubFlowCondition as ProtoSubFlowCondition, SubFlowOptions as ProtoSubFlowOptions, SubFlowReusePolicy as ProtoSubFlowReusePolicy, FlowRetryPolicy, FlowTimeoutPolicy as ProtoFlowTimeoutPolicy, FlowConfig as ProtoFlowConfig, ActiveStepSearchMode as ProtoActiveStepSearchMode, StepDurability as ProtoStepDurability, IndexType as ProtoIndexType, WaitForMethodFailurePolicy, WaitingCondition, WaitingConditionType, } from "./gen/dex.js";
 import { InvalidStepResultError, ValueMappingError } from "./errors.js";
-import { registeredFlowByName, registeredRPCByName, registeredStep, } from "./flow.js";
+import { registeredFlowByName, registeredFlow, registeredRPCByName, registeredStep, } from "./flow.js";
 import { InvocationContext } from "./invocation-context.js";
+import { AttributeMap, IndexType } from "./persistence.js";
+import { mapAttributeStoreName, mapAttributeStoreSync } from "./attribute-store-sync.js";
+import { ActiveStepSearchMode, FlowTimeoutPolicy } from "./options.js";
+import { SubFlowReusePolicy } from "./subflow.js";
 import { decodeValue, encodeUnknown, encodeValue, } from "./value-mapper.js";
 import { Channel, ChannelMap } from "./wait.js";
+const timeoutHandlerStepType = "sys:timeout_handler";
 export class WorkerDispatcher {
     registry;
     hydrator;
@@ -18,11 +23,12 @@ export class WorkerDispatcher {
         this.registry = registry;
         this.hydrator = hydrator;
     }
-    async invokeWaitFor(original) {
+    async invokeWaitFor(original, cancellationSignal = new AbortController().signal) {
         const request = await this.hydrateWaitFor(original);
+        cancellationSignal.throwIfAborted();
         const flow = registeredFlowByName(this.registry, request.flowType);
         const step = registeredStep(flow, request.stepType);
-        const context = new InvocationContext("waitFor", flow, request.context, request.attributes);
+        const context = new InvocationContext("waitFor", flow, request.context, request.attributes, [], undefined, {}, cancellationSignal);
         const input = decodeValue(step.step.inputCodec, requireValue(request.stepInput, "Step input"));
         if (step.step.waitFor === undefined) {
             throw new TypeError(`Step ${step.name} does not implement waitFor`);
@@ -31,7 +37,7 @@ export class WorkerDispatcher {
         try {
             return InvokeWaitForMethodResponse.create({
                 upsertAttributes: [...context.getAttributeWrites()],
-                waitingCondition: mapWait(flow, wait),
+                waitingCondition: mapWait(this.registry, flow, wait),
                 upsertStepExeLocals: [...context.getLocalWrites()],
                 recordEvents: [...context.getEvents()],
                 publishToChannel: [...context.getPublications()],
@@ -41,11 +47,15 @@ export class WorkerDispatcher {
             throw invalidStepResult(flow.name, step.name, "waitFor", failure);
         }
     }
-    async invokeExecute(original) {
+    async invokeExecute(original, cancellationSignal = new AbortController().signal) {
         const request = await this.hydrateExecute(original);
+        cancellationSignal.throwIfAborted();
         const flow = registeredFlowByName(this.registry, request.flowType);
+        if (request.stepType === timeoutHandlerStepType) {
+            return this.invokeTimeoutHandler(request, flow, cancellationSignal);
+        }
         const step = registeredStep(flow, request.stepType);
-        const context = new InvocationContext("execute", flow, request.context, request.attributes, request.stepExeLocals, request.conditionResults);
+        const context = new InvocationContext("execute", flow, request.context, request.attributes, request.stepExeLocals, request.conditionResults, {}, cancellationSignal);
         const input = decodeValue(step.step.inputCodec, requireValue(request.stepInput, "Step input"));
         const decision = await step.step.execute(context, input);
         try {
@@ -61,11 +71,34 @@ export class WorkerDispatcher {
             throw invalidStepResult(flow.name, step.name, "execute", failure);
         }
     }
-    async invokeRPC(original) {
+    async invokeTimeoutHandler(request, flow, cancellationSignal) {
+        try {
+            if (request.stepInput !== undefined) {
+                throw new TypeError("timeout handler input must be absent");
+            }
+            if (flow.flow.handleTimeout === undefined) {
+                throw new TypeError(`Flow ${flow.name} does not implement handleTimeout`);
+            }
+            const context = new InvocationContext("execute", flow, request.context, request.attributes, request.stepExeLocals, request.conditionResults, {}, cancellationSignal);
+            const decision = await flow.flow.handleTimeout(context);
+            return InvokeExecuteMethodResponse.create({
+                stepDecision: mapDecision(flow, decision),
+                upsertAttributes: [...context.getAttributeWrites()],
+                recordEvents: [...context.getEvents()],
+                upsertStepExeLocals: [...context.getLocalWrites()],
+                publishToChannel: [...context.getPublications()],
+            });
+        }
+        catch (failure) {
+            throw invalidStepResult(flow.name, timeoutHandlerStepType, "execute", failure);
+        }
+    }
+    async invokeRPC(original, cancellationSignal = new AbortController().signal) {
         const request = await this.hydrateRPC(original);
+        cancellationSignal.throwIfAborted();
         const flow = registeredFlowByName(this.registry, request.flowType);
         const rpc = registeredRPCByName(flow, request.rpcName);
-        const context = new InvocationContext("rpc", flow, request.context, request.attributes, [], undefined, request.channelInfos);
+        const context = new InvocationContext("rpc", flow, request.context, request.attributes, [], undefined, request.channelInfos, cancellationSignal);
         const returned = await invokeRPC(flow, rpc, context, request.input);
         try {
             const result = rpcResult(rpc, returned);
@@ -73,9 +106,7 @@ export class WorkerDispatcher {
                 output: rpc.options.outputCodec === undefined
                     ? encodeUnknown(undefined)
                     : encodeValue(rpc.options.outputCodec, result?.output),
-                stepDecision: result?.nextSteps === undefined || result.nextSteps.length === 0
-                    ? undefined
-                    : ProtoStepDecision.create({ nextSteps: mapMovements(flow, result.nextSteps) }),
+                stepDecision: rpcDecision(flow, result),
                 upsertAttributes: [...context.getAttributeWrites()],
                 recordEvents: [...context.getEvents()],
                 publishToChannel: [...context.getPublications()],
@@ -98,17 +129,26 @@ export class WorkerDispatcher {
     }
     async hydrateExecute(request) {
         const channelValues = request.conditionResults?.channelResults.flatMap((result) => result.values) ?? [];
+        const subFlowValues = request.conditionResults?.subFlowResults.flatMap((result) => result.results.map((completion) => completion.completedStepOutput)) ?? [];
+        const hasInput = request.stepInput !== undefined;
         const values = await this.hydrator.hydrateAll([
-            request.stepInput,
+            ...(hasInput ? [request.stepInput] : []),
             ...request.attributes.map((entry) => entry.value),
             ...request.stepExeLocals.map((entry) => entry.value),
             ...channelValues,
+            ...subFlowValues,
         ]);
-        let offset = 1;
+        let offset = hasInput ? 1 : 0;
         const attributes = replaceEntryValues(request.attributes, values.slice(offset, (offset += request.attributes.length)));
         const stepExeLocals = replaceEntryValues(request.stepExeLocals, values.slice(offset, (offset += request.stepExeLocals.length)));
         const conditionResults = replaceConditionValues(request.conditionResults, values.slice(offset));
-        return { ...request, attributes, stepExeLocals, conditionResults };
+        return {
+            ...request,
+            stepInput: hasInput ? values[0] : undefined,
+            attributes,
+            stepExeLocals,
+            conditionResults,
+        };
     }
     async hydrateRPC(request) {
         const hasInput = request.input !== undefined;
@@ -141,14 +181,14 @@ function rpcResult(rpc, returned) {
     }
     return returned;
 }
-function mapWait(flow, wait) {
+function mapWait(registry, flow, wait) {
     if (wait === undefined) {
         throw new TypeError("waitFor returned undefined");
     }
     if (wait.kind === "skipImmediately") {
         return undefined;
     }
-    const mapper = new ConditionMapper(flow);
+    const mapper = new ConditionMapper(registry, flow);
     let waitingConditionType;
     const combinations = [];
     if (wait.kind === "allOf" || wait.kind === "anyOf") {
@@ -176,6 +216,7 @@ function mapWait(flow, wait) {
         waitingConditionType,
         timerConditions: mapper.timers,
         channelConditions: mapper.channels,
+        subFlowConditions: mapper.subFlows,
         conditionCombinations: combinations,
     });
 }
@@ -187,14 +228,14 @@ function mapDecision(flow, decision) {
         if (decision.movements.length === 0) {
             throw new TypeError("goToMulti requires a movement");
         }
-        return ProtoStepDecision.create({ nextSteps: mapMovements(flow, decision.movements) });
+        return withCancellationSelection(flow, decision, ProtoStepDecision.create({ nextSteps: mapMovements(flow, decision.movements) }));
     }
     if (decision.kind === "deadEnd") {
-        return ProtoStepDecision.create({
+        return withCancellationSelection(flow, decision, ProtoStepDecision.create({
             closeDecision: CloseDecision.create({
                 closeDecisionType: CloseDecisionType.CLOSE_DECISION_TYPE_DEAD_END,
             }),
-        });
+        }));
     }
     if (decision.kind === "forceCompleteIfChannelsEmpty") {
         const channels = decision.channels.map((channel) => {
@@ -203,26 +244,64 @@ function mapDecision(flow, decision) {
             }
             return channel.name;
         });
-        return ProtoStepDecision.create({
+        return withCancellationSelection(flow, decision, ProtoStepDecision.create({
             nextSteps: [mapMovement(flow, decision.fallback)],
             closeDecision: CloseDecision.create({
                 closeDecisionType: CloseDecisionType.CLOSE_DECISION_TYPE_FORCE_COMPLETE_ON_CHANNELS_EMPTY,
                 conditionalChannelNames: channels,
                 closeInput: encodeUnknown(decision.output),
             }),
-        });
+        }));
     }
     const closeTypes = {
         gracefulComplete: CloseDecisionType.CLOSE_DECISION_TYPE_GRACEFUL_COMPLETE,
         forceComplete: CloseDecisionType.CLOSE_DECISION_TYPE_FORCE_COMPLETE,
         forceFail: CloseDecisionType.CLOSE_DECISION_TYPE_FORCE_FAIL,
     };
-    return ProtoStepDecision.create({
+    const closeInput = decision.kind === "forceFail"
+        ? encodeUnknown(decision.reason)
+        : decision.output === undefined
+            ? undefined
+            : encodeUnknown(decision.output);
+    return withCancellationSelection(flow, decision, ProtoStepDecision.create({
         closeDecision: CloseDecision.create({
             closeDecisionType: closeTypes[decision.kind],
-            closeInput: encodeUnknown(decision.kind === "forceFail" ? decision.reason : decision.output),
+            closeInput,
         }),
-    });
+    }));
+}
+function withCancellationSelection(flow, decision, mapped) {
+    mapped.cancelStepTypes = mapCancellationSteps(flow, decision.cancelingSteps);
+    const globalTypes = new Set(mapped.cancelStepTypes);
+    mapped.cancelSiblingStepTypes = mapCancellationSteps(flow, decision.cancelingSiblingSteps).filter((stepType) => !globalTypes.has(stepType));
+    return mapped;
+}
+function mapCancellationSteps(flow, steps) {
+    const stepTypes = [];
+    const seen = new Set();
+    for (const step of steps ?? []) {
+        const target = flow.steps.find((candidate) => candidate.step === step);
+        if (target === undefined) {
+            throw new TypeError("cancellation Step must belong to the Flow");
+        }
+        if (seen.has(target.name)) {
+            continue;
+        }
+        seen.add(target.name);
+        stepTypes.push(target.name);
+    }
+    return stepTypes;
+}
+function rpcDecision(flow, result) {
+    if (result === undefined) {
+        return undefined;
+    }
+    const nextSteps = mapMovements(flow, result.nextSteps ?? []);
+    const cancelStepTypes = mapCancellationSteps(flow, result.cancelingSteps);
+    if (nextSteps.length === 0 && cancelStepTypes.length === 0) {
+        return undefined;
+    }
+    return ProtoStepDecision.create({ nextSteps, cancelStepTypes });
 }
 function mapMovements(flow, movements) {
     return movements.map((movement) => mapMovement(flow, movement));
@@ -250,6 +329,7 @@ function mapStepOptions(flow, options, skipWaitFor) {
     return ProtoStepOptions.create({
         waitForTimeoutSeconds: seconds(options?.waitForMethodTimeoutMs),
         executeTimeoutSeconds: seconds(options?.executeMethodTimeoutMs),
+        heartbeatTimeoutSeconds: heartbeatSeconds(options?.heartbeatTimeoutMs),
         waitForRetryPolicy: mapRetry(options?.waitForRetry),
         executeRetryPolicy: mapRetry(options?.executeRetry),
         waitForFailurePolicy: options?.waitForFailure === "proceed"
@@ -296,12 +376,15 @@ function mapRetry(retry) {
     };
 }
 class ConditionMapper {
+    registry;
     flow;
     timers = [];
     channels = [];
+    subFlows = [];
     ids = new Map();
     used = new Set();
-    constructor(flow) {
+    constructor(registry, flow) {
+        this.registry = registry;
         this.flow = flow;
     }
     add(condition, idRequired) {
@@ -328,7 +411,7 @@ class ConditionMapper {
                 durationSeconds: BigInt(seconds(condition.durationMs)),
             }));
         }
-        else {
+        else if (condition.kind === "channel") {
             const registered = this.flow.persistence.get(condition.channelName ?? "");
             if (!(registered instanceof Channel) && !(registered instanceof ChannelMap)) {
                 throw new TypeError(`Channel is not registered: ${condition.channelName ?? ""}`);
@@ -343,10 +426,141 @@ class ConditionMapper {
                 atMost: condition.atMost,
             }));
         }
+        else {
+            const targetFlow = condition.subFlow;
+            if (targetFlow === undefined) {
+                throw new TypeError("SubFlow requires a target Flow");
+            }
+            const target = registeredFlow(this.registry, targetFlow);
+            const start = target.startStep;
+            if (start === undefined) {
+                throw new TypeError(`SubFlow ${target.name} has no starting Step`);
+            }
+            const options = condition.subFlowOptions ?? {};
+            this.subFlows.push(ProtoSubFlowCondition.create({
+                conditionId: id,
+                subFlowType: target.name,
+                startStepType: start.name,
+                stepInput: encodeValue(start.step.inputCodec, condition.subFlowInput),
+                stepOptions: mapStepOptions(target, start.step.getStepOptions?.(), start.step.waitFor === undefined),
+                options: mapSubFlowOptions(target, options),
+                subFlowIndex: this.subFlows.length,
+            }));
+        }
         this.ids.set(condition, id);
         return id;
     }
 }
+function mapSubFlowOptions(target, options) {
+    const timeoutSeconds = seconds(options.timeoutMs);
+    const attributes = (options.attributes ?? []).map((initial) => {
+        if (target.persistence.get(initial.attribute.name) !== initial.attribute) {
+            throw new TypeError(`SubFlow Attribute does not belong to ${target.name}`);
+        }
+        let key;
+        if (initial.attribute instanceof AttributeMap) {
+            key = physicalName(initial.attribute.name, initial.instance);
+        }
+        else {
+            if (initial.instance !== undefined) {
+                throw new TypeError("static Attribute cannot use an instance");
+            }
+            key = initial.attribute.name;
+        }
+        return {
+            key,
+            value: encodeValue(initial.attribute.codec, initial.value),
+            indexConfig: mapIndex(initial.attribute.index),
+            syncConfig: mapAttributeStoreSync(initial.attribute),
+        };
+    });
+    const reusePolicy = options.reusePolicy === SubFlowReusePolicy.ATTACH
+        ? ProtoSubFlowReusePolicy.SUB_FLOW_REUSE_POLICY_ATTACH
+        : options.reusePolicy === SubFlowReusePolicy.ALWAYS_RESTART
+            ? ProtoSubFlowReusePolicy.SUB_FLOW_REUSE_POLICY_ALWAYS_RESTART
+            : ProtoSubFlowReusePolicy.SUB_FLOW_REUSE_POLICY_RESTART_IF_PREVIOUS_EXITS_ABNORMALLY;
+    return ProtoSubFlowOptions.create({
+        reusePolicy,
+        flowTimeoutSeconds: timeoutSeconds,
+        flowTimeoutPolicy: resolveFlowTimeoutPolicy(target, timeoutSeconds, options.timeoutPolicy),
+        flowStartDelaySeconds: seconds(options.startDelayMs),
+        retryPolicy: mapFlowRetry(options.retryPolicy),
+        attributes,
+        flowConfigOverride: mapSubFlowConfig(options.configOverride),
+    });
+}
+function resolveFlowTimeoutPolicy(flow, timeoutSeconds, policy) {
+    const requested = policy ?? FlowTimeoutPolicy.DEFAULT;
+    if (timeoutSeconds === 0) {
+        if (requested !== FlowTimeoutPolicy.DEFAULT) {
+            throw new RangeError("Flow timeout policy requires a positive timeout");
+        }
+        return ProtoFlowTimeoutPolicy.FLOW_TIMEOUT_POLICY_UNSPECIFIED;
+    }
+    const resolved = requested === FlowTimeoutPolicy.DEFAULT
+        ? flow.hasTimeoutHandler
+            ? FlowTimeoutPolicy.HANDLER
+            : FlowTimeoutPolicy.FAIL
+        : requested;
+    if (resolved === FlowTimeoutPolicy.HANDLER && !flow.hasTimeoutHandler) {
+        throw new TypeError(`Flow ${flow.name} does not implement handleTimeout`);
+    }
+    return {
+        [FlowTimeoutPolicy.DEFAULT]: ProtoFlowTimeoutPolicy.FLOW_TIMEOUT_POLICY_UNSPECIFIED,
+        [FlowTimeoutPolicy.FAIL]: ProtoFlowTimeoutPolicy.FLOW_TIMEOUT_POLICY_FAIL,
+        [FlowTimeoutPolicy.CANCEL]: ProtoFlowTimeoutPolicy.FLOW_TIMEOUT_POLICY_CANCEL,
+        [FlowTimeoutPolicy.HANDLER]: ProtoFlowTimeoutPolicy.FLOW_TIMEOUT_POLICY_HANDLER,
+    }[resolved];
+}
+function mapFlowRetry(retry) {
+    if (retry === undefined)
+        return undefined;
+    return FlowRetryPolicy.create({
+        initialIntervalSeconds: seconds(retry.initialIntervalMs),
+        backoffCoefficient: retry.backoffCoefficient ?? 0,
+        maximumIntervalSeconds: seconds(retry.maximumIntervalMs),
+        maximumAttempts: retry.maximumAttempts ?? 0,
+    });
+}
+function mapSubFlowConfig(config) {
+    if (config === undefined)
+        return undefined;
+    return ProtoFlowConfig.create({
+        activeStepSearchMode: config.activeStepSearchMode === ActiveStepSearchMode.ALL
+            ? ProtoActiveStepSearchMode.ACTIVE_STEP_SEARCH_MODE_ENABLED_FOR_ALL
+            : config.activeStepSearchMode === undefined
+                ? undefined
+                : ProtoActiveStepSearchMode.ACTIVE_STEP_SEARCH_MODE_UNSPECIFIED,
+        attributeSyncConfigName: mapAttributeStoreName(config),
+        continueAsNewThreshold: config.continueAsNewThreshold,
+        continueAsNewPageSizeInBytes: config.continueAsNewPageSizeBytes,
+        stepDurability: config.stepDurability === "sync"
+            ? ProtoStepDurability.STEP_DURABILITY_SYNC
+            : config.stepDurability === "async"
+                ? ProtoStepDurability.STEP_DURABILITY_ASYNC
+                : undefined,
+        workerTarget: config.workerTarget === undefined
+            ? undefined
+            : {
+                address: config.workerTarget.address,
+                isHeadlessAddress: config.workerTarget.headless ?? false,
+            },
+    });
+}
+function mapIndex(index) {
+    if (index === undefined)
+        return undefined;
+    const types = {
+        [IndexType.KEYWORD]: ProtoIndexType.INDEX_TYPE_KEYWORD,
+        [IndexType.FULL_TEXT]: ProtoIndexType.INDEX_TYPE_TEXT,
+        [IndexType.KEYWORD_ARRAY]: ProtoIndexType.INDEX_TYPE_KEYWORD_ARRAY,
+        [IndexType.INT]: ProtoIndexType.INDEX_TYPE_INT,
+        [IndexType.DOUBLE]: ProtoIndexType.INDEX_TYPE_DOUBLE,
+        [IndexType.BOOL]: ProtoIndexType.INDEX_TYPE_BOOL,
+        [IndexType.DATETIME]: ProtoIndexType.INDEX_TYPE_DATETIME,
+    };
+    return { enable: true, type: types[index.type], indexKey: index.indexKey ?? "" };
+}
 function replaceEntryValues(entries, values) {
     if (entries.length !== values.length) {
         throw new TypeError("hydrated entry count does not match request");
@@ -367,10 +581,17 @@ function replaceConditionValues(results, values) {
         offset = next;
         return replaced;
     });
+    const subFlowResults = results.subFlowResults.map((result) => ({
+        ...result,
+        results: result.results.map((completion) => ({
+            ...completion,
+            completedStepOutput: values[offset++],
+        })),
+    }));
     if (offset !== values.length) {
         throw new TypeError("hydrated Condition value count does not match request");
     }
-    return { ...results, channelResults };
+    return { ...results, channelResults, subFlowResults };
 }
 function requireValue(value, kind) {
     if (value?.kind === undefined) {
@@ -393,6 +614,13 @@ function seconds(milliseconds) {
     }
     return milliseconds / 1_000;
 }
+function heartbeatSeconds(milliseconds) {
+    const value = seconds(milliseconds);
+    if (value > 2_147_483_647) {
+        throw new RangeError("heartbeat timeout exceeds int32 seconds");
+    }
+    return value;
+}
 function invalidStepResult(flowType, stepType, method, failure) {
     if (failure instanceof ValueMappingError) {
         return failure;