effect 4.0.0 → 4.0.2

package/src/Effect.ts

@@ -8,6 +8,7 @@
  * creating effects, combining them, handling failures, managing resources, and
  * running effect programs.
  *
+ * @stability stable
  * @since 2.0.0
  */
 import type * as Arr from "./Array.ts"
@@ -76,6 +77,7 @@ import type * as Unify from "./Unify.ts"
 /**
  * Type-level identifier for `Effect` values.
  *
+ * @stability stable
  * @category type IDs
  * @since 4.0.0
  */
@@ -84,6 +86,7 @@ export type TypeId = "~effect/Effect"
 /**
  * Runtime identifier used to recognize `Effect` values.
  *
+ * @stability stable
  * @category type IDs
  * @since 4.0.0
  */
@@ -110,6 +113,7 @@ export const TypeId: TypeId = core.EffectTypeId
  * To run an `Effect` value, you need a `Runtime`, which is a type that is
  * capable of executing `Effect` values.
  *
+ * @stability stable
  * @category models
  * @since 2.0.0
  */
@@ -124,6 +128,7 @@ export interface Effect<out A, out E = never, out R = never> extends Pipeable, I
 /**
  * Type-level unification support for `Effect` values.
  *
+ * @stability stable
  * @category models
  * @since 2.0.0
  */
