active_genie 0.0.24 → 0.0.25

data/lib/active_genie/configuration/providers/google_config.rb

@@ -1,56 +0,0 @@
-require_relative '../../clients/google_client'
-require_relative './base_config'
-
-module ActiveGenie
-  module Configuration::Providers
-    # Configuration class for the Google Generative Language API client.
-    # Manages API keys, URLs, model selections, and client instantiation.
-    class GoogleConfig < BaseConfig
-      NAME = :google
-
-      # Retrieves the API key.
-      # Falls back to the GENERATIVE_LANGUAGE_GOOGLE_API_KEY environment variable if not set.
-      # @return [String, nil] The API key.
-      def api_key
-        @api_key || ENV['GENERATIVE_LANGUAGE_GOOGLE_API_KEY'] || ENV['GEMINI_API_KEY']
-      end
-
-      # Retrieves the base API URL for Google Generative Language API.
-      # Defaults to 'https://generativelanguage.googleapis.com'.
-      # @return [String] The API base URL.
-      def api_url
-        # Note: Google Generative Language API uses a specific path structure like /v1beta/models/{model}:generateContent
-        # The base URL here should be just the domain part.
-        @api_url || 'https://generativelanguage.googleapis.com'
-      end
-
-      # Lazily initializes and returns an instance of the GoogleClient.
-      # Passes itself (the config object) to the client's constructor.
-      # @return [ActiveGenie::Clients::GoogleClient] The client instance.
-      def client
-        @client ||= ::ActiveGenie::Clients::GoogleClient.new(self)
-      end
-
-      # Retrieves the model name designated for the lower tier (e.g., cost-effective, faster).
-      # Defaults to 'gemini-2.0-flash-lite'.
-      # @return [String] The lower tier model name.
-      def lower_tier_model
-        @lower_tier_model || 'gemini-2.0-flash-lite'
-      end
-
-      # Retrieves the model name designated for the middle tier (e.g., balanced performance).
-      # Defaults to 'gemini-2.0-flash'.
-      # @return [String] The middle tier model name.
-      def middle_tier_model
-        @middle_tier_model || 'gemini-2.0-flash'
-      end
-
-      # Retrieves the model name designated for the upper tier (e.g., most capable).
-      # Defaults to 'gemini-2.5-pro-experimental'.
-      # @return [String] The upper tier model name.
-      def upper_tier_model
-        @upper_tier_model || 'gemini-2.5-pro-experimental'
-      end
-    end
-  end
-end

data/lib/active_genie/configuration/providers/internal_company_api_config.rb

@@ -1,54 +0,0 @@
-require_relative '../../clients/internal_company_api_client'
-require_relative './base_config'
-
-module ActiveGenie
-  module Configuration::Providers
-    # Configuration class for the Internal Company API client.
-    # Manages API keys, URLs, model selections, and client instantiation.
-    class InternalCompanyApiConfig < BaseConfig
-      NAME = :internal_company_api
-
-      # Retrieves the API key.
-      # Falls back to the INTERNAL_COMPANY_API_KEY environment variable if not set.
-      # @return [String, nil] The API key.
-      def api_key
-        @api_key || ENV['INTERNAL_COMPANY_API_KEY']
-      end
-
-      # Retrieves the base API URL for Internal Company API.
-      # Defaults to 'https://api.internal-company.com/v1'.
-      # @return [String] The API base URL.
-      def api_url
-        @api_url || 'https://api.internal-company.com/v1'
-      end
-
-      # Lazily initializes and returns an instance of the InternalCompanyApiClient.
-      # Passes itself (the config object) to the client's constructor.
-      # @return [ActiveGenie::Clients::InternalCompanyApiClient] The client instance.
-      def client
-        @client ||= ::ActiveGenie::Clients::InternalCompanyApiClient.new(self)
-      end
-
-      # Retrieves the model name designated for the lower tier (e.g., cost-effective, faster).
-      # Defaults to 'internal-basic'.
-      # @return [String] The lower tier model name.
-      def lower_tier_model
-        @lower_tier_model || 'internal-basic'
-      end
-
-      # Retrieves the model name designated for the middle tier (e.g., balanced performance).
-      # Defaults to 'internal-standard'.
-      # @return [String] The middle tier model name.
-      def middle_tier_model
-        @middle_tier_model || 'internal-standard'
-      end
-
-      # Retrieves the model name designated for the upper tier (e.g., most capable).
-      # Defaults to 'internal-premium'.
-      # @return [String] The upper tier model name.
-      def upper_tier_model
-        @upper_tier_model || 'internal-premium'
-      end
-    end
-  end
-end

