langfuse-ruby 0.1.4 → 0.1.5

data/lib/langfuse/trace.rb

@@ -24,9 +24,10 @@ module Langfuse
       create_trace
     end
 
+    # Create a child span with optional type
     def span(name: nil, start_time: nil, end_time: nil, input: nil, output: nil,
              metadata: nil, level: nil, status_message: nil, parent_observation_id: nil,
-             version: nil, **kwargs)
+             version: nil, as_type: nil, **kwargs)
       @client.span(
         trace_id: @id,
         name: name,
@@ -39,10 +40,12 @@ module Langfuse
         status_message: status_message,
         parent_observation_id: parent_observation_id,
         version: version,
+        as_type: as_type,
         **kwargs
       )
     end
 
+    # Create a child generation
     def generation(name: nil, start_time: nil, end_time: nil, completion_start_time: nil,
                    model: nil, model_parameters: nil, input: nil, output: nil, usage: nil,
                    metadata: nil, level: nil, status_message: nil, parent_observation_id: nil,
@@ -67,6 +70,7 @@ module Langfuse
       )
     end
 
+    # Create a child event
     def event(name:, start_time: nil, input: nil, output: nil, metadata: nil,
               level: nil, status_message: nil, parent_observation_id: nil, version: nil, **kwargs)
       @client.event(
@@ -84,6 +88,151 @@ module Langfuse
       )
     end
 
