@plurnk/plurnk-providers 1.14.2 → 1.16.0

package/.env.defaults

@@ -125,7 +125,7 @@ PLURNK_PROVIDERS_PROBE_DELAY=250
 # Rails on a weak model need a recency reminder or turns death-march to the
 # token ceiling ({§gbnf-forced-march}): put in the Recap footer (core
 # PLURNK_SERVICE_RECAP) a line such as
-#   YOU MUST begin with `# PLAN0` and end with `## SEND0 [status code]`
+#   YOU MUST begin with `## PLAN0` and end with `### SEND0 [status code]`
 # PLURNK_PROVIDERS_GBNF=plurnk.qwen.gbnf
 # Debug toggle: validate but withhold a configured local GBNF, then report the
 # unconstrained output's divergence. Development aid; leave unset in production.

package/SPEC.md

@@ -412,6 +412,20 @@ names without values. Construction rejects the same missing requirements at
 the provider boundary instead of deferring a known configuration failure to a
 model request.
 
+### §provider-input-modalities Native input parts
+
+A provider declares `inputModalities`, the set of native non-text inputs its model
+accepts, from the catalog's input modalities (Models.dev `modalities.input` minus
+`text`, kept to the vocabulary `image`, `pdf`, `audio`, `video`; empty when the
+model is unknown). A user `ChatMessage` may then carry content parts: text beside
+`{ type: "image", image: bytes, mediaType }` and `{ type: "file", data: bytes, mediaType }`,
+which the AI SDK transport forwards as the model's native image and file input;
+system and assistant messages stay text, and prompt-token estimates count text
+only, the provider's reported usage owning each part's cost. A pool declares a
+modality only when every backend does; the Mock declares them by option and
+records every request it receives. Which parts actually ride a request is the
+service's decision per attachment ({§packet-attachment-parts} in the core specification).
+
 ### §model-fact-resolution Model fact precedence
 
 Provider and model facts resolve independently:
@@ -660,7 +674,7 @@ deadline:
 
 | Layer | Operator knob | Boundary | Expiry |
 | --- | --- | --- | --- |
