last_llm 0.0.4

data/lib/last_llm/tool.rb

@@ -0,0 +1,110 @@
+# frozen_string_literal: true
+
+module LastLLM
+  # Error raised when tool parameter validation fails
+  class ToolValidationError < ValidationError; end
+
+  # Tool class for defining callable functions that can be used with LLM providers
+  class Tool
+    attr_reader :name, :description, :parameters, :function
+
+    # Initialize a new tool
+    # @param name [String] The name of the tool
+    # @param description [String] A description of what the tool does
+    # @param parameters [Hash] JSON Schema for the tool parameters
+    # @param function [Proc] The function to execute when the tool is called
+    def initialize(name:, description:, parameters:, function:)
+      validate_initialization_params(name, description, parameters, function)
+
+      @name = name
+      @description = description
+      @parameters = parameters
+      @function = function
+    end
+
+    # Call the tool with the provided parameters
+    # @param params [Hash] Parameters to pass to the tool function
+    # @return [Hash] The result of the function call
+    def call(params)
+      # Convert string keys to symbols
+      params = symbolize_keys(params)
+
+      # Validate parameters against the schema
+      validate_parameters(params)
+
+      # Convert parameter types if needed
+      converted_params = convert_parameter_types(params)
+
+      # Execute the function
+      function.call(converted_params)
+    end
+
+    private
+
+    def validate_initialization_params(name, description, parameters, function)
+      missing_params = []
+      missing_params << 'name' unless name.is_a?(String) && !name.empty?
+      missing_params << 'description' unless description.is_a?(String) && !description.empty?
+      missing_params << 'parameters' unless parameters.is_a?(Hash) && !parameters.empty?
+      missing_params << 'function' unless function.respond_to?(:call)
+
+      return if missing_params.empty?
+
+      raise ArgumentError, "Missing or invalid required attributes: #{missing_params.join(', ')}"
+    end
+
+    def validate_parameters(params)
+      # Basic validation for required parameters
+      if parameters[:required].is_a?(Array)
+        parameters[:required].each do |required_param|
+          unless params.key?(required_param.to_sym)
+            raise ToolValidationError, "Missing required parameter: #{required_param}"
+          end
+        end
+      end
+
+      # Validate enum values if present
+      return unless parameters[:properties].is_a?(Hash)
+
+      parameters[:properties].each do |prop_name, prop_schema|
+        next unless params.key?(prop_name.to_sym) && prop_schema[:enum].is_a?(Array)
+
+        param_value = params[prop_name.to_sym]
+        unless prop_schema[:enum].include?(param_value)
+          raise ToolValidationError, "Invalid value for #{prop_name}: #{param_value}. " \
+                                     "Allowed values: #{prop_schema[:enum].join(', ')}"
+        end
+      end
+    end
+
+    def convert_parameter_types(params)
+      converted_params = params.dup
+
+      parameters[:properties].each do |prop_name, prop_schema|
+        next unless params.key?(prop_name.to_sym)
+
+        param_value = params[prop_name.to_sym]
+        prop_name_sym = prop_name.to_sym
+
+        case prop_schema[:type]
+        when 'number', 'integer'
+          converted_params[prop_name_sym] = param_value.to_f if param_value.is_a?(String)
+          if prop_schema[:type] == 'integer' && param_value.is_a?(Float)
+            converted_params[prop_name_sym] =
+              param_value.to_i
+          end
+        when 'boolean'
+          converted_params[prop_name_sym] = (param_value.downcase == 'true') if param_value.is_a?(String)
+        end
+      end
+
+      converted_params
+    end
+
+    def symbolize_keys(hash)
+      return hash unless hash.is_a?(Hash)
+
+      hash.transform_keys(&:to_sym)
+    end
+  end
+end

data/lib/last_llm/version.rb

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

data/lib/last_llm.rb

@@ -0,0 +1,88 @@
+# frozen_string_literal: true
+
+require 'dry-schema'
+require 'faraday'
+require 'json'
+require 'last_llm/extensions/dry_schema_extensions'
+
+# Main module for LastLLM
+module LastLLM
+  # Base error class for all LastLLM errors
+  class Error < StandardError; end
+
+  # Error raised when configuration is invalid
+  class ConfigurationError < Error; end
+
+  # Error raised when validation fails
+  class ValidationError < Error; end
+
+  # Error raised when API request fails
+  class ApiError < Error
+    attr_reader :status
+
+    def initialize(message, status = nil)
+      @status = status
+      super(message)
+    end
+  end
+
+  # Autoload all required components
+  autoload :Configuration, 'last_llm/configuration'
+  autoload :Client, 'last_llm/client'
+  autoload :Provider, 'last_llm/provider'
+  autoload :Schema, 'last_llm/schema'
+  autoload :StructuredOutput, 'last_llm/structured_output'
+  autoload :Tool, 'last_llm/tool'
+  autoload :Railtie, 'last_llm/railtie'
+  autoload :Completion, 'last_llm/completion'
+  autoload :VERSION, 'last_llm/version'
+
+  # Provider implementations
+  module Providers
+    autoload :OpenAI, 'last_llm/providers/openai'
+    autoload :Anthropic, 'last_llm/providers/anthropic'
+    autoload :GoogleGemini, 'last_llm/providers/google_gemini'
+    autoload :Deepseek, 'last_llm/providers/deepseek'
+    autoload :Ollama, 'last_llm/providers/ollama'
+  end
+
+  class << self
+    # Configure the LastLLM client
+    # @yield [config] Configuration instance
+    # @return [Configuration] The updated configuration
+    def configure
+      self.configuration ||= Configuration.new
+      yield(configuration) if block_given?
+      configuration
+    end
+
+    # Get the current configuration or create a new one
+    # @return [Configuration] The current configuration
+    def configuration
+      @configuration ||= Configuration.new
+    end
+
+    # Create a new client with the current configuration
+    # @param options [Hash] Additional options for the client
+    # @return [Client] A new client instance
+    def client(options = {})
+      Client.new(configuration, options)
+    end
+
+    # Reset the configuration to defaults
+    # @return [Configuration] A new default configuration
+    def reset_configuration!
+      @configuration = Configuration.new
+    end
+
+    # Add Rails integration helper
+    def setup_rails!
+      return unless defined?(Rails)
+
+      require 'last_llm/railtie'
+    end
+  end
+end
+
+# Rails integration
+LastLLM.setup_rails! if defined?(Rails)

metadata

@@ -0,0 +1,144 @@
+--- !ruby/object:Gem::Specification
+name: last_llm
+version: !ruby/object:Gem::Version
+  version: 0.0.4
+platform: ruby
+authors:
+- Sam Obukwelu
+bindir: bin
+cert_chain: []
+date: 2025-03-04 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: dry-schema
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.12'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.12'
+- !ruby/object:Gem::Dependency
+  name: vcr
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.0'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.18'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.18'
+description: A unified client for interacting with various LLM providers
+email:
+- sam@obukwelu.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- lib/last_llm.rb
+- lib/last_llm/client.rb
+- lib/last_llm/completion.rb
+- lib/last_llm/configuration.rb
+- lib/last_llm/extensions/dry_schema_extensions.rb
+- lib/last_llm/provider.rb
+- lib/last_llm/providers/anthropic.rb
+- lib/last_llm/providers/constants.rb
+- lib/last_llm/providers/deepseek.rb
+- lib/last_llm/providers/google_gemini.rb
+- lib/last_llm/providers/ollama.rb
+- lib/last_llm/providers/openai.rb
+- lib/last_llm/providers/test_provider.rb
+- lib/last_llm/railtie.rb
+- lib/last_llm/schema.rb
+- lib/last_llm/structured_output.rb
+- lib/last_llm/tool.rb
+- lib/last_llm/version.rb
+homepage: https://github.com/joemocha/last_llm
+licenses:
+- MIT
+metadata:
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.3
+specification_version: 4
+summary: Last LLM
+test_files: []