@plurnk/plurnk-providers 1.29.0 → 3.0.0

package/.env.defaults

@@ -12,6 +12,8 @@
 # PLURNK_BASEURL_local=http://127.0.0.1:8080/v1
 # PLURNK_MODEL=cloud
 # PLURNK_MODEL=deepseek/deepseek-v4-flash
+# Any declared alias's own endpoint, overriding its provider's.
+# PLURNK_BASEURL_<alias>=<url>
 
 # --- Capacity ---
 # Simultaneous inference attempts per resolved endpoint in this process; -1 = unrestricted.
@@ -43,20 +45,20 @@ PLURNK_PROVIDERS_EFFORT_FALLBACK=high
 PLURNK_PROVIDERS_REASONING_RESPONSE_STYLE=verbatim
 # Compatible wire declarations below supplement Models.dev; native SDKs own their protocols.
 # Route knobs use the same suffix, e.g. PLURNK_PROVIDERS_REASONING_BUDGET_PATH_<alias>.
-# PLURNK_PROVIDERS_OUTPUT_PATH_<alias>=/max_completion_tokens
-# PLURNK_PROVIDERS_REASONING_EFFORT_PATH_<alias>=/reasoning_effort
-# PLURNK_PROVIDERS_REASONING_CONTROLS_<alias>=exclusive
-# PLURNK_PROVIDERS_REASONING_ON_BODY_<alias>='{"enable_thinking":true}'
-# PLURNK_PROVIDERS_REASONING_OFF_BODY_<alias>='{"enable_thinking":false}'
-# PLURNK_PROVIDERS_REASONING_EFFORTS_<alias>=low,medium,high
-# PLURNK_PROVIDERS_REASONING_TRANSPORT_EFFORTS_<alias>=none,low,medium,high
-# PLURNK_PROVIDERS_OPTIONS_NAMESPACE_<alias>=openrouter
-# PLURNK_PROVIDERS_REASONING_ADAPTIVE_BODY_<alias>='{}'
-# PLURNK_PROVIDERS_REASONING_TOGGLE_BODY_<alias>='{"reasoning":{"enabled":true}}'
-# PLURNK_PROVIDERS_ADAPTIVE_OPTIONS_<alias>='[{"models":["*"],"options":{"<sdk-namespace>":{…}}}]'
-# PLURNK_PROVIDERS_SYSTEM_CACHE_OPTIONS_<alias>=
-# PLURNK_PROVIDERS_APP_URL_<alias>=https://example.test/app
-# PLURNK_PROVIDERS_APP_NAME_<alias>=Example
+# PLURNK_PROVIDERS_OUTPUT_PATH=/max_completion_tokens
+# PLURNK_PROVIDERS_REASONING_EFFORT_PATH=/reasoning_effort
+# PLURNK_PROVIDERS_REASONING_CONTROLS=exclusive
+# PLURNK_PROVIDERS_REASONING_ON_BODY='{"enable_thinking":true}'
+# PLURNK_PROVIDERS_REASONING_OFF_BODY='{"enable_thinking":false}'
+# PLURNK_PROVIDERS_REASONING_EFFORTS=low,medium,high
+# PLURNK_PROVIDERS_REASONING_TRANSPORT_EFFORTS=none,low,medium,high
+# PLURNK_PROVIDERS_OPTIONS_NAMESPACE=openrouter
+# PLURNK_PROVIDERS_REASONING_ADAPTIVE_BODY='{}'
+# PLURNK_PROVIDERS_REASONING_TOGGLE_BODY='{"reasoning":{"enabled":true}}'
+# PLURNK_PROVIDERS_ADAPTIVE_OPTIONS='[{"models":["*"],"options":{"<sdk-namespace>":{…}}}]'
+# PLURNK_PROVIDERS_SYSTEM_CACHE_OPTIONS=
+# PLURNK_PROVIDERS_APP_URL=https://example.test/app
+# PLURNK_PROVIDERS_APP_NAME=Example
 
 # --- Sampling ---
 # Temperature; empty = omit, retaining the provider's sampling default.
@@ -97,6 +99,7 @@ PLURNK_PROVIDERS_PROVIDER_FIREWORKS_AI_CACHE_AFFINITY_FIELD='{"target":"header",
 # off = no explicit writes. This is distinct from affinity and can affect billing.
 PLURNK_PROVIDERS_CACHE_WRITE_POLICY=stable-system
 # Provider service tier; unset = provider default. Usually set per alias: routing can change cost.
+# Native routes send it only where the SDK documents one ({§provider-request-controls}); others warn.
 # PLURNK_PROVIDERS_SERVICE_TIER=
 # PLURNK_PROVIDERS_SERVICE_TIER_myfireworks=priority
 # USD per million tokens, merged over Models.dev rates; omitted categories retain catalog values.
@@ -131,6 +134,7 @@ PLURNK_PROVIDERS_PROBE_DELAY=250
 
 # --- Evidence capture ---
 # OpenAI top_logprobs: off/unset = none; 0 = chosen token only; N > 0 = alternatives.
+# Compatible routes and native OpenAI send it; other native routes warn ({§provider-request-controls}).
 # PLURNK_PROVIDERS_TOP_LOGPROBS=3
 # Retain raw wire body: unset/empty/0 = off; other values = on. Usually isolate to one capture alias.
 # PLURNK_PROVIDERS_RAWBODY=1
@@ -157,6 +161,8 @@ PLURNK_PROVIDERS_PROBE_DELAY=250
 # PLURNK_PROVIDERS_PROVIDER_ACME_REASONING_ON_BODY='{"reasoning":{"enabled":true}}'
 # PLURNK_PROVIDERS_PROVIDER_ACME_REASONING_OFF_BODY='{"reasoning":{"enabled":false}}'
 # PLURNK_PROVIDERS_PROVIDER_ACME_REASONING_ADAPTIVE_BODY='{}'
+# The form of every provider declaration; NAME is the route's provider segment.
+# PLURNK_PROVIDERS_PROVIDER_<NAME>_<SETTING>=<value>
 PLURNK_PROVIDERS_PROVIDER_FIREWORKS_AI_REASONING_EFFORT_PATH=/reasoning_effort
 PLURNK_PROVIDERS_PROVIDER_FIREWORKS_AI_REASONING_OFF_BODY='{"reasoning_effort":"none"}'
 PLURNK_PROVIDERS_PROVIDER_FIREWORKS_AI_REASONING_TOGGLE_BODY='{"reasoning_effort":true}'

package/README.md

