dspy 0.24.1 → 0.25.0

data/lib/dspy/utils/serialization.rb

@@ -0,0 +1,35 @@
+# typed: strict
+# frozen_string_literal: true
+
+module DSPy
+  module Utils
+    class Serialization
+      extend T::Sig
+
+      # Deep serializes any T::Struct objects to hashes for observability
+      sig { params(obj: T.untyped).returns(T.untyped) }
+      def self.deep_serialize(obj)
+        case obj
+        when T::Struct
+          # Use the serialize method to convert to a plain hash
+          deep_serialize(obj.serialize)
+        when Hash
+          # Recursively serialize hash values
+          obj.transform_values { |v| deep_serialize(v) }
+        when Array
+          # Recursively serialize array elements
+          obj.map { |v| deep_serialize(v) }
+        else
+          # Return primitive values as-is
+          obj
+        end
+      end
+
+      # Serializes an object to JSON with proper T::Struct handling
+      sig { params(obj: T.untyped).returns(String) }
+      def self.to_json(obj)
+        deep_serialize(obj).to_json
+      end
+    end
+  end
+end

data/lib/dspy/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module DSPy
-  VERSION = "0.24.1"
+  VERSION = "0.25.0"
 end

data/lib/dspy.rb

@@ -14,10 +14,10 @@ require_relative 'dspy/events/types'
 
 module DSPy
   extend Dry::Configurable
-  
+
   setting :lm
   setting :logger, default: Dry.Logger(:dspy, formatter: :string)
-  
+
   # Structured output configuration for LLM providers
   setting :structured_outputs do
     setting :openai, default: false
@@ -27,7 +27,7 @@ module DSPy
     setting :max_retries, default: 3
     setting :fallback_enabled, default: true
   end
-  
+
   # Test mode disables sleeps in retry logic
   setting :test_mode, default: false
 
@@ -35,14 +35,13 @@ module DSPy
     @logger ||= create_logger
   end
 
-  def self.log(event, **attributes)
+  def self.log(event_name, **attributes)
     # Return nil early if logger is not configured (backward compatibility)
     return nil unless logger
-    
-    # Forward to event system - this maintains backward compatibility
-    # while providing all new event system benefits
-    event(event, attributes)
-    
+
+    # Direct logging - simple and straightforward
+    emit_log(event_name, attributes)
+
     # Return nil to maintain backward compatibility
     nil
   end
@@ -53,7 +52,7 @@ module DSPy
       event_obj = event_name_or_object
       event_name = event_obj.name
       attributes = event_obj.to_attributes
-      
+
       # For LLM events, use OpenTelemetry semantic conventions for spans
       if event_obj.is_a?(DSPy::Events::LLMEvent)
         otel_attributes = event_obj.to_otel_attributes
@@ -65,44 +64,50 @@ module DSPy
       # Handle string event names (backward compatibility)
       event_name = event_name_or_object
       raise ArgumentError, "Event name cannot be nil" if event_name.nil?
-      
+
       # Handle nil attributes
       attributes = {} if attributes.nil?
-      
+
       # Create OpenTelemetry span for the event if observability is enabled
       create_event_span(event_name, attributes)
     end
-    
+
     # Perform the actual logging (original DSPy.log behavior)
-    emit_log(event_name, attributes)
-    
+    # emit_log(event_name, attributes)
+
     # Notify event listeners
     events.notify(event_name, attributes)
   end
 
   def self.events
-    @event_registry ||= DSPy::EventRegistry.new
+    @event_registry ||= DSPy::EventRegistry.new.tap do |registry|
+      # Subscribe logger to all events - use a proc that calls logger each time
+      # to support mocking in tests
+      registry.subscribe('*') { |event_name, attributes| 
+        emit_log(event_name, attributes) if logger
+      }
+    end
   end
 
   private
 
   def self.emit_log(event_name, attributes)
     return unless logger
-    
+
     # Merge context automatically (but don't include span_stack)
     context = Context.current.dup
     context.delete(:span_stack)
     attributes = context.merge(attributes)
     attributes[:event] = event_name
-    
+
     # Use Dry::Logger's structured logging
     logger.info(attributes)
   end
 
   # Internal events that should not create OpenTelemetry spans
   INTERNAL_EVENTS = [
-    'span.start', 
-    'span.end', 
+    'span.start',
+    'span.end',
     'span.attributes',
     'observability.disabled',
     'observability.error',
@@ -114,11 +119,11 @@ module DSPy
   def self.create_event_span(event_name, attributes)
     return unless DSPy::Observability.enabled?
     return if INTERNAL_EVENTS.include?(event_name)
-    
+
     begin
       # Flatten nested hashes for OpenTelemetry span attributes
       flattened_attributes = flatten_attributes(attributes)
-      
+
       # Create and immediately finish a span for this event
       # Events are instant moments in time, not ongoing operations
       span = DSPy::Observability.start_span(event_name, flattened_attributes)
@@ -137,21 +142,21 @@ module DSPy
   def self.flatten_attributes(attributes, parent_key = '', result = {})
     attributes.each do |key, value|
       new_key = parent_key.empty? ? key.to_s : "#{parent_key}.#{key}"
-      
+
       if value.is_a?(Hash)
         flatten_attributes(value, new_key, result)
       else
         result[new_key] = value
       end
     end
-    
+
     result
   end
 
   def self.create_logger
     env = ENV['RACK_ENV'] || ENV['RAILS_ENV'] || 'development'
     log_output = ENV['DSPY_LOG'] # Allow override
-    
+
     case env
     when 'test'
       # Test: key=value format to log/test.log (or override)

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: dspy
 version: !ruby/object:Gem::Version
-  version: 0.24.1
+  version: 0.25.0
 platform: ruby
 authors:
 - Vicente Reig Rincón de Arellano
 bindir: bin
 cert_chain: []
-date: 2025-09-05 00:00:00.000000000 Z
+date: 2025-09-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: dry-configurable
@@ -43,14 +43,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.23'
+        version: '2.29'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.23'
+        version: '2.29'
 - !ruby/object:Gem::Dependency
   name: openai
   requirement: !ruby/object:Gem::Requirement
@@ -238,6 +238,7 @@ files:
 - lib/dspy/mixins/type_coercion.rb
 - lib/dspy/module.rb
 - lib/dspy/observability.rb
+- lib/dspy/observability/async_span_processor.rb
 - lib/dspy/predict.rb
 - lib/dspy/prediction.rb
 - lib/dspy/prompt.rb
@@ -262,6 +263,7 @@ files:
 - lib/dspy/tools/text_processing_toolset.rb
 - lib/dspy/tools/toolset.rb
 - lib/dspy/type_serializer.rb
+- lib/dspy/utils/serialization.rb
 - lib/dspy/version.rb
 homepage: https://github.com/vicentereig/dspy.rb
 licenses: