import { SunoClient, SunoLyricsVariant, SunoTaskData, SunoTrack } from './client'; import * as schemas from './schemas'; const ASYNC_POLLING_PATHS: Record = { 'suno_generate_music': '/generate/record-info?taskId=', 'suno_generate_lyrics': '/lyrics/record-info?taskId=', 'suno_generate_sounds': '/generate/record-info?taskId=', 'suno_extend_music': '/generate/record-info?taskId=', 'suno_replace_section': '/generate/record-info?taskId=', 'suno_upload_and_cover': '/generate/record-info?taskId=', 'suno_upload_and_extend': '/generate/record-info?taskId=', 'suno_add_vocals': '/generate/record-info?taskId=', 'suno_add_instrumental': '/generate/record-info?taskId=', 'suno_generate_mashup': '/generate/record-info?taskId=', 'suno_separate_vocals': '/vocal-removal/record-info?taskId=', 'suno_separate_stems': '/vocal-removal/record-info?taskId=', 'suno_create_video': '/generate/video-info?taskId=', 'suno_create_cover': '/generate/cover-info?taskId=', 'suno_convert_to_wav': '/generate/wav-info?taskId=', }; function copyDefined>( source: T, target: Record, keys: (keyof T)[] ): void { for (const key of keys) { const value = source[key]; if (value !== undefined) { target[key as string] = value; } } } function isLyricsData(data: SunoTaskData): boolean { return data.type === 'LYRICS'; } function formatLyricsResult(data: SunoTaskData): string { const status = data.status; if (status !== 'SUCCESS') { return JSON.stringify( { taskId: data.taskId, status, errorCode: data.errorCode, errorMessage: data.errorMessage, }, null, 2 ); } const variants = (data.response?.data as SunoLyricsVariant[] | undefined) ?? []; return JSON.stringify( { taskId: data.taskId, status, type: data.type, variants: variants.map((v, index) => ({ index: index + 1, title: v.title, text: v.text, status: v.status, errorMessage: v.errorMessage, })), }, null, 2 ); } function formatTaskResult(data: SunoTaskData): string { if (isLyricsData(data)) { return formatLyricsResult(data); } const status = data.status; if (status !== 'SUCCESS') { return JSON.stringify( { taskId: data.taskId, status, errorCode: data.errorCode, errorMessage: data.errorMessage, }, null, 2 ); } const response = data.response; const tracks = (response?.data ?? response?.sunoData ?? []) as SunoTrack[]; return JSON.stringify( { taskId: data.taskId, status, operationType: data.operationType, tracks: tracks.map((t) => ({ id: t.id, title: t.title, tags: t.tags, duration: t.duration, prompt: t.prompt, audio_url: t.audio_url ?? t.audioUrl, stream_audio_url: t.stream_audio_url ?? t.streamAudioUrl, image_url: t.image_url ?? t.imageUrl, })), }, null, 2 ); } async function runAsyncTask( client: SunoClient, taskName: string, createPath: string, payload: Record ): Promise { const createResult = await client.post<{ taskId: string }>(createPath, payload); const taskId = createResult.data.taskId; const statusPathTemplate = ASYNC_POLLING_PATHS[taskName]; if (!statusPathTemplate) { return JSON.stringify({ taskId, status: 'PENDING', note: 'Use suno_get_task_status to poll.' }, null, 2); } const statusData = await client.pollTaskStatus(taskId, { statusPath: `${statusPathTemplate}${encodeURIComponent(taskId)}`, }); return formatTaskResult(statusData); } export class ToolHandlers { constructor(private readonly client: SunoClient) {} async handle(name: string, args: unknown): Promise<{ content: { type: string; text: string }[] }> { let resultText: string; switch (name) { case 'suno_generate_music': { const input = schemas.GenerateMusicSchema.parse(args); const payload: Record = { customMode: input.customMode, instrumental: input.instrumental, model: input.model, callBackUrl: input.callBackUrl ?? '', }; copyDefined(input, payload, [ 'prompt', 'style', 'title', 'negativeTags', 'vocalGender', 'styleWeight', 'weirdnessConstraint', 'audioWeight', 'personaId', 'personaModel', ]); resultText = await runAsyncTask(this.client, name, '/generate', payload); break; } case 'suno_generate_lyrics': { const input = schemas.GenerateLyricsSchema.parse(args); resultText = await runAsyncTask(this.client, name, '/lyrics', { prompt: input.prompt, callBackUrl: input.callBackUrl ?? '', }); break; } case 'suno_generate_sounds': { const input = schemas.GenerateSoundsSchema.parse(args); const payload: Record = { prompt: input.prompt, model: input.model, callBackUrl: input.callBackUrl ?? '', }; copyDefined(input, payload, ['soundLoop', 'soundTempo', 'soundKey', 'grabLyrics']); resultText = await runAsyncTask(this.client, name, '/generate/sounds', payload); break; } case 'suno_extend_music': { const input = schemas.ExtendMusicSchema.parse(args); const payload: Record = { audioId: input.audioId, defaultParamFlag: input.defaultParamFlag, model: input.model, callBackUrl: input.callBackUrl ?? '', }; copyDefined(input, payload, [ 'prompt', 'style', 'title', 'continueAt', 'negativeTags', 'vocalGender', 'styleWeight', 'weirdnessConstraint', 'audioWeight', 'personaId', 'personaModel', ]); resultText = await runAsyncTask(this.client, name, '/generate/extend', payload); break; } case 'suno_replace_section': { const input = schemas.ReplaceSectionSchema.parse(args); const payload: Record = { audioId: input.audioId, prompt: input.prompt, start: input.start, end: input.end, model: input.model, callBackUrl: input.callBackUrl ?? '', }; copyDefined(input, payload, ['replaceAudioUrl', 'customMode', 'style', 'title', 'instrumental']); resultText = await runAsyncTask(this.client, name, '/generate/replace-section', payload); break; } case 'suno_add_vocals': { const input = schemas.AddVocalsSchema.parse(args); const payload: Record = { audioId: input.audioId, model: input.model, callBackUrl: input.callBackUrl ?? '', }; copyDefined(input, payload, ['prompt', 'customMode', 'style', 'title']); resultText = await runAsyncTask(this.client, name, '/generate/add-vocals', payload); break; } case 'suno_add_instrumental': { const input = schemas.AddInstrumentalSchema.parse(args); const payload: Record = { audioId: input.audioId, model: input.model, callBackUrl: input.callBackUrl ?? '', }; copyDefined(input, payload, ['prompt', 'customMode', 'style', 'title']); resultText = await runAsyncTask(this.client, name, '/generate/add-instrumental', payload); break; } case 'suno_upload_and_cover': { const input = schemas.UploadAndCoverSchema.parse(args); const payload: Record = { uploadUrl: input.uploadUrl, customMode: input.customMode, instrumental: input.instrumental, model: input.model, callBackUrl: input.callBackUrl ?? '', }; copyDefined(input, payload, [ 'prompt', 'style', 'title', 'negativeTags', 'vocalGender', 'styleWeight', 'weirdnessConstraint', 'audioWeight', 'personaId', 'personaModel', ]); resultText = await runAsyncTask(this.client, name, '/generate/upload-cover', payload); break; } case 'suno_upload_and_extend': { const input = schemas.UploadAndExtendSchema.parse(args); const payload: Record = { uploadUrl: input.uploadUrl, defaultParamFlag: input.defaultParamFlag, model: input.model, callBackUrl: input.callBackUrl ?? '', }; copyDefined(input, payload, ['prompt', 'style', 'title', 'continueAt']); resultText = await runAsyncTask(this.client, name, '/generate/upload-extend', payload); break; } case 'suno_generate_mashup': { const input = schemas.GenerateMashupSchema.parse(args); const payload: Record = { uploadUrlList: input.uploadUrlList, customMode: input.customMode, prompt: input.prompt, model: input.model, callBackUrl: input.callBackUrl ?? '', }; copyDefined(input, payload, [ 'instrumental', 'style', 'title', 'negativeTags', 'vocalGender', 'styleWeight', 'weirdnessConstraint', 'audioWeight', ]); resultText = await runAsyncTask(this.client, name, '/generate/mashup', payload); break; } case 'suno_separate_vocals': { const input = schemas.SeparateVocalsSchema.parse(args); resultText = await runAsyncTask(this.client, name, '/vocal-removal/generate', { taskId: input.taskId, audioId: input.audioId, callBackUrl: input.callBackUrl ?? '', }); break; } case 'suno_separate_stems': { const input = schemas.SeparateStemsSchema.parse(args); resultText = await runAsyncTask(this.client, name, '/vocal-removal/generate', { taskId: input.taskId, audioId: input.audioId, type: 'split_stem', callBackUrl: input.callBackUrl ?? '', }); break; } case 'suno_create_video': { const input = schemas.CreateVideoSchema.parse(args); const payload: Record = { taskId: input.taskId, audioId: input.audioId, callBackUrl: input.callBackUrl ?? '', }; copyDefined(input, payload, ['author', 'domainName']); resultText = await runAsyncTask(this.client, name, '/generate/video', payload); break; } case 'suno_create_cover': { const input = schemas.CreateCoverSchema.parse(args); resultText = await runAsyncTask(this.client, name, '/generate/cover', { taskId: input.taskId, audioId: input.audioId, callBackUrl: input.callBackUrl ?? '', }); break; } case 'suno_convert_to_wav': { const input = schemas.ConvertToWavSchema.parse(args); resultText = await runAsyncTask(this.client, name, '/generate/wav', { taskId: input.taskId, audioId: input.audioId, callBackUrl: input.callBackUrl ?? '', }); break; } case 'suno_boost_style': { const input = schemas.BoostStyleSchema.parse(args); const result = await this.client.post<{ result: string }>('/style/generate', { content: input.content, }); resultText = result.data.result; break; } case 'suno_generate_persona': { const input = schemas.GeneratePersonaSchema.parse(args); const payload: Record = { taskId: input.taskId }; if (input.audioId !== undefined) payload.audioId = input.audioId; const result = await this.client.post<{ personaId?: string }>('/generate/persona', payload); resultText = JSON.stringify(result.data, null, 2); break; } case 'suno_get_task_status': { const input = schemas.GetTaskStatusSchema.parse(args); const data = await this.client.get( `/generate/record-info?taskId=${encodeURIComponent(input.taskId)}` ); resultText = formatTaskResult(data.data); break; } case 'suno_get_timestamped_lyrics': { const input = schemas.GetTimestampedLyricsSchema.parse(args); const result = await this.client.get( `/generate/timestamped-lyrics?taskId=${encodeURIComponent(input.taskId)}&audioId=${encodeURIComponent( input.audioId )}` ); resultText = JSON.stringify(result.data, null, 2); break; } case 'suno_get_lyrics_details': { const input = schemas.GetLyricsDetailsSchema.parse(args); const result = await this.client.get( `/lyrics/record-info?taskId=${encodeURIComponent(input.taskId)}` ); resultText = formatLyricsResult(result.data); break; } case 'suno_get_wav_details': { const input = schemas.GetWavDetailsSchema.parse(args); const result = await this.client.get( `/generate/wav-info?taskId=${encodeURIComponent(input.taskId)}` ); resultText = JSON.stringify(result.data, null, 2); break; } case 'suno_get_vocal_separation_details': { const input = schemas.GetVocalSeparationDetailsSchema.parse(args); const result = await this.client.get( `/vocal-removal/record-info?taskId=${encodeURIComponent(input.taskId)}` ); resultText = JSON.stringify(result.data, null, 2); break; } case 'suno_get_video_details': { const input = schemas.GetVideoDetailsSchema.parse(args); const result = await this.client.get( `/generate/video-info?taskId=${encodeURIComponent(input.taskId)}` ); resultText = JSON.stringify(result.data, null, 2); break; } case 'suno_get_credits': { schemas.GetCreditsSchema.parse(args); const result = await this.client.get('/generate/credit'); resultText = JSON.stringify({ credits: result.data }, null, 2); break; } default: throw new Error(`Unknown tool: ${name}`); } return { content: [{ type: 'text', text: resultText }], }; } }