llm_conductor 1.0.0 → 1.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c692236c5d26b598a2275a3a6591022312aec4e4a4d4ee57a186abc774bc39ce
-  data.tar.gz: 3c20edc85442b8e5227fb6896d3899f08495fa1296306042c07c8bc62a883941
+  metadata.gz: 00742db531ea95e6247acbb8b7ea7e92619df851b0d558fd33a4f20d8cf23873
+  data.tar.gz: 9492982bc533d2552b9b55f8e0892fc523c2340d75086ade217651bf9d72730a
 SHA512:
-  metadata.gz: 8ed23461382c3a8ee2fddea05fdaef5c72111bac8e4b820e4310a40105a8b0bd78b8f1c36c9176f9ac7ddf8c7b4300e9208b45711a129ab0531dd579f9a52964
-  data.tar.gz: d446efb23252acee7ea453361d402089b87c56450e20ed7e45b1aab2cd0381bff442ed51ea7e2a52a544c39f3117795ad17ac2208dc12514f211d12ba150bb2c
+  metadata.gz: 8d23aa8d06cc823d77ec4992605208f693a592971d13f88266d587cf06fe78cd42111b7904404cc998215736df1d2b9acf452c5474d070401619d6774a870993
+  data.tar.gz: 154240f949c96860372b6cc6eb097267c1a4e9a52b6da968dc30f53d18069f4034fdadfe12fe38b51e5be99d54f75988f1aa48864b624635ce63077bc7f8da6f

data/README.md

@@ -109,6 +109,33 @@ LlmConductor.configure do |config|
   config.ollama(
     base_url: ENV['OLLAMA_ADDRESS'] || 'http://localhost:11434'
   )
+
+  # Optional: Configure custom logger
+  config.logger = Logger.new($stdout)                  # Log to stdout
+  config.logger = Logger.new('log/llm_conductor.log')  # Log to file
+  config.logger = Rails.logger                         # Use Rails logger (in Rails apps)
+end
+```
+
+### Logging Configuration
+
+LLM Conductor supports flexible logging using Ruby's built-in Logger class. By default, when a logger is configured, it uses the DEBUG log level to provide detailed information during development.
+
+```ruby
+LlmConductor.configure do |config|
+  # Option 1: Log to stdout - uses DEBUG level by default
+  config.logger = Logger.new($stdout)
+
+  # Option 2: Log to file - set appropriate level
+  config.logger = Logger.new('log/llm_conductor.log')
+
+  # Option 3: Use Rails logger (Rails apps)
+  config.logger = Rails.logger
+
+  # Option 4: Custom logger with formatting
+  config.logger = Logger.new($stderr).tap do |logger|
+    logger.formatter = proc { |severity, datetime, progname, msg| "#{msg}\n" }
+  end
 end
 ```
 

data/config/initializers/llm_conductor.rb

@@ -10,7 +10,8 @@ LlmConductor.configure do |config|
   config.timeout = 30
   config.max_retries = 3
   config.retry_delay = 1.0
-
+  # Use Ruby's built-in Logger class directly
+  config.logger = Logger.new($stdout)
   # Configure providers
   config.openai(
     api_key: ENV['OPENAI_API_KEY'],

data/lib/llm_conductor/clients/base_client.rb

@@ -24,6 +24,12 @@ module LlmConductor
         output_text = generate_content(prompt)
         output_tokens = calculate_tokens(output_text || '')
 
+        # Logging AI request metadata if logger is set
+        configuration.logger&.debug(
+          "Vendor: #{vendor_name}, Model: #{@model} " \
+          "Output_tokens: #{output_tokens} Input_tokens: #{input_tokens}"
+        )
+
         build_response(output_text, input_tokens, output_tokens, { prompt: })
       rescue StandardError => e
         build_error_response(e)
@@ -35,6 +41,12 @@ module LlmConductor
         output_text = generate_content(prompt)
         output_tokens = calculate_tokens(output_text || '')
 
+        # Logging AI request metadata if logger is set
+        configuration.logger&.debug(
+          "Vendor: #{vendor_name}, Model: #{@model} " \
+          "Output_tokens: #{output_tokens} Input_tokens: #{input_tokens}"
+        )
+
         build_response(output_text, input_tokens, output_tokens)
       rescue StandardError => e
         build_error_response(e)
@@ -89,10 +101,18 @@ module LlmConductor
       # Build metadata for the response
       def build_metadata
         {
-          vendor: self.class.name.split('::').last.gsub('Client', '').downcase.to_sym,
+          vendor: vendor_name,
           timestamp: Time.now.utc.iso8601
         }
       end
+
+      def vendor_name
+        self.class.name.split('::').last.gsub('Client', '').downcase.to_sym
+      end
+
+      def configuration
+        LlmConductor.configuration
+      end
     end
   end
 end

data/lib/llm_conductor/configuration.rb

@@ -4,7 +4,7 @@
 module LlmConductor
   # Configuration class for managing API keys, endpoints, and default settings
   class Configuration
-    attr_accessor :default_model, :default_vendor, :timeout, :max_retries, :retry_delay
+    attr_accessor :default_model, :default_vendor, :timeout, :max_retries, :retry_delay, :logger
     attr_reader :providers
 
     def initialize
@@ -14,6 +14,7 @@ module LlmConductor
       @timeout = 30
       @max_retries = 3
       @retry_delay = 1.0
+      @logger = nil
 
       # Provider configurations
       @providers = {}

data/lib/llm_conductor/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module LlmConductor
-  VERSION = '1.0.0'
+  VERSION = '1.0.1'
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: llm_conductor
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.0.1
 platform: ruby
 authors:
 - Ben Zheng
 bindir: exe
 cert_chain: []
-date: 2025-09-26 00:00:00.000000000 Z
+date: 2025-10-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport