simstudioai--sim/apps/sim/tools/spotify/follow_artists.ts

import type { ToolConfig, ToolResponse } from '@/tools/types'

interface SpotifyFollowArtistsParams {
  accessToken: string
  artistIds: string
}

interface SpotifyFollowArtistsResponse extends ToolResponse {
  output: {
    success: boolean
  }
}

export const spotifyFollowArtistsTool: ToolConfig<
  SpotifyFollowArtistsParams,
  SpotifyFollowArtistsResponse
> = {
  id: 'spotify_follow_artists',
  name: 'Spotify Follow Artists',
  description: 'Follow one or more artists.',
  version: '1.0.0',

  oauth: {
    required: true,
    provider: 'spotify',
    requiredScopes: ['user-follow-modify'],
  },

  params: {
    artistIds: {
      type: 'string',
      required: true,
      visibility: 'user-or-llm',
      description: 'Comma-separated artist IDs to follow (max 50)',
    },
  },

  request: {
    url: (params) => {
      const ids = params.artistIds
        .split(',')
        .map((id) => id.trim())
        .slice(0, 50)
        .join(',')
      return `https://api.spotify.com/v1/me/following?type=artist&ids=${ids}`
    },
    method: 'PUT',
    headers: (params) => ({
      Authorization: `Bearer ${params.accessToken}`,
      'Content-Type': 'application/json',
    }),
  },

  transformResponse: async (): Promise<SpotifyFollowArtistsResponse> => {
    return {
      success: true,
      output: { success: true },
    }
  },

  outputs: {
    success: { type: 'boolean', description: 'Whether artists were followed successfully' },
  },
}