payloop 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 046f4c8d567e9eb4bf8f6797ef0a693f90a279f04de29d9d875030b264323788
-  data.tar.gz: 1fa3b863d95bf6568bb78b0df6819bde803449786ecad95c97c8dde57394689e
+  metadata.gz: 7783fa796b37bc909b7902b2477e59eeadb7b28460f4867cece51629b50e114f
+  data.tar.gz: 69871d85d4066f899cf697179ed3468b7adad4420319ee5c2c50f0a11314f8b3
 SHA512:
-  metadata.gz: 97cf236a7d99c0cef892e2f8c3d615d47bbba504073d5f64a67b11023859c5ed1ff6ddc67a43b3287ac85ffe37d31e633f1531078ac0ac6ff69f795c30921566
-  data.tar.gz: 205bb28b079d0459021cfb8cd6f1032df7ff7d1c351d9280c4bad530d1fdc73a8e07943d2fc6b36b60bfbcc23df66c1c1c607577e03f6f9fe2af7a7442225291
+  metadata.gz: afc394253b0c42ea0e4bf41dc9c7cfee11dad20dccffbd6689e9c5e3f19ccde79d2a1b1b807b8b07dab83562f8242286047efe6716de476882134be384d1610d
+  data.tar.gz: c98627c98fedec6e77e0b152614dcc1bce1adebe149344c344e10f99e8292607aa35e600da32cb29f9c74d77541de1474b79b5cfdfb519e129b0fdc6b8bd7aeb

data/CHANGELOG.md

@@ -40,4 +40,14 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Added
 - Support for Sentinel intercept.
-- Support for Gemini AI client tracking.
+- Support for Gemini AI client tracking.
+
+## [0.1.1] - 2026-02-11
+
+### Fixed
+- Stopped sending collector calls for intercepted requests
+
+## [0.2.0] - 2026-04-08
+
+### Added
+- Support for the RubyLLM library

data/README.md

@@ -34,7 +34,7 @@ To release a new version of the Payloop Ruby gem (e.g., version 0.0.2):
 
 1. **Update the version number** in [lib/payloop/version.rb](lib/payloop/version.rb):
    ```ruby
-   VERSION = "0.0.2"
+   VERSION = "0.2.0"
    ```
 
 2. **Update the CHANGELOG** in [CHANGELOG.md](CHANGELOG.md):

data/lib/payloop/client.rb

@@ -46,6 +46,12 @@ module Payloop
       @geminiai ||= Wrappers::GeminiAI.new(@config, @collector, @sentinel)
     end
 
+    # RubyLLM provider wrapper (ruby_llm gem)
+    # Supports any provider available via RubyLLM (Anthropic, OpenAI, Google, etc.)
+    def ruby_llm
+      @ruby_llm ||= Wrappers::RubyLLM.new(@config, @collector, @sentinel)
+    end
+
     # Set attribution for cost tracking
     def attribution(parent_id:, parent_name: nil, subsidiary_id: nil, subsidiary_name: nil)
       attr = Attribution.new(

data/lib/payloop/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Payloop
-  VERSION = "0.1.0"
+  VERSION = "0.2.0"
 end

data/lib/payloop/wrappers/anthropic.rb

@@ -81,6 +81,9 @@ module Payloop
           )
 
           response
+        rescue PayloopRequestInterceptedError => e
+          # We don't want to send intercepts to collector
+          raise e
         rescue StandardError => e
           params = kwargs.any? ? kwargs : (args.first || {})
 

data/lib/payloop/wrappers/constants.rb

@@ -6,5 +6,6 @@ module Payloop
     OPENAI_CLIENT_TITLE = "openai"
     ANTHROPIC_CLIENT_TITLE = "anthropic"
     GOOGLE_CLIENT_TITLE = "google"
+    RUBY_LLM_PROVIDER = "ruby_llm"
   end
 end

data/lib/payloop/wrappers/geminiai.rb

@@ -76,6 +76,9 @@ module Payloop
             )
 
             response
+          rescue PayloopRequestInterceptedError => e
+            # We don't want to send intercepts to collector
+            raise e
           rescue StandardError => e
             payloop_submit_error_analytics(
               method: :generate_content,
@@ -132,6 +135,9 @@ module Payloop
             )
 
             response
+          rescue PayloopRequestInterceptedError => e
+            # We don't want to send intercepts to collector
+            raise e
           rescue StandardError => e
             payloop_submit_error_analytics(
               method: :stream_generate_content,

data/lib/payloop/wrappers/google.rb

@@ -100,6 +100,9 @@ module Payloop
           )
 
           response
+        rescue PayloopRequestInterceptedError => e
+          # We don't want to send intercepts to collector
+          raise e
         rescue StandardError => e
           params = kwargs.any? ? kwargs : (args.first || {})
 

data/lib/payloop/wrappers/openai.rb

@@ -88,6 +88,9 @@ module Payloop
             )
 
             response
