@upstash/workflow 0.2.23 → 0.3.0-rc1

package/hono.mjs

@@ -2,7 +2,7 @@ import {
   SDK_TELEMETRY,
   serveBase,
   serveManyBase
-} from "./chunk-GZRDB6Z5.mjs";
+} from "./chunk-2Z32SOYM.mjs";
 
 // platforms/hono.ts
 var telemetry = {

package/index.d.mts

@@ -1,34 +1,7 @@
-import { R as RouteFunction, W as WorkflowServeOptions, E as ExclusiveValidationOptions, T as Telemetry, S as StepType, a as RawStep, N as NotifyResponse, b as Waiter } from './types-BD06btU6.mjs';
-export { A as AsyncStepFunction, C as CallResponse, x as CallSettings, D as DetailedFinishCondition, u as Duration, p as FailureFunctionPayload, F as FinishCondition, H as HeaderParams, z as InvokableWorkflow, y as InvokeStepResponse, I as InvokeWorkflowRequest, L as LazyInvokeStepParams, B as LogLevel, t as NotifyStepResponse, P as ParallelCallState, o as PublicServeOptions, q as RequiredExceptFields, l as Step, n as StepFunction, k as StepTypes, w as StringifyBody, m as SyncStepFunction, v as WaitEventOptions, r as WaitRequest, s as WaitStepResponse, d as WorkflowAbort, i as WorkflowClient, h as WorkflowContext, c as WorkflowError, J as WorkflowLogger, G as WorkflowLoggerOptions, e as WorkflowNonRetryableError, j as WorkflowReceiver, f as WorkflowRetryAfterError, g as WorkflowTool } from './types-BD06btU6.mjs';
-import { FlowControl, PublishRequest, HTTPMethods, State, Client as Client$1 } from '@upstash/qstash';
+import { S as StepType, R as RawStep, W as WorkflowMiddleware, a as WorkflowClient, b as WorkflowReceiver, c as RouteFunction, d as WorkflowServeOptions, T as Telemetry, N as NotifyResponse, e as Waiter } from './types-pEje3VEB.mjs';
+export { A as AsyncStepFunction, C as CallResponse, v as CallSettings, D as DetailedFinishCondition, t as Duration, E as ExclusiveValidationOptions, o as FailureFunctionPayload, F as FinishCondition, H as HeaderParams, x as InvokableWorkflow, w as InvokeStepResponse, I as InvokeWorkflowRequest, L as LazyInvokeStepParams, s as NotifyStepResponse, P as ParallelCallState, Q as QStashClientExtraConfig, p as RequiredExceptFields, l as Step, n as StepFunction, k as StepTypes, m as SyncStepFunction, u as WaitEventOptions, q as WaitRequest, r as WaitStepResponse, g as WorkflowAbort, j as WorkflowContext, f as WorkflowError, h as WorkflowNonRetryableError, i as WorkflowRetryAfterError } from './types-pEje3VEB.mjs';
+import { HTTPMethods, FlowControl, PublishRequest, Client as Client$1 } from '@upstash/qstash';
 import 'zod';
-import 'ai';
-import '@ai-sdk/openai';
-
-/**
- * Creates an async method that handles incoming requests and runs the provided
- * route function as a workflow.
- *
- * Not exported in the package. Instead, used in framework specific serve implementations.
- *
- * Only difference from regular serve is the `useJSONContent` parameter.
- *
- * @param routeFunction - A function that uses WorkflowContext as a parameter and runs a workflow.
- * @param options - Options including the client, onFinish callback, and initialPayloadParser.
- * @returns An async method that consumes incoming requests and runs the workflow.
- */
-declare const serveBase: <TInitialPayload = unknown, TRequest extends Request = Request, TResponse extends Response = Response, TResult = unknown>(routeFunction: RouteFunction<TInitialPayload, TResult>, telemetry?: Telemetry, options?: WorkflowServeOptions<TResponse, TInitialPayload>) => {
-    handler: (request: TRequest) => Promise<TResponse>;
-};
-/**
- * Creates an async method that handles incoming requests and runs the provided
- * route function as a workflow.
- *
- * @param routeFunction - A function that uses WorkflowContext as a parameter and runs a workflow.
- * @param options - Options including the client, onFinish callback, and initialPayloadParser.
- * @returns An async method that consumes incoming requests and runs the workflow.
- */
-declare const serve: <TInitialPayload = unknown, TRequest extends Request = Request, TResponse extends Response = Response, TResult = unknown>(routeFunction: RouteFunction<TInitialPayload, TResult>, options?: Omit<WorkflowServeOptions<TResponse, TInitialPayload>, "useJSONContent" | "schema" | "initialPayloadParser"> & ExclusiveValidationOptions<TInitialPayload>) => ReturnType<typeof serveBase<TInitialPayload, TRequest, TResponse, TResult>>;
 
 type BaseStepLog = {
     /**
@@ -241,7 +214,7 @@ type FailureFunctionLog = {
     /**
      * State of the message published for failure
      */
-    state: State;
+    state: "CALLBACK_INPROGRESS" | "CALLBACK_SUCCESS" | "CALLBACK_FAIL";
     /**
      * Headers received from the step which caused the workflow to fail
      */
@@ -432,13 +405,6 @@ type TriggerOptions = {
      * Can be used to filter the workflow run logs.
      */
     label?: string;
-    /**
-     * Whether to apply the configuration (flow control,
-     * retries, failure url, retry delay) passed in trigger
-     *
-     * @default false
-     */
-    keepTriggerConfig?: boolean;
     /**
      * By default, Workflow SDK sends telemetry about SDK version, framework or runtime.
      *
@@ -447,31 +413,11 @@ type TriggerOptions = {
      * @default false
      */
     disableTelemetry?: boolean;
-} & ({
-    /**
-     * URL to call if the first request to the workflow endpoint fails
-     */
-    failureUrl?: never;
-    /**
-     * Whether the workflow endpoint has a failure function
-     * defined to be invoked if the first request fails.
-     *
-     * If true, the failureUrl will be ignored.
-     */
-    useFailureFunction?: true;
-} | {
     /**
      * URL to call if the first request to the workflow endpoint fails
      */
     failureUrl?: string;
-    /**
-     * Whether the workflow endpoint has a failure function
-     * defined to be invoked if the first request fails.
-     *
-     * If true, the failureUrl will be ignored.
-     */
-    useFailureFunction?: never;
-});
+};
 type DLQResumeRestartOptions<TDLQId extends string | string[] = string | string[]> = {
     dlqId: TDLQId;
 } & Pick<TriggerOptions, "flowControl" | "retries">;
@@ -486,6 +432,78 @@ type DLQResumeRestartResponse = {
     workflowCreatedAt: string;
 };
 
+declare const loggingMiddleware: WorkflowMiddleware<unknown, unknown>;
+
+declare const VALID_REGIONS: readonly ["EU_CENTRAL_1", "US_EAST_1"];
+type QStashRegion = (typeof VALID_REGIONS)[number];
+/**
+ * Regional handler containing client and optional receiver
+ */
+type RegionalHandler = {
+    client: WorkflowClient;
+    receiver?: WorkflowReceiver;
+};
+/**
+ * QStash handlers for single or multi-region mode
+ */
+type QStashHandlers = {
+    mode: "single-region";
+    handlers: RegionalHandler;
+} | {
+    mode: "multi-region";
+    handlers: Record<QStashRegion, RegionalHandler>;
+    defaultRegion: QStashRegion;
+};
+
+type ResponseData = {
+    text: string;
+    status: number;
+    headers: Record<string, string>;
+};
+/**
+ * Internal options for serveBase that are not exposed to users
+ */
+type InternalServeOptions<TResponse extends Response = Response> = {
+    /**
+     * Function to generate a Response from ResponseData
+     */
+    generateResponse: (responseData: ResponseData) => TResponse;
+    /**
+     * Whether the framework should use `content-type: application/json`
+     * in `triggerFirstInvocation`.
+     */
+    useJSONContent: boolean;
+    /**
+     * QStash handlers for single or multi-region mode
+     */
+    qstashHandlers: QStashHandlers;
+};
+
+/**
+ * Creates an async method that handles incoming requests and runs the provided
+ * route function as a workflow.
+ *
+ * Not exported in the package. Instead, used in framework specific serve implementations.
+ *
+ * Only difference from regular serve is the `useJSONContent` parameter.
+ *
+ * @param routeFunction - A function that uses WorkflowContext as a parameter and runs a workflow.
+ * @param options - Options including the client, onFinish callback, and initialPayloadParser.
+ * @returns An async method that consumes incoming requests and runs the workflow.
+ */
+declare const serveBase: <TInitialPayload = unknown, TRequest extends Request = Request, TResponse extends Response = Response, TResult = unknown>(routeFunction: RouteFunction<TInitialPayload, TResult>, telemetry?: Telemetry, options?: WorkflowServeOptions<TInitialPayload, TResult>, internalOptions?: Partial<InternalServeOptions<TResponse>>) => {
+    handler: (request: TRequest) => Promise<TResponse>;
+};
+/**
+ * Creates an async method that handles incoming requests and runs the provided
+ * route function as a workflow.
+ *
+ * @param routeFunction - A function that uses WorkflowContext as a parameter and runs a workflow.
+ * @param options - Options including the client and initialPayloadParser.
+ * @returns An async method that consumes incoming requests and runs the workflow.
+ */
+declare const serve: <TInitialPayload = unknown, TRequest extends Request = Request, TResponse extends Response = Response, TResult = unknown>(routeFunction: RouteFunction<TInitialPayload, TResult>, options?: WorkflowServeOptions<TInitialPayload, TResult>) => ReturnType<typeof serveBase<TInitialPayload, TRequest, TResponse, TResult>>;
+
 type QStashDLQFilterOptions = NonNullable<Required<Parameters<Client$1["dlq"]["listMessages"]>[0]>>["filter"];
 type DLQFilterOptions = Pick<QStashDLQFilterOptions, "fromDate" | "toDate" | "url" | "responseStatus"> & {
     workflowRunId?: string;
@@ -539,15 +557,19 @@ declare class DLQ {
     /**
      * list the items in the DLQ
      *
-     * @param cursor - Optional cursor for pagination.
-     * @param count - Optional number of items to return.
-     * @param filter - Optional filter options to apply to the DLQ items.
+     * @param parameters - Optional parameters object
+     * @param parameters.cursor - Optional cursor for pagination
+     * @param parameters.count - Optional number of items to return
+     * @param parameters.filter - Optional filter options to apply to the DLQ items.
      *    The available filter options are:
      *    - `fromDate`: Filter items which entered the DLQ after this date.
      *    - `toDate`: Filter items which entered the DLQ before this date.
      *    - `url`: Filter items by the URL they were sent to.
      *    - `responseStatus`: Filter items by the response status code.
-     * @returns
+     *    - `workflowRunId`: Filter items by workflow run ID.
+     *    - `workflowCreatedAt`: Filter items by workflow creation time.
+     *    - `failureFunctionState`: Filter items by failure callback state.
+     *    - `label`: Filter items by label.
      */
     list(parameters?: {
         cursor?: string;
@@ -649,13 +671,23 @@ declare class DLQ {
      * Retry the failure callback of a workflow run whose failureUrl/failureFunction
      * request has failed.
      *
-     * @param dlqId - The ID of the DLQ message to retry.
-     * @returns
+     * @param dlqId - The ID of the DLQ message to retry
+     * @returns response with workflow run information
      */
     retryFailureFunction({ dlqId }: Pick<DLQResumeRestartOptions<string>, "dlqId">): Promise<DLQResumeRestartResponse & {
         error?: string;
     }>;
+    /**
+     * Handles DLQ options and prepares headers and query parameters.
+     *
+     * @param options - DLQ resume/restart options
+     */
     private static handleDLQOptions;
+    /**
+     * Converts DLQ ID(s) to query parameter string.
+     *
+     * @param dlqId - Single DLQ ID or array of DLQ IDs
+     */
     private static getDlqIdQueryParameter;
 }
 
@@ -877,4 +909,4 @@ declare class Client {
     get dlq(): DLQ;
 }
 
-export { Client, type DLQResumeRestartOptions, type DLQResumeRestartResponse, ExclusiveValidationOptions, NotifyResponse, RawStep, RouteFunction, type StepError, type StepLog, StepType, Telemetry, type TriggerOptions, Waiter, type WorkflowRunLog, type WorkflowRunLogs, WorkflowServeOptions, serve };
+export { Client, type DLQResumeRestartOptions, type DLQResumeRestartResponse, NotifyResponse, RawStep, RouteFunction, type StepError, type StepLog, StepType, Telemetry, type TriggerOptions, Waiter, WorkflowClient, WorkflowMiddleware, WorkflowReceiver, type WorkflowRunLog, type WorkflowRunLogs, WorkflowServeOptions, loggingMiddleware, serve };

package/index.d.ts

@@ -1,34 +1,7 @@
-import { R as RouteFunction, W as WorkflowServeOptions, E as ExclusiveValidationOptions, T as Telemetry, S as StepType, a as RawStep, N as NotifyResponse, b as Waiter } from './types-BD06btU6.js';
-export { A as AsyncStepFunction, C as CallResponse, x as CallSettings, D as DetailedFinishCondition, u as Duration, p as FailureFunctionPayload, F as FinishCondition, H as HeaderParams, z as InvokableWorkflow, y as InvokeStepResponse, I as InvokeWorkflowRequest, L as LazyInvokeStepParams, B as LogLevel, t as NotifyStepResponse, P as ParallelCallState, o as PublicServeOptions, q as RequiredExceptFields, l as Step, n as StepFunction, k as StepTypes, w as StringifyBody, m as SyncStepFunction, v as WaitEventOptions, r as WaitRequest, s as WaitStepResponse, d as WorkflowAbort, i as WorkflowClient, h as WorkflowContext, c as WorkflowError, J as WorkflowLogger, G as WorkflowLoggerOptions, e as WorkflowNonRetryableError, j as WorkflowReceiver, f as WorkflowRetryAfterError, g as WorkflowTool } from './types-BD06btU6.js';
-import { FlowControl, PublishRequest, HTTPMethods, State, Client as Client$1 } from '@upstash/qstash';
+import { S as StepType, R as RawStep, W as WorkflowMiddleware, a as WorkflowClient, b as WorkflowReceiver, c as RouteFunction, d as WorkflowServeOptions, T as Telemetry, N as NotifyResponse, e as Waiter } from './types-pEje3VEB.js';
+export { A as AsyncStepFunction, C as CallResponse, v as CallSettings, D as DetailedFinishCondition, t as Duration, E as ExclusiveValidationOptions, o as FailureFunctionPayload, F as FinishCondition, H as HeaderParams, x as InvokableWorkflow, w as InvokeStepResponse, I as InvokeWorkflowRequest, L as LazyInvokeStepParams, s as NotifyStepResponse, P as ParallelCallState, Q as QStashClientExtraConfig, p as RequiredExceptFields, l as Step, n as StepFunction, k as StepTypes, m as SyncStepFunction, u as WaitEventOptions, q as WaitRequest, r as WaitStepResponse, g as WorkflowAbort, j as WorkflowContext, f as WorkflowError, h as WorkflowNonRetryableError, i as WorkflowRetryAfterError } from './types-pEje3VEB.js';
+import { HTTPMethods, FlowControl, PublishRequest, Client as Client$1 } from '@upstash/qstash';
 import 'zod';
-import 'ai';
-import '@ai-sdk/openai';
-
-/**
- * Creates an async method that handles incoming requests and runs the provided
- * route function as a workflow.
- *
- * Not exported in the package. Instead, used in framework specific serve implementations.
- *
- * Only difference from regular serve is the `useJSONContent` parameter.
- *
- * @param routeFunction - A function that uses WorkflowContext as a parameter and runs a workflow.
- * @param options - Options including the client, onFinish callback, and initialPayloadParser.
- * @returns An async method that consumes incoming requests and runs the workflow.
- */
-declare const serveBase: <TInitialPayload = unknown, TRequest extends Request = Request, TResponse extends Response = Response, TResult = unknown>(routeFunction: RouteFunction<TInitialPayload, TResult>, telemetry?: Telemetry, options?: WorkflowServeOptions<TResponse, TInitialPayload>) => {
-    handler: (request: TRequest) => Promise<TResponse>;
-};
-/**
- * Creates an async method that handles incoming requests and runs the provided
- * route function as a workflow.
- *
- * @param routeFunction - A function that uses WorkflowContext as a parameter and runs a workflow.
- * @param options - Options including the client, onFinish callback, and initialPayloadParser.
- * @returns An async method that consumes incoming requests and runs the workflow.
- */
-declare const serve: <TInitialPayload = unknown, TRequest extends Request = Request, TResponse extends Response = Response, TResult = unknown>(routeFunction: RouteFunction<TInitialPayload, TResult>, options?: Omit<WorkflowServeOptions<TResponse, TInitialPayload>, "useJSONContent" | "schema" | "initialPayloadParser"> & ExclusiveValidationOptions<TInitialPayload>) => ReturnType<typeof serveBase<TInitialPayload, TRequest, TResponse, TResult>>;
 
 type BaseStepLog = {
     /**
@@ -241,7 +214,7 @@ type FailureFunctionLog = {
     /**
      * State of the message published for failure
      */
-    state: State;
+    state: "CALLBACK_INPROGRESS" | "CALLBACK_SUCCESS" | "CALLBACK_FAIL";
     /**
      * Headers received from the step which caused the workflow to fail
      */
@@ -432,13 +405,6 @@ type TriggerOptions = {
      * Can be used to filter the workflow run logs.
      */
     label?: string;
-    /**
-     * Whether to apply the configuration (flow control,
-     * retries, failure url, retry delay) passed in trigger
-     *
-     * @default false
-     */
-    keepTriggerConfig?: boolean;
     /**
      * By default, Workflow SDK sends telemetry about SDK version, framework or runtime.
      *
@@ -447,31 +413,11 @@ type TriggerOptions = {
      * @default false
      */
     disableTelemetry?: boolean;
-} & ({
-    /**
-     * URL to call if the first request to the workflow endpoint fails
-     */
-    failureUrl?: never;
-    /**
-     * Whether the workflow endpoint has a failure function
-     * defined to be invoked if the first request fails.
-     *
-     * If true, the failureUrl will be ignored.
-     */
-    useFailureFunction?: true;
-} | {
     /**
      * URL to call if the first request to the workflow endpoint fails
      */
     failureUrl?: string;
-    /**
-     * Whether the workflow endpoint has a failure function
-     * defined to be invoked if the first request fails.
-     *
-     * If true, the failureUrl will be ignored.
-     */
-    useFailureFunction?: never;
-});
+};
 type DLQResumeRestartOptions<TDLQId extends string | string[] = string | string[]> = {
     dlqId: TDLQId;
 } & Pick<TriggerOptions, "flowControl" | "retries">;
@@ -486,6 +432,78 @@ type DLQResumeRestartResponse = {
     workflowCreatedAt: string;
 };
 
+declare const loggingMiddleware: WorkflowMiddleware<unknown, unknown>;
+
+declare const VALID_REGIONS: readonly ["EU_CENTRAL_1", "US_EAST_1"];
+type QStashRegion = (typeof VALID_REGIONS)[number];
+/**
+ * Regional handler containing client and optional receiver
+ */
+type RegionalHandler = {
+    client: WorkflowClient;
+    receiver?: WorkflowReceiver;
+};
+/**
+ * QStash handlers for single or multi-region mode
+ */
+type QStashHandlers = {
+    mode: "single-region";
+    handlers: RegionalHandler;
+} | {
+    mode: "multi-region";
+    handlers: Record<QStashRegion, RegionalHandler>;
+    defaultRegion: QStashRegion;
+};
+
+type ResponseData = {
+    text: string;
+    status: number;
+    headers: Record<string, string>;
+};
+/**
+ * Internal options for serveBase that are not exposed to users
+ */
+type InternalServeOptions<TResponse extends Response = Response> = {
+    /**
+     * Function to generate a Response from ResponseData
+     */
+    generateResponse: (responseData: ResponseData) => TResponse;
+    /**
+     * Whether the framework should use `content-type: application/json`
+     * in `triggerFirstInvocation`.
+     */
+    useJSONContent: boolean;
+    /**
+     * QStash handlers for single or multi-region mode
+     */
+    qstashHandlers: QStashHandlers;
+};
+
+/**
+ * Creates an async method that handles incoming requests and runs the provided
+ * route function as a workflow.
+ *
+ * Not exported in the package. Instead, used in framework specific serve implementations.
+ *
+ * Only difference from regular serve is the `useJSONContent` parameter.
+ *
+ * @param routeFunction - A function that uses WorkflowContext as a parameter and runs a workflow.
+ * @param options - Options including the client, onFinish callback, and initialPayloadParser.
+ * @returns An async method that consumes incoming requests and runs the workflow.
+ */
+declare const serveBase: <TInitialPayload = unknown, TRequest extends Request = Request, TResponse extends Response = Response, TResult = unknown>(routeFunction: RouteFunction<TInitialPayload, TResult>, telemetry?: Telemetry, options?: WorkflowServeOptions<TInitialPayload, TResult>, internalOptions?: Partial<InternalServeOptions<TResponse>>) => {
+    handler: (request: TRequest) => Promise<TResponse>;
+};
+/**
+ * Creates an async method that handles incoming requests and runs the provided
+ * route function as a workflow.
+ *
+ * @param routeFunction - A function that uses WorkflowContext as a parameter and runs a workflow.
+ * @param options - Options including the client and initialPayloadParser.
+ * @returns An async method that consumes incoming requests and runs the workflow.
+ */
+declare const serve: <TInitialPayload = unknown, TRequest extends Request = Request, TResponse extends Response = Response, TResult = unknown>(routeFunction: RouteFunction<TInitialPayload, TResult>, options?: WorkflowServeOptions<TInitialPayload, TResult>) => ReturnType<typeof serveBase<TInitialPayload, TRequest, TResponse, TResult>>;
+
 type QStashDLQFilterOptions = NonNullable<Required<Parameters<Client$1["dlq"]["listMessages"]>[0]>>["filter"];
 type DLQFilterOptions = Pick<QStashDLQFilterOptions, "fromDate" | "toDate" | "url" | "responseStatus"> & {
     workflowRunId?: string;
@@ -539,15 +557,19 @@ declare class DLQ {
     /**
      * list the items in the DLQ
      *
-     * @param cursor - Optional cursor for pagination.
-     * @param count - Optional number of items to return.
-     * @param filter - Optional filter options to apply to the DLQ items.
+     * @param parameters - Optional parameters object
+     * @param parameters.cursor - Optional cursor for pagination
+     * @param parameters.count - Optional number of items to return
+     * @param parameters.filter - Optional filter options to apply to the DLQ items.
      *    The available filter options are:
      *    - `fromDate`: Filter items which entered the DLQ after this date.
      *    - `toDate`: Filter items which entered the DLQ before this date.
      *    - `url`: Filter items by the URL they were sent to.
      *    - `responseStatus`: Filter items by the response status code.
-     * @returns
+     *    - `workflowRunId`: Filter items by workflow run ID.
+     *    - `workflowCreatedAt`: Filter items by workflow creation time.
+     *    - `failureFunctionState`: Filter items by failure callback state.
+     *    - `label`: Filter items by label.
      */
     list(parameters?: {
         cursor?: string;
@@ -649,13 +671,23 @@ declare class DLQ {
      * Retry the failure callback of a workflow run whose failureUrl/failureFunction
      * request has failed.
      *
-     * @param dlqId - The ID of the DLQ message to retry.
-     * @returns
+     * @param dlqId - The ID of the DLQ message to retry
+     * @returns response with workflow run information
      */
     retryFailureFunction({ dlqId }: Pick<DLQResumeRestartOptions<string>, "dlqId">): Promise<DLQResumeRestartResponse & {
         error?: string;
     }>;
+    /**
+     * Handles DLQ options and prepares headers and query parameters.
+     *
+     * @param options - DLQ resume/restart options
+     */
     private static handleDLQOptions;
+    /**
+     * Converts DLQ ID(s) to query parameter string.
+     *
+     * @param dlqId - Single DLQ ID or array of DLQ IDs
+     */
     private static getDlqIdQueryParameter;
 }
 
@@ -877,4 +909,4 @@ declare class Client {
     get dlq(): DLQ;
 }
 
-export { Client, type DLQResumeRestartOptions, type DLQResumeRestartResponse, ExclusiveValidationOptions, NotifyResponse, RawStep, RouteFunction, type StepError, type StepLog, StepType, Telemetry, type TriggerOptions, Waiter, type WorkflowRunLog, type WorkflowRunLogs, WorkflowServeOptions, serve };
+export { Client, type DLQResumeRestartOptions, type DLQResumeRestartResponse, NotifyResponse, RawStep, RouteFunction, type StepError, type StepLog, StepType, Telemetry, type TriggerOptions, Waiter, WorkflowClient, WorkflowMiddleware, WorkflowReceiver, type WorkflowRunLog, type WorkflowRunLogs, WorkflowServeOptions, loggingMiddleware, serve };