llm.rb 9.0.0 → 11.0.0

data/lib/llm/transport/utils.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+class LLM::Transport
+  ##
+  # Shared utility methods for HTTP-backed transports.
+  #
+  # @api private
+  module Utils
+    extend self
+    private
+
+    def resolve_transport(uri, transport, timeout)
+      return default_transport(uri, timeout) if transport.nil?
+      if Class === transport && transport <= LLM::Transport
+        transport.new(
+          host: uri.host,
+          port: uri.port,
+          timeout:,
+          ssl: uri.scheme == "https"
+        )
+      else
+        transport
+      end
+    end
+
+    def default_transport(uri, timeout)
+      LLM::Transport::HTTP.new(
+        host: uri.host,
+        port: uri.port,
+        timeout:,
+        ssl: uri.scheme == "https"
+      )
+    end
+  end
+end

data/lib/llm/transport.rb

@@ -27,6 +27,7 @@ module LLM
   # transport-specific classes.
   class Transport
     require_relative "transport/response"
+    require_relative "transport/utils"
     require_relative "transport/stream_decoder"
     require_relative "transport/http"
     require_relative "transport/persistent_http"

data/lib/llm/utils.rb

@@ -0,0 +1,73 @@
+# frozen_string_literal: true
+
+module LLM
+  ##
+  # Shared utility methods used across the runtime.
+  module Utils
+    extend self
+
+    ##
+    # Resolves a configured option against an object instance.
+    #
+    # Proc values are evaluated with `instance_exec`, symbol values are
+    # optionally sent to the object as method calls, hashes are duplicated,
+    # and all other values are returned as-is.
+    #
+    # @param [Object] obj
+    # @param [Object] option
+    # @param [Boolean] resolve_symbol
+    # @return [Object]
+    def resolve_option(obj, option, resolve_symbol: true)
+      case option
+      when Proc then obj.instance_exec(&option)
+      when Symbol then resolve_symbol ? obj.send(option) : option
+      when Hash then option.dup
+      else option
+      end
+    end
+
+    ##
+    # Normalizes an HTTP API base path.
+    #
+    # Blank paths normalize to an empty string. Non-empty paths are
+    # prefixed with a leading slash and stripped of trailing slashes.
+    #
+    # @param [String, nil] path
+    # @return [String]
+    def normalize_base_path(path)
+      path = path.to_s.strip
+      return "" if path.empty? || path == "/"
+      path = "/#{path}" unless path.start_with?("/")
+      path.sub(%r{/+\z}, "")
+    end
+
+    ##
+    # Returns the Ruby module or class name for an object.
+    #
+    # This bypasses overridden `#name` implementations by binding
+    # {Module#name} directly.
+    #
+    # @param [Module] obj
+    # @return [String, nil]
+    def name_of(obj)
+      ::Module.instance_method(:name).bind(obj).call
+    end
+
+    ##
+    # Renders the class-and-object-id portion of an inspect string.
+    #
+    # This returns strings like `LLM::Tool:0x1234abcd`, which can be
+    # embedded into custom inspect output.
+    #
+    # @param [Object] obj
+    # @return [String]
+    def object_id(obj)
+      klass = if Class === obj
+        name_of(obj) || name_of(obj.superclass) || obj.class.name
+      else
+        obj.class.name || obj.class.to_s
+      end
+      "#{klass}:0x#{obj.object_id.to_s(16)}"
+    end
+  end
+end

data/lib/llm/version.rb

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

data/lib/llm.rb

@@ -2,6 +2,7 @@
 
 module LLM
   require "stringio"
+  require "securerandom"
   require_relative "llm/json_adapter"
   require_relative "llm/tracer"
   require_relative "llm/error"
@@ -12,6 +13,7 @@ module LLM
   require_relative "llm/prompt"
   require_relative "llm/schema"
   require_relative "llm/object"
+  require_relative "llm/utils"
   require_relative "llm/model"
   require_relative "llm/version"
   require_relative "llm/message"
@@ -34,6 +36,7 @@ module LLM
   require_relative "llm/skill"
   require_relative "llm/server_tool"
   require_relative "llm/mcp"
+  require_relative "llm/a2a"
 
   ##
   # Thread-safe monitors for different contexts
