payloop 0.1.1 → 0.4.0

data/sig/payloop/api/base.rbs

@@ -0,0 +1,24 @@
+# Starter signatures generated by typeprof + hand-refined; see CLAUDE.md
+# "Code style: type signatures (RBS)" for the refinement convention.
+module Payloop
+  module API
+    class Base
+      @original_api_url: String
+      @api_url: String
+      @api_key: String
+      @timeout: Numeric
+
+      def initialize: (String api_url, String api_key, Numeric timeout) -> void
+
+      private
+      def get: (String path) -> untyped
+      def post: (String path, ?Hash[Symbol, untyped]? body) -> untyped
+      def put: (String path, ?Hash[Symbol, untyped]? body) -> untyped
+      def delete: (String path) -> untyped
+      def request: (Symbol method, String path, ?Hash[Symbol, untyped]? body) -> untyped
+      def build_request: (Symbol method, URI::Generic uri, Hash[Symbol, untyped]? body) -> (Net::HTTP::Delete | Net::HTTP::Get | Net::HTTP::Post | Net::HTTP::Put)
+      def handle_response: (Net::HTTPResponse response) -> untyped
+      def parse_json_response: (String? body) -> untyped
+    end
+  end
+end

data/sig/payloop/api/invocation.rbs

@@ -0,0 +1,16 @@
+# Starter signatures generated by typeprof + hand-refined; see CLAUDE.md
+# "Code style: type signatures (RBS)" for the refinement convention.
+module Payloop
+  module API
+    class Invocation < Base
+      @attribution: Hash[Symbol, untyped]?
+
+      def initialize: (String api_url, String api_key, Numeric timeout) -> void
+      def attribution: (parent_id: String, ?parent_name: String?, ?subsidiary_id: String?, ?subsidiary_name: String?) -> self
+      def summary: (String workflow_uuid, date_start: (Date | Time | String), ?date_end: (Date | Time | String)?) -> untyped
+
+      private
+      def format_date: ((Date | Time | String) date) -> String
+    end
+  end
+end

data/sig/payloop/api/sentinel.rbs

@@ -0,0 +1,9 @@
+# Starter signatures generated by typeprof + hand-refined; see CLAUDE.md
+# "Code style: type signatures (RBS)" for the refinement convention.
+module Payloop
+  module API
+    class Sentinel < Base
+      def relevance_intercept: (Hash[Symbol, untyped] payload) -> untyped
+    end
+  end
+end

data/sig/payloop/api/workflow.rbs

@@ -0,0 +1,15 @@
+# Starter signatures generated by typeprof + hand-refined; see CLAUDE.md
+# "Code style: type signatures (RBS)" for the refinement convention.
+module Payloop
+  module API
+    class Workflow < Base
+      @uuid: String
+
+      def initialize: (String uuid, String api_url, String api_key, Numeric timeout) -> void
+      def details: -> untyped
+      def update: (label: String) -> untyped
+      def destroy: -> untyped
+      def invocation: -> Payloop::API::Invocation
+    end
+  end
+end

data/sig/payloop/api/workflows.rbs

@@ -0,0 +1,16 @@
+# Starter signatures generated by typeprof + hand-refined; see CLAUDE.md
+# "Code style: type signatures (RBS)" for the refinement convention.
+module Payloop
+  module API
+    class Workflows < Base
+      @invocation: Payloop::API::Invocation
+
+      def list: -> untyped
+      def create: (name: String, ?description: String?) -> untyped
+      def details: (String uuid) -> untyped
+      def update: (String uuid, label: String) -> untyped
+      def destroy: (String uuid) -> untyped
+      def invocation: -> Payloop::API::Invocation
+    end
+  end
+end

data/sig/payloop/attribution.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 Attribution
+    attr_reader parent_id: String
+    attr_reader parent_name: String?
+    attr_reader subsidiary_id: String?
+    attr_reader subsidiary_name: String?
+    def initialize: (parent_id: String, ?parent_name: String?, ?subsidiary_id: String?, ?subsidiary_name: String?) -> void
+    def to_h: -> Hash[Symbol, untyped]
+
+    private
+    def validate_parent_id!: (untyped value) -> String
+    def validate_string_length!: (untyped value, String field_name) -> String?
+    def validate_subsidiary_requirements!: -> void
+  end
+end

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.1.1
+  version: 0.4.0
 platform: ruby
 authors:
 - Payloop
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-02-11 00:00:00.000000000 Z
+date: 2026-05-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: concurrent-ruby
@@ -52,7 +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