effect 4.0.0-beta.74 → 4.0.0-beta.75

package/src/unstable/cli/Flag.ts

@@ -166,8 +166,8 @@ export const choiceWithValue = <const Choice extends ReadonlyArray<readonly [str
  *
  * **When to use**
  *
- * Use when a named option must be restricted to a fixed set of string values
- * and no custom value mapping is needed.
+ * Use when you need to define a named CLI flag with fixed string choices and no
+ * custom value mapping.
  *
  * **Gotchas**
  *
@@ -374,7 +374,8 @@ export const fileSchema = <A>(
  *
  * **When to use**
  *
- * Use when you use this for options that accept configuration values.
+ * Use when you need a CLI flag that accepts one or more `key=value`
+ * configuration entries.
  *
  * **Details**
  *
@@ -674,9 +675,9 @@ export const withMetavar: {
  *
  * **When to use**
  *
- * Use when you use this for experimental or internal flags that should be accepted but not
- * advertised, such as `--experimental-foo`, debug toggles, or escape hatches
- * that are not yet committed to the public CLI surface.
+ * Use when experimental or internal flags should be accepted but not advertised, such as
+ * `--experimental-foo`, debug toggles, or escape hatches that are not yet committed to the
+ * public CLI surface.
  *
  * **Example** (Hiding a flag from help)
  *

package/src/unstable/cli/GlobalFlag.ts

@@ -183,13 +183,14 @@ export const Help: Action<boolean> = action({
  *
  * **When to use**
  *
- * Use to add a built-in `--version` flag to a command runner.
+ * Use to add a built-in `--version / -v` flag to a command runner.
  *
  * @category references
  * @since 4.0.0
  */
 export const Version: Action<boolean> = action({
   flag: Flag.boolean("version").pipe(
+    Flag.withAlias("v"),
     Flag.withDescription("Show version information")
   ),
   run: (_, { command, version }) =>
@@ -266,6 +267,11 @@ export const LogLevel: Setting<"log-level", Option.Option<LogLevelType>> = setti
 /**
  * Built-in global flags in default precedence order.
  *
+ * **When to use**
+ *
+ * Use when extending or inspecting the default global-flag set that
+ * `Command.runWith` prepends before user-defined global flags.
+ *
  * **Details**
  *
  * The built-ins are `Help`, `Version`, `Completions`, and `LogLevel`.

package/src/unstable/cli/Param.ts

@@ -890,7 +890,8 @@ export const fileSchema = <Kind extends ParamKind, A>(
  *
  * **When to use**
  *
- * Use when you use it for options that accept configuration values.
+ * Use when you need command-line options or arguments that collect `key=value`
+ * configuration entries.
  *
  * **Details**
  *
@@ -935,7 +936,8 @@ export const keyValuePair = <Kind extends ParamKind>(
  *
  * **When to use**
  *
- * Use when this is useful for creating placeholder parameters or for combinators.
+ * Use when you need an empty CLI parameter sentinel for optional parameter
+ * construction or internal combinators.
  *
  * **Example** (Creating sentinel parameters)
  *
@@ -970,8 +972,8 @@ const FLAG_DASH_REGEXP = /^-+/
  *
  * **When to use**
  *
- * Use when aliases allow params to be specified with alternative names,
- * typically single-character shortcuts like "-f" for "--force".
+ * Use when you need a CLI parameter to accept an alternate name, such as "-f"
+ * for "--force".
  *
  * **Details**
  *
@@ -1006,8 +1008,8 @@ export const withAlias: {
    *
    * **When to use**
    *
-   * Use when aliases allow params to be specified with alternative names,
-   * typically single-character shortcuts like "-f" for "--force".
+   * Use when you need a CLI parameter to accept an alternate name, such as "-f"
+   * for "--force".
    *
    * **Details**
    *
@@ -1042,8 +1044,8 @@ export const withAlias: {
    *
    * **When to use**
    *
-   * Use when aliases allow params to be specified with alternative names,
-   * typically single-character shortcuts like "-f" for "--force".
+   * Use when you need a CLI parameter to accept an alternate name, such as "-f"
+   * for "--force".
    *
    * **Details**
    *
@@ -1170,8 +1172,8 @@ export const withDescription: {
  *
  * **When to use**
  *
- * Use when experimental, internal, or deprecated flags that should be
- * accepted but not advertised.
+ * Use when experimental, internal, or deprecated flags should be accepted but
+ * not advertised.
  *
  * **Example** (Hiding a flag from help)
  *
@@ -1666,7 +1668,7 @@ export const withDefault: {
  *
  * **When to use**
  *
- * Use when config should provide a fallback source for required flags or
+ * Use when you need config to provide a fallback source for required flags or
  * arguments that are absent from CLI input.
  *
  * **Details**
@@ -1691,7 +1693,7 @@ export const withFallbackConfig: {
    *
    * **When to use**
    *
-   * Use when config should provide a fallback source for required flags or
+   * Use when you need config to provide a fallback source for required flags or
    * arguments that are absent from CLI input.
    *
    * **Details**
@@ -1716,7 +1718,7 @@ export const withFallbackConfig: {
    *
    * **When to use**
    *
-   * Use when config should provide a fallback source for required flags or
+   * Use when you need config to provide a fallback source for required flags or
    * arguments that are absent from CLI input.
    *
    * **Details**
@@ -1886,8 +1888,8 @@ export type VariadicParamOptions = {
  * **Details**
  *
  * This is the base combinator for creating parameters that accept multiple values.
- * The min and max parameters are optional - if not provided, the parameter can be
- * specified any number of times (0 to infinity).
+ * The `min` and `max` parameters are optional. When they are not provided, the
+ * parameter can be specified any number of times, from 0 to infinity.
  *
  * **Example** (Accepting multiple values)
  *
@@ -2250,7 +2252,8 @@ export const atLeast: {
  *
  * **When to use**
  *
- * Use when you use this combinator for validation and transformation in a single step.
+ * Use when you need validation and transformation in a single parameter
+ * combinator.
  *
  * **Example** (Filtering and transforming values)
  *
@@ -2277,7 +2280,8 @@ export const filterMap: {
    *
    * **When to use**
    *
-   * Use when you use this combinator for validation and transformation in a single step.
+   * Use when you need validation and transformation in a single parameter
+   * combinator.
    *
    * **Example** (Filtering and transforming values)
    *
@@ -2304,7 +2308,8 @@ export const filterMap: {
    *
    * **When to use**
    *
-   * Use when you use this combinator for validation and transformation in a single step.
+   * Use when you need validation and transformation in a single parameter
+   * combinator.
    *
    * **Example** (Filtering and transforming values)
    *

package/src/unstable/cli/Primitive.ts

@@ -728,7 +728,7 @@ export const keyValuePair: Primitive<Record<string, string>> = makePrimitive(
  *
  * **When to use**
  *
- * Use when you need flags that don't accept values.
+ * Use when you need a CLI primitive for flags that do not accept values.
  *
  * **Example** (Rejecting option values)
  *
@@ -754,7 +754,8 @@ export const none: Primitive<never> = makePrimitive("None", () => Effect.fail("T
  *
  * **When to use**
  *
- * Use when you need generating help documentation.
+ * Use when you need the display type name for a `Primitive`, such as when
+ * generating CLI help documentation.
  *
  * **Example** (Getting primitive type names)
  *

package/src/unstable/cluster/ClusterCron.ts

@@ -87,8 +87,7 @@ export const make = <E, R>(options: {
    *
    * **When to use**
    *
-   * Use when this is useful to prevent running jobs that were scheduled too far in the
-   * past.
+   * Use to prevent running jobs that were scheduled too far in the past.
    *
    * **Details**
    *

package/src/unstable/cluster/ClusterMetrics.ts

@@ -29,6 +29,11 @@ import * as Metric from "../../Metric.ts"
  * Creates a gauge tracking the number of active entity instances for each entity type on
  * the current runner.
  *
+ * **When to use**
+ *
+ * Use when instrumenting runner-local entity counts and tagging them by entity
+ * type for cluster dashboards.
+ *
  * **Details**
  *
  * Bigint gauge named `effect_cluster_entities`, updated with the entity type as

package/src/unstable/cluster/ClusterSchema.ts

@@ -71,7 +71,7 @@ export const Persisted = Context.Reference<boolean>("effect/cluster/ClusterSchem
  *
  * **When to use**
  *
- * Use when a request needs server-side handling or storage work wrapped in the
+ * Use when you need server-side request handling or storage work wrapped in the
  * storage transaction.
  *
  * **Details**
@@ -135,8 +135,8 @@ export const isUninterruptibleForServer = (context: Context.Context<never>): boo
  *
  * **When to use**
  *
- * Use when client-side cluster request handling needs to decide whether an
- * interrupt should be ignored.
+ * Use when you need client-side cluster request handling to decide whether to
+ * ignore an interrupt.
  *
  * **Details**
  *

package/src/unstable/cluster/ClusterWorkflowEngine.ts

@@ -120,11 +120,11 @@ export const make = Effect.gen(function*() {
     >
   >()
   const ensureEntity = (workflow: Workflow.Any) => {
-    let entity = entities.get(workflow.name)
+    let entity = entities.get(workflow._tag)
     if (!entity) {
       entity = makeWorkflowEntity(workflow) as any
-      workflows.set(workflow.name, workflow)
-      entities.set(workflow.name, entity as any)
+      workflows.set(workflow._tag, workflow)
+      entities.set(workflow._tag, entity as any)
     }
     return entity!
   }
@@ -248,7 +248,7 @@ export const make = Effect.gen(function*() {
     }) {
       const requestId = yield* requestIdFor({
         workflow: options.workflow,
-        entityType: `Workflow/${options.workflow.name}`,
+        entityType: `Workflow/${options.workflow._tag}`,
         executionId: options.executionId,
         tag: "activity",
         id: activityPrimaryKey(options.activity.name, options.attempt)
@@ -283,7 +283,7 @@ export const make = Effect.gen(function*() {
   const resume = Effect.fnUntraced(function*(workflow: Workflow.Any, executionId: string) {
     const maybeReply = yield* requestReply({
       workflow,
-      entityType: `Workflow/${workflow.name}`,
+      entityType: `Workflow/${workflow._tag}`,
       executionId,
       tag: "run",
       id: ""
@@ -324,7 +324,7 @@ export const make = Effect.gen(function*() {
       ensureEntity(workflow)
       const requestId = yield* requestIdFor({
         workflow,
-        entityType: `Workflow/${workflow.name}`,
+        entityType: `Workflow/${workflow._tag}`,
         executionId,
         tag: "run",
         id: ""
@@ -343,7 +343,7 @@ export const make = Effect.gen(function*() {
       }
 
       yield* engine.deferredDone(InterruptSignal, {
-        workflowName: workflow.name,
+        workflowName: workflow._tag,
         executionId,
         deferredName: InterruptSignal.name,
         exit: Exit.void
@@ -457,13 +457,13 @@ export const make = Effect.gen(function*() {
 
     execute: (workflow, { discard, executionId, parent, payload }) => {
       ensureEntity(workflow)
-      return RcMap.get(clients, workflow.name).pipe(
+      return RcMap.get(clients, workflow._tag).pipe(
         Effect.flatMap((make) =>
           make(executionId).run(
             parent ?
               {
                 ...payload,
-                [payloadParentKey]: { workflowName: parent.workflow.name, executionId: parent.executionId }
+                [payloadParentKey]: { workflowName: parent.workflow._tag, executionId: parent.executionId }
               } :
               payload,
             { discard }
@@ -479,7 +479,7 @@ export const make = Effect.gen(function*() {
       const exitSchema = Schema.toCodecJson(Rpc.exitSchema(entity.protocol.requests.get("run")!))
       const reply = yield* requestReply({
         workflow,
-        entityType: `Workflow/${workflow.name}`,
+        entityType: `Workflow/${workflow._tag}`,
         executionId,
         tag: "run",
         id: ""
@@ -505,7 +505,7 @@ export const make = Effect.gen(function*() {
             id: yield* sharding.getSnowflake,
             address: entityAddressFor({
               workflow,
-              entityType: `Workflow/${workflow.name}`,
+              entityType: `Workflow/${workflow._tag}`,
               executionId
             }),
             requestId: requestId.value
@@ -523,7 +523,7 @@ export const make = Effect.gen(function*() {
         const instance = Context.get(services, WorkflowEngine.WorkflowInstance)
         yield* Effect.annotateCurrentSpan("executionId", instance.executionId)
         const activityId = `${instance.executionId}/${activity.name}`
-        const client = (yield* RcMap.get(clientsPartial, instance.workflow.name))(instance.executionId)
+        const client = (yield* RcMap.get(clientsPartial, instance.workflow._tag))(instance.executionId)
         while (true) {
           if (!activities.has(activityId)) {
             activities.set(activityId, { activity, context: services })
@@ -563,7 +563,7 @@ export const make = Effect.gen(function*() {
         Effect.flatMap((instance) =>
           requestReply({
             workflow: instance.workflow,
-            entityType: `Workflow/${instance.workflow.name}`,
+            entityType: `Workflow/${instance.workflow._tag}`,
             executionId: instance.executionId,
             tag: "deferred",
             id: deferred.name
@@ -628,7 +628,7 @@ export const make = Effect.gen(function*() {
             }),
             payload: {
               name: options.clock.name,
-              workflowName: workflow.name,
+              workflowName: workflow._tag,
               wakeUp: DateTime.addDuration(now, options.clock.duration)
             }
           })
@@ -701,7 +701,7 @@ const ResumeRpc = Rpc.make("resume", {
 const payloadParentKey = "~effect/cluster/ClusterWorkflowEngine/payloadParentKey"
 
 const makeWorkflowEntity = (workflow: Workflow.Any) =>
-  Entity.make(`Workflow/${workflow.name}`, [
+  Entity.make(`Workflow/${workflow._tag}`, [
     Rpc.make("run", {
       payload: {
         ...workflow.payloadSchema.fields,

package/src/unstable/cluster/EntityResource.ts

@@ -71,6 +71,11 @@ export interface EntityResource<out A, out E = never> {
 /**
  * Context service for a Scope that is only closed when the resource is explicitly closed.
  *
+ * **When to use**
+ *
+ * Use when a cluster entity resource needs a scope that survives restarts and
+ * closes only through the resource lifecycle.
+ *
  * **Gotchas**
  *
  * It is not closed during restarts, due to shard movement or node shutdowns.
@@ -86,6 +91,11 @@ export class CloseScope extends Context.Service<
 /**
  * Creates an `EntityResource` that can be acquired inside a cluster entity.
  *
+ * **When to use**
+ *
+ * Use when a cluster entity should lazily share an acquired resource across
+ * messages and release it only on idle timeout or explicit close.
+ *
  * **Details**
  *
  * The resource will only be fully released when the idle time to live is

package/src/unstable/cluster/Envelope.ts

@@ -28,7 +28,7 @@ import * as Predicate from "../../Predicate.ts"
 import * as PrimaryKey from "../../PrimaryKey.ts"
 import type { ReadonlyRecord } from "../../Record.ts"
 import * as Schema from "../../Schema.ts"
-import * as Transformation from "../../SchemaTransformation.ts"
+import * as SchemaTransformation from "../../SchemaTransformation.ts"
 import * as Headers from "../http/Headers.ts"
 import type * as Rpc from "../rpc/Rpc.ts"
 import { EntityAddress } from "./EntityAddress.ts"
@@ -406,10 +406,10 @@ export const Request = Schema.declare(
  * @category serialization
  * @since 4.0.0
  */
-export const RequestTransform: Transformation.Transformation<
+export const RequestTransform: SchemaTransformation.Transformation<
   Request.Any,
   any
-> = Transformation.transform({
+> = SchemaTransformation.transform({
   decode: (u: any) => makeRequest(u),
   encode: (u) => u as any
 })

package/src/unstable/cluster/Reply.ts

@@ -30,9 +30,9 @@ import * as Exit from "../../Exit.ts"
 import * as Option from "../../Option.ts"
 import { hasProperty } from "../../Predicate.ts"
 import * as Schema from "../../Schema.ts"
-import * as Issue from "../../SchemaIssue.ts"
-import * as Parser from "../../SchemaParser.ts"
-import * as Transformation from "../../SchemaTransformation.ts"
+import * as SchemaIssue from "../../SchemaIssue.ts"
+import * as SchemaParser from "../../SchemaParser.ts"
+import * as SchemaTransformation from "../../SchemaTransformation.ts"
 import * as Rpc from "../rpc/Rpc.ts"
 import type * as RpcMessage from "../rpc/RpcMessage.ts"
 import type * as RpcSchema from "../rpc/RpcSchema.ts"
@@ -221,7 +221,7 @@ export class Chunk<R extends Rpc.Any> extends Data.TaggedClass("Chunk")<{
    *
    * @since 4.0.0
    */
-  static readonly transform: Transformation.Transformation<any, any> = Transformation.transform({
+  static readonly transform: SchemaTransformation.Transformation<any, any> = SchemaTransformation.transform({
     decode: (a: any) => new Chunk(a),
     encode: (a) => a as any
   })
@@ -254,10 +254,11 @@ export class Chunk<R extends Rpc.Any> extends Data.TaggedClass("Chunk")<{
       [success],
       ([success]) => (input, ast, options) => {
         if (!isReply(input) || input._tag !== "Chunk") {
-          return Effect.fail(new Issue.InvalidType(ast, Option.some(input)))
+          return Effect.fail(new SchemaIssue.InvalidType(ast, Option.some(input)))
         }
-        return Effect.mapBothEager(Parser.decodeEffect(Schema.NonEmptyArray(success))(input.values, options), {
-          onFailure: (issue) => new Issue.Composite(ast, Option.some(input), [new Issue.Pointer(["values"], issue)]),
+        return Effect.mapBothEager(SchemaParser.decodeEffect(Schema.NonEmptyArray(success))(input.values, options), {
+          onFailure: (issue) =>
+            new SchemaIssue.Composite(ast, Option.some(input), [new SchemaIssue.Pointer(["values"], issue)]),
           onSuccess: (values) => new Chunk({ ...input, values } as any)
         })
       },
@@ -272,7 +273,7 @@ export class Chunk<R extends Rpc.Any> extends Data.TaggedClass("Chunk")<{
               sequence: Schema.Number,
               values: Schema.NonEmptyArray(success)
             }),
-            Transformation.transform({
+            SchemaTransformation.transform({
               decode: (encoded) => new Chunk(encoded),
               encode: (result) => ({ ...result })
             })
@@ -359,10 +360,11 @@ export class WithExit<R extends Rpc.Any> extends Data.TaggedClass("WithExit")<{
       [exitSchema],
       ([exit]) => (input, ast, options) => {
         if (!isReply(input) || input._tag !== "WithExit") {
-          return Effect.fail(new Issue.InvalidType(ast, Option.some(input)))
+          return Effect.fail(new SchemaIssue.InvalidType(ast, Option.some(input)))
         }
-        return Effect.mapBothEager(Parser.decodeEffect(exit)(input.exit, options), {
-          onFailure: (issue) => new Issue.Composite(ast, Option.some(input), [new Issue.Pointer(["exit"], issue)]),
+        return Effect.mapBothEager(SchemaParser.decodeEffect(exit)(input.exit, options), {
+          onFailure: (issue) =>
+            new SchemaIssue.Composite(ast, Option.some(input), [new SchemaIssue.Pointer(["exit"], issue)]),
           onSuccess: (exit) => new WithExit({ ...input, exit: exit as any })
         })
       },
@@ -376,7 +378,7 @@ export class WithExit<R extends Rpc.Any> extends Data.TaggedClass("WithExit")<{
               id: SnowflakeFromBigInt,
               exit
             }),
-            Transformation.transform({
+            SchemaTransformation.transform({
               decode: (encoded) => new WithExit(encoded as any),
               encode: (result) => ({ ...result })
             })

package/src/unstable/cluster/RunnerHealth.ts

@@ -71,7 +71,8 @@ export class RunnerHealth extends Context.Service<
  *
  * **When to use**
  *
- * Use when tests or local development do not need active runner health checks.
+ * Use when you need a runner-health layer for tests or local development where
+ * active health checks are unnecessary.
  *
  * @category layers
  * @since 4.0.0

package/src/unstable/cluster/RunnerServer.ts

@@ -212,8 +212,8 @@ export const layerWithClients: Layer.Layer<
  *
  * **When to use**
  *
- * Use when you use this layer to embed a cluster client inside another Effect application
- * without registering with the ShardManager or receiving shard assignments.
+ * Use to embed a cluster client inside another Effect application without registering with
+ * the ShardManager or receiving shard assignments.
  *
  * @category layers
  * @since 4.0.0

package/src/unstable/cluster/Runners.ts

@@ -152,9 +152,9 @@ export class Runners extends Context.Service<Runners, {
  *
  * **When to use**
  *
- * Use to build a custom `Runners` service when you already have remote `ping`,
- * `send`, `notify`, and `onRunnerUnavailable` callbacks and want the standard
- * local persistence and reply recovery behavior added around them.
+ * Use when you need a custom `Runners` service around remote `ping`, `send`,
+ * `notify`, and `onRunnerUnavailable` callbacks, with standard local
+ * persistence and reply recovery behavior.
  *
  * **Details**
  *

package/src/unstable/cluster/ShardId.ts

@@ -29,7 +29,7 @@ import * as Hash from "../../Hash.ts"
 import { hasProperty } from "../../Predicate.ts"
 import * as PrimaryKey from "../../PrimaryKey.ts"
 import * as S from "../../Schema.ts"
-import * as Getter from "../../SchemaGetter.ts"
+import * as SchemaGetter from "../../SchemaGetter.ts"
 
 const TypeId = "~effect/cluster/ShardId"
 
@@ -69,8 +69,8 @@ export const ShardId = S.declare(isShardId, {
         id: S.Number
       }),
       {
-        decode: Getter.transform(({ group, id }) => make(group, id)),
-        encode: Getter.passthrough()
+        decode: SchemaGetter.transform(({ group, id }) => make(group, id)),
+        encode: SchemaGetter.passthrough()
       }
     )
 })

package/src/unstable/cluster/Sharding.ts

@@ -1487,9 +1487,9 @@ const make = Effect.gen(function*() {
  *
  * **When to use**
  *
- * Use when assembling a cluster sharding runtime from explicit sharding
- * configuration, runner communication, message storage, runner storage, and
- * runner health layers.
+ * Use when you need to assemble a cluster sharding runtime from explicit
+ * sharding configuration, runner communication, message storage, runner
+ * storage, and runner health layers.
  *
  * **Details**
  *

package/src/unstable/cluster/ShardingConfig.ts

@@ -203,10 +203,10 @@ export const defaults: ShardingConfig["Service"] = {
  *
  * **When to use**
  *
- * Use when wiring a cluster runner with explicit `ShardingConfig` values,
- * especially in tests, local development, or code paths where configuration
- * should be provided programmatically instead of loaded from environment
- * variables.
+ * Use when you need to wire a cluster runner with explicit `ShardingConfig`
+ * values, especially in tests, local development, or code paths where
+ * configuration should be provided programmatically instead of loaded from
+ * environment variables.
  *
  * **Details**
  *

package/src/unstable/cluster/Snowflake.ts

@@ -27,7 +27,7 @@ import * as Effect from "../../Effect.ts"
 import { identity } from "../../Function.ts"
 import * as Layer from "../../Layer.ts"
 import * as Schema from "../../Schema.ts"
-import * as Transformation from "../../SchemaTransformation.ts"
+import * as SchemaTransformation from "../../SchemaTransformation.ts"
 import type { MachineId } from "./MachineId.ts"
 
 /**
@@ -129,7 +129,7 @@ export interface SnowflakeFromString extends Schema.decodeTo<SnowflakeFromBigInt
  * @since 4.0.0
  */
 export const SnowflakeFromString: SnowflakeFromString = Schema.String.pipe(
-  Schema.decodeTo(SnowflakeFromBigInt, Transformation.bigintFromString)
+  Schema.decodeTo(SnowflakeFromBigInt, SchemaTransformation.bigintFromString)
 )
 
 /**
@@ -154,7 +154,7 @@ const constBigInt4096 = BigInt(4096)
  * **When to use**
  *
  * Use to pack known timestamp, machine id, and sequence parts into a branded
- * snowflake id when you already control id allocation.
+ * snowflake id.
  *
  * **Gotchas**
  *

package/src/unstable/cluster/internal/entityManager.ts

@@ -15,7 +15,7 @@ import * as Option from "../../../Option.ts"
 import { CurrentLogAnnotations } from "../../../References.ts"
 import * as Schedule from "../../../Schedule.ts"
 import * as Schema from "../../../Schema.ts"
-import * as Issue from "../../../SchemaIssue.ts"
+import * as SchemaIssue from "../../../SchemaIssue.ts"
 import * as Scope from "../../../Scope.ts"
 import type * as Rpc from "../../rpc/Rpc.ts"
 import { RequestId } from "../../rpc/RpcMessage.ts"
@@ -636,7 +636,7 @@ const makeMessageDecode = <Type extends string, Rpcs extends Rpc.Any>(
     if (!rpc) {
       return Effect.fail(
         new Schema.SchemaError(
-          new Issue.InvalidValue(Option.some(message), {
+          new SchemaIssue.InvalidValue(Option.some(message), {
             message: `Unknown tag ${message.envelope.tag} for entity type ${entity.type}`
           })
         )