llm.rb 11.1.0 → 11.2.0

data/lib/llm/transport.rb

@@ -9,10 +9,10 @@ module LLM
   # execute provider requests without changing request adapters or
   # response adapters.
   #
-  # Providers currently construct {Net::HTTPRequest Net::HTTPRequest}
-  # objects before delegating to a transport. Custom transports are
-  # therefore expected to execute those requests directly, or transform
-  # them into backend-specific request objects before execution.
+  # Providers should construct {LLM::Transport::Request} objects before
+  # delegating to a transport. Custom transports can execute those
+  # requests directly, or transform them into backend-specific request
+  # objects before execution.
   #
   # Only {#request} is required. The remaining methods are optional hooks
   # for features such as interruption, request ownership, or persistence,
@@ -26,11 +26,14 @@ module LLM
   # can rely on one normalized response contract instead of
   # transport-specific classes.
   class Transport
+    require_relative "transport/request"
     require_relative "transport/response"
     require_relative "transport/utils"
     require_relative "transport/stream_decoder"
+    require_relative "transport/net_http_adapter"
     require_relative "transport/http"
     require_relative "transport/persistent_http"
+    require_relative "transport/curb"
     require_relative "transport/execution"
 
     ##
@@ -47,9 +50,17 @@ module LLM
       PersistentHTTP
     end
 
+    ##
+    # Returns the optional libcurl (curb) transport class.
+    # Requires the `curb` gem.
+    # @return [Class]
+    def self.curb
+      Curb
+    end
+
     ##
     # Performs a request through the transport.
-    # @param [Net::HTTPRequest] request
+    # @param [LLM::Transport::Request] request
     # @param [Object] owner
     # @param [LLM::Object, nil] stream
     # @yieldparam [LLM::Transport::Response] response
@@ -90,51 +101,12 @@ module LLM
     end
 
     ##
-    # @note
-    #  Custom transports may be able to reuse this helper when they
-    #  operate on Net::HTTPRequest objects, or implement their own
-    #  request body preparation path instead.
-    # @param [Net::HTTPRequest] request
+    # @param [LLM::Transport::Request] request
     # @param [IO] io
     # @return [void]
     def set_body_stream(request, io)
       request.body_stream = io
       request["transfer-encoding"] = "chunked" unless request["content-length"]
     end
-
-    private
-
-    ##
-    # @api private
-    # @note
-    #  Custom transports may be able to reuse this helper when they
-    #  execute requests through a Net::HTTP-compatible client, or
-    #  implement their own request execution path instead.
-    def perform_request(client, request, stream, &b)
-      if stream
-        client.request(request) do |raw|
-          res = LLM::Transport::Response.from(raw)
-          if res.success?
-            parser = stream.decoder.new(stream.parser.new(stream.streamer))
-            res.read_body(parser)
-            body = parser.body
-            res.body = (Hash === body || Array === body) ? LLM::Object.from(body) : body
-          else
-            body = +""
-            res.read_body { body << _1 }
-            res.body = body
-          end
-        ensure
-          parser&.free
-        end
-      elsif b
-        client.request(request) do |raw|
-          res = LLM::Transport::Response.from(raw)
-          res.success? ? b.call(res) : res
-        end
-      else
-        LLM::Transport::Response.from(client.request(request))
-      end
-    end
   end
 end

data/lib/llm/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module LLM
-  VERSION = "11.1.0"
+  VERSION = "11.2.0"
 end

data/llm.gemspec

@@ -28,10 +28,10 @@ Gem::Specification.new do |spec|
   spec.license = "0BSD"
   spec.required_ruby_version = ">= 3.3.0"
 
-  spec.homepage = "https://github.com/llmrb/llm.rb"
-  spec.metadata["homepage_uri"] = "https://github.com/llmrb/llm.rb"
+  spec.homepage = "https://llmrb.github.io"
+  spec.metadata["homepage_uri"] = spec.homepage
   spec.metadata["source_code_uri"] = "https://github.com/llmrb/llm.rb"
-  spec.metadata["documentation_uri"] = "https://0x1eef.github.io/x/llm.rb"
+  spec.metadata["documentation_uri"] = "https://llmrb.github.io/llm.rb"
   spec.metadata["changelog_uri"] = "https://0x1eef.github.io/x/llm.rb/file.CHANGELOG.html"
 
   spec.files = Dir[

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: llm.rb
 version: !ruby/object:Gem::Version
-  version: 11.1.0
+  version: 11.2.0
 platform: ruby
 authors:
 - Antar Azri
@@ -482,10 +482,14 @@ files:
 - lib/llm/tracer/null.rb
 - lib/llm/tracer/telemetry.rb
 - lib/llm/transport.rb
+- lib/llm/transport/curb.rb
 - lib/llm/transport/execution.rb
 - lib/llm/transport/http.rb
+- lib/llm/transport/net_http_adapter.rb
 - lib/llm/transport/persistent_http.rb
+- lib/llm/transport/request.rb
 - lib/llm/transport/response.rb
+- lib/llm/transport/response/curb.rb
 - lib/llm/transport/response/http.rb
 - lib/llm/transport/stream_decoder.rb
 - lib/llm/transport/utils.rb
@@ -495,13 +499,13 @@ files:
 - lib/sequel/plugins/agent.rb
 - lib/sequel/plugins/llm.rb
 - llm.gemspec
-homepage: https://github.com/llmrb/llm.rb
+homepage: https://llmrb.github.io
 licenses:
 - 0BSD
 metadata:
-  homepage_uri: https://github.com/llmrb/llm.rb
+  homepage_uri: https://llmrb.github.io
   source_code_uri: https://github.com/llmrb/llm.rb
-  documentation_uri: https://0x1eef.github.io/x/llm.rb
+  documentation_uri: https://llmrb.github.io/llm.rb
   changelog_uri: https://0x1eef.github.io/x/llm.rb/file.CHANGELOG.html
 rdoc_options: []
 require_paths: