@broberg/ai-sdk 0.36.4 → 0.36.5

package/dist/index.d.ts

@@ -24,7 +24,18 @@ declare function regionOfHost(url: string | undefined): Region;
  *  least defensible. Never throws — a residency reading must not be able to break a
  *  call that already succeeded. */
 declare function classifyRegionName(name: string | undefined): Region;
-/** Region for an adapter whose endpoint is fixed. Unknown provider → `"unknown"`. */
+/** Region for an adapter whose endpoint is fixed. Unknown provider → `"unknown"`.
+ *
+ *  **DO NOT BUILD A RESIDENCY GUARD ON THIS.** Use {@link regionOfHost} on the base URL
+ *  the call will actually use. Found by a consumer building exactly that guard (super,
+ *  2026-08-30): `regionOfProvider("mistral")` is `"unknown"` — correct, because Mistral
+ *  takes a `baseUrl` and a name cannot answer for residency — but a guard written as
+ *  `regionOfProvider(p) === "eu"` therefore REJECTS Mistral, which is the only EU route
+ *  we have. It fails closed and is useless: it filters out the thing it exists to allow.
+ *
+ *  The trap is invisible from the signature, which is why it is written here rather than
+ *  only in the docs. This function answers "is this provider's endpoint fixed, and where
+ *  is it?" — a narrower question than "where will my call go?". */
 declare function regionOfProvider(provider: string): Region;
 
 /** How a call reaches the model. `http` = provider REST API; `subprocess` = local
@@ -2189,8 +2200,8 @@ declare const falStubAdapter: ProviderAdapter;
  *  wires the live adapters. */
 declare const stubProviders: Record<string, ProviderAdapter>;
 
-declare const VERSION: "0.36.4";
-declare const SDK_TAG: "@broberg/ai-sdk@0.36.4";
+declare const VERSION: "0.36.5";
+declare const SDK_TAG: "@broberg/ai-sdk@0.36.5";
 
 /** Built-in defaults. Every entry is overridable via AiConfig.defaults or a
  *  per-call override.

package/dist/index.js

@@ -2986,8 +2986,8 @@ var aiConfigSchema = z.object({
 });
 
 // src/version.ts
-var VERSION = "0.36.4";
-var SDK_TAG = "@broberg/ai-sdk@0.36.4";
+var VERSION = "0.36.5";
+var SDK_TAG = "@broberg/ai-sdk@0.36.5";
 
 // src/cost/sinks/upmetrics.ts
 function upmetricsSink(config) {