langfuse-ruby 0.1.3 → 0.1.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: af3d00eedfb953a5bdc8f1a99d272debe050ed43cf160329c907cd209b28e042
-  data.tar.gz: 3a4c6ac469fa7874c0e310b059029bcaa879e6f048abfd902097dfde1d7ed3fe
+  metadata.gz: 0bb59924d3a9dcb1cb99841c6d07dd1277838ffee389d13ada1c8b03cafeb524
+  data.tar.gz: c5ba1846cd51fc3dc82fb43dd335d88394549652531a5243101ccd43ef71b3fa
 SHA512:
-  metadata.gz: 2b74bc9c6d80fe4f09c20f38345bb0244b801acc07b770674b85778c21ad0b66b0fabe07206071c52f8780531dce49799b6db8d67b1cee662432ab8f5ae81258
-  data.tar.gz: 9901d034719eab0f2c082962cf36396591db46b33f54665c3dcb9cfdd9f22c8f96ba1b71b7296d4131e20a43355e57375e70020d734a43f810d05a802e207e3f
+  metadata.gz: 9e448848c65cb8cd6f7ab7e4e566787bcab4aa8c43f20da7cc7a7a39e24e888c734c23644682f080635a0288b40fc4e3e169d8576445fdd07dde8d676faaccca
+  data.tar.gz: 9d9d1e88bf2e1161bd1d7f316e17600904169344b679839992a227eb35ac48e7edbe188ce782e3757f9f03a8a39104eac8c171a23f7bdc0c54b707754dfd87e8

data/.github/workflows/ci.yml

@@ -0,0 +1,53 @@
+name: CI
+
+on:
+  push:
+    branches: [ main, master ]
+  pull_request:
+    branches: [ main, master ]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    
+    strategy:
+      matrix:
+        ruby-version: ['2.7', '3.0', '3.1', '3.2', '3.3']
+    
+    steps:
+    - uses: actions/checkout@v4
+    
+    - name: Set up Ruby ${{ matrix.ruby-version }}
+      uses: ruby/setup-ruby@v1
+      with:
+        ruby-version: ${{ matrix.ruby-version }}
+        bundler-cache: true
+    
+    - name: Run tests
+      run: bundle exec rspec
+    
+    - name: Run offline tests
+      run: ruby test_offline.rb
+    
+    - name: Run RuboCop
+      run: bundle exec rubocop
+      continue-on-error: true
+  
+  build:
+    runs-on: ubuntu-latest
+    needs: test
+    
+    steps:
+    - uses: actions/checkout@v4
+    
+    - name: Set up Ruby
+      uses: ruby/setup-ruby@v1
+      with:
+        ruby-version: '3.2'
+        bundler-cache: true
+    
+    - name: Build gem
+      run: gem build langfuse-ruby.gemspec
+    
+    - name: Verify gem can be installed
+      run: gem install langfuse-ruby-*.gem 

data/CHANGELOG.md

@@ -7,20 +7,40 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.1.4] - 2025-07-29
+
 ### Added
+- Added support for `trace-update` event type in Langfuse ingestion API
 - Added support for `event-create` event type in Langfuse ingestion API
 - New `Event` class for creating generic events within traces, spans, and generations
 - Added `event()` method to `Client`, `Trace`, `Span`, and `Generation` classes
 - Enhanced event validation to include all supported Langfuse event types
 - New example file `examples/event_usage.rb` demonstrating event functionality
 
-## [0.1.2] - 2025-01-13
+### Fixed
+- Improved offline test error handling and authentication validation
+- Enhanced error handling tests with proper configuration management
+- Fixed prompt template validation tests in offline mode
+- Better error message handling for authentication failures
 
-### Added
+### Improved
+- More comprehensive error handling test coverage
+- Better test isolation and cleanup procedures
+- Enhanced debugging capabilities for offline testing
+
+## [0.1.3] - 2025-07-13
+
+### Fixed
+- Enhanced event data validation and debugging capabilities
+- More detailed error messages for event structure validation failures
+
+## [0.1.2] - 2025-07-12
+
+### Fixed
 - Enhanced event data validation and debugging capabilities
 - More detailed error messages for event structure validation failures
 
-## [0.1.1] - 2025-01-12
+## [0.1.1] - 2025-07-12
 
 ### Fixed
 - Improved error handling for `get_prompt` method when prompt doesn't exist
