effect 4.0.0-beta.27 → 4.0.0-beta.29

package/src/Schedule.ts

@@ -523,7 +523,9 @@ export const toStepWithSleep = <Output, Input, Error, Env>(
  *
  * @example
  * ```ts
- * import { Console, Duration, Effect, Schedule } from "effect"
+ * import { Console, Data, Duration, Effect, Schedule } from "effect"
+ *
+ * class RetryAttemptError extends Data.TaggedError("RetryAttemptError")<{ readonly message: string }> {}
  *
  * // Add random jitter to schedule delays
  * const jitteredSchedule = Schedule.addDelay(
@@ -619,7 +621,7 @@ export const toStepWithSleep = <Output, Input, Error, Env>(
  *     Effect.gen(function*() {
  *       attempt++
  *       if (attempt < 5) {
- *         return yield* Effect.fail(new Error(`Attempt ${attempt} failed`))
+ *         return yield* Effect.fail(new RetryAttemptError({ message: `Attempt ${attempt} failed` }))
  *       }
  *       return `Success on attempt ${attempt}`
  *     }),
@@ -640,7 +642,9 @@ export const addDelay: {
    *
    * @example
    * ```ts
-   * import { Console, Duration, Effect, Schedule } from "effect"
+   * import { Console, Data, Duration, Effect, Schedule } from "effect"
+   *
+   * class RetryAttemptError extends Data.TaggedError("RetryAttemptError")<{ readonly message: string }> {}
    *
    * // Add random jitter to schedule delays
    * const jitteredSchedule = Schedule.addDelay(
@@ -736,7 +740,7 @@ export const addDelay: {
    *     Effect.gen(function*() {
    *       attempt++
    *       if (attempt < 5) {
-   *         return yield* Effect.fail(new Error(`Attempt ${attempt} failed`))
+   *         return yield* Effect.fail(new RetryAttemptError({ message: `Attempt ${attempt} failed` }))
    *       }
    *       return `Success on attempt ${attempt}`
    *     }),
@@ -759,7 +763,9 @@ export const addDelay: {
    *
    * @example
    * ```ts
-   * import { Console, Duration, Effect, Schedule } from "effect"
+   * import { Console, Data, Duration, Effect, Schedule } from "effect"
+   *
+   * class RetryAttemptError extends Data.TaggedError("RetryAttemptError")<{ readonly message: string }> {}
    *
    * // Add random jitter to schedule delays
    * const jitteredSchedule = Schedule.addDelay(
@@ -855,7 +861,7 @@ export const addDelay: {
    *     Effect.gen(function*() {
    *       attempt++
    *       if (attempt < 5) {
-   *         return yield* Effect.fail(new Error(`Attempt ${attempt} failed`))
+   *         return yield* Effect.fail(new RetryAttemptError({ message: `Attempt ${attempt} failed` }))
    *       }
    *       return `Success on attempt ${attempt}`
    *     }),
@@ -890,7 +896,9 @@ export const addDelay: {
  *
  * @example
  * ```ts
- * import { Console, Effect, Schedule } from "effect"
+ * import { Console, Data, Effect, Schedule } from "effect"
+ *
+ * class RetryAttemptError extends Data.TaggedError("RetryAttemptError")<{ readonly message: string }> {}
  *
  * // First retry 3 times quickly, then switch to slower retries
  * const quickRetries = Schedule.exponential("100 millis").pipe(
@@ -909,7 +917,7 @@ export const addDelay: {
  *       attempt++
  *       yield* Console.log(`Attempt ${attempt}`)
  *       if (attempt < 6) {
- *         return yield* Effect.fail(new Error(`Failure ${attempt}`))
+ *         return yield* Effect.fail(new RetryAttemptError({ message: `Failure ${attempt}` }))
  *       }
  *       return `Success on attempt ${attempt}`
  *     }),
@@ -929,7 +937,9 @@ export const andThen: {
    *
    * @example
    * ```ts
-   * import { Console, Effect, Schedule } from "effect"
+   * import { Console, Data, Effect, Schedule } from "effect"
+   *
+   * class RetryAttemptError extends Data.TaggedError("RetryAttemptError")<{ readonly message: string }> {}
    *
    * // First retry 3 times quickly, then switch to slower retries
    * const quickRetries = Schedule.exponential("100 millis").pipe(
@@ -948,7 +958,7 @@ export const andThen: {
    *       attempt++
    *       yield* Console.log(`Attempt ${attempt}`)
    *       if (attempt < 6) {
-   *         return yield* Effect.fail(new Error(`Failure ${attempt}`))
+   *         return yield* Effect.fail(new RetryAttemptError({ message: `Failure ${attempt}` }))
    *       }
    *       return `Success on attempt ${attempt}`
    *     }),
@@ -970,7 +980,9 @@ export const andThen: {
    *
    * @example
    * ```ts
-   * import { Console, Effect, Schedule } from "effect"
+   * import { Console, Data, Effect, Schedule } from "effect"
+   *
+   * class RetryAttemptError extends Data.TaggedError("RetryAttemptError")<{ readonly message: string }> {}
    *
    * // First retry 3 times quickly, then switch to slower retries
    * const quickRetries = Schedule.exponential("100 millis").pipe(
@@ -989,7 +1001,7 @@ export const andThen: {
    *       attempt++
    *       yield* Console.log(`Attempt ${attempt}`)
    *       if (attempt < 6) {
-   *         return yield* Effect.fail(new Error(`Failure ${attempt}`))
+   *         return yield* Effect.fail(new RetryAttemptError({ message: `Failure ${attempt}` }))
    *       }
    *       return `Success on attempt ${attempt}`
    *     }),
@@ -1355,7 +1367,9 @@ export const andThenResult: {
  *
  * @example
  * ```ts
- * import { Console, Effect, Schedule } from "effect"
+ * import { Console, Data, Effect, Schedule } from "effect"
+ *
+ * class RetryAttemptError extends Data.TaggedError("RetryAttemptError")<{ readonly message: string }> {}
  *
  * // Both schedules must want to continue for the combined schedule to continue
  * const timeLimit = Schedule.spaced("1 second").pipe(Schedule.take(5)) // max 5 times
@@ -1397,7 +1411,7 @@ export const andThenResult: {
  *       yield* Console.log(`Retry attempt ${attempt}`)
  *
  *       if (attempt < 3) {
- *         return yield* Effect.fail(new Error(`Attempt ${attempt} failed`))
+ *         return yield* Effect.fail(new RetryAttemptError({ message: `Attempt ${attempt} failed` }))
  *       }
  *
  *       return `Success on attempt ${attempt}`
@@ -1423,7 +1437,9 @@ export const both: {
    *
    * @example
    * ```ts
-   * import { Console, Effect, Schedule } from "effect"
+   * import { Console, Data, Effect, Schedule } from "effect"
+   *
+   * class RetryAttemptError extends Data.TaggedError("RetryAttemptError")<{ readonly message: string }> {}
    *
    * // Both schedules must want to continue for the combined schedule to continue
    * const timeLimit = Schedule.spaced("1 second").pipe(Schedule.take(5)) // max 5 times
@@ -1465,7 +1481,7 @@ export const both: {
    *       yield* Console.log(`Retry attempt ${attempt}`)
    *
    *       if (attempt < 3) {
-   *         return yield* Effect.fail(new Error(`Attempt ${attempt} failed`))
+   *         return yield* Effect.fail(new RetryAttemptError({ message: `Attempt ${attempt} failed` }))
    *       }
    *
    *       return `Success on attempt ${attempt}`
@@ -1493,7 +1509,9 @@ export const both: {
    *
    * @example
    * ```ts
-   * import { Console, Effect, Schedule } from "effect"
+   * import { Console, Data, Effect, Schedule } from "effect"
+   *
+   * class RetryAttemptError extends Data.TaggedError("RetryAttemptError")<{ readonly message: string }> {}
    *
    * // Both schedules must want to continue for the combined schedule to continue
    * const timeLimit = Schedule.spaced("1 second").pipe(Schedule.take(5)) // max 5 times
@@ -1535,7 +1553,7 @@ export const both: {
    *       yield* Console.log(`Retry attempt ${attempt}`)
    *
    *       if (attempt < 3) {
-   *         return yield* Effect.fail(new Error(`Attempt ${attempt} failed`))
+   *         return yield* Effect.fail(new RetryAttemptError({ message: `Attempt ${attempt} failed` }))
    *       }
    *
    *       return `Success on attempt ${attempt}`
@@ -1942,7 +1960,9 @@ export const bothWith: {
  *
  * @example
  * ```ts
- * import { Console, Effect, Schedule } from "effect"
+ * import { Console, Data, Effect, Schedule } from "effect"
+ *
+ * class RetryAttemptError extends Data.TaggedError("RetryAttemptError")<{ readonly message: string }> {}
  *
  * // Compose a quick retry phase followed by slower retry phase
  * const fastRetries = Schedule.exponential("100 millis").pipe(
@@ -1966,7 +1986,7 @@ export const bothWith: {
  *       yield* Console.log(`Attempt ${attempt}`)
  *
  *       if (attempt < 7) { // Needs both phases to succeed
- *         return yield* Effect.fail(new Error(`Attempt ${attempt} failed`))
+ *         return yield* Effect.fail(new RetryAttemptError({ message: `Attempt ${attempt} failed` }))
  *       }
  *
  *       return `Success on attempt ${attempt}`
@@ -2005,7 +2025,9 @@ export const compose: {
    *
    * @example
    * ```ts
-   * import { Console, Effect, Schedule } from "effect"
+   * import { Console, Data, Effect, Schedule } from "effect"
+   *
+   * class RetryAttemptError extends Data.TaggedError("RetryAttemptError")<{ readonly message: string }> {}
    *
    * // Compose a quick retry phase followed by slower retry phase
    * const fastRetries = Schedule.exponential("100 millis").pipe(
@@ -2029,7 +2051,7 @@ export const compose: {
    *       yield* Console.log(`Attempt ${attempt}`)
    *
    *       if (attempt < 7) { // Needs both phases to succeed
-   *         return yield* Effect.fail(new Error(`Attempt ${attempt} failed`))
+   *         return yield* Effect.fail(new RetryAttemptError({ message: `Attempt ${attempt} failed` }))
    *       }
    *
    *       return `Success on attempt ${attempt}`
@@ -2070,7 +2092,9 @@ export const compose: {
    *
    * @example
    * ```ts
-   * import { Console, Effect, Schedule } from "effect"
+   * import { Console, Data, Effect, Schedule } from "effect"
+   *
+   * class RetryAttemptError extends Data.TaggedError("RetryAttemptError")<{ readonly message: string }> {}
    *
    * // Compose a quick retry phase followed by slower retry phase
    * const fastRetries = Schedule.exponential("100 millis").pipe(
@@ -2094,7 +2118,7 @@ export const compose: {
    *       yield* Console.log(`Attempt ${attempt}`)
    *
    *       if (attempt < 7) { // Needs both phases to succeed
-   *         return yield* Effect.fail(new Error(`Attempt ${attempt} failed`))
+   *         return yield* Effect.fail(new RetryAttemptError({ message: `Attempt ${attempt} failed` }))
    *       }
    *
    *       return `Success on attempt ${attempt}`
@@ -2541,7 +2565,9 @@ export const collectWhile: {
  *
  * @example
  * ```ts
- * import { Console, Effect, Schedule } from "effect"
+ * import { Console, Data, Effect, Schedule } from "effect"
+ *
+ * class ScheduledTaskError extends Data.TaggedError("ScheduledTaskError")<{ readonly message: string }> {}
  *
  * // Run every minute
  * const everyMinute = Schedule.cron("* * * * *")
@@ -2642,7 +2668,7 @@ export const collectWhile: {
  *       yield* Console.log("Complex scheduled task...")
  *       // Simulate occasional failures
  *       if (Math.random() < 0.3) {
- *         return yield* Effect.fail(new Error("Scheduled task failed"))
+ *         return yield* Effect.fail(new ScheduledTaskError({ message: "Scheduled task failed" }))
  *       }
  *       return "success"
  *     }),
@@ -2665,7 +2691,9 @@ export const cron: {
    *
    * @example
    * ```ts
-   * import { Console, Effect, Schedule } from "effect"
+   * import { Console, Data, Effect, Schedule } from "effect"
+   *
+   * class ScheduledTaskError extends Data.TaggedError("ScheduledTaskError")<{ readonly message: string }> {}
    *
    * // Run every minute
    * const everyMinute = Schedule.cron("* * * * *")
@@ -2766,7 +2794,7 @@ export const cron: {
    *       yield* Console.log("Complex scheduled task...")
    *       // Simulate occasional failures
    *       if (Math.random() < 0.3) {
-   *         return yield* Effect.fail(new Error("Scheduled task failed"))
+   *         return yield* Effect.fail(new ScheduledTaskError({ message: "Scheduled task failed" }))
    *       }
    *       return "success"
    *     }),
@@ -2789,7 +2817,9 @@ export const cron: {
    *
    * @example
    * ```ts
-   * import { Console, Effect, Schedule } from "effect"
+   * import { Console, Data, Effect, Schedule } from "effect"
+   *
+   * class ScheduledTaskError extends Data.TaggedError("ScheduledTaskError")<{ readonly message: string }> {}
    *
    * // Run every minute
    * const everyMinute = Schedule.cron("* * * * *")
@@ -2890,7 +2920,7 @@ export const cron: {
    *       yield* Console.log("Complex scheduled task...")
    *       // Simulate occasional failures
    *       if (Math.random() < 0.3) {
-   *         return yield* Effect.fail(new Error("Scheduled task failed"))
+   *         return yield* Effect.fail(new ScheduledTaskError({ message: "Scheduled task failed" }))
    *       }
    *       return "success"
    *     }),
@@ -3036,7 +3066,9 @@ export const duration = (durationInput: Duration.Input): Schedule<Duration.Durat
  *
  * @example
  * ```ts
- * import { Console, Effect, Schedule } from "effect"
+ * import { Console, Data, Effect, Schedule } from "effect"
+ *
+ * class RetryAttemptError extends Data.TaggedError("RetryAttemptError")<{ readonly message: string }> {}
  *
  * // Run a task for exactly 5 seconds, regardless of how many iterations
  * const fiveSecondSchedule = Schedule.during("5 seconds")
@@ -3098,7 +3130,7 @@ export const duration = (durationInput: Duration.Input): Schedule<Duration.Durat
  *       yield* Console.log(`Retry attempt ${attempt}`)
  *
  *       if (Math.random() < 0.8) { // 80% failure rate
- *         return yield* Effect.fail(new Error(`Attempt ${attempt} failed`))
+ *         return yield* Effect.fail(new RetryAttemptError({ message: `Attempt ${attempt} failed` }))
  *       }
  *
  *       return `Success on attempt ${attempt}`
@@ -3128,7 +3160,9 @@ export const during = (duration: Duration.Input): Schedule<Duration.Duration> =>
  *
  * @example
  * ```ts
- * import { Console, Effect, Schedule } from "effect"
+ * import { Console, Data, Effect, Schedule } from "effect"
+ *
+ * class RetryAttemptError extends Data.TaggedError("RetryAttemptError")<{ readonly message: string }> {}
  *
  * // Either continues as long as at least one schedule wants to continue
  * const timeBasedSchedule = Schedule.spaced("2 seconds").pipe(Schedule.take(3))
@@ -3172,7 +3206,7 @@ export const during = (duration: Duration.Input): Schedule<Duration.Duration> =>
  *       yield* Console.log(`Retry attempt ${attempt}`)
  *
  *       if (attempt < 6) {
- *         return yield* Effect.fail(new Error(`Attempt ${attempt} failed`))
+ *         return yield* Effect.fail(new RetryAttemptError({ message: `Attempt ${attempt} failed` }))
  *       }
  *
  *       return `Success on attempt ${attempt}`
@@ -3198,7 +3232,9 @@ export const either: {
    *
    * @example
    * ```ts
-   * import { Console, Effect, Schedule } from "effect"
+   * import { Console, Data, Effect, Schedule } from "effect"
+   *
+   * class RetryAttemptError extends Data.TaggedError("RetryAttemptError")<{ readonly message: string }> {}
    *
    * // Either continues as long as at least one schedule wants to continue
    * const timeBasedSchedule = Schedule.spaced("2 seconds").pipe(Schedule.take(3))
@@ -3242,7 +3278,7 @@ export const either: {
    *       yield* Console.log(`Retry attempt ${attempt}`)
    *
    *       if (attempt < 6) {
-   *         return yield* Effect.fail(new Error(`Attempt ${attempt} failed`))
+   *         return yield* Effect.fail(new RetryAttemptError({ message: `Attempt ${attempt} failed` }))
    *       }
    *
    *       return `Success on attempt ${attempt}`
@@ -3270,7 +3306,9 @@ export const either: {
    *
    * @example
    * ```ts
-   * import { Console, Effect, Schedule } from "effect"
+   * import { Console, Data, Effect, Schedule } from "effect"
+   *
+   * class RetryAttemptError extends Data.TaggedError("RetryAttemptError")<{ readonly message: string }> {}
    *
    * // Either continues as long as at least one schedule wants to continue
    * const timeBasedSchedule = Schedule.spaced("2 seconds").pipe(Schedule.take(3))
@@ -3314,7 +3352,7 @@ export const either: {
    *       yield* Console.log(`Retry attempt ${attempt}`)
    *
    *       if (attempt < 6) {
-   *         return yield* Effect.fail(new Error(`Attempt ${attempt} failed`))
+   *         return yield* Effect.fail(new RetryAttemptError({ message: `Attempt ${attempt} failed` }))
    *       }
    *
    *       return `Success on attempt ${attempt}`
@@ -3818,7 +3856,9 @@ export const elapsed: Schedule<Duration.Duration> = fromStepWithMetadata(
  *
  * @example
  * ```ts
- * import { Console, Effect, Schedule } from "effect"
+ * import { Console, Data, Effect, Schedule } from "effect"
+ *
+ * class RetryFailure extends Data.TaggedError("RetryFailure")<{ readonly message: string }> {}
  *
  * // Basic exponential backoff with default factor of 2
  * const basicExponential = Schedule.exponential("100 millis")
@@ -3841,7 +3881,7 @@ export const elapsed: Schedule<Duration.Duration> = fromStepWithMetadata(
  *       attempt++
  *       if (attempt < 4) {
  *         yield* Console.log(`Attempt ${attempt} failed, retrying...`)
- *         return yield* Effect.fail(new Error(`Failure ${attempt}`))
+ *         return yield* Effect.fail(new RetryFailure({ message: `Failure ${attempt}` }))
  *       }
  *       return `Success on attempt ${attempt}`
  *     }),
@@ -3875,7 +3915,9 @@ export const exponential = (
  *
  * @example
  * ```ts
- * import { Console, Effect, Schedule } from "effect"
+ * import { Console, Data, Effect, Schedule } from "effect"
+ *
+ * class RetryAttemptError extends Data.TaggedError("RetryAttemptError")<{ readonly message: string }> {}
  *
  * // Basic fibonacci schedule starting with 100ms
  * const fibSchedule = Schedule.fibonacci("100 millis")
@@ -3891,7 +3933,7 @@ export const exponential = (
  *       yield* Console.log(`Attempt ${attempt}`)
  *
  *       if (attempt < 5) {
- *         return yield* Effect.fail(new Error(`Attempt ${attempt} failed`))
+ *         return yield* Effect.fail(new RetryAttemptError({ message: `Attempt ${attempt} failed` }))
  *       }
  *
  *       return `Success on attempt ${attempt}`
@@ -4421,7 +4463,9 @@ export const passthrough = <Output, Input, Error, Env>(
  *
  * @example
  * ```ts
- * import { Console, Effect, Schedule } from "effect"
+ * import { Console, Data, Effect, Schedule } from "effect"
+ *
+ * class RetryAttemptError extends Data.TaggedError("RetryAttemptError")<{ readonly message: string }> {}
  *
  * // Basic recurs - retry at most 3 times
  * const maxThreeAttempts = Schedule.recurs(3)
@@ -4436,7 +4480,7 @@ export const passthrough = <Output, Input, Error, Env>(
  *       yield* Console.log(`Attempt ${attempt}`)
  *
  *       if (attempt < 4) {
- *         return yield* Effect.fail(new Error(`Attempt ${attempt} failed`))
+ *         return yield* Effect.fail(new RetryAttemptError({ message: `Attempt ${attempt} failed` }))
  *       }
  *
  *       return `Success on attempt ${attempt}`
@@ -4906,12 +4950,14 @@ export const spaced = (duration: Duration.Input): Schedule<number> => {
  *
  * @example
  * ```ts
- * import { Console, Effect, Schedule } from "effect"
+ * import { Console, Data, Effect, Schedule } from "effect"
+ *
+ * class RetryError extends Data.TaggedError("RetryError")<{ readonly message: string }> {}
  *
  * // Log retry errors for debugging
  * const errorLoggingSchedule = Schedule.exponential("100 millis").pipe(
  *   Schedule.take(3),
- *   Schedule.tapInput((error: Error) =>
+ *   Schedule.tapInput((error: RetryError) =>
  *     Console.log(`Retry triggered by error: ${String(error)}`)
  *   )
  * )
@@ -4923,7 +4969,7 @@ export const spaced = (duration: Duration.Input): Schedule<number> => {
  *     Effect.gen(function*() {
  *       attempt++
  *       if (attempt < 4) {
- *         return yield* Effect.fail(new Error(`Network timeout on attempt ${attempt}`))
+ *         return yield* Effect.fail(new RetryError({ message: `Network timeout on attempt ${attempt}` }))
  *       }
  *       return `Success on attempt ${attempt}`
  *     }),
@@ -4972,7 +5018,7 @@ export const spaced = (duration: Duration.Input): Schedule<number> => {
  * // Conditional alerting based on input
  * const alertingSchedule = Schedule.exponential("200 millis").pipe(
  *   Schedule.take(6),
- *   Schedule.tapInput((error: Error) =>
+ *   Schedule.tapInput((error: RetryError) =>
  *     Effect.gen(function*() {
  *       if (String(error).includes("critical")) {
  *         yield* Console.log(`🚨 CRITICAL ERROR: ${String(error)}`)
@@ -4994,7 +5040,7 @@ export const spaced = (duration: Duration.Input): Schedule<number> => {
  *       const errorType = isCritical
  *         ? "critical database failure"
  *         : "temporary network issue"
- *       return yield* Effect.fail(new Error(errorType))
+ *       return yield* Effect.fail(new RetryError({ message: errorType }))
  *     }),
  *     alertingSchedule
  *   ).pipe(
@@ -5007,10 +5053,10 @@ export const spaced = (duration: Duration.Input): Schedule<number> => {
  * // Chain multiple input taps for different purposes
  * const comprehensiveSchedule = Schedule.fibonacci("100 millis").pipe(
  *   Schedule.take(5),
- *   Schedule.tapInput((error: Error) =>
- *     Console.log(`Error occurred: ${error.name}`)
+ *   Schedule.tapInput((error: RetryError) =>
+ *     Console.log(`Error occurred: ${error._tag}`)
  *   ),
- *   Schedule.tapInput((error: Error) =>
+ *   Schedule.tapInput((error: RetryError) =>
  *     String(error).length > 20
  *       ? Console.log("📝 Long error message detected")
  *       : Effect.void
@@ -5029,12 +5075,14 @@ export const tapInput: {
    *
    * @example
    * ```ts
-   * import { Console, Effect, Schedule } from "effect"
+   * import { Console, Data, Effect, Schedule } from "effect"
+   *
+   * class RetryError extends Data.TaggedError("RetryError")<{ readonly message: string }> {}
    *
    * // Log retry errors for debugging
    * const errorLoggingSchedule = Schedule.exponential("100 millis").pipe(
    *   Schedule.take(3),
-   *   Schedule.tapInput((error: Error) =>
+   *   Schedule.tapInput((error: RetryError) =>
    *     Console.log(`Retry triggered by error: ${String(error)}`)
    *   )
    * )
@@ -5046,7 +5094,7 @@ export const tapInput: {
    *     Effect.gen(function*() {
    *       attempt++
    *       if (attempt < 4) {
-   *         return yield* Effect.fail(new Error(`Network timeout on attempt ${attempt}`))
+   *         return yield* Effect.fail(new RetryError({ message: `Network timeout on attempt ${attempt}` }))
    *       }
    *       return `Success on attempt ${attempt}`
    *     }),
@@ -5095,7 +5143,7 @@ export const tapInput: {
    * // Conditional alerting based on input
    * const alertingSchedule = Schedule.exponential("200 millis").pipe(
    *   Schedule.take(6),
-   *   Schedule.tapInput((error: Error) =>
+   *   Schedule.tapInput((error: RetryError) =>
    *     Effect.gen(function*() {
    *       if (String(error).includes("critical")) {
    *         yield* Console.log(`🚨 CRITICAL ERROR: ${String(error)}`)
@@ -5117,7 +5165,7 @@ export const tapInput: {
    *       const errorType = isCritical
    *         ? "critical database failure"
    *         : "temporary network issue"
-   *       return yield* Effect.fail(new Error(errorType))
+   *       return yield* Effect.fail(new RetryError({ message: errorType }))
    *     }),
    *     alertingSchedule
    *   ).pipe(
@@ -5130,10 +5178,10 @@ export const tapInput: {
    * // Chain multiple input taps for different purposes
    * const comprehensiveSchedule = Schedule.fibonacci("100 millis").pipe(
    *   Schedule.take(5),
-   *   Schedule.tapInput((error: Error) =>
-   *     Console.log(`Error occurred: ${error.name}`)
+   *   Schedule.tapInput((error: RetryError) =>
+   *     Console.log(`Error occurred: ${error._tag}`)
    *   ),
-   *   Schedule.tapInput((error: Error) =>
+   *   Schedule.tapInput((error: RetryError) =>
    *     String(error).length > 20
    *       ? Console.log("📝 Long error message detected")
    *       : Effect.void
@@ -5154,12 +5202,14 @@ export const tapInput: {
    *
    * @example
    * ```ts
-   * import { Console, Effect, Schedule } from "effect"
+   * import { Console, Data, Effect, Schedule } from "effect"
+   *
+   * class RetryError extends Data.TaggedError("RetryError")<{ readonly message: string }> {}
    *
    * // Log retry errors for debugging
    * const errorLoggingSchedule = Schedule.exponential("100 millis").pipe(
    *   Schedule.take(3),
-   *   Schedule.tapInput((error: Error) =>
+   *   Schedule.tapInput((error: RetryError) =>
    *     Console.log(`Retry triggered by error: ${String(error)}`)
    *   )
    * )
@@ -5171,7 +5221,7 @@ export const tapInput: {
    *     Effect.gen(function*() {
    *       attempt++
    *       if (attempt < 4) {
-   *         return yield* Effect.fail(new Error(`Network timeout on attempt ${attempt}`))
+   *         return yield* Effect.fail(new RetryError({ message: `Network timeout on attempt ${attempt}` }))
    *       }
    *       return `Success on attempt ${attempt}`
    *     }),
@@ -5220,7 +5270,7 @@ export const tapInput: {
    * // Conditional alerting based on input
    * const alertingSchedule = Schedule.exponential("200 millis").pipe(
    *   Schedule.take(6),
-   *   Schedule.tapInput((error: Error) =>
+   *   Schedule.tapInput((error: RetryError) =>
    *     Effect.gen(function*() {
    *       if (String(error).includes("critical")) {
    *         yield* Console.log(`🚨 CRITICAL ERROR: ${String(error)}`)
@@ -5242,7 +5292,7 @@ export const tapInput: {
    *       const errorType = isCritical
    *         ? "critical database failure"
    *         : "temporary network issue"
-   *       return yield* Effect.fail(new Error(errorType))
+   *       return yield* Effect.fail(new RetryError({ message: errorType }))
    *     }),
    *     alertingSchedule
    *   ).pipe(
@@ -5255,10 +5305,10 @@ export const tapInput: {
    * // Chain multiple input taps for different purposes
    * const comprehensiveSchedule = Schedule.fibonacci("100 millis").pipe(
    *   Schedule.take(5),
-   *   Schedule.tapInput((error: Error) =>
-   *     Console.log(`Error occurred: ${error.name}`)
+   *   Schedule.tapInput((error: RetryError) =>
+   *     Console.log(`Error occurred: ${error._tag}`)
    *   ),
-   *   Schedule.tapInput((error: Error) =>
+   *   Schedule.tapInput((error: RetryError) =>
    *     String(error).length > 20
    *       ? Console.log("📝 Long error message detected")
    *       : Effect.void
@@ -5289,7 +5339,9 @@ export const tapInput: {
  *
  * @example
  * ```ts
- * import { Console, Effect, Schedule } from "effect"
+ * import { Console, Data, Effect, Schedule } from "effect"
+ *
+ * class RetryAttemptError extends Data.TaggedError("RetryAttemptError")<{ readonly message: string }> {}
  *
  * // Log schedule outputs for debugging/monitoring
  * const monitoredSchedule = Schedule.exponential("100 millis").pipe(
@@ -5304,7 +5356,7 @@ export const tapInput: {
  *     Effect.gen(function*() {
  *       attempt++
  *       if (attempt < 4) {
- *         return yield* Effect.fail(new Error(`Attempt ${attempt} failed`))
+ *         return yield* Effect.fail(new RetryAttemptError({ message: `Attempt ${attempt} failed` }))
  *       }
  *       return `Success on attempt ${attempt}`
  *     }),
@@ -5373,7 +5425,9 @@ export const tapOutput: {
    *
    * @example
    * ```ts
-   * import { Console, Effect, Schedule } from "effect"
+   * import { Console, Data, Effect, Schedule } from "effect"
+   *
+   * class RetryAttemptError extends Data.TaggedError("RetryAttemptError")<{ readonly message: string }> {}
    *
    * // Log schedule outputs for debugging/monitoring
    * const monitoredSchedule = Schedule.exponential("100 millis").pipe(
@@ -5388,7 +5442,7 @@ export const tapOutput: {
    *     Effect.gen(function*() {
    *       attempt++
    *       if (attempt < 4) {
-   *         return yield* Effect.fail(new Error(`Attempt ${attempt} failed`))
+   *         return yield* Effect.fail(new RetryAttemptError({ message: `Attempt ${attempt} failed` }))
    *       }
    *       return `Success on attempt ${attempt}`
    *     }),
@@ -5459,7 +5513,9 @@ export const tapOutput: {
    *
    * @example
    * ```ts
-   * import { Console, Effect, Schedule } from "effect"
+   * import { Console, Data, Effect, Schedule } from "effect"
+   *
+   * class RetryAttemptError extends Data.TaggedError("RetryAttemptError")<{ readonly message: string }> {}
    *
    * // Log schedule outputs for debugging/monitoring
    * const monitoredSchedule = Schedule.exponential("100 millis").pipe(
@@ -5474,7 +5530,7 @@ export const tapOutput: {
    *     Effect.gen(function*() {
    *       attempt++
    *       if (attempt < 4) {
-   *         return yield* Effect.fail(new Error(`Attempt ${attempt} failed`))
+   *         return yield* Effect.fail(new RetryAttemptError({ message: `Attempt ${attempt} failed` }))
    *       }
    *       return `Success on attempt ${attempt}`
    *     }),
@@ -5555,7 +5611,9 @@ export const tapOutput: {
  *
  * @example
  * ```ts
- * import { Console, Effect, Schedule } from "effect"
+ * import { Console, Data, Effect, Schedule } from "effect"
+ *
+ * class RetryAttemptError extends Data.TaggedError("RetryAttemptError")<{ readonly message: string }> {}
  *
  * // Limit an infinite schedule to run only 5 times
  * const limitedHeartbeat = Schedule.spaced("1 second").pipe(
@@ -5588,7 +5646,7 @@ export const tapOutput: {
  *       yield* Console.log(`Attempt ${attempt}`)
  *
  *       if (attempt < 5) { // Will fail more than 3 times
- *         return yield* Effect.fail(new Error(`Attempt ${attempt} failed`))
+ *         return yield* Effect.fail(new RetryAttemptError({ message: `Attempt ${attempt} failed` }))
  *       }
  *
  *       return `Success on attempt ${attempt}`
@@ -5634,7 +5692,9 @@ export const take: {
    *
    * @example
    * ```ts
-   * import { Console, Effect, Schedule } from "effect"
+   * import { Console, Data, Effect, Schedule } from "effect"
+   *
+   * class RetryAttemptError extends Data.TaggedError("RetryAttemptError")<{ readonly message: string }> {}
    *
    * // Limit an infinite schedule to run only 5 times
    * const limitedHeartbeat = Schedule.spaced("1 second").pipe(
@@ -5667,7 +5727,7 @@ export const take: {
    *       yield* Console.log(`Attempt ${attempt}`)
    *
    *       if (attempt < 5) { // Will fail more than 3 times
-   *         return yield* Effect.fail(new Error(`Attempt ${attempt} failed`))
+   *         return yield* Effect.fail(new RetryAttemptError({ message: `Attempt ${attempt} failed` }))
    *       }
    *
    *       return `Success on attempt ${attempt}`
@@ -5715,7 +5775,9 @@ export const take: {
    *
    * @example
    * ```ts
-   * import { Console, Effect, Schedule } from "effect"
+   * import { Console, Data, Effect, Schedule } from "effect"
+   *
+   * class RetryAttemptError extends Data.TaggedError("RetryAttemptError")<{ readonly message: string }> {}
    *
    * // Limit an infinite schedule to run only 5 times
    * const limitedHeartbeat = Schedule.spaced("1 second").pipe(
@@ -5748,7 +5810,7 @@ export const take: {
    *       yield* Console.log(`Attempt ${attempt}`)
    *
    *       if (attempt < 5) { // Will fail more than 3 times
-   *         return yield* Effect.fail(new Error(`Attempt ${attempt} failed`))
+   *         return yield* Effect.fail(new RetryAttemptError({ message: `Attempt ${attempt} failed` }))
    *       }
    *
    *       return `Success on attempt ${attempt}`