@cloudflare/workers-types 4.20260506.1 → 4.20260508.1

package/experimental/index.d.ts

@@ -14359,28 +14359,16 @@ declare namespace CloudflareWorkersModule {
     attempt: number;
     config: WorkflowStepConfig;
   };
-  export interface RollbackContext<T> {
-    error: Error;
-    output: NonNullable<T> | undefined;
-    stepName: string;
-  }
-  export interface StepPromise<T> extends Promise<T> {
-    rollback(fn: (ctx: RollbackContext<T>) => Promise<void>): StepPromise<T>;
-    rollback(
-      config: WorkflowStepConfig,
-      fn: (ctx: RollbackContext<T>) => Promise<void>,
-    ): StepPromise<T>;
-  }
   export abstract class WorkflowStep {
     do<T extends Rpc.Serializable<T>>(
       name: string,
       callback: (ctx: WorkflowStepContext) => Promise<T>,
-    ): StepPromise<T>;
+    ): Promise<T>;
     do<T extends Rpc.Serializable<T>>(
       name: string,
       config: WorkflowStepConfig,
       callback: (ctx: WorkflowStepContext) => Promise<T>,
-    ): StepPromise<T>;
+    ): Promise<T>;
     sleep: (name: string, duration: WorkflowSleepDuration) => Promise<void>;
     sleepUntil: (name: string, timestamp: Date | number) => Promise<void>;
     waitForEvent<T extends Rpc.Serializable<T>>(
@@ -14389,7 +14377,7 @@ declare namespace CloudflareWorkersModule {
         type: string;
         timeout?: WorkflowTimeoutDuration | number;
       },
-    ): StepPromise<WorkflowStepEvent<T>>;
+    ): Promise<WorkflowStepEvent<T>>;
   }
   export type WorkflowInstanceStatus =
     | "queued"
@@ -15891,6 +15879,27 @@ interface WorkflowError {
   code?: number;
   message: string;
 }
+interface WorkflowInstanceRestartOptions {
+  /**
+   * Restart from a specific step. If omitted, the instance restarts from the beginning.
+   * The step must exist in the instance's execution history.
+   */
+  from?: {
+    /**
+     * The step name as defined in your workflow code.
+     */
+    name: string;
+    /**
+     * 1-indexed occurrence of this step name. Use when the same step name appears multiple times (e.g. in a loop).
+     * @default 1
+     */
+    count?: number;
+    /**
+     * Step type filter. Use when different step types share the same name.
+     */
+    type?: "do" | "sleep" | "waitForEvent";
+  };
+}
 declare abstract class WorkflowInstance {
   public id: string;
   /**
@@ -15906,9 +15915,11 @@ declare abstract class WorkflowInstance {
    */
   public terminate(): Promise<void>;
   /**
-   * Restart the instance.
+   * Restart the instance. Optionally restart from a specific step, preserving
+   * cached results for all steps before it.
+   * @param options Options for the restart, including an optional step to restart from.
    */
-  public restart(): Promise<void>;
+  public restart(options?: WorkflowInstanceRestartOptions): Promise<void>;
   /**
    * Returns the current status of the instance.
    */

package/experimental/index.ts

@@ -14330,28 +14330,16 @@ export declare namespace CloudflareWorkersModule {
     attempt: number;
     config: WorkflowStepConfig;
   };
-  export interface RollbackContext<T> {
-    error: Error;
-    output: NonNullable<T> | undefined;
-    stepName: string;
-  }
-  export interface StepPromise<T> extends Promise<T> {
-    rollback(fn: (ctx: RollbackContext<T>) => Promise<void>): StepPromise<T>;
-    rollback(
-      config: WorkflowStepConfig,
-      fn: (ctx: RollbackContext<T>) => Promise<void>,
-    ): StepPromise<T>;
-  }
   export abstract class WorkflowStep {
     do<T extends Rpc.Serializable<T>>(
       name: string,
       callback: (ctx: WorkflowStepContext) => Promise<T>,
-    ): StepPromise<T>;
+    ): Promise<T>;
     do<T extends Rpc.Serializable<T>>(
       name: string,
       config: WorkflowStepConfig,
       callback: (ctx: WorkflowStepContext) => Promise<T>,
-    ): StepPromise<T>;
+    ): Promise<T>;
     sleep: (name: string, duration: WorkflowSleepDuration) => Promise<void>;
     sleepUntil: (name: string, timestamp: Date | number) => Promise<void>;
     waitForEvent<T extends Rpc.Serializable<T>>(
@@ -14360,7 +14348,7 @@ export declare namespace CloudflareWorkersModule {
         type: string;
         timeout?: WorkflowTimeoutDuration | number;
       },
-    ): StepPromise<WorkflowStepEvent<T>>;
+    ): Promise<WorkflowStepEvent<T>>;
   }
   export type WorkflowInstanceStatus =
     | "queued"
