feat(models): gate forced tool use by model capability (#7528)

* feat(models): gate forced tool use by model capability

* fix(models): derive forced tool support from capability metadata

* refactor(models): use catalog capabilities for forced tool support

Author: j15z

apps/sim/app/workspace/[workspaceId]/w/[workflowId]/components/panel/components/editor/components/sub-block/components/tool-input/tool-input.tsx

@@ -80,6 +80,7 @@ import { useCollaborativeWorkflow } from '@/hooks/use-collaborative-workflow'
 import { useOperationAccess } from '@/hooks/use-operation-access'
 import { usePermissionConfig } from '@/hooks/use-permission-config'
 import { useSettingsNavigation } from '@/hooks/use-settings-navigation'
+import { supportsForcedToolUse } from '@/providers/models'
 import { getProviderFromModel, supportsToolUsageControl } from '@/providers/utils'
 import type { ActiveSearchTarget } from '@/stores/panel/editor/store'
 import { useSubBlockStore } from '@/stores/workflows/subblock/store'
@@ -561,10 +562,11 @@ export const ToolInput = memo(function ToolInput({
     })
   }, [mcpTools, mcpServers])
 
-  const modelValue = useSubBlockStore.getState().getValue(blockId, 'model')
+  const modelValue = useSubBlockStore((state) => state.getValue(blockId, 'model'))
   const model = typeof modelValue === 'string' ? modelValue : ''
   const provider = model ? getProviderFromModel(model) : ''
   const supportsToolControl = provider ? supportsToolUsageControl(provider) : false
+  const supportsForce = supportsForcedToolUse(model)
 
   const {
     filterBlocks,
@@ -1710,12 +1712,16 @@ export const ToolInput = memo(function ToolInput({
                         </PopoverItem>
                         <PopoverItem
                           active={tool.usageControl === 'force'}
+                          disabled={!supportsForce}
                           onClick={() => {
                             handleUsageControlChange(toolIndex, 'force')
                             setUsageControlPopoverIndex(null)
                           }}
                         >
-                          Force <span className='text-[var(--text-tertiary)]'>(always use)</span>
+                          Force{' '}
+                          <span className='text-[var(--text-tertiary)]'>
+                            {supportsForce ? '(always use)' : '(not supported by model)'}
+                          </span>
                         </PopoverItem>
                         <PopoverItem
                           active={tool.usageControl === 'none'}

apps/sim/providers/anthropic/core.request.test.ts

@@ -296,7 +296,7 @@ describe('executeAnthropicProviderRequest forced tool use', () => {
     expect(payload.tool_choice).toEqual({ type: 'tool', name: 'publish' })
   })
 
-  it('drops forced tool_choice on Claude Fable 5.1 because the API rejects it', async () => {
+  it('drops forced tool_choice when the catalog model disables Force', async () => {
     const { payload, warn } = await runWithForcedTool('claude-fable-5-1')
     expect(payload.tools?.map((tool) => tool.name)).toEqual(['publish'])
     expect(payload).not.toHaveProperty('tool_choice')

apps/sim/providers/anthropic/core.ts

@@ -21,6 +21,7 @@ import {
 import {
   getMaxOutputTokensForModel,
   getThinkingCapability,
+  supportsForcedToolUse,
   supportsNativeStructuredOutputs,
   supportsTemperature,
 } from '@/providers/models'
@@ -155,17 +156,6 @@ function supportsAdaptiveThinking(modelId: string): boolean {
   )
 }
 
-/**
- * Claude Fable 5.1 and Claude Mythos 5.1 reject forced tool use: a `tool_choice` of
- * type `tool` or `any` returns a 400 (`tool_choice: type "tool" and "any" are not
- * supported for this model.`). Thinking is always on for these models, so a forced
- * call would skip it. The request is sent with the default `auto` instead.
- */
-function rejectsForcedToolChoice(modelId: string): boolean {
-  const normalizedModel = modelId.toLowerCase()
-  return normalizedModel.includes('fable-5-1') || normalizedModel.includes('mythos-5-1')
-}
-
 /**
  * Builds the thinking configuration for the Anthropic API based on model capabilities and level.
  *
@@ -428,7 +418,7 @@ export async function executeAnthropicProviderRequest(
     } else if (toolChoice === 'none') {
       payload.tool_choice = { type: 'none' }
     } else if (toolChoice !== 'auto') {
-      if (rejectsForcedToolChoice(request.model)) {
+      if (!supportsForcedToolUse(request.model)) {
         logger.warn(
           `Model ${modelId} rejects forced tool_choice; sending tool "${toolChoice.name}" with tool_choice auto`
         )

apps/sim/providers/models.test.ts

@@ -5,6 +5,7 @@ import { describe, expect, it } from 'vitest'
 import {
   getBaseModelProviders,
   getHostedModels,
+  getModelCapabilities,
   getModelPricing,
   getModelsWithPromptCaching,
   getPromptCachingMinimumTokens,
@@ -13,6 +14,7 @@ import {
   isModelDeprecated,
   orderModelIdsByReleaseDate,
   PROVIDER_DEFINITIONS,
+  supportsForcedToolUse,
   updateFireworksModels,
 } from '@/providers/models'
 import { supportsPromptCaching } from '@/providers/utils'
@@ -61,6 +63,31 @@ describe('catalog featured model metadata', () => {
   })
 })
 
+describe('forced tool use capability', () => {
+  it.each(['claude-fable-5-1', 'CLAUDE-FABLE-5-1'])(
+    'disables Force while keeping Auto and None support for %s',
+    (model) => {
+      expect(getModelCapabilities(model)).toMatchObject({
+        toolUsageControl: true,
+        forcedToolUse: false,
+      })
+      expect(supportsForcedToolUse(model)).toBe(false)
+    }
+  )
+
+  it.each(['claude-sonnet-5', 'claude-fable-5', 'claude-opus-5', 'gpt-5.5'])(
+    'inherits provider tool-control support for %s',
+    (model) => {
+      expect(supportsForcedToolUse(model)).toBe(true)
+    }
+  )
+
+  it('does not enable Force for an unknown model without tool-control capabilities', () => {
+    expect(getModelCapabilities('unknown-model')).toBeNull()
+    expect(supportsForcedToolUse('unknown-model')).toBe(false)
+  })
+})
+
 describe('Anthropic thinking stream visibility', () => {
   it('classifies visible Claude thinking as summarized rather than raw', () => {
     for (const providerId of ['anthropic', 'azure-anthropic'] as const) {

apps/sim/providers/models.ts

@@ -45,6 +45,8 @@ export interface ModelCapabilities {
     max: number
   }
   toolUsageControl?: boolean
+  /** Whether tools can be forced. Defaults to toolUsageControl when omitted. */
+  forcedToolUse?: boolean
   computerUse?: boolean
   nativeStructuredOutputs?: boolean
   /** Maximum supported output tokens for this model */
@@ -914,6 +916,7 @@ export const PROVIDER_DEFINITIONS: Record<string, ProviderDefinition> = {
           updatedAt: '2026-09-04',
         },
         capabilities: {
+          forcedToolUse: false,
           nativeStructuredOutputs: true,
           maxOutputTokens: 128000,
           promptCaching: { minimumCacheableTokens: 512 },
@@ -4481,6 +4484,12 @@ export function supportsToolUsageControl(providerId: string): boolean {
   return getProvidersWithToolUsageControl().includes(providerId)
 }
 
+/** Whether the model accepts forced tool choice. */
+export function supportsForcedToolUse(modelId: string): boolean {
+  const capabilities = getModelCapabilities(modelId)
+  return capabilities?.forcedToolUse ?? capabilities?.toolUsageControl ?? false
+}
+
 export function updateOllamaModels(models: string[]): void {
   PROVIDER_DEFINITIONS.ollama.models = models.map((modelId) => ({
     id: modelId,