last_llm 0.0.6 → 0.0.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fbbca19ed3e3a2df1b0719317c35219d19559ffe0747336546c727eb4aafba58
-  data.tar.gz: a8e24e555e72ee106e68f2846a9449a9dd45c9ed656539d34185dd731e8304a7
+  metadata.gz: c45436277c2f585b851688ade72bbd838d33f0c51b0792942e56734e534a9a2e
+  data.tar.gz: 0ad94566719d472ccfcea83cb5bce21cd4142df80b2ffdda0f139ff561d6c9d8
 SHA512:
-  metadata.gz: f59d7412a949b1809d1481891f61738ec5e10fa1d275ea7af7f12387c705437801982ad0841f9fef3d2d9b9dd426d770d47da31b4fae6bc0f49e85cfd78e5eef
-  data.tar.gz: 406c2dca198e6659d281a03754cca5c5ff5757669bb6edc64fa564144ea6aa6ee770530faad5541df7be641e0152285f0759f3176a096be82c59980a1cb80b59
+  metadata.gz: c77932637b424601a950f6ad655c3886773be3b9880f4ce5607d4af18f0036876dd9463c973f64628c1a97ef50d73b56af9d6cd7f492144da164177dc628d4dc
+  data.tar.gz: 51709ae9cfee0d6047b5076ca0926f6395ebae1cbaa7c3b6621787dca86e8f0ff3a5d3e5f44a1d1038315effeae118b32352b963ae12f23fdd43c7356b99ca1e

data/README.md

@@ -45,128 +45,28 @@ LastLLM.configure do |config|
 end
 ```
 
-### Rails Integration
+### Logging
 
-LastLLM automatically integrates with Rails applications. Create a `config/last_llm.yml` file:
-
-```yaml
-default_provider: openai
-default_model: gpt-3.5-turbo
-globals:
-  timeout: 30
-  max_retries: 3
-```
-
-## Usage
-
-### Basic Text Generation
+LastLLM supports custom logging for monitoring requests, responses, and errors. You can configure a custom logger to integrate with your existing logging system:
 
 ```ruby
-client = LastLLM.client
-response = client.generate_text("What is the capital of France?")
-```
-
-### Structured Data Generation
+LastLLM.configure do |config|
+  # Use Rails logger
+  config.logger = Rails.logger
 
-```ruby
-schema = Dry::Schema.JSON do
-  required(:name).filled(:string)
-  required(:age).filled(:integer)
-  optional(:email).maybe(:string)
+  # Set log level (optional, defaults to :info)
+  config.log_level = :debug
 end
-
-client = LastLLM.client
-result = client.generate_object("Generate information about a person", schema)
 ```
 
-### Tool Calling
-
-```ruby
-calculator = LastLLM::Tool.new(
-  name: "calculator",
-  description: "Perform mathematical calculations",
-  parameters: {
-    type: "object",
-    properties: {
-      operation: {
-        type: "string",
-        enum: ["add", "subtract", "multiply", "divide"]
-      },
-      a: { type: "number" },
-      b: { type: "number" }
-    },
-    required: ["operation", "a", "b"]
-  },
-  function: ->(params) {
-    case params[:operation]
-    when "add"
-      { result: params[:a] + params[:b] }
-    end
-  }
-)
-```
-
-## Error Handling
-
-LastLLM provides several error classes:
-- `LastLLM::Error`: Base error class
-- `LastLLM::ConfigurationError`: Configuration-related errors
-- `LastLLM::ValidationError`: Schema validation errors
-- `LastLLM::ApiError`: API request errors
-
-## Development
+In a Rails application, you can also configure this in your `config/last_llm.yml`:
 
-After checking out the repo, run `bundle install` to install dependencies. Then, run `rspec` to run the tests.
-
-## Contributing
-
-Bug reports and pull requests are welcome on GitHub.
-# LastLLM
-
-LastLLM is a unified client for interacting with various LLM (Large Language Model) providers. It provides a consistent interface for text generation, structured data generation, and tool calling across different LLM services.
-
-## Features
-
-- Unified interface for multiple LLM providers:
-  - OpenAI
-  - Anthropic
-  - Google Gemini
-  - Deepseek
-  - Ollama
-- Text generation
-- Structured data generation with schema validation
-- Tool/function calling support
-- Rails integration
-- Configuration management
-- Error handling
-
-## Installation
-
-Add this line to your application's Gemfile:
-
-```ruby
-gem 'last_llm'
+```yaml
+logger: Rails.logger
+log_level: debug
 ```
 
-## Configuration
-
-Configure LastLLM globally or per instance:
-
-```ruby
-LastLLM.configure do |config|
-  config.default_provider = :openai
-  config.default_model = 'gpt-3.5-turbo'
-
-  # Configure OpenAI
-  config.configure_provider(:openai, api_key: 'your-api-key')
-
-  # Configure Anthropic
-  config.configure_provider(:anthropic, api_key: 'your-api-key')
-
-  # Configure Ollama
-  config.configure_provider(:ollama, host: 'http://localhost:11434')
-end
-```
+This will log LLM requests, responses, and errors to your Rails application logs, helping you debug and monitor your AI interactions.
 
 ### Rails Integration
 

data/lib/last_llm/provider.rb

@@ -148,5 +148,91 @@ module LastLLM
         end
       end
     end
