v0.22.0

Added

• PromptImageGenerationEngine for generating images from text prompts.
• VariationImageGenerationEngine for generating variations of an input image according to a text prompt.
• InpaintingImageGenerationEngine for modifying an input image according to a text prompt within the bounds of a mask defined by a mask image.
• OutpaintingImageGenerationEngine for modifying an input image according to a text prompt outside the bounds of a mask defined by a mask image.
• PromptImageGenerationClient for enabling an LLM to use the PromptImageGenerationEngine.
• VariationImageGenerationClient for enabling an LLM to use the VariationImageGenerationEngine.
• InpaintingImageGenerationClient for enabling an LLM to use the InpaintingImageGenerationEngine.
• OutpaintingImageGenerationClient for enabling an LLM to use the OutpaintingImageGenerationEngine.
• OpenAiImageGenerationDriver for use with OpenAI's image generation models.
• LeonardoImageGenerationDriver for use with Leonoaro AI's image generation models.
• AmazonBedrockImageGenerationDriver for use with Amazon Bedrock's image generation models; requires a Image Generation Model Driver.
• BedrockTitanImageGenerationModelDriver for use with Amazon Bedrock's Titan image generation.
• ImageArtifact for storing image data; used heavily by the image Engines, Tasks, and Drivers.
• ImageLoader for loading images files into ImageArtifacts.
• Support for all Tokenizers in OpenAiChatPromptDriver, enabling OpenAI drop-in clients such as Together AI.
• AmazonSageMakerEmbeddingDriver for using Amazon SageMaker to generate embeddings. Thanks @KaushikIyer16!
• Claude 2.1 support in AnthropicPromptDriver and AmazonBedrockPromptDriver via BedrockClaudePromptModelDriver.
• CodeExecutionTask for executing code as a Task without the need for an LLM.
• BedrockLlamaPromptModelDriver for using Llama models on Amazon Bedrock.

Fixed

• MongoDbAtlasVectorStore namespace not being used properly when querying.
• Miscellaneous type errors throughout the codebase.
• Remove unused section from ToolTask system prompt template.
• Structure execution args being cleared after run, preventing inspection of the Structure's input_task's input.
• Unhandled SqlClient exception. Thanks @michal-repo!

Changed

• BREAKING: Rename input_template field to input in Tasks that take a text input.
• BREAKING: Rename BedrockTitanEmbeddingDriver to AmazonBedrockTitanEmbeddingDriver.
• BREAKING: Rename AmazonBedrockStableDiffusionImageGenerationModelDriver to BedrockStableDiffusionImageGenerationModelDriver.
• BREAKING: Rename AmazonBedrockTitanImageGenerationModelDriver to BedrockTitanImageGenerationModelDriver.
• BREAKING: Rename ImageGenerationTask to PromptImageGenerationTask.
• BREAKING: Rename ImageGenerationEngine to PromptImageGenerationEngine.
• BREAKING: Rename ImageGenerationTool to PromptImageGenerationClient.
• Improve system prompt generation with Claude 2.0.
• Improve integration test coverage.
• BaseTextInputTask to accept a str, TextArtifact or callable returning a TextArtifact.

v0.21.2

🔧 Improvements

• Fixed handling of exceptions in SqlClient (#502)
• Fixed file output bug in image generation tool/task (#505)
• Removed unused portion of system prompt (#514)
• Updated Makefile to reflect release process (#524)

v0.21.1

🔧 Improvements

• Fixed README link.
• Fixed missing module file in griptape.schemas.utils.

v0.21.0

🚨 Breaking Changes

• Renamed hugging_face_hub_prompt_driver.py to huggingface_hub_prompt_driver.py.
• Renamed hugging_face_pipeline_prompt_driver.py to huggingface_pipeline_prompt_driver.py.
• Renamed hugging_face_tokenizer.py to huggingface_tokenizer.py.
• Moved ProxycurlClient Tool to dedicated repository.

🆕 New Features

• Added HuggingFaceEmbeddingDriver.
• Added SimpleTokenizer for use with LLM providers that don't provide tokenization APIs.
• Added streaming support to Chat util. Thanks @mattma1970!
• Added Image Generation Drivers (AzureOpenAiDalleImageGenerationDriver, LeonardoImageGenerationDriver, and AmazonBedrockImageGenerationDriver).
• Added streaming support to HuggingFaceHubPromptDriver.
• Added prompt_stack and prompt fields to StartPromptEvent to allow for inspection of the prompt before sending to the LLM.
• Created Tool Template repository.

🔧 Improvements

• Added python 3.12 support.
• Updated HuggingFaceHubPromptDriver to use new InferenceClient.
• Fixed OpenSearchVectorStoreDriver.query argument order. Thanks @igor-2lemetry!
• Fixed FileManager working directory not updating when using os.cwd().
• Fixed WebLoader failing when extracting empty pages.
• Fixed SummaryConversationMemory failing to deserialize.

📖 Docs

• Updated contribution guidelines for new Tools.
• Added docs for HuggingFaceEmbeddingDriver.
• Updated docs to reflect hugging_face -> huggingface rename.
• Added dedicated page for Tokenizers.
• Added note to Prompt Drivers page advising users that if they choose to override the Prompt Driver, they should also consider overriding the Embedding Driver.
• Fixed broken import on Task Memory page.

v0.20.0

🚨 Breaking Changes

• Removed BaseTask.add_child and BaseTask.add_parent. Use Workflow.add_task(s) and Workflow.insert_task(s) instead.
• Changed Workflows to always have a single input Task and single output Task; enabling Workflow Conversation Memory.
• Split dependencies into extras to reduce base installation size. Read more about this change here.
• Renamed ToolOutputProcessor to TaskMemoryClient.
• Removed Memory Actions in favor of TaskMemoryClient. If your Tools have data that needs to go to the LLM, you must set either set off_prompt=False on the Tool, or add TaskMemoryClient with off_prompt=False.
• Changed all Structure.run to return a Structure. This resolves inconsistencies in the run return values across Agents, Pipelines and Workflows. You can access the output Task value via Structure.output_task.output.value.
• Renamed AzureOpenAiChatPromptDriver's deployment_id and api_base to azure_deployment and azure_endpoint.
• Renamed Structure.tool_memory to Structure.task_memory.
• Renamed ToolMemory to TaskMemory.
• Renamed Structure.memory to Structure.conversation_memory.
• Removed TextQueryTask.load method.

🆕 New Features

• Added seed parameter to OpenAiChatPromptDriver. Read more about this parameter here.
• Added response_format parameter to OpenAiChatPromptDriver and AzureOpenAiChatPromptDriver. Read more about this parameter here.
• Added support for gpt-4-1106-preview(gpt-4-turbo) in OpenAiChatPromptDriver.
• Added new Workflow method insert_tasks. See example usage here.
• Added Conversation Memory to Workflows.
• Added off_prompt parameter to all Tools. With the exception of TaskMemoryClient (no default provided), off_prompt defaults to True meaning that the Tool results will go into Task Memory. If you'd like the results to go directly back to the LLM, set off_prompt to False.
• Added support for Rulesets and Rules to all Tasks.
• Added namespace parameter to TextQueryTask.
• Added encoding parameter to TextLoader.
• Added download_objects parameter to AwsS3Client.
• Added encoding parameter to TextLoader and TextArtifact.
• Added to_bytes method to TextArtifact.

🔧 Improvements

• Updated openai's sdk to ^1.1.0.
• Renamed Tool Memory to Task Memory. Soon, all Tasks will be able to output Artifacts into Task Memory, giving the ability to share Artifacts across Tasks.
• Added MetaMemory to store ActionSubtask results to improve the LLM's reasoning when using ToolkitTask. Other applications of MetaMemory will be added in future releases.
• Flattened Memory Actions and Tool Actions into Actions to improve the LLM's reasoning when using ToolkitTask.
• Improved system prompt for ToolTask and ToolkitTask to reduce action hallucinations.

📖 Docs

• Updated examples to reflect Tool Memory to Task Memory rename.
• Update examples to reflect flattening of Memory Actions and Tool Actions into Actions.
• Updated Overview and Prompt Driver pages to reflect pip extras changes.
• Updated Workflow example to use new Workflow.insert_tasks method.
• Added note to OpenAI Prompt Driver examples regarding seed and response_format parameters.
• Updated Tool examples to use TaskMemoryClient and off_prompt parameters.

v0.19.4

🔧 Improvements

• Lock openai at ^0.28 to prevent installation issues until #420 is implemented.

v0.19.3

🚨 Breaking Changes

• Updated Structure.add_event_listener to take an EventListener directly.

🔧 Improvements

• Fixed freeze when using the Stream utility multiple times.
• Fixed boto3 session not being passed from AmazonBedrockEmbeddingDriver to BedrockTitanTokenizer.
• Added Structure.remove_event_listener.

v0.19.2

🔧 Improvements

• Fixed requests scope in pyproject.toml.
• Updated Makefile.

v0.19.1

🔧 Improvements

• Moved requests from Tool requirements.txt to hard dependency in pyproject.toml.

v0.19.0

🚨 Breaking Changes

• Removed BufferConversationMemory.
• Simplified Event Listener format.
• Restrict Python support to >=3.9,<3.12. 3.12 support is coming, but is currently blocked by several downstream libraries.
• Removed Tokenizer's encode and decode methods.
• Removed TextToolMemory and BlobToolMemory.

🆕 New Features

• Combined TextToolMemory and BlobToolMemory under ToolMemory.
• Added Conversation Memory buffering via max_runs parameter.
• Added Conversation Memory pruning to prevent long running conversations from exceeding prompt token limit.
• Added prompt streaming to Prompt Drivers that can support it.
• Added EmailLoader.
• Added support for more file extensions in FileManager Tool.
• Added share_file activity to GoogleDriveClient Tool.
• Added serialization and deserialization for all Events.

🔧 Improvements

• Added BaseVectorStoreDriver.QueryResult.id.
• Fixed SummaryConversationMemory bugs.
• Refactored EmailClient to use EmailLoader.
• Refactored Embedding Drivers to use Chunkers for improvements on embedding large text.
• Added parsing of OpenAi rate limit headers for future use.
• Added __len__ magic methods for Artifacts (thanks @Bubble-Interface!).
• Fixed boto3 session not being passed from BedrockTitanEmbeddingDriver into BedrockTitanTokenizer.

📖 Docs

• Updated docs for new Event Listener format.
• Added page for Extraction Engines.
• Added sections for additional Task types.
• Added page for OpenWeatherClient Tool.
• Added example for PgVectorStoreDriver
• Updated page for Conversation Memory buffering changes.