effect-browser 0.3.0-beta.13 → 0.3.0-beta.15

package/dist/Stage.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"Stage.mjs","names":[],"sources":["../src/Stage.ts"],"sourcesContent":["/**\n * An output's capture ownership. Cue a page while preparing an event; commit when that event\n * happens. A prepared cue belongs to its caller's scope, and a committed one to the stage.\n * Commits serialize, drain old-page input and refuse stale first frames. `shown` distinguishes\n * confirmed silence, uncertain silence and loss without treating capture silence as evidence.\n * @since 0.3.0\n */\nimport {\n  Cause,\n  Clock,\n  Deferred,\n  Duration,\n  Effect,\n  Exit,\n  Fiber,\n  Option,\n  PubSub,\n  Result,\n  Schedule,\n  Schema,\n  Scope,\n  Stream,\n} from \"effect\";\n\nimport { type BrowserError, Closed, consequence, InvalidRequest, Timeout } from \"./BrowserError.ts\";\nimport type { CaptureStats, Frame, ScreencastOptions } from \"./Frame.ts\";\nimport { failWith, undispatched } from \"./internal/page/context.ts\";\nimport { internalsOf } from \"./internal/page/page.ts\";\nimport type { Page } from \"./Page.ts\";\n\nexport interface Options extends ScreencastOptions {\n  /** Bound for each first-frame wait. Defaults to 5 seconds. */\n  readonly firstFrame?: Duration.Input | undefined;\n}\n\n/** A switch that took effect, on the clock shared by browser events and frames. */\nexport class Presented extends Schema.Class<Presented>(\"effect-browser/Presented\")({\n  page: Schema.String,\n  at: Schema.Finite,\n  latency: Schema.Finite,\n}) {}\n\nexport interface Cue {\n  readonly page: Page;\n  /** A frame of the current document, or the capture's failure or first-frame timeout. */\n  readonly ready: Effect.Effect<void, BrowserError>;\n  /** Commit on the event's host time, or now. Interruption before switching leaves the cue usable. */\n  readonly commit: (options?: {\n    readonly at?: number | undefined;\n  }) => Effect.Effect<Presented, BrowserError>;\n}\n\n/** What the output establishes about its last image; loss ends this page's evidence. */\nexport type Shown =\n  | { readonly _tag: \"Painted\"; readonly frame: Frame }\n  | { readonly _tag: \"Still\"; readonly frame: Frame; readonly at: number }\n  | { readonly _tag: \"Stalled\"; readonly frame: Frame; readonly at: number }\n  | { readonly _tag: \"Gone\"; readonly page: string; readonly at: number };\n\nexport interface Stage {\n  readonly present: (\n    page: Page,\n    options?: { readonly at?: number | undefined },\n  ) => Effect.Effect<Presented, BrowserError>;\n  readonly cue: (page: Page) => Effect.Effect<Cue, BrowserError, Scope.Scope>;\n  /** Paint and, after every finite positive hold without paint, current evidence or loss. */\n  readonly shown: (options: { readonly hold: Duration.Input }) => Stream.Stream<Shown>;\n  /** Current-page paint; a reader more than 16 frames behind loses the oldest. */\n  readonly frames: Stream.Stream<Frame>;\n  readonly current: Effect.Effect<Option.Option<Page>>;\n  readonly stats: (options?: {\n    readonly window?: Duration.Input | undefined;\n  }) => Effect.Effect<Option.Option<CaptureStats>, BrowserError>;\n}\n\ntype FeedState =\n  | { readonly _tag: \"Warming\" }\n  | { readonly _tag: \"Ready\"; readonly latest: Frame | undefined }\n  | { readonly _tag: \"Stopped\" };\ninterface Feed {\n  readonly page: Page;\n  readonly scope: Scope.Closeable;\n  readonly changed: PubSub.PubSub<Frame>;\n  state: FeedState;\n  fiber: Fiber.Fiber<void, BrowserError> | undefined;\n}\ninterface Paint {\n  readonly feed: Feed;\n  readonly frame: Frame;\n}\n\nconst closed = () => undispatched(\"cue\", new Closed({ cause: \"released\" }));\n\n/** The sole writer of a cue's capture lifecycle; presentation ownership belongs to the stage. */\nconst update = (\n  feed: Feed,\n  input: { readonly _tag: \"Paint\"; readonly frame: Frame } | { readonly _tag: \"Reset\" | \"Stop\" },\n) => {\n  if (feed.state._tag === \"Stopped\") return;\n  if (input._tag === \"Stop\") feed.state = { _tag: \"Stopped\" };\n  else if (input._tag === \"Paint\") feed.state = { _tag: \"Ready\", latest: input.frame };\n  else if (feed.state._tag === \"Ready\") feed.state = { _tag: \"Ready\", latest: undefined };\n};\n\nconst restartable = (error: BrowserError) => {\n  const { lost, repeat } = consequence(error);\n\n  return lost === \"nothing\" && repeat !== \"pointless\";\n};\n\nconst stop = (feed: Feed) =>\n  Effect.suspend(() => {\n    update(feed, { _tag: \"Stop\" });\n\n    return Scope.close(feed.scope, Exit.void);\n  });\n\nconst frameOf = (feed: Feed) => {\n  const frame = feed.state._tag === \"Ready\" ? feed.state.latest : undefined;\n  const internals = internalsOf(feed.page);\n\n  return frame !== undefined && (internals === undefined || internals.current(frame))\n    ? frame\n    : undefined;\n};\n\nconst ended = (feed: Feed): Effect.Effect<never, BrowserError> =>\n  feed.fiber === undefined\n    ? Effect.never\n    : Fiber.await(feed.fiber).pipe(\n        Effect.flatMap((exit) =>\n          Exit.isFailure(exit) && !Cause.hasInterruptsOnly(exit.cause)\n            ? Effect.failCause(exit.cause)\n            : Effect.fail(closed()),\n        ),\n      );\n\nconst firstOf = (feed: Feed, wait: Duration.Duration) =>\n  Effect.suspend(() => {\n    if (feed.state._tag === \"Stopped\") return Effect.fail(closed());\n    if (feed.page.playwright.isClosed()) return failWith(\"cue\", new Closed({ cause: \"page\" }));\n    if (frameOf(feed) !== undefined) return Effect.void;\n\n    return Effect.raceFirst(\n      Stream.fromPubSub(feed.changed).pipe(\n        Stream.filter(() => frameOf(feed) !== undefined),\n        Stream.runHead,\n        Effect.asVoid,\n      ),\n      ended(feed),\n    ).pipe(\n      Effect.timeoutOrElse({\n        duration: wait,\n        orElse: () => failWith(\"cue\", new Timeout({ millis: Duration.toMillis(wait) })),\n      }),\n    );\n  });\n\n// A timer can wake a fraction early; a commit never precedes its event.\nconst until = (at: number, now: () => number): Effect.Effect<void> =>\n  Effect.suspend(() =>\n    at > now()\n      ? Effect.sleep(Duration.millis(Math.ceil(at - now()))).pipe(Effect.andThen(until(at, now)))\n      : Effect.void,\n  );\n\n/** Reserve the next turn before waking it; a fresh caller cannot overtake a queued commit. */\nconst ordered = () => {\n  const waiting: Array<Deferred.Deferred<void>> = [];\n\n  return <A, E, R>(effect: Effect.Effect<A, E, R>) =>\n    Effect.acquireUseRelease(\n      Effect.sync(() => {\n        const turn = Deferred.makeUnsafe<void>();\n\n        waiting.push(turn);\n        if (waiting.length === 1) Deferred.doneUnsafe(turn, Exit.void);\n\n        return turn;\n      }),\n      (turn) => Deferred.await(turn).pipe(Effect.andThen(effect)),\n      (turn) =>\n        Effect.sync(() => {\n          const at = waiting.indexOf(turn);\n\n          waiting.splice(at, 1);\n          if (at === 0 && waiting[0] !== undefined) Deferred.doneUnsafe(waiting[0], Exit.void);\n        }),\n    );\n};\n\n/** A terminal capture can know the connection is gone before the page receives its close event. */\nconst confirm = (feed: Feed, frame: Frame) => {\n  const exit = feed.fiber?.pollUnsafe();\n\n  const failure =\n    exit !== undefined && Exit.isFailure(exit) ? Cause.findErrorOption(exit.cause) : Option.none();\n\n  if (Option.isSome(failure) && consequence(failure.value).lost !== \"nothing\")\n    return Effect.fail(failure.value);\n\n  return feed.page.playwright.isClosed()\n    ? failWith(\"shown\", new Closed({ cause: \"page\" }))\n    : (internalsOf(feed.page)?.confirm(frame) ?? Effect.succeed(false));\n};\n\n/** Each subscriber confirms silence; a new frame or commit invalidates a probe. */\nconst evidence = (\n  output: PubSub.PubSub<Paint>,\n  current: () =>\n    | { readonly feed: Feed; readonly frame: Frame; readonly changedAt: number }\n    | undefined,\n  now: () => number,\n  hold: Duration.Input,\n): Stream.Stream<Shown> =>\n  Stream.unwrap(\n    Effect.sync(() => {\n      const parsed = Duration.fromInput(hold);\n\n      if (\n        Option.isNone(parsed) ||\n        !Duration.isFinite(parsed.value) ||\n        !Duration.isPositive(parsed.value)\n      )\n        throw new RangeError(\"shown hold must be a finite positive duration\");\n      const millis = Duration.toMillis(parsed.value);\n      let checkedAt = now();\n      let gone: Feed | undefined;\n\n      const probe = Effect.gen(function* () {\n        yield* until(Math.max(checkedAt, current()?.changedAt ?? checkedAt) + millis, now);\n        checkedAt = now();\n        const before = current();\n        const frame = before?.frame;\n\n        if (\n          before === undefined ||\n          frame === undefined ||\n          gone === before.feed ||\n          checkedAt - before.changedAt < millis\n        )\n          return Option.none<Shown>();\n        const { feed } = before;\n\n        const confirmed = yield* Effect.result(confirm(feed, frame));\n\n        if (current()?.feed !== feed || current()?.frame !== frame) return Option.none<Shown>();\n        const at = now();\n\n        checkedAt = at;\n        if (Result.isFailure(confirmed) && consequence(confirmed.failure).lost !== \"nothing\") {\n          gone = feed;\n\n          return Option.some<Shown>({ _tag: \"Gone\", page: feed.page.id, at });\n        }\n\n        return Option.some<Shown>({\n          _tag: Result.isSuccess(confirmed) && confirmed.success ? \"Still\" : \"Stalled\",\n          frame,\n          at,\n        });\n      });\n\n      return Stream.merge(\n        Stream.fromPubSub(output).pipe(\n          Stream.filter(({ feed }) => gone !== feed),\n          Stream.map(({ frame }): Shown => ({ _tag: \"Painted\", frame })),\n        ),\n        Stream.fromEffectRepeat(probe).pipe(\n          Stream.filter(Option.isSome),\n          Stream.map(({ value }) => value),\n        ),\n      );\n    }),\n  );\n\nconst openFeed = (\n  page: Page,\n  owner: Scope.Scope,\n  clock: Clock.Clock,\n  settings: ScreencastOptions,\n  current: () => Feed | undefined,\n  publish: (feed: Feed, frame: Frame) => Effect.Effect<unknown>,\n) =>\n  Effect.gen(function* () {\n    const scope = yield* Scope.fork(owner);\n    const started = yield* Deferred.make<void>();\n\n    const feed: Feed = {\n      page,\n      scope,\n      changed: yield* PubSub.sliding<Frame>({ capacity: 1, replay: 1 }),\n      state: { _tag: \"Warming\" },\n      fiber: undefined,\n    };\n\n    yield* Scope.addFinalizer(\n      scope,\n      Effect.sync(() => {\n        update(feed, { _tag: \"Stop\" });\n      }),\n    );\n    yield* Effect.addFinalizer(() => (current() === feed ? Effect.void : stop(feed)));\n\n    const accept = (frame: Frame) =>\n      Effect.suspend(() => {\n        update(feed, { _tag: \"Paint\", frame });\n\n        return (current() === feed ? publish(feed, frame) : Effect.void).pipe(\n          Effect.andThen(PubSub.publish(feed.changed, frame)),\n        );\n      });\n\n    const capture = Effect.scoped(\n      Effect.gen(function* () {\n        update(feed, { _tag: \"Reset\" });\n\n        const internals = internalsOf(page);\n\n        const { stream, current: frame } = yield* (\n          internals?.capture(settings) ??\n            Effect.succeed({ stream: page.screencast(settings), current: undefined })\n        );\n\n        if (frame !== undefined && internals?.current(frame)) yield* accept(frame);\n        yield* Deferred.succeed(started, undefined);\n        yield* Stream.runForEach(stream, accept);\n      }),\n    ).pipe(\n      Effect.ensuring(Effect.sync(() => update(feed, { _tag: \"Reset\" }))),\n      Effect.retry({\n        while: (error) => feed.state._tag === \"Ready\" && restartable(error),\n        schedule: Schedule.spaced(\"500 millis\"),\n      }),\n    );\n\n    feed.fiber = yield* capture.pipe(\n      Effect.provideService(Clock.Clock, clock),\n      Effect.forkIn(scope),\n    );\n    yield* Effect.raceFirst(Deferred.await(started), ended(feed)).pipe(\n      Effect.onError(() => stop(feed)),\n    );\n\n    return feed;\n  });\n\nexport const make = Effect.fn(\"Stage.make\")(function* (\n  options: Options = {},\n): Effect.fn.Return<Stage, BrowserError, Scope.Scope> {\n  const clock = yield* Clock.Clock;\n  const owner = yield* Effect.scope;\n  const now = () => Number(clock.monotonicTimeNanosUnsafe()) / 1e6;\n  const waited = Duration.fromInput(options.firstFrame ?? Duration.seconds(5));\n\n  if (\n    Option.isNone(waited) ||\n    !Duration.isFinite(waited.value) ||\n    !Duration.isPositive(waited.value)\n  )\n    return yield* failWith(\n      \"stage\",\n      new InvalidRequest({ detail: \"firstFrame must be a finite positive duration\" }),\n    );\n  const firstFrame = waited.value;\n  const settings = { quality: options.quality, size: options.size };\n  const output = yield* PubSub.sliding<Paint>(16);\n  const switching = ordered();\n\n  let showing:\n    | { readonly feed: Feed; readonly presented: Presented; frame: Frame; changedAt: number }\n    | undefined;\n\n  let painted = Number.NEGATIVE_INFINITY;\n\n  yield* Effect.addFinalizer(() => PubSub.shutdown(output));\n\n  const publish = (feed: Feed, frame: Frame) =>\n    Effect.suspend(() => {\n      painted = Math.max(painted, frame.hostTime);\n      if (showing !== undefined) {\n        showing.changedAt = now();\n        showing.frame = frame;\n      }\n\n      return PubSub.publish(output, { feed, frame });\n    });\n\n  const commit = (feed: Feed, options: { readonly at?: number | undefined } = {}) =>\n    Effect.suspend(() => {\n      const asked = options.at ?? now();\n\n      return switching(\n        Effect.gen(function* () {\n          if (!Number.isFinite(asked))\n            return yield* failWith(\n              \"cue\",\n              new InvalidRequest({ detail: \"at must be finite host milliseconds\" }),\n            );\n          yield* firstOf(feed, firstFrame);\n          const old = showing;\n\n          if (old?.feed === feed) return old.presented;\n\n          yield* Effect.raceFirst(until(asked, now), ended(feed));\n\n          const switchTo = Effect.suspend(() => {\n            const frame = frameOf(feed);\n\n            if (frame === undefined) return Effect.fail(closed());\n            const at = Math.max(now(), asked, frame.hostTime, painted);\n\n            showing = {\n              feed,\n              frame,\n              presented: new Presented({ page: feed.page.id, at, latency: at - asked }),\n              changedAt: at,\n            };\n\n            return publish(feed, frame).pipe(Effect.as(showing.presented));\n          }).pipe(Effect.uninterruptible);\n\n          const readyToSwitch = firstOf(feed, firstFrame).pipe(\n            Effect.andThen(switchTo),\n            Effect.provideService(Clock.Clock, clock),\n          );\n\n          const before = old === undefined ? undefined : internalsOf(old.feed.page);\n\n          return yield* (\n            before === undefined ? readyToSwitch : before.afterInput(readyToSwitch)\n          ).pipe(\n            // The cut owns old-page input through publication. Capture cleanup has its own bound\n            // and must finish even if the caller leaves, without turning a completed cut into Timeout.\n            Effect.ensuring(\n              Effect.suspend(() =>\n                showing?.feed === feed && old !== undefined ? stop(old.feed) : Effect.void,\n              ),\n            ),\n          );\n        }).pipe(Effect.provideService(Clock.Clock, clock)),\n      );\n    });\n\n  const cue: Stage[\"cue\"] = (page) =>\n    Effect.map(\n      openFeed(page, owner, clock, settings, () => showing?.feed, publish),\n      (feed) => ({\n        page,\n        ready: firstOf(feed, firstFrame).pipe(Effect.provideService(Clock.Clock, clock)),\n        commit: (options) => commit(feed, options),\n      }),\n    );\n\n  return {\n    cue,\n    present: (page, options) =>\n      Effect.suspend(() => {\n        const asked = options?.at ?? now();\n\n        return showing?.feed.page === page\n          ? Effect.as(firstOf(showing.feed, firstFrame), showing.presented)\n          : Effect.scoped(Effect.flatMap(cue(page), (prepared) => prepared.commit({ at: asked })));\n      }),\n    shown: ({ hold }) =>\n      evidence(output, () => showing, now, hold).pipe(Stream.provideService(Clock.Clock, clock)),\n    frames: Stream.fromPubSub(output).pipe(Stream.map(({ frame }) => frame)),\n    current: Effect.sync(() => Option.fromNullishOr(showing?.feed.page)),\n    stats: (options = {}) =>\n      showing === undefined\n        ? Effect.succeedNone\n        : Effect.asSome(showing.feed.page.captureStats({ window: options.window ?? \"1 second\" })),\n  } satisfies Stage;\n});\n"],"mappings":"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"}
+{"version":3,"file":"Stage.mjs","names":[],"sources":["../src/Stage.ts"],"sourcesContent":["/**\n * An output's capture ownership. Cue a page while preparing an event; commit when that event\n * happens. A prepared cue belongs to its caller's scope, and a committed one to the stage.\n * Commits serialize, drain old-page input and refuse stale first frames. `shown` distinguishes\n * confirmed silence, uncertain silence and loss without treating capture silence as evidence.\n * @since 0.3.0\n */\nimport {\n  Cause,\n  Clock,\n  Deferred,\n  Duration,\n  Effect,\n  Exit,\n  Fiber,\n  Option,\n  PubSub,\n  Result,\n  Schedule,\n  Schema,\n  Scope,\n  Stream,\n} from \"effect\";\n\nimport { type BrowserError, Closed, consequence, InvalidRequest, Timeout } from \"./BrowserError.ts\";\nimport type { CaptureStats, Frame, ScreencastOptions } from \"./Frame.ts\";\nimport { failWith, undispatched } from \"./internal/page/context.ts\";\nimport { internalsOf } from \"./internal/page/page.ts\";\nimport type { Page } from \"./Page.ts\";\n\nexport interface Options extends ScreencastOptions {\n  /** Bound for each first-frame wait. Defaults to 5 seconds. */\n  readonly firstFrame?: Duration.Input | undefined;\n}\n\n/** A switch that took effect, on the clock shared by browser events and frames. */\nexport class Presented extends Schema.Class<Presented>(\"effect-browser/Presented\")({\n  page: Schema.String,\n  at: Schema.Finite,\n  latency: Schema.Finite,\n}) {}\n\nexport interface Cue {\n  readonly page: Page;\n  /** A frame of the current document, or the capture's failure or first-frame timeout. */\n  readonly ready: Effect.Effect<void, BrowserError>;\n  /** Commit on the event's host time, or now. Interruption before switching leaves the cue usable. */\n  readonly commit: (options?: {\n    readonly at?: number | undefined;\n  }) => Effect.Effect<Presented, BrowserError>;\n}\n\n/** What the output establishes at nondecreasing host times; frames retain their capture times. */\nexport type Shown =\n  | { readonly _tag: \"Painted\"; readonly frame: Frame; readonly at: number }\n  | { readonly _tag: \"Still\"; readonly frame: Frame; readonly at: number }\n  | { readonly _tag: \"Stalled\"; readonly frame: Frame; readonly at: number }\n  | { readonly _tag: \"Gone\"; readonly page: string; readonly at: number };\n\nexport interface Stage {\n  readonly present: (\n    page: Page,\n    options?: { readonly at?: number | undefined },\n  ) => Effect.Effect<Presented, BrowserError>;\n  readonly cue: (page: Page) => Effect.Effect<Cue, BrowserError, Scope.Scope>;\n  /** Paint and, after every finite positive hold without paint, current evidence or loss. */\n  readonly shown: (options: { readonly hold: Duration.Input }) => Stream.Stream<Shown>;\n  /** Capture-timed current-page paint; use `shown` for output time. Readers retain 16 frames. */\n  readonly frames: Stream.Stream<Frame>;\n  readonly current: Effect.Effect<Option.Option<Page>>;\n  readonly stats: (options?: {\n    readonly window?: Duration.Input | undefined;\n  }) => Effect.Effect<Option.Option<CaptureStats>, BrowserError>;\n}\n\ntype FeedState =\n  | { readonly _tag: \"Warming\" }\n  | { readonly _tag: \"Ready\"; readonly latest: Frame | undefined }\n  | { readonly _tag: \"Stopped\" };\ninterface Feed {\n  readonly page: Page;\n  readonly scope: Scope.Closeable;\n  readonly changed: PubSub.PubSub<Frame>;\n  state: FeedState;\n  fiber: Fiber.Fiber<void, BrowserError> | undefined;\n}\ninterface Paint {\n  readonly feed: Feed;\n  readonly frame: Frame;\n  readonly at: number;\n}\n\ninterface Evidence {\n  readonly feed: Feed;\n  readonly frame: Frame;\n  readonly value: Shown;\n}\n\nconst unavailable = () =>\n  undispatched(\"cue\", new InvalidRequest({ detail: \"the cue's capture is no longer available\" }));\n\n/** The sole writer of a cue's capture lifecycle; presentation ownership belongs to the stage. */\nconst update = (\n  feed: Feed,\n  input: { readonly _tag: \"Paint\"; readonly frame: Frame } | { readonly _tag: \"Reset\" | \"Stop\" },\n) => {\n  if (feed.state._tag === \"Stopped\") return;\n  if (input._tag === \"Stop\") feed.state = { _tag: \"Stopped\" };\n  else if (input._tag === \"Paint\") feed.state = { _tag: \"Ready\", latest: input.frame };\n  else if (feed.state._tag === \"Ready\") feed.state = { _tag: \"Ready\", latest: undefined };\n};\n\nconst restartable = (error: BrowserError) => {\n  const { lost, repeat } = consequence(error);\n\n  return lost === \"nothing\" && repeat !== \"pointless\";\n};\n\nconst stop = (feed: Feed) =>\n  Effect.suspend(() => {\n    update(feed, { _tag: \"Stop\" });\n\n    return Scope.close(feed.scope, Exit.void);\n  });\n\nconst frameOf = (feed: Feed) => {\n  const frame = feed.state._tag === \"Ready\" ? feed.state.latest : undefined;\n  const internals = internalsOf(feed.page);\n\n  return frame !== undefined && (internals === undefined || internals.current(frame))\n    ? frame\n    : undefined;\n};\n\nconst ended = (feed: Feed): Effect.Effect<never, BrowserError> =>\n  feed.fiber === undefined\n    ? Effect.never\n    : Fiber.await(feed.fiber).pipe(\n        Effect.flatMap((exit) =>\n          Exit.isFailure(exit) && !Cause.hasInterruptsOnly(exit.cause)\n            ? Effect.failCause(exit.cause)\n            : Effect.fail(unavailable()),\n        ),\n      );\n\nconst firstOf = (feed: Feed, wait: Duration.Duration) =>\n  Effect.suspend(() => {\n    if (feed.state._tag === \"Stopped\") return Effect.fail(unavailable());\n    if (feed.page.playwright.isClosed()) return failWith(\"cue\", new Closed({ cause: \"page\" }));\n    if (frameOf(feed) !== undefined) return Effect.void;\n\n    return Effect.raceFirst(\n      Stream.fromPubSub(feed.changed).pipe(\n        Stream.filter(() => frameOf(feed) !== undefined),\n        Stream.runHead,\n        Effect.asVoid,\n      ),\n      ended(feed),\n    ).pipe(\n      Effect.timeoutOrElse({\n        duration: wait,\n        orElse: () => failWith(\"cue\", new Timeout({ millis: Duration.toMillis(wait) })),\n      }),\n    );\n  });\n\n// A timer can wake a fraction early; a commit never precedes its event.\nconst until = (at: number, now: () => number): Effect.Effect<void> =>\n  Effect.suspend(() =>\n    at > now()\n      ? Effect.sleep(Duration.millis(Math.ceil(at - now()))).pipe(Effect.andThen(until(at, now)))\n      : Effect.void,\n  );\n\n/** Reserve the next turn before waking it; a fresh caller cannot overtake a queued commit. */\nconst ordered = () => {\n  const waiting: Array<Deferred.Deferred<void>> = [];\n\n  return <A, E, R>(effect: Effect.Effect<A, E, R>) =>\n    Effect.acquireUseRelease(\n      Effect.sync(() => {\n        const turn = Deferred.makeUnsafe<void>();\n\n        waiting.push(turn);\n        if (waiting.length === 1) Deferred.doneUnsafe(turn, Exit.void);\n\n        return turn;\n      }),\n      (turn) => Deferred.await(turn).pipe(Effect.andThen(effect)),\n      (turn) =>\n        Effect.sync(() => {\n          const at = waiting.indexOf(turn);\n\n          waiting.splice(at, 1);\n          if (at === 0 && waiting[0] !== undefined) Deferred.doneUnsafe(waiting[0], Exit.void);\n        }),\n    );\n};\n\n/** A terminal capture can know the connection is gone before the page receives its close event. */\nconst confirm = (feed: Feed, frame: Frame) => {\n  const exit = feed.fiber?.pollUnsafe();\n\n  const failure =\n    exit !== undefined && Exit.isFailure(exit) ? Cause.findErrorOption(exit.cause) : Option.none();\n\n  if (Option.isSome(failure) && consequence(failure.value).lost !== \"nothing\")\n    return Effect.fail(failure.value);\n\n  return feed.page.playwright.isClosed()\n    ? failWith(\"shown\", new Closed({ cause: \"page\" }))\n    : (internalsOf(feed.page)?.confirm(frame) ?? Effect.succeed(false));\n};\n\n/** Each subscriber confirms silence; a new frame or commit invalidates a probe. */\nconst evidence = (\n  output: PubSub.PubSub<Paint>,\n  current: () =>\n    | { readonly feed: Feed; readonly frame: Frame; readonly changedAt: number }\n    | undefined,\n  now: () => number,\n  hold: Duration.Input,\n): Stream.Stream<Shown> =>\n  Stream.unwrap(\n    Effect.sync(() => {\n      const parsed = Duration.fromInput(hold);\n\n      if (\n        Option.isNone(parsed) ||\n        !Duration.isFinite(parsed.value) ||\n        !Duration.isPositive(parsed.value)\n      )\n        throw new RangeError(\"shown hold must be a finite positive duration\");\n      const millis = Duration.toMillis(parsed.value);\n      let checkedAt = now();\n      let shownAt = Number.NEGATIVE_INFINITY;\n      let seen: Pick<Paint, \"feed\" | \"frame\"> | undefined = current();\n      let gone: Feed | undefined;\n\n      const probe = Effect.gen(function* () {\n        yield* until(Math.max(checkedAt, current()?.changedAt ?? checkedAt) + millis, now);\n        checkedAt = now();\n        const before = current();\n        const frame = before?.frame;\n\n        if (\n          before === undefined ||\n          frame === undefined ||\n          gone === before.feed ||\n          checkedAt - before.changedAt < millis\n        )\n          return Option.none<Evidence>();\n        const { feed } = before;\n\n        const confirmed = yield* Effect.result(confirm(feed, frame));\n\n        if (current()?.feed !== feed || current()?.frame !== frame) return Option.none<Evidence>();\n        const at = now();\n\n        checkedAt = at;\n        if (Result.isFailure(confirmed) && consequence(confirmed.failure).lost !== \"nothing\") {\n          return Option.some<Evidence>({\n            feed,\n            frame,\n            value: { _tag: \"Gone\", page: feed.page.id, at },\n          });\n        }\n\n        return Option.some<Evidence>({\n          feed,\n          frame,\n          value: {\n            _tag: Result.isSuccess(confirmed) && confirmed.success ? \"Still\" : \"Stalled\",\n            frame,\n            at,\n          },\n        });\n      });\n\n      return Stream.merge(\n        Stream.fromPubSub(output).pipe(\n          Stream.map(({ feed, frame, at }): Evidence => ({\n            feed,\n            frame,\n            value: { _tag: \"Painted\", frame, at },\n          })),\n        ),\n        Stream.fromEffectRepeat(probe).pipe(\n          Stream.filter(Option.isSome),\n          Stream.map(({ value }) => value),\n        ),\n      ).pipe(\n        // A probe can overtake queued paint while its reader is paused. It establishes nothing\n        // about that reader's output until the matching frame has reached it.\n        Stream.filter(({ feed, frame, value }) => {\n          if (value._tag === \"Painted\" && gone !== feed) {\n            seen = { feed, frame };\n\n            return true;\n          }\n          // The subscription may have begun after its first publication.\n          seen ??= { feed, frame };\n\n          return value._tag !== \"Painted\" && seen?.feed === feed && seen.frame === frame;\n        }),\n        Stream.map(({ feed, value }) => {\n          if (value._tag === \"Gone\") gone = feed;\n          // A frame captured before a silence probe can arrive after the probe's evidence.\n          shownAt = Math.max(shownAt, value.at);\n\n          return value.at === shownAt ? value : { ...value, at: shownAt };\n        }),\n      );\n    }),\n  );\n\nconst openFeed = (\n  page: Page,\n  owner: Scope.Scope,\n  clock: Clock.Clock,\n  settings: ScreencastOptions,\n  current: () => Feed | undefined,\n  publish: (feed: Feed, frame: Frame) => Effect.Effect<unknown>,\n) =>\n  Effect.gen(function* () {\n    const scope = yield* Scope.fork(owner);\n    const started = yield* Deferred.make<void>();\n\n    const feed: Feed = {\n      page,\n      scope,\n      changed: yield* PubSub.sliding<Frame>({ capacity: 1, replay: 1 }),\n      state: { _tag: \"Warming\" },\n      fiber: undefined,\n    };\n\n    yield* Scope.addFinalizer(\n      scope,\n      Effect.sync(() => {\n        update(feed, { _tag: \"Stop\" });\n      }),\n    );\n    yield* Effect.addFinalizer(() => (current() === feed ? Effect.void : stop(feed)));\n\n    const accept = (frame: Frame) =>\n      Effect.suspend(() => {\n        update(feed, { _tag: \"Paint\", frame });\n\n        return (current() === feed ? publish(feed, frame) : Effect.void).pipe(\n          Effect.andThen(PubSub.publish(feed.changed, frame)),\n        );\n      });\n\n    const capture = Effect.scoped(\n      Effect.gen(function* () {\n        update(feed, { _tag: \"Reset\" });\n\n        const internals = internalsOf(page);\n\n        const { stream, current: frame } = yield* (\n          internals?.capture(settings) ??\n            Effect.succeed({ stream: page.screencast(settings), current: undefined })\n        );\n\n        if (frame !== undefined && internals?.current(frame)) yield* accept(frame);\n        yield* Deferred.succeed(started, undefined);\n        yield* Stream.runForEach(stream, accept);\n      }),\n    ).pipe(\n      Effect.ensuring(Effect.sync(() => update(feed, { _tag: \"Reset\" }))),\n      Effect.retry({\n        while: (error) => feed.state._tag === \"Ready\" && restartable(error),\n        schedule: Schedule.spaced(\"500 millis\"),\n      }),\n    );\n\n    feed.fiber = yield* capture.pipe(\n      Effect.provideService(Clock.Clock, clock),\n      Effect.forkIn(scope),\n    );\n    yield* Effect.raceFirst(Deferred.await(started), ended(feed)).pipe(\n      Effect.onError(() => stop(feed)),\n    );\n\n    return feed;\n  });\n\nexport const make = Effect.fn(\"Stage.make\")(function* (\n  options: Options = {},\n): Effect.fn.Return<Stage, BrowserError, Scope.Scope> {\n  const clock = yield* Clock.Clock;\n  const owner = yield* Effect.scope;\n  const now = () => Number(clock.monotonicTimeNanosUnsafe()) / 1e6;\n  const waited = Duration.fromInput(options.firstFrame ?? Duration.seconds(5));\n\n  if (\n    Option.isNone(waited) ||\n    !Duration.isFinite(waited.value) ||\n    !Duration.isPositive(waited.value)\n  )\n    return yield* failWith(\n      \"stage\",\n      new InvalidRequest({ detail: \"firstFrame must be a finite positive duration\" }),\n    );\n  const firstFrame = waited.value;\n  const settings = { quality: options.quality, size: options.size };\n  const output = yield* PubSub.sliding<Paint>(16);\n  const switching = ordered();\n\n  let showing:\n    | { readonly feed: Feed; readonly presented: Presented; frame: Frame; changedAt: number }\n    | undefined;\n\n  let painted = Number.NEGATIVE_INFINITY;\n\n  yield* Effect.addFinalizer(() => PubSub.shutdown(output));\n\n  const publish = (feed: Feed, frame: Frame, at = frame.hostTime) =>\n    Effect.suspend(() => {\n      painted = Math.max(painted, at);\n      if (showing !== undefined) {\n        showing.changedAt = now();\n        showing.frame = frame;\n      }\n\n      return PubSub.publish(output, { feed, frame, at: painted });\n    });\n\n  const commit = (feed: Feed, options: { readonly at?: number | undefined } = {}) =>\n    Effect.suspend(() => {\n      const asked = options.at ?? now();\n\n      return switching(\n        Effect.gen(function* () {\n          if (!Number.isFinite(asked))\n            return yield* failWith(\n              \"cue\",\n              new InvalidRequest({ detail: \"at must be finite host milliseconds\" }),\n            );\n          yield* firstOf(feed, firstFrame);\n          const old = showing;\n\n          if (old?.feed === feed) return old.presented;\n\n          yield* Effect.raceFirst(until(asked, now), ended(feed));\n\n          const switchTo = Effect.suspend(() => {\n            const frame = frameOf(feed);\n\n            if (frame === undefined) return Effect.fail(unavailable());\n            const at = Math.max(now(), asked, frame.hostTime, painted);\n\n            showing = {\n              feed,\n              frame,\n              presented: new Presented({ page: feed.page.id, at, latency: at - asked }),\n              changedAt: at,\n            };\n\n            return publish(feed, frame, at).pipe(Effect.as(showing.presented));\n          }).pipe(Effect.uninterruptible);\n\n          const readyToSwitch = firstOf(feed, firstFrame).pipe(\n            Effect.andThen(switchTo),\n            Effect.provideService(Clock.Clock, clock),\n          );\n\n          const before = old === undefined ? undefined : internalsOf(old.feed.page);\n\n          return yield* (\n            before === undefined ? readyToSwitch : before.afterInput(readyToSwitch)\n          ).pipe(\n            // The cut owns old-page input through publication. Capture cleanup has its own bound\n            // and must finish even if the caller leaves, without turning a completed cut into Timeout.\n            Effect.ensuring(\n              Effect.suspend(() =>\n                showing?.feed === feed && old !== undefined ? stop(old.feed) : Effect.void,\n              ),\n            ),\n          );\n        }).pipe(Effect.provideService(Clock.Clock, clock)),\n      );\n    });\n\n  const cue: Stage[\"cue\"] = (page) =>\n    Effect.map(\n      openFeed(page, owner, clock, settings, () => showing?.feed, publish),\n      (feed) => ({\n        page,\n        ready: firstOf(feed, firstFrame).pipe(Effect.provideService(Clock.Clock, clock)),\n        commit: (options) => commit(feed, options),\n      }),\n    );\n\n  return {\n    cue,\n    present: (page, options) =>\n      Effect.suspend(() => {\n        const asked = options?.at ?? now();\n\n        return showing?.feed.page === page\n          ? Effect.as(firstOf(showing.feed, firstFrame), showing.presented)\n          : Effect.scoped(Effect.flatMap(cue(page), (prepared) => prepared.commit({ at: asked })));\n      }),\n    shown: ({ hold }) =>\n      evidence(output, () => showing, now, hold).pipe(Stream.provideService(Clock.Clock, clock)),\n    frames: Stream.fromPubSub(output).pipe(Stream.map(({ frame }) => frame)),\n    current: Effect.sync(() => Option.fromNullishOr(showing?.feed.page)),\n    stats: (options = {}) =>\n      showing === undefined\n        ? Effect.succeedNone\n        : Effect.asSome(showing.feed.page.captureStats({ window: options.window ?? \"1 second\" })),\n  } satisfies Stage;\n});\n"],"mappings":"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"}

package/dist/{Supervisor-CYWFK3vM.d.mts → Supervisor-5tZ47hR5.d.mts}

@@ -1,8 +1,7 @@
-import { c as DisconnectCause } from "./BrowserEvent-BRu2juEz.mjs";
 import { Service, t as Browser_d_exports } from "./Browser.mjs";
-import { Cause, Duration, Effect, Schedule, Schema, Scope, Stream } from "effect";
+import { Cause, Context, Duration, Effect, Schedule, Schema, Scope, Stream } from "effect";
 declare namespace lifecycle_d_exports {
-  export { Closed, Command, Down, Drain, Draining, GenerationState, Held, Input, Kept, Live, Lost, Open, Opening, Released, Reopening, Resolution, Settled, State, Step, Unconfirmed, lookup, resolve, start, transition };
+  export { Closed, Command, Down, Drain, Draining, GenerationState, Held, Input, Kept, Live, Lost, Open, Opening, Released, Reopening, Resolution, Settled, State, Step, Unconfirmed, combine, lookup, resolve, start, transition };
 }
 declare const Settled_base: Schema.Class<Settled, Schema.TaggedStruct<"Settled", {}>, {}>;
 /** The provider confirmed that the generation's browser ended. */
@@ -30,9 +29,10 @@ declare const Draining_base: Schema.Class<Draining, Schema.TaggedStruct<"Drainin
 /** No longer serving; holds end at this host-monotonic deadline or when their owners let go. */
 declare class Draining extends Draining_base {}
 declare const Lost_base: Schema.Class<Lost, Schema.TaggedStruct<"Lost", {
-  readonly cause: Schema.Literals<readonly ["connection", "session", "released"]>;
+  readonly cause: Schema.Union<readonly [Schema.Literals<readonly ["connection", "session", "released"]>, Schema.Literal<"declared">]>;
+  readonly detail: Schema.optional<Schema.String>;
 }>, {}>;
