sailfork / t3code-github / .repos/ effect/ migration/ annotations/ effect__ai__AiError.yaml

"@effect/ai/AiError#AiError":
  replacement: "AiError.AiError"
  note: "Moved to effect/ai/AiError and redesigned from a union of separately tagged errors into one AiError wrapper with a semantic reason. Construct it with AiError.make({ module, method, reason }) and match error.reason rather than the old top-level tags."
"@effect/ai/AiError#HttpRequestError":
  replacement: "AiError.make + AiError.NetworkError"
  note: "Replace the old top-level request error with an AiError whose reason is NetworkError. NetworkError.fromRequestError converts a v4 HttpClientError.RequestError."
"@effect/ai/AiError#HttpResponseError":
  replacement: "AiError.make + AiError.reasonFromHttpStatus / AiError.InvalidResponseError / AiError.InvalidOutputError"
  note: "There is no single v4 response-error class. Wrap a semantic reason with AiError.make: use reasonFromHttpStatus for status failures. Provider response-schema and SSE decoding failures use non-retryable InvalidResponseError. Lower-level HTTP client DecodeError and EmptyBodyError still map to retryable InvalidOutputError in provider adapters."
"@effect/ai/AiError#MalformedInput":
  replacement: "AiError.make + AiError.InvalidUserInputError"
  note: "Replace the old top-level input error with an AiError whose reason is InvalidUserInputError. Use InvalidRequestError when the provider request parameters themselves are malformed."
"@effect/ai/AiError#MalformedOutput":
  replacement: "AiError.make + AiError.InvalidOutputError / AiError.InvalidResponseError"
  note: "Replace the old top-level output error with an AiError wrapper. Use retryable InvalidOutputError for invalid model-generated output and non-retryable InvalidResponseError for incompatible provider response formats, including response-schema and SSE decoding failures. Replace fromParseError with InvalidOutputError.fromSchemaError or InvalidResponseError.fromSchemaError according to what was being decoded; pass module and method to AiError.make."
"@effect/ai/AiError#TypeId":
  replacement: "AiError.isAiError"
  note: "The AiError brand is private in v4. Use isAiError for runtime narrowing, or isAiErrorReason for a reason, instead of inspecting or constructing the type id."
"@effect/ai/AiError#UnknownError":
  replacement: "AiError.make + AiError.UnknownError"
  note: "UnknownError is now a semantic reason rather than a top-level error. Put module and method on AiError.make and inspect reason._tag when handling the outer AiError."
"@effect/ai/AiError#HttpRequestDetails":
  replacement: none
  note: "Removed. NetworkError carries only the request method and url, and HttpContext and response metadata parts no longer record the request."