coolhand 0.1.2 → 0.1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 193fc72a2e4d3c485584250f6f846ba97dbd02f55c357e8bf6f3f95641b669d5
-  data.tar.gz: 4523f4af59e1a81a7763edd5424e86bec7bd35eb40799af7ad253446d9c86bbe
+  metadata.gz: 2e32109fb4ad7c01bf475cf1dbdb33a16a8ccb16ff46e2de3c5fcb0b6424e18e
+  data.tar.gz: 55da627d7b73a90195a0d1496cf504b9a46ed28e9f04fa93aff2898929662129
 SHA512:
-  metadata.gz: 6d65bfde6461c4f9676a2e0c64de863204e075abae9b762666119bad7676d21ff962e9aeafb3d0420e86ee9d00e0dcda9e266f99dbfc751b289e5e3c91e028cf
-  data.tar.gz: 48aa86e01741e1a93faec921e65e13a3d434740f91c0c564d22406279d15eab56f60f1aea1bebb5d9c5eb1095200c459b8e728cbd41cc118ee359edfb9eccec1
+  metadata.gz: 71d3bfb35646b3de753521c28bd1081ba7a777521d9be7aa115c03df3bdb96a3a6eb64dc858ae453db216e1d7af742b61539531ce957e28a68d9f3f77436b609
+  data.tar.gz: 5d84be3c077cbf1cbb694fa62229a6ace4bcaeca306c8f0dac64e9213106f02ac3529d108817b27102a9213592755aa62f867660cadf7b1e9630015803efcd1e

data/CHANGELOG.md

@@ -5,6 +5,17 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.1.3] - 2024-10-23
+
+### ✨ New Features
+- **Collector Identifier** - Added collector field to all API calls to identify SDK version (format: `coolhand-ruby-X.Y.Z`)
+- **Collection Method Tracking** - Support for optional collection method suffix (`manual`, `auto-monitor`)
+
+### 🏗️ Internal Improvements
+- **Added Collector Module** - New `Coolhand::Ruby::Collector` module for generating SDK identification strings
+- **Updated ApiService** - Base service now automatically adds collector field to all API payloads
+- **Enhanced Logging** - Both LoggerService and FeedbackService now send collector information
+
 ## [0.1.2] - 2024-10-22
 
 ### 🔧 Configuration Improvements

data/lib/coolhand/ruby/api_service.rb

@@ -3,6 +3,7 @@
 require "net/http"
 require "uri"
 require "json"
+require_relative "collector"
 
 module Coolhand
   module Ruby
@@ -29,6 +30,11 @@ module Coolhand
 
       protected
 
+      # Add collector field to the data being sent
+      def add_collector_to_data(data, collection_method = nil)
+        data.merge(collector: Collector.get_collector_string(collection_method))
+      end
+
       def create_request_options(_payload)
         {
           "Content-Type" => "application/json",
@@ -71,9 +77,11 @@ module Coolhand
         log("═" * 60) unless silent
       end
 
-      def create_feedback(feedback)
+      def create_feedback(feedback, collection_method = nil)
+        feedback_with_collector = add_collector_to_data(feedback, collection_method)
+
         payload = {
-          llm_request_log_feedback: feedback
+          llm_request_log_feedback: feedback_with_collector
         }
 
         log_feedback_info(feedback)
@@ -87,11 +95,11 @@ module Coolhand
         result
       end
 
-      def create_log(captured_data)
+      def create_log(captured_data, collection_method = nil)
+        raw_request_with_collector = add_collector_to_data({ raw_request: captured_data }, collection_method)
+
         payload = {
-          llm_request_log: {
-            raw_request: captured_data
-          }
+          llm_request_log: raw_request_with_collector
         }
 
         log_request_info(captured_data)

data/lib/coolhand/ruby/collector.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Coolhand
+  module Ruby
+    # Utility for generating collector identification string
+    module Collector
+      COLLECTION_METHODS = %w[manual auto-monitor].freeze
+
+      class << self
+        # Gets the collector identification string
+        # Format: "coolhand-ruby-X.Y.Z" or "coolhand-ruby-X.Y.Z-method"
+        # @param method [String, nil] Optional collection method suffix
+        # @return [String] Collector string identifying this SDK version and collection method
+        def get_collector_string(method = nil)
+          base = "coolhand-ruby-#{VERSION}"
+          method && COLLECTION_METHODS.include?(method) ? "#{base}-#{method}" : base
+        end
+      end
+    end
+  end
+end

data/lib/coolhand/ruby/feedback_service.rb

@@ -9,7 +9,9 @@ module Coolhand
         super("v2/llm_request_log_feedbacks")
       end
 
-      public :create_feedback
+      def create_feedback(feedback)
+        super(feedback, "manual")
+      end
     end
   end
 end

data/lib/coolhand/ruby/logger_service.rb

@@ -10,7 +10,7 @@ module Coolhand
       end
 
       def log_to_api(captured_data)
-        create_log(captured_data)
+        create_log(captured_data, "auto-monitor")
       end
     end
   end

data/lib/coolhand/ruby/version.rb

@@ -2,6 +2,6 @@
 
 module Coolhand
   module Ruby
-    VERSION = "0.1.2"
+    VERSION = "0.1.3"
   end
 end

data/lib/coolhand/ruby.rb

@@ -7,6 +7,7 @@ require "securerandom"
 
 require_relative "ruby/version"
 require_relative "ruby/configuration"
+require_relative "ruby/collector"
 require_relative "ruby/interceptor"
 require_relative "ruby/api_service"
 require_relative "ruby/logger_service"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: coolhand
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.1.3
 platform: ruby
 authors:
 - Michael Carroll
@@ -9,7 +9,7 @@ authors:
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-10-22 00:00:00.000000000 Z
+date: 2025-11-08 00:00:00.000000000 Z
 dependencies: []
 description: A Ruby gem to automatically monitor and log external LLM requests. It
   patches Net::HTTP to capture request and response data.
@@ -30,6 +30,7 @@ files:
 - coolhand-ruby.gemspec
 - lib/coolhand/ruby.rb
 - lib/coolhand/ruby/api_service.rb
+- lib/coolhand/ruby/collector.rb
 - lib/coolhand/ruby/configuration.rb
 - lib/coolhand/ruby/feedback_service.rb
 - lib/coolhand/ruby/interceptor.rb