-/** Lost: its connection dropped, or its provider ended its session, as `cause` says. */
+/** Lost through disconnection or a consumer's declaration that it is unusable. */
 declare class Lost extends Lost_base {}
 declare const Down_base: Schema.Class<Down, Schema.TaggedStruct<"Down", {
   readonly detail: Schema.String;
@@ -88,10 +88,15 @@ type State<A, H = unknown> = ({
   readonly _tag: "Retired";
 }) & {
   readonly draining: ReadonlyMap<number, Drain<A, H>>;
+  /** Retain the first unconfirmed end, otherwise the latest settled end, without its resources. */
+  readonly released?: Released | undefined;
 };
 type Input<A, H = unknown> = {
   readonly _tag: "Opened";
   readonly live: Live<A>;
+} | {
+  readonly _tag: "AttemptReleased";
+  readonly released: Released;
 } | {
   readonly _tag: "Failed";
   readonly number: number;
@@ -103,7 +108,8 @@ type Input<A, H = unknown> = {
 } | {
   readonly _tag: "Lost";
   readonly number: number;
-  readonly cause: DisconnectCause;
+  readonly cause: Lost["cause"];
+  readonly detail?: string | undefined;
 } | {
   readonly _tag: "Rotate";
   readonly due?: number | undefined;
@@ -130,7 +136,6 @@ type Input<A, H = unknown> = {
 type Command<A> = {
   readonly _tag: "Open";
   readonly number: number;
-  readonly after: number | undefined;
 } | {
   readonly _tag: "Watch";
   readonly live: Live<A>;
@@ -163,6 +168,8 @@ declare const start: <A, H = unknown>() => Step<A, H>;
 declare const lookup: <A, H>(state: State<A, H>, number: number) => Held<A, H> | undefined;
 /** Pure admission and lifecycle changes. A rejected hold preserves state identity. */
 declare const transition: <A, H = unknown>(state: State<A, H>, input: Input<A, H>, exclusive: boolean, now?: number, handover?: number) => Step<A, H>;
+/** Later confirmations cannot establish that an earlier unconfirmed session ended. */
+declare const combine: (before: Released | undefined, next: Released | undefined) => Settled | Unconfirmed | undefined;
 type Resolution<A> = {
   readonly _tag: "Serve";
   readonly live: Live<A>;
@@ -175,7 +182,7 @@ type Resolution<A> = {
 /** An unheld browser resolution; use obtains its hold atomically through Hold instead. */
 declare const resolve: <A, H>(state: State<A, H>, target: number | undefined) => Resolution<A> | undefined;
 declare namespace Supervisor_d_exports {
-  export { Closed, Down, Draining, Generation, GenerationState, Kept, Lease, Lost, Open, Opened, Opening, Options, Released, Reopening, Settled, Superseded, Supervisor, Unavailable, Unconfirmed, UseOptions, make };
+  export { Admission, Closed, Down, Draining, Generation, GenerationState, Kept, Lease, Lost, Open, Opened, Opening, Options, Released, Releasing, Reopening, Settled, Superseded, Supervisor, Unavailable, Unconfirmed, UseOptions, make };
 }
 declare const Generation_base: Schema.Class<Generation, Schema.Struct<{
   readonly number: Schema.Int;
@@ -208,9 +215,30 @@ interface Opened<A = void> {
    */
   readonly release?: Effect.Effect<Released> | undefined;
 }
+/** Facts available before an acquisition attempt; awaiting `after` never changes release order. */
+interface Admission {
+  readonly number: number;
+  /**
+   * Every earlier session that stopped serving, including failed attempts and older drains.
+   * Waits for all pending releases; an Unconfirmed end remains visible to later attempts.
+   * Undefined before any release. A still-serving nonexclusive predecessor is excluded.
+   */
+  readonly after: Effect.Effect<Released> | undefined;
+}
+declare const Releasing_base: Context.ServiceClass<Releasing, "effect-browser/Supervisor/Releasing", {
+  readonly released: (outcome: Released) => Effect.Effect<void>;
+}>;
+/**
+ * Optional service supplied during `open`. Providers report failed-attempt cleanup here before
+ * their scope closes; successful generations instead return `Opened.release`. Reporting does
+ * not release resources or replace the original acquisition failure.
+ */
+declare class Releasing extends Releasing_base {}
 interface Options<E, R, A = void> {
   /** Opens one generation in the scope it is given. */
   readonly open: Effect.Effect<Opened<A>, E, R>;
+  /** Runs before every open attempt, including the first; failures follow `reopen` and `definite`. */
+  readonly admit?: ((opening: Admission) => Effect.Effect<void, E, R>) | undefined;
   /** When to try a failed open again. Defaults to exponential from 1 second, for 5 minutes. */
   readonly reopen?: Schedule.Schedule<unknown, E> | undefined;
   /**
@@ -247,6 +275,8 @@ interface Lease<A> {
   readonly generation: number;
   readonly browser: Service;
   readonly value: A;
+  /** Declare this serving generation unusable and revoke it now; stale declarations do nothing. */
+  readonly lose: (detail: string) => Effect.Effect<void>;
   /** First notice that serving ended; loss or retirement may revoke before its deadline. */
   readonly ending: Effect.Effect<Superseded>;
   /** An independent scope; its resources close before provider release. Fails once revoked. */
@@ -276,5 +306,5 @@ type MakeOptions<E, R, A> = Omit<Options<E, R, A>, "open"> & {
 declare function make<E, R, A = void>(options: Options<E, R, A>): Effect.Effect<Supervisor<A>, never, Scope.Scope | Exclude<R, Scope.Scope>>;
 declare function make<E, R>(options: MakeOptions<E, R, never>): Effect.Effect<Supervisor<void>, never, Scope.Scope | Exclude<R, Scope.Scope>>;
 //#endregion
-export { Unconfirmed as S, Open as _, Superseded as a, Reopening as b, Unavailable as c, Closed as d, Down as f, Lost as g, Kept as h, Options as i, UseOptions as l, GenerationState as m, Lease as n, Supervisor as o, Draining as p, Opened as r, Supervisor_d_exports as s, Generation as t, make as u, Opening as v, Settled as x, Released as y };
-//# sourceMappingURL=Supervisor-CYWFK3vM.d.mts.map
+export { Settled as C, Reopening as S, Kept as _, Options as a, Opening as b, Supervisor as c, UseOptions as d, make as f, GenerationState as g, Draining as h, Opened as i, Supervisor_d_exports as l, Down as m, Generation as n, Releasing as o, Closed as p, Lease as r, Superseded as s, Admission as t, Unavailable as u, Lost as v, Unconfirmed as w, Released as x, Open as y };
+//# sourceMappingURL=Supervisor-5tZ47hR5.d.mts.map

package/dist/{Supervisor-TNKNOVzu.mjs → Supervisor-DaGlQVjv.mjs}

@@ -1,6 +1,6 @@
 import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.mjs";
 import { DisconnectCause } from "./BrowserEvent.mjs";
-import { Cause, Clock, DateTime, Deferred, Duration, Effect, Exit, FiberHandle, FiberMap, Option, Predicate, PubSub, Schedule, Schema, Scope, Semaphore, Stream, SubscriptionRef } from "effect";
+import { Cause, Clock, Context, DateTime, Deferred, Duration, Effect, Exit, FiberHandle, FiberMap, Option, Predicate, PubSub, Schedule, Schema, Scope, Semaphore, Stream, SubscriptionRef } from "effect";
 //#region src/internal/supervisor/lifecycle.ts
 /**
 * A supervisor's life as one state and one transition function, and the generation states it
@@ -27,8 +27,11 @@ var Draining = class extends Schema.TaggedClass()("Draining", {
 	]),
 	revokeAt: Schema.Finite
 }) {};
-/** Lost: its connection dropped, or its provider ended its session, as `cause` says. */
-var Lost = class extends Schema.TaggedClass()("Lost", { cause: DisconnectCause }) {};
+/** Lost through disconnection or a consumer's declaration that it is unusable. */
+var Lost = class extends Schema.TaggedClass()("Lost", {
+	cause: Schema.Union([DisconnectCause, Schema.Literal("declared")]),
+	detail: Schema.optional(Schema.String)
+}) {};
 /**
 * It never opened: its last try failed with `cause`, which the provider deems definite, or after
 * which the reopen schedule gave up.
@@ -64,8 +67,7 @@ const start = () => ({
 	events: [[1, new Opening()]],
 	commands: [{
 		_tag: "Open",
-		number: 1,
-		after: void 0
+		number: 1
 	}]
 });
 const servingOf = (state) => state._tag === "Retired" ? void 0 : state.serving;
@@ -145,30 +147,33 @@ const holds = (change, input) => {
 const next = (change, number, reopen) => {
 	const { exclusive } = change;
 	const current = servingOf(change.state);
-	const after = exclusive ? current?.number ?? change.state.draining.keys().next().value : void 0;
 	if (current !== void 0 && (reopen || exclusive)) end(change, current, reopen ? "lost" : "rotated");
 	change.state = {
 		_tag: "Opening",
 		number,
 		serving: reopen || exclusive ? void 0 : current,
-		draining: change.state.draining
+		draining: change.state.draining,
+		released: change.state.released
 	};
 	change.events.push([number, reopen ? new Reopening() : new Opening()]);
 	change.commands.push({
 		_tag: "Open",
-		number,
-		after
+		number
 	});
 };
 const lost = (change, input) => {
 	const { state } = change;
 	const drain = state.draining.get(input.number);
 	const current = servingOf(state);
+	if (input.cause === "declared" && current?.number !== input.number) return;
 	if (drain?._tag === "Draining") {
 		change.events.push([input.number, new Lost({ cause: input.cause })]);
 		revoke(change, input.number, "lost");
 	} else if (state._tag !== "Retired" && current?.number === input.number) {
-		change.events.push([input.number, new Lost({ cause: input.cause })]);
+		change.events.push([input.number, new Lost({
+			cause: input.cause,
+			detail: input.detail
+		})]);
 		if (state._tag !== "Opening") next(change, (state._tag === "Open" ? current.number : state.number) + 1, true);
 		else {
 			change.state = {
@@ -214,7 +219,8 @@ const transition = (state, input, exclusive, now = 0, handover = 3e4) => {
 				change.state = {
 					_tag: "Open",
 					serving: live,
-					draining: change.state.draining
+					draining: change.state.draining,
+					released: change.state.released
 				};
 			}
 			break;
@@ -236,6 +242,12 @@ const transition = (state, input, exclusive, now = 0, handover = 3e4) => {
 		case "Abandoned":
 			change.events.push([input.number, new Closed({})]);
 			break;
+		case "AttemptReleased":
+			change.state = {
+				...state,
+				released: combine(state.released, input.released)
+			};
+			break;
 		case "Released": {
 			const drain = state.draining.get(input.number);
 			if (drain === void 0 || drain._tag === "Draining" || drain.live.holds.size > 0) break;
@@ -243,7 +255,8 @@ const transition = (state, input, exclusive, now = 0, handover = 3e4) => {
 			draining.delete(input.number);
 			change.state = {
 				...state,
-				draining
+				draining,
+				released: combine(state.released, input.released)
 			};
 			change.events.push([input.number, input.released === void 0 ? new Kept() : new Closed({ released: input.released })]);
 			break;
@@ -263,11 +276,14 @@ const transition = (state, input, exclusive, now = 0, handover = 3e4) => {
 			if (state.serving !== void 0) end(change, state.serving, "retired", input._tag === "Keep");
 			change.state = {
 				_tag: "Retired",
-				draining: change.state.draining
+				draining: change.state.draining,
+				released: change.state.released
 			};
 	}
 	return change;
 };
+/** Later confirmations cannot establish that an earlier unconfirmed session ended. */
+const combine = (before, next) => before?._tag === "Unconfirmed" ? before : next ?? before;
 /** An unheld browser resolution; use obtains its hold atomically through Hold instead. */
 const resolve = (state, target) => {
 	if (state._tag === "Retired") return {
@@ -319,6 +335,7 @@ var Supervisor_exports = /* @__PURE__ */ __exportAll({
 	Open: () => Open,
 	Opening: () => Opening,
 	Released: () => Released,
+	Releasing: () => Releasing,
 	Reopening: () => Reopening,
 	Settled: () => Settled,
 	Superseded: () => Superseded,
@@ -350,6 +367,12 @@ var Unavailable = class extends Schema.TaggedError()("Unavailable", {
 		return `no browser: ${this.detail}`;
 	}
 };
+/**
+* Optional service supplied during `open`. Providers report failed-attempt cleanup here before
+* their scope closes; successful generations instead return `Opened.release`. Reporting does
+* not release resources or replace the original acquisition failure.
+*/
+var Releasing = class extends Context.Service()("effect-browser/Supervisor/Releasing") {};
 /** Work whose generation was revoked; input receipts still determine whether input reached a site. */
 var Superseded = class extends Schema.TaggedError()("Superseded", {
 	generation: Schema.Int,
@@ -360,6 +383,11 @@ var Superseded = class extends Schema.TaggedError()("Superseded", {
 	]),
 	revokeAt: Schema.Finite
 }) {};
+const superseded = (generation, { reason, revokeAt }) => new Superseded({
+	generation,
+	reason,
+	revokeAt
+});
 const retired = () => new Unavailable({
 	reason: "retired",
 	detail: "the supervisor was retired"
@@ -368,11 +396,6 @@ const describe = (cause) => {
 	const error = Cause.squash(cause);
 	return Predicate.isError(error) ? error.message : String(error);
 };
-const unavailable = (resolution) => new Unavailable({
-	reason: resolution.reason,
-	detail: resolution.detail,
-	cause: resolution.cause
-});
 const timedOut = () => new Unavailable({
 	reason: "opening",
 	detail: "no generation opened within the wait"
@@ -383,7 +406,7 @@ const bounded = (input, name) => Effect.suspend(() => {
 });
 /** Resolve immediately before starting a bounded wait, including when its duration is zero. */
 const waitFor = (state, wait, clock, target) => {
-	const result = (resolution) => resolution._tag === "Serve" ? Effect.succeed(resolution.live) : Effect.fail(unavailable(resolution));
+	const result = (resolution) => resolution._tag === "Serve" ? Effect.succeed(resolution.live) : Effect.fail(new Unavailable(resolution));
 	return Effect.suspend(() => {
 		const current = resolve(state.value, target);
 		return current === void 0 ? SubscriptionRef.changes(state).pipe(Stream.map((state) => resolve(state, target)), Stream.filter(Predicate.isNotUndefined), Stream.runHead, Effect.flatMap(Option.match({
@@ -404,7 +427,7 @@ const untilRotation = (expiresAt, before) => Clock.currentTimeMillis.pipe(Effect
 const until = (at, now) => Effect.suspend(() => now() >= at ? Effect.void : Effect.sleep(Duration.millis(Math.ceil(at - now()))).pipe(Effect.andThen(until(at, now))));
 /** Borrowed work and transferred scopes hold a generation until cleanup lets it go. */
 const leasing = (state, apply, waitTimeout, now, clock) => {
-	const borrow = (hold, wait) => Effect.gen(function* () {
+	const borrow = Effect.fnUntraced(function* (hold, wait) {
 		const until = now() + Duration.toMillis(wait);
 		for (;;) {
 			const step = yield* apply({
@@ -420,6 +443,12 @@ const leasing = (state, apply, waitTimeout, now, clock) => {
 		generation: live.number,
 		browser: live.value.opened.browser,
 		value: live.value.opened.value,
+		lose: (detail) => apply({
+			_tag: "Lost",
+			number: live.number,
+			cause: "declared",
+			detail
+		}).pipe(Effect.asVoid),
 		ending: Deferred.await(live.value.ending),
 		retain: Effect.uninterruptible(Effect.gen(function* () {
 			const scope = yield* Scope.make();
@@ -451,7 +480,8 @@ const leasing = (state, apply, waitTimeout, now, clock) => {
 			number: live.number,
 			hold
 		}).pipe(Effect.asVoid));
-		return yield* Effect.raceFirst(work(leaseOf(live)), Deferred.await(live.value.revoked).pipe(Effect.flatMap(Effect.fail)));
+		const revoked = Deferred.await(live.value.revoked).pipe(Effect.flatMap(Effect.fail));
+		return yield* Effect.raceFirst(work(leaseOf(live)).pipe(Effect.tap(() => Deferred.isDone(live.value.revoked).pipe(Effect.flatMap((done) => done ? revoked : Effect.void)))), revoked);
 	}));
 	return use;
 };
@@ -462,9 +492,9 @@ const acquireGeneration = (open, own) => Effect.uninterruptibleMask((restore) =>
 	},
 	scope,
 	ending: Deferred.makeUnsafe(),
-	revoked: Deferred.makeUnsafe()
+	revoked: Deferred.makeUnsafe(),
+	released: Deferred.makeUnsafe()
 })))));
-const changedUntil = (state, predicate) => SubscriptionRef.changes(state).pipe(Stream.filter(predicate), Stream.runHead, Effect.asVoid);
 const watchGeneration = (live, rotateBefore, apply) => {
 	const { browser } = live.value.opened;
 	const loss = browser.disconnected.pipe(Effect.flatMap((cause) => apply({
@@ -481,16 +511,10 @@ const watchGeneration = (live, rotateBefore, apply) => {
 		discard: true
 	});
 };
-const releaseGeneration = (command, state, apply) => Effect.gen(function* () {
-	const { live, ending } = command;
-	yield* Deferred.succeed(live.value.revoked, new Superseded({
-		generation: live.number,
-		reason: ending.reason,
-		revokeAt: ending.revokeAt
-	}));
-	const holds = lookup(state.value, live.number)?.holds ?? [];
-	const cleaned = yield* Effect.forEach(holds, (hold) => Effect.exit(hold._tag === "Retained" ? Scope.close(hold.scope, Exit.void) : Effect.void), { concurrency: 8 });
-	yield* changedUntil(state, (current) => (lookup(current, live.number)?.holds.size ?? 0) === 0);
+const releaseGeneration = Effect.fnUntraced(function* (command, state, apply) {
+	const { live } = command;
+	const cleaned = yield* Effect.forEach(lookup(state.value, live.number)?.holds ?? [], (hold) => Effect.exit(hold._tag === "Retained" ? Scope.close(hold.scope, Exit.void) : Effect.void), { concurrency: 8 });
+	yield* SubscriptionRef.changes(state).pipe(Stream.filter((current) => (lookup(current, live.number)?.holds.size ?? 0) === 0), Stream.runHead);
 	const released = command._tag === "Leave" ? void 0 : yield* (live.value.opened.release ?? Effect.succeed(new Settled())).pipe(Effect.catchCause((cause) => Effect.succeed(new Unconfirmed({ detail: `the release failed: ${describe(cause)}` }))));
 	const closed = yield* Effect.exit(Scope.close(live.value.scope, Exit.void));
 	yield* apply({
@@ -498,15 +522,24 @@ const releaseGeneration = (command, state, apply) => Effect.gen(function* () {
 		number: live.number,
 		released
 	});
+	if (released !== void 0) yield* Deferred.succeed(live.value.released, released);
 	yield* Exit.asVoidAll([...cleaned, closed]);
 });
+const admissionAfter = (state) => {
+	const released = state.released;
+	const pending = [...state.draining.values()].filter((drain) => drain._tag !== "Leaving").map(({ live }) => live.value.released);
+	return pending.length === 0 && released === void 0 ? void 0 : Effect.gen(function* () {
+		let outcome = released;
+		for (const release of pending) outcome = combine(outcome, yield* Deferred.await(release));
+		return outcome ?? new Settled();
+	});
+};
 const makeScoped = Effect.fn("Supervisor.make")(function* (options) {
 	const clock = yield* Clock.Clock;
 	const now = () => Number(clock.monotonicTimeNanosUnsafe()) / 1e6;
 	const context = yield* Effect.context();
 	const own = yield* Scope.fork(yield* Effect.scope);
 	const exclusive = options.exclusive ?? false;
-	const definite = options.definite ?? (() => false);
 	const reopen = options.reopen ?? Schedule.exponential("1 second").pipe(Schedule.upTo({ duration: Duration.minutes(5) }));
 	const rotateBefore = options.rotateBefore === void 0 ? void 0 : Duration.fromInputUnsafe(options.rotateBefore);
 	const waitTimeout = yield* bounded(options.waitTimeout ?? Duration.minutes(2), "waitTimeout");
@@ -519,14 +552,14 @@ const makeScoped = Effect.fn("Supervisor.make")(function* (options) {
 	const releases = yield* FiberMap.make();
 	const runOpen = yield* FiberHandle.runtime(opening)();
 	const runRelease = yield* FiberMap.runtime(releases)();
-	const apply = (input) => applying.withPermit(Effect.gen(function* () {
+	const apply = Effect.fnUntraced(function* (input) {
 		const current = state.value;
 		const step = transition(current, input, exclusive, now(), handover);
 		if (step.state !== current) yield* SubscriptionRef.set(state, step.state);
 		yield* perform(step);
 		return step;
-	})).pipe(Effect.uninterruptible, Effect.provideService(Clock.Clock, clock));
-	const perform = (step) => Effect.gen(function* () {
+	}, (effect) => applying.withPermit(effect), Effect.uninterruptible, Effect.provideService(Clock.Clock, clock));
+	const perform = Effect.fnUntraced(function* (step) {
 		for (const [number, generation] of step.events) PubSub.publishUnsafe(events, [new Generation({
 			number,
 			at: clock.currentTimeMillisUnsafe(),
@@ -535,17 +568,13 @@ const makeScoped = Effect.fn("Supervisor.make")(function* (options) {
 		})]);
 		for (const command of step.commands) switch (command._tag) {
 			case "Open":
-				runOpen(openGeneration(command.number, command.after));
+				runOpen(openGeneration(command.number));
 				break;
 			case "Watch":
 				yield* Effect.forkIn(Effect.provideContext(watchGeneration(command.live, rotateBefore, apply), context), command.live.value.scope);
 				break;
 			case "Drain": {
-				const ending = new Superseded({
-					generation: command.live.number,
-					reason: command.ending.reason,
-					revokeAt: command.ending.revokeAt
-				});
+				const ending = superseded(command.live.number, command.ending);
 				yield* Deferred.succeed(command.live.value.ending, ending);
 				yield* Effect.forkIn(until(ending.revokeAt, now).pipe(Effect.andThen(Effect.suspend(() => apply({
 					_tag: "Revoke",
@@ -554,37 +583,60 @@ const makeScoped = Effect.fn("Supervisor.make")(function* (options) {
 				break;
 			}
 			case "Release":
-			case "Leave": runRelease(command.live.number, releaseGeneration(command, state, apply));
+			case "Leave":
+				yield* Deferred.succeed(command.live.value.revoked, superseded(command.live.number, command.ending));
+				runRelease(command.live.number, releaseGeneration(command, state, apply));
 		}
 	});
-	const openOnce = acquireGeneration(options.open, own).pipe(Effect.provideContext(context));
-	const openGeneration = (number, after) => Effect.uninterruptibleMask((restore) => restore((after === void 0 ? Effect.void : changedUntil(state, (current) => !current.draining.has(after))).pipe(Effect.andThen(Effect.retry(openOnce, {
-		schedule: reopen,
-		while: (error) => !definite(error)
-	})))).pipe(Effect.exit, Effect.flatMap((exit) => Exit.isSuccess(exit) ? apply({
-		_tag: "Opened",
-		live: {
-			number,
-			value: exit.value
-		}
-	}) : Cause.hasInterruptsOnly(exit.cause) ? apply({
-		_tag: "Abandoned",
-		number
-	}) : apply({
-		_tag: "Failed",
-		number,
-		detail: describe(exit.cause),
-		cause: Cause.squash(exit.cause)
-	}))));
-	const use = leasing(state, apply, waitTimeout, now, clock);
+	const openGeneration = (number) => {
+		const openOnce = acquireGeneration(Effect.gen(function* () {
+			const after = admissionAfter(state.value);
+			if (exclusive && after !== void 0) yield* after;
+			yield* options.admit?.({
+				number,
+				after
+			}) ?? Effect.void;
+			return yield* options.open.pipe(Effect.provideService(Releasing, { released: (released) => apply({
+				_tag: "AttemptReleased",
+				released
+			}).pipe(Effect.asVoid) }));
+		}), own).pipe(Effect.provideContext(context));
+		return Effect.uninterruptibleMask((restore) => restore(Effect.retry(openOnce, {
+			schedule: reopen,
+			while: (error) => !options.definite?.(error)
+		})).pipe(Effect.exit, Effect.flatMap((exit) => {
+			if (Exit.isSuccess(exit)) return apply({
+				_tag: "Opened",
+				live: {
+					number,
+					value: exit.value
+				}
+			});
+			const cause = exit.cause;
+			return apply(Cause.hasInterruptsOnly(cause) ? {
+				_tag: "Abandoned",
+				number
+			} : {
+				_tag: "Failed",
+				number,
+				detail: describe(cause),
+				cause: Cause.squash(cause)
+			});
+		})));
+	};
 	const end = yield* Effect.cached(PubSub.publish(events, Exit.void));
-	const stop = (input) => apply(input).pipe(Effect.andThen(FiberHandle.clear(opening)), Effect.andThen(FiberMap.awaitEmpty(releases)), Effect.andThen(Effect.suspend(() => Deferred.isDone(releases.deferred).pipe(Effect.flatMap((failed) => failed ? FiberMap.join(releases) : Effect.void)))), Effect.ensuring(end), Effect.asVoid);
+	const stop = Effect.fnUntraced(function* (input) {
+		yield* apply(input);
+		yield* FiberHandle.clear(opening);
+		yield* FiberMap.awaitEmpty(releases);
+		if (yield* Deferred.isDone(releases.deferred)) yield* FiberMap.join(releases);
+	}, Effect.ensuring(end));
 	const retire = yield* Effect.cached(stop({ _tag: "Retire" }));
 	yield* Effect.addFinalizer(() => options.keep === true ? stop({ _tag: "Keep" }) : retire);
 	yield* perform(started);
 	return {
 		browser: Effect.map(waitFor(state, waitTimeout, clock), (live) => live.value.opened.browser),
-		use,
+		use: leasing(state, apply, waitTimeout, now, clock),
 		states: Stream.fromPubSubTake(events),
 		rotate: apply({ _tag: "Rotate" }).pipe(Effect.flatMap(({ reply }) => reply === void 0 ? Effect.fail(retired()) : Effect.map(waitFor(state, waitTimeout, clock, reply), (live) => live.value.opened.browser))),
 		retire
@@ -594,6 +646,6 @@ function make(options) {
 	return makeScoped(options);
 }
 //#endregion
-export { Unconfirmed as _, make as a, Draining as c, Lost as d, Open as f, Settled as g, Reopening as h, Unavailable as i, GenerationState as l, Released as m, Superseded as n, Closed as o, Opening as p, Supervisor_exports as r, Down as s, Generation as t, Kept as u };
+export { Settled as _, Unavailable as a, Down as c, Kept as d, Lost as f, Reopening as g, Released as h, Supervisor_exports as i, Draining as l, Opening as m, Releasing as n, make as o, Open as p, Superseded as r, Closed as s, Generation as t, GenerationState as u, Unconfirmed as v };
 
-//# sourceMappingURL=Supervisor-TNKNOVzu.mjs.map
+//# sourceMappingURL=Supervisor-DaGlQVjv.mjs.map