effect 4.0.0 → 4.0.2

package/dist/Effect.d.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";
@@ -42,6 +43,7 @@ import type * as Unify from "./Unify.ts";
 /**
  * Type-level identifier for `Effect` values.
  *
+ * @stability stable
  * @category type IDs
  * @since 4.0.0
  */
@@ -49,6 +51,7 @@ export type TypeId = "~effect/Effect";
 /**
  * Runtime identifier used to recognize `Effect` values.
  *
+ * @stability stable
  * @category type IDs
  * @since 4.0.0
  */
@@ -74,6 +77,7 @@ export declare const TypeId: TypeId;
  * 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
  */
@@ -87,6 +91,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
  */
@@ -98,6 +103,7 @@ export interface EffectUnify<A extends {
 /**
  * Type lambda used to represent `Effect` in higher-kinded APIs.
  *
+ * @stability stable
  * @category utility types
  * @since 2.0.0
  */
@@ -107,6 +113,7 @@ export interface EffectTypeLambda extends TypeLambda {
 /**
  * Variance interface for Effect, encoding the type parameters' variance.
  *
+ * @stability stable
  * @category models
  * @since 2.0.0
  */
@@ -126,6 +133,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
  */
@@ -145,6 +153,7 @@ export type Success<T> = T extends Effect<infer _A, infer _E, infer _R> ? _A : n
  * @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
  */
@@ -160,6 +169,7 @@ export type Error<T> = T extends Effect<infer _A, infer _E, infer _R> ? _E : nev
  * @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
  */
@@ -176,6 +186,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
  */
@@ -190,6 +201,7 @@ export declare const isEffect: (u: unknown) => u is Effect<unknown, unknown, unk
  *
  * @see {@link gen} for writing generator-based `Effect` programs that consume this iterator protocol
  *
+ * @stability stable
  * @category models
  * @since 4.0.0
  */
@@ -200,6 +212,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
  */
@@ -382,6 +395,7 @@ export declare namespace All {
  * ```
  *
  * @see {@link forEach} for iterating over elements and applying an effect.
+ * @stability stable
  * @category collecting
  * @since 2.0.0
  */
@@ -414,6 +428,7 @@ export declare const all: <const Arg extends Iterable<Effect<any, any, any>> | R
  * await Effect.runPromise(program) // => [[1, 3], ['0 is even', '2 is even']]
  * ```
  *
+ * @stability stable
  * @category collecting
  * @since 2.0.0
  */
@@ -442,6 +457,7 @@ export declare const partition: {
      * await Effect.runPromise(program) // => [[1, 3], ['0 is even', '2 is even']]
      * ```
      *
+     * @stability stable
      * @category collecting
      * @since 2.0.0
      */
@@ -472,6 +488,7 @@ export declare const partition: {
      * await Effect.runPromise(program) // => [[1, 3], ['0 is even', '2 is even']]
      * ```
      *
+     * @stability stable
      * @category collecting
      * @since 2.0.0
      */
@@ -513,6 +530,7 @@ export declare 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
  */
@@ -551,6 +569,7 @@ export declare 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
      */
@@ -589,6 +608,7 @@ export declare 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
      */
@@ -618,6 +638,7 @@ export declare const reduce: {
  * await Effect.runPromiseExit(program) // => Exit.fail(["0 is even", "2 is even"])
  * ```
  *
+ * @stability stable
  * @category collecting
  * @since 2.0.0
  */
@@ -646,6 +667,7 @@ export declare const validate: {
      * await Effect.runPromiseExit(program) // => Exit.fail(["0 is even", "2 is even"])
      * ```
      *
+     * @stability stable
      * @category collecting
      * @since 2.0.0
      */
@@ -677,6 +699,7 @@ export declare const validate: {
      * await Effect.runPromiseExit(program) // => Exit.fail(["0 is even", "2 is even"])
      * ```
      *
+     * @stability stable
      * @category collecting
      * @since 2.0.0
      */
@@ -708,6 +731,7 @@ export declare const validate: {
      * await Effect.runPromiseExit(program) // => Exit.fail(["0 is even", "2 is even"])
      * ```
      *
+     * @stability stable
      * @category collecting
      * @since 2.0.0
      */
@@ -739,6 +763,7 @@ export declare const validate: {
      * await Effect.runPromiseExit(program) // => Exit.fail(["0 is even", "2 is even"])
      * ```
      *
+     * @stability stable
      * @category collecting
      * @since 2.0.0
      */
@@ -765,6 +790,7 @@ export declare const validate: {
  * await Effect.runPromise(program) // => Option.some(3)
  * ```
  *
+ * @stability stable
  * @category collecting
  * @since 2.0.0
  */
@@ -787,6 +813,7 @@ export declare const findFirst: {
      * await Effect.runPromise(program) // => Option.some(3)
      * ```
      *
+     * @stability stable
      * @category collecting
      * @since 2.0.0
      */
@@ -809,6 +836,7 @@ export declare const findFirst: {
      * await Effect.runPromise(program) // => Option.some(3)
      * ```
      *
+     * @stability stable
      * @category collecting
      * @since 2.0.0
      */
@@ -829,6 +857,7 @@ export declare const findFirst: {
  *
  * @see {@link findFirst} for the simpler effectful predicate-based variant
  *
+ * @stability stable
  * @category collecting
  * @since 4.0.0
  */
@@ -848,6 +877,7 @@ export declare const findFirstFilter: {
      *
      * @see {@link findFirst} for the simpler effectful predicate-based variant
      *
+     * @stability stable
      * @category collecting
      * @since 4.0.0
      */
@@ -867,6 +897,7 @@ export declare const findFirstFilter: {
      *
      * @see {@link findFirst} for the simpler effectful predicate-based variant
      *
+     * @stability stable
      * @category collecting
      * @since 4.0.0
      */
@@ -933,6 +964,7 @@ export declare const findFirstFilter: {
  * ```
  *
  * @see {@link all} for combining multiple effects into one.
+ * @stability stable
  * @category collecting
  * @since 2.0.0
  */
@@ -998,6 +1030,7 @@ export declare const forEach: {
      * ```
      *
      * @see {@link all} for combining multiple effects into one.
+     * @stability stable
      * @category collecting
      * @since 2.0.0
      */
@@ -1066,6 +1099,7 @@ export declare const forEach: {
      * ```
      *
      * @see {@link all} for combining multiple effects into one.
+     * @stability stable
      * @category collecting
      * @since 2.0.0
      */
@@ -1095,6 +1129,7 @@ export declare const forEach: {
  * await Effect.runPromise(empty) // => Option.none()
  * ```
  *
+ * @stability stable
  * @category collecting
  * @since 2.0.0
  */
@@ -1120,6 +1155,7 @@ export declare const head: <A, E, R>(self: Effect<Iterable<A>, E, R>) => Effect<
  * output // => ["Current count: 1", "Current count: 2", "Current count: 3", "Current count: 4", "Current count: 5"]
  * ```
  *
+ * @stability stable
  * @category repetition
  * @since 2.0.0
  */
@@ -1165,6 +1201,7 @@ export declare const whileLoop: <A, E, R>(options: {
  * ```
  *
  * @see {@link tryPromise} for a version that can handle failures.
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -1236,6 +1273,7 @@ export declare const promise: <A>(evaluate: (signal: AbortSignal) => PromiseLike
  * ```
  *
  * @see {@link promise} if the effectful computation is asynchronous and does not throw errors.
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -1307,6 +1345,7 @@ export declare const tryPromise: {
      * ```
      *
      * @see {@link promise} if the effectful computation is asynchronous and does not throw errors.
+     * @stability stable
      * @category constructors
      * @since 2.0.0
      */
@@ -1378,6 +1417,7 @@ export declare const tryPromise: {
      * ```
      *
      * @see {@link promise} if the effectful computation is asynchronous and does not throw errors.
+     * @stability stable
      * @category constructors
      * @since 2.0.0
      */
@@ -1408,6 +1448,7 @@ export declare const tryPromise: {
  * ```
  *
  * @see {@link fail} to create an effect that represents a failure.
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -1425,6 +1466,7 @@ export declare const succeed: <A>(value: A) => Effect<A>;
  * Effect.runSync(program) // => Option.none()
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -1442,6 +1484,7 @@ export declare const succeedNone: Effect<Option<never>>;
  * Effect.runSync(program) // => Option.some(42)
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -1532,6 +1575,7 @@ export declare const succeedSome: <A>(value: A) => Effect<Option<A>>;
  * Effect.runSync(withSuspend(6, 2)) // => 3
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -1572,6 +1616,7 @@ export declare const suspend: <A, E, R>(effect: LazyArg<Effect<A, E, R>>) => Eff
  * ```
  *
  * @see {@link try_ | try} for a version that can handle failures.
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -1581,6 +1626,7 @@ export {
 /**
  * Returns an effect that succeeds with `void`.
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -1590,6 +1636,7 @@ export {
 /**
  * Returns an effect that succeeds with `undefined`.
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -1627,6 +1674,7 @@ undefined_ as undefined };
  * output // => ["callback completed"]
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -1644,6 +1692,7 @@ export declare const callback: <A, E = never, R = never>(register: (this: Schedu
  * await Effect.runPromise(program) // => Option.none()
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -1667,6 +1716,7 @@ export declare const never: Effect<never>;
  * Effect.runSync(program) // => { x: 2, y: 3, sum: 5 }
  * ```
  *
+ * @stability stable
  * @category do notation
  * @since 2.0.0
  */
@@ -1683,6 +1733,7 @@ export declare const Do: Effect<{}>;
  * @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
  */
@@ -1699,6 +1750,7 @@ export declare 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
      */
@@ -1717,6 +1769,7 @@ export declare 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
      */
@@ -1748,6 +1801,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
  */
@@ -1776,6 +1830,7 @@ let_ as let };
  * @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
  */
@@ -1804,6 +1859,7 @@ export declare 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
      */
@@ -1832,6 +1888,7 @@ export declare 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
      */
@@ -1886,6 +1943,7 @@ export declare const bind: {
  * await Effect.runPromise(program) // => "Final amount to charge: 96"
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -1939,6 +1997,7 @@ export declare const gen: {
      * await Effect.runPromise(program) // => "Final amount to charge: 96"
      * ```
      *
+     * @stability stable
      * @category constructors
      * @since 2.0.0
      */
@@ -1996,6 +2055,7 @@ export declare const gen: {
      * await Effect.runPromise(program) // => "Final amount to charge: 96"
      * ```
      *
+     * @stability stable
      * @category constructors
      * @since 2.0.0
      */
@@ -2010,6 +2070,7 @@ export declare const gen: {
 /**
  * Type helpers for `Effect.gen` generator return signatures.
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -2050,6 +2111,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
  */
@@ -2077,6 +2139,7 @@ export declare const fail: <E>(error: E) => Effect<never, E>;
  * Effect.runSync(Effect.flip(program)).operation // => "sync"
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -2107,6 +2170,7 @@ export declare const failSync: <E>(evaluate: LazyArg<E>) => Effect<never, E>;
  * Effect.runSync(Effect.flip(program)) // => "Network error"
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -2134,6 +2198,7 @@ export declare const failCause: <E>(cause: Cause.Cause<E>) => Effect<never, E>;
  * Effect.runSync(Effect.flip(program)) // => "Error computed at runtime"
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -2173,6 +2238,7 @@ export declare const failCauseSync: <E>(evaluate: LazyArg<Cause.Cause<E>>) => Ef
  * Effect.runSyncExit(program) // => Exit.die(defect)
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -2245,6 +2311,7 @@ export {
  *
  * @see {@link sync} if the effectful computation is synchronous and does not
  * throw errors.
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -2268,6 +2335,7 @@ try_ as try };
  * output // => ["Before yield", "After yield"]
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -2291,6 +2359,7 @@ export declare const yieldNow: Effect<void>;
  * output // => ["High priority task", "Continued after yield"]
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -2308,6 +2377,7 @@ export declare const yieldNowWith: (priority?: number) => Effect<void>;
  * Effect.runSync(program) // => "number"
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -2325,6 +2395,7 @@ export declare const withFiber: <A, E = never, R = never>(evaluate: (fiber: Fibe
  * Effect.runSync(program) // => "number"
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -2349,6 +2420,7 @@ export declare const withFiberSucceed: <A, R = never>(evaluate: (fiber: Fiber<un
  * output // => [42, "Something went wrong"]
  * ```
  *
+ * @stability stable
  * @category converting
  * @since 4.0.0
  */
@@ -2387,6 +2459,7 @@ export declare const fromResult: <A, E>(result: Result.Result<A, E>) => Effect<A
  * output // => [42, "NoSuchElementError", "missing"]
  * ```
  *
+ * @stability stable
  * @category converting
  * @since 4.0.0
  */
@@ -2419,6 +2492,7 @@ export declare const fromOption: <Arg extends Option<unknown> | LazyArg<unknown>
  * Effect.runSync(program) // => Option.some(42)
  * ```
  *
+ * @stability stable
  * @category converting
  * @since 3.13.0
  */
@@ -2445,6 +2519,7 @@ export declare const transposeOption: <A = never, E = never, R = never>(self: Op
  * output // => ["missing", "hello"]
  * ```
  *
+ * @stability stable
  * @category converting
  * @since 4.0.0
  */
@@ -2519,6 +2594,7 @@ export declare const fromNullishOr: <A>(value: A) => Effect<NonNullable<A>, Caus
  * ```
  *
  * @see {@link tap} for a version that ignores the result of the effect.
+ * @stability stable
  * @category sequencing
  * @since 2.0.0
  */
@@ -2593,6 +2669,7 @@ export declare const flatMap: {
      * ```
      *
      * @see {@link tap} for a version that ignores the result of the effect.
+     * @stability stable
      * @category sequencing
      * @since 2.0.0
      */
@@ -2667,6 +2744,7 @@ export declare const flatMap: {
      * ```
      *
      * @see {@link tap} for a version that ignores the result of the effect.
+     * @stability stable
      * @category sequencing
      * @since 2.0.0
      */
@@ -2692,6 +2770,7 @@ export declare const flatMap: {
  * output // => ["hello"]
  * ```
  *
+ * @stability stable
  * @category sequencing
  * @since 2.0.0
  */
@@ -2774,6 +2853,7 @@ export declare const flatten: <A, E, R, E2, R2>(self: Effect<Effect<A, E, R>, E2
  * await Effect.runPromise(result2) // => 190
  * ```
  *
+ * @stability stable
  * @category sequencing
  * @since 2.0.0
  */
@@ -2856,6 +2936,7 @@ export declare const andThen: {
      * await Effect.runPromise(result2) // => 190
      * ```
      *
+     * @stability stable
      * @category sequencing
      * @since 2.0.0
      */
@@ -2938,6 +3019,7 @@ export declare const andThen: {
      * await Effect.runPromise(result2) // => 190
      * ```
      *
+     * @stability stable
      * @category sequencing
      * @since 2.0.0
      */
@@ -3020,6 +3102,7 @@ export declare const andThen: {
      * await Effect.runPromise(result2) // => 190
      * ```
      *
+     * @stability stable
      * @category sequencing
      * @since 2.0.0
      */
@@ -3102,6 +3185,7 @@ export declare const andThen: {
      * await Effect.runPromise(result2) // => 190
      * ```
      *
+     * @stability stable
      * @category sequencing
      * @since 2.0.0
      */
@@ -3155,6 +3239,7 @@ export declare const andThen: {
  * output // => ["Apply a discount to: 100", 95]
  * ```
  *
+ * @stability stable
  * @category sequencing
  * @since 2.0.0
  */
@@ -3207,6 +3292,7 @@ export declare const tap: {
      * output // => ["Apply a discount to: 100", 95]
      * ```
      *
+     * @stability stable
      * @category sequencing
      * @since 2.0.0
      */
@@ -3259,6 +3345,7 @@ export declare const tap: {
      * output // => ["Apply a discount to: 100", 95]
      * ```
      *
+     * @stability stable
      * @category sequencing
      * @since 2.0.0
      */
@@ -3311,6 +3398,7 @@ export declare const tap: {
      * output // => ["Apply a discount to: 100", 95]
      * ```
      *
+     * @stability stable
      * @category sequencing
      * @since 2.0.0
      */
@@ -3363,6 +3451,7 @@ export declare const tap: {
      * output // => ["Apply a discount to: 100", 95]
      * ```
      *
+     * @stability stable
      * @category sequencing
      * @since 2.0.0
      */
@@ -3416,6 +3505,7 @@ export declare 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
  */
@@ -3458,6 +3548,7 @@ export declare const result: <A, E, R>(self: Effect<A, E, R>) => Effect<Result.R
  * @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
  */
@@ -3499,6 +3590,7 @@ export declare const option: <A, E, R>(self: Effect<A, E, R>) => Effect<Option<A
  * @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
  */
@@ -3562,6 +3654,7 @@ export declare const exit: <A, E, R>(self: Effect<A, E, R>) => Effect<Exit.Exit<
  * @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
  */
@@ -3625,6 +3718,7 @@ export declare 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
      */
@@ -3688,6 +3782,7 @@ export declare 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
      */
@@ -3720,6 +3815,7 @@ export declare 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
  */
@@ -3751,6 +3847,7 @@ export declare 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
      */
@@ -3782,6 +3879,7 @@ export declare 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
      */
@@ -3800,6 +3898,7 @@ export declare const as: {
  * Effect.runSync(program) // => Option.some(42)
  * ```
  *
+ * @stability stable
  * @category mapping
  * @since 2.0.0
  */
@@ -3817,6 +3916,7 @@ export declare const asSome: <A, E, R>(self: Effect<A, E, R>) => Effect<Option<A
  * Effect.runSync(program) // => undefined
  * ```
  *
+ * @stability stable
  * @category mapping
  * @since 2.0.0
  */
@@ -3847,6 +3947,7 @@ export declare const asVoid: <A, E, R>(self: Effect<A, E, R>) => Effect<void, E,
  * Effect.runSync(flipped) // => "Oh uh!"
  * ```
  *
+ * @stability stable
  * @category mapping
  * @since 2.0.0
  */
@@ -3902,6 +4003,7 @@ export declare const flip: <A, E, R>(self: Effect<A, E, R>) => Effect<E, A, R>;
  * @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
  */
@@ -3957,6 +4059,7 @@ export declare 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
      */
@@ -4014,6 +4117,7 @@ export declare 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
      */
@@ -4055,6 +4159,7 @@ export declare const zip: {
  * Effect.runSync(task3) // => 6
  * ```
  *
+ * @stability stable
  * @category zipping
  * @since 2.0.0
  */
@@ -4093,6 +4198,7 @@ export declare const zipWith: {
      * Effect.runSync(task3) // => 6
      * ```
      *
+     * @stability stable
      * @category zipping
      * @since 2.0.0
      */
@@ -4133,6 +4239,7 @@ export declare const zipWith: {
      * Effect.runSync(task3) // => 6
      * ```
      *
+     * @stability stable
      * @category zipping
      * @since 2.0.0
      */
@@ -4167,6 +4274,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
  */
@@ -4215,6 +4323,7 @@ catch_ as catch };
  * @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
  */
@@ -4263,6 +4372,7 @@ export declare 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
      */
@@ -4311,6 +4421,7 @@ export declare 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
      */
@@ -4360,6 +4471,7 @@ export declare const catchTag: {
  * Effect.runSync(handled) // => "Network error: 503"
  * ```
  *
+ * @stability stable
  * @category error handling
  * @since 2.0.0
  */
@@ -4408,6 +4520,7 @@ export declare const catchTags: {
      * Effect.runSync(handled) // => "Network error: 503"
      * ```
      *
+     * @stability stable
      * @category error handling
      * @since 2.0.0
      */
@@ -4476,6 +4589,7 @@ export declare const catchTags: {
      * Effect.runSync(handled) // => "Network error: 503"
      * ```
      *
+     * @stability stable
      * @category error handling
      * @since 2.0.0
      */
@@ -4547,6 +4661,7 @@ export declare const catchTags: {
  *
  * @see {@link catchReasons} for handling several nested reason tags
  *
+ * @stability stable
  * @category error handling
  * @since 4.0.0
  */
@@ -4597,6 +4712,7 @@ export declare const catchReason: {
      *
      * @see {@link catchReasons} for handling several nested reason tags
      *
+     * @stability stable
      * @category error handling
      * @since 4.0.0
      */
@@ -4647,6 +4763,7 @@ export declare const catchReason: {
      *
      * @see {@link catchReasons} for handling several nested reason tags
      *
+     * @stability stable
      * @category error handling
      * @since 4.0.0
      */
@@ -4688,6 +4805,7 @@ export declare const catchReason: {
  * Effect.runSync(handled) // => "Quota exceeded: 100"
  * ```
  *
+ * @stability stable
  * @category error handling
  * @since 4.0.0
  */
@@ -4728,6 +4846,7 @@ export declare const catchReasons: {
      * Effect.runSync(handled) // => "Quota exceeded: 100"
      * ```
      *
+     * @stability stable
      * @category error handling
      * @since 4.0.0
      */
@@ -4776,6 +4895,7 @@ export declare const catchReasons: {
      * Effect.runSync(handled) // => "Quota exceeded: 100"
      * ```
      *
+     * @stability stable
      * @category error handling
      * @since 4.0.0
      */
@@ -4806,6 +4926,7 @@ export declare 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
  */
@@ -4843,6 +4964,7 @@ export type TagsWithReason<E> = {
  * Effect.runSync(Effect.flip(unwrapped))._tag // => "RateLimitError"
  * ```
  *
+ * @stability stable
  * @category error handling
  * @since 4.0.0
  */
@@ -4878,6 +5000,7 @@ export declare const unwrapReason: {
      * Effect.runSync(Effect.flip(unwrapped))._tag // => "RateLimitError"
      * ```
      *
+     * @stability stable
      * @category error handling
      * @since 4.0.0
      */
@@ -4913,6 +5036,7 @@ export declare const unwrapReason: {
      * Effect.runSync(Effect.flip(unwrapped))._tag // => "RateLimitError"
      * ```
      *
+     * @stability stable
      * @category error handling
      * @since 4.0.0
      */
@@ -4959,6 +5083,7 @@ export declare const unwrapReason: {
  * output // => ["Caught defect", "Recovered from defect"]
  * ```
  *
+ * @stability stable
  * @category error handling
  * @since 4.0.0
  */
@@ -5004,6 +5129,7 @@ export declare const catchCause: {
      * output // => ["Caught defect", "Recovered from defect"]
      * ```
      *
+     * @stability stable
      * @category error handling
      * @since 4.0.0
      */
@@ -5049,6 +5175,7 @@ export declare const catchCause: {
      * output // => ["Caught defect", "Recovered from defect"]
      * ```
      *
+     * @stability stable
      * @category error handling
      * @since 4.0.0
      */
@@ -5094,6 +5221,7 @@ export declare const catchCause: {
  * output // => ["Caught defect: Unexpected error", "Recovered from defect"]
  * ```
  *
+ * @stability stable
  * @category error handling
  * @since 4.0.0
  */
@@ -5138,6 +5266,7 @@ export declare const catchDefect: {
      * output // => ["Caught defect: Unexpected error", "Recovered from defect"]
      * ```
      *
+     * @stability stable
      * @category error handling
      * @since 4.0.0
      */
@@ -5182,6 +5311,7 @@ export declare const catchDefect: {
      * output // => ["Caught defect: Unexpected error", "Recovered from defect"]
      * ```
      *
+     * @stability stable
      * @category error handling
      * @since 4.0.0
      */
@@ -5228,6 +5358,7 @@ export declare const catchDefect: {
  * Effect.runSync(Effect.all([recovered, recovered2])) // => ['missing:user-1', 'missing:user-1']
  * ```
  *
+ * @stability stable
  * @category error handling
  * @since 2.0.0
  */
@@ -5273,6 +5404,7 @@ export declare const catchIf: {
      * Effect.runSync(Effect.all([recovered, recovered2])) // => ['missing:user-1', 'missing:user-1']
      * ```
      *
+     * @stability stable
      * @category error handling
      * @since 2.0.0
      */
@@ -5318,6 +5450,7 @@ export declare const catchIf: {
      * Effect.runSync(Effect.all([recovered, recovered2])) // => ['missing:user-1', 'missing:user-1']
      * ```
      *
+     * @stability stable
      * @category error handling
      * @since 2.0.0
      */
@@ -5363,6 +5496,7 @@ export declare const catchIf: {
      * Effect.runSync(Effect.all([recovered, recovered2])) // => ['missing:user-1', 'missing:user-1']
      * ```
      *
+     * @stability stable
      * @category error handling
      * @since 2.0.0
      */
@@ -5408,6 +5542,7 @@ export declare const catchIf: {
      * Effect.runSync(Effect.all([recovered, recovered2])) // => ['missing:user-1', 'missing:user-1']
      * ```
      *
+     * @stability stable
      * @category error handling
      * @since 2.0.0
      */
@@ -5434,6 +5569,7 @@ export declare 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
  */
@@ -5459,6 +5595,7 @@ export declare 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
      */
@@ -5484,6 +5621,7 @@ export declare 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
      */
@@ -5520,6 +5658,7 @@ export declare 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
  */
@@ -5564,6 +5703,7 @@ export declare const catchNoSuchElement: <A, E, R>(self: Effect<A, E, R>) => Eff
  * @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
  */
@@ -5608,6 +5748,7 @@ export declare 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
      */
@@ -5652,6 +5793,7 @@ export declare 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
      */
@@ -5676,6 +5818,7 @@ export declare 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
  */
@@ -5699,6 +5842,7 @@ export declare 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
      */
@@ -5722,6 +5866,7 @@ export declare 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
      */
@@ -5763,6 +5908,7 @@ export declare 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
  */
@@ -5803,6 +5949,7 @@ export declare 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
      */
@@ -5843,6 +5990,7 @@ export declare 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
      */
@@ -5886,6 +6034,7 @@ export declare 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
  */
@@ -5928,6 +6077,7 @@ export declare 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
      */
@@ -5973,6 +6123,7 @@ export declare 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
      */
@@ -6009,6 +6160,7 @@ export declare const mapBoth: {
  * Effect.runSyncExit(program) // => Exit.die(new DivideByZeroError())
  * ```
  *
+ * @stability stable
  * @category error handling
  * @since 2.0.0
  */
@@ -6042,6 +6194,7 @@ export declare const orDie: <A, E, R>(self: Effect<A, E, R>) => Effect<A, never,
  * output // => ["expected error: NetworkError", Exit.fail("NetworkError")]
  * ```
  *
+ * @stability stable
  * @category error handling
  * @since 2.0.0
  */
@@ -6075,6 +6228,7 @@ export declare const tapError: {
      * output // => ["expected error: NetworkError", Exit.fail("NetworkError")]
      * ```
      *
+     * @stability stable
      * @category error handling
      * @since 2.0.0
      */
@@ -6108,6 +6262,7 @@ export declare const tapError: {
      * output // => ["expected error: NetworkError", Exit.fail("NetworkError")]
      * ```
      *
+     * @stability stable
      * @category error handling
      * @since 2.0.0
      */
@@ -6147,6 +6302,7 @@ export declare const tapError: {
  * output // => ["expected error: 504", Exit.fail(new NetworkError({ statusCode: 504 }))]
  * ```
  *
+ * @stability stable
  * @category error handling
  * @since 2.0.0
  */
@@ -6185,6 +6341,7 @@ export declare const tapErrorTag: {
      * output // => ["expected error: 504", Exit.fail(new NetworkError({ statusCode: 504 }))]
      * ```
      *
+     * @stability stable
      * @category error handling
      * @since 2.0.0
      */
@@ -6223,6 +6380,7 @@ export declare const tapErrorTag: {
      * output // => ["expected error: 504", Exit.fail(new NetworkError({ statusCode: 504 }))]
      * ```
      *
+     * @stability stable
      * @category error handling
      * @since 2.0.0
      */
@@ -6260,6 +6418,7 @@ export declare const tapErrorTag: {
  * output // => ["Logging cause: Something went wrong", Exit.fail("Something went wrong")]
  * ```
  *
+ * @stability stable
  * @category error handling
  * @since 4.0.0
  */
@@ -6296,6 +6455,7 @@ export declare const tapCause: {
      * output // => ["Logging cause: Something went wrong", Exit.fail("Something went wrong")]
      * ```
      *
+     * @stability stable
      * @category error handling
      * @since 4.0.0
      */
@@ -6332,6 +6492,7 @@ export declare const tapCause: {
      * output // => ["Logging cause: Something went wrong", Exit.fail("Something went wrong")]
      * ```
      *
+     * @stability stable
      * @category error handling
      * @since 4.0.0
      */
@@ -6365,6 +6526,7 @@ export declare const tapCause: {
  * output // => ["Logging failure cause: Network timeout", Exit.fail("Network timeout")]
  * ```
  *
+ * @stability stable
  * @category error handling
  * @since 4.0.0
  */
@@ -6397,6 +6559,7 @@ export declare const tapCauseIf: {
      * output // => ["Logging failure cause: Network timeout", Exit.fail("Network timeout")]
      * ```
      *
+     * @stability stable
      * @category error handling
      * @since 4.0.0
      */
@@ -6429,6 +6592,7 @@ export declare const tapCauseIf: {
      * output // => ["Logging failure cause: Network timeout", Exit.fail("Network timeout")]
      * ```
      *
+     * @stability stable
      * @category error handling
      * @since 4.0.0
      */
@@ -6453,6 +6617,7 @@ export declare 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
  */
@@ -6476,6 +6641,7 @@ export declare 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
      */
@@ -6499,6 +6665,7 @@ export declare 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
      */
@@ -6535,6 +6702,7 @@ export declare const tapCauseFilter: {
  * output // => ["defect: Something went wrong", Exit.die("Something went wrong")]
  * ```
  *
+ * @stability stable
  * @category error handling
  * @since 2.0.0
  */
@@ -6570,6 +6738,7 @@ export declare const tapDefect: {
      * output // => ["defect: Something went wrong", Exit.die("Something went wrong")]
      * ```
      *
+     * @stability stable
      * @category error handling
      * @since 2.0.0
      */
@@ -6605,6 +6774,7 @@ export declare const tapDefect: {
      * output // => ["defect: Something went wrong", Exit.die("Something went wrong")]
      * ```
      *
+     * @stability stable
      * @category error handling
      * @since 2.0.0
      */
@@ -6640,6 +6810,7 @@ export declare const tapDefect: {
  * output // => ["Attempt 1", "Attempt 2", "Attempt 3", "Ready"]
  * ```
  *
+ * @stability stable
  * @category repetition
  * @since 2.0.0
  */
@@ -6647,6 +6818,7 @@ export declare const eventually: <A, E, R>(self: Effect<A, E, R>) => Effect<A, n
 /**
  * Type helpers for retrying effects.
  *
+ * @stability stable
  * @category error handling
  * @since 2.0.0
  */
@@ -6739,6 +6911,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
  */
@@ -6791,6 +6964,7 @@ export declare 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
      */
@@ -6843,6 +7017,7 @@ export declare 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
      */
@@ -6895,6 +7070,7 @@ export declare 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
      */
@@ -6947,6 +7123,7 @@ export declare 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
      */
@@ -6999,6 +7176,7 @@ export declare 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
      */
@@ -7051,6 +7229,7 @@ export declare 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
      */
@@ -7106,6 +7285,7 @@ export declare const retry: {
  * ```
  *
  * @see {@link retry} for a version that does not run a fallback effect.
+ * @stability stable
  * @category error handling
  * @since 2.0.0
  */
@@ -7160,6 +7340,7 @@ export declare const retryOrElse: {
      * ```
      *
      * @see {@link retry} for a version that does not run a fallback effect.
+     * @stability stable
      * @category error handling
      * @since 2.0.0
      */
@@ -7214,6 +7395,7 @@ export declare const retryOrElse: {
      * ```
      *
      * @see {@link retry} for a version that does not run a fallback effect.
+     * @stability stable
      * @category error handling
      * @since 2.0.0
      */
@@ -7244,6 +7426,7 @@ export declare const retryOrElse: {
  * Effect.runSync(program) // => "Caught cause: Something went wrong"
  * ```
  *
+ * @stability stable
  * @category error handling
  * @since 2.0.0
  */
@@ -7287,6 +7470,7 @@ export declare const sandbox: <A, E, R>(self: Effect<A, E, R>) => Effect<A, Caus
  * Effect.runSync(program) // => undefined
  * ```
  *
+ * @stability stable
  * @category error handling
  * @since 2.0.0
  */
@@ -7324,6 +7508,7 @@ export declare const ignore: <Arg extends Effect<any, any, any> | {
  * Effect.runSync(program) // => undefined
  * ```
  *
+ * @stability stable
  * @category error handling
  * @since 4.0.0
  */
@@ -7409,6 +7594,7 @@ export declare const ignoreCause: <Arg extends Effect<any, any, any> | {
  * events // => ["AttemptStart:0", "AttemptFailure:0", "AttemptStart:1", "AttemptSuccess:1"]
  * ```
  *
+ * @stability unstable
  * @category error handling
  * @since 3.16.0
  */
@@ -7485,6 +7671,7 @@ export declare const withExecutionPlan: {
      * events // => ["AttemptStart:0", "AttemptFailure:0", "AttemptStart:1", "AttemptSuccess:1"]
      * ```
      *
+     * @stability unstable
      * @category error handling
      * @since 3.16.0
      */
@@ -7568,6 +7755,7 @@ export declare const withExecutionPlan: {
      * events // => ["AttemptStart:0", "AttemptFailure:0", "AttemptStart:1", "AttemptSuccess:1"]
      * ```
      *
+     * @stability unstable
      * @category error handling
      * @since 3.16.0
      */
@@ -7588,6 +7776,7 @@ export declare 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
  */
@@ -7630,6 +7819,7 @@ export declare const withErrorReporting: <Arg extends Effect<any, any, any> | {
  * Effect.runSyncExit(program) // => Exit.succeed(0)
  * ```
  *
+ * @stability stable
  * @category error handling
  * @since 2.0.0
  */
@@ -7666,6 +7856,7 @@ export declare const orElseSucceed: {
      * Effect.runSyncExit(program) // => Exit.succeed(0)
      * ```
      *
+     * @stability stable
      * @category error handling
      * @since 2.0.0
      */
@@ -7702,6 +7893,7 @@ export declare const orElseSucceed: {
      * Effect.runSyncExit(program) // => Exit.succeed(0)
      * ```
      *
+     * @stability stable
      * @category error handling
      * @since 2.0.0
      */
@@ -7747,6 +7939,7 @@ export declare const orElseSucceed: {
  * Effect.runSync(program) // => "secondary result"
  * ```
  *
+ * @stability stable
  * @category error handling
  * @since 2.0.0
  */
@@ -7785,6 +7978,7 @@ export declare const firstSuccessOf: <Eff extends Effect<any, any, any>>(effects
  * @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
  */
@@ -7823,6 +8017,7 @@ export declare 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
      */
@@ -7861,6 +8056,7 @@ export declare 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
      */
@@ -7893,6 +8089,7 @@ export declare 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
  */
@@ -7924,6 +8121,7 @@ export declare 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
      */
@@ -7955,6 +8153,7 @@ export declare 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
      */
@@ -7984,6 +8183,7 @@ export declare 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
  */
@@ -8012,6 +8212,7 @@ export declare 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
      */
@@ -8043,6 +8244,7 @@ export declare 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
      */
@@ -8067,6 +8269,7 @@ export declare const timeoutOrElse: {
  * output // => ["Delayed message"]
  * ```
  *
+ * @stability stable
  * @category delays & timeouts
  * @since 2.0.0
  */
@@ -8087,6 +8290,7 @@ export declare const delay: {
      * output // => ["Delayed message"]
      * ```
      *
+     * @stability stable
      * @category delays & timeouts
      * @since 2.0.0
      */
@@ -8107,6 +8311,7 @@ export declare const delay: {
      * output // => ["Delayed message"]
      * ```
      *
+     * @stability stable
      * @category delays & timeouts
      * @since 2.0.0
      */
@@ -8132,6 +8337,7 @@ export declare const delay: {
  * output // => ["Start", "End"]
  * ```
  *
+ * @stability stable
  * @category delays & timeouts
  * @since 2.0.0
  */
@@ -8157,6 +8363,7 @@ export declare const sleep: (duration: Duration.Input) => Effect<void>;
  * Effect.runSync(program) // => "ok"
  * ```
  *
+ * @stability stable
  * @category delays & timeouts
  * @since 2.0.0
  */
@@ -8189,6 +8396,7 @@ export declare const timed: <A, E, R>(self: Effect<A, E, R>) => Effect<[duration
  * ```
  *
  * @see {@link race} for a version that handles only two effects.
+ * @stability stable
  * @category racing
  * @since 2.0.0
  */
@@ -8221,6 +8429,7 @@ export declare const raceAll: <Eff extends Effect<any, any, any>>(all: Iterable<
  * await Effect.runPromise(Effect.flip(raced)) // => "First failed"
  * ```
  *
+ * @stability stable
  * @category racing
  * @since 4.0.0
  */
@@ -8257,6 +8466,7 @@ export declare const raceAllFirst: <Eff extends Effect<any, any, any>>(all: Iter
  * output // => ["winner: slow-success"]
  * ```
  *
+ * @stability stable
  * @category racing
  * @since 2.0.0
  */
@@ -8287,6 +8497,7 @@ export declare const race: {
      * output // => ["winner: slow-success"]
      * ```
      *
+     * @stability stable
      * @category racing
      * @since 2.0.0
      */
@@ -8323,6 +8534,7 @@ export declare const race: {
      * output // => ["winner: slow-success"]
      * ```
      *
+     * @stability stable
      * @category racing
      * @since 2.0.0
      */
@@ -8368,6 +8580,7 @@ export declare const race: {
  * output // => ["failed: fast-fail"]
  * ```
  *
+ * @stability stable
  * @category racing
  * @since 2.0.0
  */
@@ -8406,6 +8619,7 @@ export declare const raceFirst: {
      * output // => ["failed: fast-fail"]
      * ```
      *
+     * @stability stable
      * @category racing
      * @since 2.0.0
      */
@@ -8450,6 +8664,7 @@ export declare const raceFirst: {
      * output // => ["failed: fast-fail"]
      * ```
      *
+     * @stability stable
      * @category racing
      * @since 2.0.0
      */
@@ -8482,6 +8697,7 @@ export declare const raceFirst: {
  * output // => [[2, 4], [2, 3]]
  * ```
  *
+ * @stability stable
  * @category collecting
  * @since 2.0.0
  */
@@ -8507,6 +8723,7 @@ export declare const filter: {
      * output // => [[2, 4], [2, 3]]
      * ```
      *
+     * @stability stable
      * @category collecting
      * @since 2.0.0
      */
@@ -8532,6 +8749,7 @@ export declare const filter: {
      * output // => [[2, 4], [2, 3]]
      * ```
      *
+     * @stability stable
      * @category collecting
      * @since 2.0.0
      */
@@ -8557,6 +8775,7 @@ export declare const filter: {
      * output // => [[2, 4], [2, 3]]
      * ```
      *
+     * @stability stable
      * @category collecting
      * @since 2.0.0
      */
@@ -8584,6 +8803,7 @@ export declare const filter: {
      * output // => [[2, 4], [2, 3]]
      * ```
      *
+     * @stability stable
      * @category collecting
      * @since 2.0.0
      */
@@ -8609,6 +8829,7 @@ export declare const filter: {
      * output // => [[2, 4], [2, 3]]
      * ```
      *
+     * @stability stable
      * @category collecting
      * @since 2.0.0
      */
@@ -8634,6 +8855,7 @@ export declare const filter: {
      * output // => [[2, 4], [2, 3]]
      * ```
      *
+     * @stability stable
      * @category collecting
      * @since 2.0.0
      */
@@ -8657,6 +8879,7 @@ export declare 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
  */
@@ -8677,6 +8900,7 @@ export declare 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
      */
@@ -8697,6 +8921,7 @@ export declare 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
      */
@@ -8723,6 +8948,7 @@ export declare 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
  */
@@ -8748,6 +8974,7 @@ export declare 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
      */
@@ -8775,6 +9002,7 @@ export declare 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
      */
@@ -8815,6 +9043,7 @@ export declare const filterMapEffect: {
  * Effect.runSync(filtered) // => "Number 5 is odd"
  * ```
  *
+ * @stability stable
  * @category filtering
  * @since 2.0.0
  */
@@ -8852,6 +9081,7 @@ export declare const filterOrElse: {
      * Effect.runSync(filtered) // => "Number 5 is odd"
      * ```
      *
+     * @stability stable
      * @category filtering
      * @since 2.0.0
      */
@@ -8889,6 +9119,7 @@ export declare const filterOrElse: {
      * Effect.runSync(filtered) // => "Number 5 is odd"
      * ```
      *
+     * @stability stable
      * @category filtering
      * @since 2.0.0
      */
@@ -8926,6 +9157,7 @@ export declare const filterOrElse: {
      * Effect.runSync(filtered) // => "Number 5 is odd"
      * ```
      *
+     * @stability stable
      * @category filtering
      * @since 2.0.0
      */
@@ -8963,6 +9195,7 @@ export declare const filterOrElse: {
      * Effect.runSync(filtered) // => "Number 5 is odd"
      * ```
      *
+     * @stability stable
      * @category filtering
      * @since 2.0.0
      */
@@ -8985,6 +9218,7 @@ export declare 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
  */
@@ -9006,6 +9240,7 @@ export declare 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
      */
@@ -9027,6 +9262,7 @@ export declare 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
      */
@@ -9059,6 +9295,7 @@ export declare const filterMapOrElse: {
  * Effect.runSync(Effect.flip(filtered)) // => "Expected even number, got 5"
  * ```
  *
+ * @stability stable
  * @category filtering
  * @since 2.0.0
  */
@@ -9090,6 +9327,7 @@ export declare const filterOrFail: {
      * Effect.runSync(Effect.flip(filtered)) // => "Expected even number, got 5"
      * ```
      *
+     * @stability stable
      * @category filtering
      * @since 2.0.0
      */
@@ -9121,6 +9359,7 @@ export declare const filterOrFail: {
      * Effect.runSync(Effect.flip(filtered)) // => "Expected even number, got 5"
      * ```
      *
+     * @stability stable
      * @category filtering
      * @since 2.0.0
      */
@@ -9152,6 +9391,7 @@ export declare const filterOrFail: {
      * Effect.runSync(Effect.flip(filtered)) // => "Expected even number, got 5"
      * ```
      *
+     * @stability stable
      * @category filtering
      * @since 2.0.0
      */
@@ -9183,6 +9423,7 @@ export declare const filterOrFail: {
      * Effect.runSync(Effect.flip(filtered)) // => "Expected even number, got 5"
      * ```
      *
+     * @stability stable
      * @category filtering
      * @since 2.0.0
      */
@@ -9214,6 +9455,7 @@ export declare const filterOrFail: {
      * Effect.runSync(Effect.flip(filtered)) // => "Expected even number, got 5"
      * ```
      *
+     * @stability stable
      * @category filtering
      * @since 2.0.0
      */
@@ -9245,6 +9487,7 @@ export declare const filterOrFail: {
      * Effect.runSync(Effect.flip(filtered)) // => "Expected even number, got 5"
      * ```
      *
+     * @stability stable
      * @category filtering
      * @since 2.0.0
      */
@@ -9276,6 +9519,7 @@ export declare const filterOrFail: {
      * Effect.runSync(Effect.flip(filtered)) // => "Expected even number, got 5"
      * ```
      *
+     * @stability stable
      * @category filtering
      * @since 2.0.0
      */
@@ -9307,6 +9551,7 @@ export declare const filterOrFail: {
      * Effect.runSync(Effect.flip(filtered)) // => "Expected even number, got 5"
      * ```
      *
+     * @stability stable
      * @category filtering
      * @since 2.0.0
      */
@@ -9329,6 +9574,7 @@ export declare 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
  */
@@ -9350,6 +9596,7 @@ export declare 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
      */
@@ -9371,6 +9618,7 @@ export declare 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
      */
@@ -9392,6 +9640,7 @@ export declare 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
      */
@@ -9413,6 +9662,7 @@ export declare 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
      */
@@ -9451,6 +9701,7 @@ export declare const filterMapOrFail: {
  * output // => ["Condition is true!", Option.some(undefined)]
  * ```
  *
+ * @stability stable
  * @category filtering
  * @since 2.0.0
  */
@@ -9488,6 +9739,7 @@ export declare const when: {
      * output // => ["Condition is true!", Option.some(undefined)]
      * ```
      *
+     * @stability stable
      * @category filtering
      * @since 2.0.0
      */
@@ -9525,6 +9777,7 @@ export declare const when: {
      * output // => ["Condition is true!", Option.some(undefined)]
      * ```
      *
+     * @stability stable
      * @category filtering
      * @since 2.0.0
      */
@@ -9577,6 +9830,7 @@ export declare const when: {
  * ```
  *
  * @see {@link matchEffect} if you need to perform side effects in the handlers.
+ * @stability stable
  * @category pattern matching
  * @since 2.0.0
  */
@@ -9628,6 +9882,7 @@ export declare const match: {
      * ```
      *
      * @see {@link matchEffect} if you need to perform side effects in the handlers.
+     * @stability stable
      * @category pattern matching
      * @since 2.0.0
      */
@@ -9682,6 +9937,7 @@ export declare const match: {
      * ```
      *
      * @see {@link matchEffect} if you need to perform side effects in the handlers.
+     * @stability stable
      * @category pattern matching
      * @since 2.0.0
      */
@@ -9726,6 +9982,7 @@ export declare 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
  */
@@ -9766,6 +10023,7 @@ export declare 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
      */
@@ -9809,6 +10067,7 @@ export declare 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
      */
@@ -9848,6 +10107,7 @@ export declare 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
  */
@@ -9883,6 +10143,7 @@ export declare 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
      */
@@ -9921,6 +10182,7 @@ export declare 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
      */
@@ -9955,6 +10217,7 @@ export declare const matchCause: {
  * Effect.runSync(handleResult) // => "Success: 42"
  * ```
  *
+ * @stability stable
  * @category pattern matching
  * @since 4.0.0
  */
@@ -9985,6 +10248,7 @@ export declare const matchCauseEager: {
      * Effect.runSync(handleResult) // => "Success: 42"
      * ```
      *
+     * @stability stable
      * @category pattern matching
      * @since 4.0.0
      */
@@ -10018,6 +10282,7 @@ export declare const matchCauseEager: {
      * Effect.runSync(handleResult) // => "Success: 42"
      * ```
      *
+     * @stability stable
      * @category pattern matching
      * @since 4.0.0
      */
@@ -10043,6 +10308,7 @@ export declare 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
  */
@@ -10064,6 +10330,7 @@ export declare 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
      */
@@ -10088,6 +10355,7 @@ export declare 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
      */
@@ -10151,6 +10419,7 @@ export declare 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
  */
@@ -10210,6 +10479,7 @@ export declare 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
      */
@@ -10272,6 +10542,7 @@ export declare 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
      */
@@ -10327,6 +10598,7 @@ export declare 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
  */
@@ -10378,6 +10650,7 @@ export declare 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
      */
@@ -10432,6 +10705,7 @@ export declare 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
      */
@@ -10462,6 +10736,7 @@ export declare const matchEffect: {
  * output // => [true]
  * ```
  *
+ * @stability stable
  * @category predicates
  * @since 2.0.0
  */
@@ -10491,6 +10766,7 @@ export declare const isFailure: <A, E, R>(self: Effect<A, E, R>) => Effect<boole
  * output // => ["ok: true", "failed: false"]
  * ```
  *
+ * @stability stable
  * @category predicates
  * @since 2.0.0
  */
@@ -10543,6 +10819,7 @@ export declare const isSuccess: <A, E, R>(self: Effect<A, E, R>) => Effect<boole
  * @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
  */
@@ -10601,6 +10878,7 @@ export declare const context: <R = never>() => Effect<Context.Context<R>, never,
  * @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
  */
@@ -10635,6 +10913,7 @@ export declare const contextWith: <R, A, E, R2>(f: (context: Context.Context<R>)
  * await Effect.runPromise(provided) // => "Result for: SELECT * FROM users"
  * ```
  *
+ * @stability stable
  * @category providing services
  * @since 2.0.0
  */
@@ -10669,6 +10948,7 @@ export declare const provide: {
      * await Effect.runPromise(provided) // => "Result for: SELECT * FROM users"
      * ```
      *
+     * @stability stable
      * @category providing services
      * @since 2.0.0
      */
@@ -10705,6 +10985,7 @@ export declare const provide: {
      * await Effect.runPromise(provided) // => "Result for: SELECT * FROM users"
      * ```
      *
+     * @stability stable
      * @category providing services
      * @since 2.0.0
      */
@@ -10741,6 +11022,7 @@ export declare const provide: {
      * await Effect.runPromise(provided) // => "Result for: SELECT * FROM users"
      * ```
      *
+     * @stability stable
      * @category providing services
      * @since 2.0.0
      */
@@ -10775,6 +11057,7 @@ export declare const provide: {
      * await Effect.runPromise(provided) // => "Result for: SELECT * FROM users"
      * ```
      *
+     * @stability stable
      * @category providing services
      * @since 2.0.0
      */
@@ -10811,6 +11094,7 @@ export declare const provide: {
      * await Effect.runPromise(provided) // => "Result for: SELECT * FROM users"
      * ```
      *
+     * @stability stable
      * @category providing services
      * @since 2.0.0
      */
@@ -10847,6 +11131,7 @@ export declare const provide: {
      * await Effect.runPromise(provided) // => "Result for: SELECT * FROM users"
      * ```
      *
+     * @stability stable
      * @category providing services
      * @since 2.0.0
      */
@@ -10892,6 +11177,7 @@ export declare const provide: {
  * output // => ["Querying database", "result"]
  * ```
  *
+ * @stability stable
  * @category providing services
  * @since 4.0.0
  */
@@ -10936,6 +11222,7 @@ export declare const provideContext: {
      * output // => ["Querying database", "result"]
      * ```
      *
+     * @stability stable
      * @category providing services
      * @since 4.0.0
      */
@@ -10980,6 +11267,7 @@ export declare const provideContext: {
      * output // => ["Querying database", "result"]
      * ```
      *
+     * @stability stable
      * @category providing services
      * @since 4.0.0
      */
@@ -11023,6 +11311,7 @@ export declare 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
  */
@@ -11065,6 +11354,7 @@ export declare 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
      */
@@ -11107,6 +11397,7 @@ export declare 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
      */
@@ -11137,6 +11428,7 @@ export declare const setContext: {
  * Effect.runSync(runnable) // => "Result for: SELECT * FROM users"
  * ```
  *
+ * @stability stable
  * @category accessors
  * @since 4.0.0
  */
@@ -11182,6 +11474,7 @@ export declare const service: <I, S>(service: Context.Key<I, S>) => Effect<S, ne
  * output // => ["Service not available"]
  * ```
  *
+ * @stability stable
  * @category accessors
  * @since 2.0.0
  */
@@ -11225,6 +11518,7 @@ export declare const serviceOption: <I, S>(key: Context.Key<I, S>) => Effect<Opt
  * Effect.runSync(result) // => "Hello World!"
  * ```
  *
+ * @stability stable
  * @category providing services
  * @since 4.0.0
  */
@@ -11268,6 +11562,7 @@ export declare const updateContext: {
      * Effect.runSync(result) // => "Hello World!"
      * ```
      *
+     * @stability stable
      * @category providing services
      * @since 4.0.0
      */
@@ -11311,6 +11606,7 @@ export declare const updateContext: {
      * Effect.runSync(result) // => "Hello World!"
      * ```
      *
+     * @stability stable
      * @category providing services
      * @since 4.0.0
      */
@@ -11348,6 +11644,7 @@ export declare const updateContext: {
  * output // => ["Updated count: 1", 1]
  * ```
  *
+ * @stability stable
  * @category providing services
  * @since 2.0.0
  */
@@ -11384,6 +11681,7 @@ export declare const updateService: {
      * output // => ["Updated count: 1", 1]
      * ```
      *
+     * @stability stable
      * @category providing services
      * @since 2.0.0
      */
@@ -11420,6 +11718,7 @@ export declare const updateService: {
      * output // => ["Updated count: 1", 1]
      * ```
      *
+     * @stability stable
      * @category providing services
      * @since 2.0.0
      */
@@ -11481,6 +11780,7 @@ export declare const updateService: {
  *
  * @see {@link updateService} for updating a service only within a wrapped effect
  *
+ * @stability stable
  * @category providing services
  * @since 4.0.0
  */
@@ -11531,6 +11831,7 @@ export declare const updateServiceScoped: <I, A>(service: Context.Key<I, A>, f:
  * @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
  */
@@ -11579,6 +11880,7 @@ export declare 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
      */
@@ -11627,6 +11929,7 @@ export declare 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
          */
@@ -11675,6 +11978,7 @@ export declare 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
          */
@@ -11724,6 +12028,7 @@ export declare 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
      */
@@ -11772,6 +12077,7 @@ export declare 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
      */
@@ -11829,6 +12135,7 @@ export declare const provideService: {
  * output // => ["Establishing database connection...", "Database connected!", "Result for: SELECT * FROM users"]
  * ```
  *
+ * @stability stable
  * @category providing services
  * @since 2.0.0
  */
@@ -11885,6 +12192,7 @@ export declare const provideServiceEffect: {
      * output // => ["Establishing database connection...", "Database connected!", "Result for: SELECT * FROM users"]
      * ```
      *
+     * @stability stable
      * @category providing services
      * @since 2.0.0
      */
@@ -11941,6 +12249,7 @@ export declare const provideServiceEffect: {
      * output // => ["Establishing database connection...", "Database connected!", "Result for: SELECT * FROM users"]
      * ```
      *
+     * @stability stable
      * @category providing services
      * @since 2.0.0
      */
@@ -11972,6 +12281,7 @@ export declare const provideServiceEffect: {
  * output // => ["Got scope for resource management", "Acquiring resource", "Releasing resource", "resource"]
  * ```
  *
+ * @stability stable
  * @category resource management
  * @since 2.0.0
  */
@@ -12011,6 +12321,7 @@ export declare const scope: Effect<Scope, never, Scope>;
  * output // => ["Acquiring resource", "Using resource", "Releasing resource"]
  * ```
  *
+ * @stability stable
  * @category resource management
  * @since 2.0.0
  */
@@ -12052,6 +12363,7 @@ export declare const scoped: <A, E, R>(self: Effect<A, E, R>) => Effect<A, E, Ex
  * output // => ["Inside scoped context", "Acquiring resource", "Releasing resource", "Manual finalizer", "resource"]
  * ```
  *
+ * @stability stable
  * @category resource management
  * @since 3.11.0
  */
@@ -12118,6 +12430,7 @@ export declare const scopedWith: <A, E, R>(f: (scope: Scope) => Effect<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
  */
@@ -12169,6 +12482,7 @@ export declare const acquireRelease: <A, E, R, R2>(acquire: Effect<A, E, R>, rel
  *
  * @see {@link acquireRelease} for resources that need an explicit finalizer
  *
+ * @stability stable
  * @category resource management
  * @since 4.0.0
  */
@@ -12244,6 +12558,7 @@ export declare const acquireDisposable: <A extends AsyncDisposable | Disposable,
  *
  * @see {@link acquireRelease} for scoped resources whose use happens later
  *
+ * @stability stable
  * @category resource management
  * @since 2.0.0
  */
@@ -12291,6 +12606,7 @@ export declare const acquireUseRelease: <Resource, E, R, A, E2, R2, E3, R3>(acqu
  * @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
  */
@@ -12330,6 +12646,7 @@ export declare const addFinalizer: <R>(finalizer: (exit: Exit.Exit<unknown, unkn
  * output // => ["Task started", "Task completed", "Cleanup: This always runs!", 42]
  * ```
  *
+ * @stability stable
  * @category resource management
  * @since 2.0.0
  */
@@ -12369,6 +12686,7 @@ export declare const ensuring: {
      * output // => ["Task started", "Task completed", "Cleanup: This always runs!", 42]
      * ```
      *
+     * @stability stable
      * @category resource management
      * @since 2.0.0
      */
@@ -12408,6 +12726,7 @@ export declare const ensuring: {
      * output // => ["Task started", "Task completed", "Cleanup: This always runs!", 42]
      * ```
      *
+     * @stability stable
      * @category resource management
      * @since 2.0.0
      */
@@ -12437,6 +12756,7 @@ export declare const ensuring: {
  * output // => ["Cleanup on error: TaskError: Something went wrong", Exit.fail(error)]
  * ```
  *
+ * @stability stable
  * @category resource management
  * @since 2.0.0
  */
@@ -12465,6 +12785,7 @@ export declare const onError: {
      * output // => ["Cleanup on error: TaskError: Something went wrong", Exit.fail(error)]
      * ```
      *
+     * @stability stable
      * @category resource management
      * @since 2.0.0
      */
@@ -12493,6 +12814,7 @@ export declare const onError: {
      * output // => ["Cleanup on error: TaskError: Something went wrong", Exit.fail(error)]
      * ```
      *
+     * @stability stable
      * @category resource management
      * @since 2.0.0
      */
@@ -12523,6 +12845,7 @@ export declare const onError: {
  * output // => ["Cause: boom", Exit.fail("boom")]
  * ```
  *
+ * @stability stable
  * @category resource management
  * @since 4.0.0
  */
@@ -12552,6 +12875,7 @@ export declare const onErrorIf: {
      * output // => ["Cause: boom", Exit.fail("boom")]
      * ```
      *
+     * @stability stable
      * @category resource management
      * @since 4.0.0
      */
@@ -12581,6 +12905,7 @@ export declare const onErrorIf: {
      * output // => ["Cause: boom", Exit.fail("boom")]
      * ```
      *
+     * @stability stable
      * @category resource management
      * @since 4.0.0
      */
@@ -12599,6 +12924,7 @@ export declare 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
  */
@@ -12616,6 +12942,7 @@ export declare 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
      */
@@ -12633,6 +12960,7 @@ export declare 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
      */
@@ -12656,6 +12984,7 @@ export declare 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
  */
@@ -12687,6 +13016,7 @@ export declare const onExitPrimitive: <A, E, R, XE = never, XR = never>(self: Ef
  * output // => ["Task succeeded with: 42", 42]
  * ```
  *
+ * @stability stable
  * @category resource management
  * @since 2.0.0
  */
@@ -12718,6 +13048,7 @@ export declare const onExit: {
      * output // => ["Task succeeded with: 42", 42]
      * ```
      *
+     * @stability stable
      * @category resource management
      * @since 2.0.0
      */
@@ -12749,6 +13080,7 @@ export declare const onExit: {
      * output // => ["Task succeeded with: 42", 42]
      * ```
      *
+     * @stability stable
      * @category resource management
      * @since 2.0.0
      */
@@ -12777,6 +13109,7 @@ export declare const onExit: {
  * output // => ["Succeeded with: 42", 42]
  * ```
  *
+ * @stability stable
  * @category resource management
  * @since 4.0.0
  */
@@ -12804,6 +13137,7 @@ export declare const onExitIf: {
      * output // => ["Succeeded with: 42", 42]
      * ```
      *
+     * @stability stable
      * @category resource management
      * @since 4.0.0
      */
@@ -12831,6 +13165,7 @@ export declare const onExitIf: {
      * output // => ["Succeeded with: 42", 42]
      * ```
      *
+     * @stability stable
      * @category resource management
      * @since 4.0.0
      */
@@ -12854,6 +13189,7 @@ export declare 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
  */
@@ -12876,6 +13212,7 @@ export declare 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
      */
@@ -12898,6 +13235,7 @@ export declare 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
      */
@@ -12919,6 +13257,11 @@ export declare 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
@@ -12950,6 +13293,7 @@ export declare 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
  */
@@ -12979,11 +13323,12 @@ export declare const cached: <A, E, R>(self: Effect<A, E, R>) => Effect<Effect<A
  * `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)
@@ -13034,6 +13379,7 @@ export declare const cached: <A, E, R>(self: Effect<A, E, R>) => Effect<Effect<A
  * 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
  */
@@ -13063,11 +13409,12 @@ export declare 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)
@@ -13118,6 +13465,7 @@ export declare 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
      */
@@ -13147,11 +13495,12 @@ export declare 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)
@@ -13202,6 +13551,7 @@ export declare 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
      */
@@ -13231,11 +13581,12 @@ export declare 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)
@@ -13286,6 +13637,7 @@ export declare 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
      */
@@ -13315,11 +13667,12 @@ export declare 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)
@@ -13370,14 +13723,15 @@ export declare 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
      */
     <A, E, R>(self: Effect<A, E, R>, timeToLive: Duration.Input | ((exit: Exit.Exit<A, E>) => Duration.Input)): Effect<Effect<A, E, R>>;
 };
 /**
- * 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**
  *
@@ -13430,13 +13784,74 @@ export declare 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 declare 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**
+     *
+     * 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>(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**
      *
@@ -13489,13 +13904,74 @@ export declare 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
      */
     (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**
+     *
+     * 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>(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**
      *
@@ -13548,10 +14024,11 @@ export declare 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, R>(self: Effect<A, E, R>, timeToLive: Duration.Input | ((exit: Exit.Exit<A, E>) => Duration.Input)): Effect<[Effect<A, E, R>, Effect<void>]>;
 };
 /**
  * Returns an effect that is immediately interrupted.
@@ -13569,6 +14046,7 @@ export declare const cachedInvalidateWithTTL: {
  * Effect.runSyncExit(program)._tag // => "Failure"
  * ```
  *
+ * @stability stable
  * @category interruption
  * @since 2.0.0
  */
@@ -13587,6 +14065,7 @@ export declare const interrupt: Effect<never>;
  * await Effect.runPromise(program) // => Option.none()
  * ```
  *
+ * @stability stable
  * @category interruption
  * @since 2.0.0
  */
@@ -13612,6 +14091,7 @@ export declare const interruptible: <A, E, R>(self: Effect<A, E, R>) => Effect<A
  * output // => ["Task was interrupted, cleaning up..."]
  * ```
  *
+ * @stability stable
  * @category interruption
  * @since 2.0.0
  */
@@ -13637,6 +14117,7 @@ export declare const onInterrupt: {
      * output // => ["Task was interrupted, cleaning up..."]
      * ```
      *
+     * @stability stable
      * @category interruption
      * @since 2.0.0
      */
@@ -13662,6 +14143,7 @@ export declare const onInterrupt: {
      * output // => ["Task was interrupted, cleaning up..."]
      * ```
      *
+     * @stability stable
      * @category interruption
      * @since 2.0.0
      */
@@ -13687,6 +14169,7 @@ export declare const onInterrupt: {
  * output // => ["Starting critical section...", "Critical section completed"]
  * ```
  *
+ * @stability stable
  * @category interruption
  * @since 2.0.0
  */
@@ -13719,6 +14202,7 @@ export declare const uninterruptible: <A, E, R>(self: Effect<A, E, R>) => Effect
  * output // => ["Uninterruptible phase...", "Interruptible phase...", "Back to uninterruptible"]
  * ```
  *
+ * @stability stable
  * @category interruption
  * @since 2.0.0
  */
@@ -13751,6 +14235,7 @@ export declare const uninterruptibleMask: <A, E, R>(f: (restore: <AX, EX, RX>(ef
  * output // => ["Interruptible phase...", "Uninterruptible phase...", "Back to interruptible"]
  * ```
  *
+ * @stability stable
  * @category interruption
  * @since 2.0.0
  */
@@ -13776,6 +14261,7 @@ export declare const interruptibleMask: <A, E, R>(f: (restore: <AX, EX, RX>(effe
  *
  * @see {@link scoped} for binding resource lifetime to a scope
  *
+ * @stability stable
  * @category interruption
  * @since 4.0.0
  */
@@ -13783,6 +14269,7 @@ export declare const abortSignal: Effect<AbortSignal, never, Scope>;
 /**
  * Type helpers for repeating effects.
  *
+ * @stability stable
  * @category repetition
  * @since 2.0.0
  */
@@ -13835,6 +14322,7 @@ export declare namespace Repeat {
  * await Effect.runPromise(program) // => Option.none()
  * ```
  *
+ * @stability stable
  * @category repetition
  * @since 2.0.0
  */
@@ -13922,6 +14410,7 @@ export declare const forever: <Arg extends Effect<any, any, any> | {
  * @see {@link retry} for failure-based repetition
  * @see {@link repeatOrElse} for fallback handling when repetition fails
  *
+ * @stability stable
  * @category repetition
  * @since 2.0.0
  */
@@ -14003,6 +14492,7 @@ export declare 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
      */
@@ -14084,6 +14574,7 @@ export declare 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
      */
@@ -14165,6 +14656,7 @@ export declare 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
      */
@@ -14246,6 +14738,7 @@ export declare 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
      */
@@ -14327,6 +14820,7 @@ export declare 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
      */
@@ -14408,6 +14902,7 @@ export declare 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
      */
@@ -14461,6 +14956,7 @@ export declare const repeat: {
  * output // => ["Attempt 1 failed", "Final failure: Error 1, after 0 attempts", 0]
  * ```
  *
+ * @stability stable
  * @category repetition
  * @since 2.0.0
  */
@@ -14513,6 +15009,7 @@ export declare const repeatOrElse: {
      * output // => ["Attempt 1 failed", "Final failure: Error 1, after 0 attempts", 0]
      * ```
      *
+     * @stability stable
      * @category repetition
      * @since 2.0.0
      */
@@ -14565,6 +15062,7 @@ export declare const repeatOrElse: {
      * output // => ["Attempt 1 failed", "Final failure: Error 1, after 0 attempts", 0]
      * ```
      *
+     * @stability stable
      * @category repetition
      * @since 2.0.0
      */
@@ -14585,6 +15083,7 @@ export declare 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
  */
@@ -14604,6 +15103,7 @@ export declare 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
      */
@@ -14623,6 +15123,7 @@ export declare 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
      */
@@ -14655,6 +15156,7 @@ export declare const replicate: {
  * output // => [[1, 1, 1]]
  * ```
  *
+ * @stability stable
  * @category repetition
  * @since 2.0.0
  */
@@ -14686,6 +15188,7 @@ export declare const replicateEffect: {
      * output // => [[1, 1, 1]]
      * ```
      *
+     * @stability stable
      * @category repetition
      * @since 2.0.0
      */
@@ -14720,6 +15223,7 @@ export declare const replicateEffect: {
      * output // => [[1, 1, 1]]
      * ```
      *
+     * @stability stable
      * @category repetition
      * @since 2.0.0
      */
@@ -14754,6 +15258,7 @@ export declare const replicateEffect: {
      * output // => [[1, 1, 1]]
      * ```
      *
+     * @stability stable
      * @category repetition
      * @since 2.0.0
      */
@@ -14788,6 +15293,7 @@ export declare const replicateEffect: {
      * output // => [[1, 1, 1]]
      * ```
      *
+     * @stability stable
      * @category repetition
      * @since 2.0.0
      */
@@ -14833,6 +15339,7 @@ export declare 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
  */
@@ -14874,6 +15381,7 @@ export declare 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
      */
@@ -14915,6 +15423,7 @@ export declare 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
      */
@@ -14955,6 +15464,7 @@ export declare const schedule: {
  * output // => ["Processing: 0", "Processing: 0", 2]
  * ```
  *
+ * @stability stable
  * @category repetition
  * @since 2.0.0
  */
@@ -14994,6 +15504,7 @@ export declare const scheduleFrom: {
      * output // => ["Processing: 0", "Processing: 0", 2]
      * ```
      *
+     * @stability stable
      * @category repetition
      * @since 2.0.0
      */
@@ -15033,6 +15544,7 @@ export declare const scheduleFrom: {
      * output // => ["Processing: 0", "Processing: 0", 2]
      * ```
      *
+     * @stability stable
      * @category repetition
      * @since 2.0.0
      */
@@ -15054,6 +15566,7 @@ export declare const scheduleFrom: {
  * Effect.runSync(program) // => "function"
  * ```
  *
+ * @stability stable
  * @category tracing
  * @since 2.0.0
  */
@@ -15074,6 +15587,7 @@ export declare const tracer: Effect<Tracer>;
  * Effect.runSync(program) // => "completed"
  * ```
  *
+ * @stability stable
  * @category tracing
  * @since 2.0.0
  */
@@ -15094,6 +15608,7 @@ export declare const withTracer: {
      * Effect.runSync(program) // => "completed"
      * ```
      *
+     * @stability stable
      * @category tracing
      * @since 2.0.0
      */
@@ -15114,6 +15629,7 @@ export declare const withTracer: {
      * Effect.runSync(program) // => "completed"
      * ```
      *
+     * @stability stable
      * @category tracing
      * @since 2.0.0
      */
@@ -15140,6 +15656,7 @@ export declare const withTracer: {
  * Effect.runSync(program) // => 42
  * ```
  *
+ * @stability stable
  * @category tracing
  * @since 2.0.0
  */
@@ -15165,6 +15682,7 @@ export declare const withTracerEnabled: {
      * Effect.runSync(program) // => 42
      * ```
      *
+     * @stability stable
      * @category tracing
      * @since 2.0.0
      */
@@ -15190,6 +15708,7 @@ export declare const withTracerEnabled: {
      * Effect.runSync(program) // => 42
      * ```
      *
+     * @stability stable
      * @category tracing
      * @since 2.0.0
      */
@@ -15211,6 +15730,7 @@ export declare const withTracerEnabled: {
  * Effect.runSync(program) // => 42
  * ```
  *
+ * @stability stable
  * @category tracing
  * @since 2.0.0
  */
@@ -15231,6 +15751,7 @@ export declare const withTracerTiming: {
      * Effect.runSync(program) // => 42
      * ```
      *
+     * @stability stable
      * @category tracing
      * @since 2.0.0
      */
@@ -15251,6 +15772,7 @@ export declare const withTracerTiming: {
      * Effect.runSync(program) // => 42
      * ```
      *
+     * @stability stable
      * @category tracing
      * @since 2.0.0
      */
@@ -15279,6 +15801,7 @@ export declare const withTracerTiming: {
  * Effect.runSync(Effect.all([annotated1, annotated2])) // => ['result', 'result']
  * ```
  *
+ * @stability stable
  * @category tracing
  * @since 2.0.0
  */
@@ -15306,6 +15829,7 @@ export declare const annotateSpans: {
      * Effect.runSync(Effect.all([annotated1, annotated2])) // => ['result', 'result']
      * ```
      *
+     * @stability stable
      * @category tracing
      * @since 2.0.0
      */
@@ -15333,6 +15857,7 @@ export declare const annotateSpans: {
      * Effect.runSync(Effect.all([annotated1, annotated2])) // => ['result', 'result']
      * ```
      *
+     * @stability stable
      * @category tracing
      * @since 2.0.0
      */
@@ -15360,6 +15885,7 @@ export declare const annotateSpans: {
      * Effect.runSync(Effect.all([annotated1, annotated2])) // => ['result', 'result']
      * ```
      *
+     * @stability stable
      * @category tracing
      * @since 2.0.0
      */
@@ -15387,6 +15913,7 @@ export declare const annotateSpans: {
      * Effect.runSync(Effect.all([annotated1, annotated2])) // => ['result', 'result']
      * ```
      *
+     * @stability stable
      * @category tracing
      * @since 2.0.0
      */
@@ -15412,6 +15939,7 @@ export declare const annotateSpans: {
  * Effect.runSync(traced) // => "success"
  * ```
  *
+ * @stability stable
  * @category tracing
  * @since 2.0.0
  */
@@ -15436,6 +15964,7 @@ export declare const annotateCurrentSpan: {
      * Effect.runSync(traced) // => "success"
      * ```
      *
+     * @stability stable
      * @category tracing
      * @since 2.0.0
      */
@@ -15460,6 +15989,7 @@ export declare const annotateCurrentSpan: {
      * Effect.runSync(traced) // => "success"
      * ```
      *
+     * @stability stable
      * @category tracing
      * @since 2.0.0
      */
@@ -15487,6 +16017,7 @@ export declare const annotateCurrentSpan: {
  * Effect.runSync(traced) // => "my-span"
  * ```
  *
+ * @stability stable
  * @category tracing
  * @since 2.0.0
  */
@@ -15516,6 +16047,7 @@ export declare const currentSpan: Effect<Span, Cause.NoSuchElementError>;
  * Effect.runSync(traced) // => "Span"
  * ```
  *
+ * @stability stable
  * @category tracing
  * @since 2.0.0
  */
@@ -15541,6 +16073,7 @@ export declare const currentParentSpan: Effect<AnySpan, Cause.NoSuchElementError
  * Effect.runSync(program) // => { userId: '123', operation: 'data-processing' }
  * ```
  *
+ * @stability stable
  * @category tracing
  * @since 2.0.0
  */
@@ -15567,6 +16100,7 @@ export declare const spanAnnotations: Effect<Readonly<Record<string, unknown>>>;
  * Effect.runSync(program).length // => 0
  * ```
  *
+ * @stability stable
  * @category tracing
  * @since 2.0.0
  */
@@ -15615,6 +16149,7 @@ export declare const spanLinks: Effect<ReadonlyArray<SpanLink>>;
  * Effect.runSync(program).length // => 2
  * ```
  *
+ * @stability stable
  * @category tracing
  * @since 2.0.0
  */
@@ -15663,6 +16198,7 @@ export declare const linkSpans: {
      * Effect.runSync(program).length // => 2
      * ```
      *
+     * @stability stable
      * @category tracing
      * @since 2.0.0
      */
@@ -15711,6 +16247,7 @@ export declare const linkSpans: {
      * Effect.runSync(program).length // => 2
      * ```
      *
+     * @stability stable
      * @category tracing
      * @since 2.0.0
      */
@@ -15738,6 +16275,7 @@ export declare const linkSpans: {
  * Effect.runSync(program) // => "my-operation"
  * ```
  *
+ * @stability stable
  * @category tracing
  * @since 2.0.0
  */
@@ -15767,6 +16305,7 @@ export declare const makeSpan: (name: string, options?: SpanOptionsNoTrace) => E
  * Effect.runSync(program) // => "scoped-operation"
  * ```
  *
+ * @stability stable
  * @category tracing
  * @since 2.0.0
  */
@@ -15792,6 +16331,7 @@ export declare const makeSpanScoped: (name: string, options?: SpanOptionsNoTrace
  * Effect.runSync(program) // => "user-operation: success"
  * ```
  *
+ * @stability stable
  * @category tracing
  * @since 2.0.0
  */
@@ -15817,6 +16357,7 @@ export declare const useSpan: {
      * Effect.runSync(program) // => "user-operation: success"
      * ```
      *
+     * @stability stable
      * @category tracing
      * @since 2.0.0
      */
@@ -15842,6 +16383,7 @@ export declare const useSpan: {
      * Effect.runSync(program) // => "user-operation: success"
      * ```
      *
+     * @stability stable
      * @category tracing
      * @since 2.0.0
      */
@@ -15863,6 +16405,7 @@ export declare const useSpan: {
  * Effect.runSync(traced) // => "result"
  * ```
  *
+ * @stability stable
  * @category tracing
  * @since 2.0.0
  */
@@ -15883,6 +16426,7 @@ export declare const withSpan: {
      * Effect.runSync(traced) // => "result"
      * ```
      *
+     * @stability stable
      * @category tracing
      * @since 2.0.0
      */
@@ -15903,6 +16447,7 @@ export declare const withSpan: {
      * Effect.runSync(traced) // => "result"
      * ```
      *
+     * @stability stable
      * @category tracing
      * @since 2.0.0
      */
@@ -15930,6 +16475,7 @@ export declare const withSpan: {
  * Effect.runSync(program) // => "completed"
  * ```
  *
+ * @stability stable
  * @category tracing
  * @since 2.0.0
  */
@@ -15956,6 +16502,7 @@ export declare const withSpanScoped: {
      * Effect.runSync(program) // => "completed"
      * ```
      *
+     * @stability stable
      * @category tracing
      * @since 2.0.0
      */
@@ -15982,6 +16529,7 @@ export declare const withSpanScoped: {
      * Effect.runSync(program) // => "completed"
      * ```
      *
+     * @stability stable
      * @category tracing
      * @since 2.0.0
      */
@@ -16004,6 +16552,7 @@ export declare const withSpanScoped: {
  * Effect.runSync(program) // => "completed"
  * ```
  *
+ * @stability stable
  * @category tracing
  * @since 2.0.0
  */
@@ -16025,6 +16574,7 @@ export declare const withParentSpan: {
      * Effect.runSync(program) // => "completed"
      * ```
      *
+     * @stability stable
      * @category tracing
      * @since 2.0.0
      */
@@ -16046,6 +16596,7 @@ export declare const withParentSpan: {
      * Effect.runSync(program) // => "completed"
      * ```
      *
+     * @stability stable
      * @category tracing
      * @since 2.0.0
      */
@@ -16089,6 +16640,7 @@ export declare 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
  */
@@ -16131,6 +16683,7 @@ export declare 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
      */
@@ -16173,6 +16726,7 @@ export declare 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
      */
@@ -16192,6 +16746,7 @@ export declare const request: {
  *
  * @see {@link request} for the `Effect`-returning API used for normal request execution
  *
+ * @stability stable
  * @category unsafe
  * @since 4.0.0
  */
@@ -16239,6 +16794,7 @@ export declare const requestUnsafe: <A extends Request.Any>(self: A, options: {
  * await Effect.runPromise(program) // => "result"
  * ```
  *
+ * @stability stable
  * @category forking
  * @since 4.0.0
  */
@@ -16275,6 +16831,7 @@ export declare const forkChild: <Arg extends Effect<any, any, any> | {
  * await Effect.runPromise(program) // => "done"
  * ```
  *
+ * @stability stable
  * @category forking
  * @since 2.0.0
  */
@@ -16302,6 +16859,7 @@ export declare const forkIn: {
      * await Effect.runPromise(program) // => "done"
      * ```
      *
+     * @stability stable
      * @category forking
      * @since 2.0.0
      */
@@ -16332,6 +16890,7 @@ export declare const forkIn: {
      * await Effect.runPromise(program) // => "done"
      * ```
      *
+     * @stability stable
      * @category forking
      * @since 2.0.0
      */
@@ -16362,6 +16921,7 @@ export declare const forkIn: {
  * await Effect.runPromise(program) // => "scope completed"
  * ```
  *
+ * @stability stable
  * @category forking
  * @since 2.0.0
  */
@@ -16395,6 +16955,7 @@ export declare const forkScoped: <Arg extends Effect<any, any, any> | {
  * await Effect.runPromise(program) // => "daemon result"
  * ```
  *
+ * @stability stable
  * @category forking
  * @since 4.0.0
  */
@@ -16431,6 +16992,7 @@ export declare const forkDetach: <Arg extends Effect<any, any, any> | {
  * @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
  */
@@ -16453,6 +17015,7 @@ export declare const awaitAllChildren: <A, E, R>(self: Effect<A, E, R>) => Effec
  * output // => ["number"]
  * ```
  *
+ * @stability stable
  * @category accessors
  * @since 4.0.0
  */
@@ -16469,6 +17032,7 @@ export declare const fiber: Effect<Fiber<unknown, unknown>>;
  * Effect.runSync(program) // => "number"
  * ```
  *
+ * @stability stable
  * @category accessors
  * @since 2.0.0
  */
@@ -16493,6 +17057,7 @@ export declare const fiberId: Effect<number>;
  * @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
  */
@@ -16528,6 +17093,7 @@ export interface RunOptions {
  * output // => ["running...", "done"]
  * ```
  *
+ * @stability stable
  * @category running
  * @since 2.0.0
  */
@@ -16567,6 +17133,7 @@ export declare const runFork: <A, E>(effect: Effect<A, E, never>, options?: RunO
  * output // => ["Hello from service!", "done"]
  * ```
  *
+ * @stability stable
  * @category running
  * @since 4.0.0
  */
@@ -16616,6 +17183,7 @@ export declare const runForkWith: <R>(context: Context.Context<R>) => <A, E>(eff
  * output // => ["Started", "Success"]
  * ```
  *
+ * @stability stable
  * @category running
  * @since 4.0.0
  */
@@ -16659,6 +17227,7 @@ export declare const runCallbackWith: <R>(context: Context.Context<R>) => <A, E>
  * output // => ["working", "success: done"]
  * ```
  *
+ * @stability stable
  * @category running
  * @since 2.0.0
  */
@@ -16699,6 +17268,7 @@ export declare const runCallback: <A, E>(effect: Effect<A, E, never>, options?:
  * ```
  *
  * @see {@link runPromiseExit} for a version that returns an `Exit` type instead of rejecting.
+ * @stability stable
  * @category running
  * @since 2.0.0
  */
@@ -16734,6 +17304,7 @@ export declare const runPromise: <A, E>(effect: Effect<A, E>, options?: RunOptio
  * await Effect.runPromiseWith(context)(program) // => "Connecting to https://api.example.com"
  * ```
  *
+ * @stability stable
  * @category running
  * @since 4.0.0
  */
@@ -16767,6 +17338,7 @@ export declare const runPromiseWith: <R>(context: Context.Context<R>) => <A, E>(
  *
  * @see {@link runPromise} for a version that rejects on failure.
  *
+ * @stability stable
  * @category running
  * @since 2.0.0
  */
@@ -16807,6 +17379,7 @@ export declare const runPromiseExit: <A, E>(effect: Effect<A, E>, options?: RunO
  * output // => ["Success: Result for: SELECT * FROM users"]
  * ```
  *
+ * @stability stable
  * @category running
  * @since 4.0.0
  */
@@ -16864,6 +17437,7 @@ export declare const runPromiseExitWith: <R>(context: Context.Context<R>) => <A,
  *
  * @see {@link runSyncExit} for a version that returns an `Exit` type instead of
  * throwing an error.
+ * @stability stable
  * @category running
  * @since 2.0.0
  */
@@ -16900,6 +17474,7 @@ export declare const runSync: <A, E>(effect: Effect<A, E>) => A;
  * result // => 5
  * ```
  *
+ * @stability stable
  * @category running
  * @since 4.0.0
  */
@@ -16948,6 +17523,7 @@ export declare const runSyncWith: <R>(context: Context.Context<R>) => <A, E>(eff
  *
  * @see {@link runSync} for a version that throws on failure.
  *
+ * @stability stable
  * @category running
  * @since 2.0.0
  */
@@ -16992,6 +17568,7 @@ export declare const runSyncExit: <A, E>(effect: Effect<A, E>) => Exit.Exit<A, E
  * output // => ["[LOG] Computing result...", "Success: 42"]
  * ```
  *
+ * @stability stable
  * @category running
  * @since 4.0.0
  */
@@ -17003,6 +17580,7 @@ export declare const runSyncExitWith: <R>(context: Context.Context<R>) => <A, E>
  *
  * Use these to describe generator-based signatures and traced or untraced variants.
  *
+ * @stability stable
  * @category constructors
  * @since 3.11.0
  */
@@ -17728,6 +18306,7 @@ export declare namespace fn {
  * Effect.runSync(program) // => "hello"
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 3.12.0
  */
@@ -17851,6 +18430,7 @@ export declare const fnUntraced: fn.Untraced;
  * Effect.runSync(program) // => "hello"
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 3.11.0
  */
@@ -17875,6 +18455,7 @@ export declare const fn: fn.Traced & {
  * Effect.runSync(program) // => "Clock is available"
  * ```
  *
+ * @stability stable
  * @category accessors
  * @since 2.0.0
  */
@@ -17909,6 +18490,7 @@ export declare const clockWith: <A, E, R>(f: (clock: Clock) => Effect<A, E, R>)
  * output // => ["Warn: Cache miss"]
  * ```
  *
+ * @stability stable
  * @category logging
  * @since 2.0.0
  */
@@ -17936,6 +18518,7 @@ export declare const logWithLevel: (level?: Severity) => (...message: ReadonlyAr
  * output // => ["Info: Result: 4", 4]
  * ```
  *
+ * @stability stable
  * @category logging
  * @since 2.0.0
  */
@@ -17961,6 +18544,7 @@ export declare const log: (...message: ReadonlyArray<any>) => Effect<void>;
  * output // => ["Fatal: Critical system failure"]
  * ```
  *
+ * @stability stable
  * @category logging
  * @since 2.0.0
  */
@@ -17985,6 +18569,7 @@ export declare const logFatal: (...message: ReadonlyArray<any>) => Effect<void>;
  * output // => ["Warn: API rate limit approaching"]
  * ```
  *
+ * @stability stable
  * @category logging
  * @since 2.0.0
  */
@@ -18009,6 +18594,7 @@ export declare const logWarning: (...message: ReadonlyArray<any>) => Effect<void
  * output // => ["Error: Database connection failed"]
  * ```
  *
+ * @stability stable
  * @category logging
  * @since 2.0.0
  */
@@ -18033,6 +18619,7 @@ export declare const logError: (...message: ReadonlyArray<any>) => Effect<void>;
  * output // => ["Info: Application starting up"]
  * ```
  *
+ * @stability stable
  * @category logging
  * @since 2.0.0
  */
@@ -18061,6 +18648,7 @@ export declare const logInfo: (...message: ReadonlyArray<any>) => Effect<void>;
  * output // => ["Debug: Debug mode enabled"]
  * ```
  *
+ * @stability stable
  * @category logging
  * @since 2.0.0
  */
@@ -18089,6 +18677,7 @@ export declare const logDebug: (...message: ReadonlyArray<any>) => Effect<void>;
  * output // => ["Trace: Entering function processData"]
  * ```
  *
+ * @stability stable
  * @category logging
  * @since 2.0.0
  */
@@ -18119,6 +18708,7 @@ export declare const logTrace: (...message: ReadonlyArray<any>) => Effect<void>;
  * output // => ["[CUSTOM]: This will go to both default and custom logger"]
  * ```
  *
+ * @stability stable
  * @category logging
  * @since 4.0.0
  */
@@ -18149,6 +18739,7 @@ export declare const withLogger: {
      * output // => ["[CUSTOM]: This will go to both default and custom logger"]
      * ```
      *
+     * @stability stable
      * @category logging
      * @since 4.0.0
      */
@@ -18179,6 +18770,7 @@ export declare const withLogger: {
      * output // => ["[CUSTOM]: This will go to both default and custom logger"]
      * ```
      *
+     * @stability stable
      * @category logging
      * @since 4.0.0
      */
@@ -18216,6 +18808,7 @@ export declare const withLogger: {
  * output // => ["Starting operation", "Starting operation"]
  * ```
  *
+ * @stability stable
  * @category logging
  * @since 2.0.0
  */
@@ -18252,6 +18845,7 @@ export declare const annotateLogs: {
      * output // => ["Starting operation", "Starting operation"]
      * ```
      *
+     * @stability stable
      * @category logging
      * @since 2.0.0
      */
@@ -18288,6 +18882,7 @@ export declare const annotateLogs: {
      * output // => ["Starting operation", "Starting operation"]
      * ```
      *
+     * @stability stable
      * @category logging
      * @since 2.0.0
      */
@@ -18324,6 +18919,7 @@ export declare const annotateLogs: {
      * output // => ["Starting operation", "Starting operation"]
      * ```
      *
+     * @stability stable
      * @category logging
      * @since 2.0.0
      */
@@ -18360,6 +18956,7 @@ export declare const annotateLogs: {
      * output // => ["Starting operation", "Starting operation"]
      * ```
      *
+     * @stability stable
      * @category logging
      * @since 2.0.0
      */
@@ -18401,6 +18998,7 @@ export declare const annotateLogs: {
  *
  * @see {@link annotateLogs} for annotating one effect
  *
+ * @stability stable
  * @category logging
  * @since 3.1.0
  */
@@ -18441,6 +19039,7 @@ export declare const annotateLogsScoped: {
      *
      * @see {@link annotateLogs} for annotating one effect
      *
+     * @stability stable
      * @category logging
      * @since 3.1.0
      */
@@ -18481,6 +19080,7 @@ export declare const annotateLogsScoped: {
      *
      * @see {@link annotateLogs} for annotating one effect
      *
+     * @stability stable
      * @category logging
      * @since 3.1.0
      */
@@ -18518,6 +19118,7 @@ export declare const annotateLogsScoped: {
  * output // => ["Making HTTP request", "Connecting to database", "Executing query", "Processing results", "Sending response", "data"]
  * ```
  *
+ * @stability stable
  * @category logging
  * @since 2.0.0
  */
@@ -18554,6 +19155,7 @@ export declare const withLogSpan: {
      * output // => ["Making HTTP request", "Connecting to database", "Executing query", "Processing results", "Sending response", "data"]
      * ```
      *
+     * @stability stable
      * @category logging
      * @since 2.0.0
      */
@@ -18590,6 +19192,7 @@ export declare const withLogSpan: {
      * output // => ["Making HTTP request", "Connecting to database", "Executing query", "Processing results", "Sending response", "data"]
      * ```
      *
+     * @stability stable
      * @category logging
      * @since 2.0.0
      */
@@ -18638,6 +19241,7 @@ export declare const withLogSpan: {
  * Effect.runSync(Metric.value(exitTracker)).occurrences.get("success") // => 1
  * ```
  *
+ * @stability stable
  * @category metrics
  * @since 4.0.0
  */
@@ -18685,6 +19289,7 @@ export declare const track: {
      * Effect.runSync(Metric.value(exitTracker)).occurrences.get("success") // => 1
      * ```
      *
+     * @stability stable
      * @category metrics
      * @since 4.0.0
      */
@@ -18732,6 +19337,7 @@ export declare const track: {
      * Effect.runSync(Metric.value(exitTracker)).occurrences.get("success") // => 1
      * ```
      *
+     * @stability stable
      * @category metrics
      * @since 4.0.0
      */
@@ -18779,6 +19385,7 @@ export declare const track: {
      * Effect.runSync(Metric.value(exitTracker)).occurrences.get("success") // => 1
      * ```
      *
+     * @stability stable
      * @category metrics
      * @since 4.0.0
      */
@@ -18826,6 +19433,7 @@ export declare const track: {
      * Effect.runSync(Metric.value(exitTracker)).occurrences.get("success") // => 1
      * ```
      *
+     * @stability stable
      * @category metrics
      * @since 4.0.0
      */
@@ -18873,6 +19481,7 @@ export declare const track: {
  * Effect.runSync(Metric.value(requestSizeGauge)).value // => 12
  * ```
  *
+ * @stability stable
  * @category metrics
  * @since 4.0.0
  */
@@ -18919,6 +19528,7 @@ export declare const trackSuccesses: {
      * Effect.runSync(Metric.value(requestSizeGauge)).value // => 12
      * ```
      *
+     * @stability stable
      * @category metrics
      * @since 4.0.0
      */
@@ -18965,6 +19575,7 @@ export declare const trackSuccesses: {
      * Effect.runSync(Metric.value(requestSizeGauge)).value // => 12
      * ```
      *
+     * @stability stable
      * @category metrics
      * @since 4.0.0
      */
@@ -19011,6 +19622,7 @@ export declare const trackSuccesses: {
      * Effect.runSync(Metric.value(requestSizeGauge)).value // => 12
      * ```
      *
+     * @stability stable
      * @category metrics
      * @since 4.0.0
      */
@@ -19057,6 +19669,7 @@ export declare const trackSuccesses: {
      * Effect.runSync(Metric.value(requestSizeGauge)).value // => 12
      * ```
      *
+     * @stability stable
      * @category metrics
      * @since 4.0.0
      */
@@ -19106,6 +19719,7 @@ export declare const trackSuccesses: {
  * Effect.runSync(Metric.value(errorTypeFrequency)).occurrences.get("ConnectionFailedError") // => 1
  * ```
  *
+ * @stability stable
  * @category metrics
  * @since 4.0.0
  */
@@ -19154,6 +19768,7 @@ export declare const trackErrors: {
      * Effect.runSync(Metric.value(errorTypeFrequency)).occurrences.get("ConnectionFailedError") // => 1
      * ```
      *
+     * @stability stable
      * @category metrics
      * @since 4.0.0
      */
@@ -19202,6 +19817,7 @@ export declare const trackErrors: {
      * Effect.runSync(Metric.value(errorTypeFrequency)).occurrences.get("ConnectionFailedError") // => 1
      * ```
      *
+     * @stability stable
      * @category metrics
      * @since 4.0.0
      */
@@ -19250,6 +19866,7 @@ export declare const trackErrors: {
      * Effect.runSync(Metric.value(errorTypeFrequency)).occurrences.get("ConnectionFailedError") // => 1
      * ```
      *
+     * @stability stable
      * @category metrics
      * @since 4.0.0
      */
@@ -19298,6 +19915,7 @@ export declare const trackErrors: {
      * Effect.runSync(Metric.value(errorTypeFrequency)).occurrences.get("ConnectionFailedError") // => 1
      * ```
      *
+     * @stability stable
      * @category metrics
      * @since 4.0.0
      */
@@ -19348,6 +19966,7 @@ export declare const trackErrors: {
  * Effect.runSync(Metric.value(defectTypeFrequency)).occurrences.get("Error") // => 1
  * ```
  *
+ * @stability stable
  * @category metrics
  * @since 4.0.0
  */
@@ -19397,6 +20016,7 @@ export declare const trackDefects: {
      * Effect.runSync(Metric.value(defectTypeFrequency)).occurrences.get("Error") // => 1
      * ```
      *
+     * @stability stable
      * @category metrics
      * @since 4.0.0
      */
@@ -19446,6 +20066,7 @@ export declare const trackDefects: {
      * Effect.runSync(Metric.value(defectTypeFrequency)).occurrences.get("Error") // => 1
      * ```
      *
+     * @stability stable
      * @category metrics
      * @since 4.0.0
      */
@@ -19495,6 +20116,7 @@ export declare const trackDefects: {
      * Effect.runSync(Metric.value(defectTypeFrequency)).occurrences.get("Error") // => 1
      * ```
      *
+     * @stability stable
      * @category metrics
      * @since 4.0.0
      */
@@ -19544,6 +20166,7 @@ export declare const trackDefects: {
      * Effect.runSync(Metric.value(defectTypeFrequency)).occurrences.get("Error") // => 1
      * ```
      *
+     * @stability stable
      * @category metrics
      * @since 4.0.0
      */
@@ -19590,6 +20213,7 @@ export declare const trackDefects: {
  * Effect.runSync(Metric.value(durationGauge)).value // => 1
  * ```
  *
+ * @stability stable
  * @category metrics
  * @since 4.0.0
  */
@@ -19635,6 +20259,7 @@ export declare const trackDuration: {
      * Effect.runSync(Metric.value(durationGauge)).value // => 1
      * ```
      *
+     * @stability stable
      * @category metrics
      * @since 4.0.0
      */
@@ -19680,6 +20305,7 @@ export declare const trackDuration: {
      * Effect.runSync(Metric.value(durationGauge)).value // => 1
      * ```
      *
+     * @stability stable
      * @category metrics
      * @since 4.0.0
      */
@@ -19725,6 +20351,7 @@ export declare const trackDuration: {
      * Effect.runSync(Metric.value(durationGauge)).value // => 1
      * ```
      *
+     * @stability stable
      * @category metrics
      * @since 4.0.0
      */
@@ -19770,6 +20397,7 @@ export declare const trackDuration: {
      * Effect.runSync(Metric.value(durationGauge)).value // => 1
      * ```
      *
+     * @stability stable
      * @category metrics
      * @since 4.0.0
      */
@@ -19810,6 +20438,7 @@ declare const Transaction_base: Context.ServiceClass<Transaction, "effect/Effect
  * Effect.runSync(runnable) // => "Transaction complete"
  * ```
  *
+ * @stability stable
  * @category transactions
  * @since 4.0.0
  */
@@ -19858,6 +20487,7 @@ export declare class Transaction extends Transaction_base {
  * output // => ["Transaction sum: 30", "Final ref1: 10", "Final ref2: 20"]
  * ```
  *
+ * @stability stable
  * @category transactions
  * @since 4.0.0
  */
@@ -19895,6 +20525,7 @@ export declare const tx: <A, E, R>(effect: Effect<A, E, R>) => Effect<A, E, Excl
  * await Effect.runPromise(program) // => 1
  * ```
  *
+ * @stability stable
  * @category transactions
  * @since 4.0.0
  */
@@ -19902,6 +20533,7 @@ export declare const txRetry: Effect<never, never, Transaction>;
 /**
  * Type helpers for converting callback-based functions into `Effect` functions.
  *
+ * @stability stable
  * @category converting
  * @since 4.0.0
  */
@@ -20171,6 +20803,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
  */
@@ -20224,6 +20857,7 @@ export declare const effectify: {
      * error.message // => "Failed to process hello: unavailable"
      * ```
      *
+     * @stability stable
      * @category converting
      * @since 4.0.0
      */
@@ -20277,6 +20911,7 @@ export declare const effectify: {
      * error.message // => "Failed to process hello: unavailable"
      * ```
      *
+     * @stability stable
      * @category converting
      * @since 4.0.0
      */
@@ -20330,6 +20965,7 @@ export declare const effectify: {
      * error.message // => "Failed to process hello: unavailable"
      * ```
      *
+     * @stability stable
      * @category converting
      * @since 4.0.0
      */
@@ -20361,6 +20997,7 @@ export declare const effectify: {
  * // Type 'string' is not assignable to type 'number'
  * ```
  *
+ * @stability stable
  * @category utility types
  * @since 4.0.0
  */
@@ -20393,6 +21030,7 @@ export declare const satisfiesSuccessType: <A>() => <A2 extends A, E, R>(effect:
  * // Type 'string' is not assignable to type 'ValidationError'
  * ```
  *
+ * @stability stable
  * @category utility types
  * @since 4.0.0
  */
@@ -20422,6 +21060,7 @@ export declare const satisfiesErrorType: <E>() => <A, E2 extends E, R>(effect: E
  * // const constrainedInvalid = satisfiesStringServices(invalidEffect)
  * ```
  *
+ * @stability stable
  * @category utility types
  * @since 4.0.0
  */
@@ -20455,6 +21094,7 @@ export declare const satisfiesServicesType: <R>() => <A, E, R2 extends R>(effect
  * await Effect.runPromise(Effect.all([mapped, mappedPending])) // => [10, 10]
  * ```
  *
+ * @stability stable
  * @category mapping
  * @since 4.0.0
  */
@@ -20488,6 +21128,7 @@ export declare const mapEager: {
      * await Effect.runPromise(Effect.all([mapped, mappedPending])) // => [10, 10]
      * ```
      *
+     * @stability stable
      * @category mapping
      * @since 4.0.0
      */
@@ -20521,6 +21162,7 @@ export declare const mapEager: {
      * await Effect.runPromise(Effect.all([mapped, mappedPending])) // => [10, 10]
      * ```
      *
+     * @stability stable
      * @category mapping
      * @since 4.0.0
      */
@@ -20565,6 +21207,7 @@ export declare const mapEager: {
  * output // => [['mapped: original error', 'mapped: error']]
  * ```
  *
+ * @stability stable
  * @category error handling
  * @since 4.0.0
  */
@@ -20608,6 +21251,7 @@ export declare const mapErrorEager: {
      * output // => [['mapped: original error', 'mapped: error']]
      * ```
      *
+     * @stability stable
      * @category error handling
      * @since 4.0.0
      */
@@ -20651,6 +21295,7 @@ export declare const mapErrorEager: {
      * output // => [['mapped: original error', 'mapped: error']]
      * ```
      *
+     * @stability stable
      * @category error handling
      * @since 4.0.0
      */
@@ -20694,6 +21339,7 @@ export declare const mapErrorEager: {
  * output // => [10, "Failed: error"]
  * ```
  *
+ * @stability stable
  * @category mapping
  * @since 4.0.0
  */
@@ -20736,6 +21382,7 @@ export declare const mapBothEager: {
      * output // => [10, "Failed: error"]
      * ```
      *
+     * @stability stable
      * @category mapping
      * @since 4.0.0
      */
@@ -20781,6 +21428,7 @@ export declare const mapBothEager: {
      * output // => [10, "Failed: error"]
      * ```
      *
+     * @stability stable
      * @category mapping
      * @since 4.0.0
      */
@@ -20822,6 +21470,7 @@ export declare const mapBothEager: {
  * await Effect.runPromise(Effect.all([flatMapped, flatMappedPending])) // => [10, 10]
  * ```
  *
+ * @stability stable
  * @category sequencing
  * @since 4.0.0
  */
@@ -20859,6 +21508,7 @@ export declare const flatMapEager: {
      * await Effect.runPromise(Effect.all([flatMapped, flatMappedPending])) // => [10, 10]
      * ```
      *
+     * @stability stable
      * @category sequencing
      * @since 4.0.0
      */
@@ -20896,6 +21546,7 @@ export declare const flatMapEager: {
      * await Effect.runPromise(Effect.all([flatMapped, flatMappedPending])) // => [10, 10]
      * ```
      *
+     * @stability stable
      * @category sequencing
      * @since 4.0.0
      */
@@ -20950,6 +21601,7 @@ export declare const flatMapEager: {
  * output // => [['recovered from: original error', 42, 'recovered from: error']]
  * ```
  *
+ * @stability stable
  * @category error handling
  * @since 4.0.0
  */
@@ -21003,6 +21655,7 @@ export declare const catchEager: {
      * output // => [['recovered from: original error', 42, 'recovered from: error']]
      * ```
      *
+     * @stability stable
      * @category error handling
      * @since 4.0.0
      */
@@ -21056,6 +21709,7 @@ export declare const catchEager: {
      * output // => [['recovered from: original error', 42, 'recovered from: error']]
      * ```
      *
+     * @stability stable
      * @category error handling
      * @since 4.0.0
      */
@@ -21084,6 +21738,7 @@ export declare const catchEager: {
  * Effect.runSync(effect) // => "computed eagerly"
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */