coolhand 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6a7e878a6cb441cee3e29de825ba5b0d5b01285475f42d5a4f66386f37379098
-  data.tar.gz: fcc866bd1ca6e7348fbd3ff2daf75ba9203981c09acfaa6062873a08e11b5370
+  metadata.gz: 3f66ea8b94e39769d66543c75987c2108397f89c93dc53748753b396ca76d921
+  data.tar.gz: 560b9ec89c71b31095b5f579bb270b295a79b87a7edbec495179f6f1b764f77e
 SHA512:
-  metadata.gz: 7b7f36ff49b826fb34691488c3839de760c7f01c58f811e1bb9108b896da71d958f2e1a714486513da0c1a264278078784ee4065be165b72b349939128e4a9e8
-  data.tar.gz: c3bcb5e2a7d3bb07e8e66483bb5c64d3a27b4ad7b7cd677a7bc7aa74b8d612ad53b3b373f21244d3fdf14fb32a34ccee1f80e227b740d3634b7fb6074b7ee64a
+  metadata.gz: ebd806bb3744d3fd16673a98f7746b144b468a158ec855b32a4ba142cf110ff4a78b03ea1b95106b8f29d011425bbe0ec44b8f853acb87b9e4037cf87843991f
+  data.tar.gz: 3a8078f5dbe7f3a5c7a0892b391a7085d54b5a6aa1db386075e34470c89802ca0bd6bb5dc5654dffa7fcb2595da3df7b2210a52568595c5c77929e435d1a13b8

data/CHANGELOG.md

@@ -5,6 +5,21 @@ 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).
 
+## [Unreleased]
+
+## [0.4.0] - 2026-06-22
+
+### Added
+- **More default intercept addresses** — Vertex AI (`aiplatform.googleapis.com`), Cloudflare AI Gateway (`gateway.ai.cloudflare.com`), AWS Bedrock OpenAI-compatible endpoint (`bedrock-runtime`), and OpenRouter (`openrouter.ai`) are now monitored out of the box with no configuration required (#66).
+- **`Configuration#enabled` flag** — Set `config.enabled = false` (e.g. `config.enabled = Rails.env.production?`) to skip all patching and validation globally without restructuring your configure block (#68).
+- **Feedback `creator_type` field** — Pass `creator_type: 'human'`, `'agent'`, or `'unknown'` when submitting feedback to identify who originated the feedback; matches the Coolhand API field (#67).
+
+### Changed
+- **Deferred `api_key` validation** — A missing `api_key` no longer raises at `Coolhand.configure` time. Intercepted requests are silently skipped (with a warning log) when the key is absent, so apps that boot without a key in CI or non-production environments no longer crash (#68).
+
+### Dependencies
+- Bumped `faraday` from 2.14.1 to 2.14.2 (#63).
+
 ## [0.3.0] - 2026-05-14
 
 ### 🚀 Major Changes

data/README.md

@@ -1,5 +1,7 @@
 # Coolhand Ruby Monitor
 
+[![Gem Version](https://badge.fury.io/rb/coolhand.svg)](https://badge.fury.io/rb/coolhand)
+
 Monitor and log LLM API calls from multiple providers (OpenAI, Anthropic, Google AI, Cohere, and more) to the Coolhand analytics platform.
 
 ## Installation
@@ -107,6 +109,7 @@ feedback = feedback_service.create_feedback(
 - **`like`** 👍 *Low Signal (Deprecated)* - Boolean: `true` = like, `false` = dislike. Use `sentiment` instead. Conversion: `true` → `"like"`, `false` → `"dislike"`.
 - **`workload_hashid`** 🔗 *Workload Association* - Hashid of a workload to associate this feedback with.
 - **`creator_unique_id`** 👤 *User Tracking* - Unique ID to match feedback to the end user who created it
+- **`creator_type`** 🧑‍🤝‍🤖 *Creator Type* - What kind of creator submitted the feedback: `'human'`, `'agent'`, or `'unknown'`.
 
 ## Rails Integration
 
@@ -179,7 +182,8 @@ end
 
 | Option | Type | Default | Description |
 |--------|------|---------|-------------|
-| `api_key` | String | *required* | Your Coolhand API key for authentication |
+| `api_key` | String | `nil` | Your Coolhand API key. If absent, intercepted requests are skipped with a warning log rather than raising at boot time |
+| `enabled` | Boolean | `true` | Set to `false` to disable all patching and validation (e.g. `Rails.env.production?`) |
 | `silent` | Boolean | `false` | Whether to suppress console output |
 | `intercept_addresses` | Array | `["api.openai.com", "api.anthropic.com"]` | Array of API endpoint strings to monitor |
 

data/lib/coolhand/api_service.rb

@@ -65,6 +65,8 @@ module Coolhand
     end
 
     def send_request(payload, success_message)
+      return nil if missing_api_key?
+
       uri = URI.parse(@api_endpoint)
       http = Net::HTTP.new(uri.host, uri.port)
       http.use_ssl = (uri.scheme == "https")
@@ -117,6 +119,8 @@ module Coolhand
     end
 
     def create_feedback(feedback, collection_method = nil)
+      return nil if !debug_mode? && missing_api_key?
+
       normalized = normalize_feedback_sentiment(feedback)
       feedback_with_collector = add_collector_to_data(normalized, collection_method)
 
@@ -144,6 +148,8 @@ module Coolhand
     end
 
     def create_log(captured_data, collection_method = nil)
+      return nil if !debug_mode? && missing_api_key?
+
       raw_request_with_collector = add_collector_to_data({ raw_request: captured_data }, collection_method)
 
       payload = {
@@ -193,6 +199,13 @@ module Coolhand
 
     private
 
+    def missing_api_key?
+      return false if Coolhand.required_field?(api_key)
+
+      Coolhand.log "⚠️  Coolhand: API key is missing — skipping log for this request."
+      true
+    end
+
     # Get all filtered field names as a flat array
     def filtered_field_names
       @filtered_field_names ||= BINARY_DATA_FILTERS.values.flatten.map(&:downcase)

data/lib/coolhand/configuration.rb

@@ -17,7 +17,7 @@ module Coolhand
     BASE_URL_ERROR_MSG = "base_url must use https:// (or http://localhost / http://127.0.0.1 for local dev)"
     LOOPBACK_HOSTS = %w[localhost 127.0.0.1 ::1].freeze
 
-    attr_accessor :api_key, :environment, :silent, :debug_mode, :capture, :exclude_api_patterns
+    attr_accessor :api_key, :environment, :silent, :debug_mode, :capture, :exclude_api_patterns, :enabled
     attr_reader :intercept_addresses, :base_url
 
     def initialize
@@ -30,6 +30,7 @@ module Coolhand
       @debug_mode = false
       @capture = true
       @exclude_api_patterns = DEFAULT_EXCLUDE_API_PATTERNS.dup
+      @enabled = true
     end
 
     # Custom setter that preserves defaults when nil/empty array is provided
@@ -47,12 +48,6 @@ module Coolhand
     end
 
     def validate!
-      # Validate API Key after configuration
-      if api_key.nil?
-        Coolhand.log "❌ Coolhand Error: API Key is required. Please set it in the configuration."
-        raise Error, "API Key is required"
-      end
-
       # Validate intercept_addresses after configuration
       if intercept_addresses.nil? || intercept_addresses.empty?
         Coolhand.log "❌ Coolhand Error: Intercept addresses cannot be empty. Please set it in the configuration."

data/lib/coolhand/default_intercept_addresses.yml

@@ -13,3 +13,7 @@
 - "models.inference.ai.azure.com"
 - ":generateContent"
 - ":streamGenerateContent"
+- "aiplatform.googleapis.com"
+- "gateway.ai.cloudflare.com"
+- "bedrock-runtime"
+- "openrouter.ai"

data/lib/coolhand/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Coolhand
-  VERSION = "0.3.0"
+  VERSION = "0.4.0"
 end

data/lib/coolhand.rb

@@ -45,6 +45,8 @@ module Coolhand
     def configure
       yield(configuration)
 
+      return unless configuration.enabled
+
       configuration.validate!
 
       NetHttpInterceptor.patch!
@@ -58,13 +60,15 @@ module Coolhand
         return
       end
 
-      patched = NetHttpInterceptor.patched?
+      return yield unless configuration.enabled
 
+      patched = NetHttpInterceptor.patched?
       NetHttpInterceptor.patch!
-
-      yield
-    ensure
-      NetHttpInterceptor.unpatch! unless patched
+      begin
+        yield
+      ensure
+        NetHttpInterceptor.unpatch! unless patched
+      end
     end
 
     def without_capture

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: coolhand
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Michael Carroll
 - Yaroslav Malyk
 bindir: exe
 cert_chain: []
-date: 2026-05-16 00:00:00.000000000 Z
+date: 2026-06-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: base64
@@ -43,7 +43,6 @@ files:
 - LICENSE
 - README.md
 - Rakefile
-- coolhand-ruby.gemspec
 - docs/anthropic.md
 - docs/elevenlabs.md
 - lib/coolhand.rb

data/coolhand-ruby.gemspec

@@ -1,46 +0,0 @@
-# frozen_string_literal: true
-
-require_relative "lib/coolhand/version"
-
-Gem::Specification.new do |spec|
-  spec.name = "coolhand"
-  spec.version = Coolhand::VERSION
-  spec.authors = ["Michael Carroll", "Yaroslav Malyk"]
-  spec.email = ["mc@coolhandlabs.com"]
-
-  spec.summary = "Monitor and log LLM API calls from OpenAI, Anthropic, and other providers to Coolhand analytics."
-  spec.description = "Automatically intercept and log LLM requests from Ruby applications. Supports OpenAI, " \
-                     "official Anthropic gem, ruby-anthropic gem, and other Faraday-based libraries. Features " \
-                     "dual interceptor architecture, streaming support, thread-safe operation, and automatic " \
-                     "duplicate request prevention."
-  spec.homepage = "https://coolhandlabs.com/"
-  spec.license = "Apache-2.0"
-  spec.required_ruby_version = ">= 3.0.0"
-
-  spec.metadata["allowed_push_host"] = "https://rubygems.org"
-
-  spec.metadata["homepage_uri"] = spec.homepage
-  spec.metadata["source_code_uri"] = "https://github.com/Coolhand-Labs/coolhand-ruby"
-  spec.metadata["changelog_uri"] = "https://github.com/Coolhand-Labs/coolhand-ruby/blob/main/CHANGELOG.md"
-
-  # Specify which files should be added to the gem when it is released.
-  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
-  spec.files = Dir.chdir(__dir__) do
-    `git ls-files -z`.split("\x0").reject do |f|
-      (File.expand_path(f) == __FILE__) ||
-        f.start_with?(*%w[bin/ test/ spec/ features/ .git appveyor Gemfile])
-    end
-  end
-  spec.bindir = "exe"
-  spec.executables = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
-  spec.require_paths = ["lib"]
-
-  # Uncomment to register a new dependency of your gem
-  # spec.add_dependency "example-gem", "~> 1.0"
-
-  spec.add_dependency "base64", "~> 0.2"
-
-  # For more information and examples about making a new gem, check out our
-  # guide at: https://bundler.io/guides/creating_gem.html
-  spec.metadata["rubygems_mfa_required"] = "true"
-end