intelligence 0.5.0

data/lib/intelligence/error.rb

@@ -0,0 +1,3 @@
+module Intelligence 
+  class Error < StandardError; end 
+end

data/lib/intelligence/error_result.rb

@@ -0,0 +1,24 @@
+module Intelligence
+
+  class ErrorResult
+  # ---------------
+
+    attr_reader :error_type
+    attr_reader :error
+    attr_reader :error_description
+
+    def initialize( error_attributes )
+    # --------------------------------
+      error_attributes.each do | key, value |
+        instance_variable_set( "@#{key}", value ) if self.respond_to?( "#{key}" )
+      end
+    end
+
+    def empty?
+    # --------
+      @error_type.nil? && @error.nil? && @error_description.nil?
+    end
+
+  end
+
+end

data/lib/intelligence/invalid_content_error.rb

@@ -0,0 +1,3 @@
+module Intelligence 
+  class InvalidContentError < AdapterError; end 
+end

data/lib/intelligence/message.rb

@@ -0,0 +1,53 @@
+module Intelligence
+  class Message
+
+    ROLES = [ :system, :user, :assistant ]
+
+    attr_reader :role
+    attr_reader :contents
+
+    def initialize( role, content_type = nil, content_attributes = nil )
+      raise ArgumentError.new( "The role is invalid. It must be one of #{ROLES.join( ', ' )}." ) \
+        unless ROLES.include?( role.to_sym )
+
+      @role = role.to_sym 
+      @contents = []   
+
+      @contents << MessageContent.build( content_type, content_attributes ) unless content_type.nil?
+    end
+
+    def append_content( content )
+      @contents.push( content ) unless content.nil?
+      self 
+    end
+
+    def build_and_append_content( content_type = nil, content_attributes = nil )
+      append_content(
+        MessageContent.build( content_type, content_attributes )
+      )
+      self 
+    end
+
+    alias :<< :append_content
+   
+    def each_content( &block )
+      @contents.each( &block )
+    end
+
+    def empty?
+      @contents.empty?
+    end
+
+    def valid?
+      !@role.nil? && @contents.all?{ | contents | contents.valid? }
+    end
+
+    def to_h
+      { 
+        role: @role,
+        contents: @contents.map { | c | c.to_h }
+      }
+    end
+
+  end
+end

data/lib/intelligence/message_content/base.rb

@@ -0,0 +1,18 @@
+module Intelligence   
+  module MessageContent 
+
+    class Base
+      def initialize( attributes = {} )
+        attributes.each do | key, value |
+          instance_variable_set( "@#{key}", value.freeze ) if self.respond_to?( "#{key}" )
+        end
+      end
+
+      def valid?
+        false
+      end
+    end
+
+  end
+end
+

data/lib/intelligence/message_content/binary.rb

@@ -0,0 +1,24 @@
+module Intelligence   
+  module MessageContent 
+
+    class Binary < Base
+      attr_reader :content_type 
+      attr_reader :bytes
+      
+      def valid?
+        ( @content_type || false ) && !MIME::Types[ @content_type ].empty? && 
+        ( @bytes || false ) && bytes.respond_to?( :empty? ) && !bytes.empty? 
+      end
+
+      def image?
+        ( @content_type || false ) && 
+        ( MIME::Types[ @content_type ]&.first&.media_type == 'image' )
+      end
+
+      def to_h
+        { type: :binary, content_type: content_type, bytes: bytes }
+      end
+    end 
+
+  end
+end

data/lib/intelligence/message_content/text.rb

@@ -0,0 +1,17 @@
+module Intelligence   
+  module MessageContent 
+
+    class Text < Base
+      attr_reader :text 
+      
+      def valid?
+        ( text || false ) && text.respond_to?( :empty? ) && !text.empty? 
+      end
+
+      def to_h
+        { type: :text, text: text }
+      end
+    end 
+
+  end
+end

data/lib/intelligence/message_content/tool_call.rb

@@ -0,0 +1,20 @@
+module Intelligence   
+  module MessageContent 
+
+    class ToolCall < Base
+      attr_reader :tool_call_id 
+      attr_reader :tool_name
+      attr_reader :tool_parameters
+
+      def to_h
+        { 
+          type:             :tool_call, 
+          tool_call_id:     tool_call_id, 
+          tool_name:        tool_name, 
+          tool_parameters:  tool_parameters 
+        }.compact
+      end
+    end 
+
+  end
+end

data/lib/intelligence/message_content/tool_result.rb

@@ -0,0 +1,20 @@
+module Intelligence   
+  module MessageContent 
+
+    class ToolResult < Base
+      attr_reader :tool_call_id 
+      attr_reader :tool_name
+      attr_reader :tool_result
+
+      def to_h
+        { 
+          type:             :tool_call, 
+          tool_call_id:     tool_call_id, 
+          tool_name:        tool_name, 
+          tool_parameters:  tool_result 
+        }.compact
+      end
+    end 
+
+  end
+end

data/lib/intelligence/message_content.rb

@@ -0,0 +1,16 @@
+Dir[ File.join( __dir__, 'message_content', '*.rb' ) ].each do | file |
+  require_relative file
+end
+
+module Intelligence   
+  module MessageContent 
+    
+    def self.build( type, attributes )
+      type_name = type.to_s.split( '_' ).map { | word | word.capitalize }.join
+      klass = Intelligence.const_get( "MessageContent::#{type_name}" ) rescue nil
+      klass.nil? ? nil : klass.new( attributes )
+    end
+
+  end
+end
+

