@getuserfeedback/protocol 3.1.2 → 3.1.4

package/dist/host/flow-command-handle-controller.d.ts

@@ -0,0 +1,16 @@
+export type FlowCommandHandleController<THandleId extends string, TSettlement> = {
+    runCommand<TPayload>(buildPayload: (handleId: THandleId | undefined) => TPayload, dispatchAndWait: (payload: TPayload) => Promise<TSettlement>): Promise<TSettlement>;
+    getHandleId(): THandleId | undefined;
+    hasHandleId(handleId: string): boolean;
+    hasPendingCommands(): boolean;
+    subscribeHandle(subscriber: (handleId: THandleId) => void): () => void;
+    clearResolvedHandle(): THandleId | undefined;
+    reset(): void;
+};
+export type CreateFlowCommandHandleControllerOptions<THandleId extends string, TSettlement> = {
+    getHandleIdFromSettlement: (settlement: TSettlement) => THandleId | undefined;
+    isStaleHandleError: (error: unknown) => boolean;
+    onClearResolvedHandle?: (handleId: THandleId) => void;
+};
+export declare function createFlowCommandHandleController<THandleId extends string, TSettlement>({ getHandleIdFromSettlement, isStaleHandleError, onClearResolvedHandle, }: CreateFlowCommandHandleControllerOptions<THandleId, TSettlement>): FlowCommandHandleController<THandleId, TSettlement>;
+//# sourceMappingURL=flow-command-handle-controller.d.ts.map

package/dist/host/flow-command-handle-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow-command-handle-controller.d.ts","sourceRoot":"","sources":["../../src/host/flow-command-handle-controller.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,2BAA2B,CACtC,SAAS,SAAS,MAAM,EACxB,WAAW,IACR;IACH,UAAU,CAAC,QAAQ,EAClB,YAAY,EAAE,CAAC,QAAQ,EAAE,SAAS,GAAG,SAAS,KAAK,QAAQ,EAC3D,eAAe,EAAE,CAAC,OAAO,EAAE,QAAQ,KAAK,OAAO,CAAC,WAAW,CAAC,GAC1D,OAAO,CAAC,WAAW,CAAC,CAAC;IACxB,WAAW,IAAI,SAAS,GAAG,SAAS,CAAC;IACrC,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IACvC,kBAAkB,IAAI,OAAO,CAAC;IAC9B,eAAe,CAAC,UAAU,EAAE,CAAC,QAAQ,EAAE,SAAS,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IACvE,mBAAmB,IAAI,SAAS,GAAG,SAAS,CAAC;IAC7C,KAAK,IAAI,IAAI,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,wCAAwC,CACnD,SAAS,SAAS,MAAM,EACxB,WAAW,IACR;IACH,yBAAyB,EAAE,CAAC,UAAU,EAAE,WAAW,KAAK,SAAS,GAAG,SAAS,CAAC;IAC9E,kBAAkB,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;IAChD,qBAAqB,CAAC,EAAE,CAAC,QAAQ,EAAE,SAAS,KAAK,IAAI,CAAC;CACtD,CAAC;AAEF,wBAAgB,iCAAiC,CAChD,SAAS,SAAS,MAAM,EACxB,WAAW,EACV,EACD,yBAAyB,EACzB,kBAAkB,EAClB,qBAAqB,GACrB,EAAE,wCAAwC,CAC1C,SAAS,EACT,WAAW,CACX,GAAG,2BAA2B,CAAC,SAAS,EAAE,WAAW,CAAC,CA6CtD"}

package/dist/host/flow-command-handle-controller.js

@@ -0,0 +1,39 @@
+import { createLazyHandleClient, } from "./lazy-handle-client.js";
+export function createFlowCommandHandleController({ getHandleIdFromSettlement, isStaleHandleError, onClearResolvedHandle, }) {
+    const handleClient = createLazyHandleClient({
+        getHandleIdFromSettlement,
+    });
+    const clearResolvedHandle = () => {
+        const previousHandleId = handleClient.getHandleId();
+        if (!previousHandleId) {
+            return undefined;
+        }
+        handleClient.reset();
+        onClearResolvedHandle?.(previousHandleId);
+        return previousHandleId;
+    };
+    const reset = () => {
+        const previousHandleId = handleClient.getHandleId();
+        handleClient.reset();
+        if (previousHandleId) {
+            onClearResolvedHandle?.(previousHandleId);
+        }
+    };
+    const runCommand = async (buildPayload, dispatchAndWait) => {
+        return handleClient.runCommandWithRetry(buildPayload, dispatchAndWait, {
+            shouldRetry: isStaleHandleError,
+            onBeforeRetry: () => {
+                clearResolvedHandle();
+            },
+        });
+    };
+    return {
+        runCommand,
+        getHandleId: () => handleClient.getHandleId(),
+        hasHandleId: (handleId) => handleClient.getHandleId() === handleId,
+        hasPendingCommands: () => handleClient.hasPendingCommands(),
+        subscribeHandle: (subscriber) => handleClient.subscribeHandle(subscriber),
+        clearResolvedHandle,
+        reset,
+    };
+}

package/dist/host/index.d.ts

@@ -6,6 +6,7 @@ export * from "./command-envelope.js";
 export * from "./command-settlement.js";
 export * from "./constants.js";
 export * from "./external-id-argument-guards.js";
+export * from "./flow-command-handle-controller.js";
 export * from "./host-event-contract.js";
 export * from "./lazy-handle-client.js";
 export { createCommandRequestId } from "./request-id.js";

package/dist/host/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/host/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kCAAkC,CAAC;AACjD,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AACzD,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,oCAAoC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/host/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kCAAkC,CAAC;AACjD,cAAc,qCAAqC,CAAC;AACpD,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AACzD,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,oCAAoC,CAAC"}

package/dist/host/index.js

@@ -6,6 +6,7 @@ export * from "./command-envelope.js";
 export * from "./command-settlement.js";
 export * from "./constants.js";
 export * from "./external-id-argument-guards.js";
+export * from "./flow-command-handle-controller.js";
 export * from "./host-event-contract.js";
 export * from "./lazy-handle-client.js";
 export { createCommandRequestId } from "./request-id.js";

package/dist/host/lazy-handle-client.d.ts

@@ -8,7 +8,12 @@ type StageMap<TStage extends string> = {
 };
 export type LazyHandleClient<THandleId extends string, TSettlement, TStage extends string = LifecycleStage> = {
     runCommand<TPayload>(buildPayload: (handleId: THandleId | undefined) => TPayload, dispatchAndWait: (payload: TPayload) => Promise<TSettlement>): Promise<TSettlement>;
+    runCommandWithRetry<TPayload>(buildPayload: (handleId: THandleId | undefined) => TPayload, dispatchAndWait: (payload: TPayload) => Promise<TSettlement>, options: {
+        shouldRetry: (error: unknown) => boolean;
+        onBeforeRetry?: (error: unknown) => void;
+    }): Promise<TSettlement>;
     getHandleId(): THandleId | undefined;
+    hasPendingCommands(): boolean;
     subscribeHandle(subscriber: Subscriber<THandleId>): () => void;
     getStage(): TStage;
     setStage(stage: TStage): void;

package/dist/host/lazy-handle-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lazy-handle-client.d.ts","sourceRoot":"","sources":["../../src/host/lazy-handle-client.ts"],"names":[],"mappings":"AAAA,KAAK,UAAU,CAAC,SAAS,SAAS,MAAM,IAAI,CAAC,QAAQ,EAAE,SAAS,KAAK,IAAI,CAAC;AAC1E,KAAK,eAAe,CAAC,MAAM,SAAS,MAAM,IAAI,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;AAEtE,KAAK,cAAc,GAAG,eAAe,GAAG,OAAO,GAAG,aAAa,CAAC;AAChE,KAAK,QAAQ,CAAC,MAAM,SAAS,MAAM,IAAI;IACtC,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACpB,CAAC;AAQF,MAAM,MAAM,gBAAgB,CAC3B,SAAS,SAAS,MAAM,EACxB,WAAW,EACX,MAAM,SAAS,MAAM,GAAG,cAAc,IACnC;IACH,UAAU,CAAC,QAAQ,EAClB,YAAY,EAAE,CAAC,QAAQ,EAAE,SAAS,GAAG,SAAS,KAAK,QAAQ,EAC3D,eAAe,EAAE,CAAC,OAAO,EAAE,QAAQ,KAAK,OAAO,CAAC,WAAW,CAAC,GAC1D,OAAO,CAAC,WAAW,CAAC,CAAC;IACxB,WAAW,IAAI,SAAS,GAAG,SAAS,CAAC;IACrC,eAAe,CAAC,UAAU,EAAE,UAAU,CAAC,SAAS,CAAC,GAAG,MAAM,IAAI,CAAC;IAC/D,QAAQ,IAAI,MAAM,CAAC;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,cAAc,CAAC,UAAU,EAAE,eAAe,CAAC,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC;IAChE,KAAK,IAAI,IAAI,CAAC;IACd,UAAU,IAAI,IAAI,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,6BAA6B,CACxC,SAAS,SAAS,MAAM,EACxB,WAAW,EACX,MAAM,SAAS,MAAM,GAAG,cAAc,IACnC;IACH,yBAAyB,EAAE,CAAC,UAAU,EAAE,WAAW,KAAK,SAAS,GAAG,SAAS,CAAC;IAC9E,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,KAAK,oCAAoC,CACxC,SAAS,SAAS,MAAM,EACxB,WAAW,IACR;IACH,yBAAyB,EAAE,CAAC,UAAU,EAAE,WAAW,KAAK,SAAS,GAAG,SAAS,CAAC;IAC9E,YAAY,CAAC,EAAE,cAAc,CAAC;IAC9B,MAAM,CAAC,EAAE,SAAS,CAAC;CACnB,CAAC;AAEF,KAAK,mCAAmC,CACvC,SAAS,SAAS,MAAM,EACxB,WAAW,EACX,MAAM,SAAS,MAAM,IAClB;IACH,yBAAyB,EAAE,CAAC,UAAU,EAAE,WAAW,KAAK,SAAS,GAAG,SAAS,CAAC;IAC9E,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAuHF,wBAAgB,sBAAsB,CAAC,SAAS,SAAS,MAAM,EAAE,WAAW,EAC3E,OAAO,EAAE,oCAAoC,CAAC,SAAS,EAAE,WAAW,CAAC,GACnE,gBAAgB,CAAC,SAAS,EAAE,WAAW,EAAE,cAAc,CAAC,CAAC;AAC5D,wBAAgB,sBAAsB,CACrC,SAAS,SAAS,MAAM,EACxB,WAAW,EACX,MAAM,SAAS,MAAM,EAErB,OAAO,EAAE,mCAAmC,CAAC,SAAS,EAAE,WAAW,EAAE,MAAM,CAAC,GAC1E,gBAAgB,CAAC,SAAS,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC"}
+{"version":3,"file":"lazy-handle-client.d.ts","sourceRoot":"","sources":["../../src/host/lazy-handle-client.ts"],"names":[],"mappings":"AAAA,KAAK,UAAU,CAAC,SAAS,SAAS,MAAM,IAAI,CAAC,QAAQ,EAAE,SAAS,KAAK,IAAI,CAAC;AAC1E,KAAK,eAAe,CAAC,MAAM,SAAS,MAAM,IAAI,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;AAEtE,KAAK,cAAc,GAAG,eAAe,GAAG,OAAO,GAAG,aAAa,CAAC;AAChE,KAAK,QAAQ,CAAC,MAAM,SAAS,MAAM,IAAI;IACtC,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACpB,CAAC;AAQF,MAAM,MAAM,gBAAgB,CAC3B,SAAS,SAAS,MAAM,EACxB,WAAW,EACX,MAAM,SAAS,MAAM,GAAG,cAAc,IACnC;IACH,UAAU,CAAC,QAAQ,EAClB,YAAY,EAAE,CAAC,QAAQ,EAAE,SAAS,GAAG,SAAS,KAAK,QAAQ,EAC3D,eAAe,EAAE,CAAC,OAAO,EAAE,QAAQ,KAAK,OAAO,CAAC,WAAW,CAAC,GAC1D,OAAO,CAAC,WAAW,CAAC,CAAC;IACxB,mBAAmB,CAAC,QAAQ,EAC3B,YAAY,EAAE,CAAC,QAAQ,EAAE,SAAS,GAAG,SAAS,KAAK,QAAQ,EAC3D,eAAe,EAAE,CAAC,OAAO,EAAE,QAAQ,KAAK,OAAO,CAAC,WAAW,CAAC,EAC5D,OAAO,EAAE;QACR,WAAW,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;QACzC,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;KACzC,GACC,OAAO,CAAC,WAAW,CAAC,CAAC;IACxB,WAAW,IAAI,SAAS,GAAG,SAAS,CAAC;IACrC,kBAAkB,IAAI,OAAO,CAAC;IAC9B,eAAe,CAAC,UAAU,EAAE,UAAU,CAAC,SAAS,CAAC,GAAG,MAAM,IAAI,CAAC;IAC/D,QAAQ,IAAI,MAAM,CAAC;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,cAAc,CAAC,UAAU,EAAE,eAAe,CAAC,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC;IAChE,KAAK,IAAI,IAAI,CAAC;IACd,UAAU,IAAI,IAAI,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,6BAA6B,CACxC,SAAS,SAAS,MAAM,EACxB,WAAW,EACX,MAAM,SAAS,MAAM,GAAG,cAAc,IACnC;IACH,yBAAyB,EAAE,CAAC,UAAU,EAAE,WAAW,KAAK,SAAS,GAAG,SAAS,CAAC;IAC9E,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,KAAK,oCAAoC,CACxC,SAAS,SAAS,MAAM,EACxB,WAAW,IACR;IACH,yBAAyB,EAAE,CAAC,UAAU,EAAE,WAAW,KAAK,SAAS,GAAG,SAAS,CAAC;IAC9E,YAAY,CAAC,EAAE,cAAc,CAAC;IAC9B,MAAM,CAAC,EAAE,SAAS,CAAC;CACnB,CAAC;AAEF,KAAK,mCAAmC,CACvC,SAAS,SAAS,MAAM,EACxB,WAAW,EACX,MAAM,SAAS,MAAM,IAClB;IACH,yBAAyB,EAAE,CAAC,UAAU,EAAE,WAAW,KAAK,SAAS,GAAG,SAAS,CAAC;IAC9E,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AA0KF,wBAAgB,sBAAsB,CAAC,SAAS,SAAS,MAAM,EAAE,WAAW,EAC3E,OAAO,EAAE,oCAAoC,CAAC,SAAS,EAAE,WAAW,CAAC,GACnE,gBAAgB,CAAC,SAAS,EAAE,WAAW,EAAE,cAAc,CAAC,CAAC;AAC5D,wBAAgB,sBAAsB,CACrC,SAAS,SAAS,MAAM,EACxB,WAAW,EACX,MAAM,SAAS,MAAM,EAErB,OAAO,EAAE,mCAAmC,CAAC,SAAS,EAAE,WAAW,EAAE,MAAM,CAAC,GAC1E,gBAAgB,CAAC,SAAS,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC"}

package/dist/host/lazy-handle-client.js

@@ -62,9 +62,49 @@ const createLazyHandleClientWithStages = (input) => {
         });
         return run;
     };
