Text to Speech Support

[andrewfrench]

Introduces support for Text to Speech workloads. For example:

from griptape.drivers import OpenAiTextToSpeechDriver
from griptape.structures import Agent
from griptape.tools.text_to_speech_client.tool import TextToSpeechClient
from griptape.utils import Chat


agent = Agent(tools=[
    TextToSpeechClient(
        output_dir="audio_out",
        engine=TextToSpeechEngine(
            text_to_speech_driver=OpenAiTextToSpeechDriver(),
        ),
    ),
])

Chat(agent).start()

todos:

• TextToSpeechClient implementation
• TextToSpeechClient documentation
• Driver documentation
• Engine documentation
• AudioArtifact documentation
• ElevenLabs SDK as an optional dependency
• Generalized MediaArtifactFileOutputMixin

[dylanholmes]

Great job!

The comments I've added are mostly "food for thought"

[dylanholmes]

Should this be an optional dependency?

[dylanholmes]

Does it at all matter what format the AudioArtifact.value is? (Or are we ok with relying on elevenlabs to throw a runtime error?)

[andrewfrench]

Realistically, we shouldn't rely on the Eleven Labs SDK to play audio, that's just convenience for demo purposes and this should be reworked before approval/merge. We should expect to receive audio data in common enough formats that we should be able to play it with common Python/OS utilities.

[dylanholmes]

If this mixin is just for make it easier to writes bytes to a file, then why not generalize all the way to BlobArtifactFileOutputMixin? (Or a FileOutputMixin that takes a bytes in the write method)

[andrewfrench]

I think we'll want to accept some sort of artifact here because we fall back to the artifact name as output filename if one isn't provided (if output_dir is set and we might expect multiple artifacts to end up there). Agreed that there's no reason to limit ourselves to MediaArtifacts, though.

[collindutter]

Nice work but...docs. There's no escaping them now 😄

[vachillo]

nit: maybe move this default to a top level constant?

[vachillo]

not sure what the guideline is for inline defaults vs top-level constants. seems like its done both ways.