@@ -36,7 +56,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Updated gemspec metadata to avoid RubyGems warnings
 - Improved documentation with clearer error handling examples
 
-## [0.1.0] - 2025-01-12
+## [0.1.0] - 2025-07-12
 
 ### Added
 - Initial release of Langfuse Ruby SDK

data/Gemfile.lock

@@ -1,10 +1,10 @@
 PATH
   remote: .
   specs:
-    langfuse-ruby (0.1.3)
+    langfuse-ruby (0.1.4)
       concurrent-ruby (~> 1.0)
-      faraday (~> 2.0)
-      faraday-net_http (~> 3.0)
+      faraday (>= 1.8, < 3.0)
+      faraday-net_http (>= 1.0, < 4.0)
       json (~> 2.0)
 
 GEM

data/README.md

@@ -1,7 +1,9 @@
 # Langfuse Ruby SDK
 
 [![Gem Version](https://badge.fury.io/rb/langfuse-ruby.svg)](https://badge.fury.io/rb/langfuse-ruby)
-[![Build Status](https://github.com/ai-firstly/langfuse-ruby/workflows/CI/badge.svg)](https://github.com/ai-firstly/langfuse-ruby/actions)
+[![CI](https://github.com/ai-firstly/langfuse-ruby/workflows/CI/badge.svg)](https://github.com/ai-firstly/langfuse-ruby/actions/workflows/ci.yml)
+[![Ruby](https://img.shields.io/badge/ruby-%3E%3D%202.7.0-red.svg)](https://www.ruby-lang.org/)
+[![License](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
 
 Ruby SDK for [Langfuse](https://langfuse.com) - the open-source LLM engineering platform. This SDK provides comprehensive tracing, prompt management, and evaluation capabilities for LLM applications.
 
@@ -80,6 +82,8 @@ generation = trace.generation(
 
 generation.end(output: 'Hello! How can I help you today?', usage: { prompt_tokens: 10, completion_tokens: 15, total_tokens: 25 })
 
+trace.update(output: 'Hello! How can I help you today?')
+
 # Flush events (optional - happens automatically)
 client.flush
 ```

data/langfuse-ruby.gemspec

@@ -41,8 +41,8 @@ Gem::Specification.new do |spec|
 
   # Dependencies
   spec.add_dependency 'concurrent-ruby', '~> 1.0'
-  spec.add_dependency 'faraday', '~> 2.0'
-  spec.add_dependency 'faraday-net_http', '~> 3.0'
+  spec.add_dependency 'faraday', '>= 1.8', '< 3.0'
+  spec.add_dependency 'faraday-net_http', '>= 1.0', '< 4.0'
   spec.add_dependency 'json', '~> 2.0'
 
   # Development dependencies

data/lib/langfuse/client.rb

@@ -188,7 +188,7 @@ module Langfuse
     def enqueue_event(type, body)
       # 验证事件类型是否有效
       valid_types = %w[
-        trace-create
+        trace-create trace-update
         generation-create generation-update
         span-create span-update
         event-create
@@ -207,7 +207,32 @@ module Langfuse
         body: Utils.deep_stringify_keys(body)
       }
 
-      @event_queue << event
+      if type == 'trace-update'
+        # 查找对应的 trace-create 事件并更新
+        trace_id = body['id'] || body[:id]
+        if trace_id
+          existing_event_index = @event_queue.find_index do |existing_event|
+            existing_event[:type] == 'trace-create' &&
+              (existing_event[:body]['id'] == trace_id || existing_event[:body][:id] == trace_id)
+          end
+
+          if existing_event_index
+            # 更新现有的 trace-create 事件
+            @event_queue[existing_event_index][:body].merge!(event[:body])
+            @event_queue[existing_event_index][:timestamp] = event[:timestamp]
+            puts "Updated existing trace-create event for trace_id: #{trace_id}" if @debug
+          else
+            # 如果没找到对应的 trace-create 事件，将 trace-update 转换为 trace-create
+            event[:type] = 'trace-create'
+            @event_queue << event
+            puts "Converted trace-update to trace-create for trace_id: #{trace_id}" if @debug
+          end
+        elsif @debug
+          puts 'Warning: trace-update event missing trace_id, skipping'
+        end
+      else
+        @event_queue << event
+      end
       puts "Enqueued event: #{type}" if @debug
     end
 

data/lib/langfuse/trace.rb

@@ -95,6 +95,23 @@ module Langfuse
       )
     end
 
+    def update(name: nil, user_id: nil, session_id: nil, version: nil,
+               release: nil, input: nil, output: nil, metadata: nil, tags: nil, **kwargs)
+      # 更新实例变量
+      @name = name if name
+      @user_id = user_id if user_id
+      @session_id = session_id if session_id
+      @version = version if version
+      @release = release if release
+      @input = input if input
+      @output = output if output
+      @metadata = metadata if metadata
+      @tags = tags if tags
+      @kwargs.merge!(kwargs) if kwargs.any?
+      # 触发 trace-update 事件
+      update_trace
+    end
+
     def get_url
       "#{@client.host}/trace/#{@id}"
     end
@@ -134,5 +151,23 @@ module Langfuse
 
       @client.enqueue_event('trace-create', data)
     end
+
+    def update_trace
+      data = {
+        id: @id,
+        name: @name,
+        user_id: @user_id,
+        session_id: @session_id,
+        version: @version,
+        release: @release,
+        input: @input,
+        output: @output,
+        metadata: @metadata,
+        tags: @tags,
+        timestamp: @timestamp
+      }.merge(@kwargs).compact
+
+      @client.enqueue_event('trace-update', data)
+    end
   end
 end

data/lib/langfuse/version.rb

@@ -1,3 +1,3 @@
 module Langfuse
-  VERSION = '0.1.3'
+  VERSION = '0.1.4'
 end

data/test_offline.rb

@@ -288,19 +288,45 @@ end
 # Test 11: Error handling
 puts "\n11. Testing error handling..."
 begin
-  # Test validation error
+  # Save current configuration
+  original_public_key = Langfuse.configuration.public_key
+  original_secret_key = Langfuse.configuration.secret_key
+
+  # Test authentication error - missing public key
   begin
-    Langfuse::Utils.validate_required_fields({ name: 'test' }, %i[name required_field])
-  rescue Langfuse::ValidationError => e
-    puts "✅ Validation error caught: #{e.message}"
+    Langfuse.configuration.public_key = nil
+    ENV.delete('LANGFUSE_PUBLIC_KEY')
+    Langfuse.new(public_key: nil, secret_key: 'secret')
+    puts '❌ Expected AuthenticationError but none was raised'
+  rescue Langfuse::AuthenticationError => e
+    puts "✅ Authentication error caught: #{e.message}"
+  ensure
+    Langfuse.configuration.public_key = original_public_key
   end
 
-  # Test authentication error
+  # Test authentication error - missing secret key
   begin
-    Langfuse.new(public_key: nil, secret_key: 'secret')
+    Langfuse.configuration.secret_key = nil
+    ENV.delete('LANGFUSE_SECRET_KEY')
+    Langfuse.new(public_key: 'public', secret_key: nil)
+    puts '❌ Expected AuthenticationError but none was raised'
   rescue Langfuse::AuthenticationError => e
     puts "✅ Authentication error caught: #{e.message}"
+  ensure
+    Langfuse.configuration.secret_key = original_secret_key
   end
+
+  # Test validation error through prompt template
+  begin
+    template = Langfuse::PromptTemplate.from_template('Hello {{name}}!')
+    # This should work fine
+    result = template.format(name: 'World')
+    puts "✅ Prompt template validation passed: #{result}"
+  rescue Langfuse::ValidationError => e
+    puts "✅ Validation error caught: #{e.message}"
+  end
+
+  puts '✅ Error handling tests completed'
 rescue StandardError => e
   puts "❌ Error handling failed: #{e.message}"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: langfuse-ruby
 version: !ruby/object:Gem::Version
-  version: 0.1.3
+  version: 0.1.4
 platform: ruby
 authors:
 - Richard Sun
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-07-13 00:00:00.000000000 Z
+date: 2025-07-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: concurrent-ruby
@@ -28,30 +28,42 @@ dependencies:
   name: faraday
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '2.0'
+        version: '1.8'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '3.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '2.0'
+        version: '1.8'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '3.0'
 - !ruby/object:Gem::Dependency
   name: faraday-net_http
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: '1.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '4.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: '1.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '4.0'
 - !ruby/object:Gem::Dependency
   name: json
   requirement: !ruby/object:Gem::Requirement
@@ -172,6 +184,7 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- ".github/workflows/ci.yml"
 - ".github/workflows/release.yml"
 - ".gitignore"
 - CHANGELOG.md