@x12i/ai-dispatcher 2.3.0 → 2.3.1

package/README.md

@@ -4,7 +4,7 @@ One request shape for OpenRouter, AWS Bedrock, the OpenAI Responses API, and Clo
 
 **Implemented providers:** `openrouter`, `bedrock`, `openai`, `cloudflare`. Any other provider throws `PROVIDER_NOT_IMPLEMENTED`.
 
-The package is `@x12i/ai-dispatcher` 2.3.0. It runs on Node 20 or newer and publishes ESM and CommonJS from the same entry.
+The package is `@x12i/ai-dispatcher` 2.3.1. It runs on Node 20 or newer and publishes ESM and CommonJS from the same entry.
 
 Connected MCP servers can be passed to `createAiDispatcher`. `run()` and `compile()` expose those tools to the model. `executeStreamingChat` does not. Details are in [MCP tools](#mcp-tools).
 
@@ -446,6 +446,17 @@ await dispatcher.run({
 
 Cloudflare supports the same `run`, `compile`, and `executeStreamingChat` entrypoints. `executeStreamingChat` rejects `/ai/run`. `reasoningEffort` uses the OpenAI or OpenRouter catalog, as described above. `cache` sets AI Gateway headers and, for GPT on Responses and Claude on Messages, the native breakpoint. Local function tools and MCP tools follow the OpenAI loop. OpenRouter server tools are rejected. `rawOpenRouterOverrides` is rejected except for a `metadata` object, which is folded into `metadata`. `responseFormat` is `text` on Responses, `response_format` on chat, and rejected on messages and run.
 
+## Credentials
+
+A provider is available when the dispatcher can resolve the credential it sends. `compile` and `run` throw when a required value is missing.
+
+| Provider | Option | Environment |
+| --- | --- | --- |
+| OpenRouter | `openrouter.apiKey` | `OPENROUTER_API_KEY`, then `OPEN_ROUTER_KEY` |
+| Bedrock | `bedrock.region` and optional `bedrock.credentials` | `AWS_REGION` or `AWS_DEFAULT_REGION`. When `credentials` is omitted, the AWS SDK default chain is used. An explicit credential is `accessKeyId`, `secretAccessKey`, and optional `sessionToken`. |
+| OpenAI | `openai.apiKey` | `OPENAI_API_KEY` |
+| Cloudflare | `cloudflare.apiToken` and `cloudflare.accountId` | `CLOUDFLARE_API_TOKEN` and `CLOUDFLARE_ACCOUNT_ID` |
+
 ## Errors
 
 Catalog failures throw `AiDispatcherError` with `code`, `message`, and the catalog `details`. Dispatcher codes include:
@@ -466,7 +477,7 @@ Catalog failures throw `AiDispatcherError` with `code`, `message`, and the catal
 | `PROVIDER_AUTH_FAILED` | OpenAI or Cloudflare HTTP `401` or `403` |
 | `PROVIDER_MODEL_NOT_FOUND` | OpenAI or Cloudflare HTTP `404` |
 | `PROVIDER_REQUEST_FAILED` | Other OpenAI or Cloudflare HTTP failures |
-| `PROVIDER_RATE_LIMITED` | Cloudflare HTTP `429` after retries |
+| `PROVIDER_RATE_LIMITED` | OpenAI or Cloudflare HTTP `429` after retries |
 | `PROVIDER_RETRYABLE` / `PROVIDER_GATEWAY_UNREACHABLE` | OpenAI or Cloudflare transport failures after retries, including timeout |
 | `FUNCTION_TOOL_LIMIT` | Function-tool calls exceed `maxFunctionToolCalls` |
 | `UNSUPPORTED_CONTENT` | Bedrock received an image URL or content part it cannot send |

package/dist/index.cjs

@@ -3280,8 +3280,7 @@ async function readFailure2(response) {
 function classifyStatus2(status) {
   if (status === 401 || status === 403) return "PROVIDER_AUTH_FAILED";
   if (status === 404) return "PROVIDER_MODEL_NOT_FOUND";
-  if (status === 429) return "PROVIDER_RATE_LIMITED";
-  if (status === 408 || status >= 500) return "PROVIDER_RETRYABLE";
+  if (status === 429 || status === 408 || status >= 500) return "PROVIDER_RETRYABLE";
   return "PROVIDER_REQUEST_FAILED";
 }
 function isConfigError2(code) {
@@ -3289,6 +3288,8 @@ function isConfigError2(code) {
 }
 function asTerminalError2(error) {
   if (error instanceof AiDispatcherError && error.code === "PROVIDER_RETRYABLE") {
+    const status = isRecord7(error.details) ? error.details.status : void 0;
+    if (status === 429) return new AiDispatcherError("PROVIDER_RATE_LIMITED", error.message, error.details);
     return new AiDispatcherError("PROVIDER_GATEWAY_UNREACHABLE", error.message, error.details);
   }
   if (error instanceof AiDispatcherError) return error;