+    # Convenience methods for enhanced observation types
+
+    # Create a child agent observation
+    def agent(name: nil, start_time: nil, end_time: nil, input: nil, output: nil,
+              metadata: nil, level: nil, status_message: nil, parent_observation_id: nil,
+              version: nil, **kwargs)
+      span(
+        name: name,
+        start_time: start_time,
+        end_time: end_time,
+        input: input,
+        output: output,
+        metadata: metadata,
+        level: level,
+        status_message: status_message,
+        parent_observation_id: parent_observation_id,
+        version: version,
+        as_type: ObservationType::AGENT,
+        **kwargs
+      )
+    end
+
+    # Create a child tool observation
+    def tool(name: nil, start_time: nil, end_time: nil, input: nil, output: nil,
+             metadata: nil, level: nil, status_message: nil, parent_observation_id: nil,
+             version: nil, **kwargs)
+      span(
+        name: name,
+        start_time: start_time,
+        end_time: end_time,
+        input: input,
+        output: output,
+        metadata: metadata,
+        level: level,
+        status_message: status_message,
+        parent_observation_id: parent_observation_id,
+        version: version,
+        as_type: ObservationType::TOOL,
+        **kwargs
+      )
+    end
+
+    # Create a child chain observation
+    def chain(name: nil, start_time: nil, end_time: nil, input: nil, output: nil,
+              metadata: nil, level: nil, status_message: nil, parent_observation_id: nil,
+              version: nil, **kwargs)
+      span(
+        name: name,
+        start_time: start_time,
+        end_time: end_time,
+        input: input,
+        output: output,
+        metadata: metadata,
+        level: level,
+        status_message: status_message,
+        parent_observation_id: parent_observation_id,
+        version: version,
+        as_type: ObservationType::CHAIN,
+        **kwargs
+      )
+    end
+
+    # Create a child retriever observation
+    def retriever(name: nil, start_time: nil, end_time: nil, input: nil, output: nil,
+                  metadata: nil, level: nil, status_message: nil, parent_observation_id: nil,
+                  version: nil, **kwargs)
+      span(
+        name: name,
+        start_time: start_time,
+        end_time: end_time,
+        input: input,
+        output: output,
+        metadata: metadata,
+        level: level,
+        status_message: status_message,
+        parent_observation_id: parent_observation_id,
+        version: version,
+        as_type: ObservationType::RETRIEVER,
+        **kwargs
+      )
+    end
+
+    # Create a child embedding observation
+    def embedding(name: nil, start_time: nil, end_time: nil, input: nil, output: nil,
+                  model: nil, usage: nil, metadata: nil, level: nil, status_message: nil,
+                  parent_observation_id: nil, version: nil, **kwargs)
+      merged_metadata = (metadata || {}).merge(
+        { model: model, usage: usage }.compact
+      )
+      span(
+        name: name,
+        start_time: start_time,
+        end_time: end_time,
+        input: input,
+        output: output,
+        metadata: merged_metadata.empty? ? nil : merged_metadata,
+        level: level,
+        status_message: status_message,
+        parent_observation_id: parent_observation_id,
+        version: version,
+        as_type: ObservationType::EMBEDDING,
+        **kwargs
+      )
+    end
+
+    # Create a child evaluator observation
+    def evaluator(name: nil, start_time: nil, end_time: nil, input: nil, output: nil,
+                  metadata: nil, level: nil, status_message: nil, parent_observation_id: nil,
+                  version: nil, **kwargs)
+      span(
+        name: name,
+        start_time: start_time,
+        end_time: end_time,
+        input: input,
+        output: output,
+        metadata: metadata,
+        level: level,
+        status_message: status_message,
+        parent_observation_id: parent_observation_id,
+        version: version,
+        as_type: ObservationType::EVALUATOR,
+        **kwargs
+      )
+    end
+
+    # Create a child guardrail observation
+    def guardrail(name: nil, start_time: nil, end_time: nil, input: nil, output: nil,
+                  metadata: nil, level: nil, status_message: nil, parent_observation_id: nil,
+                  version: nil, **kwargs)
+      span(
+        name: name,
+        start_time: start_time,
+        end_time: end_time,
+        input: input,
+        output: output,
+        metadata: metadata,
+        level: level,
+        status_message: status_message,
+        parent_observation_id: parent_observation_id,
+        version: version,
+        as_type: ObservationType::GUARDRAIL,
+        **kwargs
+      )
+    end
+
     def score(name:, value:, data_type: nil, comment: nil, **kwargs)
       @client.score(
         trace_id: @id,

data/lib/langfuse/utils.rb

@@ -1,5 +1,6 @@
 require 'securerandom'
 require 'time'
+require 'erb'
 
 module Langfuse
   module Utils
@@ -12,6 +13,10 @@ module Langfuse
         Time.now.utc.iso8601(3)
       end
 
+      def url_encode(string)
+        ERB::Util.url_encode(string.to_s)
+      end
+
       def deep_symbolize_keys(hash)
         return hash unless hash.is_a?(Hash)
 

data/lib/langfuse/version.rb

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

data/lib/langfuse.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require_relative 'langfuse/version'
+require_relative 'langfuse/observation_types'
 require_relative 'langfuse/client'
 require_relative 'langfuse/trace'
 require_relative 'langfuse/span'

data/test_offline.rb

@@ -209,8 +209,8 @@ begin
     user_id: 'user-456',
     session_id: 'session-789',
     input: { query: 'Explain quantum computing' },
+    environment: 'test',
     metadata: {
-      environment: 'test',
       version: '1.0.0',
       tags: %w[physics computing]
     }

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: langfuse-ruby
 version: !ruby/object:Gem::Version
-  version: 0.1.4
+  version: 0.1.5
 platform: ruby
 authors:
 - Richard Sun
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-07-29 00:00:00.000000000 Z
+date: 2025-12-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: concurrent-ruby
@@ -64,6 +64,20 @@ dependencies:
     - - "<"
       - !ruby/object:Gem::Version
         version: '4.0'
+- !ruby/object:Gem::Dependency
+  name: faraday-multipart
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
 - !ruby/object:Gem::Dependency
   name: json
   requirement: !ruby/object:Gem::Requirement
@@ -198,11 +212,13 @@ files:
 - docs/README.md
 - docs/RELEASE_CHECKLIST.md
 - docs/TYPE_VALIDATION_TROUBLESHOOTING.md
+- docs/URL_ENCODING_FIX.md
 - examples/auto_flush_control.rb
 - examples/basic_tracing.rb
 - examples/connection_config_demo.rb
 - examples/event_usage.rb
 - examples/prompt_management.rb
+- examples/url_encoding_demo.rb
 - langfuse-ruby.gemspec
 - lib/langfuse.rb
 - lib/langfuse/client.rb
@@ -210,6 +226,7 @@ files:
 - lib/langfuse/evaluation.rb
 - lib/langfuse/event.rb
 - lib/langfuse/generation.rb
+- lib/langfuse/observation_types.rb
 - lib/langfuse/prompt.rb
 - lib/langfuse/span.rb
 - lib/langfuse/trace.rb
@@ -236,7 +253,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.7.0
+      version: 3.1.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="