@@ -15843,6 +15831,27 @@ export interface WorkflowError {
   code?: number;
   message: string;
 }
+export interface WorkflowInstanceRestartOptions {
+  /**
+   * Restart from a specific step. If omitted, the instance restarts from the beginning.
+   * The step must exist in the instance's execution history.
+   */
+  from?: {
+    /**
+     * The step name as defined in your workflow code.
+     */
+    name: string;
+    /**
+     * 1-indexed occurrence of this step name. Use when the same step name appears multiple times (e.g. in a loop).
+     * @default 1
+     */
+    count?: number;
+    /**
+     * Step type filter. Use when different step types share the same name.
+     */
+    type?: "do" | "sleep" | "waitForEvent";
+  };
+}
 export declare abstract class WorkflowInstance {
   public id: string;
   /**
@@ -15858,9 +15867,11 @@ export declare abstract class WorkflowInstance {
    */
   public terminate(): Promise<void>;
   /**
-   * Restart the instance.
+   * Restart the instance. Optionally restart from a specific step, preserving
+   * cached results for all steps before it.
+   * @param options Options for the restart, including an optional step to restart from.
    */
-  public restart(): Promise<void>;
+  public restart(options?: WorkflowInstanceRestartOptions): Promise<void>;
   /**
    * Returns the current status of the instance.
    */

package/index.d.ts

@@ -13550,28 +13550,16 @@ declare namespace CloudflareWorkersModule {
     attempt: number;
     config: WorkflowStepConfig;
   };
-  export interface RollbackContext<T> {
-    error: Error;
-    output: NonNullable<T> | undefined;
-    stepName: string;
-  }
-  export interface StepPromise<T> extends Promise<T> {
-    rollback(fn: (ctx: RollbackContext<T>) => Promise<void>): StepPromise<T>;
-    rollback(
-      config: WorkflowStepConfig,
-      fn: (ctx: RollbackContext<T>) => Promise<void>,
-    ): StepPromise<T>;
-  }
   export abstract class WorkflowStep {
     do<T extends Rpc.Serializable<T>>(
       name: string,
       callback: (ctx: WorkflowStepContext) => Promise<T>,
-    ): StepPromise<T>;
+    ): Promise<T>;
     do<T extends Rpc.Serializable<T>>(
       name: string,
       config: WorkflowStepConfig,
       callback: (ctx: WorkflowStepContext) => Promise<T>,
-    ): StepPromise<T>;
+    ): Promise<T>;
     sleep: (name: string, duration: WorkflowSleepDuration) => Promise<void>;
     sleepUntil: (name: string, timestamp: Date | number) => Promise<void>;
     waitForEvent<T extends Rpc.Serializable<T>>(
@@ -13580,7 +13568,7 @@ declare namespace CloudflareWorkersModule {
         type: string;
         timeout?: WorkflowTimeoutDuration | number;
       },
-    ): StepPromise<WorkflowStepEvent<T>>;
+    ): Promise<WorkflowStepEvent<T>>;
   }
   export type WorkflowInstanceStatus =
     | "queued"
@@ -15082,6 +15070,27 @@ interface WorkflowError {
   code?: number;
   message: string;
 }
+interface WorkflowInstanceRestartOptions {
+  /**
+   * Restart from a specific step. If omitted, the instance restarts from the beginning.
+   * The step must exist in the instance's execution history.
+   */
+  from?: {
+    /**
+     * The step name as defined in your workflow code.
+     */
+    name: string;
+    /**
+     * 1-indexed occurrence of this step name. Use when the same step name appears multiple times (e.g. in a loop).
+     * @default 1
+     */
+    count?: number;
+    /**
+     * Step type filter. Use when different step types share the same name.
+     */
+    type?: "do" | "sleep" | "waitForEvent";
+  };
+}
 declare abstract class WorkflowInstance {
   public id: string;
   /**
@@ -15097,9 +15106,11 @@ declare abstract class WorkflowInstance {
    */
   public terminate(): Promise<void>;
   /**
-   * Restart the instance.
+   * Restart the instance. Optionally restart from a specific step, preserving
+   * cached results for all steps before it.
+   * @param options Options for the restart, including an optional step to restart from.
    */
-  public restart(): Promise<void>;
+  public restart(options?: WorkflowInstanceRestartOptions): Promise<void>;
   /**
    * Returns the current status of the instance.
    */

package/index.ts

@@ -13521,28 +13521,16 @@ export declare namespace CloudflareWorkersModule {
     attempt: number;
     config: WorkflowStepConfig;
   };
-  export interface RollbackContext<T> {
-    error: Error;
-    output: NonNullable<T> | undefined;
-    stepName: string;
-  }
-  export interface StepPromise<T> extends Promise<T> {
-    rollback(fn: (ctx: RollbackContext<T>) => Promise<void>): StepPromise<T>;
-    rollback(
-      config: WorkflowStepConfig,
-      fn: (ctx: RollbackContext<T>) => Promise<void>,
-    ): StepPromise<T>;
-  }
   export abstract class WorkflowStep {
     do<T extends Rpc.Serializable<T>>(
       name: string,
       callback: (ctx: WorkflowStepContext) => Promise<T>,
-    ): StepPromise<T>;
+    ): Promise<T>;
     do<T extends Rpc.Serializable<T>>(
       name: string,
       config: WorkflowStepConfig,
       callback: (ctx: WorkflowStepContext) => Promise<T>,
-    ): StepPromise<T>;
+    ): Promise<T>;
     sleep: (name: string, duration: WorkflowSleepDuration) => Promise<void>;
     sleepUntil: (name: string, timestamp: Date | number) => Promise<void>;
     waitForEvent<T extends Rpc.Serializable<T>>(
@@ -13551,7 +13539,7 @@ export declare namespace CloudflareWorkersModule {
         type: string;
         timeout?: WorkflowTimeoutDuration | number;
       },
-    ): StepPromise<WorkflowStepEvent<T>>;
+    ): Promise<WorkflowStepEvent<T>>;
   }
   export type WorkflowInstanceStatus =
     | "queued"
@@ -15034,6 +15022,27 @@ export interface WorkflowError {
   code?: number;
   message: string;
 }
+export interface WorkflowInstanceRestartOptions {
+  /**
+   * Restart from a specific step. If omitted, the instance restarts from the beginning.
+   * The step must exist in the instance's execution history.
+   */
+  from?: {
+    /**
+     * The step name as defined in your workflow code.
+     */
+    name: string;
+    /**
+     * 1-indexed occurrence of this step name. Use when the same step name appears multiple times (e.g. in a loop).
+     * @default 1
+     */
+    count?: number;
+    /**
+     * Step type filter. Use when different step types share the same name.
+     */
+    type?: "do" | "sleep" | "waitForEvent";
+  };
+}
 export declare abstract class WorkflowInstance {
   public id: string;
   /**
@@ -15049,9 +15058,11 @@ export declare abstract class WorkflowInstance {
    */
   public terminate(): Promise<void>;
   /**
-   * Restart the instance.
+   * Restart the instance. Optionally restart from a specific step, preserving
+   * cached results for all steps before it.
+   * @param options Options for the restart, including an optional step to restart from.
    */
-  public restart(): Promise<void>;
+  public restart(options?: WorkflowInstanceRestartOptions): Promise<void>;
   /**
    * Returns the current status of the instance.
    */

package/latest/index.d.ts

@@ -13691,28 +13691,16 @@ declare namespace CloudflareWorkersModule {
     attempt: number;
     config: WorkflowStepConfig;
   };
-  export interface RollbackContext<T> {
-    error: Error;
-    output: NonNullable<T> | undefined;
-    stepName: string;
-  }
-  export interface StepPromise<T> extends Promise<T> {
-    rollback(fn: (ctx: RollbackContext<T>) => Promise<void>): StepPromise<T>;
-    rollback(
-      config: WorkflowStepConfig,
-      fn: (ctx: RollbackContext<T>) => Promise<void>,
-    ): StepPromise<T>;
-  }
   export abstract class WorkflowStep {
     do<T extends Rpc.Serializable<T>>(
       name: string,
       callback: (ctx: WorkflowStepContext) => Promise<T>,
-    ): StepPromise<T>;
+    ): Promise<T>;
     do<T extends Rpc.Serializable<T>>(
       name: string,
       config: WorkflowStepConfig,
       callback: (ctx: WorkflowStepContext) => Promise<T>,
-    ): StepPromise<T>;
+    ): Promise<T>;
     sleep: (name: string, duration: WorkflowSleepDuration) => Promise<void>;
     sleepUntil: (name: string, timestamp: Date | number) => Promise<void>;
     waitForEvent<T extends Rpc.Serializable<T>>(
@@ -13721,7 +13709,7 @@ declare namespace CloudflareWorkersModule {
         type: string;
         timeout?: WorkflowTimeoutDuration | number;
       },
-    ): StepPromise<WorkflowStepEvent<T>>;
+    ): Promise<WorkflowStepEvent<T>>;
   }
   export type WorkflowInstanceStatus =
     | "queued"
@@ -15223,6 +15211,27 @@ interface WorkflowError {
   code?: number;
   message: string;
 }
+interface WorkflowInstanceRestartOptions {
+  /**
+   * Restart from a specific step. If omitted, the instance restarts from the beginning.
+   * The step must exist in the instance's execution history.
+   */
+  from?: {
+    /**
+     * The step name as defined in your workflow code.
+     */
+    name: string;
+    /**
+     * 1-indexed occurrence of this step name. Use when the same step name appears multiple times (e.g. in a loop).
+     * @default 1
+     */
+    count?: number;
+    /**
+     * Step type filter. Use when different step types share the same name.
+     */
+    type?: "do" | "sleep" | "waitForEvent";
+  };
+}
 declare abstract class WorkflowInstance {
   public id: string;
   /**
@@ -15238,9 +15247,11 @@ declare abstract class WorkflowInstance {
    */
   public terminate(): Promise<void>;
   /**
-   * Restart the instance.
+   * Restart the instance. Optionally restart from a specific step, preserving
+   * cached results for all steps before it.
+   * @param options Options for the restart, including an optional step to restart from.
    */
-  public restart(): Promise<void>;
+  public restart(options?: WorkflowInstanceRestartOptions): Promise<void>;
   /**
    * Returns the current status of the instance.
    */

package/latest/index.ts

@@ -13662,28 +13662,16 @@ export declare namespace CloudflareWorkersModule {
     attempt: number;
     config: WorkflowStepConfig;
   };
-  export interface RollbackContext<T> {
-    error: Error;
-    output: NonNullable<T> | undefined;
-    stepName: string;
-  }
-  export interface StepPromise<T> extends Promise<T> {
-    rollback(fn: (ctx: RollbackContext<T>) => Promise<void>): StepPromise<T>;
-    rollback(
-      config: WorkflowStepConfig,
-      fn: (ctx: RollbackContext<T>) => Promise<void>,
-    ): StepPromise<T>;
-  }
   export abstract class WorkflowStep {
     do<T extends Rpc.Serializable<T>>(
       name: string,
       callback: (ctx: WorkflowStepContext) => Promise<T>,
-    ): StepPromise<T>;
+    ): Promise<T>;
     do<T extends Rpc.Serializable<T>>(
       name: string,
       config: WorkflowStepConfig,
       callback: (ctx: WorkflowStepContext) => Promise<T>,
-    ): StepPromise<T>;
+    ): Promise<T>;
     sleep: (name: string, duration: WorkflowSleepDuration) => Promise<void>;
     sleepUntil: (name: string, timestamp: Date | number) => Promise<void>;
     waitForEvent<T extends Rpc.Serializable<T>>(
@@ -13692,7 +13680,7 @@ export declare namespace CloudflareWorkersModule {
         type: string;
         timeout?: WorkflowTimeoutDuration | number;
       },
-    ): StepPromise<WorkflowStepEvent<T>>;
+    ): Promise<WorkflowStepEvent<T>>;
   }
   export type WorkflowInstanceStatus =
     | "queued"
@@ -15175,6 +15163,27 @@ export interface WorkflowError {
   code?: number;
   message: string;
 }
+export interface WorkflowInstanceRestartOptions {
+  /**
+   * Restart from a specific step. If omitted, the instance restarts from the beginning.
+   * The step must exist in the instance's execution history.
+   */
+  from?: {
+    /**
+     * The step name as defined in your workflow code.
+     */
+    name: string;
+    /**
+     * 1-indexed occurrence of this step name. Use when the same step name appears multiple times (e.g. in a loop).
+     * @default 1
+     */
+    count?: number;
+    /**
+     * Step type filter. Use when different step types share the same name.
+     */
+    type?: "do" | "sleep" | "waitForEvent";
+  };
+}
 export declare abstract class WorkflowInstance {
   public id: string;
   /**
@@ -15190,9 +15199,11 @@ export declare abstract class WorkflowInstance {
    */
   public terminate(): Promise<void>;
   /**
-   * Restart the instance.
+   * Restart the instance. Optionally restart from a specific step, preserving
+   * cached results for all steps before it.
+   * @param options Options for the restart, including an optional step to restart from.
    */
-  public restart(): Promise<void>;
+  public restart(options?: WorkflowInstanceRestartOptions): Promise<void>;
   /**
    * Returns the current status of the instance.
    */

package/oldest/index.d.ts

@@ -13550,28 +13550,16 @@ declare namespace CloudflareWorkersModule {
     attempt: number;
     config: WorkflowStepConfig;
   };
-  export interface RollbackContext<T> {
-    error: Error;
-    output: NonNullable<T> | undefined;
-    stepName: string;
-  }
-  export interface StepPromise<T> extends Promise<T> {
-    rollback(fn: (ctx: RollbackContext<T>) => Promise<void>): StepPromise<T>;
-    rollback(
-      config: WorkflowStepConfig,
-      fn: (ctx: RollbackContext<T>) => Promise<void>,
-    ): StepPromise<T>;
-  }
   export abstract class WorkflowStep {
     do<T extends Rpc.Serializable<T>>(
       name: string,
       callback: (ctx: WorkflowStepContext) => Promise<T>,
-    ): StepPromise<T>;
+    ): Promise<T>;
     do<T extends Rpc.Serializable<T>>(
       name: string,
       config: WorkflowStepConfig,
       callback: (ctx: WorkflowStepContext) => Promise<T>,
-    ): StepPromise<T>;
+    ): Promise<T>;
     sleep: (name: string, duration: WorkflowSleepDuration) => Promise<void>;
     sleepUntil: (name: string, timestamp: Date | number) => Promise<void>;
     waitForEvent<T extends Rpc.Serializable<T>>(
@@ -13580,7 +13568,7 @@ declare namespace CloudflareWorkersModule {
         type: string;
         timeout?: WorkflowTimeoutDuration | number;
       },
-    ): StepPromise<WorkflowStepEvent<T>>;
+    ): Promise<WorkflowStepEvent<T>>;
   }
   export type WorkflowInstanceStatus =
     | "queued"
@@ -15082,6 +15070,27 @@ interface WorkflowError {
   code?: number;
   message: string;
 }
