@plurnk/plurnk-providers 1.10.0 → 1.11.0

package/src/catalogProvider.ts

@@ -32,7 +32,7 @@ const reasoningStyleFromEnv = (
     if (value === undefined || value.length === 0) return undefined;
     const styles: readonly ReasoningStyle[] = [
         "none", "think", "include_reasoning", "effort",
-        "effort_explicit", "thinking_effort", "template", "anthropic",
+        "effort_explicit", "effort_required", "thinking_effort", "template", "anthropic",
     ];
     if (!styles.includes(value as ReasoningStyle)) {
         throw new Error(`${name} provider: PLURNK_PROVIDERS_PROVIDER_${prefix}_REASONING_STYLE has invalid value "${value}"`);
@@ -89,6 +89,7 @@ const supportedReasoningPolicies = ({
         return REASONING_POLICIES;
     }
     if (style === "effort" || style === "effort_explicit") return REASONING_POLICIES;
+    if (style === "effort_required") return reasoningWithoutOff;
     if (style === "thinking_effort") return deepSeekPolicies;
     return activationPolicies;
 };
@@ -189,8 +190,10 @@ export const providerFromSdkModel = ({
         maxOutputTokens,
     );
     const reasoning = reasoningFromEnv(env, name, envelope.reasoningBudget);
-    const reasoningStyle = reasoningStyleFromEnv(env, name) ?? "none";
     const reasoningCapable = info?.reasoning === true;
+    const reasoningStyle = info?.reasoning === false
+        ? "none"
+        : reasoningStyleFromEnv(env, name) ?? "none";
     const adaptiveReasoning = adaptiveReasoningProjection({
         sdkPackage,
         model,
@@ -285,7 +288,7 @@ export const catalogProviderFromEnv = (
         );
     }
     const wireModel = resolved?.id ?? model;
-    const sdk = createSdkModel(name, wireModel, env, baseUrlOverride);
+    const sdk = createSdkModel(name, wireModel, env, baseUrlOverride, reasoningFromEnv(env, name).mode);
     if (sdk === null) return null;
 
     const info = resolved?.info;

package/src/discover.test.ts

@@ -30,7 +30,7 @@ test("discover: the node_modules scan is scope-agnostic — third-party scopes a
         "@acme/acme-provider-foo": { name: "@acme/acme-provider-foo", plurnk: { kind: "provider", name: "foo" } },
         "unscoped-provider-bar": { name: "unscoped-provider-bar", plurnk: { kind: "provider", name: "bar" } },
         "left-pad": { name: "left-pad" },                                   // no plurnk block → ignored
-        "@plurnk/plurnk-execs-git": { name: "@plurnk/plurnk-execs-git", plurnk: { kind: "exec", runtimes: [] } }, // wrong kind → ignored
+        "@acme/acme-execs-wrong-kind": { name: "@acme/acme-execs-wrong-kind", plurnk: { kind: "exec", runtimes: [] } }, // wrong kind → ignored
     });
     const { registry } = await discover({ cwd: root });
     assert.deepEqual([...registry.keys()].sort(), ["bar", "foo", "native"]);

package/src/notices.ts

@@ -1,4 +1,4 @@
-export type ProviderNoticeKind = "grammar_unenforced" | "provider_warning";
+export type ProviderNoticeKind = "grammar_unenforced" | "provider_warning" | "provider_retry";
 
 // Observations about a completed model exchange. These never represent a
 // failed provider operation; transport failures throw ProviderError with an

package/src/sdkModels.test.ts

@@ -123,6 +123,22 @@ test("createSdkModel constructs Cerebras from Models.dev facts", () => {
     assert.equal(sdk?.compatible, undefined);
 });
 
+test("{§provider-reasoning-policy} createSdkModel represents a fixed OpenRouter policy in the model settings", () => {
+    const env = {
+        OPENROUTER_API_KEY: "test-key",
+        OPENROUTER_HTTP_REFERER: "https://github.com/plurnk/plurnk-service",
+        OPENROUTER_APP_TITLE: "Plurnk",
+    };
+    const settings = (reasoning?: "off" | "adaptive" | "low" | "medium" | "high"): unknown =>
+        (createSdkModel("openrouter", "z-ai/glm-5.3-flash", env, undefined, reasoning)?.languageModel as { settings?: { reasoning?: unknown } } | undefined)?.settings?.reasoning;
+    assert.deepEqual(settings("low"), { effort: "low" });
+    assert.deepEqual(settings("medium"), { effort: "medium" });
+    assert.deepEqual(settings("high"), { effort: "high" });
+    assert.deepEqual(settings("off"), { effort: "none" });
+    assert.equal(settings("adaptive"), undefined);
+    assert.equal(settings(), undefined);
+});
+
 test("{§openrouter-app-attribution} attribution rejects malformed URLs and the retired title name", () => {
     assert.throws(
         () => createSdkModel("openrouter", "openai/gpt-5", {

package/src/sdkModels.ts

@@ -15,7 +15,7 @@ import {
     providerCatalogSnapshot,
     type ProviderInfo,
 } from "@plurnk/plurnk-models";
-import { Validator, type ModelReadiness, type ModelReadinessCause } from "@plurnk/plurnk-contracts";
+import { Validator, type ModelReadiness, type ModelReadinessCause, type ReasoningPolicy } from "@plurnk/plurnk-contracts";
 import type { LanguageModel } from "ai";
 import { providerCostNormalizer } from "./accounting.ts";
 import type { AiSdkProviderOptions, CacheAffinity } from "./AiSdkProvider.ts";
@@ -286,11 +286,23 @@ const requireApiKey = (
     return key;
 };
 
+// {§provider-reasoning-policy} — the OpenRouter SDK builds its request from the model
+// settings alone (neither the generic `reasoning` call setting nor provider options reach
+// its body), so a fixed policy and `off` are represented there; `adaptive` leaves the
+// route's provider default.
+const openRouterReasoningSettings = (
+    reasoning: ReasoningPolicy | undefined,
+): { reasoning?: { effort: "none" | "low" | "medium" | "high" } } =>
+    reasoning === undefined || reasoning === "adaptive"
+        ? {}
+        : { reasoning: { effort: reasoning === "off" ? "none" : reasoning } };
+
 export const createSdkModel = (
     provider: string,
     model: string,
     env: NodeJS.ProcessEnv,
     baseUrlOverride?: string,
+    reasoning?: ReasoningPolicy,
 ): SdkModel | null => {
     const catalog = lookupProvider(provider) ?? configuredProviderInfo(provider, env);
     if (catalog === null) return null;
@@ -386,7 +398,7 @@ export const createSdkModel = (
                     apiKey: requireApiKey(provider, env, catalog),
                     baseURL: url,
                     headers: openRouterHeaders(provider, env, catalog),
-                }).languageModel(model),
+                }).languageModel(model, openRouterReasoningSettings(reasoning)),
                 ...(catalog.id === "openrouter"
                     ? { cacheAffinity: { target: "header" as const, name: "x-session-id" } }
                     : {}),