+
+    def make_request(prompt, options = {})
+      log_request(prompt, options)
+
+      response = yield
+
+      log_response(response)
+
+      handle_response(response) do |result|
+        yield(result)
+      end
+    rescue Faraday::Error => e
+      @logger&.error("[#{@name}] Request failed: #{e.message}")
+      handle_provider_error(e)
+    end
+
+    private
+
+    def log_request(prompt, options)
+      return unless @logger
+
+      sanitized_options = options.dup
+      # Remove sensitive data
+      sanitized_options.delete(:api_key)
+
+      @logger.info("[#{@name}] Request - Model: #{options[:model]}")
+      @logger.debug("[#{@name}] Prompt: #{prompt}")
+      @logger.debug("[#{@name}] Options: #{sanitized_options.inspect}")
+    end
+
+    def log_response(response)
+      return unless @logger
+
+      @logger.info("[#{@name}] Response received - Status: #{response.status}")
+      @logger.debug("[#{@name}] Response body: #{response.body}")
+    rescue StandardError => e
+      @logger.error("[#{@name}] Failed to log response: #{e.message}")
+    end
+
+    def handle_provider_error(error)
+      @logger&.error("[#{@name}] #{error.class}: #{error.message}")
+      raise ApiError.new(error.message, error.response&.status)
+    end
+
+    def make_request(prompt, options = {})
+      log_request(prompt, options)
+
+      response = yield
+
+      log_response(response)
+
+      handle_response(response) do |result|
+        yield(result)
+      end
+    rescue Faraday::Error => e
+      @logger&.error("[#{@name}] Request failed: #{e.message}")
+      handle_provider_error(e)
+    end
+
+    private
+
+    def log_request(prompt, options)
+      return unless @logger
+
+      sanitized_options = options.dup
+      # Remove sensitive data
+      sanitized_options.delete(:api_key)
+
+      @logger.info("[#{@name}] Request - Model: #{options[:model]}")
+      @logger.debug("[#{@name}] Prompt: #{prompt}")
+      @logger.debug("[#{@name}] Options: #{sanitized_options.inspect}")
+    end
+
+    def log_response(response)
+      return unless @logger
+
+      @logger.info("[#{@name}] Response received - Status: #{response.status}")
+      @logger.debug("[#{@name}] Response body: #{response.body}")
+    rescue StandardError => e
+      @logger.error("[#{@name}] Failed to log response: #{e.message}")
+    end
+
+    def handle_provider_error(error)
+      @logger&.error("[#{@name}] #{error.class}: #{error.message}")
+      raise ApiError.new(error.message, error.response&.status)
+    end
   end
 end

data/lib/last_llm/providers/google_gemini.rb

@@ -32,7 +32,7 @@ module LastLLM
       end
 
       def generate_text(prompt, options = {})
-        make_request(prompt, options) do |response|
+          make_request(prompt, options) do |response|
           extract_text_content(response)
         end
       end

data/lib/last_llm/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module LastLLM
-  VERSION = '0.0.6'
+  VERSION = '0.0.7'
 end

data/lib/tasks/release.rake

@@ -0,0 +1,67 @@
+# frozen_string_literal: true
+
+require 'bundler/gem_tasks'
+
+namespace :version do
+  desc 'Bump major version (X.y.z)'
+  task :major do
+    bump_version(:major)
+  end
+
+  desc 'Bump minor version (x.Y.z)'
+  task :minor do
+    bump_version(:minor)
+  end
+
+  desc 'Bump patch version (x.y.Z)'
+  task :patch do
+    bump_version(:patch)
+  end
+
+  def bump_version(type)
+    version_file = 'lib/last_llm/version.rb'
+    content = File.read(version_file)
+    current_version = content.match(/VERSION\s*=\s*['"](\d+\.\d+\.\d+)['"]/)[1]
+    major, minor, patch = current_version.split('.').map(&:to_i)
+
+    case type
+    when :major
+      major += 1
+      minor = 0
+      patch = 0
+    when :minor
+      minor += 1
+      patch = 0
+    when :patch
+      patch += 1
+    end
+
+    new_version = "#{major}.#{minor}.#{patch}"
+    new_content = content.gsub(/VERSION\s*=\s*['"](\d+\.\d+\.\d+)['"]/, "VERSION = '#{new_version}'")
+    
+    File.write(version_file, new_content)
+    puts "Version bumped to #{new_version}"
+  end
+end
+
+namespace :release do
+  desc 'Build and push gem to RubyGems'
+  task :push do
+    system('gem build last_llm.gemspec') || abort('Gem build failed')
+    gem_file = Dir['last_llm-*.gem'].sort_by { |f| File.mtime(f) }.last
+    system("gem push #{gem_file}") || abort('Gem push failed')
+    FileUtils.rm(gem_file)
+    puts "Successfully released #{gem_file}"
+  end
+end
+
+desc 'Bump version, build and push gem (usage: rake release[patch])'
+task :release, [:type] => [:clean] do |_, args|
+  type = (args[:type] || 'patch').to_sym
+  unless %i[major minor patch].include?(type)
+    abort "Invalid version type. Use 'major', 'minor', or 'patch'"
+  end
+
+  Rake::Task["version:#{type}"].invoke
+  Rake::Task['release:push'].invoke
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: last_llm
 version: !ruby/object:Gem::Version
-  version: 0.0.6
+  version: 0.0.7
 platform: ruby
 authors:
 - Sam Obukwelu
@@ -123,6 +123,7 @@ files:
 - lib/last_llm/structured_output.rb
 - lib/last_llm/tool.rb
 - lib/last_llm/version.rb
+- lib/tasks/release.rake
 homepage: https://github.com/joemocha/last_llm
 licenses:
 - MIT