payloop 0.2.0 → 0.4.0

data/sig/payloop/client.rbs

@@ -0,0 +1,29 @@
+# Starter signatures generated by typeprof + hand-refined; see CLAUDE.md
+# "Code style: type signatures (RBS)" for the refinement convention.
+module Payloop
+  class Client
+    @openai: Payloop::Wrappers::OpenAI
+    @anthropic: Payloop::Wrappers::Anthropic
+    @google: Payloop::Wrappers::Google
+    @geminiai: Payloop::Wrappers::GeminiAI
+    @ruby_llm: Payloop::Wrappers::RubyLLM
+    @groq: Payloop::Wrappers::Groq
+    @workflows: Payloop::API::Workflows
+
+    attr_reader config: Payloop::Config
+    attr_reader collector: Payloop::Collector
+    attr_reader sentinel: Payloop::Sentinel
+
+    def initialize: (?api_key: String?, ?collector_url: String?, ?api_url: String?, ?timeout: Numeric?) -> void
+    def openai: -> Payloop::Wrappers::OpenAI
+    def anthropic: -> Payloop::Wrappers::Anthropic
+    def google: -> Payloop::Wrappers::Google
+    def geminiai: -> Payloop::Wrappers::GeminiAI
+    def ruby_llm: -> Payloop::Wrappers::RubyLLM
+    def groq: -> Payloop::Wrappers::Groq
+    def attribution: (parent_id: String, ?parent_name: String?, ?subsidiary_id: String?, ?subsidiary_name: String?) -> self
+    def new_transaction: -> self
+    def workflows: -> Payloop::API::Workflows
+    def shutdown: -> void
+  end
+end

data/sig/payloop/collector.rbs

@@ -0,0 +1,20 @@
+# Starter signatures generated by typeprof + hand-refined; see CLAUDE.md
+# "Code style: type signatures (RBS)" for the refinement convention.
+module Payloop
+  class Collector
+    DEFAULT_MAX_RETRIES: Integer
+    RETRY_DELAY: Integer
+    @config: Payloop::Config
+    # Concurrent::ThreadPoolExecutor — no upstream signatures available.
+    @executor: untyped
+
+    def initialize: (Payloop::Config config) -> void
+    def submit_async: (Hash[Symbol, untyped] payload) -> void
+    def submit: (Hash[Symbol, untyped] payload) -> untyped
+    def shutdown: -> void
+
+    private
+    def submit_with_retry: (Hash[Symbol, untyped] payload, ?Integer attempt) -> untyped
+    def post_to_collector: (Hash[Symbol, untyped] payload) -> untyped
+  end
+end

data/sig/payloop/config.rbs

@@ -0,0 +1,33 @@
+# Starter signatures generated by typeprof + hand-refined; see CLAUDE.md
+# "Code style: type signatures (RBS)" for the refinement convention.
+module Payloop
+  class Config
+    # Concurrent::AtomicReference[T] — no `concurrent-ruby` signatures for
+    # that class are shipped in the public rbs_collection, so falls back to
+    # `untyped`. Refine once we add a hand-rolled stub or upstream sig.
+    @attribution: untyped
+    @tx_uuid: untyped
+    @raise_if_irrelevant: untyped
+    @secs_irrelevant_request_timeout: untyped
+
+    attr_reader api_key: String
+    attr_reader collector_url: String
+    attr_reader api_url: String
+    attr_reader timeout: Numeric
+    attr_reader version: String
+
+    def initialize: (?api_key: String?, ?collector_url: String?, ?api_url: String?, ?timeout: Numeric?) -> void
+    def attribution: -> Payloop::Attribution?
+    def attribution=: (Payloop::Attribution? value) -> void
+    def tx_uuid: -> String
+    def tx_uuid=: (String value) -> void
+    def raise_if_irrelevant: -> bool
+    def raise_if_irrelevant=: (bool value) -> void
+    def secs_irrelevant_request_timeout: -> Numeric
+    def secs_irrelevant_request_timeout=: (Numeric value) -> void
+    def new_transaction: -> String
+
+    private
+    def nonempty_env: (String name) -> String?
+  end
+end

data/sig/payloop/errors.rbs

@@ -0,0 +1,28 @@
+# Starter signatures generated by typeprof + hand-refined; see CLAUDE.md
+# "Code style: type signatures (RBS)" for the refinement convention.
+module Payloop
+  class Error < StandardError
+  end
+
+  class MissingAPIKeyError < Error
+    def initialize: (?String msg) -> void
+  end
+
+  class ValidationError < Error
+  end
+
+  class RegistrationError < Error
+  end
+
+  class APIError < Error
+    attr_reader status_code: Integer?
+    attr_reader response_body: String?
+    def initialize: (String message, ?status_code: Integer?, ?response_body: String?) -> void
+  end
+
+  class PayloopRequestInterceptedError < Error
+  end
+
+  class StreamError < Error
+  end
+end

data/sig/payloop/sentinel.rbs

@@ -0,0 +1,17 @@
+# Starter signatures generated by typeprof + hand-refined; see CLAUDE.md
+# "Code style: type signatures (RBS)" for the refinement convention.
+module Payloop
+  class Sentinel
+    @config: Payloop::Config
+
+    def initialize: (Payloop::Config config) -> void
+    def raise_if_irrelevant: (?enabled: bool) -> self
+    def set_secs_irrelevant_request_timeout: (Numeric timeout) -> self
+    def raise_if_irrelevant!: (title: String?, request: Hash[Symbol, untyped], ?provider: String?, ?version: String?) -> void
+
+    private
+    def make_relevance_intercept_request: (title: String?, request: Hash[Symbol, untyped], ?provider: String?, ?version: String?) -> [bool, String?]
+    def normalize_request: (Hash[Symbol, untyped] request) -> untyped
+    def remove_procs: (untyped obj) -> untyped
+  end
+end

data/sig/payloop/version.rbs

@@ -0,0 +1,5 @@
+# Starter signatures generated by typeprof + hand-refined; see CLAUDE.md
+# "Code style: type signatures (RBS)" for the refinement convention.
+module Payloop
+  VERSION: String
+end

data/sig/payloop/wrappers/anthropic.rbs

@@ -0,0 +1,18 @@
+# Starter signatures generated by typeprof + hand-refined; see CLAUDE.md
+# "Code style: type signatures (RBS)" for the refinement convention.
+module Payloop
+  module Wrappers
+    class Anthropic
+      @config: Payloop::Config
+      @collector: Payloop::Collector
+      @sentinel: Payloop::Sentinel?
+
+      def initialize: (Payloop::Config config, Payloop::Collector collector, ?Payloop::Sentinel? sentinel) -> void
+      def register: (untyped client) -> untyped
+
+      private
+      def validate_client!: (untyped client) -> void
+      def wrap_messages_method: (untyped client) -> void
+    end
+  end
+end

data/sig/payloop/wrappers/base.rbs

@@ -0,0 +1,21 @@
+# Starter signatures generated by typeprof + hand-refined; see CLAUDE.md
+# "Code style: type signatures (RBS)" for the refinement convention.
+module Payloop
+  module Wrappers
+    module Base
+      def payloop_wrap_method: (Symbol method_name, String _provider_name) -> void
+      def payloop_submit_analytics: (method: Symbol, args: Array[untyped], kwargs: Hash[Symbol, untyped], response: untyped, start_time: Time, end_time: Time, ?provider: String?, ?title: String?, ?version: String?, ?status: String, ?exception: String?) -> void
+      def payloop_submit_error_analytics: (method: Symbol, args: Array[untyped], kwargs: Hash[Symbol, untyped], error: StandardError, start_time: Time, end_time: Time, ?provider: String?, ?title: String?, ?version: String?, ?response: untyped) -> void
+      def payloop_merge_streaming_chunk: (Hash[String | Symbol, untyped] accumulated, Hash[String | Symbol, untyped] chunk) -> Hash[String | Symbol, untyped]
+      def payloop_normalize_openai_chunk: (untyped chunk) -> untyped
+
+      private
+      def extract_query: (Symbol _method, Array[untyped] _args, Hash[Symbol, untyped] kwargs) -> Hash[Symbol, untyped]
+      def extract_response: (untyped response) -> untyped
+      def extract_instance_variables: (untyped obj) -> Hash[Symbol, untyped]
+      def serialize_value: (untyped value) -> untyped
+      def deep_copy: (untyped obj) -> untyped
+      def build_payload: (query: Hash[Symbol, untyped], response: untyped, start_time: Time, end_time: Time, config: Payloop::Config, status: String, ?provider: String?, ?title: String?, ?version: String?, ?exception: String?) -> Hash[Symbol, untyped]
+    end
+  end
+end

data/sig/payloop/wrappers/constants.rbs

@@ -0,0 +1,10 @@
+# Classes
+module Payloop
+  module Wrappers
+    OPENAI_CLIENT_TITLE: String
+    ANTHROPIC_CLIENT_TITLE: String
+    GOOGLE_CLIENT_TITLE: String
+    RUBY_LLM_PROVIDER: String
+    GROQ_PROVIDER: String
+  end
+end

data/sig/payloop/wrappers/geminiai.rbs

@@ -0,0 +1,19 @@
+# Starter signatures generated by typeprof + hand-refined; see CLAUDE.md
+# "Code style: type signatures (RBS)" for the refinement convention.
+module Payloop
+  module Wrappers
+    class GeminiAI
+      @config: Payloop::Config
+      @collector: Payloop::Collector
+      @sentinel: Payloop::Sentinel?
+
+      def initialize: (Payloop::Config config, Payloop::Collector collector, ?Payloop::Sentinel? sentinel) -> void
+      def register: (untyped client) -> untyped
+
+      private
+      def validate_client!: (untyped client) -> void
+      def wrap_generate_content_method: (untyped client) -> void
+      def wrap_stream_generate_content_method: (untyped client) -> void
+    end
+  end
+end

data/sig/payloop/wrappers/google.rbs

@@ -0,0 +1,19 @@
+# Starter signatures generated by typeprof + hand-refined; see CLAUDE.md
+# "Code style: type signatures (RBS)" for the refinement convention.
+module Payloop
+  module Wrappers
+    class Google
+      @config: Payloop::Config
+      @collector: Payloop::Collector
+      @sentinel: Payloop::Sentinel?
+
+      def initialize: (Payloop::Config config, Payloop::Collector collector, ?Payloop::Sentinel? sentinel) -> void
+      def register: (untyped client) -> untyped
+
+      private
+      def validate_client!: (untyped client) -> void
+      def patch_response_class!: -> void
+      def wrap_generate_content_method: (untyped client) -> void
+    end
+  end
+end

data/sig/payloop/wrappers/groq.rbs

@@ -0,0 +1,22 @@
+# Starter signatures generated by typeprof + hand-refined; see CLAUDE.md
+# "Code style: type signatures (RBS)" for the refinement convention.
+module Payloop
+  module Wrappers
+    class Groq
+      CHAT_COMPLETIONS_PATH: String
+      @config: Payloop::Config
+      @collector: Payloop::Collector
+      @sentinel: Payloop::Sentinel?
+
+      def initialize: (Payloop::Config config, Payloop::Collector collector, ?Payloop::Sentinel? sentinel) -> void
+      def register: (untyped client) -> untyped
+      def self.extract_model_title: (untyped model, String fallback) -> String
+      def self.build_error_response: (streaming: bool, accumulated: Hash[untyped, untyped]?, error: Exception) -> Hash[untyped, untyped]
+
+      private
+      def validate_client!: (untyped client) -> void
+      def patch_stream_handler!: () -> void
+      def wrap_post_method: (untyped client) -> void
+    end
+  end
+end

data/sig/payloop/wrappers/openai.rbs

@@ -0,0 +1,19 @@
+# Starter signatures generated by typeprof + hand-refined; see CLAUDE.md
+# "Code style: type signatures (RBS)" for the refinement convention.
+module Payloop
+  module Wrappers
+    class OpenAI
+      @config: Payloop::Config
+      @collector: Payloop::Collector
+      @sentinel: Payloop::Sentinel?
+
+      def initialize: (Payloop::Config config, Payloop::Collector collector, ?Payloop::Sentinel? sentinel) -> void
+      def register: (untyped client) -> untyped
+
+      private
+      def wrap_responses_method: (untyped client) -> void
+      def validate_client!: (untyped client) -> void
+      def wrap_chat_method: (untyped client) -> void
+    end
+  end
+end

data/sig/payloop/wrappers/ruby_llm.rbs

@@ -0,0 +1,21 @@
+# Starter signatures generated by typeprof + hand-refined; see CLAUDE.md
+# "Code style: type signatures (RBS)" for the refinement convention.
+module Payloop
+  module Wrappers
+    class RubyLLM
+      @config: Payloop::Config
+      @collector: Payloop::Collector
+      @sentinel: Payloop::Sentinel?
+
+      def initialize: (Payloop::Config config, Payloop::Collector collector, ?Payloop::Sentinel? sentinel) -> void
+      def register: (untyped client) -> untyped
+
+      private
+      def validate_client!: (untyped client) -> void
+      def wrap_ask_method: (untyped client) -> void
+      def build_query: (String provider, String model_id, Array[Hash[Symbol, untyped]] messages, Hash[Symbol, untyped] tools) -> Hash[Symbol, untyped]
+      def build_messages_query: (String model_id, Array[Hash[Symbol, untyped]] messages, Hash[Symbol, untyped] tools) -> Hash[Symbol, untyped]
+      def build_google_query: (String model_id, Array[Hash[Symbol, untyped]] messages, Hash[Symbol, untyped] tools) -> Hash[Symbol, untyped]
+    end
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: payloop
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Payloop
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-04-10 00:00:00.000000000 Z
+date: 2026-05-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: concurrent-ruby
@@ -52,8 +52,29 @@ files:
 - lib/payloop/wrappers/constants.rb
 - lib/payloop/wrappers/geminiai.rb
 - lib/payloop/wrappers/google.rb
+- lib/payloop/wrappers/groq.rb
 - lib/payloop/wrappers/openai.rb
 - lib/payloop/wrappers/ruby_llm.rb
+- sig/payloop/api/base.rbs
+- sig/payloop/api/invocation.rbs
+- sig/payloop/api/sentinel.rbs
+- sig/payloop/api/workflow.rbs
+- sig/payloop/api/workflows.rbs
+- sig/payloop/attribution.rbs
+- sig/payloop/client.rbs
+- sig/payloop/collector.rbs
+- sig/payloop/config.rbs
+- sig/payloop/errors.rbs
+- sig/payloop/sentinel.rbs
+- sig/payloop/version.rbs
+- sig/payloop/wrappers/anthropic.rbs
+- sig/payloop/wrappers/base.rbs
+- sig/payloop/wrappers/constants.rbs
+- sig/payloop/wrappers/geminiai.rbs
+- sig/payloop/wrappers/google.rbs
+- sig/payloop/wrappers/groq.rbs
+- sig/payloop/wrappers/openai.rbs
+- sig/payloop/wrappers/ruby_llm.rbs
 homepage: https://trypayloop.com
 licenses:
 - MIT