-| Operation | `PLURNK_PROVIDERS_OPERATION_TIMEOUT` | Complete logical call, including every attempt and retry delay. | Final `deadline_exceeded` Problem at 504 with `timeoutPhase=operation`; never retried. |
+| Operation | `PLURNK_PROVIDERS_OPERATION_TIMEOUT` | Complete logical call, including every attempt and retry delay. | Final `deadline_exceeded` Problem at 504 with `timeoutPhase=operation`; never retried. Enforced as a race, not only the advisory signal, so a wedged transport that never observes the abort cannot hang the loop past the deadline (#505); a well-behaved transport unwinds within a short grace and settles its own attempt evidence first. |
 | Attempt | `PLURNK_PROVIDERS_FETCH_TIMEOUT` | One physical generation request, including response consumption. | Surfaced `network_failure` with `timeoutPhase=attempt`; never transport-retried (#479) — the consumer's recovery owns re-issue. Embedding requests share the same per-physical-request deadline, enforced as a race so a wedged adapter cannot hang its awaiters (#463). |
 | First content | `PLURNK_PROVIDERS_FIRST_CONTENT_TIMEOUT` | Response-stream start through first semantic model content; metadata, empty deltas, and transport activity do not satisfy it. | Surfaced `network_failure` with `timeoutPhase=first_content`; never transport-retried (#479). |
 | Stream idle | `PLURNK_PROVIDERS_STREAM_IDLE_TIMEOUT` | Silence between semantic content chunks after content begins. | Surfaced `network_failure` with `timeoutPhase=stream_idle`; never transport-retried (#479). |
@@ -732,7 +746,7 @@ is `content` and `contentStart` is zero.
 §gbnf-forced-march **A grammar masks end-of-generation until the sentence completes — pair rails on a weak model with a recency reminder.** llama-server admits EOG only in a grammar-accepting state, so a model whose intended emission diverges from the required turn shape cannot stop: each masked substitution drifts it further from the terminal, and the request runs to the token ceiling and dies as a length cut (measured 2026-09-01, #477 — the thought budget fires and throughput is unaffected; the march is the grammar's one failure mode, and the weaker the model, the likelier the divergence that triggers it). When enabling a GBNF rail for a model that does not reliably hold the frame shape, put the shape command where recency helps — the operator's Recap footer (core `PLURNK_SERVICE_RECAP`) — for example:
 
 ```text
-YOU MUST begin with `# PLAN0` and end with `## SEND0 [status code]`
+YOU MUST begin with `## PLAN0` and end with `### SEND0 [status code]`
 ```
 
 A model that emits valid frames freehand needs neither the rail nor the reminder.

package/dist/AiSdkProvider.d.ts

@@ -2,6 +2,7 @@ import type { ChatMessage, PromptTokenMeasurement, Provider, ProviderCostNormali
 import type { ProviderCost } from "@plurnk/plurnk-contracts";
 import type { JSONValue } from "ai";
 import { type Reasoning, type ReasoningResponseStyle } from "./env.ts";
+import type { InputModality } from "./types.ts";
 import type { LanguageModel } from "ai";
 import type { PluginAttribution, PluginAttributionContext } from "@plurnk/plurnk-meta";
 export type ProviderFetch = typeof globalThis.fetch;
@@ -30,6 +31,7 @@ export type AiSdkProviderConfig = {
     headers?: Record<string, string>;
     fetch?: ProviderFetch;
     contextWindow?: number | null;
+    inputModalities?: ReadonlySet<InputModality>;
     maxInputTokens?: number | null;
     maxOutputTokens?: number | null;
     outputBudget?: number | null;
@@ -83,6 +85,7 @@ export default class AiSdkProvider implements Provider {
     tokenize?: (text: string) => Promise<number[]>;
     constructor(config: AiSdkProviderConfig);
     get contextWindow(): number | null;
+    get inputModalities(): ReadonlySet<InputModality>;
     get maxInputTokens(): number | null;
     get maxOutputTokens(): number | null;
     get outputBudget(): 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

@@ -8,27 +8,41 @@
 import { REASONING_POLICIES } from "@plurnk/plurnk-contracts";
 import { MAX_PROVIDER_TIMEOUT_MS } from "./env.js";
 import { UnsupportedReasoningPolicyError } from "./types.js";
-import { executeAiSdkModel, executeOpenAICompatible, transportFailureOutputObserved, transportFailureEvidence, } from "./aiSdkTransport.js";
+import { executeAiSdkModel, executeOpenAICompatible, transportFailureOutputObserved, transportFailureEvidence } from "./aiSdkTransport.js";
 import { prepareRetries } from "ai/internal";
 import { toProviderError, ProviderError, ProviderTimeoutError } from "./errors.js";
-import { validateGbnf } from "@plurnk/gbnf";
 import { assertPromptTokenMeasurement, estimatePromptTokens } from "./promptTokens.js";
 import { emitWarningOnce } from "./warnings.js";
 import { resolveProviderCost } from "./cost.js";
 import { validateProviderRequestAccounting } from "./accounting.js";
 import { validateProviderUsage } from "./usage.js";
 import { assessRequestCapacity, effectiveInputCapacity, effectiveOutputBudget, effectiveReasoningBudget } from "./capacity.js";
-const isJsonObject = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
-const mergeJsonObjects = (left, right) => Object.fromEntries([...new Set([...Object.keys(left), ...Object.keys(right)])].map((key) => {
-    const leftValue = left[key];
-    const rightValue = right[key];
-    return [
-        key,
-        isJsonObject(leftValue) && isJsonObject(rightValue)
-            ? mergeJsonObjects(leftValue, rightValue)
-            : rightValue ?? leftValue,
-    ];
-}));
+import { nativeFixedEffort } from "./reasoning-effort.js";
+import AiSdkRequestBody from "./AiSdkRequestBody.js";
+// {§provider-connectivity} — an AbortSignal is advisory: a wedged transport that never observes it can
+// hang the await past the deadline (#505). This backstops the deadline the same way an embedding request
+// bounds a wedged adapter (#463): once the signal fires, a well-behaved transport unwinds and settles its
+// own attempt (and accounting) within a short grace, and that path wins the race untouched; only a
+// transport still wedged after the grace is force-rejected with the signal's own reason, so the existing
+// operation/cancellation classification is unchanged. The grace is unwind slack, not a second deadline.
+const OPERATION_DEADLINE_UNWIND_GRACE_MS = 1_000;
+const raceAgainstDeadline = async (work, signal) => {
+    let timer;
+    const backstop = new Promise((_resolve, reject) => {
+        const arm = () => { timer = setTimeout(() => reject(signal.reason), OPERATION_DEADLINE_UNWIND_GRACE_MS); };
+        if (signal.aborted)
+            arm();
+        else
+            signal.addEventListener("abort", arm, { once: true });
+    });
+    try {
+        return await Promise.race([work, backstop]);
+    }
+    finally {
+        if (timer !== undefined)
+            clearTimeout(timer);
+    }
+};
 class ProviderRequestObserverError extends Error {
     constructor(cause) {
         super("provider request accounting could not be durably settled", { cause });
@@ -101,32 +115,6 @@ const projectTemplateReasoning = (content) => {
     }
     return { content, reasoning: "", projected: false, contentStart: 0 };
 };
-const fixedEffort = (mode) => {
-    if (mode === "low" || mode === "medium" || mode === "high" || mode === "xhigh" || mode === "max")
-        return mode;
-    throw new TypeError(`reasoning policy '${mode}' is not a fixed effort`);
-};
-// The native SDK effort surface tops at xhigh; admission never grants a native
-// route "max", so reaching it here is a contract violation, not a fallback site.
-const nativeFixedEffort = (mode) => {
-    const effort = fixedEffort(mode);
-    if (effort === "max")
-        throw new TypeError(`reasoning policy 'max' has no native SDK effort surface`);
-    return effort;
-};
-// Anthropic's older manual-reasoning protocol needs an absolute allowance while
-// PLURNK's durable contract names an effort. These fractions match the native
-// SDK's policy projection, but apply to PLURNK's total envelope rather than the
-// model's physical maximum. The minimum is imposed by the provider protocol.
-const MANUAL_REASONING_FRACTIONS = Object.freeze({
-    adaptive: 0.6,
-    low: 0.1,
-    medium: 0.3,
-    high: 0.6,
-    xhigh: 0.75,
-    max: 0.85,
-});
-const MANUAL_REASONING_MINIMUM = 1024;
 const providerWarningMessage = (warning) => {
     switch (warning.type) {
         case "unsupported":
@@ -136,27 +124,6 @@ const providerWarningMessage = (warning) => {
         case "other": return warning.message;
     }
 };
-// Body keys the provider owns — a caller's `sampling` passthrough may not set
-// these. Two families:
-//   transport/managed — grammar transport, the stream/JSON choice, slot pinning,
-//     data capture ({§provider-evidence}: backend-specific fields never cross the contract);
-//   contract invariants — `n` (atomic single completion: choices[0] is the
-//     response; n>1 = paid, dropped output), the tool-calling family (tools-in-
-//     body doctrine, §2: native tool_calls return null content = a broken turn),
-//     modalities/audio (text-only contract), prediction (decode semantics, not
-//     sampling), and the token caps (the envelope is the managed maxOutputTokens —
-//     sampling must not bypass the consumer's cap).
-// Sampling intent (temperature, top_p, penalties, stop, seed, logit_bias) and
-// platform knobs (user, service_tier, prompt_cache_*, safety_identifier,
-// metadata, store, verbosity) pass through; the managed floors spread UNDER
-// sampling stay deliberately caller-overridable.
-const RESERVED_BODY_KEYS = new Set([
-    "model", "messages", "stream", "stream_options", "grammar", "response_format", "id_slot", "logprobs", "top_logprobs",
-    "reasoning_format", "reasoning_effort", "thinking", "think", "include_reasoning", "chat_template_kwargs", "thinking_budget_tokens", // lexicon-allow: backend wire fields
-    "n", "tools", "tool_choice", "functions", "function_call", "parallel_tool_calls",
-    "modalities", "audio", "prediction", "max_tokens", "max_completion_tokens",
-    "prompt_cache_key",
-]);
 export default class AiSdkProvider {
     #model;
     #url;
@@ -171,6 +138,7 @@ export default class AiSdkProvider {
     #apiKeyRejectedMessage;
     #eosText;
     #contextWindow;
+    #inputModalities;
     #maxInputTokens;
     #maxOutputTokens;
     #outputBudget;
@@ -220,6 +188,7 @@ export default class AiSdkProvider {
     // tokenizeUrl (llama-server), so `provider.tokenize === undefined` remains
     // the honest capability signal for every other backend.
     tokenize;
+    #requestBody;
     constructor(config) {
         this.#model = config.model;
         this.#url = config.url;
@@ -245,6 +214,7 @@ export default class AiSdkProvider {
         this.#headers = config.headers ?? {};
         this.#fetch = config.fetch ?? ((input, init) => globalThis.fetch(input, init));
         this.#contextWindow = config.contextWindow ?? null;
+        this.#inputModalities = config.inputModalities ?? new Set();
         this.#maxInputTokens = config.maxInputTokens ?? null;
         this.#maxOutputTokens = config.maxOutputTokens ?? null;
         this.#outputBudget = config.outputBudget ?? null;
@@ -377,8 +347,10 @@ export default class AiSdkProvider {
                 return tokens;
             };
         }
+        this.#requestBody = new AiSdkRequestBody({ reasoningBudget: this.#reasoningBudget, additiveReasoningProvider: this.#additiveReasoningProvider, reasoning: this.#reasoning, reasoningToggle: this.#reasoningToggle, compatibleAdaptiveReasoning: this.#compatibleAdaptiveReasoning, compatibleOffReasoning: this.#compatibleOffReasoning, adaptiveReasoningProviderOptions: this.#adaptiveReasoningProviderOptions, repeatPenalty: this.#repeatPenalty, frequencyPenalty: this.#frequencyPenalty, 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, firstPartyMetadata: this.#firstPartyMetadata, supportsSlotPinning: this.#supportsSlotPinning, slotCount: this.#slotCount });
     }
     get contextWindow() { return this.#contextWindow; }
+    get inputModalities() { return this.#inputModalities; }
     get maxInputTokens() { return this.#maxInputTokens; }
     get maxOutputTokens() { return this.#maxOutputTokens; }
     get outputBudget() { return this.#outputBudget; }
@@ -420,7 +392,7 @@ export default class AiSdkProvider {
                 body: JSON.stringify({
                     model: this.#model,
                     messages,
-                    ...this.#reasoningBody(),
+                    ...this.#requestBody.reasoningBody(),
                 }),
                 ...(requestSignal === undefined ? {} : { signal: requestSignal }),
             });
@@ -462,208 +434,6 @@ export default class AiSdkProvider {
             measurement: await this.countPromptTokens(messages, signal),
         });
     }
-    // Reasoning activation and allowance are independent of grammar transport;
-    // only the response representation becomes lossless when evidence is needed.
-    // The llama-server template mapping is owned by {§llama-reasoning-request}.
-    #reasoningBody(preserveGrammarSentence = false, reasoningBudget = this.#reasoningBudget) {
-        const { mode } = this.#reasoning;
-        const budget = reasoningBudget;
-        const on = mode !== "off";
-        switch (this.#reasoningStyle) {
-            case "template": {
-                const allowance = mode === "off"
-                    ? 0
-                    : budget;
-                // A fixed effort rides into the template as its own variable; adaptive
-                // and off send none and leave the template's default in force.
-                const templateEffort = mode === "off" || mode === "adaptive" ? {} : { reasoning_effort: fixedEffort(mode) };
-                return {
-                    chat_template_kwargs: { enable_thinking: on, ...templateEffort },
-                    reasoning_format: preserveGrammarSentence ? "none" : "auto",
-                    ...(allowance === null ? {} : { thinking_budget_tokens: allowance }),
-                };
-            }
-            case "think": return on ? { think: true } : {};
-            case "include_reasoning": return on ? { include_reasoning: true } : {};
-            case "effort": return mode === "off"
-                ? this.#compatibleOffReasoning === undefined
-                    ? {}
-                    : { reasoning_effort: this.#compatibleOffReasoning }
-                : mode === "adaptive"
-                    ? this.#compatibleAdaptiveReasoning === "provider-default"
-                        ? {}
-                        : { reasoning_effort: this.#compatibleAdaptiveReasoning }
-                    : { reasoning_effort: fixedEffort(mode) };
-            // Graded reasoning is mandatory when the route advertises an effort
-            // value. Cataloged routes supply the exact strongest legal value;
-            // construction rejects an unsupported off or fixed policy.
-            case "effort_required": {
-                if (mode === "off") {
-                    if (this.#compatibleOffReasoning === undefined) {
-                        throw new TypeError(`${this.#source}: required reasoning effort has no off projection`);
-                    }
-                    return { reasoning_effort: this.#compatibleOffReasoning };
-                }
-                if (mode === "adaptive") {
-                    return this.#compatibleAdaptiveReasoning === "provider-default"
-                        ? {}
-                        : { reasoning_effort: this.#compatibleAdaptiveReasoning };
-                }
-                return { reasoning_effort: fixedEffort(mode) };
-            }
-            // Fireworks enum: OFF is sent EXPLICITLY ("none") — omission leaves a
-            // reason-by-default model (DeepSeek V4: default 'high') reasoning.
-            // ADAPTIVE omits the field UNLESS the catalog declares a toggle control:
-            // toggle routes (nemotron-lightning) default reasoning OFF, so adaptive
-            // sends the documented Fireworks Boolean enable (#457). The literal
-            // "adaptive" is MiniMax-M3-only — Fireworks 400s it for every other
-            // model (wire-verified; the 1.0.2 adaptive default refused to boot on
-            // it). V4 gotcha: integer efforts 400.
-            case "effort_explicit": return mode === "off"
-                ? { reasoning_effort: "none" }
-                : mode === "adaptive"
-                    ? this.#reasoningToggle ? { reasoning_effort: true } : {}
-                    : { reasoning_effort: fixedEffort(mode) };
-            // {§deepseek-reasoning-request}
-            case "thinking_effort": return mode === "off"
-                ? { thinking: { type: "disabled" } }
-                : mode === "adaptive" ? { thinking: { type: "enabled" } } : {
-                    thinking: { type: "enabled" },
-                    reasoning_effort: fixedEffort(mode),
-                };
-            // Anthropic-compatible native dynamic or manual budget mode.
-            case "anthropic": return mode === "off"
-                ? { thinking: { type: "disabled" } }
-                : mode === "adaptive" ? { thinking: { type: "adaptive" } } : {
-                    thinking: {
-                        type: "enabled",
-                        budget_tokens: budget,
-                    },
-                };
-            case "none": return {};
-        }
-    }
-    // Per-worker slot affinity: the consumer passes which worker this is; the
-    // provider owns WHICH slot serves it. Sticky per workerId, round-robin across
-    // new runs (distinct runs → distinct slots while slots last), LRU-bounded
-    // bookkeeping so a long-lived daemon never grows the map unboundedly —
-    // an evicted-and-returning run simply re-pins, worst case one cold prefill.
-    #runSlots = new Map();
-    #nextSlot = 0;
-    #slotBody(workerId) {
-        if (!this.#supportsSlotPinning || this.#slotCount === null || this.#slotCount < 1)
-            return {};
-        let slot = this.#runSlots.get(workerId);
-        if (slot === undefined) {
-            slot = this.#nextSlot++ % this.#slotCount;
-            if (this.#runSlots.size >= this.#slotCount * 8) {
-                this.#runSlots.delete(this.#runSlots.keys().next().value);
-            }
-        }
-        else {
-            this.#runSlots.delete(workerId); // re-insert to refresh LRU recency
-        }
-        this.#runSlots.set(workerId, slot);
-        return { id_slot: slot };
-    }
-    // Optional local llama-server GBNF transport ({§gbnf-response-observation}). Unsupported
-    // backends receive no grammar-related field.
-    #grammarBody(grammar) {
-        if (grammar === undefined)
-            return {};
-        switch (this.#grammarStyle) {
-            // Grammar-constrained decoding can loop under the mask; a configured
-            // per-alias repeat_penalty is the measured remedy ({§provider-sampling-passthrough}).
-            case "llamacpp": return { grammar, ...(this.#repeatPenalty !== null ? { repeat_penalty: this.#repeatPenalty } : {}) };
-            case "none": return {};
-        }
-    }
-    // Anti-degeneration default on every request, keyed to the backend's wire
-    // convention - NOT grammar-bound. GBNF is a local constraint, so a cloud
-    // alias runs the sampler bare: firefast (deepseek/fireworks) ran 4/86 bench turns
-    // straight to the token cap on pure looped repetition (run52). Ships next to
-    // temperature so caller `sampling` can tune it; the grammar path re-asserts it as a
-    // managed FLOOR in #grammarBody. llama.cpp takes the repeat_penalty
-    // MULTIPLIER; the plain cloud path ("none") can't, so it gets
-    // frequency_penalty - OpenAI-standard, accepted by every OpenAI-compat backend (verified
-    // live: together/deepinfra/fireworks; it is OpenAI's own param, so real OpenAI takes it too).
-    #repetitionPenaltyBody() {
-        switch (this.#grammarStyle) {
-            // repeat_penalty + optional DRY (repeated-sequence penalty) + a wider
-            // repeat_last_n window — the loop-breaking tools a llama.cpp backend serves.
-            // Each rides only when its operator knob is set; absent = the box's default.
-            case "llamacpp": return {
-                ...(this.#repeatPenalty !== null ? { repeat_penalty: this.#repeatPenalty } : {}),
-                ...(this.#repeatLastN !== undefined ? { repeat_last_n: this.#repeatLastN } : {}),
-                ...(this.#dryMultiplier !== undefined && this.#dryMultiplier > 0 ? {
-                    dry_multiplier: this.#dryMultiplier,
-                    ...(this.#dryBase !== undefined ? { dry_base: this.#dryBase } : {}),
-                    ...(this.#dryAllowedLength !== undefined ? { dry_allowed_length: this.#dryAllowedLength } : {}),
-                } : {}),
-            };
-            case "none": return this.#frequencyPenalty > 0 ? { frequency_penalty: this.#frequencyPenalty } : {};
-        }
-    }
-    // First-party telemetry headers ({§provider-request-authority} {§provider-call-kind}): forwarded only when the spec
-    // opted in (the plurnk endpoint). The gate is here, not at the call site, so
-    // attributions/client/strikes can never reach a third-party backend even if
-    // the consumer passes them to the wrong provider. Empty values emit no header
-    // — EXCEPT strikes, where 0 is a real value (clean streak) distinct from
-    // absent (consumer didn't report); contract {§strikes-first-party-metadata}. Strikes
-    // ride HTTP headers only — the packet never carries them (the model must
-    // never see strike state; engine accounting is not a metric to game).
-    #metadataHeaders(attributions, client, strikes, workerId, primaryWorkerId, workspaceId, loop, turn, callKind) {
-        if (!this.#firstPartyMetadata)
-            return {};
-        const h = {};
-        if (attributions !== undefined && attributions.length > 0)
-            h["Plurnk-Attribution"] = JSON.stringify(attributions);
-        if (client !== undefined && client.length > 0)
-            h["Plurnk-Client"] = client;
-        if (strikes !== undefined && Number.isInteger(strikes) && strikes >= 0)
-            h["Plurnk-Strikes"] = String(strikes);
-        // Worker identity: the opaque workerId
-        // the consumer already supplies, forwarded so the endpoint can key
-        // per-worker affinity/telemetry — same gate as every first-party signal.
-        h["Plurnk-Worker-Id"] = workerId;
-        // Root worker of the lineage ({§worker-primary}): the no-parent ancestor of this turn's
-        // worker tree. The consumer classifies primary-vs-spawned by equality
-        // (primaryWorkerId == workerId ⇒ the primary/root worker). The provider
-        // EMITS what the consumer supplies and never invents a primary; the
-        // consumer's contract is to stamp it EVERY turn (including the primary's
-        // own, where it equals workerId). Absence is the consumer's violation for
-        // the endpoint to surface, not a provider default.
-        if (primaryWorkerId !== undefined && primaryWorkerId.length > 0)
-            h["Plurnk-Worker-Primary"] = primaryWorkerId;
-        // Turn coordinate ({§lifecycle-terms}): workspace/loop/turn, the
-        // daemon-side sequence the endpoint can never scrape from the wire.
-        // Coordinates are 1-based — 0 is not a real value, so no strikes-style
-        // zero exception; absent/empty/0 emits no header.
-        if (workspaceId !== undefined && workspaceId.length > 0)
-            h["Plurnk-Workspace-Id"] = workspaceId;
-        if (loop !== undefined && Number.isInteger(loop) && loop >= 1)
-            h["Plurnk-Loop"] = String(loop);
-        if (turn !== undefined && Number.isInteger(turn) && turn >= 1)
-            h["Plurnk-Turn"] = String(turn);
-        if (callKind !== undefined)
-            h["Plurnk-Call-Kind"] = callKind;
-        return h;
-    }
-    // PLURNK_PROVIDERS_GBNF_DEBUG ({§gbnf-response-observation}): validate the supplied GBNF locally and fail
-    // hard if it's malformed, BEFORE any wire call — and the grammar is NOT
-    // transported, so the request runs unconstrained. A debug aid to catch invalid
-    // grammars (e.g. while editing the plurnk grammar) without a model round-trip;
-    // off in production. `validateGbnf(grammar, "")` parses the grammar + resolves
-    // its root, throwing iff the grammar itself is invalid (the empty input's
-    // verdict is irrelevant — we only care that parsing succeeded).
-    #assertGrammarValid(grammar) {
-        try {
-            validateGbnf(grammar, "");
-        }
-        catch (cause) {
-            throw new Error(`grammar validation (PLURNK_PROVIDERS_GBNF_DEBUG): invalid GBNF — ${cause.message}`, { cause });
-        }
-    }
     // Per-turn metadata bag: pass the backend's non-standard top-level fields
     // through verbatim. Providers do not reinterpret vendor currency or account
     // metadata; a monetary value carries its own amount and currency.
@@ -671,71 +441,6 @@ export default class AiSdkProvider {
         const meta = { ...chunkMetadata };
         return Object.keys(meta).length > 0 ? meta : undefined;
     }
-    // Caller-supplied OpenAI-compat sampling params (temperature, top_p, top_k,
-    // penalties, stop, seed, …) merged UNDER the managed body: model, messages,
-    // reasoning, grammar (+ its repeat-penalty floor), max_tokens and slot always
-    // win, and reserved transport/protocol keys are stripped so the passthrough
-    // can't smuggle a grammar, a stream toggle, or a backend slot
-    // ({§provider-request-authority}).
-    #samplingBody(sampling) {
-        if (sampling === undefined)
-            return {};
-        const out = {};
-        for (const [k, v] of Object.entries(sampling))
-            if (!RESERVED_BODY_KEYS.has(k))
-                out[k] = v;
-        return out;
-    }
-    #requestProviderOptions(workerId, nativeReasoningBudget) {
-        const responseOptions = this.#reasoning.mode === "off"
-            ? undefined
-            : this.#reasoningResponseProviderOptions;
-        const adaptiveOptions = this.#reasoning.mode === "adaptive"
-            && nativeReasoningBudget === null
-            ? this.#adaptiveReasoningProviderOptions
-            : undefined;
-        const nativeReasoning = nativeReasoningBudget !== null
-            ? this.#additiveReasoningProvider === "anthropic"
-                ? { anthropic: { thinking: { type: "enabled", budgetTokens: nativeReasoningBudget } } }
-                : this.#additiveReasoningProvider === "bedrock"
-                    ? { bedrock: { reasoningConfig: { type: "enabled", budgetTokens: nativeReasoningBudget } } }
-                    : undefined
-            : undefined;
-        const options = {};
-        for (const part of [responseOptions, adaptiveOptions, nativeReasoning]) {
-            for (const [provider, values] of Object.entries(part ?? {})) {
-                options[provider] = mergeJsonObjects(options[provider] ?? {}, values);
-            }
-        }
-        if (this.#cacheAffinity?.target === "provider-option") {
-            const { provider, name } = this.#cacheAffinity;
-            options[provider] = { ...options[provider], [name]: workerId };
-        }
-        return Object.keys(options).length === 0 ? undefined : options;
-    }
-    #nativeMaxOutputTokens(outputBudget, nativeReasoningBudget) {
-        if (outputBudget === null)
-            return undefined;
-        return nativeReasoningBudget !== null
-            ? outputBudget - nativeReasoningBudget
-            : outputBudget;
-    }
-    #nativeReasoningBudget(outputBudget, configuredReasoningBudget) {
-        if (this.#additiveReasoningProvider === undefined || this.#reasoning.mode === "off")
-            return null;
-        if (configuredReasoningBudget !== null)
-            return configuredReasoningBudget;
-        if (this.#adaptiveReasoningProviderOptions !== undefined)
-            return null;
-        if (outputBudget === null) {
-            throw new TypeError(`${this.#source}: manual provider reasoning requires a resolved total output budget`);
-        }
-        if (outputBudget <= MANUAL_REASONING_MINIMUM) {
-            throw new TypeError(`${this.#source}: total output budget must exceed the provider's ${MANUAL_REASONING_MINIMUM}-token minimum reasoning allowance`);
-        }
-        const fraction = MANUAL_REASONING_FRACTIONS[this.#reasoning.mode];
-        return Math.min(outputBudget - 1, Math.max(MANUAL_REASONING_MINIMUM, Math.round(outputBudget * fraction)));
-    }
     #accounting(outcome, usage, evidence, status) {
         const knownUsage = usage === undefined ? undefined : validateProviderUsage(usage);
         const direct = this.#normalizeCost?.(evidence);
@@ -762,7 +467,7 @@ export default class AiSdkProvider {
         // supplied grammar before the call but withholds it from the backend.
         const wantGrammar = grammar !== undefined && this.#grammarStyle !== "none";
         if (wantGrammar && this.#gbnfDebug)
-            this.#assertGrammarValid(grammar);
+            this.#requestBody.assertGrammarValid(grammar);
         const sendGrammar = wantGrammar && !this.#gbnfDebug ? grammar : undefined;
         const preserveGrammarSentence = wantGrammar
             && this.#reasoningStyle === "template";
@@ -776,7 +481,7 @@ export default class AiSdkProvider {
         // {§provider-flexed-allowance} (#482): the wire grants the flexed
         // allowance — the floor, or the exactly-measured slack above it.
         const effectiveMaxOutputTokens = capacity.responseMax ?? capacity.outputBudget ?? undefined;
-        const nativeReasoningBudget = this.#nativeReasoningBudget(capacity.outputBudget, capacity.reasoningBudget);
+        const nativeReasoningBudget = this.#requestBody.nativeReasoningBudget(capacity.outputBudget, capacity.reasoningBudget);
         // Assembly order = precedence: the family's sampling DEFAULTS
         // (PLURNK_PROVIDERS_TEMPERATURE — universal, measured on grammar
         // paths and the name promises every request) < the caller's `sampling`
@@ -784,24 +489,24 @@ export default class AiSdkProvider {
         const body = {
             // Floors are suppressed on router-owned-tuning providers (plurnk) —
             // the router's per-model tuning must not be overridden by client floors.
-            ...(this.#tuningFloors ? { ...(this.#temperature !== null ? { temperature: this.#temperature } : {}), ...this.#repetitionPenaltyBody() } : {}),
-            ...this.#samplingBody(sampling),
+            ...(this.#tuningFloors ? { ...(this.#temperature !== null ? { temperature: this.#temperature } : {}), ...this.#requestBody.repetitionPenaltyBody() } : {}),
+            ...this.#requestBody.samplingBody(sampling),
             ...(this.#serviceTier !== undefined ? { service_tier: this.#serviceTier } : {}),
             model: this.#model,
             messages,
-            ...this.#reasoningBody(preserveGrammarSentence, capacity.reasoningBudget),
-            ...this.#grammarBody(sendGrammar),
+            ...this.#requestBody.reasoningBody(preserveGrammarSentence, capacity.reasoningBudget),
+            ...this.#requestBody.grammarBody(sendGrammar),
             ...(effectiveMaxOutputTokens !== undefined ? { max_tokens: effectiveMaxOutputTokens } : {}),
             // Request per-token logprobs only when enabled (managed field —
             // reserved from caller sampling; the env flag is the single control).
             ...(this.#topLogprobs !== null ? { logprobs: true, top_logprobs: this.#topLogprobs } : {}),
-            ...this.#slotBody(workerId),
+            ...this.#requestBody.slotBody(workerId),
             ...(this.#cacheAffinity?.target === "body"
                 ? { [this.#cacheAffinity.name]: workerId }
                 : {}),
         };
         // Per-request headers = static auth/routing + any first-party telemetry.
-        const metaHeaders = this.#metadataHeaders(attributions, client, strikes, workerId, primaryWorkerId, workspaceId, loop, turn, callKind);
+        const metaHeaders = this.#requestBody.metadataHeaders(attributions, client, strikes, workerId, primaryWorkerId, workspaceId, loop, turn, callKind);
         const headers = new Headers(this.#headers);
         if (this.#cacheAffinity?.target === "header") {
             headers.set(this.#cacheAffinity.name, workerId);
@@ -910,7 +615,7 @@ export default class AiSdkProvider {
                     : await executeAiSdkModel({
                         languageModel: this.#languageModel,
                         headers: requestHeaders,
-                        providerOptions: this.#requestProviderOptions(workerId, nativeReasoningBudget),
+                        providerOptions: this.#requestBody.requestProviderOptions(workerId, nativeReasoningBudget),
                         systemProviderOptions: this.#systemCacheProviderOptions,
                         messages,
                         signal: operationSignal,
@@ -935,7 +640,7 @@ export default class AiSdkProvider {
                                 ? sampling.stop
                                 : undefined,
                         seed: typeof sampling?.seed === "number" ? sampling.seed : undefined,
-                        maxOutputTokens: this.#nativeMaxOutputTokens(capacity.outputBudget, nativeReasoningBudget),
+                        maxOutputTokens: this.#requestBody.nativeMaxOutputTokens(capacity.outputBudget, nativeReasoningBudget),
                         reasoning: this.#reasoning.mode === "off"
                             ? "none"
                             : this.#reasoning.mode === "adaptive"
@@ -960,7 +665,13 @@ export default class AiSdkProvider {
                 maxRetries: this.#retryAttempts,
                 abortSignal: operationSignal,
             });
-            raw = await retry(executeRequest);
+            // {§provider-connectivity} — the operation deadline and caller cancellation are backstopped by
+            // racing, not only by the advisory operationSignal, so a transport that ignores the abort still
+            // surfaces the deadline (→ the operationTimeout/caller branches below) rather than hanging the
+            // loop (#505). A well-behaved transport settles first and wins the race with its own evidence.
+            raw = operationSignal === undefined
+                ? await retry(executeRequest)
+                : await raceAgainstDeadline(retry(executeRequest), operationSignal);
         }
         catch (err) {
             if (err instanceof ProviderRequestObserverError