Class InvalidOutputError

packages/effect/src/unstable/ai/AiError.ts:695–746

 * @since 4.0.0
 */
export class InvalidOutputError extends Schema.Error<InvalidOutputError>(
  "effect/ai/AiError/InvalidOutputError"
)({
  _tag: Schema.tag("InvalidOutputError"),
  description: Schema.String,
  metadata: providerMetadataWithDefaults<InvalidOutputErrorMetadata>(),
  usage: Schema.optional(UsageInfo)
}) {
  /**
   * Marks `InvalidOutputError` as a semantic AI error reason for runtime guards.
   *
   * @since 4.0.0
   */
  readonly [ReasonTypeId] = ReasonTypeId

  /**
   * Invalid output errors are retryable since LLM outputs are non-deterministic.
   *
   * @since 4.0.0
   */
  get isRetryable(): boolean {
    return true
  }

  /**
   * Creates an InvalidOutputError from a Schema error.
   *
   * **Example** (Creating an invalid output error from a schema error)
   *
   * ```ts import.meta.vitest
   * import { Effect, Schema } from "effect"
   * import { AiError } from "effect/unstable/ai"
   *
   * const schemaError = await Effect.runPromise(
   *   Schema.decodeUnknownEffect(Schema.Number)("not a number").pipe(Effect.flip)
   * )
   * const parseError = AiError.InvalidOutputError.fromSchemaError(schemaError)
   * parseError.description // => "Expected number"
   * ```
   *
   * @since 4.0.0
   */
  static fromSchemaError(error: Schema.SchemaError): InvalidOutputError {
    return new InvalidOutputError({
      description: error.message
    })
  }

  override get message(): string {
    return `Invalid output: ${this.description}`
  }
}

/**
 * Error indicating the LLM generated text that does not conform to the