Support max reasoning and compatible provider quota errors

[K-Mistele]

Summary

• accept max as a Responses API reasoning effort
• decode the flat { error, code } error payload used by OpenAI-compatible providers such as xAI
• classify HTTP 402 and billing_insufficient_balance responses as non-retryable quota exhaustion
• add focused request-schema and client error-mapping coverage

Context

@effect/ai-openai is also used with OpenAI-compatible endpoints. xAI can return billing errors as HTTP 402 with a flat { error: string, code?: string } body, or use the billing_insufficient_balance code. Without decoding that shape, the useful provider message and code are lost and the error is classified incorrectly.

I searched existing and merged PRs in the Effect repositories before opening this and did not find a proposal covering these cases.

Verification

• pnpm lint-fix
• pnpm test packages/ai/openai/test/OpenAiClient.test.ts packages/ai/openai/test/OpenAiSchema.test.ts
• pnpm check

[changeset-bot]

🦋 Changeset detected

Latest commit: 88ca9f9

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 30 packages

Name	Type
@effect/ai-openai	Patch
effect	Patch
@effect/ai-anthropic	Patch
@effect/ai-openai-compat	Patch
@effect/ai-openrouter	Patch
@effect/atom-react	Patch
@effect/atom-solid	Patch
@effect/atom-vue	Patch
@effect/docgen	Patch
@effect/doctest	Patch
@effect/openapi-generator	Patch
@effect/opentelemetry	Patch
@effect/platform-browser	Patch
@effect/platform-bun	Patch
@effect/platform-deno	Patch
@effect/platform-node	Patch
@effect/platform-node-shared	Patch
@effect/sql-clickhouse	Patch
@effect/sql-d1	Patch
@effect/sql-libsql	Patch
@effect/sql-mssql	Patch
@effect/sql-mysql2	Patch
@effect/sql-pg	Patch
@effect/sql-pglite	Patch
@effect/sql-sqlite-bun	Patch
@effect/sql-sqlite-do	Patch
@effect/sql-sqlite-node	Patch
@effect/sql-sqlite-react-native	Patch
@effect/sql-sqlite-wasm	Patch
@effect/vitest	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[github-actions]

Bundle Size Analysis

Generated from PR build output; treat the content below as untrusted.

File Name	Current Size	Previous Size	Difference
basic.ts	6.96 KB	6.96 KB	0.00 KB (0.00%)
batching.ts	9.76 KB	9.76 KB	0.00 KB (0.00%)
brand.ts	6.55 KB	6.55 KB	0.00 KB (0.00%)
cache.ts	10.67 KB	10.67 KB	0.00 KB (0.00%)
config.ts	21.10 KB	21.10 KB	0.00 KB (0.00%)
differ.ts	20.04 KB	20.04 KB	0.00 KB (0.00%)
http-client.ts	21.64 KB	21.64 KB	0.00 KB (0.00%)
logger.ts	10.91 KB	10.91 KB	0.00 KB (0.00%)
metric.ts	8.89 KB	8.89 KB	0.00 KB (0.00%)
optic.ts	6.71 KB	6.71 KB	0.00 KB (0.00%)
pubsub.ts	14.94 KB	14.94 KB	0.00 KB (0.00%)
queue.ts	11.61 KB	11.61 KB	0.00 KB (0.00%)
schedule.ts	10.77 KB	10.77 KB	0.00 KB (0.00%)
schema-class.ts	19.66 KB	19.66 KB	0.00 KB (0.00%)
schema-fromJsonSchemaDocument.ts	29.61 KB	29.61 KB	0.00 KB (0.00%)
schema-representation-roundtrip.ts	25.85 KB	25.85 KB	0.00 KB (0.00%)
schema-string-transformation.ts	13.53 KB	13.53 KB	0.00 KB (0.00%)
schema-string.ts	11.03 KB	11.03 KB	0.00 KB (0.00%)
schema-template-literal.ts	15.33 KB	15.33 KB	0.00 KB (0.00%)
schema-toArbitrary.ts	21.78 KB	21.78 KB	0.00 KB (0.00%)
schema-toCodeDocument.ts	24.21 KB	24.21 KB	0.00 KB (0.00%)
schema-toCodecJson.ts	19.00 KB	19.00 KB	0.00 KB (0.00%)
schema-toEquivalence.ts	18.82 KB	18.82 KB	0.00 KB (0.00%)
schema-toFormatter.ts	18.69 KB	18.69 KB	0.00 KB (0.00%)
schema-toJsonSchemaDocument.ts	22.85 KB	22.85 KB	0.00 KB (0.00%)
schema-toRepresentation.ts	19.33 KB	19.33 KB	0.00 KB (0.00%)
schema.ts	18.91 KB	18.91 KB	0.00 KB (0.00%)
stm.ts	12.69 KB	12.69 KB	0.00 KB (0.00%)
stream.ts	9.71 KB	9.71 KB	0.00 KB (0.00%)