@@ -178,8 +181,6 @@ module LLM
   end
 
   ##
-  # @param [LLM::Provider, nil] llm
-  #  The provider to use for MCP transports that need one
   # @param [Hash, nil] stdio
   # @option stdio [Array<String>] :argv
   #  The command to run for the MCP process
@@ -188,8 +189,27 @@ module LLM
   # @option stdio [String, nil] :cwd
   #  The working directory for the MCP process
   # @return [LLM::MCP]
-  def mcp(llm = nil, **)
-    LLM::MCP.new(llm, **)
+  def mcp(**)
+    LLM::MCP.new(**)
+  end
+
+  ##
+  # Creates a new A2A client connected to a remote agent.
+  #
+  # @param [Hash, nil] http
+  # @option http [String] :url
+  #  The base URL of the A2A agent (e.g., "https://agent.example.com")
+  # @option http [Hash<String, String>] :headers
+  #  Extra HTTP headers (e.g., Authorization)
+  # @option http [Integer, nil] :timeout
+  #  Request timeout in seconds
+  # @option http [LLM::Transport, Class, nil] :transport
+  #  Optional transport override
+  # @param [Symbol] binding
+  #  The protocol binding to use. One of `:rest` or `:jsonrpc`
+  # @return [LLM::A2A]
+  def a2a(http:, binding: :rest)
+    LLM::A2A.http(**http, binding:)
   end
 
   ##

data/llm.gemspec

@@ -9,7 +9,22 @@ Gem::Specification.new do |spec|
   spec.email = ["azantar@proton.me", "0x1eef@hardenedbsd.org"]
 
   spec.summary = "Ruby's most capable AI runtime"
-  spec.description = spec.summary
+  spec.description = <<~DESC
+  llm.rb is Ruby's most capable AI runtime.
+
+  It runs on Ruby's standard library by default. loads optional pieces
+  only when needed, and offers a single runtime for providers, agents,
+  tools, skills, MCP, A2A (Agent2Agent), RAG (vector stores & embeddings),
+  streaming, files, and persisted state. As a bonus, llm.rb is also available
+  for mruby.
+
+  It supports OpenAI, OpenAI-compatible endpoints, Anthropic, Google
+  Gemini, DeepSeek, xAI, Z.ai, AWS Bedrock, Ollama, and llama.cpp. It
+  also includes built-in ActiveRecord and Sequel support, plus concurrent
+  tool execution through threads, tasks (via async gem), fibers, ractors,
+  and fork (via xchan.rb gem).
+  DESC
+
   spec.license = "0BSD"
   spec.required_ruby_version = ">= 3.3.0"
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: llm.rb
 version: !ruby/object:Gem::Version
-  version: 9.0.0
+  version: 11.0.0
 platform: ruby
 authors:
 - Antar Azri
@@ -264,7 +264,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.5'
-description: Ruby's most capable AI runtime
+description: |
+  llm.rb is Ruby's most capable AI runtime.
+
+  It runs on Ruby's standard library by default. loads optional pieces
+  only when needed, and offers a single runtime for providers, agents,
+  tools, skills, MCP, A2A (Agent2Agent), RAG (vector stores & embeddings),
+  streaming, files, and persisted state. As a bonus, llm.rb is also available
+  for mruby.
+
+  It supports OpenAI, OpenAI-compatible endpoints, Anthropic, Google
+  Gemini, DeepSeek, xAI, Z.ai, AWS Bedrock, Ollama, and llama.cpp. It
+  also includes built-in ActiveRecord and Sequel support, plus concurrent
+  tool execution through threads, tasks (via async gem), fibers, ractors,
+  and fork (via xchan.rb gem).
 email:
 - azantar@proton.me
 - 0x1eef@hardenedbsd.org
@@ -283,11 +296,20 @@ files:
 - data/xai.json
 - data/zai.json
 - lib/llm.rb