data/lib/active_genie/configuration/providers/openai_config.rb

@@ -1,54 +0,0 @@
-require_relative '../../clients/openai_client'
-require_relative './base_config'
-
-module ActiveGenie
-  module Configuration::Providers
-    # Configuration class for the OpenAI API client.
-    # Manages API keys, organization IDs, URLs, model selections, and client instantiation.
-    class OpenaiConfig < BaseConfig
-      NAME = :openai
-
-      # Retrieves the API key.
-      # Falls back to the OPENAI_API_KEY environment variable if not set.
-      # @return [String, nil] The API key.
-      def api_key
-        @api_key || ENV['OPENAI_API_KEY']
-      end
-
-      # Retrieves the base API URL for OpenAI API.
-      # Defaults to 'https://api.openai.com/v1'.
-      # @return [String] The API base URL.
-      def api_url
-        @api_url || 'https://api.openai.com/v1'
-      end
-
-      # Lazily initializes and returns an instance of the OpenaiClient.
-      # Passes itself (the config object) to the client's constructor.
-      # @return [ActiveGenie::Clients::OpenaiClient] The client instance.
-      def client
-        @client ||= ::ActiveGenie::Clients::OpenaiClient.new(self)
-      end
-
-      # Retrieves the model name designated for the lower tier (e.g., cost-effective, faster).
-      # Defaults to 'gpt-4o-mini'.
-      # @return [String] The lower tier model name.
-      def lower_tier_model
-        @lower_tier_model || 'gpt-4o-mini'
-      end
-
-      # Retrieves the model name designated for the middle tier (e.g., balanced performance).
-      # Defaults to 'gpt-4o'.
-      # @return [String] The middle tier model name.
-      def middle_tier_model
-        @middle_tier_model || 'gpt-4o'
-      end
-
-      # Retrieves the model name designated for the upper tier (e.g., most capable).
-      # Defaults to 'o1-preview'.
-      # @return [String] The upper tier model name.
-      def upper_tier_model
-        @upper_tier_model || 'o1-preview'
-      end
-    end
-  end
-end

data/lib/active_genie/configuration/providers_config.rb

@@ -1,40 +0,0 @@
-module ActiveGenie::Configuration
-  class ProvidersConfig
-    def initialize
-      @all = {}
-      @default = nil
-    end
-
-    def register(provider_class)
-      @all ||= {}
-      name = provider_class::NAME
-      @all[name] = provider_class.new
-      define_singleton_method(name) do
-        instance_variable_get("@#{name}") || instance_variable_set("@#{name}", @all[name])
-      end
-
-      self
-    end
-
-    def default
-      @default || @all.values.find { |p| p.api_key }.class::NAME
-    end
-
-    def valid
-      valid_provider_keys = @all.keys.select { |k| @all[k].valid? }
-      @all.slice(*valid_provider_keys)
-    end
-
-    def to_h(config = {})
-      hash_all = {}
-      @all.each do |name, provider|
-        hash_all[name] = provider.to_h(config.dig(name) || {})
-      end
-      hash_all
-    end
-
-    private
-
-    attr_writer :default
-  end
-end

data/lib/active_genie/configuration/runtime_config.rb

@@ -1,35 +0,0 @@
-module ActiveGenie::Configuration
-  class RuntimeConfig
-    attr_writer :max_tokens, :temperature, :model, :provider, :api_key, :max_retries
-
-    def max_tokens
-      @max_tokens ||= 4096
-    end
-
-    def temperature
-      @temperature ||= 0.1
-    end
-
-    def model
-      @model
-    end
-
-    def provider
-      @provider ||= ActiveGenie.configuration.providers.default
-    end
-
-    def api_key
-      @api_key
-    end
-
-    def max_retries
-      @max_retries ||= 3
-    end
-
-    def to_h(config = {})
-      {
-        max_tokens:, temperature:, model:, provider:, api_key:, max_retries:,
-      }.merge(config)
-    end
-  end
-end

data/lib/active_genie/data_extractor/basic.rb

@@ -1,101 +0,0 @@
-
-require_relative '../clients/unified_client'
-
-module ActiveGenie::DataExtractor
-  class Basic
-    def self.call(...)
-      new(...).call
-    end
-
-    # Extracts structured data from text based on a predefined schema.
-    #
-    # @param text [String] The input text to analyze and extract data from
-    # @param data_to_extract [Hash] Schema defining the data structure to extract.
-    #   Each key in the hash represents a field to extract, and its value defines the expected type and constraints.
-    # @param config [Hash] Additional config for the extraction process
-    #
-    # @return [Hash] The extracted data matching the schema structure. Each field will include
-    #   both the extracted value and an explanation of how it was derived.
-    #
-    # @example Extract a person's details
-    #   schema = {
-    #     name: { type: 'string', description: 'Full name of the person' },
-    #     age: { type: 'integer', description: 'Age in years' }
-    #   }
-    #   text = "John Doe is 25 years old"
-    #   DataExtractor.call(text, schema)
-    #   # => { name: "John Doe", name_explanation: "Found directly in text",
-    #   #      age: 25, age_explanation: "Explicitly stated as 25 years old" }
-    def initialize(text, data_to_extract, config: {})
-      @text = text
-      @data_to_extract = data_to_extract
-      @config = ActiveGenie::Configuration.to_h(config)
-    end
-
-    def call
-      messages = [
-        {  role: 'system', content: PROMPT },
-        {  role: 'user', content: @text }
-      ]
-
-      properties = data_to_extract_with_explaination
-
-      function = {
-        name: 'data_extractor',
-        description: 'Extract structured and typed data from user messages.',
-        parameters: {
-          type: "object",
-          properties:,
-          required: properties.keys
-        }
-      }
-
-      result = ::ActiveGenie::Clients::UnifiedClient.function_calling(
-        messages,
-        function,
-        model_tier: 'lower_tier',
-        config: @config
-      )
-
-      ActiveGenie::Logger.debug({
-        code: :data_extractor,
-        text: @text[0..30],
-        data_to_extract: @data_to_extract,
-        extracted_data: result
-      })
-
-      result
-    end
-
-    private
-
-    PROMPT = <<~PROMPT
-    Extract structured and typed data from user messages.
-    Identify relevant information within user messages and categorize it into predefined data fields with specific data types.
-
-    # Steps
-    1. **Identify Data Types**: Determine the types of data to collect, such as names, dates, email addresses, phone numbers, etc.
-    2. **Extract Information**: Use pattern recognition and language understanding to identify and extract the relevant pieces of data from the user message.
-    3. **Categorize Data**: Assign the extracted data to the appropriate predefined fields.
-
-    # Notes
-    - Handle missing or partial information gracefully.
-    - Manage multiple occurrences of similar data points by prioritizing the first one unless specified otherwise.
-    - Be flexible to handle variations in data format and language clues.
-    PROMPT
-
-    def data_to_extract_with_explaination
-      with_explaination = {}
-  
-      @data_to_extract.each do |key, value|
-        with_explaination[key] = value
-        with_explaination["#{key}_explanation"] = {
-          type: 'string',
-          description: "The chain of thought that led to the conclusion about: #{key}. Can be blank if the user didn't provide any context",
-        }
-      end
-      
-      with_explaination
-    end
-  end
-end

data/lib/active_genie/scoring/basic.rb