+    const runCommandWithRetry = (buildPayload, dispatchAndWait, options) => {
+        const execute = async () => {
+            let didRetry = false;
+            for (;;) {
+                if (stage === stages.invalidated) {
+                    throw new Error("Handle client is invalidated");
+                }
+                const commandEpoch = epoch;
+                const payload = buildPayload(handleId);
+                try {
+                    const settlement = await dispatchAndWait(payload);
+                    const settledHandleId = input.getHandleIdFromSettlement(settlement);
+                    if (settledHandleId && commandEpoch === epoch) {
+                        publishHandle(settledHandleId);
+                    }
+                    return settlement;
+                }
+                catch (error) {
+                    if (commandEpoch === epoch &&
+                        !didRetry &&
+                        options.shouldRetry(error)) {
+                        didRetry = true;
+                        options.onBeforeRetry?.(error);
+                        continue;
+                    }
+                    throw error;
+                }
+            }
+        };
+        const run = queuedCommandCount === 0 ? execute() : tail.then(execute, execute);
+        queuedCommandCount += 1;
+        tail = run.then(() => {
+            queuedCommandCount -= 1;
+        }, () => {
+            queuedCommandCount -= 1;
+        });
+        return run;
+    };
     return {
         runCommand,
+        runCommandWithRetry,
         getHandleId: () => handleId,
+        hasPendingCommands: () => queuedCommandCount > 0,
         subscribeHandle: (subscriber) => {
             subscribers.add(subscriber);
             if (handleId) {

package/dist/host/sdk.d.ts

@@ -4,6 +4,8 @@
  */
 export { createCommandDispatch } from "./command-dispatch.js";
 export { COMMAND_SETTLEMENT_TIMEOUT_CODE, CommandSettlementError, CommandSettlementTimeoutError, toCommandSettlementError, waitForCommandSettlement, } from "./command-settlement.js";
+export type { FlowCommandHandleController } from "./flow-command-handle-controller.js";
+export { createFlowCommandHandleController } from "./flow-command-handle-controller.js";
 export type { FlowHandleFromSettlement, FlowState, } from "./host-event-contract.js";
 export { getFlowHandleFromSettlementDetail, isFlowStateChangedDetail, isHandleInvalidatedDetail, isInstanceFlowStateChangedDetail, } from "./host-event-contract.js";
 export type { AppEventCapability, AppEventFlag, AppEventFlagProvider, AppEventFlagValue, AppEventPayload, CapabilitiesInput, ClientMeta, ClientOptions, Command, CommandEnvelope, ConfigureOptions, ContainerPolicy, FlagsInput, InitOptions, PublicCommandPayload, ResponseMetadataInput, TelemetryEvent, } from "./sdk-types.js";

package/dist/host/sdk.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sdk.d.ts","sourceRoot":"","sources":["../../src/host/sdk.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EACN,+BAA+B,EAC/B,sBAAsB,EACtB,6BAA6B,EAC7B,wBAAwB,EACxB,wBAAwB,GACxB,MAAM,yBAAyB,CAAC;AACjC,YAAY,EACX,wBAAwB,EACxB,SAAS,GACT,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACN,iCAAiC,EACjC,wBAAwB,EACxB,yBAAyB,EACzB,gCAAgC,GAChC,MAAM,0BAA0B,CAAC;AAClC,YAAY,EACX,kBAAkB,EAClB,YAAY,EACZ,oBAAoB,EACpB,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,UAAU,EACV,aAAa,EACb,OAAO,EACP,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,UAAU,EACV,WAAW,EACX,oBAAoB,EACpB,qBAAqB,EAErB,cAAc,GACd,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"sdk.d.ts","sourceRoot":"","sources":["../../src/host/sdk.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EACN,+BAA+B,EAC/B,sBAAsB,EACtB,6BAA6B,EAC7B,wBAAwB,EACxB,wBAAwB,GACxB,MAAM,yBAAyB,CAAC;AACjC,YAAY,EAAE,2BAA2B,EAAE,MAAM,qCAAqC,CAAC;AACvF,OAAO,EAAE,iCAAiC,EAAE,MAAM,qCAAqC,CAAC;AACxF,YAAY,EACX,wBAAwB,EACxB,SAAS,GACT,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACN,iCAAiC,EACjC,wBAAwB,EACxB,yBAAyB,EACzB,gCAAgC,GAChC,MAAM,0BAA0B,CAAC;AAClC,YAAY,EACX,kBAAkB,EAClB,YAAY,EACZ,oBAAoB,EACpB,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,UAAU,EACV,aAAa,EACb,OAAO,EACP,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,UAAU,EACV,WAAW,EACX,oBAAoB,EACpB,qBAAqB,EAErB,cAAc,GACd,MAAM,gBAAgB,CAAC"}

package/dist/host/sdk.js

@@ -4,4 +4,5 @@
  */
 export { createCommandDispatch } from "./command-dispatch.js";
 export { COMMAND_SETTLEMENT_TIMEOUT_CODE, CommandSettlementError, CommandSettlementTimeoutError, toCommandSettlementError, waitForCommandSettlement, } from "./command-settlement.js";
+export { createFlowCommandHandleController } from "./flow-command-handle-controller.js";
 export { getFlowHandleFromSettlementDetail, isFlowStateChangedDetail, isHandleInvalidatedDetail, isInstanceFlowStateChangedDetail, } from "./host-event-contract.js";

package/dist/index.d.ts

@@ -11,6 +11,7 @@ export { type FlowDisplaySyncRequest, type FlowDisplaySyncResponse, flowDisplayS
 export { buildIdentityTypeGuidanceMessage, getIdentityTypeSuggestion, IDENTITY_TYPE_VALUES, type IdentityTypeValue, isIdentityTypeValue, type StandardIdentityTypeValue, } from "./identity-type.js";
 export { type CaptureInstanceFeedbackRequest, type CaptureInstanceFeedbackResponse, captureInstanceFeedbackRequestSchema, captureInstanceFeedbackResponseSchema, type InstanceFeedbackDataType, type InstanceFeedbackMineFeedback, type InstanceFeedbackValence, instanceFeedbackDataTypeSchema, instanceFeedbackMineFeedbackSchema, instanceFeedbackValenceSchema, type ListInstanceFeedbackMineRequest, type ListInstanceFeedbackMineResponse, listInstanceFeedbackMineRequestSchema, listInstanceFeedbackMineResponseSchema, } from "./instance-feedback.js";
 export { type PreviewConnectionPairRequest, type PreviewConnectionPairResponse, previewConnectionPairRequestSchema, previewConnectionPairResponseSchema, } from "./preview-connection.js";
+export { PREVIEW_FLOW_TRANSPORT_SOURCE, type PreviewFlowOpenCommand, type PreviewFlowOpenRequest, type PreviewFlowOpenResult, previewFlowOpenCommandSchema, previewFlowOpenRequestSchema, previewFlowOpenResultSchema, } from "./preview-flow-transport.js";
 export { PREVIEW_PAIRING_TRANSPORT_SOURCE, type PreviewPairingHostAck, type PreviewPairingHostRequest, type PreviewPairingHostResult, previewPairingHostAckSchema, previewPairingHostRequestSchema, previewPairingHostResultSchema, } from "./preview-pairing-transport.js";
 export { isPublicGrantScope, type PublicGrantScope, publicGrantScopeIdSchema, } from "./public-grant-scope.js";
 export { type RuntimeEndpoints, resolveApiBaseUrl, resolveCoreUrl, resolveRealtimeUrl, resolveTrpcBaseUrl, runtimeEndpointsSchema, } from "./runtime-endpoints.js";

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -10,6 +10,7 @@ export { flowDisplaySyncRequestSchema, flowDisplaySyncResponseSchema, resolveFlo
 export { buildIdentityTypeGuidanceMessage, getIdentityTypeSuggestion, IDENTITY_TYPE_VALUES, isIdentityTypeValue, } from "./identity-type.js";
 export { captureInstanceFeedbackRequestSchema, captureInstanceFeedbackResponseSchema, instanceFeedbackDataTypeSchema, instanceFeedbackMineFeedbackSchema, instanceFeedbackValenceSchema, listInstanceFeedbackMineRequestSchema, listInstanceFeedbackMineResponseSchema, } from "./instance-feedback.js";
 export { previewConnectionPairRequestSchema, previewConnectionPairResponseSchema, } from "./preview-connection.js";
+export { PREVIEW_FLOW_TRANSPORT_SOURCE, previewFlowOpenCommandSchema, previewFlowOpenRequestSchema, previewFlowOpenResultSchema, } from "./preview-flow-transport.js";
 export { PREVIEW_PAIRING_TRANSPORT_SOURCE, previewPairingHostAckSchema, previewPairingHostRequestSchema, previewPairingHostResultSchema, } from "./preview-pairing-transport.js";
 export { isPublicGrantScope, publicGrantScopeIdSchema, } from "./public-grant-scope.js";
 export { resolveApiBaseUrl, resolveCoreUrl, resolveRealtimeUrl, resolveTrpcBaseUrl, runtimeEndpointsSchema, } from "./runtime-endpoints.js";

package/dist/preview-flow-transport.d.ts

@@ -0,0 +1,61 @@
+import * as z from "zod/mini";
+export declare const PREVIEW_FLOW_TRANSPORT_SOURCE = "getuserfeedback.preview";
+export declare const previewFlowOpenCommandSchema: z.ZodMiniObject<{
+    kind: z.ZodMiniLiteral<"open">;
+    flow: z.ZodMiniObject<{
+        definition: z.ZodMiniUnknown;
+        theme: z.ZodMiniOptional<z.ZodMiniObject<{
+            css: z.ZodMiniOptional<z.ZodMiniString<string>>;
+            themeRuntimeArtifactId: z.ZodMiniOptional<z.ZodMiniString<string>>;
+            themeVersionId: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>;
+    flowHandleId: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    metadata: z.ZodMiniOptional<z.ZodMiniObject<{
+        tags: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniUnion<readonly [z.ZodMiniString<string>, z.ZodMiniArray<z.ZodMiniString<string>>]>>>;
+    }, z.core.$strict>>;
+    hideCloseButton: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
+}, z.core.$strict>;
+export declare const previewFlowOpenRequestSchema: z.ZodMiniObject<{
+    source: z.ZodMiniLiteral<"getuserfeedback.preview">;
+    type: z.ZodMiniLiteral<"preview.flow.open.request">;
+    requestId: z.ZodMiniString<string>;
+    command: z.ZodMiniObject<{
+        kind: z.ZodMiniLiteral<"open">;
+        flow: z.ZodMiniObject<{
+            definition: z.ZodMiniUnknown;
+            theme: z.ZodMiniOptional<z.ZodMiniObject<{
+                css: z.ZodMiniOptional<z.ZodMiniString<string>>;
+                themeRuntimeArtifactId: z.ZodMiniOptional<z.ZodMiniString<string>>;
+                themeVersionId: z.ZodMiniOptional<z.ZodMiniString<string>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>;
+        flowHandleId: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        metadata: z.ZodMiniOptional<z.ZodMiniObject<{
+            tags: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniUnion<readonly [z.ZodMiniString<string>, z.ZodMiniArray<z.ZodMiniString<string>>]>>>;
+        }, z.core.$strict>>;
+        hideCloseButton: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export declare const previewFlowOpenResultSchema: z.ZodMiniDiscriminatedUnion<[z.ZodMiniObject<{
+    source: z.ZodMiniLiteral<"getuserfeedback.preview">;
+    type: z.ZodMiniLiteral<"preview.flow.open.result">;
+    requestId: z.ZodMiniString<string>;
+    ok: z.ZodMiniLiteral<true>;
+    result: z.ZodMiniObject<{
+        flowHandleId: z.ZodMiniString<string>;
+    }, z.core.$strict>;
+}, z.core.$strict>, z.ZodMiniObject<{
+    source: z.ZodMiniLiteral<"getuserfeedback.preview">;
+    type: z.ZodMiniLiteral<"preview.flow.open.result">;
+    requestId: z.ZodMiniString<string>;
+    ok: z.ZodMiniLiteral<false>;
+    error: z.ZodMiniObject<{
+        code: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        message: z.ZodMiniString<string>;
+    }, z.core.$strict>;
+}, z.core.$strict>], "ok">;
+export type PreviewFlowOpenCommand = z.output<typeof previewFlowOpenCommandSchema>;
+export type PreviewFlowOpenRequest = z.output<typeof previewFlowOpenRequestSchema>;
+export type PreviewFlowOpenResult = z.output<typeof previewFlowOpenResultSchema>;
+//# sourceMappingURL=preview-flow-transport.d.ts.map

package/dist/preview-flow-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview-flow-transport.d.ts","sourceRoot":"","sources":["../src/preview-flow-transport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,UAAU,CAAC;AAI9B,eAAO,MAAM,6BAA6B,4BAAmC,CAAC;AA8B9E,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;kBAMvC,CAAC;AAEH,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;kBAKvC,CAAC;AAEH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;0BAoBtC,CAAC;AAEH,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAC5C,OAAO,4BAA4B,CACnC,CAAC;AACF,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAC5C,OAAO,4BAA4B,CACnC,CAAC;AACF,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAC3C,OAAO,2BAA2B,CAClC,CAAC"}

package/dist/preview-flow-transport.js

@@ -0,0 +1,59 @@
+import * as z from "zod/mini";
+import { PREVIEW_PAIRING_TRANSPORT_SOURCE } from "./preview-pairing-transport.js";
+import { responseMetadataInputSchema } from "./response-metadata.js";
+export const PREVIEW_FLOW_TRANSPORT_SOURCE = PREVIEW_PAIRING_TRANSPORT_SOURCE;
+const requestIdSchema = z.string().check(z.trim(), z.minLength(1));
+const flowHandleIdSchema = z.string().check(z.trim(), z.minLength(1));
+const inlineFlowThemeSchema = z.strictObject({
+    css: z.optional(z.string()),
+    themeRuntimeArtifactId: z.optional(z.string().check(z.trim(), z.minLength(1))),
+    themeVersionId: z.optional(z.string().check(z.trim(), z.minLength(1))),
+});
+const inlineFlowSchema = z.strictObject({
+    definition: z.unknown().check(z.check((ctx) => {
+        if (ctx.value !== undefined) {
+            return;
+        }
+        ctx.issues.push({
+            code: "custom",
+            input: ctx.value,
+            message: "Inline flow definition is required.",
+            continue: false,
+        });
+    })),
+    theme: z.optional(inlineFlowThemeSchema),
+});
+export const previewFlowOpenCommandSchema = z.strictObject({
+    kind: z.literal("open"),
+    flow: inlineFlowSchema,
+    flowHandleId: z.optional(flowHandleIdSchema),
+    metadata: z.optional(responseMetadataInputSchema),
+    hideCloseButton: z.optional(z.boolean()),
+});
+export const previewFlowOpenRequestSchema = z.strictObject({
+    source: z.literal(PREVIEW_FLOW_TRANSPORT_SOURCE),
+    type: z.literal("preview.flow.open.request"),
+    requestId: requestIdSchema,
+    command: previewFlowOpenCommandSchema,
+});
+export const previewFlowOpenResultSchema = z.discriminatedUnion("ok", [
+    z.strictObject({
+        source: z.literal(PREVIEW_FLOW_TRANSPORT_SOURCE),
+        type: z.literal("preview.flow.open.result"),
+        requestId: requestIdSchema,
+        ok: z.literal(true),
+        result: z.strictObject({
+            flowHandleId: flowHandleIdSchema,
+        }),
+    }),
+    z.strictObject({
+        source: z.literal(PREVIEW_FLOW_TRANSPORT_SOURCE),
+        type: z.literal("preview.flow.open.result"),
+        requestId: requestIdSchema,
+        ok: z.literal(false),
+        error: z.strictObject({
+            code: z.optional(z.string().check(z.trim(), z.minLength(1))),
+            message: z.string().check(z.trim(), z.minLength(1)),
+        }),
+    }),
+]);

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@getuserfeedback/protocol",
-	"version": "3.1.2",
+	"version": "3.1.4",
 	"description": "getuserfeedback widget protocol — host surface and (later) wire protocol",
 	"keywords": [
 		"getuserfeedback",

package/src/host/flow-command-handle-controller.test.ts

@@ -0,0 +1,239 @@
+import { describe, expect, it } from "bun:test";
+import { createFlowCommandHandleController } from "./flow-command-handle-controller";
+
+describe("flow command handle controller", () => {
+	it("serializes commands and publishes settled handles to later payloads", async () => {
+		const dispatched: Array<{ flowHandleId?: string; kind: string }> = [];
+		const controller = createFlowCommandHandleController<
+			string,
+			{ result?: { flowHandleId?: string } }
+		>({
+			getHandleIdFromSettlement: (settlement) =>
+				settlement.result?.flowHandleId,
+			isStaleHandleError: () => false,
+		});
+
+		await controller.runCommand(
+			(flowHandleId) => ({ kind: "prefetch", flowHandleId }),
+			async (payload) => {
+				dispatched.push(payload);
+				return { result: { flowHandleId: "handle_123" } };
+			},
+		);
+		await controller.runCommand(
+			(flowHandleId) => ({ kind: "open", flowHandleId }),
+			async (payload) => {
+				dispatched.push(payload);
+				return { result: { flowHandleId: "handle_123" } };
+			},
+		);
+
+		expect(dispatched).toEqual([
+			{ kind: "prefetch", flowHandleId: undefined },
+			{ kind: "open", flowHandleId: "handle_123" },
+		]);
+		expect(controller.getHandleId()).toBe("handle_123");
+		expect(controller.hasHandleId("handle_123")).toBe(true);
+	});
+
+	it("clears stale handles and retries once without the handle", async () => {
+		const dispatched: Array<{ flowHandleId?: string; kind: string }> = [];
+		const clearedHandles: string[] = [];
+		const controller = createFlowCommandHandleController<
+			string,
+			{ result?: { flowHandleId?: string } }
+		>({
+			getHandleIdFromSettlement: (settlement) =>
+				settlement.result?.flowHandleId,
+			isStaleHandleError: (error) =>
+				error instanceof Error && error.message === "stale",
+			onClearResolvedHandle: (flowHandleId) => {
+				clearedHandles.push(flowHandleId);
+			},
+		});
+
+		await controller.runCommand(
+			(flowHandleId) => ({ kind: "prefetch", flowHandleId }),
+			async (payload) => {
+				dispatched.push(payload);
+				return { result: { flowHandleId: "handle_stale" } };
+			},
+		);
+		let didFailOnce = false;
+		await controller.runCommand(
+			(flowHandleId) => ({ kind: "open", flowHandleId }),
+			async (payload) => {
+				dispatched.push(payload);
+				if (!didFailOnce) {
+					didFailOnce = true;
+					throw new Error("stale");
+				}
+				return { result: { flowHandleId: "handle_recovered" } };
+			},
+		);
+
+		expect(dispatched).toEqual([
+			{ kind: "prefetch", flowHandleId: undefined },
+			{ kind: "open", flowHandleId: "handle_stale" },
+			{ kind: "open", flowHandleId: undefined },
+		]);
+		expect(clearedHandles).toEqual(["handle_stale"]);
+		expect(controller.getHandleId()).toBe("handle_recovered");
+	});
+
+	it("keeps stale-handle retry in the same serialized command slot", async () => {
+		const dispatched: Array<{ flowHandleId?: string; kind: string }> = [];
+		const controller = createFlowCommandHandleController<
+			string,
+			{ result?: { flowHandleId?: string } }
+		>({
+			getHandleIdFromSettlement: (settlement) =>
+				settlement.result?.flowHandleId,
+			isStaleHandleError: (error) =>
+				error instanceof Error && error.message === "stale",
+		});
+
+		await controller.runCommand(
+			(flowHandleId) => ({ kind: "prefetch", flowHandleId }),
+			async (payload) => {
+				dispatched.push(payload);
+				return { result: { flowHandleId: "handle_stale" } };
+			},
+		);
+		let didFailOnce = false;
+		const staleOpen = controller.runCommand(
+			(flowHandleId) => ({ kind: "open", flowHandleId }),
+			async (payload) => {
+				dispatched.push(payload);
+				if (!didFailOnce) {
+					didFailOnce = true;
+					throw new Error("stale");
+				}
+				return { result: { flowHandleId: "handle_recovered" } };
+			},
+		);
+		const queuedPrerender = controller.runCommand(
+			(flowHandleId) => ({ kind: "prerender", flowHandleId }),
+			async (payload) => {
+				dispatched.push(payload);
+				return { result: { flowHandleId: "handle_second" } };
+			},
+		);
+
+		await staleOpen;
+		await queuedPrerender;
+
+		expect(dispatched).toEqual([
+			{ kind: "prefetch", flowHandleId: undefined },
+			{ kind: "open", flowHandleId: "handle_stale" },
+			{ kind: "open", flowHandleId: undefined },
+			{ kind: "prerender", flowHandleId: "handle_recovered" },
+		]);
+		expect(controller.getHandleId()).toBe("handle_second");
+	});
+
+	it("does not retry non-stale failures", async () => {
+		const dispatched: Array<{ flowHandleId?: string; kind: string }> = [];
+		const controller = createFlowCommandHandleController<
+			string,
+			{ result?: { flowHandleId?: string } }
+		>({
+			getHandleIdFromSettlement: (settlement) =>
+				settlement.result?.flowHandleId,
+			isStaleHandleError: () => false,
+		});
+
+		await expect(
+			controller.runCommand(
+				(flowHandleId) => ({ kind: "open", flowHandleId }),
+				async (payload) => {
+					dispatched.push(payload);
+					throw new Error("boom");
+				},
+			),
+		).rejects.toThrow("boom");
+
+		expect(dispatched).toEqual([{ kind: "open", flowHandleId: undefined }]);
+	});
+
+	it("ignores handles from commands that settle after reset", async () => {
+		const dispatched: Array<{ flowHandleId?: string; kind: string }> = [];
+		let resolveSettlement:
+			| ((settlement: { result?: { flowHandleId?: string } }) => void)
+			| undefined;
+		const controller = createFlowCommandHandleController<
+			string,
+			{ result?: { flowHandleId?: string } }
+		>({
+			getHandleIdFromSettlement: (settlement) =>
+				settlement.result?.flowHandleId,
+			isStaleHandleError: () => false,
+		});
+
+		const pendingCommand = controller.runCommand(
+			(flowHandleId) => ({ kind: "prefetch", flowHandleId }),
+			(payload) => {
+				dispatched.push(payload);
+				return new Promise((resolve) => {
+					resolveSettlement = resolve;
+				});
+			},
+		);
+		controller.reset();
+		resolveSettlement?.({ result: { flowHandleId: "handle_from_old_epoch" } });
+		await pendingCommand;
+		await controller.runCommand(
+			(flowHandleId) => ({ kind: "open", flowHandleId }),
+			async (payload) => {
+				dispatched.push(payload);
+				return { result: { flowHandleId: "handle_current" } };
+			},
+		);
+
+		expect(dispatched).toEqual([
+			{ kind: "prefetch", flowHandleId: undefined },
+			{ kind: "open", flowHandleId: undefined },
+		]);
+		expect(controller.getHandleId()).toBe("handle_current");
+	});
+
+	it("does not retry stale failures from commands that fail after reset", async () => {
+		const dispatched: Array<{ flowHandleId?: string; kind: string }> = [];
+		let rejectSettlement: ((error: Error) => void) | undefined;
+		const controller = createFlowCommandHandleController<
+			string,
+			{ result?: { flowHandleId?: string } }
+		>({
+			getHandleIdFromSettlement: (settlement) =>
+				settlement.result?.flowHandleId,
+			isStaleHandleError: (error) =>
+				error instanceof Error && error.message === "stale",
+		});
+
+		await controller.runCommand(
+			(flowHandleId) => ({ kind: "prefetch", flowHandleId }),
+			async (payload) => {
+				dispatched.push(payload);
+				return { result: { flowHandleId: "handle_before_reset" } };
+			},
+		);
+		const pendingCommand = controller.runCommand(
+			(flowHandleId) => ({ kind: "open", flowHandleId }),
+			(payload) => {
+				dispatched.push(payload);
+				return new Promise((_resolve, reject) => {
+					rejectSettlement = reject;
+				});
+			},
+		);
+		controller.reset();
+		rejectSettlement?.(new Error("stale"));
+
+		await expect(pendingCommand).rejects.toThrow("stale");
+		expect(dispatched).toEqual([
+			{ kind: "prefetch", flowHandleId: undefined },
+			{ kind: "open", flowHandleId: "handle_before_reset" },
+		]);
+		expect(controller.getHandleId()).toBeUndefined();
+	});
+});

package/src/host/flow-command-handle-controller.ts

@@ -0,0 +1,86 @@
+import {
+	createLazyHandleClient,
+	type LazyHandleClient,
+} from "./lazy-handle-client.js";
+
+export type FlowCommandHandleController<
+	THandleId extends string,
+	TSettlement,
+> = {
+	runCommand<TPayload>(
+		buildPayload: (handleId: THandleId | undefined) => TPayload,
+		dispatchAndWait: (payload: TPayload) => Promise<TSettlement>,
+	): Promise<TSettlement>;
+	getHandleId(): THandleId | undefined;
+	hasHandleId(handleId: string): boolean;
+	hasPendingCommands(): boolean;
+	subscribeHandle(subscriber: (handleId: THandleId) => void): () => void;
+	clearResolvedHandle(): THandleId | undefined;
+	reset(): void;
+};
+
+export type CreateFlowCommandHandleControllerOptions<
+	THandleId extends string,
+	TSettlement,
+> = {
+	getHandleIdFromSettlement: (settlement: TSettlement) => THandleId | undefined;
+	isStaleHandleError: (error: unknown) => boolean;
+	onClearResolvedHandle?: (handleId: THandleId) => void;
+};
+
+export function createFlowCommandHandleController<
+	THandleId extends string,
+	TSettlement,
+>({
+	getHandleIdFromSettlement,
+	isStaleHandleError,
+	onClearResolvedHandle,
+}: CreateFlowCommandHandleControllerOptions<
+	THandleId,
+	TSettlement
+>): FlowCommandHandleController<THandleId, TSettlement> {
+	const handleClient: LazyHandleClient<THandleId, TSettlement> =
+		createLazyHandleClient<THandleId, TSettlement>({
+			getHandleIdFromSettlement,
+		});
+
+	const clearResolvedHandle = (): THandleId | undefined => {
+		const previousHandleId = handleClient.getHandleId();
+		if (!previousHandleId) {
+			return undefined;
+		}
+		handleClient.reset();
+		onClearResolvedHandle?.(previousHandleId);
+		return previousHandleId;
+	};
+
+	const reset = (): void => {
+		const previousHandleId = handleClient.getHandleId();
+		handleClient.reset();
+		if (previousHandleId) {
+			onClearResolvedHandle?.(previousHandleId);
+		}
+	};
+
+	const runCommand: FlowCommandHandleController<
+		THandleId,
+		TSettlement
+	>["runCommand"] = async (buildPayload, dispatchAndWait) => {
+		return handleClient.runCommandWithRetry(buildPayload, dispatchAndWait, {
+			shouldRetry: isStaleHandleError,
+			onBeforeRetry: () => {
+				clearResolvedHandle();
+			},
+		});
+	};
+
+	return {
+		runCommand,
+		getHandleId: () => handleClient.getHandleId(),
+		hasHandleId: (handleId) => handleClient.getHandleId() === handleId,
+		hasPendingCommands: () => handleClient.hasPendingCommands(),
+		subscribeHandle: (subscriber) => handleClient.subscribeHandle(subscriber),
+		clearResolvedHandle,
+		reset,
+	};
+}

package/src/host/index.ts

@@ -7,6 +7,7 @@ export * from "./command-envelope.js";
 export * from "./command-settlement.js";
 export * from "./constants.js";
 export * from "./external-id-argument-guards.js";
+export * from "./flow-command-handle-controller.js";
 export * from "./host-event-contract.js";
 export * from "./lazy-handle-client.js";
 export { createCommandRequestId } from "./request-id.js";

package/src/host/lazy-handle-client.ts

@@ -23,7 +23,16 @@ export type LazyHandleClient<
 		buildPayload: (handleId: THandleId | undefined) => TPayload,
 		dispatchAndWait: (payload: TPayload) => Promise<TSettlement>,
 	): Promise<TSettlement>;
+	runCommandWithRetry<TPayload>(
+		buildPayload: (handleId: THandleId | undefined) => TPayload,
+		dispatchAndWait: (payload: TPayload) => Promise<TSettlement>,
+		options: {
+			shouldRetry: (error: unknown) => boolean;
+			onBeforeRetry?: (error: unknown) => void;
+		},
+	): Promise<TSettlement>;
 	getHandleId(): THandleId | undefined;
+	hasPendingCommands(): boolean;
 	subscribeHandle(subscriber: Subscriber<THandleId>): () => void;
 	getStage(): TStage;
 	setStage(stage: TStage): void;
@@ -141,9 +150,60 @@ const createLazyHandleClientWithStages = <
 		return run;
 	};
 
+	const runCommandWithRetry: LazyHandleClient<
+		THandleId,
+		TSettlement,
+		TStage
+	>["runCommandWithRetry"] = (buildPayload, dispatchAndWait, options) => {
+		const execute = async (): Promise<TSettlement> => {
+			let didRetry = false;
+			for (;;) {
+				if (stage === stages.invalidated) {
+					throw new Error("Handle client is invalidated");
+				}
+				const commandEpoch = epoch;
+				const payload = buildPayload(handleId);
+				try {
+					const settlement = await dispatchAndWait(payload);
+					const settledHandleId = input.getHandleIdFromSettlement(settlement);
+					if (settledHandleId && commandEpoch === epoch) {
+						publishHandle(settledHandleId);
+					}
+					return settlement;
+				} catch (error) {
+					if (
+						commandEpoch === epoch &&
+						!didRetry &&
+						options.shouldRetry(error)
+					) {
+						didRetry = true;
+						options.onBeforeRetry?.(error);
+						continue;
+					}
+					throw error;
+				}
+			}
+		};
+
+		const run =
+			queuedCommandCount === 0 ? execute() : tail.then(execute, execute);
+		queuedCommandCount += 1;
+		tail = run.then(
+			() => {
+				queuedCommandCount -= 1;
+			},
+			() => {
+				queuedCommandCount -= 1;
+			},
+		);
+		return run;
+	};
+
 	return {
 		runCommand,
+		runCommandWithRetry,
 		getHandleId: () => handleId,
+		hasPendingCommands: () => queuedCommandCount > 0,
 		subscribeHandle: (subscriber) => {
 			subscribers.add(subscriber);
 			if (handleId) {

package/src/host/sdk.ts

@@ -11,6 +11,8 @@ export {
 	toCommandSettlementError,
 	waitForCommandSettlement,
 } from "./command-settlement.js";
+export type { FlowCommandHandleController } from "./flow-command-handle-controller.js";
+export { createFlowCommandHandleController } from "./flow-command-handle-controller.js";
 export type {
 	FlowHandleFromSettlement,
 	FlowState,

package/src/index.ts

@@ -125,6 +125,15 @@ export {
 	previewConnectionPairRequestSchema,
 	previewConnectionPairResponseSchema,
 } from "./preview-connection.js";
+export {
+	PREVIEW_FLOW_TRANSPORT_SOURCE,
+	type PreviewFlowOpenCommand,
+	type PreviewFlowOpenRequest,
+	type PreviewFlowOpenResult,
+	previewFlowOpenCommandSchema,
+	previewFlowOpenRequestSchema,
+	previewFlowOpenResultSchema,
+} from "./preview-flow-transport.js";
 export {
 	PREVIEW_PAIRING_TRANSPORT_SOURCE,
 	type PreviewPairingHostAck,

package/src/preview-flow-transport.test.ts

@@ -0,0 +1,95 @@
+import { describe, expect, it } from "bun:test";
+import {
+	PREVIEW_FLOW_TRANSPORT_SOURCE,
+	previewFlowOpenRequestSchema,
+	previewFlowOpenResultSchema,
+} from "./preview-flow-transport";
+
+describe("preview flow transport protocol", () => {
+	it("parses inline flow open requests", () => {
+		expect(
+			previewFlowOpenRequestSchema.parse({
+				source: PREVIEW_FLOW_TRANSPORT_SOURCE,
+				type: "preview.flow.open.request",
+				requestId: "req_123",
+				command: {
+					kind: "open",
+					flow: {
+						definition: {
+							blocks: [],
+							config: {},
+							presenter: null,
+						},
+					},
+					flowHandleId: "handle_123",
+					hideCloseButton: true,
+				},
+			}),
+		).toMatchObject({
+			requestId: "req_123",
+			command: {
+				kind: "open",
+				flowHandleId: "handle_123",
+				flow: {
+					definition: {
+						blocks: [],
+					},
+				},
+			},
+		});
+	});
+
+	it("rejects undefined inline definitions", () => {
+		expect(() =>
+			previewFlowOpenRequestSchema.parse({
+				source: PREVIEW_FLOW_TRANSPORT_SOURCE,
+				type: "preview.flow.open.request",
+				requestId: "req_123",
+				command: {
+					kind: "open",
+					flow: {
+						definition: undefined,
+					},
+				},
+			}),
+		).toThrow();
+	});
+
+	it("parses success and failure results", () => {
+		expect(
+			previewFlowOpenResultSchema.parse({
+				source: PREVIEW_FLOW_TRANSPORT_SOURCE,
+				type: "preview.flow.open.result",
+				requestId: "req_123",
+				ok: true,
+				result: {
+					flowHandleId: "handle_123",
+				},
+			}),
+		).toEqual({
+			source: PREVIEW_FLOW_TRANSPORT_SOURCE,
+			type: "preview.flow.open.result",
+			requestId: "req_123",
+			ok: true,
+			result: {
+				flowHandleId: "handle_123",
+			},
+		});
+
+		expect(
+			previewFlowOpenResultSchema.parse({
+				source: PREVIEW_FLOW_TRANSPORT_SOURCE,
+				type: "preview.flow.open.result",
+				requestId: "req_123",
+				ok: false,
+				error: {
+					code: "DISPATCH_FAILED",
+					message: "Preview dispatch failed",
+				},
+			}),
+		).toMatchObject({
+			ok: false,
+			error: { code: "DISPATCH_FAILED" },
+		});
+	});
+});

package/src/preview-flow-transport.ts

@@ -0,0 +1,80 @@
+import * as z from "zod/mini";
+import { PREVIEW_PAIRING_TRANSPORT_SOURCE } from "./preview-pairing-transport.js";
+import { responseMetadataInputSchema } from "./response-metadata.js";
+
+export const PREVIEW_FLOW_TRANSPORT_SOURCE = PREVIEW_PAIRING_TRANSPORT_SOURCE;
+
+const requestIdSchema = z.string().check(z.trim(), z.minLength(1));
+const flowHandleIdSchema = z.string().check(z.trim(), z.minLength(1));
+
+const inlineFlowThemeSchema = z.strictObject({
+	css: z.optional(z.string()),
+	themeRuntimeArtifactId: z.optional(
+		z.string().check(z.trim(), z.minLength(1)),
+	),
+	themeVersionId: z.optional(z.string().check(z.trim(), z.minLength(1))),
+});
+
+const inlineFlowSchema = z.strictObject({
+	definition: z.unknown().check(
+		z.check((ctx) => {
+			if (ctx.value !== undefined) {
+				return;
+			}
+			ctx.issues.push({
+				code: "custom",
+				input: ctx.value,
+				message: "Inline flow definition is required.",
+				continue: false,
+			});
+		}),
+	),
+	theme: z.optional(inlineFlowThemeSchema),
+});
+
+export const previewFlowOpenCommandSchema = z.strictObject({
+	kind: z.literal("open"),
+	flow: inlineFlowSchema,
+	flowHandleId: z.optional(flowHandleIdSchema),
+	metadata: z.optional(responseMetadataInputSchema),
+	hideCloseButton: z.optional(z.boolean()),
+});
+
+export const previewFlowOpenRequestSchema = z.strictObject({
+	source: z.literal(PREVIEW_FLOW_TRANSPORT_SOURCE),
+	type: z.literal("preview.flow.open.request"),
+	requestId: requestIdSchema,
+	command: previewFlowOpenCommandSchema,
+});
+
+export const previewFlowOpenResultSchema = z.discriminatedUnion("ok", [
+	z.strictObject({
+		source: z.literal(PREVIEW_FLOW_TRANSPORT_SOURCE),
+		type: z.literal("preview.flow.open.result"),
+		requestId: requestIdSchema,
+		ok: z.literal(true),
+		result: z.strictObject({
+			flowHandleId: flowHandleIdSchema,
+		}),
+	}),
+	z.strictObject({
+		source: z.literal(PREVIEW_FLOW_TRANSPORT_SOURCE),
+		type: z.literal("preview.flow.open.result"),
+		requestId: requestIdSchema,
+		ok: z.literal(false),
+		error: z.strictObject({
+			code: z.optional(z.string().check(z.trim(), z.minLength(1))),
+			message: z.string().check(z.trim(), z.minLength(1)),
+		}),
+	}),
+]);
+
+export type PreviewFlowOpenCommand = z.output<
+	typeof previewFlowOpenCommandSchema
+>;
+export type PreviewFlowOpenRequest = z.output<
+	typeof previewFlowOpenRequestSchema
+>;
+export type PreviewFlowOpenResult = z.output<
+	typeof previewFlowOpenResultSchema
+>;