llm.rb 4.0.0 → 4.2.0

data/lib/llm.rb

@@ -3,10 +3,11 @@
 module LLM
   require "stringio"
   require_relative "llm/json_adapter"
+  require_relative "llm/tracer"
   require_relative "llm/error"
   require_relative "llm/contract"
   require_relative "llm/usage"
-  require_relative "llm/builder"
+  require_relative "llm/prompt"
   require_relative "llm/schema"
   require_relative "llm/object"
   require_relative "llm/version"
@@ -17,7 +18,8 @@ module LLM
   require_relative "llm/multipart"
   require_relative "llm/file"
   require_relative "llm/provider"
-  require_relative "llm/bot"
+  require_relative "llm/session"
+  require_relative "llm/agent"
   require_relative "llm/buffer"
   require_relative "llm/function"
   require_relative "llm/eventstream"
@@ -34,7 +36,7 @@ module LLM
   ##
   # Returns the JSON adapter used by the library
   # @return [Class]
-  #  Returns a class that responds to +dump+ and +load+
+  #  Returns a class that responds to `dump` and `load`
   def json
     @json ||= JSONAdapter::JSON
   end

data/llm.gemspec

@@ -21,7 +21,8 @@ Gem::Specification.new do |spec|
   spec.required_ruby_version = ">= 3.2.0"
 
   spec.metadata["homepage_uri"] = spec.homepage
-  spec.metadata["source_code_uri"] = "https://github.com/llmrb/llm"
+  spec.metadata["source_code_uri"] = "https://github.com/llmrb/llm.rb"
+  spec.metadata["documentation_uri"] = "https://0x1eef.github.io/x/llm.rb"
 
   spec.files = Dir[
     "README.md", "LICENSE",
@@ -41,4 +42,6 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency "vcr", "~> 6.0"
   spec.add_development_dependency "dotenv", "~> 2.8"
   spec.add_development_dependency "net-http-persistent", "~> 4.0"
+  spec.add_development_dependency "opentelemetry-sdk", "~> 1.10"
+  spec.add_development_dependency "logger", "~> 1.7"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: llm.rb
 version: !ruby/object:Gem::Version
-  version: 4.0.0
+  version: 4.2.0
 platform: ruby
 authors:
 - Antar Azri
@@ -164,6 +164,34 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '4.0'
+- !ruby/object:Gem::Dependency
+  name: opentelemetry-sdk
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.10'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.10'
+- !ruby/object:Gem::Dependency
+  name: logger
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
 description: llm.rb is a zero-dependency Ruby toolkit for Large Language Models that
   includes OpenAI, Gemini, Anthropic, xAI (grok), zAI, DeepSeek, Ollama, and LlamaCpp.
   The toolkit includes full support for chat, streaming, tool calling, audio, images,
@@ -178,9 +206,9 @@ files:
 - LICENSE
 - README.md
 - lib/llm.rb
+- lib/llm/agent.rb
 - lib/llm/bot.rb
 - lib/llm/buffer.rb
-- lib/llm/builder.rb
 - lib/llm/client.rb
 - lib/llm/contract.rb
 - lib/llm/contract/completion.rb
@@ -191,6 +219,7 @@ files:
 - lib/llm/eventstream/parser.rb
 - lib/llm/file.rb
 - lib/llm/function.rb
+- lib/llm/function/tracing.rb
 - lib/llm/json_adapter.rb
 - lib/llm/message.rb
 - lib/llm/mime.rb
@@ -199,6 +228,7 @@ files:
 - lib/llm/object.rb
 - lib/llm/object/builder.rb
 - lib/llm/object/kernel.rb
+- lib/llm/prompt.rb
 - lib/llm/provider.rb
 - lib/llm/providers/anthropic.rb
 - lib/llm/providers/anthropic/error_handler.rb
@@ -282,8 +312,13 @@ files:
 - lib/llm/schema/string.rb
 - lib/llm/schema/version.rb
 - lib/llm/server_tool.rb
+- lib/llm/session.rb
 - lib/llm/tool.rb
 - lib/llm/tool/param.rb
+- lib/llm/tracer.rb
+- lib/llm/tracer/logger.rb
+- lib/llm/tracer/null.rb
+- lib/llm/tracer/telemetry.rb
 - lib/llm/usage.rb
 - lib/llm/utils.rb
 - lib/llm/version.rb
@@ -293,7 +328,8 @@ licenses:
 - 0BSD
 metadata:
   homepage_uri: https://github.com/llmrb/llm
-  source_code_uri: https://github.com/llmrb/llm
+  source_code_uri: https://github.com/llmrb/llm.rb
+  documentation_uri: https://0x1eef.github.io/x/llm.rb
 rdoc_options: []
 require_paths:
 - lib

data/lib/llm/builder.rb

@@ -1,61 +0,0 @@
-# frozen_string_literal: true
-
-##
-# The {LLM::Builder LLM::Builder} class can build a collection
-# of messages that can be sent in a single request.
-#
-# @example
-#   llm = LLM.openai(key: ENV["KEY"])
-#   bot = LLM::Bot.new(llm)
-#   prompt = bot.build_prompt do
-#     it.system "Your task is to assist the user"
-#     it.user "Hello. Can you assist me?"
-#   end
-#   res = bot.chat(prompt)
-class LLM::Builder
-  ##
-  # @param [Proc] evaluator
-  #  The evaluator
-  def initialize(&evaluator)
-    @buffer = []
-    @evaluator = evaluator
-  end
-
-  ##
-  # @return [void]
-  def call
-    @evaluator.call(self)
-  end
-
-  ##
-  # @param [String] content
-  #  The message
-  # @param [Symbol] role
-  #  The role (eg user, system)
-  # @return [void]
-  def chat(content, role: :user)
-    @buffer << LLM::Message.new(role, content)
-  end
-
-  ##
-  # @param [String] content
-  #  The message content
-  # @return [void]
-  def user(content)
-    chat(content, role: :user)
-  end
-
-  ##
-  # @param [String] content
-  #  The message content
-  # @return [void]
-  def system(content)
-    chat(content, role: :system)
-  end
-
-  ##
-  # @return [Array]
-  def to_a
-    @buffer.dup
-  end
-end