@@ -1,170 +0,0 @@
-# frozen_string_literal: true
-
-require_relative '../clients/unified_client'
-
-module ActiveGenie::Scoring
-  # The Basic class provides a foundation for scoring text content against specified criteria
-  # using AI-powered evaluation. It supports both single and multiple reviewer scenarios,
-  # with the ability to automatically recommend reviewers when none are specified.
-  #
-  # The scoring process evaluates text based on given criteria and returns detailed feedback
-  # including individual reviewer scores, reasoning, and a final aggregated score.
-  #
-  # @example Basic usage with a single reviewer
-  #   Basic.call("Sample text", "Evaluate grammar and clarity", ["Grammar Expert"])
-  #
-  # @example Usage with automatic reviewer recommendation
-  #   Basic.call("Sample text", "Evaluate technical accuracy")
-  #
-  class Basic
-    # @param text [String] The text content to be evaluated
-    # @param criteria [String] The evaluation criteria or rubric to assess against
-    # @param reviewers [Array<String>] Optional list of specific reviewers. If empty,
-    #   reviewers will be automatically recommended based on the content and criteria
-    # @param config [Hash] Additional configuration config that modify the scoring behavior
-    # @return [Hash] The evaluation result containing the scores and reasoning
-    #   @return [Number] :final_score The final score of the text based on the criteria and reviewers
-    #   @return [String] :final_reasoning Detailed explanation of why the final score was reached
-    def self.call(...)
-      new(...).call
-    end
-
-    def initialize(text, criteria, reviewers = [], config: {})
-      @text = text
-      @criteria = criteria
-      @reviewers = Array(reviewers).compact.uniq
-      @config = ActiveGenie::Configuration.to_h(config)
-    end
-
-    def call
-      messages = [
-        {  role: 'system', content: PROMPT },
-        {  role: 'user', content: "Scoring criteria: #{@criteria}" },
-        {  role: 'user', content: "Text to score: #{@text}" }, 
-      ]
-
-      properties = build_properties
-
-      function = {
-        name: 'scoring',
-        description: 'Score the text based on the given criteria.',
-        parameters: {
-          type: "object",
-          properties:,
-          required: properties.keys
-        }
-      }
-
-      result = ::ActiveGenie::Clients::UnifiedClient.function_calling(
-        messages,
-        function,
-        model_tier: 'lower_tier',
-        config: @config
-      )
-
-      result['final_score'] = 0 if result['final_score'].nil?
-
-      ActiveGenie::Logger.debug({
-        code: :scoring,
-        text: @text[0..30],
-        criteria: @criteria[0..30],
-        reviewers: get_or_recommend_reviewers,
-        score: result['final_score'],
-        reasoning: result['final_reasoning']
-      })
-
-      result
-    end
-
-    private
-    
-    def build_properties
-      properties = {}
-      get_or_recommend_reviewers.each do |reviewer|
-        properties["#{reviewer}_reasoning"] = {
-          type: 'string',
-          description: "The reasoning of the scoring process by #{reviewer}.",
-        }
-        properties["#{reviewer}_score"] = {
-          type: 'number',
-          description: "The score given by #{reviewer}.",
-          min: 0,
-          max: 100
-        }
-      end
-
-      properties[:final_score] = {
-        type: 'number',
-        description: 'The final score based on the previous reviewers',
-      }
-      properties[:final_reasoning] = {
-        type: 'string',
-        description: 'The final reasoning based on the previous reviewers',
-      }
-
-      properties
-    end
-
-    def get_or_recommend_reviewers
-      @get_or_recommend_reviewers ||= if @reviewers.count > 0 
-        @reviewers
-      else
-        result = RecommendedReviewers.call(@text, @criteria, config: @config)
-
-        [result['reviewer1'], result['reviewer2'], result['reviewer3']]
-      end
-    end
-
-    PROMPT = <<~PROMPT
-    Evaluate and score the provided text based on predefined criteria, using a scoring range of 0 to 100 with 100 representing the highest possible score.
-
-    Follow the instructions below to ensure a comprehensive and objective assessment. 
-
-    # Evaluation Process
-
-    1. **Analysis**: 
-      - Thoroughly compare the text against each criterion for a comprehensive evaluation.
-      
-    2. **Document Deviations**:
-      - Identify and document areas where the content does not align with the specified criteria.
-
-    3. **Highlight Strengths**:
-      - Note notable features or elements that enhance the quality or effectiveness of the content.
-
-    4. **Identify Weaknesses**:
-      - Specify areas where the content fails to meet the criteria or where improvements could be made.
-
-    # Scoring Fairness
-
-    - Ensure the assigned score reflects both the alignment with the criteria and the content's effectiveness.
-    - Consider if the fulfillment of other criteria compensates for areas lacking extreme details.
-
-    # Scoring Range
-
-    Segment scores into five parts before assigning a final score:
-    - **Terrible**: 0-20 - Content does not meet the criteria.
-    - **Bad**: 21-40 - Content is substandard but meets some criteria.
-    - **Average**: 41-60 - Content meets criteria with room for improvement.
-    - **Good**: 61-80 - Content exceeds criteria and is above average.
-    - **Great**: 81-100 - Content exceeds all expectations.
-
-    # Guidelines
-
-    - Maintain objectivity and avoid biases.
-    - Deconstruct each criterion into actionable components for systematic evaluation.
-    - Apply reasonable judgment in assigning a score, justifying your rationale clearly.
-
-    # Output Format
-
-    - Provide a detailed review including:
-      - A final score (0-100)
-      - Specific reasoning for the assigned score, detailing all evaluated criteria
-      - Include both positive aspects and suggested improvements
-
-    # Notes
-
-    - Consider edge cases where the text may partially align with criteria.
-    - If lacking information, reasonably judge and explain your scoring approach.
-    PROMPT
-  end
-end