data/lib/intelligence/unsupported_content_error.rb

@@ -0,0 +1,3 @@
+module Intelligence 
+  class UnsupportedContentError < AdapterError; end 
+end

data/lib/intelligence/version.rb

@@ -0,0 +1,3 @@
+module Intelligence
+  VERSION = "0.5.0"
+end

data/lib/intelligence.rb

@@ -0,0 +1,24 @@
+require 'json'
+
+require 'faraday'
+require 'adaptive_configuration'
+require 'mime-types'
+
+require 'intelligence/version'
+
+require 'intelligence/error'
+require 'intelligence/adapter_error'
+require 'intelligence/unsupported_content_error'
+
+require 'intelligence/error_result'
+
+require 'intelligence/conversation'
+require 'intelligence/message'
+require 'intelligence/message_content'
+require 'intelligence/adapter'
+require 'intelligence/chat_request'
+require 'intelligence/chat_result'
+require 'intelligence/chat_result_choice'
+require 'intelligence/chat_metrics'
+require 'intelligence/chat_error_result'
+

metadata

@@ -0,0 +1,181 @@
+--- !ruby/object:Gem::Specification
+name: intelligence
+version: !ruby/object:Gem::Version
+  version: 0.5.0
+platform: ruby
+authors:
+- Kristoph Cichocki-Romanov
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2024-10-08 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.7'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.7'
+- !ruby/object:Gem::Dependency
+  name: adaptiveconfiguration
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.0.0.beta01
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.0.0.beta01
+- !ruby/object:Gem::Dependency
+  name: mime-types
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.6'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.6'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.4'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.4'
+- !ruby/object:Gem::Dependency
+  name: debug
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.9'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.9'
+- !ruby/object:Gem::Dependency
+  name: vcr
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.3'
+description: Intelligence is a lightweight yet powerful Ruby gem that allows you to
+  seamlessly and uniformly  interact with large language and vision models (LLM) API's
+  of numerous vendors, including  OpenAI, Anthropic, Google, Cerebras, Groq, Hyperbolic,
+  Samba Nova and Together AI. It can be  trivially expanded to other OpenAI conformant
+  API providers as well as self hosted models.  Intelligence supports text models
+  in streaming and non-streaming mode, vision models, and  tool use.    Intelligence
+  has minimal dependencies and does not require the vendors ( often bloated ) SDK's.
+email:
+- rubygems.org@kristoph.net
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- intelligence.gemspec
+- lib/intelligence.rb
+- lib/intelligence/adapter.rb
+- lib/intelligence/adapter/base.rb
+- lib/intelligence/adapter/construction_methods.rb
+- lib/intelligence/adapter_error.rb
+- lib/intelligence/adapters/anthropic.rb
+- lib/intelligence/adapters/anthropic/adapter.rb
+- lib/intelligence/adapters/anthropic/chat_methods.rb
+- lib/intelligence/adapters/cerebras.rb
+- lib/intelligence/adapters/generic.rb
+- lib/intelligence/adapters/generic/adapter.rb
+- lib/intelligence/adapters/generic/chat_methods.rb
+- lib/intelligence/adapters/google.rb
+- lib/intelligence/adapters/google/adapter.rb
+- lib/intelligence/adapters/google/chat_methods.rb
+- lib/intelligence/adapters/groq.rb
+- lib/intelligence/adapters/hyperbolic.rb
+- lib/intelligence/adapters/legacy/adapter.rb
+- lib/intelligence/adapters/legacy/chat_methods.rb
+- lib/intelligence/adapters/open_ai.rb
+- lib/intelligence/adapters/open_ai/adapter.rb
+- lib/intelligence/adapters/open_ai/chat_methods.rb
+- lib/intelligence/adapters/samba_nova.rb
+- lib/intelligence/adapters/together_ai.rb
+- lib/intelligence/chat_error_result.rb
+- lib/intelligence/chat_metrics.rb
+- lib/intelligence/chat_request.rb
+- lib/intelligence/chat_result.rb
+- lib/intelligence/chat_result_choice.rb
+- lib/intelligence/conversation.rb
+- lib/intelligence/error.rb
+- lib/intelligence/error_result.rb
+- lib/intelligence/invalid_content_error.rb
+- lib/intelligence/message.rb
+- lib/intelligence/message_content.rb
+- lib/intelligence/message_content/base.rb
+- lib/intelligence/message_content/binary.rb
+- lib/intelligence/message_content/text.rb
+- lib/intelligence/message_content/tool_call.rb
+- lib/intelligence/message_content/tool_result.rb
+- lib/intelligence/unsupported_content_error.rb
+- lib/intelligence/version.rb
+homepage: https://github.com/EndlessInternational/intelligence
+licenses:
+- MIT
+metadata:
+  source_code_uri: https://github.com/EndlessInternational/intelligence
+  bug_tracker_uri: https://github.com/EndlessInternational/intelligence/issues
+post_install_message:
+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.5.19
+signing_key:
+specification_version: 4
+summary: A Ruby gem for seamlessly and uniformly interacting with large languge and
+  vision model (LLM)  API's served by numerous services, including those of OpenAI,
+  Anthropic, Google and others.
+test_files: []