+          rescue PayloopRequestInterceptedError => e
+            # We don't want to send intercepts to collector
+            raise e
           rescue StandardError => e
             payloop_submit_error_analytics(
               method: :chat,

data/lib/payloop/wrappers/ruby_llm.rb

@@ -0,0 +1,156 @@
+# frozen_string_literal: true
+
+require_relative "constants"
+
+module Payloop
+  module Wrappers
+    # Wrapper for RubyLLM (ruby_llm gem)
+    # Supports any provider available via RubyLLM (Anthropic, OpenAI, Google, etc.)
+    # Returns raw response and raw formatted query to backend so that the existing
+    # extractors can be used.
+    class RubyLLM
+      def initialize(config, collector, sentinel = nil)
+        @config = config
+        @collector = collector
+        @sentinel = sentinel
+      end
+
+      def register(client)
+        validate_client!(client)
+
+        # Prevent double registration
+        return client if client.instance_variable_defined?(:@payloop_registered)
+
+        # Store references in the client instance
+        client.instance_variable_set(:@payloop_config, @config)
+        client.instance_variable_set(:@payloop_collector, @collector)
+        client.instance_variable_set(:@payloop_sentinel, @sentinel)
+        client.instance_variable_set(:@payloop_registered, true)
+
+        # Ask method handles both streaming and non-streaming cases unlike some others.
+        wrap_ask_method(client)
+
+        client
+      end
+
+      private
+
+      def validate_client!(client)
+        return if client.respond_to?(:ask)
+
+        raise RegistrationError,
+              "Client does not appear to be a valid RubyLLM client (missing ask method)"
+      end
+
+      def wrap_ask_method(client)
+        # Capture the wrapper instance in a local variable so it's accessible as a closure
+        # inside the block, where self will no longer refer to it.
+        wrapper = self
+
+        client.singleton_class.class_eval do
+          include Base
+
+          alias_method :original_ask, :ask
+
+          define_method(:ask) do |message, with: nil, &block|
+            start_time = Time.now
+            query = {} # Fallback for error analytics if an exception occurs before build_query completes
+
+            sentinel = instance_variable_get(:@payloop_sentinel)
+            provider = model.provider
+            title = provider == "gemini" ? GOOGLE_CLIENT_TITLE : provider
+
+            # Capture existing messages (e.g. system instruction) before the call
+            # adds the new user message to history.
+            existing_msgs = messages.map { |m| { role: m.role.to_s, content: m.content.to_s } }
+            all_msgs = existing_msgs + [{ role: "user", content: message.to_s }]
+
+            # Build a query in the provider's native format so the backend extractor can parse it.
+            query = wrapper.send(:build_query, provider, model.id, all_msgs, tools)
+
+            # Pass the actual provider title (e.g. "anthropic", "openai", "google") so the
+            # sentinel backend can route to the correct classifier for this request format.
+            sentinel&.raise_if_irrelevant!(title: title, request: query)
+
+            response = original_ask(message, with: with, &block)
+
+            payloop_submit_analytics(
+              method: :ask,
+              args: [],
+              kwargs: query,
+              response: response.raw&.body,
+              start_time: start_time,
+              end_time: Time.now,
+              title: title,
+              provider: RUBY_LLM_PROVIDER
+            )
+
+            response
+          rescue PayloopRequestInterceptedError => e
+            raise e
+          rescue StandardError => e
+            payloop_submit_error_analytics(
+              method: :ask,
+              args: [],
+              kwargs: query,
+              error: e,
+              start_time: start_time,
+              end_time: Time.now,
+              title: title,
+              provider: RUBY_LLM_PROVIDER
+            )
+            raise e
+          end
+        end
+      end
+
+      # Dispatches to the appropriate provider-native query builder.
+      def build_query(provider, model_id, messages, tools)
+        if provider == "gemini"
+          build_google_query(model_id, messages, tools)
+        else
+          # Anthropic and OpenAI have the same query format
+          build_messages_query(model_id, messages, tools)
+        end
+      end
+
+      # Builds an OpenAI-compatible query (used for Anthropic and OpenAI providers).
+      def build_messages_query(model_id, messages, tools)
+        query = { model: model_id, messages: messages }
+        unless tools.empty?
+          query[:tools] = tools.values.map do |t|
+            { name: t.name, description: t.description, parameters: t.params_schema }
+          end
+        end
+        query
+      end
+
+      # Builds a Google-native query with contents/systemInstruction structure.
+      def build_google_query(model_id, messages, tools)
+        system_msgs = messages.select { |m| m[:role] == "system" }
+        content_msgs = messages.reject { |m| m[:role] == "system" }
+
+        query = {
+          model: model_id,
+          contents: content_msgs.map do |m|
+            google_role = m[:role] == "assistant" ? "model" : m[:role]
+            { role: google_role, parts: [{ text: m[:content] }] }
+          end
+        }
+
+        if system_msgs.any?
+          system_text = system_msgs.map { |m| m[:content] }.join("\n")
+          query[:systemInstruction] = { parts: [{ text: system_text }] }
+        end
+
+        unless tools.empty?
+          query[:tools] = tools.values.map do |t|
+            { name: t.name, description: t.description, parameters: t.params_schema }
+          end
+        end
+
+        query
+      end
+    end
+  end
+end

data/lib/payloop.rb

@@ -11,6 +11,7 @@ require_relative "payloop/wrappers/openai"
 require_relative "payloop/wrappers/anthropic"
 require_relative "payloop/wrappers/google"
 require_relative "payloop/wrappers/geminiai"
+require_relative "payloop/wrappers/ruby_llm"
 require_relative "payloop/api/base"
 require_relative "payloop/api/sentinel"
 require_relative "payloop/api/workflows"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: payloop
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Payloop
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-02-03 00:00:00.000000000 Z
+date: 2026-04-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: concurrent-ruby
@@ -53,6 +53,7 @@ files:
 - lib/payloop/wrappers/geminiai.rb
 - lib/payloop/wrappers/google.rb
 - lib/payloop/wrappers/openai.rb
+- lib/payloop/wrappers/ruby_llm.rb
 homepage: https://trypayloop.com
 licenses:
 - MIT