langfuse-ruby 0.2.0 → 0.2.1

data/lib/langfuse.rb

@@ -2,12 +2,16 @@
 
 require_relative 'langfuse/version'
 require_relative 'langfuse/observation_types'
+require_relative 'langfuse/span_wrappers'
+require_relative 'langfuse/partial_updates'
+require_relative 'langfuse/template_compiler'
 require_relative 'langfuse/client'
 require_relative 'langfuse/trace'
 require_relative 'langfuse/span'
 require_relative 'langfuse/generation'
 require_relative 'langfuse/event'
 require_relative 'langfuse/prompt'
+require_relative 'langfuse/prompt_cache'
 require_relative 'langfuse/evaluation'
 require_relative 'langfuse/errors'
 require_relative 'langfuse/utils'
@@ -47,29 +51,23 @@ module Langfuse
     # @param cache_ttl_seconds [Integer] cache TTL in seconds (default: 60)
     # @param retries [Integer] number of retries on failure (default: 2)
     # @return [String, Prompt, nil] compiled prompt string if variables provided, Prompt object otherwise, nil on failure
+    # `retries` is applied inside the HTTP layer, which retries only transient
+    # failures (timeout, network, 429, 5xx), honors Retry-After and backs off with
+    # jitter. A missing prompt therefore fails immediately instead of being
+    # requested three times.
     def get_prompt(prompt_name, variables: nil, label: nil, version: nil, cache_ttl_seconds: 60, retries: 2)
-      attempts = 0
-
-      begin
-        attempts += 1
-        prompt = client.get_prompt(prompt_name, label: label, version: version, cache_ttl_seconds: cache_ttl_seconds)
-
-        if variables
-          prompt.compile(variables)
-        else
-          prompt
-        end
-      rescue StandardError => e
-        if attempts <= retries
-          sleep_time = (2**(attempts - 1)) * 0.1 # Exponential backoff: 0.1s, 0.2s, 0.4s...
-          warn "Langfuse prompt fetch failed (#{prompt_name}), retrying in #{sleep_time}s... (attempt #{attempts}/#{retries + 1})" if configuration.debug
-          sleep(sleep_time)
-          retry
-        end
+      prompt = client.get_prompt(
+        prompt_name,
+        label: label,
+        version: version,
+        cache_ttl_seconds: cache_ttl_seconds,
+        retries: retries
+      )
 
-        warn "Langfuse prompt fetch failed (#{prompt_name}): #{e.message}" if configuration.debug
-        nil
-      end
+      variables ? prompt.compile(variables) : prompt
+    rescue StandardError => e
+      warn "Langfuse prompt fetch failed (#{prompt_name}): #{e.message}" if configuration.debug
+      nil
     end
 
     # Create a trace and optionally execute a block with it
@@ -103,38 +101,34 @@ module Langfuse
     #
     def trace(name = nil, user_id: nil, session_id: nil, input: nil, output: nil,
               metadata: nil, tags: nil, version: nil, release: nil, **kwargs)
-      trace = client.trace(
-        name: name,
-        user_id: user_id,
-        session_id: session_id,
-        input: input,
-        output: output,
-        metadata: metadata,
-        tags: tags,
-        version: version,
-        release: release,
-        **kwargs
-      )
-
-      if block_given?
+      # Only trace creation degrades to a NullTrace. An exception raised by the
+      # block must propagate: rescuing it here and yielding again would run the
+      # caller's block a second time (duplicate LLM calls and billing).
+      trace =
         begin
-          result = yield(trace)
-          result
-        ensure
-          flush
+          client.trace(
+            name: name,
+            user_id: user_id,
+            session_id: session_id,
+            input: input,
+            output: output,
+            metadata: metadata,
+            tags: tags,
+            version: version,
+            release: release,
+            **kwargs
+          )
+        rescue StandardError => e
+          warn "Langfuse trace creation failed: #{e.message}" if configuration.debug
+          NullTrace.new
         end
-      else
-        trace
-      end
-    rescue StandardError => e
-      warn "Langfuse trace creation failed: #{e.message}" if configuration.debug
-
-      # If block given, execute with NullTrace to ensure code continues
-      if block_given?
-        null_trace = NullTrace.new
-        yield(null_trace)
-      else
-        NullTrace.new
+
+      return trace unless block_given?
+
+      begin
+        yield(trace)
+      ensure
+        flush
       end
     end
 
@@ -161,7 +155,8 @@ module Langfuse
   # Configuration class for Langfuse client settings
   class Configuration
     attr_accessor :public_key, :secret_key, :host, :debug, :timeout, :retries, :flush_interval, :auto_flush,
-                  :ingestion_mode, :environment, :sample_rate, :mask, :flush_at, :logger, :shutdown_on_exit
+                  :ingestion_mode, :environment, :sample_rate, :mask, :flush_at, :max_queue_size, :logger,
+                  :shutdown_on_exit, :http_adapter
 
     def initialize
       @public_key = nil
@@ -177,8 +172,10 @@ module Langfuse
       @sample_rate = nil       # 0.0..1.0, nil disables sampling
       @mask = nil              # callable applied to input/output/metadata before sending
       @flush_at = 15           # flush as soon as this many events are queued
+      @max_queue_size = 10_000 # queue cap; the oldest events are dropped when full
       @logger = nil            # custom Logger instance
       @shutdown_on_exit = true # register an at_exit hook that flushes pending events
+      @http_adapter = nil      # Faraday adapter, e.g. :net_http_persistent for keep-alive
     end
   end
 end

data/scripts/release.sh

@@ -49,31 +49,31 @@ if ! bundle exec rspec; then
 fi
 
 print_status "Running offline tests..."
-if ! ruby scripts/test_offline.rb; then
+if ! bundle exec ruby scripts/test_offline.rb; then
     print_error "Offline tests failed. Please fix them before releasing."
     exit 1
 fi
 
 # Build gem
 print_status "Building gem..."
-if ! gem build langfuse.gemspec; then
+if ! gem build langfuse-ruby.gemspec; then
     print_error "Gem build failed."
     exit 1
 fi
 
 # Check if gem was built successfully
-if [ ! -f "langfuse-${CURRENT_VERSION}.gem" ]; then
-    print_error "Gem file not found: langfuse-${CURRENT_VERSION}.gem"
+if [ ! -f "langfuse-ruby-${CURRENT_VERSION}.gem" ]; then
+    print_error "Gem file not found: langfuse-ruby-${CURRENT_VERSION}.gem"
     exit 1
 fi
 
-print_status "Gem built successfully: langfuse-${CURRENT_VERSION}.gem"
+print_status "Gem built successfully: langfuse-ruby-${CURRENT_VERSION}.gem"
 
 # Ask for confirmation
 echo
 echo "📋 Release Summary:"
 echo "  Version: $CURRENT_VERSION"
-echo "  Gem file: langfuse-${CURRENT_VERSION}.gem"
+echo "  Gem file: langfuse-ruby-${CURRENT_VERSION}.gem"
 echo "  Tests: ✅ Passed"
 echo
 
@@ -81,7 +81,7 @@ read -p "Do you want to proceed with the release? (y/N): " -n 1 -r
 echo
 if [[ ! $REPLY =~ ^[Yy]$ ]]; then
     print_warning "Release cancelled."
-    rm -f "langfuse-${CURRENT_VERSION}.gem"
+    rm -f "langfuse-ruby-${CURRENT_VERSION}.gem"
     exit 0
 fi
 
@@ -91,12 +91,12 @@ git tag "v${CURRENT_VERSION}"
 
 # Push to git
 print_status "Pushing to git..."
-git push origin main
+git push origin master
 git push origin "v${CURRENT_VERSION}"
 
 # Publish to RubyGems
 print_status "Publishing to RubyGems..."
-if gem push "langfuse-${CURRENT_VERSION}.gem"; then
+if gem push "langfuse-ruby-${CURRENT_VERSION}.gem"; then
     print_status "Successfully published to RubyGems!"
 else
     print_error "Failed to publish to RubyGems."
@@ -105,16 +105,16 @@ else
 fi
 
 # Clean up
-rm -f "langfuse-${CURRENT_VERSION}.gem"
+rm -f "langfuse-ruby-${CURRENT_VERSION}.gem"
 
 print_status "Release completed successfully! 🎉"
 echo
 echo "📝 Next steps:"
-echo "  1. Check https://rubygems.org/gems/langfuse"
+echo "  1. Check https://rubygems.org/gems/langfuse-ruby"
 echo "  2. Update documentation if needed"
 echo "  3. Announce the release"
 echo
 echo "🔗 Useful links:"
-echo "  - RubyGems: https://rubygems.org/gems/langfuse"
+echo "  - RubyGems: https://rubygems.org/gems/langfuse-ruby"
 echo "  - GitHub: https://github.com/ai-firstly/langfuse-ruby"
 echo "  - Documentation: https://github.com/ai-firstly/langfuse-ruby#readme" 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: langfuse-ruby
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.2.1
 platform: ruby
 authors:
 - Richard Sun
@@ -242,6 +242,7 @@ files:
 - docs/PUBLISH_GUIDE.md
 - docs/README.md
 - docs/RELEASE_CHECKLIST.md
+- docs/V4.md
 - examples/auto_flush_control.rb
 - examples/basic_tracing.rb
 - examples/connection_config_demo.rb
@@ -249,6 +250,7 @@ files:
 - examples/prompt_management.rb
 - examples/simplified_usage.rb
 - examples/url_encoding_demo.rb
+- examples/v4_otel_tracing.rb
 - langfuse-ruby.gemspec
 - lib/langfuse.rb
 - lib/langfuse/client.rb
@@ -259,8 +261,12 @@ files:
 - lib/langfuse/null_objects.rb
 - lib/langfuse/observation_types.rb
 - lib/langfuse/otel_exporter.rb
+- lib/langfuse/partial_updates.rb
 - lib/langfuse/prompt.rb
+- lib/langfuse/prompt_cache.rb
 - lib/langfuse/span.rb
+- lib/langfuse/span_wrappers.rb
+- lib/langfuse/template_compiler.rb
 - lib/langfuse/trace.rb
 - lib/langfuse/utils.rb
 - lib/langfuse/version.rb
@@ -292,7 +298,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.16
+rubygems_version: 4.0.20
 specification_version: 4
 summary: Ruby SDK for Langfuse - Open source LLM engineering platform
 test_files: []