Function getSearchExtraToolsMode

src/utils/searchExtraTools.ts:170–192

()

 *   (unset)               tst (default: always defer non-core tools)
 */
export function getSearchExtraToolsMode(): SearchExtraToolsMode {
  // CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS still acts as a kill switch
  // for tool search, even though we no longer send beta headers.
  // Users who set this flag explicitly opt out of tool search.
  if (isEnvTruthy(process.env.CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS)) {
    return 'standard'
  }

  const value = process.env.ENABLE_SEARCH_EXTRA_TOOLS

  // Handle auto:N syntax - check edge cases first
  const autoPercent = value ? parseAutoPercentage(value) : null
  if (autoPercent === 0) return 'tst' // auto:0 = always enabled
  if (autoPercent === 100) return 'standard'
  if (isAutoSearchExtraToolsMode(value)) {
    return 'tst-auto' // auto or auto:1-99
  }

  if (isEnvTruthy(value)) return 'tst'
  if (isEnvDefinedFalsy(process.env.ENABLE_SEARCH_EXTRA_TOOLS))
    return 'standard'
  return 'tst' // default: always defer non-core tools
}

/**
 * Check if tool search *might* be enabled (optimistic check).