@truefoundry/assistant-ui-runtime 0.1.17 → 0.1.18

package/dist/plugins/truefoundry-agent-server-adapter/index.d.ts

@@ -1,6 +1,6 @@
 import { AgentSessionClient } from 'truefoundry-gateway-sdk/agents';
 import { PrivateAgentSessionClient } from 'truefoundry-gateway-sdk/agents/private';
-import { A as AgentSpec, N as CreateSessionRequest, Y as ListSessionsParams, S as Session, d as Turn, aE as TurnState, a as AgentChatServer, aM as UpdateSessionRequest, k as AgentSelectorEntry, G as ConnectorSelectorEntry, a8 as ModelSelectorEntry, az as SkillSelectorEntry, g as AgentBuilderServer } from '../../types-CctJojlz.js';
+import { A as AgentSpec, N as CreateSessionRequest, Y as ListSessionsParams, S as Session, d as Turn, aE as TurnState, a as AgentChatServer, aM as UpdateSessionRequest, k as AgentSelectorEntry, G as ConnectorSelectorEntry, a8 as ModelSelectorEntry, az as SkillSelectorEntry, g as AgentBuilderServer } from '../../types-BRrQpoVy.js';
 import { TruefoundryGatewayApi } from 'truefoundry-gateway-sdk';
 
 /**
@@ -116,7 +116,11 @@ declare function createTrueFoundryChatServer<TSpec extends TfyAgentSpec = TfyAge
  */
 
 interface TfyModelSelectorEntry extends ModelSelectorEntry {
-    /** Write into AgentSpec.model.name (model_fqn). */
+    /**
+     * model_fqn for AgentSpec.model.name.
+     * Same value as {@link ModelSelectorEntry.name} / `id` — trueforge-ui writes
+     * `name` into the spec; keep this alias for hosts that still read `apiModel`.
+     */
     apiModel: string;
     modelId: string;
     providerAccount?: string;

package/dist/plugins/truefoundry-agent-server-adapter/index.js

@@ -7,7 +7,7 @@ import {
   isTfyMcpToolInfo,
   isTfySystemToolInfo,
   isTfyToolInfo
-} from "../../chunk-S4SH2KT2.js";
+} from "../../chunk-N6LJ3LR2.js";
 export {
   createTrueFoundryAgentUIServer,
   createTrueFoundryChatServer,

package/dist/server/index.d.ts

@@ -1,5 +1,5 @@
-import { aH as TurnStreamingEvent, aO as DeltaEvents, T as TurnEvent } from '../types-CctJojlz.js';
-export { aP as ActionRequiredEvent, f as AgentBuilderCapabilitiesResponse, g as AgentBuilderServer, h as AgentCapabilityConfig, a as AgentChatServer, aQ as AgentInfo, i as AgentLibraryEntry, aR as AgentParent, j as AgentRuntimeConfig, k as AgentSelectorEntry, l as AgentSkill, A as AgentSpec, m as AgentUIServer, n as AgentUIServerPort, o as ApprovalDecision, p as AuthenticateConnectorRequest, C as CatalogServer, aS as ChunkDeltaToolCall, q as ConnectorAuth, r as ConnectorAuthApiKey, s as ConnectorAuthNone, t as ConnectorAuthOAuth, u as ConnectorAuthPublic, v as ConnectorAuthPublicApiKey, w as ConnectorAuthPublicNone, x as ConnectorAuthPublicOAuth, y as ConnectorAuthType, z as ConnectorAuthenticationResult, B as ConnectorBase, D as ConnectorCatalogEntry, E as ConnectorCatalogServer, F as ConnectorConfigBase, G as ConnectorSelectorEntry, H as ConnectorState, I as CreateConnectorRequest, J as CreateModelProviderRequest, K as CreateSandboxProviderRequest, L as CreateSandboxRequest, N as CreateSessionRequest, O as CreateSkillRequest, P as CreateSkillRequestBase, Q as DefinedSkill, R as GithubSkill, V as ImportGithubSkillRequest, W as ListResult, X as ListSessionsOrder, Y as ListSessionsParams, M as McpAuthRequiredEvent, aT as McpInitializeEvent, aU as McpServerAuthInfo, Z as McpServerMount, _ as Model, $ as ModelCatalogServer, a0 as ModelEntry, aV as ModelMessageContentPart, aW as ModelMessageDeltaEvent, a1 as ModelMessageEvent, a2 as ModelParams, a3 as ModelProperties, a4 as ModelProviderBase, a5 as ModelProviderCatalogEntry, a6 as ModelProviderConfigBase, a7 as ModelSelection, a8 as ModelSelectorEntry, a9 as PageParams, aa as PreviousTurnIdInput, ab as ProviderEntry, ac as ProviderType, ad as RegistrySkill, ae as SandboxBase, af as SandboxCatalogEntry, ag as SandboxCatalogServer, ah as SandboxConfig, ai as SandboxCreatedEvent, aj as SandboxProviderBase, ak as SandboxProviderCatalogEntry, al as SandboxProviderConfig, am as SandboxProviderListEntry, an as SandboxSnapshotSyncStatus, ao as SaveAgentRequest, ap as SaveAgentResult, aq as SearchAgentSelectorParams, ar as SearchAgentsParams, as as SelectRegistrySkillRequest, S as Session, at as SessionEventItem, au as SkillBase, av as SkillCatalogEntry, aw as SkillCatalogServer, ax as SkillConfigBase, ay as SkillMount, az as SkillSelectorEntry, b as ThreadCreatedEvent, aX as ThreadDoneEvent, aA as ToolApprovalRequiredEvent, aB as ToolBase, aC as ToolCall, aY as ToolCallFunction, aZ as ToolCallRef, a_ as ToolInfo, a$ as ToolResponseEvent, aD as ToolResponseRequiredEvent, d as Turn, b0 as TurnCreatedEvent, b1 as TurnDoneEvent, e as TurnInputItem, aE as TurnState, b2 as TurnStateCancelled, aF as TurnStateDone, b3 as TurnStateError, b4 as TurnStateRunning, aG as TurnStreamData, aI as UpdateConnectorRequest, aJ as UpdateModelProviderRequest, aK as UpdateSandboxProviderRequest, aL as UpdateSandboxRequest, aM as UpdateSessionRequest, aN as UserMessage, b5 as UserMessageContent, c as UserToolApprovalEvent, U as UserToolResponseEvent } from '../types-CctJojlz.js';
+import { aH as TurnStreamingEvent, aO as DeltaEvents, T as TurnEvent } from '../types-BRrQpoVy.js';
+export { aP as ActionRequiredEvent, f as AgentBuilderCapabilitiesResponse, g as AgentBuilderServer, h as AgentCapabilityConfig, a as AgentChatServer, aQ as AgentInfo, i as AgentLibraryEntry, aR as AgentParent, j as AgentRuntimeConfig, k as AgentSelectorEntry, l as AgentSkill, A as AgentSpec, m as AgentUIServer, n as AgentUIServerPort, o as ApprovalDecision, p as AuthenticateConnectorRequest, C as CatalogServer, aS as ChunkDeltaToolCall, q as ConnectorAuth, r as ConnectorAuthApiKey, s as ConnectorAuthNone, t as ConnectorAuthOAuth, u as ConnectorAuthPublic, v as ConnectorAuthPublicApiKey, w as ConnectorAuthPublicNone, x as ConnectorAuthPublicOAuth, y as ConnectorAuthType, z as ConnectorAuthenticationResult, B as ConnectorBase, D as ConnectorCatalogEntry, E as ConnectorCatalogServer, F as ConnectorConfigBase, G as ConnectorSelectorEntry, H as ConnectorState, I as CreateConnectorRequest, J as CreateModelProviderRequest, K as CreateSandboxProviderRequest, L as CreateSandboxRequest, N as CreateSessionRequest, O as CreateSkillRequest, P as CreateSkillRequestBase, Q as DefinedSkill, R as GithubSkill, V as ImportGithubSkillRequest, W as ListResult, X as ListSessionsOrder, Y as ListSessionsParams, M as McpAuthRequiredEvent, aT as McpInitializeEvent, aU as McpServerAuthInfo, Z as McpServerMount, _ as Model, $ as ModelCatalogServer, a0 as ModelEntry, aV as ModelMessageContentPart, aW as ModelMessageDeltaEvent, a1 as ModelMessageEvent, a2 as ModelParams, a3 as ModelProperties, a4 as ModelProviderBase, a5 as ModelProviderCatalogEntry, a6 as ModelProviderConfigBase, a7 as ModelSelection, a8 as ModelSelectorEntry, a9 as PageParams, aa as PreviousTurnIdInput, ab as ProviderEntry, ac as ProviderType, ad as RegistrySkill, ae as SandboxBase, af as SandboxCatalogEntry, ag as SandboxCatalogServer, ah as SandboxConfig, ai as SandboxCreatedEvent, aj as SandboxProviderBase, ak as SandboxProviderCatalogEntry, al as SandboxProviderConfig, am as SandboxProviderListEntry, an as SandboxSnapshotSyncStatus, ao as SaveAgentRequest, ap as SaveAgentResult, aq as SearchAgentSelectorParams, ar as SearchAgentsParams, as as SelectRegistrySkillRequest, S as Session, at as SessionEventItem, au as SkillBase, av as SkillCatalogEntry, aw as SkillCatalogServer, ax as SkillConfigBase, ay as SkillMount, az as SkillSelectorEntry, b as ThreadCreatedEvent, aX as ThreadDoneEvent, aA as ToolApprovalRequiredEvent, aB as ToolBase, aC as ToolCall, aY as ToolCallFunction, aZ as ToolCallRef, a_ as ToolInfo, a$ as ToolResponseEvent, aD as ToolResponseRequiredEvent, d as Turn, b0 as TurnCreatedEvent, b1 as TurnDoneEvent, e as TurnInputItem, aE as TurnState, b2 as TurnStateCancelled, aF as TurnStateDone, b3 as TurnStateError, b4 as TurnStateRunning, aG as TurnStreamData, aI as UpdateConnectorRequest, aJ as UpdateModelProviderRequest, aK as UpdateSandboxProviderRequest, aL as UpdateSandboxRequest, aM as UpdateSessionRequest, aN as UserMessage, b5 as UserMessageContent, c as UserToolApprovalEvent, U as UserToolResponseEvent } from '../types-BRrQpoVy.js';
 
 /**
  * Local implementations of streaming delta helpers.

package/dist/{types-CctJojlz.d.ts → types-BRrQpoVy.d.ts}

@@ -632,6 +632,7 @@ type ConnectorAuthPublic = ConnectorAuthPublicOAuth | ConnectorAuthPublicApiKey
  */
 interface ConnectorConfigBase<TAuth extends ConnectorAuth = ConnectorAuth> {
     name: string;
+    description: string;
     url: string;
     auth: TAuth;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@truefoundry/assistant-ui-runtime",
-  "version": "0.1.17",
+  "version": "0.1.18",
   "description": "TrueFoundry Gateway agent runtime adapter for assistant-ui",
   "license": "Apache-2.0",
   "repository": {
@@ -81,4 +81,4 @@
     "typescript": "^5.9.3",
     "vitest": "4.1.9"
   }
-}
+}

package/src/hooks.ts

@@ -6,7 +6,8 @@ import { useAui, useAuiState } from "@assistant-ui/store";
 import type { TrueFoundryMessageCustomMetadata } from "./messageCustomMetadata.js";
 import {
     EMPTY_DRAFT_EXTRAS,
-    trueFoundryExtras,
+    getTrueFoundryExtras,
+    useTrueFoundryRuntimeExtras,
     type TrueFoundryDraftRuntimeExtras,
 } from "./truefoundryExtras.js";
 import type { RespondToToolApprovalOptions } from "./toolApproval.js";
@@ -14,7 +15,7 @@ import type { RespondToToolResponseOptions } from "./toolResponse.js";
 
 /** Pending tool approvals plus a respond action. */
 export const useTrueFoundryApprovals = () => {
-    const extras = trueFoundryExtras.use((e) => e, undefined);
+    const extras = useTrueFoundryRuntimeExtras();
 
     return useMemo(
         () => ({
@@ -31,7 +32,7 @@ export const useTrueFoundryApprovals = () => {
 
 /** Pending ask-user tool responses plus a respond action. */
 export const useTrueFoundryToolResponses = () => {
-    const extras = trueFoundryExtras.use((e) => e, undefined);
+    const extras = useTrueFoundryRuntimeExtras();
 
     return useMemo(
         () => ({
@@ -48,7 +49,7 @@ export const useTrueFoundryToolResponses = () => {
 
 /** Pending MCP OAuth plus a resume action. */
 export const useTrueFoundryMcpAuth = () => {
-    const extras = trueFoundryExtras.use((e) => e, undefined);
+    const extras = useTrueFoundryRuntimeExtras();
 
     return useMemo(
         () => ({
@@ -67,25 +68,25 @@ export const useTrueFoundryMcpAuth = () => {
 export const useTrueFoundryRespondToToolApproval = () => {
     const aui = useAui();
     return (response: RespondToToolApprovalOptions) =>
-        trueFoundryExtras.get(aui).respondToToolApproval(response);
+        getTrueFoundryExtras(aui).respondToToolApproval(response);
 };
 
 /** Returns a function to respond to a pending tool response from any render context. */
 export const useTrueFoundryRespondToToolResponse = () => {
     const aui = useAui();
     return (response: RespondToToolResponseOptions) =>
-        trueFoundryExtras.get(aui).respondToToolResponse(response);
+        getTrueFoundryExtras(aui).respondToToolResponse(response);
 };
 
 /** Returns a function to resume after MCP OAuth from any render context. */
 export const useTrueFoundryResumeMcpAuth = () => {
     const aui = useAui();
-    return () => trueFoundryExtras.get(aui).resumeMcpAuth();
+    return () => getTrueFoundryExtras(aui).resumeMcpAuth();
 };
 
 /** Current sandboxId for this session, if a sandbox has been created. */
 export const useTrueFoundrySandboxId = (): string | undefined =>
-    trueFoundryExtras.use((e) => e.sandboxId, undefined);
+    useTrueFoundryRuntimeExtras()?.sandboxId;
 
 /** Turn that produced the message being rendered. Only defined inside a message scope. */
 export const useTrueFoundryTurnId = (): string | undefined =>
@@ -108,25 +109,25 @@ export const useTrueFoundryDownloadSandboxFile = () => {
                 "Downloading a sandbox file requires a message scope to resolve its turn.",
             );
         }
-        return trueFoundryExtras.get(aui).downloadSandboxFile({ turnId, path });
+        return getTrueFoundryExtras(aui).downloadSandboxFile({ turnId, path });
     };
 };
 
 /** Returns a function to cancel the current run from any render context. */
 export const useTrueFoundryCancel = () => {
     const aui = useAui();
-    return () => trueFoundryExtras.get(aui).cancel();
+    return () => getTrueFoundryExtras(aui).cancel();
 };
 
 /** Returns a function to reload (retry) the current session from any render context. */
 export const useTrueFoundryReload = () => {
     const aui = useAui();
-    return () => trueFoundryExtras.get(aui).reload();
+    return () => getTrueFoundryExtras(aui).reload();
 };
 
 /** Older history pagination state plus a load-more action for scroll-up. */
 export const useTrueFoundryHistoryPagination = () => {
-    const extras = trueFoundryExtras.use((e) => e, undefined);
+    const extras = useTrueFoundryRuntimeExtras();
 
     return useMemo(
         () => ({
@@ -147,17 +148,17 @@ export const useTrueFoundryHistoryPagination = () => {
  * arrive in this client. Falls back to `false` on runtimes that predate the flag.
  */
 export const useTrueFoundryResumeUnavailable = () =>
-    trueFoundryExtras.use((e) => e.resumeUnavailable, false) ?? false;
+    useTrueFoundryRuntimeExtras()?.resumeUnavailable ?? false;
 
 /** Returns a function to reset (re-submit) a user turn from any render context. */
 export const useTrueFoundryResetFromTurn = () => {
     const aui = useAui();
-    return (turnId: string) => trueFoundryExtras.get(aui).resetFromTurn(turnId);
+    return (turnId: string) => getTrueFoundryExtras(aui).resetFromTurn(turnId);
 };
 
 /** Current draft agent spec and sync state (draft mode only). */
 export const useTrueFoundryAgentSpec = () => {
-    const extras = trueFoundryExtras.use((e) => e.draft, null);
+    const extras = useTrueFoundryRuntimeExtras()?.draft ?? null;
 
     return useMemo(
         () => ({ ...EMPTY_DRAFT_EXTRAS, ...extras }),
@@ -169,14 +170,14 @@ export const useTrueFoundryAgentSpec = () => {
 export const useTrueFoundryUpdateAgentSpec = () => {
     const aui = useAui();
     return (update: Parameters<TrueFoundryDraftRuntimeExtras["updateAgentSpec"]>[0]) =>
-        trueFoundryExtras.get(aui).draft?.updateAgentSpec(update);
+        getTrueFoundryExtras(aui).draft?.updateAgentSpec(update);
 };
 
 /** Flushes any pending draft-spec synchronization before a coordinated write. */
 export const useTrueFoundryFlushAgentSpec = () => {
     const aui = useAui();
     return () =>
-        trueFoundryExtras.get(aui).draft?.flushAgentSpec() ?? Promise.resolve();
+        getTrueFoundryExtras(aui).draft?.flushAgentSpec() ?? Promise.resolve();
 };
 
 /** Adopts a spec already persisted by another server operation without syncing again. */
@@ -184,6 +185,5 @@ export const useTrueFoundryAdoptAgentSpec = () => {
     const aui = useAui();
     return (
         request: Parameters<TrueFoundryDraftRuntimeExtras["adoptAgentSpec"]>[0],
-    ) => trueFoundryExtras.get(aui).draft?.adoptAgentSpec(request);
+    ) => getTrueFoundryExtras(aui).draft?.adoptAgentSpec(request);
 };
-

package/src/index.ts

@@ -42,7 +42,11 @@ export type {
 } from "./messageCustomMetadata.js";
 export type { PendingApproval, PendingToolResponse } from "./collectPending.js";
 export type { TrueFoundryRuntimeExtras } from "./truefoundryExtras.js";
-export { trueFoundryExtras } from "./truefoundryExtras.js";
+export {
+    trueFoundryExtras,
+    getTrueFoundryExtras,
+    tryGetTrueFoundryExtras,
+} from "./truefoundryExtras.js";
 export {
     useTrueFoundryApprovals,
     useTrueFoundryToolResponses,

package/src/plugins/truefoundry-agent-server-adapter/README.md

@@ -89,7 +89,7 @@ Implemented against Control Plane HTTP (not the gateway SDK):
 
 | Method | CP path |
 | ------ | ------- |
-| `getModels` | `GET /api/svc/v1/llm-gateway/model/enabled` |
+| `getModels` | `GET /api/svc/v1/llm-gateway/model/enabled` (+ `GET /api/svc/v1/provider-accounts/providers` for `properties.reasoningEfforts`) |
 | `getSkills` | `GET /api/ml/v1/agent-skills?include_empty_agent_skills=false` |
 | `getMcp` | `GET /api/svc/v1/mcp-servers` |
 | `searchAgents` | `GET /api/svc/v1/agents?type=truefoundry-agent&…` |

package/src/plugins/truefoundry-agent-server-adapter/cp.test.ts

@@ -150,7 +150,7 @@ describe("normalizeEnabledModels", () => {
         expect(rows).toEqual([
             {
                 id: "openai-main/gpt-4.1",
-                name: "gpt-4.1",
+                name: "openai-main/gpt-4.1",
                 provider: { name: "openai" },
                 properties: {},
                 apiModel: "openai-main/gpt-4.1",
@@ -159,7 +159,7 @@ describe("normalizeEnabledModels", () => {
             },
             {
                 id: "anthropic-prod/claude-sonnet-4-6",
-                name: "claude-sonnet-4-6",
+                name: "anthropic-prod/claude-sonnet-4-6",
                 provider: { name: "anthropic" },
                 properties: {},
                 apiModel: "anthropic-prod/claude-sonnet-4-6",
@@ -186,7 +186,7 @@ describe("normalizeEnabledModels", () => {
         expect(rows).toEqual([
             {
                 id: "virtual-main/router",
-                name: "router",
+                name: "virtual-main/router",
                 provider: { name: "virtual-model" },
                 properties: {},
                 apiModel: "virtual-main/router",

package/src/plugins/truefoundry-agent-server-adapter/cp.ts

@@ -13,6 +13,11 @@ import type {
     SearchAgentSelectorParams,
     SkillSelectorEntry,
 } from "../../server/types.js";
+import {
+    buildMetadataMap,
+    metadataKey,
+    reasoningEffortsForModel,
+} from "./modelReasoningEffort.js";
 import { normalizeAgentSpecForGateway } from "./normalizeAgentSpec.js";
 import type { TfyAgentSpec } from "./types.js";
 
@@ -21,7 +26,11 @@ import type { TfyAgentSpec } from "./types.js";
 // ---------------------------------------------------------------------------
 
 export interface TfyModelSelectorEntry extends ModelSelectorEntry {
-    /** Write into AgentSpec.model.name (model_fqn). */
+    /**
+     * model_fqn for AgentSpec.model.name.
+     * Same value as {@link ModelSelectorEntry.name} / `id` — trueforge-ui writes
+     * `name` into the spec; keep this alias for hosts that still read `apiModel`.
+     */
     apiModel: string;
     modelId: string;
     providerAccount?: string;
@@ -158,15 +167,17 @@ function isChatModel(row: RawEnabledModel): boolean {
 
 function toModelEntry(row: RawEnabledModel): TfyModelSelectorEntry | null {
     if (!isChatModel(row)) return null;
+    // Gateway AgentSpec.model.name must be model_fqn (e.g. account/model-id).
+    // trueforge-ui DraftModelSelector writes ModelSelectorEntry.name into that
+    // field, so `name` is the FQN — not the CP short display label.
     const apiModel = row.model_fqn ?? row.id;
-    const name = row.name;
-    if (apiModel == null || apiModel === "" || name == null || name === "") {
+    if (apiModel == null || apiModel === "") {
         return null;
     }
-    const modelId = row.model_id ?? name;
+    const modelId = row.model_id ?? row.name ?? apiModel;
     return {
         id: apiModel,
-        name,
+        name: apiModel,
         provider: { name: row.provider ?? "unknown" },
         properties: {},
         apiModel,
@@ -219,14 +230,44 @@ export function normalizeEnabledModels(raw: unknown): TfyModelSelectorEntry[] {
     return out;
 }
 
+/**
+ * Attach `properties.reasoningEfforts` from provider-account metadata when the
+ * model supports thinking. Pure — used by {@link listEnabledModels} and tests.
+ */
+export function enrichModelsWithReasoningEfforts(
+    models: TfyModelSelectorEntry[],
+    providerMetadataRaw: unknown,
+): TfyModelSelectorEntry[] {
+    const map = buildMetadataMap(providerMetadataRaw);
+    if (map.size === 0) return models;
+    return models.map((model) => {
+        const meta = map.get(metadataKey(model.provider.name, model.modelId));
+        const reasoningEfforts = reasoningEffortsForModel(
+            meta,
+            model.provider.name,
+        );
+        if (reasoningEfforts == null) return model;
+        return {
+            ...model,
+            properties: { ...model.properties, reasoningEfforts },
+        };
+    });
+}
+
 export async function listEnabledModels(
     opts: CpCredentials,
 ): Promise<TfyModelSelectorEntry[]> {
-    const raw = await cpFetch<unknown>(
-        opts,
-        "/api/svc/v1/llm-gateway/model/enabled",
-    );
-    return normalizeEnabledModels(raw);
+    // Parallel: providers is enrichment-only; soft-fail keeps models usable.
+    const [raw, providers] = await Promise.all([
+        cpFetch<unknown>(opts, "/api/svc/v1/llm-gateway/model/enabled"),
+        cpFetch<unknown>(
+            opts,
+            "/api/svc/v1/provider-accounts/providers",
+        ).catch(() => null),
+    ]);
+    const models = normalizeEnabledModels(raw);
+    if (providers == null) return models;
+    return enrichModelsWithReasoningEfforts(models, providers);
 }
 
 // ---------------------------------------------------------------------------

package/src/plugins/truefoundry-agent-server-adapter/modelReasoningEffort.test.ts

@@ -0,0 +1,171 @@
+import { describe, expect, it } from "vitest";
+
+import {
+    buildMetadataMap,
+    getEffortOptions,
+    reasoningEffortsForModel,
+    showsReasoningEffort,
+    type ModelMetadata,
+} from "./modelReasoningEffort.js";
+import {
+    enrichModelsWithReasoningEfforts,
+    type TfyModelSelectorEntry,
+} from "./cp.js";
+
+const thinkingMeta: ModelMetadata = {
+    thinking: true,
+    removeParams: ["temperature"],
+    params: [
+        {
+            key: "reasoning_effort",
+            type: "string",
+            defaultValue: "high",
+            supportedValues: ["low", "medium", "high", "max"],
+        },
+    ],
+};
+
+const thinkingViaProviderDefaults: ModelMetadata = {
+    thinking: true,
+    params: [{ key: "max_tokens", maxValue: 128000 }],
+    defaultProviderParams: {
+        params: [
+            {
+                key: "reasoning_effort",
+                type: "string",
+                defaultValue: "high",
+                supportedValues: ["low", "medium", "high", "xhigh", "max"],
+            },
+        ],
+    },
+};
+
+describe("showsReasoningEffort", () => {
+    it("hides for openai exact slug even when thinking", () => {
+        expect(showsReasoningEffort(thinkingMeta, "openai")).toBe(false);
+    });
+
+    it("shows for azure-openai / anthropic when thinking", () => {
+        expect(showsReasoningEffort(thinkingMeta, "azure-openai")).toBe(true);
+        expect(showsReasoningEffort(thinkingMeta, "anthropic")).toBe(true);
+    });
+
+    it("hides when thinking is off or reasoning_effort is removed", () => {
+        expect(
+            showsReasoningEffort({ thinking: false }, "anthropic"),
+        ).toBe(false);
+        expect(
+            showsReasoningEffort(
+                { thinking: true, removeParams: ["reasoning_effort"] },
+                "anthropic",
+            ),
+        ).toBe(false);
+    });
+});
+
+describe("getEffortOptions / reasoningEffortsForModel", () => {
+    it("uses supportedValues from model params", () => {
+        expect(getEffortOptions(thinkingMeta)).toEqual([
+            "low",
+            "medium",
+            "high",
+            "max",
+        ]);
+        expect(reasoningEffortsForModel(thinkingMeta, "anthropic")).toEqual([
+            "low",
+            "medium",
+            "high",
+            "max",
+        ]);
+    });
+
+    it("falls back to defaultProviderParams", () => {
+        expect(getEffortOptions(thinkingViaProviderDefaults)).toEqual([
+            "low",
+            "medium",
+            "high",
+            "xhigh",
+            "max",
+        ]);
+    });
+
+    it("returns undefined when the picker should stay hidden", () => {
+        expect(reasoningEffortsForModel(thinkingMeta, "openai")).toBeUndefined();
+        expect(
+            reasoningEffortsForModel({ thinking: false }, "anthropic"),
+        ).toBeUndefined();
+    });
+});
+
+describe("buildMetadataMap + enrichModelsWithReasoningEfforts", () => {
+    const providersPayload = [
+        {
+            type: "provider-account/anthropic",
+            integrations: [
+                {
+                    metadata: {
+                        "claude-sonnet-4-6": thinkingMeta,
+                        "claude-haiku": { thinking: false },
+                    },
+                },
+            ],
+        },
+        {
+            type: "provider-account/openai",
+            integrations: [
+                {
+                    metadata: {
+                        "o3-mini": thinkingMeta,
+                    },
+                },
+            ],
+        },
+    ];
+
+    it("indexes metadata by providerSlug/modelId", () => {
+        const map = buildMetadataMap(providersPayload);
+        expect(map.get("anthropic/claude-sonnet-4-6")).toEqual(thinkingMeta);
+        expect(map.get("openai/o3-mini")).toEqual(thinkingMeta);
+    });
+
+    it("attaches properties.reasoningEfforts for thinking models only", () => {
+        const models: TfyModelSelectorEntry[] = [
+            {
+                id: "anthropic-prod/claude-sonnet-4-6",
+                name: "anthropic-prod/claude-sonnet-4-6",
+                provider: { name: "anthropic" },
+                properties: {},
+                apiModel: "anthropic-prod/claude-sonnet-4-6",
+                modelId: "claude-sonnet-4-6",
+            },
+            {
+                id: "anthropic-prod/claude-haiku",
+                name: "anthropic-prod/claude-haiku",
+                provider: { name: "anthropic" },
+                properties: {},
+                apiModel: "anthropic-prod/claude-haiku",
+                modelId: "claude-haiku",
+            },
+            {
+                id: "openai-main/o3-mini",
+                name: "openai-main/o3-mini",
+                provider: { name: "openai" },
+                properties: {},
+                apiModel: "openai-main/o3-mini",
+                modelId: "o3-mini",
+            },
+        ];
+
+        const next = enrichModelsWithReasoningEfforts(models, providersPayload);
+
+        expect(next[0]?.properties.reasoningEfforts).toEqual([
+            "low",
+            "medium",
+            "high",
+            "max",
+        ]);
+        expect(next[1]?.properties.reasoningEfforts).toBeUndefined();
+        // exact openai slug hides even when thinking metadata exists
+        expect(next[2]?.properties.reasoningEfforts).toBeUndefined();
+    });
+});