effect 4.0.0-beta.26 → 4.0.0-beta.28

package/dist/Schedule.d.ts

@@ -31,7 +31,7 @@ declare const TypeId = "~effect/Schedule";
  * const program = Effect.gen(function*() {
  *   // Using retry schedule
  *   const result1 = yield* Effect.retry(
- *     Effect.fail("temporary error"),
+ *     Effect.suspend(() => Math.random() > 0.5 ? Effect.fail("temporary error") : Effect.succeed("Success")),
  *     retrySchedule
  *   )
  *
@@ -143,7 +143,7 @@ export declare const CurrentMetadata: ServiceMap.Reference<Metadata<unknown, unk
  *     Effect.gen(function*() {
  *       attempt++
  *       if (attempt < 3) {
- *         yield* Effect.fail(`Attempt ${attempt} failed`)
+ *         return yield* Effect.fail(`Attempt ${attempt} failed`)
  *       }
  *       return `Success on attempt ${attempt}`
  *     }),
@@ -367,7 +367,9 @@ export declare const toStepWithSleep: <Output, Input, Error, Env>(schedule: Sche
  *
  * @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(
@@ -463,7 +465,7 @@ export declare const toStepWithSleep: <Output, Input, Error, Env>(schedule: Sche
  *     Effect.gen(function*() {
  *       attempt++
  *       if (attempt < 5) {
- *         yield* Effect.fail(new Error(`Attempt ${attempt} failed`))
+ *         return yield* Effect.fail(new RetryAttemptError({ message: `Attempt ${attempt} failed` }))
  *       }
  *       return `Success on attempt ${attempt}`
  *     }),
@@ -484,7 +486,9 @@ export declare 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(
@@ -580,7 +584,7 @@ export declare const addDelay: {
      *     Effect.gen(function*() {
      *       attempt++
      *       if (attempt < 5) {
-     *         yield* Effect.fail(new Error(`Attempt ${attempt} failed`))
+     *         return yield* Effect.fail(new RetryAttemptError({ message: `Attempt ${attempt} failed` }))
      *       }
      *       return `Success on attempt ${attempt}`
      *     }),
@@ -601,7 +605,9 @@ export declare 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(
@@ -697,7 +703,7 @@ export declare const addDelay: {
      *     Effect.gen(function*() {
      *       attempt++
      *       if (attempt < 5) {
-     *         yield* Effect.fail(new Error(`Attempt ${attempt} failed`))
+     *         return yield* Effect.fail(new RetryAttemptError({ message: `Attempt ${attempt} failed` }))
      *       }
      *       return `Success on attempt ${attempt}`
      *     }),
@@ -720,7 +726,9 @@ export declare 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(
@@ -739,7 +747,7 @@ export declare const addDelay: {
  *       attempt++
  *       yield* Console.log(`Attempt ${attempt}`)
  *       if (attempt < 6) {
- *         yield* Effect.fail(new Error(`Failure ${attempt}`))
+ *         return yield* Effect.fail(new RetryAttemptError({ message: `Failure ${attempt}` }))
  *       }
  *       return `Success on attempt ${attempt}`
  *     }),
@@ -759,7 +767,9 @@ export declare 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(
@@ -778,7 +788,7 @@ export declare const andThen: {
      *       attempt++
      *       yield* Console.log(`Attempt ${attempt}`)
      *       if (attempt < 6) {
-     *         yield* Effect.fail(new Error(`Failure ${attempt}`))
+     *         return yield* Effect.fail(new RetryAttemptError({ message: `Failure ${attempt}` }))
      *       }
      *       return `Success on attempt ${attempt}`
      *     }),
@@ -798,7 +808,9 @@ export declare 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(
@@ -817,7 +829,7 @@ export declare const andThen: {
      *       attempt++
      *       yield* Console.log(`Attempt ${attempt}`)
      *       if (attempt < 6) {
-     *         yield* Effect.fail(new Error(`Failure ${attempt}`))
+     *         return yield* Effect.fail(new RetryAttemptError({ message: `Failure ${attempt}` }))
      *       }
      *       return `Success on attempt ${attempt}`
      *     }),
@@ -962,7 +974,9 @@ export declare 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
@@ -1004,7 +1018,7 @@ export declare const andThenResult: {
  *       yield* Console.log(`Retry attempt ${attempt}`)
  *
  *       if (attempt < 3) {
- *         yield* Effect.fail(new Error(`Attempt ${attempt} failed`))
+ *         return yield* Effect.fail(new RetryAttemptError({ message: `Attempt ${attempt} failed` }))
  *       }
  *
  *       return `Success on attempt ${attempt}`
@@ -1030,7 +1044,9 @@ export declare 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
@@ -1072,7 +1088,7 @@ export declare const both: {
      *       yield* Console.log(`Retry attempt ${attempt}`)
      *
      *       if (attempt < 3) {
-     *         yield* Effect.fail(new Error(`Attempt ${attempt} failed`))
+     *         return yield* Effect.fail(new RetryAttemptError({ message: `Attempt ${attempt} failed` }))
      *       }
      *
      *       return `Success on attempt ${attempt}`
@@ -1098,7 +1114,9 @@ export declare 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
@@ -1140,7 +1158,7 @@ export declare const both: {
      *       yield* Console.log(`Retry attempt ${attempt}`)
      *
      *       if (attempt < 3) {
-     *         yield* Effect.fail(new Error(`Attempt ${attempt} failed`))
+     *         return yield* Effect.fail(new RetryAttemptError({ message: `Attempt ${attempt} failed` }))
      *       }
      *
      *       return `Success on attempt ${attempt}`
@@ -1485,7 +1503,9 @@ export declare 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(
@@ -1509,7 +1529,7 @@ export declare const bothWith: {
  *       yield* Console.log(`Attempt ${attempt}`)
  *
  *       if (attempt < 7) { // Needs both phases to succeed
- *         yield* Effect.fail(new Error(`Attempt ${attempt} failed`))
+ *         return yield* Effect.fail(new RetryAttemptError({ message: `Attempt ${attempt} failed` }))
  *       }
  *
  *       return `Success on attempt ${attempt}`
@@ -1548,7 +1568,9 @@ export declare 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(
@@ -1572,7 +1594,7 @@ export declare const compose: {
      *       yield* Console.log(`Attempt ${attempt}`)
      *
      *       if (attempt < 7) { // Needs both phases to succeed
-     *         yield* Effect.fail(new Error(`Attempt ${attempt} failed`))
+     *         return yield* Effect.fail(new RetryAttemptError({ message: `Attempt ${attempt} failed` }))
      *       }
      *
      *       return `Success on attempt ${attempt}`
@@ -1611,7 +1633,9 @@ export declare 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(
@@ -1635,7 +1659,7 @@ export declare const compose: {
      *       yield* Console.log(`Attempt ${attempt}`)
      *
      *       if (attempt < 7) { // Needs both phases to succeed
-     *         yield* Effect.fail(new Error(`Attempt ${attempt} failed`))
+     *         return yield* Effect.fail(new RetryAttemptError({ message: `Attempt ${attempt} failed` }))
      *       }
      *
      *       return `Success on attempt ${attempt}`
@@ -2048,7 +2072,9 @@ export declare 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("* * * * *")
@@ -2149,7 +2175,7 @@ export declare const collectWhile: {
  *       yield* Console.log("Complex scheduled task...")
  *       // Simulate occasional failures
  *       if (Math.random() < 0.3) {
- *         yield* Effect.fail(new Error("Scheduled task failed"))
+ *         return yield* Effect.fail(new ScheduledTaskError({ message: "Scheduled task failed" }))
  *       }
  *       return "success"
  *     }),
@@ -2172,7 +2198,9 @@ export declare 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("* * * * *")
@@ -2273,7 +2301,7 @@ export declare const cron: {
      *       yield* Console.log("Complex scheduled task...")
      *       // Simulate occasional failures
      *       if (Math.random() < 0.3) {
-     *         yield* Effect.fail(new Error("Scheduled task failed"))
+     *         return yield* Effect.fail(new ScheduledTaskError({ message: "Scheduled task failed" }))
      *       }
      *       return "success"
      *     }),
@@ -2296,7 +2324,9 @@ export declare 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("* * * * *")
@@ -2397,7 +2427,7 @@ export declare const cron: {
      *       yield* Console.log("Complex scheduled task...")
      *       // Simulate occasional failures
      *       if (Math.random() < 0.3) {
-     *         yield* Effect.fail(new Error("Scheduled task failed"))
+     *         return yield* Effect.fail(new ScheduledTaskError({ message: "Scheduled task failed" }))
      *       }
      *       return "success"
      *     }),
@@ -2515,7 +2545,9 @@ export declare const duration: (durationInput: Duration.Input) => Schedule<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")
@@ -2577,7 +2609,7 @@ export declare const duration: (durationInput: Duration.Input) => Schedule<Durat
  *       yield* Console.log(`Retry attempt ${attempt}`)
  *
  *       if (Math.random() < 0.8) { // 80% failure rate
- *         yield* Effect.fail(new Error(`Attempt ${attempt} failed`))
+ *         return yield* Effect.fail(new RetryAttemptError({ message: `Attempt ${attempt} failed` }))
  *       }
  *
  *       return `Success on attempt ${attempt}`
@@ -2602,7 +2634,9 @@ export declare const during: (duration: Duration.Input) => Schedule<Duration.Dur
  *
  * @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))
@@ -2646,7 +2680,7 @@ export declare const during: (duration: Duration.Input) => Schedule<Duration.Dur
  *       yield* Console.log(`Retry attempt ${attempt}`)
  *
  *       if (attempt < 6) {
- *         yield* Effect.fail(new Error(`Attempt ${attempt} failed`))
+ *         return yield* Effect.fail(new RetryAttemptError({ message: `Attempt ${attempt} failed` }))
  *       }
  *
  *       return `Success on attempt ${attempt}`
@@ -2672,7 +2706,9 @@ export declare 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))
@@ -2716,7 +2752,7 @@ export declare const either: {
      *       yield* Console.log(`Retry attempt ${attempt}`)
      *
      *       if (attempt < 6) {
-     *         yield* Effect.fail(new Error(`Attempt ${attempt} failed`))
+     *         return yield* Effect.fail(new RetryAttemptError({ message: `Attempt ${attempt} failed` }))
      *       }
      *
      *       return `Success on attempt ${attempt}`
@@ -2742,7 +2778,9 @@ export declare 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))
@@ -2786,7 +2824,7 @@ export declare const either: {
      *       yield* Console.log(`Retry attempt ${attempt}`)
      *
      *       if (attempt < 6) {
-     *         yield* Effect.fail(new Error(`Attempt ${attempt} failed`))
+     *         return yield* Effect.fail(new RetryAttemptError({ message: `Attempt ${attempt} failed` }))
      *       }
      *
      *       return `Success on attempt ${attempt}`
@@ -3176,7 +3214,9 @@ export declare const elapsed: Schedule<Duration.Duration>;
  *
  * @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")
@@ -3199,7 +3239,7 @@ export declare const elapsed: Schedule<Duration.Duration>;
  *       attempt++
  *       if (attempt < 4) {
  *         yield* Console.log(`Attempt ${attempt} failed, retrying...`)
- *         yield* Effect.fail(new Error(`Failure ${attempt}`))
+ *         return yield* Effect.fail(new RetryFailure({ message: `Failure ${attempt}` }))
  *       }
  *       return `Success on attempt ${attempt}`
  *     }),
@@ -3223,7 +3263,9 @@ export declare const exponential: (base: Duration.Input, factor?: number) => Sch
  *
  * @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")
@@ -3239,7 +3281,7 @@ export declare const exponential: (base: Duration.Input, factor?: number) => Sch
  *       yield* Console.log(`Attempt ${attempt}`)
  *
  *       if (attempt < 5) {
- *         yield* Effect.fail(new Error(`Attempt ${attempt} failed`))
+ *         return yield* Effect.fail(new RetryAttemptError({ message: `Attempt ${attempt} failed` }))
  *       }
  *
  *       return `Success on attempt ${attempt}`
@@ -3678,7 +3720,9 @@ export declare const passthrough: <Output, Input, Error, Env>(self: Schedule<Out
  *
  * @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)
@@ -3693,7 +3737,7 @@ export declare const passthrough: <Output, Input, Error, Env>(self: Schedule<Out
  *       yield* Console.log(`Attempt ${attempt}`)
  *
  *       if (attempt < 4) {
- *         yield* Effect.fail(new Error(`Attempt ${attempt} failed`))
+ *         return yield* Effect.fail(new RetryAttemptError({ message: `Attempt ${attempt} failed` }))
  *       }
  *
  *       return `Success on attempt ${attempt}`
@@ -4121,12 +4165,14 @@ export declare 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)}`)
  *   )
  * )
@@ -4138,7 +4184,7 @@ export declare const spaced: (duration: Duration.Input) => Schedule<number>;
  *     Effect.gen(function*() {
  *       attempt++
  *       if (attempt < 4) {
- *         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}`
  *     }),
@@ -4187,7 +4233,7 @@ export declare 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)}`)
@@ -4209,7 +4255,7 @@ export declare const spaced: (duration: Duration.Input) => Schedule<number>;
  *       const errorType = isCritical
  *         ? "critical database failure"
  *         : "temporary network issue"
- *       yield* Effect.fail(new Error(errorType))
+ *       return yield* Effect.fail(new RetryError({ message: errorType }))
  *     }),
  *     alertingSchedule
  *   ).pipe(
@@ -4222,10 +4268,10 @@ export declare 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
@@ -4244,12 +4290,14 @@ export declare 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)}`)
      *   )
      * )
@@ -4261,7 +4309,7 @@ export declare const tapInput: {
      *     Effect.gen(function*() {
      *       attempt++
      *       if (attempt < 4) {
-     *         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}`
      *     }),
@@ -4310,7 +4358,7 @@ export declare 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)}`)
@@ -4332,7 +4380,7 @@ export declare const tapInput: {
      *       const errorType = isCritical
      *         ? "critical database failure"
      *         : "temporary network issue"
-     *       yield* Effect.fail(new Error(errorType))
+     *       return yield* Effect.fail(new RetryError({ message: errorType }))
      *     }),
      *     alertingSchedule
      *   ).pipe(
@@ -4345,10 +4393,10 @@ export declare 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
@@ -4367,12 +4415,14 @@ export declare 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)}`)
      *   )
      * )
@@ -4384,7 +4434,7 @@ export declare const tapInput: {
      *     Effect.gen(function*() {
      *       attempt++
      *       if (attempt < 4) {
-     *         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}`
      *     }),
@@ -4433,7 +4483,7 @@ export declare 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)}`)
@@ -4455,7 +4505,7 @@ export declare const tapInput: {
      *       const errorType = isCritical
      *         ? "critical database failure"
      *         : "temporary network issue"
-     *       yield* Effect.fail(new Error(errorType))
+     *       return yield* Effect.fail(new RetryError({ message: errorType }))
      *     }),
      *     alertingSchedule
      *   ).pipe(
@@ -4468,10 +4518,10 @@ export declare 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
@@ -4491,7 +4541,9 @@ export declare 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(
@@ -4506,7 +4558,7 @@ export declare const tapInput: {
  *     Effect.gen(function*() {
  *       attempt++
  *       if (attempt < 4) {
- *         yield* Effect.fail(new Error(`Attempt ${attempt} failed`))
+ *         return yield* Effect.fail(new RetryAttemptError({ message: `Attempt ${attempt} failed` }))
  *       }
  *       return `Success on attempt ${attempt}`
  *     }),
@@ -4575,7 +4627,9 @@ export declare 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(
@@ -4590,7 +4644,7 @@ export declare const tapOutput: {
      *     Effect.gen(function*() {
      *       attempt++
      *       if (attempt < 4) {
-     *         yield* Effect.fail(new Error(`Attempt ${attempt} failed`))
+     *         return yield* Effect.fail(new RetryAttemptError({ message: `Attempt ${attempt} failed` }))
      *       }
      *       return `Success on attempt ${attempt}`
      *     }),
@@ -4659,7 +4713,9 @@ export declare 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(
@@ -4674,7 +4730,7 @@ export declare const tapOutput: {
      *     Effect.gen(function*() {
      *       attempt++
      *       if (attempt < 4) {
-     *         yield* Effect.fail(new Error(`Attempt ${attempt} failed`))
+     *         return yield* Effect.fail(new RetryAttemptError({ message: `Attempt ${attempt} failed` }))
      *       }
      *       return `Success on attempt ${attempt}`
      *     }),
@@ -4744,7 +4800,9 @@ export declare 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(
@@ -4777,7 +4835,7 @@ export declare const tapOutput: {
  *       yield* Console.log(`Attempt ${attempt}`)
  *
  *       if (attempt < 5) { // Will fail more than 3 times
- *         yield* Effect.fail(new Error(`Attempt ${attempt} failed`))
+ *         return yield* Effect.fail(new RetryAttemptError({ message: `Attempt ${attempt} failed` }))
  *       }
  *
  *       return `Success on attempt ${attempt}`
@@ -4823,7 +4881,9 @@ export declare 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(
@@ -4856,7 +4916,7 @@ export declare const take: {
      *       yield* Console.log(`Attempt ${attempt}`)
      *
      *       if (attempt < 5) { // Will fail more than 3 times
-     *         yield* Effect.fail(new Error(`Attempt ${attempt} failed`))
+     *         return yield* Effect.fail(new RetryAttemptError({ message: `Attempt ${attempt} failed` }))
      *       }
      *
      *       return `Success on attempt ${attempt}`
@@ -4902,7 +4962,9 @@ export declare 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(
@@ -4935,7 +4997,7 @@ export declare const take: {
      *       yield* Console.log(`Attempt ${attempt}`)
      *
      *       if (attempt < 5) { // Will fail more than 3 times
-     *         yield* Effect.fail(new Error(`Attempt ${attempt} failed`))
+     *         return yield* Effect.fail(new RetryAttemptError({ message: `Attempt ${attempt} failed` }))
      *       }
      *
      *       return `Success on attempt ${attempt}`