+- lib/llm/a2a.rb
+- lib/llm/a2a/card.rb
+- lib/llm/a2a/card/capabilities.rb
+- lib/llm/a2a/card/interface.rb
+- lib/llm/a2a/card/provider.rb
+- lib/llm/a2a/card/skill.rb
+- lib/llm/a2a/error.rb
+- lib/llm/a2a/notifications.rb
+- lib/llm/a2a/tasks.rb
+- lib/llm/a2a/transport/http.rb
 - lib/llm/active_record.rb
 - lib/llm/active_record/acts_as_agent.rb
 - lib/llm/active_record/acts_as_llm.rb
 - lib/llm/agent.rb
-- lib/llm/bot.rb
 - lib/llm/buffer.rb
 - lib/llm/compactor.rb
 - lib/llm/context.rb
@@ -305,6 +327,7 @@ files:
 - lib/llm/function.rb
 - lib/llm/function/array.rb
 - lib/llm/function/call_group.rb
+- lib/llm/function/call_task.rb
 - lib/llm/function/fiber_group.rb
 - lib/llm/function/fork.rb
 - lib/llm/function/fork/job.rb
@@ -329,7 +352,6 @@ files:
 - lib/llm/mcp/router.rb
 - lib/llm/mcp/rpc.rb
 - lib/llm/mcp/transport/http.rb
-- lib/llm/mcp/transport/http/event_handler.rb
 - lib/llm/mcp/transport/stdio.rb
 - lib/llm/message.rb
 - lib/llm/mime.rb
@@ -466,7 +488,9 @@ files:
 - lib/llm/transport/response.rb
 - lib/llm/transport/response/http.rb
 - lib/llm/transport/stream_decoder.rb
+- lib/llm/transport/utils.rb
 - lib/llm/usage.rb
+- lib/llm/utils.rb
 - lib/llm/version.rb
 - lib/sequel/plugins/agent.rb
 - lib/sequel/plugins/llm.rb
@@ -493,7 +517,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.3
+rubygems_version: 4.0.6
 specification_version: 4
 summary: Ruby's most capable AI runtime
 test_files: []

data/lib/llm/bot.rb

@@ -1,3 +0,0 @@
-# frozen_string_literal: true
-
-require_relative "context"

data/lib/llm/mcp/transport/http/event_handler.rb

@@ -1,68 +0,0 @@
-# frozen_string_literal: true
-
-module LLM::MCP::Transport
-  ##
-  # The {LLM::MCP::Transport::HTTP::EventHandler LLM::MCP::Transport::HTTP::EventHandler}
-  # class adapts generic server-sent event callbacks into decoded JSON-RPC
-  # messages for {LLM::MCP::Transport::HTTP LLM::MCP::Transport::HTTP}.
-  # It accumulates event data until a blank line terminates the current
-  # event, then parses the payload as JSON and yields it to the callback
-  # given at initialization.
-  # @private
-  class HTTP::EventHandler
-    ##
-    # @yieldparam [Hash] message
-    #  A decoded JSON-RPC message
-    # @return [LLM::MCP::Transport::HTTP::EventHandler]
-    def initialize(&on_message)
-      @on_message = on_message
-      reset
-    end
-
-    ##
-    # Receives the SSE event name.
-    # @param [LLM::EventStream::Event, String, nil] event
-    # @param [String, nil] chunk
-    #  The event stream event
-    # @return [void]
-    def on_event(event, chunk = nil)
-      @event = chunk ? event : event.value
-    end
-
-    ##
-    # Receives one line of SSE data.
-    # @param [LLM::EventStream::Event, String, nil] event
-    # @param [String, nil] chunk
-    #  The event stream event
-    # @return [void]
-    def on_data(event, chunk = nil)
-      @data << (chunk ? event : event.value).to_s
-    end
-
-    # The generic event stream parser dispatches one line at a time.
-    # A blank line terminates the current SSE event.
-    # @param [LLM::EventStream::Event, String] event
-    #  The event stream event
-    # @return [void]
-    def on_chunk(event, chunk = nil)
-      flush if (chunk || event&.chunk || event) == "\n"
-    end
-
-    private
-
-    def flush
-      return reset if @data.empty? && @event.nil?
-      payload = @data.join("\n")
-      reset
-      return if payload.empty? || payload == "[DONE]"
-      @on_message.call(LLM.json.load(payload))
-    rescue *LLM.json.parser_error
-      reset
-    end
-
-    def reset
-      @event = nil
-      @data = []
-    end
-  end
-end