spectre_ai 1.1.2 → 1.1.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 07e44eac15c5b58b13b2dbbb784f1ca4d5364d6aed7f2fe5a5d797c0ee5fd43d
-  data.tar.gz: 3d33fb9b5c228eb4577f678d5e2f310d401671cd242b0ca02bcf9a80df55fad8
+  metadata.gz: e92299b643fbf7d928b9c45de5ad9a504528cbb246202d56cb24d36a32030030
+  data.tar.gz: 8dc5d19040a9cac2cc929a1a91b55112d0e78fa21ca8de05bb6c3544838af9ed
 SHA512:
-  metadata.gz: 17c0de5cfb63e7d072e1c85d221abbdadabd2eb131276b22ceff834c7eaea05ce3a2a1a02c826887d39b54619c8841d651a7aaa3823a5eabf4f0f3faaf5c263e
-  data.tar.gz: 14ffff5c963ea79c2360e9517c9906f36b3bc27494732c3f3bd640c0f492aacdd0bdaf190be2effd5bbb9bc875315afe441c8583c07f3ff2faf6f7a8cdcdcceb
+  metadata.gz: 8ea61b8b0a0e23d7a5c500fd99e147942fd33538e21d38be0030aff60dda20758a87651b9460d4b4de50f986ffe068da4dd29f172dc0a25a993595eadee34fe6
+  data.tar.gz: b4ef2e616f0143f677c635e6d999e155a1205a1ab90ac47fc2a8c322b95ee6f107522dc4c2d8a16e33a856f3387ffdb1e7ac85ca9f83b3a72960e9b8e6d52ca1

data/CHANGELOG.md

@@ -93,4 +93,49 @@ This version enhances the flexibility and robustness of the Completions class, e
   * The `Spectre::Prompt.render` method now dynamically detects the project root based on the presence of project-specific markers, such as `Gemfile`, `.git`, or `config/application.rb`.
   * This change allows for greater flexibility when using spectre in different environments and projects, ensuring the prompt templates are found regardless of where spectre is used.
   *	**Example**: If you're using `spectre` inside a gem, the `detect_prompts_path` method will now correctly resolve the prompts path within the gem project root.
-  *	If no markers are found, the system falls back to the current working directory (`Dir.pwd`).
+  *	If no markers are found, the system falls back to the current working directory (`Dir.pwd`).
+
+
+# Changelog for Version 1.1.3
+
+**Release Date:** [2nd Dec 2024]
+
+**Fixes:**
+
+* **Removed unnecessary validations in `Completions` class**
+  * Removed redundant validations in the `Completions` class that were causing unnecessary errors in specific edge cases. LLM providers returns a proper errors messages now.
+
+
+# Changelog for Version 1.1.4
+
+**Release Date:** [5th Dec 2024]
+
+**New Features:**
+
+* Customizable Timeout for API Requests
+* Introduced DEFAULT_TIMEOUT constant (set to 60 seconds) for managing request timeouts across the Completions and Embeddings classes.
+* Added optional arguments (args) to create methods, allowing users to override read_timeout and open_timeout dynamically.
+* This change ensures greater flexibility when dealing with varying network conditions or API response times.
+
+**Example Usage:**
+
+```ruby
+Spectre::Openai::Completions.create(
+  messages: messages,
+  read_timeout: 30,
+  open_timeout: 20
+)
+```
+
+**Key Changes:**
+
+* **Updated Completions class:**
+  * http.read_timeout = args.fetch(:read_timeout, DEFAULT_TIMEOUT)
+  * http.open_timeout = args.fetch(:open_timeout, DEFAULT_TIMEOUT)
+  * Updated Embeddings class with the same timeout handling logic.
+
+**Fixes:**
+
+* Simplified Exception Handling for Timeouts
+* Removed explicit handling of Net::OpenTimeout and Net::ReadTimeout exceptions in both Completions and Embeddings classes.
+* Letting these exceptions propagate ensures clearer and more consistent error messages for timeout issues.

data/README.md

