// the signal comes from the SDK and is passed to our tool
const controller = new AbortController()
const signal = controller.signal

async function createPlaylistMashup({
	songs,
	onProgress,
	// we pass the signal to our utility so we can add an event listener to it
	signal,
}: {
	songs: string[]
	onProgress?: (progress: number) => void
	signal?: AbortSignal
}) {
	if (signal?.aborted) throw new Error('Mashup creation was cancelled')

	// our logic...
	const promise = doTheAsyncThing()

	function onAbort() {
		// we can do something here, like send a notification to the user
		// that the mashup was cancelled. This should trigger the async thing to throw an error.
	}
	signal.addEventListener('abort', onAbort)
	await promise.finally(() => {
		// make sure to clean up regardless of whether the promise resolves or rejects
		signal.removeEventListener('abort', onAbort)
	})

	return 'Mashup complete!'
}

// Somewhere in the SDK, this gets called when the user wants to cancel:
controller.abort()