@@ -137,6 +142,7 @@ export interface EffectUnify<A extends { [Unify.typeSymbol]?: any }> {
 /**
  * Type lambda used to represent `Effect` in higher-kinded APIs.
  *
+ * @stability stable
  * @category utility types
  * @since 2.0.0
  */
@@ -147,6 +153,7 @@ export interface EffectTypeLambda extends TypeLambda {
 /**
  * Variance interface for Effect, encoding the type parameters' variance.
  *
+ * @stability stable
  * @category models
  * @since 2.0.0
  */
@@ -167,6 +174,7 @@ export interface Variance<A, E, R> {
  * @see {@link Error} for extracting the failure type from the same `Effect`
  * @see {@link Services} for extracting the required services from the same `Effect`
  *
+ * @stability stable
  * @category utility types
  * @since 2.0.0
  */
@@ -188,6 +196,7 @@ export type Success<T> = T extends Effect<infer _A, infer _E, infer _R> ? _A
  * @see {@link Success} for extracting the success value type instead
  * @see {@link Services} for extracting the required services type instead
  *
+ * @stability stable
  * @category utility types
  * @since 2.0.0
  */
@@ -205,6 +214,7 @@ export type Error<T> = T extends Effect<infer _A, infer _E, infer _R> ? _E
  * @see {@link Success} for extracting the success value type instead
  * @see {@link Error} for extracting the failure type instead
  *
+ * @stability stable
  * @category utility types
  * @since 4.0.0
  */
@@ -223,6 +233,7 @@ export type Services<T> = T extends Effect<infer _A, infer _E, infer _R> ? _R
  * Effect.isEffect("hello") // => false
  * ```
  *
+ * @stability stable
  * @category guards
  * @since 2.0.0
  */
@@ -238,6 +249,7 @@ export const isEffect: (u: unknown) => u is Effect<unknown, unknown, unknown> =
  *
  * @see {@link gen} for writing generator-based `Effect` programs that consume this iterator protocol
  *
+ * @stability stable
  * @category models
  * @since 4.0.0
  */
@@ -255,6 +267,7 @@ export interface EffectIterator<T extends Effect<any, any, any>> {
  * Namespace containing type utilities for the `Effect.all` function, which handles
  * collecting multiple effects into various output structures.
  *
+ * @stability stable
  * @category collecting
  * @since 2.0.0
  */
@@ -485,6 +498,7 @@ export declare namespace All {
  * ```
  *
  * @see {@link forEach} for iterating over elements and applying an effect.
+ * @stability stable
  * @category collecting
  * @since 2.0.0
  */
@@ -526,6 +540,7 @@ export const all: <
  * await Effect.runPromise(program) // => [[1, 3], ['0 is even', '2 is even']]
  * ```
  *
+ * @stability stable
  * @category collecting
  * @since 2.0.0
  */
@@ -554,6 +569,7 @@ export const partition: {
    * await Effect.runPromise(program) // => [[1, 3], ['0 is even', '2 is even']]
    * ```
    *
+   * @stability stable
    * @category collecting
    * @since 2.0.0
    */
@@ -585,6 +601,7 @@ export const partition: {
    * await Effect.runPromise(program) // => [[1, 3], ['0 is even', '2 is even']]
    * ```
    *
+   * @stability stable
    * @category collecting
    * @since 2.0.0
    */
@@ -629,6 +646,7 @@ export const partition: {
  * output // => ["Adding 1 at index 0", "Adding 2 at index 1", "Adding 3 at index 2", 6]
  * ```
  *
+ * @stability stable
  * @category collecting
  * @since 2.0.0
  */
@@ -667,6 +685,7 @@ export const reduce: {
    * output // => ["Adding 1 at index 0", "Adding 2 at index 1", "Adding 3 at index 2", 6]
    * ```
    *
+   * @stability stable
    * @category collecting
    * @since 2.0.0
    */
@@ -705,6 +724,7 @@ export const reduce: {
    * output // => ["Adding 1 at index 0", "Adding 2 at index 1", "Adding 3 at index 2", 6]
    * ```
    *
+   * @stability stable
    * @category collecting
    * @since 2.0.0
    */
@@ -739,6 +759,7 @@ export const reduce: {
  * await Effect.runPromiseExit(program) // => Exit.fail(["0 is even", "2 is even"])
  * ```
  *
+ * @stability stable
  * @category collecting
  * @since 2.0.0
  */
@@ -767,6 +788,7 @@ export const validate: {
    * await Effect.runPromiseExit(program) // => Exit.fail(["0 is even", "2 is even"])
    * ```
    *
+   * @stability stable
    * @category collecting
    * @since 2.0.0
    */
@@ -801,6 +823,7 @@ export const validate: {
    * await Effect.runPromiseExit(program) // => Exit.fail(["0 is even", "2 is even"])
    * ```
    *
+   * @stability stable
    * @category collecting
    * @since 2.0.0
    */
@@ -835,6 +858,7 @@ export const validate: {
    * await Effect.runPromiseExit(program) // => Exit.fail(["0 is even", "2 is even"])
    * ```
    *
+   * @stability stable
    * @category collecting
    * @since 2.0.0
    */
@@ -870,6 +894,7 @@ export const validate: {
    * await Effect.runPromiseExit(program) // => Exit.fail(["0 is even", "2 is even"])
    * ```
    *
+   * @stability stable
    * @category collecting
    * @since 2.0.0
    */
@@ -901,6 +926,7 @@ export const validate: {
  * await Effect.runPromise(program) // => Option.some(3)
  * ```
  *
+ * @stability stable
  * @category collecting
  * @since 2.0.0
  */
@@ -923,6 +949,7 @@ export const findFirst: {
    * await Effect.runPromise(program) // => Option.some(3)
    * ```
    *
+   * @stability stable
    * @category collecting
    * @since 2.0.0
    */
@@ -945,6 +972,7 @@ export const findFirst: {
    * await Effect.runPromise(program) // => Option.some(3)
    * ```
    *
+   * @stability stable
    * @category collecting
    * @since 2.0.0
    */
@@ -969,6 +997,7 @@ export const findFirst: {
  *
  * @see {@link findFirst} for the simpler effectful predicate-based variant
  *
+ * @stability stable
  * @category collecting
  * @since 4.0.0
  */
@@ -988,6 +1017,7 @@ export const findFirstFilter: {
    *
    * @see {@link findFirst} for the simpler effectful predicate-based variant
    *
+   * @stability stable
    * @category collecting
    * @since 4.0.0
    */
@@ -1009,6 +1039,7 @@ export const findFirstFilter: {
    *
    * @see {@link findFirst} for the simpler effectful predicate-based variant
    *
+   * @stability stable
    * @category collecting
    * @since 4.0.0
    */
@@ -1079,6 +1110,7 @@ export const findFirstFilter: {
  * ```
  *
  * @see {@link all} for combining multiple effects into one.
+ * @stability stable
  * @category collecting
  * @since 2.0.0
  */
@@ -1144,6 +1176,7 @@ export const forEach: {
    * ```
    *
    * @see {@link all} for combining multiple effects into one.
+   * @stability stable
    * @category collecting
    * @since 2.0.0
    */
@@ -1214,6 +1247,7 @@ export const forEach: {
    * ```
    *
    * @see {@link all} for combining multiple effects into one.
+   * @stability stable
    * @category collecting
    * @since 2.0.0
    */
@@ -1245,6 +1279,7 @@ export const forEach: {
  * await Effect.runPromise(empty) // => Option.none()
  * ```
  *
+ * @stability stable
  * @category collecting
  * @since 2.0.0
  */
@@ -1273,6 +1308,7 @@ export const head: <A, E, R>(
  * output // => ["Current count: 1", "Current count: 2", "Current count: 3", "Current count: 4", "Current count: 5"]
  * ```
  *
+ * @stability stable
  * @category repetition
  * @since 2.0.0
  */
@@ -1323,6 +1359,7 @@ export const whileLoop: <A, E, R>(options: {
  * ```
  *
  * @see {@link tryPromise} for a version that can handle failures.
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -1397,6 +1434,7 @@ export const promise: <A>(
  * ```
  *
  * @see {@link promise} if the effectful computation is asynchronous and does not throw errors.
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -1468,6 +1506,7 @@ export const tryPromise: {
    * ```
    *
    * @see {@link promise} if the effectful computation is asynchronous and does not throw errors.
+   * @stability stable
    * @category constructors
    * @since 2.0.0
    */
@@ -1539,6 +1578,7 @@ export const tryPromise: {
    * ```
    *
    * @see {@link promise} if the effectful computation is asynchronous and does not throw errors.
+   * @stability stable
    * @category constructors
    * @since 2.0.0
    */
@@ -1569,6 +1609,7 @@ export const tryPromise: {
  * ```
  *
  * @see {@link fail} to create an effect that represents a failure.
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -1587,6 +1628,7 @@ export const succeed: <A>(value: A) => Effect<A> = internal.succeed
  * Effect.runSync(program) // => Option.none()
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -1605,6 +1647,7 @@ export const succeedNone: Effect<Option<never>> = internal.succeedNone
  * Effect.runSync(program) // => Option.some(42)
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -1696,6 +1739,7 @@ export const succeedSome: <A>(value: A) => Effect<Option<A>> = internal.succeedS
  * Effect.runSync(withSuspend(6, 2)) // => 3
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -1739,6 +1783,7 @@ export const suspend: <A, E, R>(
  * ```
  *
  * @see {@link try_ | try} for a version that can handle failures.
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -1749,6 +1794,7 @@ export {
   /**
    * Returns an effect that succeeds with `void`.
    *
+   * @stability stable
    * @category constructors
    * @since 2.0.0
    */
@@ -1760,6 +1806,7 @@ export {
   /**
    * Returns an effect that succeeds with `undefined`.
    *
+   * @stability stable
    * @category constructors
    * @since 4.0.0
    */
@@ -1799,6 +1846,7 @@ export {
  * output // => ["callback completed"]
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -1823,6 +1871,7 @@ export const callback: <A, E = never, R = never>(
  * await Effect.runPromise(program) // => Option.none()
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -1847,6 +1896,7 @@ export const never: Effect<never> = internal.never
  * Effect.runSync(program) // => { x: 2, y: 3, sum: 5 }
  * ```
  *
+ * @stability stable
  * @category do notation
  * @since 2.0.0
  */
@@ -1864,6 +1914,7 @@ export const Do: Effect<{}> = internal.Do
  * @see {@link Do} for starting from an empty accumulated record
  * @see {@link bind} for adding fields produced by effects
  *
+ * @stability stable
  * @category do notation
  * @since 2.0.0
  */
@@ -1880,6 +1931,7 @@ export const bindTo: {
    * @see {@link Do} for starting from an empty accumulated record
    * @see {@link bind} for adding fields produced by effects
    *
+   * @stability stable
    * @category do notation
    * @since 2.0.0
    */
@@ -1896,6 +1948,7 @@ export const bindTo: {
    * @see {@link Do} for starting from an empty accumulated record
    * @see {@link bind} for adding fields produced by effects
    *
+   * @stability stable
    * @category do notation
    * @since 2.0.0
    */
@@ -1936,6 +1989,7 @@ export {
    * @see {@link Do} for starting from an empty accumulated record
    * @see {@link gen} for sequencing without accumulating a record
    *
+   * @stability stable
    * @category do notation
    * @since 2.0.0
    */
@@ -1966,6 +2020,7 @@ export {
  * @see {@link bindTo} for naming the success value of an existing effect
  * @see {@link gen} for generator-based sequencing without accumulating a record
  *
+ * @stability stable
  * @category do notation
  * @since 2.0.0
  */
@@ -1994,6 +2049,7 @@ export const bind: {
    * @see {@link bindTo} for naming the success value of an existing effect
    * @see {@link gen} for generator-based sequencing without accumulating a record
    *
+   * @stability stable
    * @category do notation
    * @since 2.0.0
    */
@@ -2024,6 +2080,7 @@ export const bind: {
    * @see {@link bindTo} for naming the success value of an existing effect
    * @see {@link gen} for generator-based sequencing without accumulating a record
    *
+   * @stability stable
    * @category do notation
    * @since 2.0.0
    */
@@ -2079,6 +2136,7 @@ export const bind: {
  * await Effect.runPromise(program) // => "Final amount to charge: 96"
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -2132,6 +2190,7 @@ export const gen: {
    * await Effect.runPromise(program) // => "Final amount to charge: 96"
    * ```
    *
+   * @stability stable
    * @category constructors
    * @since 2.0.0
    */
@@ -2193,6 +2252,7 @@ export const gen: {
    * await Effect.runPromise(program) // => "Final amount to charge: 96"
    * ```
    *
+   * @stability stable
    * @category constructors
    * @since 2.0.0
    */
@@ -2215,6 +2275,7 @@ export const gen: {
 /**
  * Type helpers for `Effect.gen` generator return signatures.
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -2256,6 +2317,7 @@ export declare namespace gen {
  * ```
  *
  * @see {@link succeed} to create an effect that represents a successful value.
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -2284,6 +2346,7 @@ export const fail: <E>(error: E) => Effect<never, E> = internal.fail
  * Effect.runSync(Effect.flip(program)).operation // => "sync"
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -2315,6 +2378,7 @@ export const failSync: <E>(evaluate: LazyArg<E>) => Effect<never, E> = internal.
  * Effect.runSync(Effect.flip(program)) // => "Network error"
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -2343,6 +2407,7 @@ export const failCause: <E>(cause: Cause.Cause<E>) => Effect<never, E> = interna
  * Effect.runSync(Effect.flip(program)) // => "Error computed at runtime"
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -2385,6 +2450,7 @@ export const failCauseSync: <E>(
  * Effect.runSyncExit(program) // => Exit.die(defect)
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -2459,6 +2525,7 @@ export {
    *
    * @see {@link sync} if the effectful computation is synchronous and does not
    * throw errors.
+   * @stability stable
    * @category constructors
    * @since 2.0.0
    */
@@ -2484,6 +2551,7 @@ export {
  * output // => ["Before yield", "After yield"]
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -2508,6 +2576,7 @@ export const yieldNow: Effect<void> = internal.yieldNow
  * output // => ["High priority task", "Continued after yield"]
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -2526,6 +2595,7 @@ export const yieldNowWith: (priority?: number) => Effect<void> = internal.yieldN
  * Effect.runSync(program) // => "number"
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -2546,6 +2616,7 @@ export const withFiber: <A, E = never, R = never>(
  * Effect.runSync(program) // => "number"
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -2577,6 +2648,7 @@ export const withFiberSucceed: <A, R = never>(
  * output // => [42, "Something went wrong"]
  * ```
  *
+ * @stability stable
  * @category converting
  * @since 4.0.0
  */
@@ -2616,6 +2688,7 @@ export const fromResult: <A, E>(result: Result.Result<A, E>) => Effect<A, E> = i
  * output // => [42, "NoSuchElementError", "missing"]
  * ```
  *
+ * @stability stable
  * @category converting
  * @since 4.0.0
  */
@@ -2663,6 +2736,7 @@ export const fromOption: <
  * Effect.runSync(program) // => Option.some(42)
  * ```
  *
+ * @stability stable
  * @category converting
  * @since 3.13.0
  */
@@ -2692,6 +2766,7 @@ export const transposeOption: <A = never, E = never, R = never>(
  * output // => ["missing", "hello"]
  * ```
  *
+ * @stability stable
  * @category converting
  * @since 4.0.0
  */
@@ -2771,6 +2846,7 @@ export const fromNullishOr: <A>(value: A) => Effect<NonNullable<A>, Cause.NoSuch
  * ```
  *
  * @see {@link tap} for a version that ignores the result of the effect.
+ * @stability stable
  * @category sequencing
  * @since 2.0.0
  */
@@ -2849,6 +2925,7 @@ export const flatMap: {
    * ```
    *
    * @see {@link tap} for a version that ignores the result of the effect.
+   * @stability stable
    * @category sequencing
    * @since 2.0.0
    */
@@ -2927,6 +3004,7 @@ export const flatMap: {
    * ```
    *
    * @see {@link tap} for a version that ignores the result of the effect.
+   * @stability stable
    * @category sequencing
    * @since 2.0.0
    */
@@ -2953,6 +3031,7 @@ export const flatMap: {
  * output // => ["hello"]
  * ```
  *
+ * @stability stable
  * @category sequencing
  * @since 2.0.0
  */
@@ -3037,6 +3116,7 @@ export const flatten: <A, E, R, E2, R2>(self: Effect<Effect<A, E, R>, E2, R2>) =
  * await Effect.runPromise(result2) // => 190
  * ```
  *
+ * @stability stable
  * @category sequencing
  * @since 2.0.0
  */
@@ -3119,6 +3199,7 @@ export const andThen: {
    * await Effect.runPromise(result2) // => 190
    * ```
    *
+   * @stability stable
    * @category sequencing
    * @since 2.0.0
    */
@@ -3201,6 +3282,7 @@ export const andThen: {
    * await Effect.runPromise(result2) // => 190
    * ```
    *
+   * @stability stable
    * @category sequencing
    * @since 2.0.0
    */
@@ -3283,6 +3365,7 @@ export const andThen: {
    * await Effect.runPromise(result2) // => 190
    * ```
    *
+   * @stability stable
    * @category sequencing
    * @since 2.0.0
    */
@@ -3365,6 +3448,7 @@ export const andThen: {
    * await Effect.runPromise(result2) // => 190
    * ```
    *
+   * @stability stable
    * @category sequencing
    * @since 2.0.0
    */
@@ -3419,6 +3503,7 @@ export const andThen: {
  * output // => ["Apply a discount to: 100", 95]
  * ```
  *
+ * @stability stable
  * @category sequencing
  * @since 2.0.0
  */
@@ -3471,6 +3556,7 @@ export const tap: {
    * output // => ["Apply a discount to: 100", 95]
    * ```
    *
+   * @stability stable
    * @category sequencing
    * @since 2.0.0
    */
@@ -3523,6 +3609,7 @@ export const tap: {
    * output // => ["Apply a discount to: 100", 95]
    * ```
    *
+   * @stability stable
    * @category sequencing
    * @since 2.0.0
    */
@@ -3575,6 +3662,7 @@ export const tap: {
    * output // => ["Apply a discount to: 100", 95]
    * ```
    *
+   * @stability stable
    * @category sequencing
    * @since 2.0.0
    */
@@ -3627,6 +3715,7 @@ export const tap: {
    * output // => ["Apply a discount to: 100", 95]
    * ```
    *
+   * @stability stable
    * @category sequencing
    * @since 2.0.0
    */
@@ -3681,6 +3770,7 @@ export const tap: {
  * @see {@link option} for a version that uses `Option` instead.
  * @see {@link exit} for a version that encapsulates both recoverable errors and defects in an `Exit`.
  *
+ * @stability stable
  * @category error handling
  * @since 4.0.0
  */
@@ -3724,6 +3814,7 @@ export const result: <A, E, R>(self: Effect<A, E, R>) => Effect<Result.Result<A,
  * @see {@link result} for a version that uses `Result` instead.
  * @see {@link exit} for a version that encapsulates both recoverable errors and defects in an `Exit`.
  *
+ * @stability stable
  * @category error handling
  * @since 2.0.0
  */
@@ -3766,6 +3857,7 @@ export const option: <A, E, R>(self: Effect<A, E, R>) => Effect<Option<A>, never
  * @see {@link option} for a version that uses `Option` instead.
  * @see {@link result} for a version that uses `Result` instead.
  *
+ * @stability stable
  * @category error handling
  * @since 2.0.0
  */
@@ -3832,6 +3924,7 @@ export const exit: <A, E, R>(
  * @see {@link mapError} for a version that operates on the error channel.
  * @see {@link mapBoth} for a version that operates on both channels.
  * @see {@link flatMap} or {@link andThen} for a version that can return a new effect.
+ * @stability stable
  * @category mapping
  * @since 2.0.0
  */
@@ -3895,6 +3988,7 @@ export const map: {
    * @see {@link mapError} for a version that operates on the error channel.
    * @see {@link mapBoth} for a version that operates on both channels.
    * @see {@link flatMap} or {@link andThen} for a version that can return a new effect.
+   * @stability stable
    * @category mapping
    * @since 2.0.0
    */
@@ -3958,6 +4052,7 @@ export const map: {
    * @see {@link mapError} for a version that operates on the error channel.
    * @see {@link mapBoth} for a version that operates on both channels.
    * @see {@link flatMap} or {@link andThen} for a version that can return a new effect.
+   * @stability stable
    * @category mapping
    * @since 2.0.0
    */
@@ -3991,6 +4086,7 @@ export const map: {
  * @see {@link map} for deriving the replacement value from the success value
  * @see {@link asVoid} for replacing the success value with `void`
  *
+ * @stability stable
  * @category mapping
  * @since 2.0.0
  */
@@ -4022,6 +4118,7 @@ export const as: {
    * @see {@link map} for deriving the replacement value from the success value
    * @see {@link asVoid} for replacing the success value with `void`
    *
+   * @stability stable
    * @category mapping
    * @since 2.0.0
    */
@@ -4053,6 +4150,7 @@ export const as: {
    * @see {@link map} for deriving the replacement value from the success value
    * @see {@link asVoid} for replacing the success value with `void`
    *
+   * @stability stable
    * @category mapping
    * @since 2.0.0
    */
@@ -4072,6 +4170,7 @@ export const as: {
  * Effect.runSync(program) // => Option.some(42)
  * ```
  *
+ * @stability stable
  * @category mapping
  * @since 2.0.0
  */
@@ -4090,6 +4189,7 @@ export const asSome: <A, E, R>(self: Effect<A, E, R>) => Effect<Option<A>, E, R>
  * Effect.runSync(program) // => undefined
  * ```
  *
+ * @stability stable
  * @category mapping
  * @since 2.0.0
  */
@@ -4121,6 +4221,7 @@ export const asVoid: <A, E, R>(self: Effect<A, E, R>) => Effect<void, E, R> = in
  * Effect.runSync(flipped) // => "Oh uh!"
  * ```
  *
+ * @stability stable
  * @category mapping
  * @since 2.0.0
  */
@@ -4181,6 +4282,7 @@ export const flip: <A, E, R>(self: Effect<A, E, R>) => Effect<E, A, R> = interna
  * @see {@link zipWith} for a version that combines the results with a custom function.
  * @see {@link all} for collecting a larger structure of effects.
  *
+ * @stability stable
  * @category zipping
  * @since 2.0.0
  */
@@ -4240,6 +4342,7 @@ export const zip: {
    * @see {@link zipWith} for a version that combines the results with a custom function.
    * @see {@link all} for collecting a larger structure of effects.
    *
+   * @stability stable
    * @category zipping
    * @since 2.0.0
    */
@@ -4302,6 +4405,7 @@ export const zip: {
    * @see {@link zipWith} for a version that combines the results with a custom function.
    * @see {@link all} for collecting a larger structure of effects.
    *
+   * @stability stable
    * @category zipping
    * @since 2.0.0
    */
@@ -4346,6 +4450,7 @@ export const zip: {
  * Effect.runSync(task3) // => 6
  * ```
  *
+ * @stability stable
  * @category zipping
  * @since 2.0.0
  */
@@ -4384,6 +4489,7 @@ export const zipWith: {
    * Effect.runSync(task3) // => 6
    * ```
    *
+   * @stability stable
    * @category zipping
    * @since 2.0.0
    */
@@ -4426,6 +4532,7 @@ export const zipWith: {
    * Effect.runSync(task3) // => 6
    * ```
    *
+   * @stability stable
    * @category zipping
    * @since 2.0.0
    */
@@ -4474,6 +4581,7 @@ export {
    *
    * @see {@link catchCause} for a version that can recover from both recoverable and unrecoverable errors.
    *
+   * @stability stable
    * @category error handling
    * @since 4.0.0
    */
@@ -4524,6 +4632,7 @@ export {
  * @see {@link catchTags} for handling multiple tagged errors in one call
  * @see {@link catchIf} for recovering from errors that match a predicate
  *
+ * @stability stable
  * @category error handling
  * @since 2.0.0
  */
@@ -4572,6 +4681,7 @@ export const catchTag: {
    * @see {@link catchTags} for handling multiple tagged errors in one call
    * @see {@link catchIf} for recovering from errors that match a predicate
    *
+   * @stability stable
    * @category error handling
    * @since 2.0.0
    */
@@ -4643,6 +4753,7 @@ export const catchTag: {
    * @see {@link catchTags} for handling multiple tagged errors in one call
    * @see {@link catchIf} for recovering from errors that match a predicate
    *
+   * @stability stable
    * @category error handling
    * @since 2.0.0
    */
@@ -4717,6 +4828,7 @@ export const catchTag: {
  * Effect.runSync(handled) // => "Network error: 503"
  * ```
  *
+ * @stability stable
  * @category error handling
  * @since 2.0.0
  */
@@ -4765,6 +4877,7 @@ export const catchTags: {
    * Effect.runSync(handled) // => "Network error: 503"
    * ```
    *
+   * @stability stable
    * @category error handling
    * @since 2.0.0
    */
@@ -4842,6 +4955,7 @@ export const catchTags: {
    * Effect.runSync(handled) // => "Network error: 503"
    * ```
    *
+   * @stability stable
    * @category error handling
    * @since 2.0.0
    */
@@ -4924,6 +5038,7 @@ export const catchTags: {
  *
  * @see {@link catchReasons} for handling several nested reason tags
  *
+ * @stability stable
  * @category error handling
  * @since 4.0.0
  */
@@ -4974,6 +5089,7 @@ export const catchReason: {
    *
    * @see {@link catchReasons} for handling several nested reason tags
    *
+   * @stability stable
    * @category error handling
    * @since 4.0.0
    */
@@ -5053,6 +5169,7 @@ export const catchReason: {
    *
    * @see {@link catchReasons} for handling several nested reason tags
    *
+   * @stability stable
    * @category error handling
    * @since 4.0.0
    */
@@ -5119,6 +5236,7 @@ export const catchReason: {
  * Effect.runSync(handled) // => "Quota exceeded: 100"
  * ```
  *
+ * @stability stable
  * @category error handling
  * @since 4.0.0
  */
@@ -5159,6 +5277,7 @@ export const catchReasons: {
    * Effect.runSync(handled) // => "Quota exceeded: 100"
    * ```
    *
+   * @stability stable
    * @category error handling
    * @since 4.0.0
    */
@@ -5239,6 +5358,7 @@ export const catchReasons: {
    * Effect.runSync(handled) // => "Quota exceeded: 100"
    * ```
    *
+   * @stability stable
    * @category error handling
    * @since 4.0.0
    */
@@ -5303,6 +5423,7 @@ export const catchReasons: {
  * @see {@link catchReason} for handling one nested reason tag
  * @see {@link catchReasons} for handling several nested reason tags
  *
+ * @stability stable
  * @category error handling
  * @since 4.0.0
  */
@@ -5341,6 +5462,7 @@ export type TagsWithReason<E> = {
  * Effect.runSync(Effect.flip(unwrapped))._tag // => "RateLimitError"
  * ```
  *
+ * @stability stable
  * @category error handling
  * @since 4.0.0
  */
@@ -5376,6 +5498,7 @@ export const unwrapReason: {
    * Effect.runSync(Effect.flip(unwrapped))._tag // => "RateLimitError"
    * ```
    *
+   * @stability stable
    * @category error handling
    * @since 4.0.0
    */
@@ -5414,6 +5537,7 @@ export const unwrapReason: {
    * Effect.runSync(Effect.flip(unwrapped))._tag // => "RateLimitError"
    * ```
    *
+   * @stability stable
    * @category error handling
    * @since 4.0.0
    */
@@ -5466,6 +5590,7 @@ export const unwrapReason: {
  * output // => ["Caught defect", "Recovered from defect"]
  * ```
  *
+ * @stability stable
  * @category error handling
  * @since 4.0.0
  */
@@ -5511,6 +5636,7 @@ export const catchCause: {
    * output // => ["Caught defect", "Recovered from defect"]
    * ```
    *
+   * @stability stable
    * @category error handling
    * @since 4.0.0
    */
@@ -5556,6 +5682,7 @@ export const catchCause: {
    * output // => ["Caught defect", "Recovered from defect"]
    * ```
    *
+   * @stability stable
    * @category error handling
    * @since 4.0.0
    */
@@ -5602,6 +5729,7 @@ export const catchCause: {
  * output // => ["Caught defect: Unexpected error", "Recovered from defect"]
  * ```
  *
+ * @stability stable
  * @category error handling
  * @since 4.0.0
  */
@@ -5646,6 +5774,7 @@ export const catchDefect: {
    * output // => ["Caught defect: Unexpected error", "Recovered from defect"]
    * ```
    *
+   * @stability stable
    * @category error handling
    * @since 4.0.0
    */
@@ -5690,6 +5819,7 @@ export const catchDefect: {
    * output // => ["Caught defect: Unexpected error", "Recovered from defect"]
    * ```
    *
+   * @stability stable
    * @category error handling
    * @since 4.0.0
    */
@@ -5737,6 +5867,7 @@ export const catchDefect: {
  * Effect.runSync(Effect.all([recovered, recovered2])) // => ['missing:user-1', 'missing:user-1']
  * ```
  *
+ * @stability stable
  * @category error handling
  * @since 2.0.0
  */
@@ -5782,6 +5913,7 @@ export const catchIf: {
    * Effect.runSync(Effect.all([recovered, recovered2])) // => ['missing:user-1', 'missing:user-1']
    * ```
    *
+   * @stability stable
    * @category error handling
    * @since 2.0.0
    */
@@ -5833,6 +5965,7 @@ export const catchIf: {
    * Effect.runSync(Effect.all([recovered, recovered2])) // => ['missing:user-1', 'missing:user-1']
    * ```
    *
+   * @stability stable
    * @category error handling
    * @since 2.0.0
    */
@@ -5884,6 +6017,7 @@ export const catchIf: {
    * Effect.runSync(Effect.all([recovered, recovered2])) // => ['missing:user-1', 'missing:user-1']
    * ```
    *
+   * @stability stable
    * @category error handling
    * @since 2.0.0
    */
@@ -5934,6 +6068,7 @@ export const catchIf: {
    * Effect.runSync(Effect.all([recovered, recovered2])) // => ['missing:user-1', 'missing:user-1']
    * ```
    *
+   * @stability stable
    * @category error handling
    * @since 2.0.0
    */
@@ -5966,6 +6101,7 @@ export const catchIf: {
  * @see {@link catchTags} for recovering from several tagged errors
  * @see {@link catchCauseFilter} for filtering full causes instead of typed errors
  *
+ * @stability stable
  * @category error handling
  * @since 4.0.0
  */
@@ -5991,6 +6127,7 @@ export const catchFilter: {
    * @see {@link catchTags} for recovering from several tagged errors
    * @see {@link catchCauseFilter} for filtering full causes instead of typed errors
    *
+   * @stability stable
    * @category error handling
    * @since 4.0.0
    */
@@ -6022,6 +6159,7 @@ export const catchFilter: {
    * @see {@link catchTags} for recovering from several tagged errors
    * @see {@link catchCauseFilter} for filtering full causes instead of typed errors
    *
+   * @stability stable
    * @category error handling
    * @since 4.0.0
    */
@@ -6064,6 +6202,7 @@ export const catchFilter: {
  * @see {@link fromNullishOr} for converting nullish values into `NoSuchElementError`
  * @see {@link option} for converting any failure into `Option.none`
  *
+ * @stability stable
  * @category error handling
  * @since 4.0.0
  */
@@ -6111,6 +6250,7 @@ export const catchNoSuchElement: <A, E, R>(
  * @see {@link catchCauseFilter} for selecting full causes with a `Filter`
  * @see {@link catchIf} for predicate-based recovery from typed errors
  *
+ * @stability stable
  * @category error handling
  * @since 4.0.0
  */
@@ -6155,6 +6295,7 @@ export const catchCauseIf: {
    * @see {@link catchCauseFilter} for selecting full causes with a `Filter`
    * @see {@link catchIf} for predicate-based recovery from typed errors
    *
+   * @stability stable
    * @category error handling
    * @since 4.0.0
    */
@@ -6202,6 +6343,7 @@ export const catchCauseIf: {
    * @see {@link catchCauseFilter} for selecting full causes with a `Filter`
    * @see {@link catchIf} for predicate-based recovery from typed errors
    *
+   * @stability stable
    * @category error handling
    * @since 4.0.0
    */
@@ -6231,6 +6373,7 @@ export const catchCauseIf: {
  * @see {@link catchFilter} for filtering typed error values instead of full causes
  * @see {@link catchCause} for recovering from every cause without filtering
  *
+ * @stability stable
  * @category error handling
  * @since 4.0.0
  */
@@ -6254,6 +6397,7 @@ export const catchCauseFilter: {
    * @see {@link catchFilter} for filtering typed error values instead of full causes
    * @see {@link catchCause} for recovering from every cause without filtering
    *
+   * @stability stable
    * @category error handling
    * @since 4.0.0
    */
@@ -6280,6 +6424,7 @@ export const catchCauseFilter: {
    * @see {@link catchFilter} for filtering typed error values instead of full causes
    * @see {@link catchCause} for recovering from every cause without filtering
    *
+   * @stability stable
    * @category error handling
    * @since 4.0.0
    */
@@ -6326,6 +6471,7 @@ export const catchCauseFilter: {
  * @see {@link map} for a version that operates on the success channel.
  * @see {@link mapBoth} for a version that operates on both channels.
  *
+ * @stability stable
  * @category error handling
  * @since 2.0.0
  */
@@ -6366,6 +6512,7 @@ export const mapError: {
    * @see {@link map} for a version that operates on the success channel.
    * @see {@link mapBoth} for a version that operates on both channels.
    *
+   * @stability stable
    * @category error handling
    * @since 2.0.0
    */
@@ -6406,6 +6553,7 @@ export const mapError: {
    * @see {@link map} for a version that operates on the success channel.
    * @see {@link mapBoth} for a version that operates on both channels.
    *
+   * @stability stable
    * @category error handling
    * @since 2.0.0
    */
@@ -6450,6 +6598,7 @@ export const mapError: {
  * @see {@link map} for a version that operates on the success channel.
  * @see {@link mapError} for a version that operates on the error channel.
  *
+ * @stability stable
  * @category mapping
  * @since 2.0.0
  */
@@ -6492,6 +6641,7 @@ export const mapBoth: {
    * @see {@link map} for a version that operates on the success channel.
    * @see {@link mapError} for a version that operates on the error channel.
    *
+   * @stability stable
    * @category mapping
    * @since 2.0.0
    */
@@ -6536,6 +6686,7 @@ export const mapBoth: {
    * @see {@link map} for a version that operates on the success channel.
    * @see {@link mapError} for a version that operates on the error channel.
    *
+   * @stability stable
    * @category mapping
    * @since 2.0.0
    */
@@ -6573,6 +6724,7 @@ export const mapBoth: {
  * Effect.runSyncExit(program) // => Exit.die(new DivideByZeroError())
  * ```
  *
+ * @stability stable
  * @category error handling
  * @since 2.0.0
  */
@@ -6607,6 +6759,7 @@ export const orDie: <A, E, R>(self: Effect<A, E, R>) => Effect<A, never, R> = in
  * output // => ["expected error: NetworkError", Exit.fail("NetworkError")]
  * ```
  *
+ * @stability stable
  * @category error handling
  * @since 2.0.0
  */
@@ -6640,6 +6793,7 @@ export const tapError: {
    * output // => ["expected error: NetworkError", Exit.fail("NetworkError")]
    * ```
    *
+   * @stability stable
    * @category error handling
    * @since 2.0.0
    */
@@ -6673,6 +6827,7 @@ export const tapError: {
    * output // => ["expected error: NetworkError", Exit.fail("NetworkError")]
    * ```
    *
+   * @stability stable
    * @category error handling
    * @since 2.0.0
    */
@@ -6713,6 +6868,7 @@ export const tapError: {
  * output // => ["expected error: 504", Exit.fail(new NetworkError({ statusCode: 504 }))]
  * ```
  *
+ * @stability stable
  * @category error handling
  * @since 2.0.0
  */
@@ -6751,6 +6907,7 @@ export const tapErrorTag: {
    * output // => ["expected error: 504", Exit.fail(new NetworkError({ statusCode: 504 }))]
    * ```
    *
+   * @stability stable
    * @category error handling
    * @since 2.0.0
    */
@@ -6792,6 +6949,7 @@ export const tapErrorTag: {
    * output // => ["expected error: 504", Exit.fail(new NetworkError({ statusCode: 504 }))]
    * ```
    *
+   * @stability stable
    * @category error handling
    * @since 2.0.0
    */
@@ -6842,6 +7000,7 @@ export const tapErrorTag: {
  * output // => ["Logging cause: Something went wrong", Exit.fail("Something went wrong")]
  * ```
  *
+ * @stability stable
  * @category error handling
  * @since 4.0.0
  */
@@ -6878,6 +7037,7 @@ export const tapCause: {
    * output // => ["Logging cause: Something went wrong", Exit.fail("Something went wrong")]
    * ```
    *
+   * @stability stable
    * @category error handling
    * @since 4.0.0
    */
@@ -6914,6 +7074,7 @@ export const tapCause: {
    * output // => ["Logging cause: Something went wrong", Exit.fail("Something went wrong")]
    * ```
    *
+   * @stability stable
    * @category error handling
    * @since 4.0.0
    */
@@ -6948,6 +7109,7 @@ export const tapCause: {
  * output // => ["Logging failure cause: Network timeout", Exit.fail("Network timeout")]
  * ```
  *
+ * @stability stable
  * @category error handling
  * @since 4.0.0
  */
@@ -6980,6 +7142,7 @@ export const tapCauseIf: {
    * output // => ["Logging failure cause: Network timeout", Exit.fail("Network timeout")]
    * ```
    *
+   * @stability stable
    * @category error handling
    * @since 4.0.0
    */
@@ -7015,6 +7178,7 @@ export const tapCauseIf: {
    * output // => ["Logging failure cause: Network timeout", Exit.fail("Network timeout")]
    * ```
    *
+   * @stability stable
    * @category error handling
    * @since 4.0.0
    */
@@ -7044,6 +7208,7 @@ export const tapCauseIf: {
  * @see {@link tapCause} for observing every failure cause
  * @see {@link catchCauseFilter} for recovering from selected causes instead of only observing them
  *
+ * @stability stable
  * @category error handling
  * @since 4.0.0
  */
@@ -7067,6 +7232,7 @@ export const tapCauseFilter: {
    * @see {@link tapCause} for observing every failure cause
    * @see {@link catchCauseFilter} for recovering from selected causes instead of only observing them
    *
+   * @stability stable
    * @category error handling
    * @since 4.0.0
    */
@@ -7093,6 +7259,7 @@ export const tapCauseFilter: {
    * @see {@link tapCause} for observing every failure cause
    * @see {@link catchCauseFilter} for recovering from selected causes instead of only observing them
    *
+   * @stability stable
    * @category error handling
    * @since 4.0.0
    */
@@ -7134,6 +7301,7 @@ export const tapCauseFilter: {
  * output // => ["defect: Something went wrong", Exit.die("Something went wrong")]
  * ```
  *
+ * @stability stable
  * @category error handling
  * @since 2.0.0
  */
@@ -7169,6 +7337,7 @@ export const tapDefect: {
    * output // => ["defect: Something went wrong", Exit.die("Something went wrong")]
    * ```
    *
+   * @stability stable
    * @category error handling
    * @since 2.0.0
    */
@@ -7204,6 +7373,7 @@ export const tapDefect: {
    * output // => ["defect: Something went wrong", Exit.die("Something went wrong")]
    * ```
    *
+   * @stability stable
    * @category error handling
    * @since 2.0.0
    */
@@ -7240,6 +7410,7 @@ export const tapDefect: {
  * output // => ["Attempt 1", "Attempt 2", "Attempt 3", "Ready"]
  * ```
  *
+ * @stability stable
  * @category repetition
  * @since 2.0.0
  */
@@ -7252,6 +7423,7 @@ export const eventually: <A, E, R>(self: Effect<A, E, R>) => Effect<A, never, R>
 /**
  * Type helpers for retrying effects.
  *
+ * @stability stable
  * @category error handling
  * @since 2.0.0
  */
@@ -7347,6 +7519,7 @@ export declare namespace Retry {
  *
  * @see {@link retryOrElse} for a version that allows you to run a fallback.
  * @see {@link repeat} if your retry condition is based on successful outcomes rather than errors.
+ * @stability stable
  * @category error handling
  * @since 2.0.0
  */
@@ -7399,6 +7572,7 @@ export const retry: {
    *
    * @see {@link retryOrElse} for a version that allows you to run a fallback.
    * @see {@link repeat} if your retry condition is based on successful outcomes rather than errors.
+   * @stability stable
    * @category error handling
    * @since 2.0.0
    */
@@ -7451,6 +7625,7 @@ export const retry: {
    *
    * @see {@link retryOrElse} for a version that allows you to run a fallback.
    * @see {@link repeat} if your retry condition is based on successful outcomes rather than errors.
+   * @stability stable
    * @category error handling
    * @since 2.0.0
    */
@@ -7503,6 +7678,7 @@ export const retry: {
    *
    * @see {@link retryOrElse} for a version that allows you to run a fallback.
    * @see {@link repeat} if your retry condition is based on successful outcomes rather than errors.
+   * @stability stable
    * @category error handling
    * @since 2.0.0
    */
@@ -7559,6 +7735,7 @@ export const retry: {
    *
    * @see {@link retryOrElse} for a version that allows you to run a fallback.
    * @see {@link repeat} if your retry condition is based on successful outcomes rather than errors.
+   * @stability stable
    * @category error handling
    * @since 2.0.0
    */
@@ -7611,6 +7788,7 @@ export const retry: {
    *
    * @see {@link retryOrElse} for a version that allows you to run a fallback.
    * @see {@link repeat} if your retry condition is based on successful outcomes rather than errors.
+   * @stability stable
    * @category error handling
    * @since 2.0.0
    */
@@ -7663,6 +7841,7 @@ export const retry: {
    *
    * @see {@link retryOrElse} for a version that allows you to run a fallback.
    * @see {@link repeat} if your retry condition is based on successful outcomes rather than errors.
+   * @stability stable
    * @category error handling
    * @since 2.0.0
    */
@@ -7724,6 +7903,7 @@ export const retry: {
  * ```
  *
  * @see {@link retry} for a version that does not run a fallback effect.
+ * @stability stable
  * @category error handling
  * @since 2.0.0
  */
@@ -7778,6 +7958,7 @@ export const retryOrElse: {
    * ```
    *
    * @see {@link retry} for a version that does not run a fallback effect.
+   * @stability stable
    * @category error handling
    * @since 2.0.0
    */
@@ -7835,6 +8016,7 @@ export const retryOrElse: {
    * ```
    *
    * @see {@link retry} for a version that does not run a fallback effect.
+   * @stability stable
    * @category error handling
    * @since 2.0.0
    */
@@ -7870,6 +8052,7 @@ export const retryOrElse: {
  * Effect.runSync(program) // => "Caught cause: Something went wrong"
  * ```
  *
+ * @stability stable
  * @category error handling
  * @since 2.0.0
  */
@@ -7916,6 +8099,7 @@ export const sandbox: <A, E, R>(
  * Effect.runSync(program) // => undefined
  * ```
  *
+ * @stability stable
  * @category error handling
  * @since 2.0.0
  */
@@ -7960,6 +8144,7 @@ export const ignore: <
  * Effect.runSync(program) // => undefined
  * ```
  *
+ * @stability stable
  * @category error handling
  * @since 4.0.0
  */
@@ -8052,6 +8237,7 @@ export const ignoreCause: <
  * events // => ["AttemptStart:0", "AttemptFailure:0", "AttemptStart:1", "AttemptSuccess:1"]
  * ```
  *
+ * @stability unstable
  * @category error handling
  * @since 3.16.0
  */
@@ -8128,6 +8314,7 @@ export const withExecutionPlan: {
    * events // => ["AttemptStart:0", "AttemptFailure:0", "AttemptStart:1", "AttemptSuccess:1"]
    * ```
    *
+   * @stability unstable
    * @category error handling
    * @since 3.16.0
    */
@@ -8211,6 +8398,7 @@ export const withExecutionPlan: {
    * events // => ["AttemptStart:0", "AttemptFailure:0", "AttemptStart:1", "AttemptSuccess:1"]
    * ```
    *
+   * @stability unstable
    * @category error handling
    * @since 3.16.0
    */
@@ -8231,6 +8419,7 @@ export const withExecutionPlan: {
  * If the `defectsOnly` option is set to `true`, only defects (unrecoverable
  * errors) will be reported, while regular failures will be ignored.
  *
+ * @stability unstable
  * @category error handling
  * @since 4.0.0
  */
@@ -8280,6 +8469,7 @@ export const withErrorReporting: <
  * Effect.runSyncExit(program) // => Exit.succeed(0)
  * ```
  *
+ * @stability stable
  * @category error handling
  * @since 2.0.0
  */
@@ -8320,6 +8510,7 @@ export const orElseSucceed: {
    * Effect.runSyncExit(program) // => Exit.succeed(0)
    * ```
    *
+   * @stability stable
    * @category error handling
    * @since 2.0.0
    */
@@ -8360,6 +8551,7 @@ export const orElseSucceed: {
    * Effect.runSyncExit(program) // => Exit.succeed(0)
    * ```
    *
+   * @stability stable
    * @category error handling
    * @since 2.0.0
    */
@@ -8406,6 +8598,7 @@ export const orElseSucceed: {
  * Effect.runSync(program) // => "secondary result"
  * ```
  *
+ * @stability stable
  * @category error handling
  * @since 2.0.0
  */
@@ -8451,6 +8644,7 @@ export const firstSuccessOf: <Eff extends Effect<any, any, any>>(
  * @see {@link timeoutOption} for returning `Option.none` on timeout.
  * @see {@link timeoutOrElse} for a version that allows specifying both success and timeout handlers.
  *
+ * @stability stable
  * @category delays & timeouts
  * @since 2.0.0
  */
@@ -8493,6 +8687,7 @@ export const timeout: {
    * @see {@link timeoutOption} for returning `Option.none` on timeout.
    * @see {@link timeoutOrElse} for a version that allows specifying both success and timeout handlers.
    *
+   * @stability stable
    * @category delays & timeouts
    * @since 2.0.0
    */
@@ -8535,6 +8730,7 @@ export const timeout: {
    * @see {@link timeoutOption} for returning `Option.none` on timeout.
    * @see {@link timeoutOrElse} for a version that allows specifying both success and timeout handlers.
    *
+   * @stability stable
    * @category delays & timeouts
    * @since 2.0.0
    */
@@ -8568,6 +8764,7 @@ export const timeout: {
  * @see {@link timeout} for a version that raises a `TimeoutError`.
  * @see {@link timeoutOrElse} for a version that allows specifying both success and timeout handlers.
  *
+ * @stability stable
  * @category delays & timeouts
  * @since 3.1.0
  */
@@ -8599,6 +8796,7 @@ export const timeoutOption: {
    * @see {@link timeout} for a version that raises a `TimeoutError`.
    * @see {@link timeoutOrElse} for a version that allows specifying both success and timeout handlers.
    *
+   * @stability stable
    * @category delays & timeouts
    * @since 3.1.0
    */
@@ -8630,6 +8828,7 @@ export const timeoutOption: {
    * @see {@link timeout} for a version that raises a `TimeoutError`.
    * @see {@link timeoutOrElse} for a version that allows specifying both success and timeout handlers.
    *
+   * @stability stable
    * @category delays & timeouts
    * @since 3.1.0
    */
@@ -8660,6 +8859,7 @@ export const timeoutOption: {
  * @see {@link timeout} for failing with a `TimeoutError`.
  * @see {@link timeoutOption} for returning `Option.none` on timeout.
  *
+ * @stability stable
  * @category delays & timeouts
  * @since 4.0.0
  */
@@ -8688,6 +8888,7 @@ export const timeoutOrElse: {
    * @see {@link timeout} for failing with a `TimeoutError`.
    * @see {@link timeoutOption} for returning `Option.none` on timeout.
    *
+   * @stability stable
    * @category delays & timeouts
    * @since 4.0.0
    */
@@ -8721,6 +8922,7 @@ export const timeoutOrElse: {
    * @see {@link timeout} for failing with a `TimeoutError`.
    * @see {@link timeoutOption} for returning `Option.none` on timeout.
    *
+   * @stability stable
    * @category delays & timeouts
    * @since 4.0.0
    */
@@ -8749,6 +8951,7 @@ export const timeoutOrElse: {
  * output // => ["Delayed message"]
  * ```
  *
+ * @stability stable
  * @category delays & timeouts
  * @since 2.0.0
  */
@@ -8769,6 +8972,7 @@ export const delay: {
    * output // => ["Delayed message"]
    * ```
    *
+   * @stability stable
    * @category delays & timeouts
    * @since 2.0.0
    */
@@ -8789,6 +8993,7 @@ export const delay: {
    * output // => ["Delayed message"]
    * ```
    *
+   * @stability stable
    * @category delays & timeouts
    * @since 2.0.0
    */
@@ -8815,6 +9020,7 @@ export const delay: {
  * output // => ["Start", "End"]
  * ```
  *
+ * @stability stable
  * @category delays & timeouts
  * @since 2.0.0
  */
@@ -8841,6 +9047,7 @@ export const sleep: (duration: Duration.Input) => Effect<void> = internal.sleep
  * Effect.runSync(program) // => "ok"
  * ```
  *
+ * @stability stable
  * @category delays & timeouts
  * @since 2.0.0
  */
@@ -8879,6 +9086,7 @@ export const timed: <A, E, R>(self: Effect<A, E, R>) => Effect<[duration: Durati
  * ```
  *
  * @see {@link race} for a version that handles only two effects.
+ * @stability stable
  * @category racing
  * @since 2.0.0
  */
@@ -8915,6 +9123,7 @@ export const raceAll: <Eff extends Effect<any, any, any>>(
  * await Effect.runPromise(Effect.flip(raced)) // => "First failed"
  * ```
  *
+ * @stability stable
  * @category racing
  * @since 4.0.0
  */
@@ -8955,6 +9164,7 @@ export const raceAllFirst: <Eff extends Effect<any, any, any>>(
  * output // => ["winner: slow-success"]
  * ```
  *
+ * @stability stable
  * @category racing
  * @since 2.0.0
  */
@@ -8985,6 +9195,7 @@ export const race: {
    * output // => ["winner: slow-success"]
    * ```
    *
+   * @stability stable
    * @category racing
    * @since 2.0.0
    */
@@ -9022,6 +9233,7 @@ export const race: {
    * output // => ["winner: slow-success"]
    * ```
    *
+   * @stability stable
    * @category racing
    * @since 2.0.0
    */
@@ -9070,6 +9282,7 @@ export const race: {
  * output // => ["failed: fast-fail"]
  * ```
  *
+ * @stability stable
  * @category racing
  * @since 2.0.0
  */
@@ -9108,6 +9321,7 @@ export const raceFirst: {
    * output // => ["failed: fast-fail"]
    * ```
    *
+   * @stability stable
    * @category racing
    * @since 2.0.0
    */
@@ -9153,6 +9367,7 @@ export const raceFirst: {
    * output // => ["failed: fast-fail"]
    * ```
    *
+   * @stability stable
    * @category racing
    * @since 2.0.0
    */
@@ -9192,6 +9407,7 @@ export const raceFirst: {
  * output // => [[2, 4], [2, 3]]
  * ```
  *
+ * @stability stable
  * @category collecting
  * @since 2.0.0
  */
@@ -9221,6 +9437,7 @@ export const filter: {
    * output // => [[2, 4], [2, 3]]
    * ```
    *
+   * @stability stable
    * @category collecting
    * @since 2.0.0
    */
@@ -9250,6 +9467,7 @@ export const filter: {
    * output // => [[2, 4], [2, 3]]
    * ```
    *
+   * @stability stable
    * @category collecting
    * @since 2.0.0
    */
@@ -9279,6 +9497,7 @@ export const filter: {
    * output // => [[2, 4], [2, 3]]
    * ```
    *
+   * @stability stable
    * @category collecting
    * @since 2.0.0
    */
@@ -9311,6 +9530,7 @@ export const filter: {
    * output // => [[2, 4], [2, 3]]
    * ```
    *
+   * @stability stable
    * @category collecting
    * @since 2.0.0
    */
@@ -9340,6 +9560,7 @@ export const filter: {
    * output // => [[2, 4], [2, 3]]
    * ```
    *
+   * @stability stable
    * @category collecting
    * @since 2.0.0
    */
@@ -9369,6 +9590,7 @@ export const filter: {
    * output // => [[2, 4], [2, 3]]
    * ```
    *
+   * @stability stable
    * @category collecting
    * @since 2.0.0
    */
@@ -9395,6 +9617,7 @@ export const filter: {
  * @see {@link filter} for keeping original elements with a boolean predicate, refinement, or effectful predicate
  * @see {@link filterMapEffect} for using an effectful `Filter`
  *
+ * @stability stable
  * @category collecting
  * @since 2.0.0
  */
@@ -9415,6 +9638,7 @@ export const filterMap: {
    * @see {@link filter} for keeping original elements with a boolean predicate, refinement, or effectful predicate
    * @see {@link filterMapEffect} for using an effectful `Filter`
    *
+   * @stability stable
    * @category collecting
    * @since 2.0.0
    */
@@ -9435,6 +9659,7 @@ export const filterMap: {
    * @see {@link filter} for keeping original elements with a boolean predicate, refinement, or effectful predicate
    * @see {@link filterMapEffect} for using an effectful `Filter`
    *
+   * @stability stable
    * @category collecting
    * @since 2.0.0
    */
@@ -9462,6 +9687,7 @@ export const filterMap: {
  * @see {@link filterMap} for using a synchronous `Filter`
  * @see {@link filter} for keeping original elements with a predicate
  *
+ * @stability stable
  * @category collecting
  * @since 4.0.0
  */
@@ -9487,6 +9713,7 @@ export const filterMapEffect: {
    * @see {@link filterMap} for using a synchronous `Filter`
    * @see {@link filter} for keeping original elements with a predicate
    *
+   * @stability stable
    * @category collecting
    * @since 4.0.0
    */
@@ -9515,6 +9742,7 @@ export const filterMapEffect: {
    * @see {@link filterMap} for using a synchronous `Filter`
    * @see {@link filter} for keeping original elements with a predicate
    *
+   * @stability stable
    * @category collecting
    * @since 4.0.0
    */
@@ -9558,6 +9786,7 @@ export const filterMapEffect: {
  * Effect.runSync(filtered) // => "Number 5 is odd"
  * ```
  *
+ * @stability stable
  * @category filtering
  * @since 2.0.0
  */
@@ -9595,6 +9824,7 @@ export const filterOrElse: {
    * Effect.runSync(filtered) // => "Number 5 is odd"
    * ```
    *
+   * @stability stable
    * @category filtering
    * @since 2.0.0
    */
@@ -9635,6 +9865,7 @@ export const filterOrElse: {
    * Effect.runSync(filtered) // => "Number 5 is odd"
    * ```
    *
+   * @stability stable
    * @category filtering
    * @since 2.0.0
    */
@@ -9675,6 +9906,7 @@ export const filterOrElse: {
    * Effect.runSync(filtered) // => "Number 5 is odd"
    * ```
    *
+   * @stability stable
    * @category filtering
    * @since 2.0.0
    */
@@ -9716,6 +9948,7 @@ export const filterOrElse: {
    * Effect.runSync(filtered) // => "Number 5 is odd"
    * ```
    *
+   * @stability stable
    * @category filtering
    * @since 2.0.0
    */
@@ -9743,6 +9976,7 @@ export const filterOrElse: {
  * @see {@link filterOrElse} for using a predicate and fallback effect
  * @see {@link filterMapOrFail} for failing the effect when the filter fails
  *
+ * @stability stable
  * @category filtering
  * @since 4.0.0
  */
@@ -9764,6 +9998,7 @@ export const filterMapOrElse: {
    * @see {@link filterOrElse} for using a predicate and fallback effect
    * @see {@link filterMapOrFail} for failing the effect when the filter fails
    *
+   * @stability stable
    * @category filtering
    * @since 4.0.0
    */
@@ -9788,6 +10023,7 @@ export const filterMapOrElse: {
    * @see {@link filterOrElse} for using a predicate and fallback effect
    * @see {@link filterMapOrFail} for failing the effect when the filter fails
    *
+   * @stability stable
    * @category filtering
    * @since 4.0.0
    */
@@ -9825,6 +10061,7 @@ export const filterMapOrElse: {
  * Effect.runSync(Effect.flip(filtered)) // => "Expected even number, got 5"
  * ```
  *
+ * @stability stable
  * @category filtering
  * @since 2.0.0
  */
@@ -9856,6 +10093,7 @@ export const filterOrFail: {
    * Effect.runSync(Effect.flip(filtered)) // => "Expected even number, got 5"
    * ```
    *
+   * @stability stable
    * @category filtering
    * @since 2.0.0
    */
@@ -9890,6 +10128,7 @@ export const filterOrFail: {
    * Effect.runSync(Effect.flip(filtered)) // => "Expected even number, got 5"
    * ```
    *
+   * @stability stable
    * @category filtering
    * @since 2.0.0
    */
@@ -9924,6 +10163,7 @@ export const filterOrFail: {
    * Effect.runSync(Effect.flip(filtered)) // => "Expected even number, got 5"
    * ```
    *
+   * @stability stable
    * @category filtering
    * @since 2.0.0
    */
@@ -9955,6 +10195,7 @@ export const filterOrFail: {
    * Effect.runSync(Effect.flip(filtered)) // => "Expected even number, got 5"
    * ```
    *
+   * @stability stable
    * @category filtering
    * @since 2.0.0
    */
@@ -9986,6 +10227,7 @@ export const filterOrFail: {
    * Effect.runSync(Effect.flip(filtered)) // => "Expected even number, got 5"
    * ```
    *
+   * @stability stable
    * @category filtering
    * @since 2.0.0
    */
@@ -10021,6 +10263,7 @@ export const filterOrFail: {
    * Effect.runSync(Effect.flip(filtered)) // => "Expected even number, got 5"
    * ```
    *
+   * @stability stable
    * @category filtering
    * @since 2.0.0
    */
@@ -10056,6 +10299,7 @@ export const filterOrFail: {
    * Effect.runSync(Effect.flip(filtered)) // => "Expected even number, got 5"
    * ```
    *
+   * @stability stable
    * @category filtering
    * @since 2.0.0
    */
@@ -10087,6 +10331,7 @@ export const filterOrFail: {
    * Effect.runSync(Effect.flip(filtered)) // => "Expected even number, got 5"
    * ```
    *
+   * @stability stable
    * @category filtering
    * @since 2.0.0
    */
@@ -10110,6 +10355,7 @@ export const filterOrFail: {
  * @see {@link filterOrFail} for validating with a predicate instead of a `Filter`
  * @see {@link filterMap} for filtering and mapping iterable elements
  *
+ * @stability stable
  * @category filtering
  * @since 4.0.0
  */
@@ -10131,6 +10377,7 @@ export const filterMapOrFail: {
    * @see {@link filterOrFail} for validating with a predicate instead of a `Filter`
    * @see {@link filterMap} for filtering and mapping iterable elements
    *
+   * @stability stable
    * @category filtering
    * @since 4.0.0
    */
@@ -10152,6 +10399,7 @@ export const filterMapOrFail: {
    * @see {@link filterOrFail} for validating with a predicate instead of a `Filter`
    * @see {@link filterMap} for filtering and mapping iterable elements
    *
+   * @stability stable
    * @category filtering
    * @since 4.0.0
    */
@@ -10173,6 +10421,7 @@ export const filterMapOrFail: {
    * @see {@link filterOrFail} for validating with a predicate instead of a `Filter`
    * @see {@link filterMap} for filtering and mapping iterable elements
    *
+   * @stability stable
    * @category filtering
    * @since 4.0.0
    */
@@ -10198,6 +10447,7 @@ export const filterMapOrFail: {
    * @see {@link filterOrFail} for validating with a predicate instead of a `Filter`
    * @see {@link filterMap} for filtering and mapping iterable elements
    *
+   * @stability stable
    * @category filtering
    * @since 4.0.0
    */
@@ -10241,6 +10491,7 @@ export const filterMapOrFail: {
  * output // => ["Condition is true!", Option.some(undefined)]
  * ```
  *
+ * @stability stable
  * @category filtering
  * @since 2.0.0
  */
@@ -10282,6 +10533,7 @@ export const when: {
    * output // => ["Condition is true!", Option.some(undefined)]
    * ```
    *
+   * @stability stable
    * @category filtering
    * @since 2.0.0
    */
@@ -10323,6 +10575,7 @@ export const when: {
    * output // => ["Condition is true!", Option.some(undefined)]
    * ```
    *
+   * @stability stable
    * @category filtering
    * @since 2.0.0
    */
@@ -10380,6 +10633,7 @@ export const when: {
  * ```
  *
  * @see {@link matchEffect} if you need to perform side effects in the handlers.
+ * @stability stable
  * @category pattern matching
  * @since 2.0.0
  */
@@ -10435,6 +10689,7 @@ export const match: {
    * ```
    *
    * @see {@link matchEffect} if you need to perform side effects in the handlers.
+   * @stability stable
    * @category pattern matching
    * @since 2.0.0
    */
@@ -10495,6 +10750,7 @@ export const match: {
    * ```
    *
    * @see {@link matchEffect} if you need to perform side effects in the handlers.
+   * @stability stable
    * @category pattern matching
    * @since 2.0.0
    */
@@ -10543,6 +10799,7 @@ export const match: {
  *
  * @see {@link match} for the non-eager version.
  * @see {@link matchEffect} if you need to perform side effects in the handlers.
+ * @stability stable
  * @category pattern matching
  * @since 4.0.0
  */
@@ -10583,6 +10840,7 @@ export const matchEager: {
    *
    * @see {@link match} for the non-eager version.
    * @see {@link matchEffect} if you need to perform side effects in the handlers.
+   * @stability stable
    * @category pattern matching
    * @since 4.0.0
    */
@@ -10628,6 +10886,7 @@ export const matchEager: {
    *
    * @see {@link match} for the non-eager version.
    * @see {@link matchEffect} if you need to perform side effects in the handlers.
+   * @stability stable
    * @category pattern matching
    * @since 4.0.0
    */
@@ -10671,6 +10930,7 @@ export const matchEager: {
  * @see {@link matchCauseEffect} if you need to perform side effects in the
  * handlers.
  * @see {@link match} if you don't need to handle the cause of the failure.
+ * @stability stable
  * @category pattern matching
  * @since 2.0.0
  */
@@ -10706,6 +10966,7 @@ export const matchCause: {
    * @see {@link matchCauseEffect} if you need to perform side effects in the
    * handlers.
    * @see {@link match} if you don't need to handle the cause of the failure.
+   * @stability stable
    * @category pattern matching
    * @since 2.0.0
    */
@@ -10746,6 +11007,7 @@ export const matchCause: {
    * @see {@link matchCauseEffect} if you need to perform side effects in the
    * handlers.
    * @see {@link match} if you don't need to handle the cause of the failure.
+   * @stability stable
    * @category pattern matching
    * @since 2.0.0
    */
@@ -10784,6 +11046,7 @@ export const matchCause: {
  * Effect.runSync(handleResult) // => "Success: 42"
  * ```
  *
+ * @stability stable
  * @category pattern matching
  * @since 4.0.0
  */
@@ -10814,6 +11077,7 @@ export const matchCauseEager: {
    * Effect.runSync(handleResult) // => "Success: 42"
    * ```
    *
+   * @stability stable
    * @category pattern matching
    * @since 4.0.0
    */
@@ -10849,6 +11113,7 @@ export const matchCauseEager: {
    * Effect.runSync(handleResult) // => "Success: 42"
    * ```
    *
+   * @stability stable
    * @category pattern matching
    * @since 4.0.0
    */
@@ -10878,6 +11143,7 @@ export const matchCauseEager: {
  * @see {@link matchCauseEager} for eager cause matching with pure handlers
  * @see {@link matchEffect} for effectful matching on typed failures instead of full causes
  *
+ * @stability stable
  * @category pattern matching
  * @since 4.0.0
  */
@@ -10899,6 +11165,7 @@ export const matchCauseEffectEager: {
    * @see {@link matchCauseEager} for eager cause matching with pure handlers
    * @see {@link matchEffect} for effectful matching on typed failures instead of full causes
    *
+   * @stability stable
    * @category pattern matching
    * @since 4.0.0
    */
@@ -10925,6 +11192,7 @@ export const matchCauseEffectEager: {
    * @see {@link matchCauseEager} for eager cause matching with pure handlers
    * @see {@link matchEffect} for effectful matching on typed failures instead of full causes
    *
+   * @stability stable
    * @category pattern matching
    * @since 4.0.0
    */
@@ -10992,6 +11260,7 @@ export const matchCauseEffectEager: {
  * @see {@link matchCause} if you don't need side effects and only want to handle the result or failure.
  * @see {@link matchEffect} if you don't need to handle the cause of the failure.
  *
+ * @stability stable
  * @category pattern matching
  * @since 2.0.0
  */
@@ -11051,6 +11320,7 @@ export const matchCauseEffect: {
    * @see {@link matchCause} if you don't need side effects and only want to handle the result or failure.
    * @see {@link matchEffect} if you don't need to handle the cause of the failure.
    *
+   * @stability stable
    * @category pattern matching
    * @since 2.0.0
    */
@@ -11115,6 +11385,7 @@ export const matchCauseEffect: {
    * @see {@link matchCause} if you don't need side effects and only want to handle the result or failure.
    * @see {@link matchEffect} if you don't need to handle the cause of the failure.
    *
+   * @stability stable
    * @category pattern matching
    * @since 2.0.0
    */
@@ -11174,6 +11445,7 @@ export const matchCauseEffect: {
  *
  * @see {@link match} if you don't need side effects and only want to handle the
  * result or failure.
+ * @stability stable
  * @category pattern matching
  * @since 2.0.0
  */
@@ -11225,6 +11497,7 @@ export const matchEffect: {
    *
    * @see {@link match} if you don't need side effects and only want to handle the
    * result or failure.
+   * @stability stable
    * @category pattern matching
    * @since 2.0.0
    */
@@ -11281,6 +11554,7 @@ export const matchEffect: {
    *
    * @see {@link match} if you don't need side effects and only want to handle the
    * result or failure.
+   * @stability stable
    * @category pattern matching
    * @since 2.0.0
    */
@@ -11319,6 +11593,7 @@ export const matchEffect: {
  * output // => [true]
  * ```
  *
+ * @stability stable
  * @category predicates
  * @since 2.0.0
  */
@@ -11349,6 +11624,7 @@ export const isFailure: <A, E, R>(self: Effect<A, E, R>) => Effect<boolean, neve
  * output // => ["ok: true", "failed: false"]
  * ```
  *
+ * @stability stable
  * @category predicates
  * @since 2.0.0
  */
@@ -11406,6 +11682,7 @@ export const isSuccess: <A, E, R>(self: Effect<A, E, R>) => Effect<boolean, neve
  * @see {@link contextWith} for deriving an effect from the complete context
  * @see {@link service} for reading one service from the context
  *
+ * @stability stable
  * @category accessors
  * @since 2.0.0
  */
@@ -11465,6 +11742,7 @@ export const context: <R = never>() => Effect<Context.Context<R>, never, R> = in
  * @see {@link context} for reading the complete context as a value
  * @see {@link service} for reading one service from the context
  *
+ * @stability stable
  * @category accessors
  * @since 2.0.0
  */
@@ -11502,6 +11780,7 @@ export const contextWith: <R, A, E, R2>(
  * await Effect.runPromise(provided) // => "Result for: SELECT * FROM users"
  * ```
  *
+ * @stability stable
  * @category providing services
  * @since 2.0.0
  */
@@ -11536,6 +11815,7 @@ export const provide: {
    * await Effect.runPromise(provided) // => "Result for: SELECT * FROM users"
    * ```
    *
+   * @stability stable
    * @category providing services
    * @since 2.0.0
    */
@@ -11581,6 +11861,7 @@ export const provide: {
    * await Effect.runPromise(provided) // => "Result for: SELECT * FROM users"
    * ```
    *
+   * @stability stable
    * @category providing services
    * @since 2.0.0
    */
@@ -11622,6 +11903,7 @@ export const provide: {
    * await Effect.runPromise(provided) // => "Result for: SELECT * FROM users"
    * ```
    *
+   * @stability stable
    * @category providing services
    * @since 2.0.0
    */
@@ -11656,6 +11938,7 @@ export const provide: {
    * await Effect.runPromise(provided) // => "Result for: SELECT * FROM users"
    * ```
    *
+   * @stability stable
    * @category providing services
    * @since 2.0.0
    */
@@ -11700,6 +11983,7 @@ export const provide: {
    * await Effect.runPromise(provided) // => "Result for: SELECT * FROM users"
    * ```
    *
+   * @stability stable
    * @category providing services
    * @since 2.0.0
    */
@@ -11740,6 +12024,7 @@ export const provide: {
    * await Effect.runPromise(provided) // => "Result for: SELECT * FROM users"
    * ```
    *
+   * @stability stable
    * @category providing services
    * @since 2.0.0
    */
@@ -11786,6 +12071,7 @@ export const provide: {
  * output // => ["Querying database", "result"]
  * ```
  *
+ * @stability stable
  * @category providing services
  * @since 4.0.0
  */
@@ -11830,6 +12116,7 @@ export const provideContext: {
    * output // => ["Querying database", "result"]
    * ```
    *
+   * @stability stable
    * @category providing services
    * @since 4.0.0
    */
@@ -11874,6 +12161,7 @@ export const provideContext: {
    * output // => ["Querying database", "result"]
    * ```
    *
+   * @stability stable
    * @category providing services
    * @since 4.0.0
    */
@@ -11918,6 +12206,7 @@ export const provideContext: {
  * @see {@link provideContext} for partially satisfying an effect's context requirements.
  * @see {@link updateContext} for deriving the required context from the current one.
  *
+ * @stability stable
  * @category providing services
  * @since 4.0.0
  */
@@ -11960,6 +12249,7 @@ export const setContext: {
    * @see {@link provideContext} for partially satisfying an effect's context requirements.
    * @see {@link updateContext} for deriving the required context from the current one.
    *
+   * @stability stable
    * @category providing services
    * @since 4.0.0
    */
@@ -12002,6 +12292,7 @@ export const setContext: {
    * @see {@link provideContext} for partially satisfying an effect's context requirements.
    * @see {@link updateContext} for deriving the required context from the current one.
    *
+   * @stability stable
    * @category providing services
    * @since 4.0.0
    */
@@ -12033,6 +12324,7 @@ export const setContext: {
  * Effect.runSync(runnable) // => "Result for: SELECT * FROM users"
  * ```
  *
+ * @stability stable
  * @category accessors
  * @since 4.0.0
  */
@@ -12079,6 +12371,7 @@ export const service: <I, S>(service: Context.Key<I, S>) => Effect<S, never, I>
  * output // => ["Service not available"]
  * ```
  *
+ * @stability stable
  * @category accessors
  * @since 2.0.0
  */
@@ -12123,6 +12416,7 @@ export const serviceOption: <I, S>(key: Context.Key<I, S>) => Effect<Option<S>>
  * Effect.runSync(result) // => "Hello World!"
  * ```
  *
+ * @stability stable
  * @category providing services
  * @since 4.0.0
  */
@@ -12166,6 +12460,7 @@ export const updateContext: {
    * Effect.runSync(result) // => "Hello World!"
    * ```
    *
+   * @stability stable
    * @category providing services
    * @since 4.0.0
    */
@@ -12209,6 +12504,7 @@ export const updateContext: {
    * Effect.runSync(result) // => "Hello World!"
    * ```
    *
+   * @stability stable
    * @category providing services
    * @since 4.0.0
    */
@@ -12250,6 +12546,7 @@ export const updateContext: {
  * output // => ["Updated count: 1", 1]
  * ```
  *
+ * @stability stable
  * @category providing services
  * @since 2.0.0
  */
@@ -12286,6 +12583,7 @@ export const updateService: {
    * output // => ["Updated count: 1", 1]
    * ```
    *
+   * @stability stable
    * @category providing services
    * @since 2.0.0
    */
@@ -12322,6 +12620,7 @@ export const updateService: {
    * output // => ["Updated count: 1", 1]
    * ```
    *
+   * @stability stable
    * @category providing services
    * @since 2.0.0
    */
@@ -12388,6 +12687,7 @@ export const updateService: {
  *
  * @see {@link updateService} for updating a service only within a wrapped effect
  *
+ * @stability stable
  * @category providing services
  * @since 4.0.0
  */
@@ -12443,6 +12743,7 @@ export const updateServiceScoped: <I, A>(
  * @see {@link provide} for providing multiple layers to an effect.
  * @see {@link provideServiceEffect} for acquiring the service implementation effectfully.
  * @see {@link provideContext} for providing a complete context.
+ * @stability stable
  * @category providing services
  * @since 2.0.0
  */
@@ -12491,6 +12792,7 @@ export const provideService: {
    * @see {@link provide} for providing multiple layers to an effect.
    * @see {@link provideServiceEffect} for acquiring the service implementation effectfully.
    * @see {@link provideContext} for providing a complete context.
+   * @stability stable
    * @category providing services
    * @since 2.0.0
    */
@@ -12539,6 +12841,7 @@ export const provideService: {
      * @see {@link provide} for providing multiple layers to an effect.
      * @see {@link provideServiceEffect} for acquiring the service implementation effectfully.
      * @see {@link provideContext} for providing a complete context.
+     * @stability stable
      * @category providing services
      * @since 2.0.0
      */
@@ -12587,6 +12890,7 @@ export const provideService: {
      * @see {@link provide} for providing multiple layers to an effect.
      * @see {@link provideServiceEffect} for acquiring the service implementation effectfully.
      * @see {@link provideContext} for providing a complete context.
+     * @stability stable
      * @category providing services
      * @since 2.0.0
      */
@@ -12636,6 +12940,7 @@ export const provideService: {
    * @see {@link provide} for providing multiple layers to an effect.
    * @see {@link provideServiceEffect} for acquiring the service implementation effectfully.
    * @see {@link provideContext} for providing a complete context.
+   * @stability stable
    * @category providing services
    * @since 2.0.0
    */
@@ -12684,6 +12989,7 @@ export const provideService: {
    * @see {@link provide} for providing multiple layers to an effect.
    * @see {@link provideServiceEffect} for acquiring the service implementation effectfully.
    * @see {@link provideContext} for providing a complete context.
+   * @stability stable
    * @category providing services
    * @since 2.0.0
    */
@@ -12742,6 +13048,7 @@ export const provideService: {
  * output // => ["Establishing database connection...", "Database connected!", "Result for: SELECT * FROM users"]
  * ```
  *
+ * @stability stable
  * @category providing services
  * @since 2.0.0
  */
@@ -12798,6 +13105,7 @@ export const provideServiceEffect: {
    * output // => ["Establishing database connection...", "Database connected!", "Result for: SELECT * FROM users"]
    * ```
    *
+   * @stability stable
    * @category providing services
    * @since 2.0.0
    */
@@ -12854,6 +13162,7 @@ export const provideServiceEffect: {
    * output // => ["Establishing database connection...", "Database connected!", "Result for: SELECT * FROM users"]
    * ```
    *
+   * @stability stable
    * @category providing services
    * @since 2.0.0
    */
@@ -12894,6 +13203,7 @@ export const provideServiceEffect: {
  * output // => ["Got scope for resource management", "Acquiring resource", "Releasing resource", "resource"]
  * ```
  *
+ * @stability stable
  * @category resource management
  * @since 2.0.0
  */
@@ -12934,6 +13244,7 @@ export const scope: Effect<Scope, never, Scope> = internal.scope
  * output // => ["Acquiring resource", "Using resource", "Releasing resource"]
  * ```
  *
+ * @stability stable
  * @category resource management
  * @since 2.0.0
  */
@@ -12978,6 +13289,7 @@ export const scoped: <A, E, R>(
  * output // => ["Inside scoped context", "Acquiring resource", "Releasing resource", "Manual finalizer", "resource"]
  * ```
  *
+ * @stability stable
  * @category resource management
  * @since 3.11.0
  */
@@ -13047,6 +13359,7 @@ export const scopedWith: <A, E, R>(
  * @see {@link acquireDisposable} for resources that implement JavaScript disposal protocols
  * @see {@link acquireUseRelease} for bracketing acquire, use, and release in one effect
  *
+ * @stability stable
  * @category resource management
  * @since 2.0.0
  */
@@ -13101,6 +13414,7 @@ export const acquireRelease: <A, E, R, R2>(
  *
  * @see {@link acquireRelease} for resources that need an explicit finalizer
  *
+ * @stability stable
  * @category resource management
  * @since 4.0.0
  */
@@ -13179,6 +13493,7 @@ export const acquireDisposable: <A extends AsyncDisposable | Disposable, E, R>(
  *
  * @see {@link acquireRelease} for scoped resources whose use happens later
  *
+ * @stability stable
  * @category resource management
  * @since 2.0.0
  */
@@ -13231,6 +13546,7 @@ export const acquireUseRelease: <Resource, E, R, A, E2, R2, E3, R3>(
  * @see {@link acquireRelease} for resource acquisition with a release finalizer
  * @see {@link ensuring} for attaching a finalizer to one effect
  *
+ * @stability stable
  * @category resource management
  * @since 2.0.0
  */
@@ -13273,6 +13589,7 @@ export const addFinalizer: <R>(
  * output // => ["Task started", "Task completed", "Cleanup: This always runs!", 42]
  * ```
  *
+ * @stability stable
  * @category resource management
  * @since 2.0.0
  */
@@ -13312,6 +13629,7 @@ export const ensuring: {
    * output // => ["Task started", "Task completed", "Cleanup: This always runs!", 42]
    * ```
    *
+   * @stability stable
    * @category resource management
    * @since 2.0.0
    */
@@ -13351,6 +13669,7 @@ export const ensuring: {
    * output // => ["Task started", "Task completed", "Cleanup: This always runs!", 42]
    * ```
    *
+   * @stability stable
    * @category resource management
    * @since 2.0.0
    */
@@ -13381,6 +13700,7 @@ export const ensuring: {
  * output // => ["Cleanup on error: TaskError: Something went wrong", Exit.fail(error)]
  * ```
  *
+ * @stability stable
  * @category resource management
  * @since 2.0.0
  */
@@ -13409,6 +13729,7 @@ export const onError: {
    * output // => ["Cleanup on error: TaskError: Something went wrong", Exit.fail(error)]
    * ```
    *
+   * @stability stable
    * @category resource management
    * @since 2.0.0
    */
@@ -13437,6 +13758,7 @@ export const onError: {
    * output // => ["Cleanup on error: TaskError: Something went wrong", Exit.fail(error)]
    * ```
    *
+   * @stability stable
    * @category resource management
    * @since 2.0.0
    */
@@ -13471,6 +13793,7 @@ export const onError: {
  * output // => ["Cause: boom", Exit.fail("boom")]
  * ```
  *
+ * @stability stable
  * @category resource management
  * @since 4.0.0
  */
@@ -13500,6 +13823,7 @@ export const onErrorIf: {
    * output // => ["Cause: boom", Exit.fail("boom")]
    * ```
    *
+   * @stability stable
    * @category resource management
    * @since 4.0.0
    */
@@ -13532,6 +13856,7 @@ export const onErrorIf: {
    * output // => ["Cause: boom", Exit.fail("boom")]
    * ```
    *
+   * @stability stable
    * @category resource management
    * @since 4.0.0
    */
@@ -13555,6 +13880,7 @@ export const onErrorIf: {
  * @see {@link onErrorIf} for selecting failures with a boolean predicate
  * @see {@link onExitFilter} for selecting from every exit instead of only failures
  *
+ * @stability stable
  * @category resource management
  * @since 4.0.0
  */
@@ -13572,6 +13898,7 @@ export const onErrorFilter: {
    * @see {@link onErrorIf} for selecting failures with a boolean predicate
    * @see {@link onExitFilter} for selecting from every exit instead of only failures
    *
+   * @stability stable
    * @category resource management
    * @since 4.0.0
    */
@@ -13592,6 +13919,7 @@ export const onErrorFilter: {
    * @see {@link onErrorIf} for selecting failures with a boolean predicate
    * @see {@link onExitFilter} for selecting from every exit instead of only failures
    *
+   * @stability stable
    * @category resource management
    * @since 4.0.0
    */
@@ -13620,6 +13948,7 @@ export const onErrorFilter: {
  *
  * @see {@link onExit} for ordinary exit-aware cleanup whose finalizer always returns an effect
  *
+ * @stability stable
  * @category resource management
  * @since 4.0.0
  */
@@ -13656,6 +13985,7 @@ export const onExitPrimitive: <A, E, R, XE = never, XR = never>(
  * output // => ["Task succeeded with: 42", 42]
  * ```
  *
+ * @stability stable
  * @category resource management
  * @since 2.0.0
  */
@@ -13687,6 +14017,7 @@ export const onExit: {
    * output // => ["Task succeeded with: 42", 42]
    * ```
    *
+   * @stability stable
    * @category resource management
    * @since 2.0.0
    */
@@ -13718,6 +14049,7 @@ export const onExit: {
    * output // => ["Task succeeded with: 42", 42]
    * ```
    *
+   * @stability stable
    * @category resource management
    * @since 2.0.0
    */
@@ -13747,6 +14079,7 @@ export const onExit: {
  * output // => ["Succeeded with: 42", 42]
  * ```
  *
+ * @stability stable
  * @category resource management
  * @since 4.0.0
  */
@@ -13774,6 +14107,7 @@ export const onExitIf: {
    * output // => ["Succeeded with: 42", 42]
    * ```
    *
+   * @stability stable
    * @category resource management
    * @since 4.0.0
    */
@@ -13804,6 +14138,7 @@ export const onExitIf: {
    * output // => ["Succeeded with: 42", 42]
    * ```
    *
+   * @stability stable
    * @category resource management
    * @since 4.0.0
    */
@@ -13832,6 +14167,7 @@ export const onExitIf: {
  * @see {@link onExitIf} for selecting exits with a boolean predicate
  * @see {@link onErrorFilter} for selecting only failure causes
  *
+ * @stability stable
  * @category resource management
  * @since 4.0.0
  */
@@ -13854,6 +14190,7 @@ export const onExitFilter: {
    * @see {@link onExitIf} for selecting exits with a boolean predicate
    * @see {@link onErrorFilter} for selecting only failure causes
    *
+   * @stability stable
    * @category resource management
    * @since 4.0.0
    */
@@ -13879,6 +14216,7 @@ export const onExitFilter: {
    * @see {@link onExitIf} for selecting exits with a boolean predicate
    * @see {@link onErrorFilter} for selecting only failure causes
    *
+   * @stability stable
    * @category resource management
    * @since 4.0.0
    */
@@ -13909,6 +14247,11 @@ export const onExitFilter: {
  * evaluations of the same effect will return the cached result without
  * re-executing the logic.
  *
+ * Concurrent callers share the pending computation, which is interrupted only
+ * once every caller waiting on it has been interrupted. Interrupted
+ * computations are never cached, so the next evaluation starts a fresh
+ * computation.
+ *
  * **Example** (Memoizing an effect until invalidated)
  *
  * ```ts import.meta.vitest
@@ -13940,6 +14283,7 @@ export const onExitFilter: {
  * time-to-live duration for the cached value.
  * @see {@link cachedInvalidateWithTTL} for a similar function that includes an
  * additional effect for manually invalidating the cached value.
+ * @stability stable
  * @category caching
  * @since 2.0.0
  */
@@ -13970,11 +14314,12 @@ export const cached: <A, E, R>(self: Effect<A, E, R>) => Effect<Effect<A, E, R>>
  * `Duration.Input`. The function runs once after each fresh computation,
  * including failures, so successes and failures can have different TTLs. It
  * does not run when the cache is created or when a cached result is reused.
- * The callback also receives interruption exits, which are cached for the
- * returned duration.
+ * Interrupted computations are never cached and do not call the function.
  *
  * The TTL starts when the computation completes. Concurrent callers share the
- * pending computation. A zero TTL expires immediately, and an infinite TTL
+ * pending computation, which is interrupted only once every caller waiting on
+ * it has been interrupted. The next evaluation then starts a fresh
+ * computation. A zero TTL expires immediately, and an infinite TTL
  * keeps the result indefinitely.
  *
  * **Example** (Memoizing an effect with TTL)
@@ -14025,6 +14370,7 @@ export const cached: <A, E, R>(self: Effect<A, E, R>) => Effect<Effect<A, E, R>>
  * indefinitely.
  * @see {@link cachedInvalidateWithTTL} for a similar function that includes an
  * additional effect for manually invalidating the cached value.
+ * @stability stable
  * @category caching
  * @since 2.0.0
  */
@@ -14054,11 +14400,12 @@ export const cachedWithTTL: {
    * `Duration.Input`. The function runs once after each fresh computation,
    * including failures, so successes and failures can have different TTLs. It
    * does not run when the cache is created or when a cached result is reused.
-   * The callback also receives interruption exits, which are cached for the
-   * returned duration.
+   * Interrupted computations are never cached and do not call the function.
    *
    * The TTL starts when the computation completes. Concurrent callers share the
-   * pending computation. A zero TTL expires immediately, and an infinite TTL
+   * pending computation, which is interrupted only once every caller waiting on
+   * it has been interrupted. The next evaluation then starts a fresh
+   * computation. A zero TTL expires immediately, and an infinite TTL
    * keeps the result indefinitely.
    *
    * **Example** (Memoizing an effect with TTL)
@@ -14109,6 +14456,7 @@ export const cachedWithTTL: {
    * indefinitely.
    * @see {@link cachedInvalidateWithTTL} for a similar function that includes an
    * additional effect for manually invalidating the cached value.
+   * @stability stable
    * @category caching
    * @since 2.0.0
    */
@@ -14138,11 +14486,12 @@ export const cachedWithTTL: {
    * `Duration.Input`. The function runs once after each fresh computation,
    * including failures, so successes and failures can have different TTLs. It
    * does not run when the cache is created or when a cached result is reused.
-   * The callback also receives interruption exits, which are cached for the
-   * returned duration.
+   * Interrupted computations are never cached and do not call the function.
    *
    * The TTL starts when the computation completes. Concurrent callers share the
-   * pending computation. A zero TTL expires immediately, and an infinite TTL
+   * pending computation, which is interrupted only once every caller waiting on
+   * it has been interrupted. The next evaluation then starts a fresh
+   * computation. A zero TTL expires immediately, and an infinite TTL
    * keeps the result indefinitely.
    *
    * **Example** (Memoizing an effect with TTL)
@@ -14193,6 +14542,7 @@ export const cachedWithTTL: {
    * indefinitely.
    * @see {@link cachedInvalidateWithTTL} for a similar function that includes an
    * additional effect for manually invalidating the cached value.
+   * @stability stable
    * @category caching
    * @since 2.0.0
    */
@@ -14222,11 +14572,12 @@ export const cachedWithTTL: {
    * `Duration.Input`. The function runs once after each fresh computation,
    * including failures, so successes and failures can have different TTLs. It
    * does not run when the cache is created or when a cached result is reused.
-   * The callback also receives interruption exits, which are cached for the
-   * returned duration.
+   * Interrupted computations are never cached and do not call the function.
    *
    * The TTL starts when the computation completes. Concurrent callers share the
-   * pending computation. A zero TTL expires immediately, and an infinite TTL
+   * pending computation, which is interrupted only once every caller waiting on
+   * it has been interrupted. The next evaluation then starts a fresh
+   * computation. A zero TTL expires immediately, and an infinite TTL
    * keeps the result indefinitely.
    *
    * **Example** (Memoizing an effect with TTL)
@@ -14277,6 +14628,7 @@ export const cachedWithTTL: {
    * indefinitely.
    * @see {@link cachedInvalidateWithTTL} for a similar function that includes an
    * additional effect for manually invalidating the cached value.
+   * @stability stable
    * @category caching
    * @since 2.0.0
    */
@@ -14306,11 +14658,12 @@ export const cachedWithTTL: {
    * `Duration.Input`. The function runs once after each fresh computation,
    * including failures, so successes and failures can have different TTLs. It
    * does not run when the cache is created or when a cached result is reused.
-   * The callback also receives interruption exits, which are cached for the
-   * returned duration.
+   * Interrupted computations are never cached and do not call the function.
    *
    * The TTL starts when the computation completes. Concurrent callers share the
-   * pending computation. A zero TTL expires immediately, and an infinite TTL
+   * pending computation, which is interrupted only once every caller waiting on
+   * it has been interrupted. The next evaluation then starts a fresh
+   * computation. A zero TTL expires immediately, and an infinite TTL
    * keeps the result indefinitely.
    *
    * **Example** (Memoizing an effect with TTL)
@@ -14361,6 +14714,7 @@ export const cachedWithTTL: {
    * indefinitely.
    * @see {@link cachedInvalidateWithTTL} for a similar function that includes an
    * additional effect for manually invalidating the cached value.
+   * @stability stable
    * @category caching
    * @since 2.0.0
    */
@@ -14371,8 +14725,8 @@ export const cachedWithTTL: {
 } = internal.cachedWithTTL
 
 /**
- * Creates a cached effect result for a specified duration and allows manual
- * invalidation before expiration.
+ * Creates a cached effect result for a fixed duration or a duration computed
+ * from its `Exit` and allows manual invalidation before expiration.
  *
  * **When to use**
  *
@@ -14425,13 +14779,14 @@ export const cachedWithTTL: {
  * indefinitely.
  * @see {@link cachedWithTTL} for a similar function that caches the result for
  * a specified duration but does not include an effect for manual invalidation.
+ * @stability stable
  * @category caching
  * @since 2.0.0
  */
 export const cachedInvalidateWithTTL: {
   /**
-   * Creates a cached effect result for a specified duration and allows manual
-   * invalidation before expiration.
+   * Creates a cached effect result for a fixed duration or a duration computed
+   * from its `Exit` and allows manual invalidation before expiration.
    *
    * **When to use**
    *
@@ -14484,13 +14839,74 @@ export const cachedInvalidateWithTTL: {
    * indefinitely.
    * @see {@link cachedWithTTL} for a similar function that caches the result for
    * a specified duration but does not include an effect for manual invalidation.
+   * @stability stable
+   * @category caching
+   * @since 2.0.0
+   */
+  <A, E>(timeToLive: (exit: Exit.Exit<A, E>) => Duration.Input): <R>(self: Effect<A, E, R>) => Effect<[Effect<A, E, R>, Effect<void>]>
+  /**
+   * Creates a cached effect result for a fixed duration or a duration computed
+   * from its `Exit` and allows manual invalidation before expiration.
+   *
+   * **When to use**
+   *
+   * Use when an effect result should be cached for a bounded time and callers
+   * also need a manual invalidation effect to force recomputation before
+   * expiration.
+   *
+   * **Details**
+   *
+   * This function behaves similarly to {@link cachedWithTTL} by caching the
+   * result of an effect for a specified period of time. However, it introduces an
+   * additional feature: it provides an effect that allows you to manually
+   * invalidate the cached result before it naturally expires.
+   *
+   * This gives you more control over the cache, allowing you to refresh the
+   * result when needed, even if the original cache has not yet expired.
+   *
+   * Once the cache is invalidated, the next time the effect is evaluated, the
+   * result will be recomputed, and the cache will be refreshed.
+   *
+   * **Example** (Memoizing with TTL and invalidation)
+   *
+   * ```ts import.meta.vitest
+   * import { Effect } from "effect"
+   * const output: Array<unknown> = []
+   * const record = (value: unknown) => Effect.sync(() => { output.push(value) })
+   *
+   * let i = 1
+   * const expensiveTask = Effect.sync(() => {
+   *   void output.push("expensive task...")
+   *   return `result ${i++}`
+   * })
+   *
+   * const program = Effect.gen(function*() {
+   *   const [cached, invalidate] = yield* Effect.cachedInvalidateWithTTL(
+   *     expensiveTask,
+   *     "1 hour"
+   *   )
+   *   yield* cached.pipe(Effect.andThen(record))
+   *   yield* cached.pipe(Effect.andThen(record))
+   *   yield* invalidate
+   *   yield* cached.pipe(Effect.andThen(record))
+   * })
+   *
+   * Effect.runSync(program)
+   * output // => ["expensive task...", "result 1", "result 1", "expensive task...", "result 2"]
+   * ```
+   *
+   * @see {@link cached} for a similar function that caches the result
+   * indefinitely.
+   * @see {@link cachedWithTTL} for a similar function that caches the result for
+   * a specified duration but does not include an effect for manual invalidation.
+   * @stability stable
    * @category caching
    * @since 2.0.0
    */
   (timeToLive: Duration.Input): <A, E, R>(self: Effect<A, E, R>) => Effect<[Effect<A, E, R>, Effect<void>]>
   /**
-   * Creates a cached effect result for a specified duration and allows manual
-   * invalidation before expiration.
+   * Creates a cached effect result for a fixed duration or a duration computed
+   * from its `Exit` and allows manual invalidation before expiration.
    *
    * **When to use**
    *
@@ -14543,10 +14959,74 @@ export const cachedInvalidateWithTTL: {
    * indefinitely.
    * @see {@link cachedWithTTL} for a similar function that caches the result for
    * a specified duration but does not include an effect for manual invalidation.
+   * @stability stable
    * @category caching
    * @since 2.0.0
    */
-  <A, E, R>(self: Effect<A, E, R>, timeToLive: Duration.Input): Effect<[Effect<A, E, R>, Effect<void>]>
+  <A, E>(timeToLive: Duration.Input | ((exit: Exit.Exit<A, E>) => Duration.Input)): <R>(self: Effect<A, E, R>) => Effect<[Effect<A, E, R>, Effect<void>]>
+  /**
+   * Creates a cached effect result for a fixed duration or a duration computed
+   * from its `Exit` and allows manual invalidation before expiration.
+   *
+   * **When to use**
+   *
+   * Use when an effect result should be cached for a bounded time and callers
+   * also need a manual invalidation effect to force recomputation before
+   * expiration.
+   *
+   * **Details**
+   *
+   * This function behaves similarly to {@link cachedWithTTL} by caching the
+   * result of an effect for a specified period of time. However, it introduces an
+   * additional feature: it provides an effect that allows you to manually
+   * invalidate the cached result before it naturally expires.
+   *
+   * This gives you more control over the cache, allowing you to refresh the
+   * result when needed, even if the original cache has not yet expired.
+   *
+   * Once the cache is invalidated, the next time the effect is evaluated, the
+   * result will be recomputed, and the cache will be refreshed.
+   *
+   * **Example** (Memoizing with TTL and invalidation)
+   *
+   * ```ts import.meta.vitest
+   * import { Effect } from "effect"
+   * const output: Array<unknown> = []
+   * const record = (value: unknown) => Effect.sync(() => { output.push(value) })
+   *
+   * let i = 1
+   * const expensiveTask = Effect.sync(() => {
+   *   void output.push("expensive task...")
+   *   return `result ${i++}`
+   * })
+   *
+   * const program = Effect.gen(function*() {
+   *   const [cached, invalidate] = yield* Effect.cachedInvalidateWithTTL(
+   *     expensiveTask,
+   *     "1 hour"
+   *   )
+   *   yield* cached.pipe(Effect.andThen(record))
+   *   yield* cached.pipe(Effect.andThen(record))
+   *   yield* invalidate
+   *   yield* cached.pipe(Effect.andThen(record))
+   * })
+   *
+   * Effect.runSync(program)
+   * output // => ["expensive task...", "result 1", "result 1", "expensive task...", "result 2"]
+   * ```
+   *
+   * @see {@link cached} for a similar function that caches the result
+   * indefinitely.
+   * @see {@link cachedWithTTL} for a similar function that caches the result for
+   * a specified duration but does not include an effect for manual invalidation.
+   * @stability stable
+   * @category caching
+   * @since 2.0.0
+   */
+  <A, E, R>(
+    self: Effect<A, E, R>,
+    timeToLive: Duration.Input | ((exit: Exit.Exit<A, E>) => Duration.Input)
+  ): Effect<[Effect<A, E, R>, Effect<void>]>
 } = internal.cachedInvalidateWithTTL
 
 // -----------------------------------------------------------------------------
@@ -14569,6 +15049,7 @@ export const cachedInvalidateWithTTL: {
  * Effect.runSyncExit(program)._tag // => "Failure"
  * ```
  *
+ * @stability stable
  * @category interruption
  * @since 2.0.0
  */
@@ -14588,6 +15069,7 @@ export const interrupt: Effect<never> = internal.interrupt
  * await Effect.runPromise(program) // => Option.none()
  * ```
  *
+ * @stability stable
  * @category interruption
  * @since 2.0.0
  */
@@ -14616,6 +15098,7 @@ export const interruptible: <A, E, R>(
  * output // => ["Task was interrupted, cleaning up..."]
  * ```
  *
+ * @stability stable
  * @category interruption
  * @since 2.0.0
  */
@@ -14641,6 +15124,7 @@ export const onInterrupt: {
    * output // => ["Task was interrupted, cleaning up..."]
    * ```
    *
+   * @stability stable
    * @category interruption
    * @since 2.0.0
    */
@@ -14666,6 +15150,7 @@ export const onInterrupt: {
    * output // => ["Task was interrupted, cleaning up..."]
    * ```
    *
+   * @stability stable
    * @category interruption
    * @since 2.0.0
    */
@@ -14695,6 +15180,7 @@ export const onInterrupt: {
  * output // => ["Starting critical section...", "Critical section completed"]
  * ```
  *
+ * @stability stable
  * @category interruption
  * @since 2.0.0
  */
@@ -14730,6 +15216,7 @@ export const uninterruptible: <A, E, R>(
  * output // => ["Uninterruptible phase...", "Interruptible phase...", "Back to uninterruptible"]
  * ```
  *
+ * @stability stable
  * @category interruption
  * @since 2.0.0
  */
@@ -14767,6 +15254,7 @@ export const uninterruptibleMask: <A, E, R>(
  * output // => ["Interruptible phase...", "Uninterruptible phase...", "Back to interruptible"]
  * ```
  *
+ * @stability stable
  * @category interruption
  * @since 2.0.0
  */
@@ -14797,6 +15285,7 @@ export const interruptibleMask: <A, E, R>(
  *
  * @see {@link scoped} for binding resource lifetime to a scope
  *
+ * @stability stable
  * @category interruption
  * @since 4.0.0
  */
@@ -14809,6 +15298,7 @@ export const abortSignal: Effect<AbortSignal, never, Scope> = internal.abortSign
 /**
  * Type helpers for repeating effects.
  *
+ * @stability stable
  * @category repetition
  * @since 2.0.0
  */
@@ -14873,6 +15363,7 @@ export declare namespace Repeat {
  * await Effect.runPromise(program) // => Option.none()
  * ```
  *
+ * @stability stable
  * @category repetition
  * @since 2.0.0
  */
@@ -14967,6 +15458,7 @@ export const forever: <
  * @see {@link retry} for failure-based repetition
  * @see {@link repeatOrElse} for fallback handling when repetition fails
  *
+ * @stability stable
  * @category repetition
  * @since 2.0.0
  */
@@ -15048,6 +15540,7 @@ export const repeat: {
    * @see {@link retry} for failure-based repetition
    * @see {@link repeatOrElse} for fallback handling when repetition fails
    *
+   * @stability stable
    * @category repetition
    * @since 2.0.0
    */
@@ -15129,6 +15622,7 @@ export const repeat: {
    * @see {@link retry} for failure-based repetition
    * @see {@link repeatOrElse} for fallback handling when repetition fails
    *
+   * @stability stable
    * @category repetition
    * @since 2.0.0
    */
@@ -15210,6 +15704,7 @@ export const repeat: {
    * @see {@link retry} for failure-based repetition
    * @see {@link repeatOrElse} for fallback handling when repetition fails
    *
+   * @stability stable
    * @category repetition
    * @since 2.0.0
    */
@@ -15295,6 +15790,7 @@ export const repeat: {
    * @see {@link retry} for failure-based repetition
    * @see {@link repeatOrElse} for fallback handling when repetition fails
    *
+   * @stability stable
    * @category repetition
    * @since 2.0.0
    */
@@ -15376,6 +15872,7 @@ export const repeat: {
    * @see {@link retry} for failure-based repetition
    * @see {@link repeatOrElse} for fallback handling when repetition fails
    *
+   * @stability stable
    * @category repetition
    * @since 2.0.0
    */
@@ -15460,6 +15957,7 @@ export const repeat: {
    * @see {@link retry} for failure-based repetition
    * @see {@link repeatOrElse} for fallback handling when repetition fails
    *
+   * @stability stable
    * @category repetition
    * @since 2.0.0
    */
@@ -15519,6 +16017,7 @@ export const repeat: {
  * output // => ["Attempt 1 failed", "Final failure: Error 1, after 0 attempts", 0]
  * ```
  *
+ * @stability stable
  * @category repetition
  * @since 2.0.0
  */
@@ -15571,6 +16070,7 @@ export const repeatOrElse: {
    * output // => ["Attempt 1 failed", "Final failure: Error 1, after 0 attempts", 0]
    * ```
    *
+   * @stability stable
    * @category repetition
    * @since 2.0.0
    */
@@ -15626,6 +16126,7 @@ export const repeatOrElse: {
    * output // => ["Attempt 1 failed", "Final failure: Error 1, after 0 attempts", 0]
    * ```
    *
+   * @stability stable
    * @category repetition
    * @since 2.0.0
    */
@@ -15651,6 +16152,7 @@ export const repeatOrElse: {
  * @see {@link all} for running the returned effects and collecting results
  * @see {@link replicateEffect} for repeating an effect and collecting results in one step with concurrency and discard options
  *
+ * @stability stable
  * @category repetition
  * @since 2.0.0
  */
@@ -15670,6 +16172,7 @@ export const replicate: {
    * @see {@link all} for running the returned effects and collecting results
    * @see {@link replicateEffect} for repeating an effect and collecting results in one step with concurrency and discard options
    *
+   * @stability stable
    * @category repetition
    * @since 2.0.0
    */
@@ -15689,6 +16192,7 @@ export const replicate: {
    * @see {@link all} for running the returned effects and collecting results
    * @see {@link replicateEffect} for repeating an effect and collecting results in one step with concurrency and discard options
    *
+   * @stability stable
    * @category repetition
    * @since 2.0.0
    */
@@ -15722,6 +16226,7 @@ export const replicate: {
  * output // => [[1, 1, 1]]
  * ```
  *
+ * @stability stable
  * @category repetition
  * @since 2.0.0
  */
@@ -15753,6 +16258,7 @@ export const replicateEffect: {
    * output // => [[1, 1, 1]]
    * ```
    *
+   * @stability stable
    * @category repetition
    * @since 2.0.0
    */
@@ -15787,6 +16293,7 @@ export const replicateEffect: {
    * output // => [[1, 1, 1]]
    * ```
    *
+   * @stability stable
    * @category repetition
    * @since 2.0.0
    */
@@ -15821,6 +16328,7 @@ export const replicateEffect: {
    * output // => [[1, 1, 1]]
    * ```
    *
+   * @stability stable
    * @category repetition
    * @since 2.0.0
    */
@@ -15856,6 +16364,7 @@ export const replicateEffect: {
    * output // => [[1, 1, 1]]
    * ```
    *
+   * @stability stable
    * @category repetition
    * @since 2.0.0
    */
@@ -15903,6 +16412,7 @@ export const replicateEffect: {
  * @see {@link scheduleFrom} for a variant that allows the schedule's decision
  * to depend on the result of this effect.
  *
+ * @stability stable
  * @category repetition
  * @since 2.0.0
  */
@@ -15944,6 +16454,7 @@ export const schedule: {
    * @see {@link scheduleFrom} for a variant that allows the schedule's decision
    * to depend on the result of this effect.
    *
+   * @stability stable
    * @category repetition
    * @since 2.0.0
    */
@@ -15985,6 +16496,7 @@ export const schedule: {
    * @see {@link scheduleFrom} for a variant that allows the schedule's decision
    * to depend on the result of this effect.
    *
+   * @stability stable
    * @category repetition
    * @since 2.0.0
    */
@@ -16029,6 +16541,7 @@ export const schedule: {
  * output // => ["Processing: 0", "Processing: 0", 2]
  * ```
  *
+ * @stability stable
  * @category repetition
  * @since 2.0.0
  */
@@ -16068,6 +16581,7 @@ export const scheduleFrom: {
    * output // => ["Processing: 0", "Processing: 0", 2]
    * ```
    *
+   * @stability stable
    * @category repetition
    * @since 2.0.0
    */
@@ -16107,6 +16621,7 @@ export const scheduleFrom: {
    * output // => ["Processing: 0", "Processing: 0", 2]
    * ```
    *
+   * @stability stable
    * @category repetition
    * @since 2.0.0
    */
@@ -16137,6 +16652,7 @@ export const scheduleFrom: {
  * Effect.runSync(program) // => "function"
  * ```
  *
+ * @stability stable
  * @category tracing
  * @since 2.0.0
  */
@@ -16158,6 +16674,7 @@ export const tracer: Effect<Tracer> = internal.tracer
  * Effect.runSync(program) // => "completed"
  * ```
  *
+ * @stability stable
  * @category tracing
  * @since 2.0.0
  */
@@ -16178,6 +16695,7 @@ export const withTracer: {
    * Effect.runSync(program) // => "completed"
    * ```
    *
+   * @stability stable
    * @category tracing
    * @since 2.0.0
    */
@@ -16198,6 +16716,7 @@ export const withTracer: {
    * Effect.runSync(program) // => "completed"
    * ```
    *
+   * @stability stable
    * @category tracing
    * @since 2.0.0
    */
@@ -16225,6 +16744,7 @@ export const withTracer: {
  * Effect.runSync(program) // => 42
  * ```
  *
+ * @stability stable
  * @category tracing
  * @since 2.0.0
  */
@@ -16250,6 +16770,7 @@ export const withTracerEnabled: {
    * Effect.runSync(program) // => 42
    * ```
    *
+   * @stability stable
    * @category tracing
    * @since 2.0.0
    */
@@ -16275,6 +16796,7 @@ export const withTracerEnabled: {
    * Effect.runSync(program) // => 42
    * ```
    *
+   * @stability stable
    * @category tracing
    * @since 2.0.0
    */
@@ -16297,6 +16819,7 @@ export const withTracerEnabled: {
  * Effect.runSync(program) // => 42
  * ```
  *
+ * @stability stable
  * @category tracing
  * @since 2.0.0
  */
@@ -16317,6 +16840,7 @@ export const withTracerTiming: {
    * Effect.runSync(program) // => 42
    * ```
    *
+   * @stability stable
    * @category tracing
    * @since 2.0.0
    */
@@ -16337,6 +16861,7 @@ export const withTracerTiming: {
    * Effect.runSync(program) // => 42
    * ```
    *
+   * @stability stable
    * @category tracing
    * @since 2.0.0
    */
@@ -16366,6 +16891,7 @@ export const withTracerTiming: {
  * Effect.runSync(Effect.all([annotated1, annotated2])) // => ['result', 'result']
  * ```
  *
+ * @stability stable
  * @category tracing
  * @since 2.0.0
  */
@@ -16393,6 +16919,7 @@ export const annotateSpans: {
    * Effect.runSync(Effect.all([annotated1, annotated2])) // => ['result', 'result']
    * ```
    *
+   * @stability stable
    * @category tracing
    * @since 2.0.0
    */
@@ -16420,6 +16947,7 @@ export const annotateSpans: {
    * Effect.runSync(Effect.all([annotated1, annotated2])) // => ['result', 'result']
    * ```
    *
+   * @stability stable
    * @category tracing
    * @since 2.0.0
    */
@@ -16447,6 +16975,7 @@ export const annotateSpans: {
    * Effect.runSync(Effect.all([annotated1, annotated2])) // => ['result', 'result']
    * ```
    *
+   * @stability stable
    * @category tracing
    * @since 2.0.0
    */
@@ -16474,6 +17003,7 @@ export const annotateSpans: {
    * Effect.runSync(Effect.all([annotated1, annotated2])) // => ['result', 'result']
    * ```
    *
+   * @stability stable
    * @category tracing
    * @since 2.0.0
    */
@@ -16500,6 +17030,7 @@ export const annotateSpans: {
  * Effect.runSync(traced) // => "success"
  * ```
  *
+ * @stability stable
  * @category tracing
  * @since 2.0.0
  */
@@ -16524,6 +17055,7 @@ export const annotateCurrentSpan: {
    * Effect.runSync(traced) // => "success"
    * ```
    *
+   * @stability stable
    * @category tracing
    * @since 2.0.0
    */
@@ -16548,6 +17080,7 @@ export const annotateCurrentSpan: {
    * Effect.runSync(traced) // => "success"
    * ```
    *
+   * @stability stable
    * @category tracing
    * @since 2.0.0
    */
@@ -16576,6 +17109,7 @@ export const annotateCurrentSpan: {
  * Effect.runSync(traced) // => "my-span"
  * ```
  *
+ * @stability stable
  * @category tracing
  * @since 2.0.0
  */
@@ -16606,6 +17140,7 @@ export const currentSpan: Effect<Span, Cause.NoSuchElementError> = internal.curr
  * Effect.runSync(traced) // => "Span"
  * ```
  *
+ * @stability stable
  * @category tracing
  * @since 2.0.0
  */
@@ -16632,6 +17167,7 @@ export const currentParentSpan: Effect<AnySpan, Cause.NoSuchElementError> = inte
  * Effect.runSync(program) // => { userId: '123', operation: 'data-processing' }
  * ```
  *
+ * @stability stable
  * @category tracing
  * @since 2.0.0
  */
@@ -16659,6 +17195,7 @@ export const spanAnnotations: Effect<Readonly<Record<string, unknown>>> = intern
  * Effect.runSync(program).length // => 0
  * ```
  *
+ * @stability stable
  * @category tracing
  * @since 2.0.0
  */
@@ -16708,6 +17245,7 @@ export const spanLinks: Effect<ReadonlyArray<SpanLink>> = internal.spanLinks
  * Effect.runSync(program).length // => 2
  * ```
  *
+ * @stability stable
  * @category tracing
  * @since 2.0.0
  */
@@ -16756,6 +17294,7 @@ export const linkSpans: {
    * Effect.runSync(program).length // => 2
    * ```
    *
+   * @stability stable
    * @category tracing
    * @since 2.0.0
    */
@@ -16807,6 +17346,7 @@ export const linkSpans: {
    * Effect.runSync(program).length // => 2
    * ```
    *
+   * @stability stable
    * @category tracing
    * @since 2.0.0
    */
@@ -16839,6 +17379,7 @@ export const linkSpans: {
  * Effect.runSync(program) // => "my-operation"
  * ```
  *
+ * @stability stable
  * @category tracing
  * @since 2.0.0
  */
@@ -16869,6 +17410,7 @@ export const makeSpan: (name: string, options?: SpanOptionsNoTrace) => Effect<Sp
  * Effect.runSync(program) // => "scoped-operation"
  * ```
  *
+ * @stability stable
  * @category tracing
  * @since 2.0.0
  */
@@ -16898,6 +17440,7 @@ export const makeSpanScoped: (
  * Effect.runSync(program) // => "user-operation: success"
  * ```
  *
+ * @stability stable
  * @category tracing
  * @since 2.0.0
  */
@@ -16923,6 +17466,7 @@ export const useSpan: {
    * Effect.runSync(program) // => "user-operation: success"
    * ```
    *
+   * @stability stable
    * @category tracing
    * @since 2.0.0
    */
@@ -16948,6 +17492,7 @@ export const useSpan: {
    * Effect.runSync(program) // => "user-operation: success"
    * ```
    *
+   * @stability stable
    * @category tracing
    * @since 2.0.0
    */
@@ -16974,6 +17519,7 @@ export const useSpan: {
  * Effect.runSync(traced) // => "result"
  * ```
  *
+ * @stability stable
  * @category tracing
  * @since 2.0.0
  */
@@ -16994,6 +17540,7 @@ export const withSpan: {
    * Effect.runSync(traced) // => "result"
    * ```
    *
+   * @stability stable
    * @category tracing
    * @since 2.0.0
    */
@@ -17021,6 +17568,7 @@ export const withSpan: {
    * Effect.runSync(traced) // => "result"
    * ```
    *
+   * @stability stable
    * @category tracing
    * @since 2.0.0
    */
@@ -17049,6 +17597,7 @@ export const withSpan: {
  * Effect.runSync(program) // => "completed"
  * ```
  *
+ * @stability stable
  * @category tracing
  * @since 2.0.0
  */
@@ -17075,6 +17624,7 @@ export const withSpanScoped: {
    * Effect.runSync(program) // => "completed"
    * ```
    *
+   * @stability stable
    * @category tracing
    * @since 2.0.0
    */
@@ -17103,6 +17653,7 @@ export const withSpanScoped: {
    * Effect.runSync(program) // => "completed"
    * ```
    *
+   * @stability stable
    * @category tracing
    * @since 2.0.0
    */
@@ -17126,6 +17677,7 @@ export const withSpanScoped: {
  * Effect.runSync(program) // => "completed"
  * ```
  *
+ * @stability stable
  * @category tracing
  * @since 2.0.0
  */
@@ -17147,6 +17699,7 @@ export const withParentSpan: {
    * Effect.runSync(program) // => "completed"
    * ```
    *
+   * @stability stable
    * @category tracing
    * @since 2.0.0
    */
@@ -17168,6 +17721,7 @@ export const withParentSpan: {
    * Effect.runSync(program) // => "completed"
    * ```
    *
+   * @stability stable
    * @category tracing
    * @since 2.0.0
    */
@@ -17216,6 +17770,7 @@ export const withParentSpan: {
  *
  * @see {@link requestUnsafe} for the low-level entry point when you already have a `Context` and need to enqueue outside an `Effect`
  *
+ * @stability stable
  * @category running
  * @since 2.0.0
  */
@@ -17262,6 +17817,7 @@ export const request: {
    *
    * @see {@link requestUnsafe} for the low-level entry point when you already have a `Context` and need to enqueue outside an `Effect`
    *
+   * @stability stable
    * @category running
    * @since 2.0.0
    */
@@ -17308,6 +17864,7 @@ export const request: {
    *
    * @see {@link requestUnsafe} for the low-level entry point when you already have a `Context` and need to enqueue outside an `Effect`
    *
+   * @stability stable
    * @category running
    * @since 2.0.0
    */
@@ -17328,6 +17885,7 @@ export const request: {
  *
  * @see {@link request} for the `Effect`-returning API used for normal request execution
  *
+ * @stability stable
  * @category unsafe
  * @since 4.0.0
  */
@@ -17383,6 +17941,7 @@ export const requestUnsafe: <A extends Request.Any>(
  * await Effect.runPromise(program) // => "result"
  * ```
  *
+ * @stability stable
  * @category forking
  * @since 4.0.0
  */
@@ -17426,6 +17985,7 @@ export const forkChild: <
  * await Effect.runPromise(program) // => "done"
  * ```
  *
+ * @stability stable
  * @category forking
  * @since 2.0.0
  */
@@ -17453,6 +18013,7 @@ export const forkIn: {
    * await Effect.runPromise(program) // => "done"
    * ```
    *
+   * @stability stable
    * @category forking
    * @since 2.0.0
    */
@@ -17486,6 +18047,7 @@ export const forkIn: {
    * await Effect.runPromise(program) // => "done"
    * ```
    *
+   * @stability stable
    * @category forking
    * @since 2.0.0
    */
@@ -17521,6 +18083,7 @@ export const forkIn: {
  * await Effect.runPromise(program) // => "scope completed"
  * ```
  *
+ * @stability stable
  * @category forking
  * @since 2.0.0
  */
@@ -17561,6 +18124,7 @@ export const forkScoped: <
  * await Effect.runPromise(program) // => "daemon result"
  * ```
  *
+ * @stability stable
  * @category forking
  * @since 4.0.0
  */
@@ -17604,6 +18168,7 @@ export const forkDetach: <
  * @see {@link forkIn} for forking into an explicit scope
  * @see {@link forkScoped} for forking fibers tied to the current scope
  *
+ * @stability stable
  * @category forking
  * @since 2.0.0
  */
@@ -17627,6 +18192,7 @@ export const awaitAllChildren: <A, E, R>(self: Effect<A, E, R>) => Effect<A, E,
  * output // => ["number"]
  * ```
  *
+ * @stability stable
  * @category accessors
  * @since 4.0.0
  */
@@ -17644,6 +18210,7 @@ export const fiber: Effect<Fiber<unknown, unknown>> = internal.fiber
  * Effect.runSync(program) // => "number"
  * ```
  *
+ * @stability stable
  * @category accessors
  * @since 2.0.0
  */
@@ -17673,6 +18240,7 @@ export const fiberId: Effect<number> = internal.fiberId
  * @see {@link runPromise} for promise-based running with these options
  * @see {@link runPromiseExit} for promise-based running that returns an `Exit`
  *
+ * @stability stable
  * @category running
  * @since 4.0.0
  */
@@ -17709,6 +18277,7 @@ export interface RunOptions {
  * output // => ["running...", "done"]
  * ```
  *
+ * @stability stable
  * @category running
  * @since 2.0.0
  */
@@ -17750,6 +18319,7 @@ export const runFork: <A, E>(effect: Effect<A, E, never>, options?: RunOptions |
  * output // => ["Hello from service!", "done"]
  * ```
  *
+ * @stability stable
  * @category running
  * @since 4.0.0
  */
@@ -17802,6 +18372,7 @@ export const runForkWith: <R>(
  * output // => ["Started", "Success"]
  * ```
  *
+ * @stability stable
  * @category running
  * @since 4.0.0
  */
@@ -17849,6 +18420,7 @@ export const runCallbackWith: <R>(
  * output // => ["working", "success: done"]
  * ```
  *
+ * @stability stable
  * @category running
  * @since 2.0.0
  */
@@ -17891,6 +18463,7 @@ export const runCallback: <A, E>(
  * ```
  *
  * @see {@link runPromiseExit} for a version that returns an `Exit` type instead of rejecting.
+ * @stability stable
  * @category running
  * @since 2.0.0
  */
@@ -17930,6 +18503,7 @@ export const runPromise: <A, E>(
  * await Effect.runPromiseWith(context)(program) // => "Connecting to https://api.example.com"
  * ```
  *
+ * @stability stable
  * @category running
  * @since 4.0.0
  */
@@ -17966,6 +18540,7 @@ export const runPromiseWith: <R>(
  *
  * @see {@link runPromise} for a version that rejects on failure.
  *
+ * @stability stable
  * @category running
  * @since 2.0.0
  */
@@ -18010,6 +18585,7 @@ export const runPromiseExit: <A, E>(
  * output // => ["Success: Result for: SELECT * FROM users"]
  * ```
  *
+ * @stability stable
  * @category running
  * @since 4.0.0
  */
@@ -18071,6 +18647,7 @@ export const runPromiseExitWith: <R>(
  *
  * @see {@link runSyncExit} for a version that returns an `Exit` type instead of
  * throwing an error.
+ * @stability stable
  * @category running
  * @since 2.0.0
  */
@@ -18108,6 +18685,7 @@ export const runSync: <A, E>(effect: Effect<A, E>) => A = internal.runSync
  * result // => 5
  * ```
  *
+ * @stability stable
  * @category running
  * @since 4.0.0
  */
@@ -18159,6 +18737,7 @@ export const runSyncWith: <R>(
  *
  * @see {@link runSync} for a version that throws on failure.
  *
+ * @stability stable
  * @category running
  * @since 2.0.0
  */
@@ -18204,6 +18783,7 @@ export const runSyncExit: <A, E>(effect: Effect<A, E>) => Exit.Exit<A, E> = inte
  * output // => ["[LOG] Computing result...", "Success: 42"]
  * ```
  *
+ * @stability stable
  * @category running
  * @since 4.0.0
  */
@@ -18222,6 +18802,7 @@ export const runSyncExitWith: <R>(
  *
  * Use these to describe generator-based signatures and traced or untraced variants.
  *
+ * @stability stable
  * @category constructors
  * @since 3.11.0
  */
@@ -22396,6 +22977,7 @@ export declare namespace fn {
  * Effect.runSync(program) // => "hello"
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 3.12.0
  */
@@ -22520,6 +23102,7 @@ export const fnUntraced: fn.Untraced = internal.fnUntraced
  * Effect.runSync(program) // => "hello"
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 3.11.0
  */
@@ -22549,6 +23132,7 @@ export const fn: fn.Traced & {
  * Effect.runSync(program) // => "Clock is available"
  * ```
  *
+ * @stability stable
  * @category accessors
  * @since 2.0.0
  */
@@ -22590,6 +23174,7 @@ export const clockWith: <A, E, R>(
  * output // => ["Warn: Cache miss"]
  * ```
  *
+ * @stability stable
  * @category logging
  * @since 2.0.0
  */
@@ -22619,6 +23204,7 @@ export const logWithLevel: (level?: Severity) => (...message: ReadonlyArray<any>
  * output // => ["Info: Result: 4", 4]
  * ```
  *
+ * @stability stable
  * @category logging
  * @since 2.0.0
  */
@@ -22645,6 +23231,7 @@ export const log: (...message: ReadonlyArray<any>) => Effect<void> = internal.lo
  * output // => ["Fatal: Critical system failure"]
  * ```
  *
+ * @stability stable
  * @category logging
  * @since 2.0.0
  */
@@ -22670,6 +23257,7 @@ export const logFatal: (...message: ReadonlyArray<any>) => Effect<void> = intern
  * output // => ["Warn: API rate limit approaching"]
  * ```
  *
+ * @stability stable
  * @category logging
  * @since 2.0.0
  */
@@ -22695,6 +23283,7 @@ export const logWarning: (...message: ReadonlyArray<any>) => Effect<void> = inte
  * output // => ["Error: Database connection failed"]
  * ```
  *
+ * @stability stable
  * @category logging
  * @since 2.0.0
  */
@@ -22720,6 +23309,7 @@ export const logError: (...message: ReadonlyArray<any>) => Effect<void> = intern
  * output // => ["Info: Application starting up"]
  * ```
  *
+ * @stability stable
  * @category logging
  * @since 2.0.0
  */
@@ -22749,6 +23339,7 @@ export const logInfo: (...message: ReadonlyArray<any>) => Effect<void> = interna
  * output // => ["Debug: Debug mode enabled"]
  * ```
  *
+ * @stability stable
  * @category logging
  * @since 2.0.0
  */
@@ -22778,6 +23369,7 @@ export const logDebug: (...message: ReadonlyArray<any>) => Effect<void> = intern
  * output // => ["Trace: Entering function processData"]
  * ```
  *
+ * @stability stable
  * @category logging
  * @since 2.0.0
  */
@@ -22809,6 +23401,7 @@ export const logTrace: (...message: ReadonlyArray<any>) => Effect<void> = intern
  * output // => ["[CUSTOM]: This will go to both default and custom logger"]
  * ```
  *
+ * @stability stable
  * @category logging
  * @since 4.0.0
  */
@@ -22839,6 +23432,7 @@ export const withLogger: {
    * output // => ["[CUSTOM]: This will go to both default and custom logger"]
    * ```
    *
+   * @stability stable
    * @category logging
    * @since 4.0.0
    */
@@ -22869,6 +23463,7 @@ export const withLogger: {
    * output // => ["[CUSTOM]: This will go to both default and custom logger"]
    * ```
    *
+   * @stability stable
    * @category logging
    * @since 4.0.0
    */
@@ -22915,6 +23510,7 @@ export const withLogger: {
  * output // => ["Starting operation", "Starting operation"]
  * ```
  *
+ * @stability stable
  * @category logging
  * @since 2.0.0
  */
@@ -22951,6 +23547,7 @@ export const annotateLogs: {
    * output // => ["Starting operation", "Starting operation"]
    * ```
    *
+   * @stability stable
    * @category logging
    * @since 2.0.0
    */
@@ -22987,6 +23584,7 @@ export const annotateLogs: {
    * output // => ["Starting operation", "Starting operation"]
    * ```
    *
+   * @stability stable
    * @category logging
    * @since 2.0.0
    */
@@ -23023,6 +23621,7 @@ export const annotateLogs: {
    * output // => ["Starting operation", "Starting operation"]
    * ```
    *
+   * @stability stable
    * @category logging
    * @since 2.0.0
    */
@@ -23059,6 +23658,7 @@ export const annotateLogs: {
    * output // => ["Starting operation", "Starting operation"]
    * ```
    *
+   * @stability stable
    * @category logging
    * @since 2.0.0
    */
@@ -23116,6 +23716,7 @@ export const annotateLogs: {
  *
  * @see {@link annotateLogs} for annotating one effect
  *
+ * @stability stable
  * @category logging
  * @since 3.1.0
  */
@@ -23156,6 +23757,7 @@ export const annotateLogsScoped: {
    *
    * @see {@link annotateLogs} for annotating one effect
    *
+   * @stability stable
    * @category logging
    * @since 3.1.0
    */
@@ -23196,6 +23798,7 @@ export const annotateLogsScoped: {
    *
    * @see {@link annotateLogs} for annotating one effect
    *
+   * @stability stable
    * @category logging
    * @since 3.1.0
    */
@@ -23234,6 +23837,7 @@ export const annotateLogsScoped: {
  * output // => ["Making HTTP request", "Connecting to database", "Executing query", "Processing results", "Sending response", "data"]
  * ```
  *
+ * @stability stable
  * @category logging
  * @since 2.0.0
  */
@@ -23270,6 +23874,7 @@ export const withLogSpan: {
    * output // => ["Making HTTP request", "Connecting to database", "Executing query", "Processing results", "Sending response", "data"]
    * ```
    *
+   * @stability stable
    * @category logging
    * @since 2.0.0
    */
@@ -23306,6 +23911,7 @@ export const withLogSpan: {
    * output // => ["Making HTTP request", "Connecting to database", "Executing query", "Processing results", "Sending response", "data"]
    * ```
    *
+   * @stability stable
    * @category logging
    * @since 2.0.0
    */
@@ -23367,6 +23973,7 @@ export const withLogSpan: {
  * Effect.runSync(Metric.value(exitTracker)).occurrences.get("success") // => 1
  * ```
  *
+ * @stability stable
  * @category metrics
  * @since 4.0.0
  */
@@ -23418,6 +24025,7 @@ export const track: {
    * Effect.runSync(Metric.value(exitTracker)).occurrences.get("success") // => 1
    * ```
    *
+   * @stability stable
    * @category metrics
    * @since 4.0.0
    */
@@ -23469,6 +24077,7 @@ export const track: {
    * Effect.runSync(Metric.value(exitTracker)).occurrences.get("success") // => 1
    * ```
    *
+   * @stability stable
    * @category metrics
    * @since 4.0.0
    */
@@ -23520,6 +24129,7 @@ export const track: {
    * Effect.runSync(Metric.value(exitTracker)).occurrences.get("success") // => 1
    * ```
    *
+   * @stability stable
    * @category metrics
    * @since 4.0.0
    */
@@ -23575,6 +24185,7 @@ export const track: {
    * Effect.runSync(Metric.value(exitTracker)).occurrences.get("success") // => 1
    * ```
    *
+   * @stability stable
    * @category metrics
    * @since 4.0.0
    */
@@ -23637,6 +24248,7 @@ export const track: {
  * Effect.runSync(Metric.value(requestSizeGauge)).value // => 12
  * ```
  *
+ * @stability stable
  * @category metrics
  * @since 4.0.0
  */
@@ -23683,6 +24295,7 @@ export const trackSuccesses: {
    * Effect.runSync(Metric.value(requestSizeGauge)).value // => 12
    * ```
    *
+   * @stability stable
    * @category metrics
    * @since 4.0.0
    */
@@ -23729,6 +24342,7 @@ export const trackSuccesses: {
    * Effect.runSync(Metric.value(requestSizeGauge)).value // => 12
    * ```
    *
+   * @stability stable
    * @category metrics
    * @since 4.0.0
    */
@@ -23775,6 +24389,7 @@ export const trackSuccesses: {
    * Effect.runSync(Metric.value(requestSizeGauge)).value // => 12
    * ```
    *
+   * @stability stable
    * @category metrics
    * @since 4.0.0
    */
@@ -23825,6 +24440,7 @@ export const trackSuccesses: {
    * Effect.runSync(Metric.value(requestSizeGauge)).value // => 12
    * ```
    *
+   * @stability stable
    * @category metrics
    * @since 4.0.0
    */
@@ -23886,6 +24502,7 @@ export const trackSuccesses: {
  * Effect.runSync(Metric.value(errorTypeFrequency)).occurrences.get("ConnectionFailedError") // => 1
  * ```
  *
+ * @stability stable
  * @category metrics
  * @since 4.0.0
  */
@@ -23934,6 +24551,7 @@ export const trackErrors: {
    * Effect.runSync(Metric.value(errorTypeFrequency)).occurrences.get("ConnectionFailedError") // => 1
    * ```
    *
+   * @stability stable
    * @category metrics
    * @since 4.0.0
    */
@@ -23982,6 +24600,7 @@ export const trackErrors: {
    * Effect.runSync(Metric.value(errorTypeFrequency)).occurrences.get("ConnectionFailedError") // => 1
    * ```
    *
+   * @stability stable
    * @category metrics
    * @since 4.0.0
    */
@@ -24030,6 +24649,7 @@ export const trackErrors: {
    * Effect.runSync(Metric.value(errorTypeFrequency)).occurrences.get("ConnectionFailedError") // => 1
    * ```
    *
+   * @stability stable
    * @category metrics
    * @since 4.0.0
    */
@@ -24082,6 +24702,7 @@ export const trackErrors: {
    * Effect.runSync(Metric.value(errorTypeFrequency)).occurrences.get("ConnectionFailedError") // => 1
    * ```
    *
+   * @stability stable
    * @category metrics
    * @since 4.0.0
    */
@@ -24144,6 +24765,7 @@ export const trackErrors: {
  * Effect.runSync(Metric.value(defectTypeFrequency)).occurrences.get("Error") // => 1
  * ```
  *
+ * @stability stable
  * @category metrics
  * @since 4.0.0
  */
@@ -24193,6 +24815,7 @@ export const trackDefects: {
    * Effect.runSync(Metric.value(defectTypeFrequency)).occurrences.get("Error") // => 1
    * ```
    *
+   * @stability stable
    * @category metrics
    * @since 4.0.0
    */
@@ -24242,6 +24865,7 @@ export const trackDefects: {
    * Effect.runSync(Metric.value(defectTypeFrequency)).occurrences.get("Error") // => 1
    * ```
    *
+   * @stability stable
    * @category metrics
    * @since 4.0.0
    */
@@ -24291,6 +24915,7 @@ export const trackDefects: {
    * Effect.runSync(Metric.value(defectTypeFrequency)).occurrences.get("Error") // => 1
    * ```
    *
+   * @stability stable
    * @category metrics
    * @since 4.0.0
    */
@@ -24344,6 +24969,7 @@ export const trackDefects: {
    * Effect.runSync(Metric.value(defectTypeFrequency)).occurrences.get("Error") // => 1
    * ```
    *
+   * @stability stable
    * @category metrics
    * @since 4.0.0
    */
@@ -24398,6 +25024,7 @@ export const trackDefects: {
  * Effect.runSync(Metric.value(durationGauge)).value // => 1
  * ```
  *
+ * @stability stable
  * @category metrics
  * @since 4.0.0
  */
@@ -24443,6 +25070,7 @@ export const trackDuration: {
    * Effect.runSync(Metric.value(durationGauge)).value // => 1
    * ```
    *
+   * @stability stable
    * @category metrics
    * @since 4.0.0
    */
@@ -24491,6 +25119,7 @@ export const trackDuration: {
    * Effect.runSync(Metric.value(durationGauge)).value // => 1
    * ```
    *
+   * @stability stable
    * @category metrics
    * @since 4.0.0
    */
@@ -24536,6 +25165,7 @@ export const trackDuration: {
    * Effect.runSync(Metric.value(durationGauge)).value // => 1
    * ```
    *
+   * @stability stable
    * @category metrics
    * @since 4.0.0
    */
@@ -24585,6 +25215,7 @@ export const trackDuration: {
    * Effect.runSync(Metric.value(durationGauge)).value // => 1
    * ```
    *
+   * @stability stable
    * @category metrics
    * @since 4.0.0
    */
@@ -24641,6 +25272,7 @@ export const trackDuration: {
  * Effect.runSync(runnable) // => "Transaction complete"
  * ```
  *
+ * @stability stable
  * @category transactions
  * @since 4.0.0
  */
@@ -24702,6 +25334,7 @@ export class Transaction extends Context.Service<
  * output // => ["Transaction sum: 30", "Final ref1: 10", "Final ref2: 20"]
  * ```
  *
+ * @stability stable
  * @category transactions
  * @since 4.0.0
  */
@@ -24710,7 +25343,7 @@ export const tx = <A, E, R>(
 ): Effect<A, E, Exclude<R, Transaction>> =>
   withFiber((fiber) => {
     let state = Context.getOrUndefined(fiber.context, Transaction)
-    if (state) {
+    if (state && !completedTransactions.has(state)) {
       return effect as Effect<A, E, Exclude<R, Transaction>>
     }
     // Create transaction state only at the outermost boundary
@@ -24723,8 +25356,11 @@ export const tx = <A, E, R>(
           body: constant(
             restore(effect).pipe(
               provideService(Transaction, state),
-              tapCause(() => {
+              tapCause((cause) => {
                 if (!state.retry) return void_
+                // txRetry interrupts the body; any other reason in the cause is a real failure.
+                // Roll back now so the step below fails instead of waiting or rerunning.
+                if (!internal.hasInterruptsOnly(cause)) return sync(() => clearTransaction(state))
                 return restore(awaitPendingTransaction(state))
               }),
               exit
@@ -24736,9 +25372,9 @@ export const tx = <A, E, R>(
             }
             if (Exit.isSuccess(exit)) {
               commitTransaction(fiber, state)
-            } else {
-              clearTransaction(state)
             }
+            clearTransaction(state)
+            completedTransactions.add(state)
             result = exit
           }
         }),
@@ -24747,6 +25383,10 @@ export const tx = <A, E, R>(
     )
   })
 
+// Child fibers inherit the boundary's state, so mark it completed once the
+// boundary finishes and let later `tx` calls start a fresh boundary.
+const completedTransactions = new WeakSet<Transaction["Service"]>()
+
 const isTransactionConsistent = (state: Transaction["Service"]) => {
   for (const [ref, { version }] of state.journal) {
     if (ref.version !== version) {
@@ -24833,6 +25473,7 @@ function clearTransaction(state: Transaction["Service"]) {
  * await Effect.runPromise(program) // => 1
  * ```
  *
+ * @stability stable
  * @category transactions
  * @since 4.0.0
  */
@@ -24846,6 +25487,7 @@ export const txRetry: Effect<never, never, Transaction> = flatMap(
 /**
  * Type helpers for converting callback-based functions into `Effect` functions.
  *
+ * @stability stable
  * @category converting
  * @since 4.0.0
  */
@@ -25142,6 +25784,7 @@ type EffectifyArgs<F extends (...args: Array<any>) => any> = Parameters<F> exten
  * error.message // => "Failed to process hello: unavailable"
  * ```
  *
+ * @stability stable
  * @category converting
  * @since 4.0.0
  */
@@ -25195,6 +25838,7 @@ export const effectify: {
    * error.message // => "Failed to process hello: unavailable"
    * ```
    *
+   * @stability stable
    * @category converting
    * @since 4.0.0
    */
@@ -25248,6 +25892,7 @@ export const effectify: {
    * error.message // => "Failed to process hello: unavailable"
    * ```
    *
+   * @stability stable
    * @category converting
    * @since 4.0.0
    */
@@ -25304,6 +25949,7 @@ export const effectify: {
    * error.message // => "Failed to process hello: unavailable"
    * ```
    *
+   * @stability stable
    * @category converting
    * @since 4.0.0
    */
@@ -25319,7 +25965,7 @@ export const effectify: {
       try {
         fn(...args, (err: globalThis.Error | null, result: A) => {
           if (err) {
-            resume(fail(onError ? onError(err, args) : err))
+            resume(onError ? suspend(() => fail(onError(err, args))) : fail(err))
           } else {
             resume(succeed(result))
           }
@@ -25359,6 +26005,7 @@ export const effectify: {
  * // Type 'string' is not assignable to type 'number'
  * ```
  *
+ * @stability stable
  * @category utility types
  * @since 4.0.0
  */
@@ -25392,6 +26039,7 @@ export const satisfiesSuccessType = <A>() => <A2 extends A, E, R>(effect: Effect
  * // Type 'string' is not assignable to type 'ValidationError'
  * ```
  *
+ * @stability stable
  * @category utility types
  * @since 4.0.0
  */
@@ -25422,6 +26070,7 @@ export const satisfiesErrorType = <E>() => <A, E2 extends E, R>(effect: Effect<A
  * // const constrainedInvalid = satisfiesStringServices(invalidEffect)
  * ```
  *
+ * @stability stable
  * @category utility types
  * @since 4.0.0
  */
@@ -25456,6 +26105,7 @@ export const satisfiesServicesType = <R>() => <A, E, R2 extends R>(effect: Effec
  * await Effect.runPromise(Effect.all([mapped, mappedPending])) // => [10, 10]
  * ```
  *
+ * @stability stable
  * @category mapping
  * @since 4.0.0
  */
@@ -25489,6 +26139,7 @@ export const mapEager: {
    * await Effect.runPromise(Effect.all([mapped, mappedPending])) // => [10, 10]
    * ```
    *
+   * @stability stable
    * @category mapping
    * @since 4.0.0
    */
@@ -25522,6 +26173,7 @@ export const mapEager: {
    * await Effect.runPromise(Effect.all([mapped, mappedPending])) // => [10, 10]
    * ```
    *
+   * @stability stable
    * @category mapping
    * @since 4.0.0
    */
@@ -25567,6 +26219,7 @@ export const mapEager: {
  * output // => [['mapped: original error', 'mapped: error']]
  * ```
  *
+ * @stability stable
  * @category error handling
  * @since 4.0.0
  */
@@ -25610,6 +26263,7 @@ export const mapErrorEager: {
    * output // => [['mapped: original error', 'mapped: error']]
    * ```
    *
+   * @stability stable
    * @category error handling
    * @since 4.0.0
    */
@@ -25653,6 +26307,7 @@ export const mapErrorEager: {
    * output // => [['mapped: original error', 'mapped: error']]
    * ```
    *
+   * @stability stable
    * @category error handling
    * @since 4.0.0
    */
@@ -25697,6 +26352,7 @@ export const mapErrorEager: {
  * output // => [10, "Failed: error"]
  * ```
  *
+ * @stability stable
  * @category mapping
  * @since 4.0.0
  */
@@ -25739,6 +26395,7 @@ export const mapBothEager: {
    * output // => [10, "Failed: error"]
    * ```
    *
+   * @stability stable
    * @category mapping
    * @since 4.0.0
    */
@@ -25783,6 +26440,7 @@ export const mapBothEager: {
    * output // => [10, "Failed: error"]
    * ```
    *
+   * @stability stable
    * @category mapping
    * @since 4.0.0
    */
@@ -25825,6 +26483,7 @@ export const mapBothEager: {
  * await Effect.runPromise(Effect.all([flatMapped, flatMappedPending])) // => [10, 10]
  * ```
  *
+ * @stability stable
  * @category sequencing
  * @since 4.0.0
  */
@@ -25862,6 +26521,7 @@ export const flatMapEager: {
    * await Effect.runPromise(Effect.all([flatMapped, flatMappedPending])) // => [10, 10]
    * ```
    *
+   * @stability stable
    * @category sequencing
    * @since 4.0.0
    */
@@ -25899,6 +26559,7 @@ export const flatMapEager: {
    * await Effect.runPromise(Effect.all([flatMapped, flatMappedPending])) // => [10, 10]
    * ```
    *
+   * @stability stable
    * @category sequencing
    * @since 4.0.0
    */
@@ -25954,6 +26615,7 @@ export const flatMapEager: {
  * output // => [['recovered from: original error', 42, 'recovered from: error']]
  * ```
  *
+ * @stability stable
  * @category error handling
  * @since 4.0.0
  */
@@ -26007,6 +26669,7 @@ export const catchEager: {
    * output // => [['recovered from: original error', 42, 'recovered from: error']]
    * ```
    *
+   * @stability stable
    * @category error handling
    * @since 4.0.0
    */
@@ -26060,6 +26723,7 @@ export const catchEager: {
    * output // => [['recovered from: original error', 42, 'recovered from: error']]
    * ```
    *
+   * @stability stable
    * @category error handling
    * @since 4.0.0
    */
@@ -26089,6 +26753,7 @@ export const catchEager: {
  * Effect.runSync(effect) // => "computed eagerly"
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */