@opencode/ai 2.0.19 → 2.0.20

package/dist/protocols/openai-responses.d.ts

@@ -291,8 +291,8 @@ export declare const protocol: Protocol<{
         } | {
             readonly type: "input_file";
             readonly filename: string;
-            readonly file_data?: string | undefined;
             readonly detail?: string | undefined;
+            readonly file_data?: string | undefined;
             readonly file_url?: string | undefined;
         } | {
             readonly type: "input_text";
@@ -328,8 +328,8 @@ export declare const protocol: Protocol<{
         } | {
             readonly type: "input_file";
             readonly filename: string;
-            readonly file_data?: string | undefined;
             readonly detail?: string | undefined;
+            readonly file_data?: string | undefined;
             readonly file_url?: string | undefined;
         } | {
             readonly type: "input_text";
@@ -450,21 +450,10 @@ export declare const protocol: Protocol<{
     readonly [x: string]: unknown;
     readonly type: string;
     readonly status?: unknown;
-    readonly code?: unknown;
     readonly message?: unknown;
+    readonly code?: unknown;
     readonly text?: string | undefined;
     readonly error?: unknown;
-    readonly item?: {
-        readonly [x: string]: unknown;
-        readonly type: string;
-        readonly id?: string | undefined;
-        readonly name?: string | undefined;
-        readonly namespace?: string | undefined;
-        readonly arguments?: string | undefined;
-        readonly encrypted_content?: string | null | undefined;
-        readonly call_id?: string | undefined;
-    } | null | undefined;
-    readonly delta?: string | undefined;
     readonly response?: {
         readonly [x: string]: unknown;
         readonly id?: string | undefined;
@@ -496,6 +485,17 @@ export declare const protocol: Protocol<{
             readonly reason?: string | undefined;
         } | null | undefined;
     } | undefined;
+    readonly item?: {
+        readonly [x: string]: unknown;
+        readonly type: string;
+        readonly id?: string | undefined;
+        readonly name?: string | undefined;
+        readonly namespace?: string | undefined;
+        readonly arguments?: string | undefined;
+        readonly encrypted_content?: string | null | undefined;
+        readonly call_id?: string | undefined;
+    } | null | undefined;
+    readonly delta?: string | undefined;
     readonly arguments?: string | undefined;
     readonly item_id?: string | undefined;
     readonly output_index?: number | undefined;
@@ -574,8 +574,8 @@ export declare const httpTransport: HttpTransport.HttpJsonTransport<{
         } | {
             readonly type: "input_file";
             readonly filename: string;
-            readonly file_data?: string | undefined;
             readonly detail?: string | undefined;
+            readonly file_data?: string | undefined;
             readonly file_url?: string | undefined;
         } | {
             readonly type: "input_text";
@@ -611,8 +611,8 @@ export declare const httpTransport: HttpTransport.HttpJsonTransport<{
         } | {
             readonly type: "input_file";
             readonly filename: string;
-            readonly file_data?: string | undefined;
             readonly detail?: string | undefined;
+            readonly file_data?: string | undefined;
             readonly file_url?: string | undefined;
         } | {
             readonly type: "input_text";
@@ -802,8 +802,8 @@ export declare const channelTransport: (options: import("./open-responses-channe
         } | {
             readonly type: "input_file";
             readonly filename: string;
-            readonly file_data?: string | undefined;
             readonly detail?: string | undefined;
+            readonly file_data?: string | undefined;
             readonly file_url?: string | undefined;
         } | {
             readonly type: "input_text";
@@ -839,8 +839,8 @@ export declare const channelTransport: (options: import("./open-responses-channe
         } | {
             readonly type: "input_file";
             readonly filename: string;
-            readonly file_data?: string | undefined;
             readonly detail?: string | undefined;
+            readonly file_data?: string | undefined;
             readonly file_url?: string | undefined;
         } | {
             readonly type: "input_text";
@@ -1030,8 +1030,8 @@ export declare const transport: import("../route/transport/index.js").Transport<
         } | {
             readonly type: "input_file";
             readonly filename: string;
-            readonly file_data?: string | undefined;
             readonly detail?: string | undefined;
+            readonly file_data?: string | undefined;
             readonly file_url?: string | undefined;
         } | {
             readonly type: "input_text";
@@ -1067,8 +1067,8 @@ export declare const transport: import("../route/transport/index.js").Transport<
         } | {
             readonly type: "input_file";
             readonly filename: string;
-            readonly file_data?: string | undefined;
             readonly detail?: string | undefined;
+            readonly file_data?: string | undefined;
             readonly file_url?: string | undefined;
         } | {
             readonly type: "input_text";
@@ -1258,8 +1258,8 @@ export declare const route: Route<{
         } | {
             readonly type: "input_file";
             readonly filename: string;
-            readonly file_data?: string | undefined;
             readonly detail?: string | undefined;
+            readonly file_data?: string | undefined;
             readonly file_url?: string | undefined;
         } | {
             readonly type: "input_text";
@@ -1295,8 +1295,8 @@ export declare const route: Route<{
         } | {
             readonly type: "input_file";
             readonly filename: string;
-            readonly file_data?: string | undefined;
             readonly detail?: string | undefined;
+            readonly file_data?: string | undefined;
             readonly file_url?: string | undefined;
         } | {
             readonly type: "input_text";

package/dist/protocols/utils/claude-model.d.ts

@@ -0,0 +1,8 @@
+import type { LLMRequest } from "../../schema/index.js";
+export declare const THINKING_BINDING_BETA = "thinking-binding-controls-2026-08-01";
+export declare const claudeVersion: (id: string) => {
+    family: string;
+    major: number;
+    minor: number;
+} | undefined;
+export declare const supportsThinkingBlockBinding: (model: LLMRequest["model"]) => boolean;

package/dist/protocols/utils/claude-model.js

@@ -0,0 +1,15 @@
+export const THINKING_BINDING_BETA = "thinking-binding-controls-2026-08-01";
+// Accept gateway namespaces and Vertex suffixes without treating a snapshot date as a minor version.
+export const claudeVersion = (id) => {
+    const match = /(?:^|[./])claude-(?<family>[a-z]+)-(?<major>\d+)(?:[.-](?<minor>\d{1,2}))?(?:$|[-:@])/.exec(id.toLowerCase())?.groups;
+    if (!match)
+        return undefined;
+    return { family: match.family, major: Number(match.major), minor: Number(match.minor ?? 0) };
+};
+export const supportsThinkingBlockBinding = (model) => {
+    const override = model.compatibility?.supportsThinkingBlockBinding;
+    if (override !== undefined)
+        return override;
+    const version = claudeVersion(model.id);
+    return version !== undefined && (version.major > 5 || (version.major === 5 && version.minor >= 1));
+};

package/dist/protocols/utils/tool-stream.d.ts

@@ -236,8 +236,8 @@ export declare const finish: <K extends StreamKey>(route: string, tools: State<K
     } | {
         readonly id: string;
         readonly type: "tool-error";
-        readonly name: string;
         readonly message: string;
+        readonly name: string;
         readonly error?: unknown;
         readonly providerMetadata?: {
             readonly [x: string]: {
@@ -459,8 +459,8 @@ export declare const finishWithInput: <K extends StreamKey>(route: string, tools
     } | {
         readonly id: string;
         readonly type: "tool-error";
-        readonly name: string;
         readonly message: string;
+        readonly name: string;
         readonly error?: unknown;
         readonly providerMetadata?: {
             readonly [x: string]: {
@@ -679,8 +679,8 @@ export declare const finishAll: <K extends StreamKey>(route: string, tools: Stat
     } | {
         readonly id: string;
         readonly type: "tool-error";
-        readonly name: string;
         readonly message: string;
+        readonly name: string;
         readonly error?: unknown;
         readonly providerMetadata?: {
             readonly [x: string]: {

package/dist/protocols/xai-responses.d.ts

@@ -67,8 +67,8 @@ export declare const protocol: Protocol<{
         } | {
             readonly type: "input_file";
             readonly filename: string;
-            readonly file_data?: string | undefined;
             readonly detail?: string | undefined;
+            readonly file_data?: string | undefined;
             readonly file_url?: string | undefined;
         } | {
             readonly type: "input_text";
@@ -104,8 +104,8 @@ export declare const protocol: Protocol<{
         } | {
             readonly type: "input_file";
             readonly filename: string;
-            readonly file_data?: string | undefined;
             readonly detail?: string | undefined;
+            readonly file_data?: string | undefined;
             readonly file_url?: string | undefined;
         } | {
             readonly type: "input_text";
@@ -184,21 +184,10 @@ export declare const protocol: Protocol<{
     readonly [x: string]: unknown;
     readonly type: string;
     readonly status?: unknown;
-    readonly code?: unknown;
     readonly message?: unknown;
+    readonly code?: unknown;
     readonly text?: string | undefined;
     readonly error?: unknown;
-    readonly item?: {
-        readonly [x: string]: unknown;
-        readonly type: string;
-        readonly id?: string | undefined;
-        readonly name?: string | undefined;
-        readonly namespace?: string | undefined;
-        readonly arguments?: string | undefined;
-        readonly encrypted_content?: string | null | undefined;
-        readonly call_id?: string | undefined;
-    } | null | undefined;
-    readonly delta?: string | undefined;
     readonly response?: {
         readonly [x: string]: unknown;
         readonly id?: string | undefined;
@@ -230,6 +219,17 @@ export declare const protocol: Protocol<{
             readonly reason?: string | undefined;
         } | null | undefined;
     } | undefined;
+    readonly item?: {
+        readonly [x: string]: unknown;
+        readonly type: string;
+        readonly id?: string | undefined;
+        readonly name?: string | undefined;
+        readonly namespace?: string | undefined;
+        readonly arguments?: string | undefined;
+        readonly encrypted_content?: string | null | undefined;
+        readonly call_id?: string | undefined;
+    } | null | undefined;
+    readonly delta?: string | undefined;
     readonly arguments?: string | undefined;
     readonly item_id?: string | undefined;
     readonly output_index?: number | undefined;

package/dist/provider-error.d.ts

@@ -7,6 +7,7 @@ export declare const isContextOverflowFailure: (failure: unknown) => boolean;
  * not deliver an accepted write, and unrecognized failures. Callers decide which calls are safe to repeat.
  */
 export declare const isRetryable: (error: AIError) => boolean;
+export declare const providerErrorMessage: (body: string) => string | undefined;
 export interface ProviderFailure {
     readonly message: string;
     readonly status?: number | undefined;

package/dist/provider-error.js

@@ -1,4 +1,4 @@
-import { Option, Schema } from "effect";
+import { Option, Schema, SchemaGetter } from "effect";
 import { AuthenticationError, ContentPolicyError, InvalidRequestError, AIError, ProviderErrorEvent, ProviderInternalError, QuotaExceededError, RateLimitError, UnknownProviderError, } from "./schema/index.js";
 const patterns = [
     /prompt is too long/i,
@@ -130,6 +130,24 @@ const QUOTA_TEXT = /insufficient[-_\s]?quota|quota[-_\s]?exceeded|budget exceede
 // under `invalid_request_error`.
 const CONTENT_POLICY_TEXT = /violating our usage policy|blocked by content filtering policy|content[-_\s]?policy|rejected as a result of our safety system/i;
 const SERVER_ERROR_TEXT = /\b(?:try again|(?:please |you can )?retry (?:the |this |your )?request|try (?:the |this |your )?request again|(?:currently |temporarily )?at capacity|overloaded|temporarily unavailable|service[-_\s]?unavailable|(?:server|internal)[-_\s]?error|server (?:is )?busy|provider returned (?:an )?error|resource[-_\s]?exhausted|upstream (?:connect|connection|request)|request buffer limit while retrying upstream)\b/i;
+const Message = Schema.String.check(Schema.isPattern(/\S/));
+const messageAt = (fields, message) => Schema.Struct(fields).pipe(Schema.decodeTo(Schema.String, {
+    decode: SchemaGetter.transform(message),
+    encode: SchemaGetter.forbidden(() => "Provider error messages are decode-only"),
+}));
+// Common error body layouts that carry a human-readable message, in priority order.
+// Provider-specific layouts belong in their protocol.
+const decodeMessage = Schema.decodeUnknownOption(Schema.fromJsonString(Schema.Union([
+    messageAt({ error: Schema.Struct({ message: Message }) }, (body) => body.error.message),
+    messageAt({ error: Message }, (body) => body.error),
+    messageAt({ message: Message }, (body) => body.message),
+    // AWS services
+    messageAt({ Message: Message }, (body) => body.Message),
+    // RFC 9457 problem details
+    messageAt({ detail: Message }, (body) => body.detail),
+    messageAt({ errors: Schema.NonEmptyArray(Schema.Struct({ message: Message })) }, (body) => body.errors[0].message),
+])));
+export const providerErrorMessage = (body) => Option.getOrUndefined(decodeMessage(body));
 // Classification records affirmative evidence about a failure. Deterministic
 // failures need positive identification (a 4xx status, quota/auth/policy
 // signals); anything unrecognized stays UnknownProvider, which the session

package/dist/providers/alibaba.d.ts

@@ -487,8 +487,8 @@ export declare const routes: (Route<{
         } | {
             readonly type: "input_file";
             readonly filename: string;
-            readonly file_data?: string | undefined;
             readonly detail?: string | undefined;
+            readonly file_data?: string | undefined;
             readonly file_url?: string | undefined;
         } | {
             readonly type: "input_text";
@@ -524,8 +524,8 @@ export declare const routes: (Route<{
         } | {
             readonly type: "input_file";
             readonly filename: string;
-            readonly file_data?: string | undefined;
             readonly detail?: string | undefined;
+            readonly file_data?: string | undefined;
             readonly file_url?: string | undefined;
         } | {
             readonly type: "input_text";

package/dist/providers/amazon-bedrock-mantle.d.ts

@@ -208,8 +208,8 @@ export declare const routes: (Route<{
         } | {
             readonly type: "input_file";
             readonly filename: string;
-            readonly file_data?: string | undefined;
             readonly detail?: string | undefined;
+            readonly file_data?: string | undefined;
             readonly file_url?: string | undefined;
         } | {
             readonly type: "input_text";
@@ -245,8 +245,8 @@ export declare const routes: (Route<{
         } | {
             readonly type: "input_file";
             readonly filename: string;
-            readonly file_data?: string | undefined;
             readonly detail?: string | undefined;
+            readonly file_data?: string | undefined;
             readonly file_url?: string | undefined;
         } | {
             readonly type: "input_text";

package/dist/providers/azure.d.ts

@@ -93,8 +93,8 @@ declare const responsesRoute: Route<{
         } | {
             readonly type: "input_file";
             readonly filename: string;
-            readonly file_data?: string | undefined;
             readonly detail?: string | undefined;
+            readonly file_data?: string | undefined;
             readonly file_url?: string | undefined;
         } | {
             readonly type: "input_text";
@@ -130,8 +130,8 @@ declare const responsesRoute: Route<{
         } | {
             readonly type: "input_file";
             readonly filename: string;
-            readonly file_data?: string | undefined;
             readonly detail?: string | undefined;
+            readonly file_data?: string | undefined;
             readonly file_url?: string | undefined;
         } | {
             readonly type: "input_text";
@@ -438,8 +438,8 @@ export declare const routes: (Route<{
         } | {
             readonly type: "input_file";
             readonly filename: string;
-            readonly file_data?: string | undefined;
             readonly detail?: string | undefined;
+            readonly file_data?: string | undefined;
             readonly file_url?: string | undefined;
         } | {
             readonly type: "input_text";
@@ -475,8 +475,8 @@ export declare const routes: (Route<{
         } | {
             readonly type: "input_file";
             readonly filename: string;
-            readonly file_data?: string | undefined;
             readonly detail?: string | undefined;
+            readonly file_data?: string | undefined;
             readonly file_url?: string | undefined;
         } | {
             readonly type: "input_text";

package/dist/providers/cloudflare-ai-gateway.d.ts

@@ -99,8 +99,8 @@ export declare const responsesRoute: import("../route/client.js").Route<{
         } | {
             readonly type: "input_file";
             readonly filename: string;
-            readonly file_data?: string | undefined;
             readonly detail?: string | undefined;
+            readonly file_data?: string | undefined;
             readonly file_url?: string | undefined;
         } | {
             readonly type: "input_text";
@@ -136,8 +136,8 @@ export declare const responsesRoute: import("../route/client.js").Route<{
         } | {
             readonly type: "input_file";
             readonly filename: string;
-            readonly file_data?: string | undefined;
             readonly detail?: string | undefined;
+            readonly file_data?: string | undefined;
             readonly file_url?: string | undefined;
         } | {
             readonly type: "input_text";
@@ -1106,8 +1106,8 @@ export declare const routes: (import("../route/client.js").Route<{
         } | {
             readonly type: "input_file";
             readonly filename: string;
-            readonly file_data?: string | undefined;
             readonly detail?: string | undefined;
+            readonly file_data?: string | undefined;
             readonly file_url?: string | undefined;
         } | {
             readonly type: "input_text";
@@ -1143,8 +1143,8 @@ export declare const routes: (import("../route/client.js").Route<{
         } | {
             readonly type: "input_file";
             readonly filename: string;
-            readonly file_data?: string | undefined;
             readonly detail?: string | undefined;
+            readonly file_data?: string | undefined;
             readonly file_url?: string | undefined;
         } | {
             readonly type: "input_text";

package/dist/providers/google-vertex-responses.d.ts

@@ -84,8 +84,8 @@ export declare const routes: Route<{
         } | {
             readonly type: "input_file";
             readonly filename: string;
-            readonly file_data?: string | undefined;
             readonly detail?: string | undefined;
+            readonly file_data?: string | undefined;
             readonly file_url?: string | undefined;
         } | {
             readonly type: "input_text";
@@ -121,8 +121,8 @@ export declare const routes: Route<{
         } | {
             readonly type: "input_file";
             readonly filename: string;
-            readonly file_data?: string | undefined;
             readonly detail?: string | undefined;
+            readonly file_data?: string | undefined;
             readonly file_url?: string | undefined;
         } | {
             readonly type: "input_text";

package/dist/providers/meta.d.ts

@@ -220,8 +220,8 @@ export declare const routes: (Route<{
         } | {
             readonly type: "input_file";
             readonly filename: string;
-            readonly file_data?: string | undefined;
             readonly detail?: string | undefined;
+            readonly file_data?: string | undefined;
             readonly file_url?: string | undefined;
         } | {
             readonly type: "input_text";
@@ -257,8 +257,8 @@ export declare const routes: (Route<{
         } | {
             readonly type: "input_file";
             readonly filename: string;
-            readonly file_data?: string | undefined;
             readonly detail?: string | undefined;
+            readonly file_data?: string | undefined;
             readonly file_url?: string | undefined;
         } | {
             readonly type: "input_text";
@@ -547,11 +547,15 @@ export declare const routes: (Route<{
             readonly timezone?: string | undefined;
         } | undefined;
     } | {
-        readonly name: string;
         readonly description: string;
+        readonly name: string;
         readonly input_schema: {
             readonly [x: string]: unknown;
         };
+        readonly cache_control?: {
+            readonly type: "ephemeral";
+            readonly ttl?: "1h" | "5m" | undefined;
+        } | undefined;
     })[] | undefined;
     readonly system?: readonly {
         readonly type: "text";

package/dist/providers/minimax.d.ts

@@ -372,8 +372,8 @@ export declare const routes: (Route<{
         } | {
             readonly type: "input_file";
             readonly filename: string;
-            readonly file_data?: string | undefined;
             readonly detail?: string | undefined;
+            readonly file_data?: string | undefined;
             readonly file_url?: string | undefined;
         } | {
             readonly type: "input_text";
@@ -409,8 +409,8 @@ export declare const routes: (Route<{
         } | {
             readonly type: "input_file";
             readonly filename: string;
-            readonly file_data?: string | undefined;
             readonly detail?: string | undefined;
+            readonly file_data?: string | undefined;
             readonly file_url?: string | undefined;
         } | {
             readonly type: "input_text";

package/dist/providers/moonshot.d.ts

@@ -370,8 +370,8 @@ export declare const routes: (Route<{
         } | {
             readonly type: "input_file";
             readonly filename: string;
-            readonly file_data?: string | undefined;
             readonly detail?: string | undefined;
+            readonly file_data?: string | undefined;
             readonly file_url?: string | undefined;
         } | {
             readonly type: "input_text";
@@ -407,8 +407,8 @@ export declare const routes: (Route<{
         } | {
             readonly type: "input_file";
             readonly filename: string;
-            readonly file_data?: string | undefined;
             readonly detail?: string | undefined;
+            readonly file_data?: string | undefined;
             readonly file_url?: string | undefined;
         } | {
             readonly type: "input_text";

package/dist/providers/openai-compatible-responses.d.ts

@@ -82,8 +82,8 @@ export declare const routes: import("../route/client.js").Route<{
         } | {
             readonly type: "input_file";
             readonly filename: string;
-            readonly file_data?: string | undefined;
             readonly detail?: string | undefined;
+            readonly file_data?: string | undefined;
             readonly file_url?: string | undefined;
         } | {
             readonly type: "input_text";
@@ -119,8 +119,8 @@ export declare const routes: import("../route/client.js").Route<{
         } | {
             readonly type: "input_file";
             readonly filename: string;
-            readonly file_data?: string | undefined;
             readonly detail?: string | undefined;
+            readonly file_data?: string | undefined;
             readonly file_url?: string | undefined;
         } | {
             readonly type: "input_text";

package/dist/providers/openai.d.ts

@@ -196,8 +196,8 @@ export declare const routes: (Route<{
         } | {
             readonly type: "input_file";
             readonly filename: string;
-            readonly file_data?: string | undefined;
             readonly detail?: string | undefined;
+            readonly file_data?: string | undefined;
             readonly file_url?: string | undefined;
         } | {
             readonly type: "input_text";
@@ -233,8 +233,8 @@ export declare const routes: (Route<{
         } | {
             readonly type: "input_file";
             readonly filename: string;
-            readonly file_data?: string | undefined;
             readonly detail?: string | undefined;
+            readonly file_data?: string | undefined;
             readonly file_url?: string | undefined;
         } | {
             readonly type: "input_text";

package/dist/providers/zai-coding-plan.d.ts

@@ -86,8 +86,8 @@ export declare const routes: (Route<{
         } | {
             readonly type: "input_file";
             readonly filename: string;
-            readonly file_data?: string | undefined;
             readonly detail?: string | undefined;
+            readonly file_data?: string | undefined;
             readonly file_url?: string | undefined;
         } | {
             readonly type: "input_text";
@@ -123,8 +123,8 @@ export declare const routes: (Route<{
         } | {
             readonly type: "input_file";
             readonly filename: string;
-            readonly file_data?: string | undefined;
             readonly detail?: string | undefined;
+            readonly file_data?: string | undefined;
             readonly file_url?: string | undefined;
         } | {
             readonly type: "input_text";

package/dist/route/client.d.ts

@@ -374,8 +374,8 @@ export declare const streamRequest: (request: LLMRequest, options?: StreamOption
 } | {
     readonly id: string;
     readonly type: "tool-error";
-    readonly name: string;
     readonly message: string;
+    readonly name: string;
     readonly error?: unknown;
     readonly providerMetadata?: {
         readonly [x: string]: {

package/dist/route/executor.js

@@ -1,7 +1,7 @@
 import { Cause, Effect, Layer, Option, Schema, Stream } from "effect";
 import { FetchHttpClient, Headers, HttpClient, HttpClientError, HttpClientRequest, HttpClientResponse, } from "effect/unstable/http";
 import { HttpContext, HttpRateLimitDetails, AIError, TransportError } from "../schema/index.js";
-import { classifyProviderFailure } from "../provider-error.js";
+import { classifyProviderFailure, providerErrorMessage } from "../provider-error.js";
 import { Service } from "./executor-service.js";
 export { Service } from "./executor-service.js";
 const headerDetails = (headers) => Object.fromEntries(Object.entries(headers).map(([name, value]) => [name, String(value)]));
@@ -65,14 +65,18 @@ export const responseHttp = (response) => new HttpContext({
     status: response.status,
     headers: headerDetails(response.headers),
 });
-const decodeProviderBody = Schema.decodeUnknownOption(Schema.fromJsonString(Schema.Struct({
-    message: Schema.optionalKey(Schema.String),
-    error: Schema.optionalKey(Schema.Struct({ message: Schema.optionalKey(Schema.String) })),
-})));
+const MAX_BODY_CHARS = 2000;
+// Without a recognized message, show the raw body so the provider's explanation is never dropped.
 const providerMessage = (status, body) => {
-    const decoded = body === undefined ? undefined : Option.getOrUndefined(decodeProviderBody(body));
-    return ([decoded?.error?.message, decoded?.message].find((message) => message?.trim()) ??
-        `Provider request failed with HTTP ${status}`);
+    const fallback = `Provider request failed with HTTP ${status}`;
+    const text = body?.trim() ?? "";
+    const message = providerErrorMessage(text);
+    if (message)
+        return message;
+    // Gateway and proxy HTML error pages are markup, not an explanation.
+    if (!text || /^<(?:!doctype|html)/i.test(text))
+        return fallback;
+    return `${fallback}: ${text.length > MAX_BODY_CHARS ? `${text.slice(0, MAX_BODY_CHARS)}…` : text}`;
 };
 const statusError = (response) => Effect.gen(function* () {
     if (response.status < 400)