coolhand 0.1.4 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4b8242433c93dec62fb833fc641c5917f6bb68c01e59e3061f2ac6300ec674c5
-  data.tar.gz: 7e6019bc86a3268df2ddebf4e0a9cfcabd32a72e3e8618a473c2035921aa0ff0
+  metadata.gz: fc0fc356a6cf69d4a0c67a906000cab9590d9fc2a452efec8037a7f541efa561
+  data.tar.gz: ec6f7a136ae1d8e139bf638175b81a2dda063b9bf19d0199ab7f7135cf6d833d
 SHA512:
-  metadata.gz: 2255984a1e9238a8bfd1fedecf19aece7a552b25635873ec51803390ae679d206eb69dd0ff31d9df3d6169d78d9ba7503321eaf4bd048b2e59d3337b5c05758c
-  data.tar.gz: 44a5dc44c6a74385adf1e70057bf49f463c0401bea5f69b5850d697b414292fe0f9ebe208903f46325db80e0a638bf548c4a1dfcebe0d3b808f67a32b2167cdf
+  metadata.gz: 131465dcaf94ae8cc4b5dce47252fe92effc9693ba4de6e61247714c682a717934fa3144cf3228bf754fe89a53803051f32a895c3a42fd3c07990d4cf74286a5
+  data.tar.gz: 26e03d0f27b9acbeb36ff6a0e0ee11cca55b8142cd17d494972013534ba4d8b3753b29fb3565dedb8c0f8daf1e26d7af443353999f5956f5b1b7b8d7ea139585

data/.rubocop.yml

@@ -1,7 +1,8 @@
 # This is the configuration used to check the rubocop source code.
 
-require:
+plugins:
   - rubocop-performance
+require:
   - rubocop-rspec
 inherit_gem:
   test-prof: config/rubocop-rspec.yml

data/CHANGELOG.md

@@ -5,6 +5,59 @@ 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.2.0] - 2025-12-16
+
+### ✨ Major New Features
+- **Official Anthropic Gem Support** - Added comprehensive monitoring support for the official `anthropic` gem (v1.8+) through direct Net::HTTP interception
+- **Dual Gem Compatibility** - Support for both `anthropic` (official) and `ruby-anthropic` (community) gems with automatic detection and appropriate interceptor selection
+- **Streaming Response Support** - Enhanced SSE (Server-Sent Events) parsing for Anthropic streaming responses with proper message accumulation and reconstruction
+- **Graceful Gem Conflict Handling** - Automatic detection when both anthropic gems are installed, with graceful degradation to ruby-anthropic monitoring
+
+### 🏗️ Architecture Improvements
+- **AnthropicInterceptor Module** - New dedicated interceptor for official anthropic gem requests with streaming response support
+- **BaseInterceptor Module** - Shared functionality across interceptors with unified API logging format and DRY principles
+- **Modular Design** - Moved from single `interceptor.rb` to specialized interceptors (`faraday_interceptor.rb`, `anthropic_interceptor.rb`)
+- **Enhanced Configuration** - Automatic gem detection in `configure` block with appropriate interceptor selection
+
+### 🔧 API & Format Changes
+- **Unified Logging Format** - Standardized API request/response logging with `raw_request` wrapper and collector data integration
+- **Headers Field Update** - API logs now use `headers` instead of `request_headers` for consistency
+- **Silent Mode Override** - Critical warnings (like gem conflicts) now always display regardless of silent mode settings
+
+### 🧪 Testing & Quality
+- **Comprehensive Test Coverage** - Added 16 new specs covering all interceptor scenarios including gem conflict handling
+- **RuboCop Compliance** - Applied linting with proper line length, verified doubles, and RSpec best practices
+- **Thread Safety** - Enhanced request correlation with thread-local storage for streaming requests
+
+### 🗂️ Supported Environments
+- **Development Environment** - Uses official `anthropic` gem for Net::HTTP-based requests
+- **AR_Dev Environment** - Uses `ruby-anthropic` gem for Faraday-based requests
+- **Automatic Detection** - Coolhand detects which gem is loaded and applies appropriate interception
+
+### 💔 Breaking Changes
+- **Removed** - `lib/coolhand/ruby/interceptor.rb` replaced by specialized interceptor modules
+- **API Change** - Logging format now uses `headers` field instead of `request_headers`
+
+### 🔄 Migration Guide
+For users upgrading from v0.1.x:
+- No code changes required for basic usage
+- If depending on old `interceptor.rb` directly, update imports to use `faraday_interceptor.rb` or `anthropic_interceptor.rb`
+- API log consumers should expect `headers` field instead of `request_headers`
+
+### 📊 Compatibility Matrix
+| Gem | Version | Interceptor | Status |
+|-----|---------|-------------|--------|
+| `anthropic` | 1.8+ | AnthropicInterceptor | ✅ Full Support |
+| `ruby-anthropic` | 0.4+ | FaradayInterceptor | ✅ Full Support |
+| Both gems | Any | FaradayInterceptor | ⚠️ Graceful Degradation |
+
+## [0.1.5] - 2024-12-09
+
+### 🐛 Critical Bug Fixes
+- **Fixed SystemStackError with APM tools** - Resolved critical conflict with Datadog and other APM tools that caused applications to crash on startup with "stack level too deep" error
+- **Replaced alias_method with prepend** - Changed monkey-patching approach from `alias_method` to `prepend` for better compatibility with other instrumentation libraries
+- **Added duplicate interceptor prevention** - Ensures only one Coolhand interceptor is added to each Faraday connection
+
 ## [0.1.3] - 2024-10-23
 
 ### ✨ New Features

