v1.3.0

[collindutter]

Added

• Provider-specific Driver namespaces (e.g., griptape.drivers.prompt.openai, griptape.drivers.embedding.cohere).
• Tool streaming support to OllamaPromptDriver.
• DateTimeTool.add_timedelta and DateTimeTool.get_datetime_diff for basic datetime arithmetic.
• Support for pydantic.BaseModels anywhere schema.Schema is supported.
• Support for new serialization metadata, serialization_key and deserialization_key for more granular control over serialization.
• Support for OpenAi reasoning models, o1 and o3.
• Support for enums in GriptapeCloudToolTool.
• LocalRerankDriver for reranking locally.
• griptape.utils.griptape_cloud.GriptapeCloudStructure for automatically configuring Cloud-specific Drivers when in the Griptape Cloud Structures Runtime.
• Support for AudioArtifact inputs/outputs in OpenAiChatPromptDriver.

Changed

• Added DateTime.get_relative_datetime to DateTimeTool.denylist. May be removed in a future release.
• Changed log level of ActionsSubtask errors from EXCEPTION to DEBUG.
• GriptapeCloudStructureRunDriver now publishes its events to the global event bus.
• Changed log level of Tool execution errors from EXCEPTION to DEBUG
• Improved mime type detection in FileManagerTool.
• Improve SqlDriver.get_table_schema speed.
• Cache SqlDriver.get_table_schema results.
• Updated Azure Drivers to use the latest Azure OpenAI API version, 2024-10-21.

Deprecated

• griptape.drivers namespace. Use provider-specific namespaces instead.

---

This discussion was created from the release v1.3.0.

[collindutter]

Reposting an offline comment for some context on the deprecation:

Supporting a single top-level package, griptape.drivers, requires all sorts of awkward hacks when implementing Drivers. This not only makes maintenance more difficult for us but also raises the barrier for others contributing framework Drivers.

Additionally, this change resolves/unblocks a couple of significant issues:
Issue #1587
Issue #1441

For better discoverability and easier Driver swapping, we could implement alternative solutions elsewhere. For example, we could support a syntax like this to automatically select the appropriate Driver:

from griptape.tasks import PromptTask

task = PromptTask(
    model="openai:gpt-4o"
    # model="anthropic:claude"
    # model="google:gemini"
)

I don’t love that this change is necessary, but it’s the right direction for the framework. We can address the gaps it introduces with newer, better features.