+interface WorkflowInstanceRestartOptions {
+  /**
+   * Restart from a specific step. If omitted, the instance restarts from the beginning.
+   * The step must exist in the instance's execution history.
+   */
+  from?: {
+    /**
+     * The step name as defined in your workflow code.
+     */
+    name: string;
+    /**
+     * 1-indexed occurrence of this step name. Use when the same step name appears multiple times (e.g. in a loop).
+     * @default 1
+     */
+    count?: number;
+    /**
+     * Step type filter. Use when different step types share the same name.
+     */
+    type?: "do" | "sleep" | "waitForEvent";
+  };
+}
 declare abstract class WorkflowInstance {
   public id: string;
   /**
@@ -15097,9 +15106,11 @@ declare abstract class WorkflowInstance {
    */
   public terminate(): Promise<void>;
   /**
-   * Restart the instance.
+   * Restart the instance. Optionally restart from a specific step, preserving
+   * cached results for all steps before it.
+   * @param options Options for the restart, including an optional step to restart from.
    */
-  public restart(): Promise<void>;
+  public restart(options?: WorkflowInstanceRestartOptions): Promise<void>;
   /**
    * Returns the current status of the instance.
    */

package/oldest/index.ts

@@ -13521,28 +13521,16 @@ export declare namespace CloudflareWorkersModule {
     attempt: number;
     config: WorkflowStepConfig;
   };
-  export interface RollbackContext<T> {
-    error: Error;
-    output: NonNullable<T> | undefined;
-    stepName: string;
-  }
-  export interface StepPromise<T> extends Promise<T> {
-    rollback(fn: (ctx: RollbackContext<T>) => Promise<void>): StepPromise<T>;
-    rollback(
-      config: WorkflowStepConfig,
-      fn: (ctx: RollbackContext<T>) => Promise<void>,
-    ): StepPromise<T>;
-  }
   export abstract class WorkflowStep {
     do<T extends Rpc.Serializable<T>>(
       name: string,
       callback: (ctx: WorkflowStepContext) => Promise<T>,
-    ): StepPromise<T>;
+    ): Promise<T>;
     do<T extends Rpc.Serializable<T>>(
       name: string,
       config: WorkflowStepConfig,
       callback: (ctx: WorkflowStepContext) => Promise<T>,
-    ): StepPromise<T>;
+    ): Promise<T>;
     sleep: (name: string, duration: WorkflowSleepDuration) => Promise<void>;
     sleepUntil: (name: string, timestamp: Date | number) => Promise<void>;
     waitForEvent<T extends Rpc.Serializable<T>>(
@@ -13551,7 +13539,7 @@ export declare namespace CloudflareWorkersModule {
         type: string;
         timeout?: WorkflowTimeoutDuration | number;
       },
-    ): StepPromise<WorkflowStepEvent<T>>;
+    ): Promise<WorkflowStepEvent<T>>;
   }
   export type WorkflowInstanceStatus =
     | "queued"
@@ -15034,6 +15022,27 @@ export interface WorkflowError {
   code?: number;
   message: string;
 }
+export interface WorkflowInstanceRestartOptions {
+  /**
+   * Restart from a specific step. If omitted, the instance restarts from the beginning.
+   * The step must exist in the instance's execution history.
+   */
+  from?: {
+    /**
+     * The step name as defined in your workflow code.
+     */
+    name: string;
+    /**
+     * 1-indexed occurrence of this step name. Use when the same step name appears multiple times (e.g. in a loop).
+     * @default 1
+     */
+    count?: number;
+    /**
+     * Step type filter. Use when different step types share the same name.
+     */
+    type?: "do" | "sleep" | "waitForEvent";
+  };
+}
 export declare abstract class WorkflowInstance {
   public id: string;
   /**
@@ -15049,9 +15058,11 @@ export declare abstract class WorkflowInstance {
    */
   public terminate(): Promise<void>;
   /**
-   * Restart the instance.
+   * Restart the instance. Optionally restart from a specific step, preserving
+   * cached results for all steps before it.
+   * @param options Options for the restart, including an optional step to restart from.
    */
-  public restart(): Promise<void>;
+  public restart(options?: WorkflowInstanceRestartOptions): Promise<void>;
   /**
    * Returns the current status of the instance.
    */

package/package.json

@@ -7,5 +7,5 @@
   },
   "author": "Cloudflare Workers DevProd Team <workers-devprod@cloudflare.com> (https://workers.cloudflare.com)",
   "license": "MIT OR Apache-2.0",
-  "version": "4.20260506.1"
+  "version": "4.20260508.1"
 }