@@ -1,4 +1,6 @@
-# Spectre [![Gem Version](https://badge.fury.io/rb/spectre_ai.svg)](https://badge.fury.io/rb/spectre_ai)
+# <img src='logo.svg' height='120' alt='Spectre Logo' />
+
+[![Gem Version](https://badge.fury.io/rb/spectre_ai.svg)](https://badge.fury.io/rb/spectre_ai)
 
 **Spectre** is a Ruby gem that makes it easy to AI-enable your Ruby on Rails application. Currently, Spectre focuses on helping developers create embeddings, perform vector-based searches, create chat completions, and manage dynamic prompts — ideal for applications that are featuring RAG (Retrieval-Augmented Generation), chatbots and dynamic prompts.
 

data/lib/spectre/openai/completions.rb

@@ -9,6 +9,7 @@ module Spectre
     class Completions
       API_URL = 'https://api.openai.com/v1/chat/completions'
       DEFAULT_MODEL = 'gpt-4o-mini'
+      DEFAULT_TIMEOUT = 60
 
       # Class method to generate a completion based on user messages and optional tools
       #
@@ -17,10 +18,11 @@ module Spectre
       # @param json_schema [Hash, nil] An optional JSON schema to enforce structured output
       # @param max_tokens [Integer] The maximum number of tokens for the completion (default: 50)
       # @param tools [Array<Hash>, nil] An optional array of tool definitions for function calling
+      # @param args [Hash] Optional arguments like timeouts
       # @return [Hash] The parsed response including any function calls or content
       # @raise [APIKeyNotConfiguredError] If the API key is not set
       # @raise [RuntimeError] For general API errors or unexpected issues
-      def self.create(messages:, model: DEFAULT_MODEL, json_schema: nil, max_tokens: nil, tools: nil)
+      def self.create(messages:, model: DEFAULT_MODEL, json_schema: nil, max_tokens: nil, tools: nil, **args)
         api_key = Spectre.api_key
         raise APIKeyNotConfiguredError, "API key is not configured" unless api_key
 
@@ -29,8 +31,8 @@ module Spectre
         uri = URI(API_URL)
         http = Net::HTTP.new(uri.host, uri.port)
         http.use_ssl = true
-        http.read_timeout = 10 # seconds
-        http.open_timeout = 10 # seconds
+        http.read_timeout = args.fetch(:read_timeout, DEFAULT_TIMEOUT)
+        http.open_timeout = args.fetch(:open_timeout, DEFAULT_TIMEOUT)
 
         request = Net::HTTP::Post.new(uri.path, {
           'Content-Type' => 'application/json',
@@ -49,8 +51,6 @@ module Spectre
         handle_response(parsed_response)
       rescue JSON::ParserError => e
         raise "JSON Parse Error: #{e.message}"
-      rescue Net::OpenTimeout, Net::ReadTimeout => e
-        raise "Request Timeout: #{e.message}"
       end
 
       private
@@ -72,27 +72,6 @@ module Spectre
         if messages.empty?
           raise ArgumentError, "Messages cannot be empty."
         end
-
-        # Iterate through each message and perform detailed validation.
-        messages.each_with_index do |msg, index|
-          # Check if each message hash contains the required keys: :role and :content.
-          # These keys are necessary for defining the type of message and its content.
-          unless msg.key?(:role) && msg.key?(:content)
-            raise ArgumentError, "Message at index #{index} must contain both :role and :content keys."
-          end
-
-          # Check if the role is one of the allowed values: 'system', 'user', or 'assistant'.
-          # This ensures that each message has a valid role identifier.
-          unless %w[system user assistant].include?(msg[:role])
-            raise ArgumentError, "Invalid role '#{msg[:role]}' at index #{index}. Valid roles are 'system', 'user', 'assistant'."
-          end
-
-          # Check if the content is a non-empty string.
-          # This prevents empty or non-string content, which would be meaningless in a conversation.
-          unless msg[:content].is_a?(String) && !msg[:content].strip.empty?
-            raise ArgumentError, "Content for message at index #{index} must be a non-empty string."
-          end
-        end
       end
 
       # Helper method to generate the request body

data/lib/spectre/openai/embeddings.rb

@@ -9,23 +9,25 @@ module Spectre
     class Embeddings
       API_URL = 'https://api.openai.com/v1/embeddings'
       DEFAULT_MODEL = 'text-embedding-3-small'
+      DEFAULT_TIMEOUT = 60
 
       # Class method to generate embeddings for a given text
       #
       # @param text [String] the text input for which embeddings are to be generated
       # @param model [String] the model to be used for generating embeddings, defaults to DEFAULT_MODEL
+      # # @param args [Hash] Optional arguments like timeouts
       # @return [Array<Float>] the generated embedding vector
       # @raise [APIKeyNotConfiguredError] if the API key is not set
       # @raise [RuntimeError] for general API errors or unexpected issues
-      def self.create(text, model: DEFAULT_MODEL)
+      def self.create(text, model: DEFAULT_MODEL, **args)
         api_key = Spectre.api_key
         raise APIKeyNotConfiguredError, "API key is not configured" unless api_key
 
         uri = URI(API_URL)
         http = Net::HTTP.new(uri.host, uri.port)
         http.use_ssl = true
-        http.read_timeout = 10 # seconds
-        http.open_timeout = 10 # seconds
+        http.read_timeout = args.fetch(:read_timeout, DEFAULT_TIMEOUT)
+        http.open_timeout = args.fetch(:open_timeout, DEFAULT_TIMEOUT)
 
         request = Net::HTTP::Post.new(uri.path, {
           'Content-Type' => 'application/json',
@@ -42,8 +44,6 @@ module Spectre
         JSON.parse(response.body).dig('data', 0, 'embedding')
       rescue JSON::ParserError => e
         raise "JSON Parse Error: #{e.message}"
-      rescue Net::OpenTimeout, Net::ReadTimeout => e
-        raise "Request Timeout: #{e.message}"
       end
     end
   end

data/lib/spectre/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Spectre # :nodoc:all
-  VERSION = "1.1.2"
+  VERSION = "1.1.4"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: spectre_ai
 version: !ruby/object:Gem::Version
-  version: 1.1.2
+  version: 1.1.4
 platform: ruby
 authors:
 - Ilya Klapatok
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-10-14 00:00:00.000000000 Z
+date: 2024-12-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rspec-rails