@@ -42,7 +42,7 @@ import {
 import { ProviderError } from "@plurnk/plurnk-providers/errors";
 ```
 
-The package root composes the complete Node provider runtime, including plugin
+The package root composes the complete Node provider runtime, including extension
 discovery and environment-file defaults.
 
 ## Configure a model
@@ -126,10 +126,10 @@ flowchart TD
   shrink known capacity or declare unknown capacity, never enlarge known limits.
   Prompt projection and initialization reasoning READ limits are separate Core policy.
 
-## Provider plugins
+## Provider extensions
 
 Most integrations should use an MCP server, executor, scheme, or a provider
-declaration. A provider plugin is only needed for a protocol binding unavailable
+declaration. A provider extension is only needed for a protocol binding unavailable
 through the catalog and installed SDK packages.
 
 It may use any npm scope. Its package manifest declares the PLURNK name:
@@ -149,16 +149,16 @@ It may use any npm scope. Its package manifest declares the PLURNK name:
 
 The default export is an AI SDK provider with
 `languageModel(modelId)`. PLURNK adapts that language model into its own
-contract, so plugins do not reproduce retries, usage normalization, envelopes,
+contract, so extensions do not reproduce retries, usage normalization, envelopes,
 notices, or RFC 9457 failure normalization.
 
 The manifest may declare always-on `plurnk.attribution`. The default export may
 also implement synchronous `attributions(context)` and decide per provider
 attempt whether to return no, one, or many additional opaque tags
-({§plugin-attribution}).
+({§extension-attribution}).
 
 Discovery is scope-agnostic and rejects duplicate names.
-Third-party discovery uses the shared pre-import trust contract ({§plugin-trust-boundary}).
+Third-party discovery uses the shared pre-import trust contract ({§extension-trust-boundary}).
 
 ## Local endpoints
 
@@ -199,14 +199,14 @@ opt-in for endpoints that emit a leading `<think>` envelope, not a reasoning swi
 | Generation deadline | One whole-call allowance across queueing, requests and retries; caller cancellation still applies. No first-content or inter-chunk cutoff. |
 | Discovery/tokenizer HTTP | Separate non-generation fetch bound; does not limit inference. |
 | Provider-directed waits | Bounded retries honor `Retry-After`; other recoverable failures return to Core. |
-| Loop recovery | Core reissues within its recovery window, then parks attended loops or concludes unattended loops on the failure. |
+| Loop recovery | Core reissues within its recovery window, then parks for a review-capable owner or concludes on the failure. |
 | Cache affinity | Stable Worker identity through documented provider controls; not a cache-hit guarantee. |
 | Explicit cache writes | Separate policy on supported routes; can affect billing. |
 | Service tier | Explicit route choice that may change price and availability. |
 | Cost | Provider monetary evidence wins; known usage and catalog rates yield an estimate, not a settled charge. |
 
 For uncataloged compatible endpoints, declare the SDK, URL, and credential-variable
-name together; the examples are in the defaults reference. A provider plugin is
+name together; the examples are in the defaults reference. A provider extension is
 needed only when the protocol cannot be expressed by the installed adapters.
 
 ## Configured-provider packet conformance matrix

package/SPEC.md

@@ -103,7 +103,9 @@ the upstream provider as capacity oracle. The curation reservation's intersectio
 exposed as `inputCapacity`, the line Core packs the room against; the wall's, as `inputWall`; `null` means the available limits cannot establish
 one. A known combined context and output budget must leave positive input
 capacity. Consumers may display or use that fact as policy, but MUST NOT
-substitute their own content heuristic for request-shaped admission.
+substitute their own content heuristic for request-shaped admission. A consumer
+may assess a request before sending it; `generate` repeats the assessment as its
+own guard.
 
 `tokenize` is the separate content-token capability and exists only when the
 endpoint exposes its real vocabulary. Content tokenization does not substitute
@@ -177,7 +179,7 @@ The built-in transports preserve that intent after SDK serialization:
 | Anthropic Messages | `tools: []`, `tool_choice: {"type":"none"}` |
 | Gemini GenerateContent | `tools: []`, `toolConfig: {"functionCallingConfig":{"mode":"NONE"}}` |
 | Bedrock Converse | No tool configuration; the protocol has no `none` choice. |
-| Installed SDK provider plugins | Portable `none` intent; the plugin owns its wire projection. |
+| Installed SDK provider extensions | Portable `none` intent; the extension owns its wire projection. |
 
 This is a text-generation contract, not provider/model tuning or prompt
 teaching. Callers cannot supply tools or override the choice through request
@@ -451,8 +453,6 @@ Native SDKs retain their own output field; `OUTPUT_PATH` is incompatible with an
 options namespace. Request-local options are projected after the effective
 envelope is known, never frozen into SDK model construction. Streaming and
 non-streaming calls use the same projection.
-Retired `REASONING_STYLE` selectors fail at the selected provider/alias boundary;
-they neither select a preset nor silently coexist with these declarations.
 
 A native SDK's portable reasoning setting has no `max`, so a native route without
 a namespace cannot send an effort the catalog documents beyond it; construction
@@ -554,12 +554,9 @@ The provider segment of a model route IS the Models.dev id (#459) —
 configurations align with the catalog end to end (`fireworks-ai/…`,
 `cloudflare-workers-ai/@cf/…`, `togetherai/…`), and the
 `PLURNK_PROVIDERS_PROVIDER_<PREFIX>_*` prefix is that id uppercased with
-non-alphanumerics as underscores (`FIREWORKS_AI`). A retired plurnk-local
-segment (`fireworks`, `cloudflare`, `together`, `moonshot`, `dashscope`,
-`zhipu`, `hunyuan`, `bedrock`) refuses loudly, naming the id — it never
-silently resolves. Custom declared providers keep their operator-chosen
-names; the built-in local `ollama` rail keeps its name (the catalog's
-`ollama-cloud` is a different provider).
+non-alphanumerics as underscores (`FIREWORKS_AI`). Custom declared providers
+keep their operator-chosen names; the built-in local `ollama` rail keeps its
+name (the catalog's `ollama-cloud` is a different provider).
 
 `instantiateProvider` resolves in this order:
 
@@ -567,14 +564,14 @@ names; the built-in local `ollama` rail keeps its name (the catalog's
 2. An operator provider declaration:
    `PLURNK_PROVIDERS_PROVIDER_<NAME>_{NPM,BASE_URL,API_KEY_ENV}`.
 3. The local `openai` or `ollama` adapter.
-4. A discovered AI SDK provider plugin.
+4. A discovered AI SDK provider extension.
 5. A precise unknown-provider error.
 
-Earlier sources are authoritative. Installed plugins cannot shadow a cataloged
+Earlier sources are authoritative. Installed extensions cannot shadow a cataloged
 or explicitly declared name. This remains true when a named model is absent
 from the Models.dev snapshot: construction requires an explicit
 `PLURNK_PROVIDERS_CONTEXT_WINDOW` and never falls through to a same-name
-plugin.
+extension.
 
 Model IDs resolve exactly first. A unique catalog suffix is accepted to avoid
 forcing a vendor-owned resource prefix into PLURNK aliases. Ambiguous suffixes
@@ -603,36 +600,36 @@ The named secret remains in the operator environment. `${ENV_NAME}` inside a
 catalog or declared endpoint is expanded at construction and fails clearly
 when absent.
 
-## §6 Provider plugins
+## §6 Provider extensions
 
-Provider plugins are the escape hatch for a protocol binding not represented by
+Provider extensions are the escape hatch for a protocol binding not represented by
 Models.dev, installed SDK providers, or a declaration. Most extensibility
 belongs in MCP, schemes, executors, or mimetypes instead.
 
-A provider plugin:
+A provider extension:
 
-1. declares the exact string `plurnk: { kind: "provider", name }` in `package.json` ({§plugin-family-kind});
+1. declares the exact string `plurnk: { kind: "provider", name }` in `package.json` ({§extension-kind});
 2. may declare always-on package-level `plurnk.attribution` and/or implement the
-   synchronous runtime `attributions(context)` hook under {§plugin-attribution};
+   synchronous runtime `attributions(context)` hook under {§extension-attribution};
 3. may use any npm scope;
 4. default-exports an AI SDK provider with `languageModel(modelId)`;
 5. peers on compatible `ai` and `@plurnk/plurnk-providers` majors.
 
-§provider-grammar-transport A plugin whose backend accepts a llama.cpp-style
+§provider-grammar-transport An extension whose backend accepts a llama.cpp-style
 GBNF grammar may declare `plurnk.grammarStyle: "llamacpp"` beside its kind and
 name; the discovery records it and the adapted Provider carries the capability,
 so an operator's grammar file ({§operator-grammar}) rides the wire exactly as
 on a probed llama-server. Absence or `"none"` keeps the grammar off the wire;
-any other value fails discovery loudly. The declaration is the plugin author's
+any other value fails discovery loudly. The declaration is the extension author's
 fact about their backend; the transport evidence on each response
 ({§provider-grammar-evidence}) is where a wrong declaration shows, never by
 degrading admission.
 
-PLURNK adapts the returned language model. The plugin does not implement the
+PLURNK adapts the returned language model. The extension does not implement the
 PLURNK `Provider`, read PLURNK tuning knobs, or reproduce transport policy.
 
 Discovery is scope-agnostic and memoized per process. Duplicate names fail hard.
-The common plugin trust gate applies before import ({§plugin-trust-boundary}). A plugin absent from
+The common extension trust gate applies before import ({§extension-trust-boundary}). An extension absent from
 Models.dev requires an explicit context-window pin because PLURNK will not guess
 model physics. `Discovery.packageAttributions` carries the canonical package map.
 
@@ -701,14 +698,35 @@ Generic AI SDK calls accept only settings represented by the SDK's portable
 surface. Compatible endpoints may carry additional sampling keys after reserved
 keys are removed.
 
+§provider-request-controls **A configured service tier or logprobs count reaches a
+native route only through the per-call option its SDK documents.** On a compatible
+route, `PLURNK_PROVIDERS_SERVICE_TIER` and `PLURNK_PROVIDERS_TOP_LOGPROBS` are the
+body fields `service_tier`, `logprobs` and `top_logprobs`. A native route sends them
+in its SDK's `providerOptions` namespace, serialized by that SDK. A control the SDK
+does not document is not sent, and one process warning,
+`PLURNK_REQUEST_CONTROL_UNSUPPORTED`, names it, so a configured choice never
+disappears in silence. The tier passes verbatim: the SDK owns its vocabulary, and a
+value it drops surfaces as its call warning ({§provider-sdk-warning}). A logprobs
+count of 0 asks for the chosen token only.
+
+| Native SDK | Namespace | Service tier | Logprobs |
+| --- | --- | --- | --- |
+| OpenAI | `openai` | sent | sent |
+| Groq | `groq` | sent | not sent |
+| Cerebras | `cerebras` | sent | not sent |
+| xAI | `xai` | sent | not sent |
+| Google | `google` | sent | not sent |
+| Anthropic | `anthropic` | sent | not sent |
+| Amazon Bedrock | `bedrock` | sent | not sent |
+| Mistral, Together, DeepInfra, OpenRouter | none | not sent | not sent |
+
 §openrouter-app-attribution **A route on the OpenRouter SDK identifies the calling
 application only as its provider declares.** `APP_URL`, an absolute HTTP(S) URL, and
 the optional `APP_NAME` are provider declarations (`PLURNK_PROVIDERS_PROVIDER_<NAME>_`,
 overridable per route or alias); the SDK sends them as `HTTP-Referer` and
 `X-OpenRouter-Title`. The shipped floor declares them for `openrouter` only, so
 another provider on the same SDK package sends none; an empty `APP_URL` suppresses
-both. The retired `OPENROUTER_HTTP_REFERER`, `OPENROUTER_APP_TITLE` and
-`OPENROUTER_X_TITLE` fail construction.
+both.
 
 ## §9 Failures, retries, and cancellation
 
@@ -997,8 +1015,7 @@ replayed. Missing output usage cannot prove a violation.
 as `35%`. `PLURNK_PROVIDERS_REASONING_BUDGET` is optional; leaving it unset
 preserves provider-adaptive depth. A backend known to decode without a finite
 limit advertises `requiresOutputBudget` and fails construction when no total can
-be resolved. The retired additive reserve knobs fail hard rather than creating
-a second envelope contract.
+be resolved.
 
 ## §13 Inference capacity
 
@@ -1011,7 +1028,7 @@ alias scoping. Zero, other negative values and non-integers are invalid.
 
 | Boundary | Contract |
 | --- | --- |
-| Identity | Provider instances and aliases sharing the resolved API base URL share one allowance. SDK/plugin-owned endpoints without a resolved URL share their provider identity. Conflicting limits for one identity fail construction, naming the identity and both values; they never create independent queues. The daemon reads its environment once at boot, so an identity's limit cannot change within a process: reconstructing a provider from that environment reuses its allowance, and in-flight leases keep counting. |
+| Identity | Provider instances and aliases sharing the resolved API base URL share one allowance. SDK- or extension-owned endpoints without a resolved URL share their provider identity. Conflicting limits for one identity fail construction, naming the identity and both values; they never create independent queues. The daemon reads its environment once at boot, so an identity's limit cannot change within a process: reconstructing a provider from that environment reuses its allowance, and in-flight leases keep counting. |
 | Admission | FIFO among live waiters. The lease begins before the physical request observer and ends after the complete response or transport failure settles, including streamed bodies. |
 | Cancellation | A queued abort removes that waiter and preserves the caller's reason. It opens no physical request or accounting row. In-flight cancellation signals the transport; capacity is released when that attempt unwinds. A transport still running despite abort does not authorize exceeding the limit. |
 | Retries | Backoff holds no lease. Each retry rejoins admission as a new physical attempt. |
@@ -1045,7 +1062,7 @@ complete-envelope derivation per backend before taking the minimum.
 
 Coverage MUST prove:
 
-- catalog, declaration, local, and plugin resolution;
+- catalog, declaration, local, and extension resolution;
 - exact and unique-suffix model lookup;
 - native SDK request mapping and normalized responses;
 - compatible extension preservation;

package/dist/AiSdkProvider.d.ts

@@ -4,7 +4,7 @@ import type { JSONValue } from "ai";
 import type { EffortSetting, ReasoningResponseStyle } from "./env.ts";
 import type { InputModality } from "./types.ts";
 import type { LanguageModel } from "ai";
-import type { PluginAttribution, PluginAttributionContext } from "@plurnk/plurnk-meta";
+import type { ExtensionAttribution, ExtensionAttributionContext } from "@plurnk/plurnk-meta";
 import type RequestFields from "./RequestFields.ts";
 import type InferenceAdmission from "./InferenceAdmission.ts";
 export type ProviderFetch = typeof globalThis.fetch;
@@ -25,7 +25,7 @@ export type AiSdkProviderConfig = {
     model: string;
     url?: string;
     languageModel?: LanguageModel;
-    attributions?: (context: PluginAttributionContext) => PluginAttribution;
+    attributions?: (context: ExtensionAttributionContext) => ExtensionAttribution;
     fetchTimeoutMs: number;
     operationTimeoutMs: number;
     droppedOutputTokens?: number;
@@ -54,6 +54,7 @@ export type AiSdkProviderConfig = {
     systemCacheProviderOptions?: AiSdkProviderOptions;
     reasoningResponseProviderOptions?: AiSdkProviderOptions;
     serviceTier?: string;
+    requestControls?: NativeRequestControls;
     streaming?: boolean;
     apiKeyRejectedMessage?: string;
     eosText?: string;
@@ -80,9 +81,14 @@ export type AiSdkProviderConfig = {
     topLogprobs?: number | null;
     rawBody?: boolean;
 };
+export interface NativeRequestControls {
+    readonly namespace: string;
+    readonly serviceTier: boolean;
+    readonly logprobs: boolean;
+}
 export default class AiSdkProvider implements Provider {
     #private;
-    readonly attributions?: (context: PluginAttributionContext) => PluginAttribution;
+    readonly attributions?: (context: ExtensionAttributionContext) => ExtensionAttribution;
     tokenize?: (text: string) => Promise<number[]>;
     constructor(config: AiSdkProviderConfig);
     get contextWindow(): number | null;

package/dist/AiSdkProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AiSdkProvider.d.ts","sourceRoot":"","sources":["../src/AiSdkProvider.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"AiSdkProvider.d.ts","sourceRoot":"","sources":["../src/AiSdkProvider.ts"],"names":[],"mappings":"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"}

package/dist/AiSdkProvider.js

@@ -1,9 +1,9 @@
 // PLURNK adapter over an AI SDK language model. Implements the universal generate()
 // spine — signal merging, the SSE call, usage mapping, finishReason
-// normalization, response assembly — that every sibling had duplicated.
+// normalization, response assembly.
 //
 // Composition, not inheritance: an official AI SDK language model supplies the
-// ordinary vendor protocol. The compatible URL path remains only for PLURNK
+// ordinary vendor protocol. The compatible URL path serves only PLURNK
 // extensions and local endpoint probes the SDK cannot represent.
 import { EFFORTS, MAX_TIMER_MS } from "@plurnk/plurnk-contracts";
 import { UnsupportedEffortError } from "./types.js";
@@ -82,6 +82,26 @@ const providerWarningMessage = (warning) => {
         case "other": return warning.message;
     }
 };
+// {§provider-request-controls} — a native route forwards a configured control only through its
+// SDK's documented provider option; a control the SDK does not document is named once and not
+// sent, never dropped in silence (#988).
+const nativeControlOptions = (source, controls, serviceTier, topLogprobs) => {
+    const options = {};
+    const unsupported = (knob) => emitWarningOnce(`${source}: ${knob} is not a provider option this route's SDK${controls === undefined ? "" : ` (${controls.namespace})`} documents, so it is not sent`, "PLURNK_REQUEST_CONTROL_UNSUPPORTED");
+    if (serviceTier !== undefined) {
+        if (controls?.serviceTier === true)
+            options.serviceTier = serviceTier;
+        else
+            unsupported("PLURNK_PROVIDERS_SERVICE_TIER");
+    }
+    if (topLogprobs !== null) {
+        if (controls?.logprobs === true)
+            options.logprobs = topLogprobs > 0 ? topLogprobs : true;
+        else
+            unsupported("PLURNK_PROVIDERS_TOP_LOGPROBS");
+    }
+    return controls === undefined || Object.keys(options).length === 0 ? undefined : { [controls.namespace]: options };
+};
 export default class AiSdkProvider {
     #inferenceAdmission;
     #model;
@@ -126,6 +146,7 @@ export default class AiSdkProvider {
     #systemCacheProviderOptions;
     #reasoningResponseProviderOptions;
     #serviceTier;
+    #controlOptions;
     #streaming;
     #supportsSlotPinning;
     #slotCount;
@@ -181,7 +202,7 @@ export default class AiSdkProvider {
         if (!this.#supportedEfforts.includes(this.#effort.mode)) {
             throw new UnsupportedEffortError(config.source ?? "provider", this.#effort.mode, this.#supportedEfforts);
         }
-        // Loud guard: an out-of-date consumer (stale plugin dist) omitting the
+        // Loud guard: an out-of-date consumer (stale extension dist) omitting the
         // required tuning fields must fail at construction, not silently send
         // undefined sampling on every grammar request.
         if (config.temperature === undefined || config.repeatPenalty === undefined) {
@@ -257,6 +278,12 @@ export default class AiSdkProvider {
         this.#supportsSlotPinning = config.supportsSlotPinning ?? false;
         this.#slotCount = config.slotCount ?? null;
         this.#topLogprobs = config.topLogprobs ?? null;
+        if (this.#languageModel === undefined && config.requestControls !== undefined) {
+            throw new Error(`${this.#source}: native request controls require an AI SDK model`);
+        }
+        this.#controlOptions = this.#languageModel === undefined
+            ? undefined
+            : nativeControlOptions(this.#source, config.requestControls, this.#serviceTier, this.#topLogprobs);
         this.#rawBody = config.rawBody ?? false;
         this.#servedModel = config.servedModel;
         this.#requiresOutputBudget = config.requiresOutputBudget;
@@ -306,7 +333,7 @@ export default class AiSdkProvider {
                 return tokens;
             };
         }
-        this.#requestBody = new AiSdkRequestBody({ reasoningBudget: this.#reasoningBudget, additiveReasoningProvider: this.#additiveReasoningProvider, effort: this.#effort, adaptiveEffortProviderOptions: this.#adaptiveEffortProviderOptions, repeatPenalty: this.#repeatPenalty, dryMultiplier: this.#dryMultiplier, dryBase: this.#dryBase, dryAllowedLength: this.#dryAllowedLength, repeatLastN: this.#repeatLastN, reasoningStyle: this.#reasoningStyle, source: this.#source, grammarStyle: this.#grammarStyle, cacheAffinity: this.#cacheAffinity, reasoningResponseProviderOptions: this.#reasoningResponseProviderOptions, supportsSlotPinning: this.#supportsSlotPinning, slotCount: this.#slotCount });
+        this.#requestBody = new AiSdkRequestBody({ reasoningBudget: this.#reasoningBudget, additiveReasoningProvider: this.#additiveReasoningProvider, effort: this.#effort, adaptiveEffortProviderOptions: this.#adaptiveEffortProviderOptions, repeatPenalty: this.#repeatPenalty, dryMultiplier: this.#dryMultiplier, dryBase: this.#dryBase, dryAllowedLength: this.#dryAllowedLength, repeatLastN: this.#repeatLastN, reasoningStyle: this.#reasoningStyle, source: this.#source, grammarStyle: this.#grammarStyle, cacheAffinity: this.#cacheAffinity, reasoningResponseProviderOptions: this.#reasoningResponseProviderOptions, controlOptions: this.#controlOptions, supportsSlotPinning: this.#supportsSlotPinning, slotCount: this.#slotCount });
     }
     get contextWindow() { return this.#contextWindow; }
     get inputModalities() { return this.#inputModalities; }
@@ -782,10 +809,9 @@ export default class AiSdkProvider {
         if (sendGrammar !== undefined
             && this.tokenize !== undefined
             && usage?.outputTokens !== undefined) {
-            // Channel-escape detector: completion tokens
-            // billed far beyond every visible channel mean the decode ESCAPED into
-            // a server-discarded reasoning block mid-emission. This diagnostic
-            // requires the serving vocabulary; an estimate cannot prove absence.
+            // {§diagnostic-observation} — billed output tokens far beyond every visible channel are reported
+            // as the two counts, naming no cause. The count requires the serving vocabulary; an estimate
+            // cannot prove absence.
             try {
                 const [contentTokens, reasoningTokens] = await Promise.all([
                     this.tokenize(raw.content),
@@ -795,9 +821,9 @@ export default class AiSdkProvider {
                 if (usage.outputTokens > visible + 64) {
                     (notices ??= []).push({
                         source: this.#source,
-                        kind: "grammar_unenforced",
+                        kind: "output_unaccounted",
                         level: "warn",
-                        message: `decode escaped the grammar: ${usage.outputTokens} output tokens billed but only ${visible} visible across content+reasoning — the balance ran unconstrained in a discarded reasoning channel`,
+                        message: `${usage.outputTokens} output tokens billed; ${visible} visible across content and reasoning.`,
                         position: [...raw.content].length,
                     });
                 }