data/README.md

@@ -10,7 +10,7 @@ gem 'coolhand'
 
 ## Getting Started
 
-1. **Get API Key**: Visit [coolhand.io](https://coolhand.io/) to create a free account
+1. **Get API Key**: Visit [coolhandlabs.com](https://coolhandlabs.com/) to create a free account
 2. **Install**: `gem install coolhand`
 3. **Initialize**: Add configuration to your Ruby application
 4. **Configure**: Set your API key in the configuration block
@@ -186,29 +186,7 @@ puts response.dig("choices", 0, "message", "content")
 # The request and response have been automatically logged to Coolhand!
 ```
 
-### With Anthropic Ruby Client
-
-```ruby
-require 'anthropic'
-require 'coolhand/ruby'
-
-# Configure Coolhand
-Coolhand.configure do |config|
-  config.api_key = 'your_api_key_here'
-end
-
-# Use Anthropic normally - requests are automatically logged
-anthropic = Anthropic::Client.new(access_token: ENV['ANTHROPIC_API_KEY'])
-
-response = anthropic.messages(
-  model: "claude-3-opus",
-  max_tokens: 1024,
-  messages: [{ role: "user", content: "Hello, Claude!" }]
-)
-
-puts response["content"]
-# Automatically logged to Coolhand!
-```
+📖 **[Complete Anthropic Integration Guide →](docs/anthropic.md)** - Supports both official and community gems with automatic detection
 
 ## Logging Inbound Webhooks
 
@@ -285,23 +263,43 @@ The filtering is automatic and applies to all monitored API calls and webhook lo
 
 ## Supported Libraries
 
-The monitor works with any Ruby library that uses Faraday for HTTP(S) requests to LLM APIs, including:
+The monitor works with multiple transport layers and Ruby libraries:
 
+**Faraday-based libraries:**
 - OpenAI Ruby SDK
-- Anthropic Ruby SDK
+- ruby-anthropic gem (community Anthropic gem)
 - ruby-openai gem
 - LangChain.rb
 - Direct Faraday requests
 - Any other Faraday-based HTTP client
 
+**Native HTTP libraries:**
+- Official Anthropic Ruby SDK (using Net::HTTP)
+- Any library using Net::HTTP directly
+
+**Auto-detection**: Coolhand automatically detects which transport layer your libraries use and applies the appropriate monitoring strategy.
+
 ## How It Works
 
-The gem patches Faraday connections to intercept HTTP requests. When a request matches the configured LLM endpoints:
+Coolhand uses a dual-interceptor strategy to monitor different HTTP transport layers:
+
+### Faraday Interceptor
+- Patches Faraday connections using middleware injection
+- Monitors: OpenAI SDK, ruby-anthropic, LangChain.rb, and other Faraday-based libraries
+- Handles: Standard HTTP requests and Server-Sent Events (SSE) for streaming
+
+### Anthropic Interceptor
+- Patches the official Anthropic gem's internal HTTP transport (Net::HTTP)
+- Monitors: Official Anthropic Ruby SDK requests
+
+### Request Flow
+When a request matches configured LLM endpoints:
 
-1. The original request executes normally
-2. Request and response data (body, headers, status) are captured
-3. Data is sent to the Coolhand API asynchronously in a background thread
-4. Your application continues without any performance impact
+1. The original request executes normally with zero performance impact
+2. Request and response data (body, headers, status) are captured by the appropriate interceptor
+3. For streaming requests, the complete accumulated response is captured (not individual chunks)
+4. Data is sent to the Coolhand API asynchronously in a background thread
+5. Your application continues without interruption
 
 For non-matching endpoints, requests pass through unchanged.
 
@@ -351,7 +349,7 @@ end
 
 ## API Key
 
-🆓 **Sign up for free** at [coolhand.io](https://coolhand.io/) to get your API key and start monitoring your LLM usage.
+🆓 **Sign up for free** at [coolhandlabs.com](https://coolhandlabs.com/) to get your API key and start monitoring your LLM usage.
 
 **What you get:**
 - Complete LLM request and response logging
@@ -369,6 +367,7 @@ The monitor handles errors gracefully:
 
 ## Integration Guides
 
+- **[Anthropic Integration](docs/anthropic.md)** - Complete guide for both official and community Anthropic gems, including streaming, dual gem handling, and troubleshooting
 - **[ElevenLabs Integration](docs/elevenlabs.md)** - Complete guide for integrating ElevenLabs Conversational AI with webhook capture and feedback submission
 
 ## Security
@@ -380,7 +379,7 @@ The monitor handles errors gracefully:
 ## Other Languages
 
 - **Node.js**: [coolhand-node package](https://github.com/coolhand-io/coolhand-node) - Coolhand monitoring for Node.js applications
-- **API Docs**: [API Documentation](https://coolhand.io/docs) - Direct API integration documentation
+- **API Docs**: [API Documentation](https://coolhandlabs.com/docs) - Direct API integration documentation
 
 ## Community