dspy 0.3.0 → 0.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8053438ba1e55a093c35b50b9dc3b106b0c158ce426c6f286ba7f62aeee8161d
-  data.tar.gz: 456ca182c45f1924caa6eeea6c86debba28a77ba127c6326014b1a468e07c445
+  metadata.gz: 64e8b7011ea06273772d2ef8a985d61aa1ee30d5d6fb3c559dc22ed81e345b16
+  data.tar.gz: a16fab394ee1db1bcaddc0baaa3636590a2ca00c1ce60eb7dc1a00355750009f
 SHA512:
-  metadata.gz: 67c31136acd1ef0a01c49938b3f142abf3690264ac048969e342a750dce80b59b16b258efc4ee6385fb55fb7580e18ac9f87aeb7fb09631cfb0fb139debb4f52
-  data.tar.gz: 94214ff9fdd61ea1d478abf9d8da37325d884e8238b01e7bd50cdb3bd21fcfcfaf2c0c6b3509241f0bff3e730587e770588c9f262206f1ca1bc809724e553b31
+  metadata.gz: ce4ab780cce89c2c3680e6c5703e853bbd901ac206993af1cd0660cc25e9796ef1dd5adb488d575bbc97ea75a71b563e82eb4cc521b5c84291ff9b1e106216e1
+  data.tar.gz: be313a08f282eb7a08638879298742baf5ec26bcb48b946ac068892c2ad542003d99df575ecc85bb5220c637368f02adf042164831cf5d48fd7139bb3f5424a7

data/README.md

@@ -380,16 +380,6 @@ DSPy.rb includes built-in instrumentation that captures detailed events and
 performance metrics from your LLM operations. Perfect for monitoring your 
 applications and integrating with observability tools.
 
-### Quick Setup
-
-Enable instrumentation to start capturing events:
-
-```ruby
-DSPy::Instrumentation.configure do |config|
-  config.enabled = true
-end
-```
-
 ### Available Events
 
 Subscribe to these events to monitor different aspects of your LLM operations:
@@ -449,26 +439,6 @@ giving you precise cost tracking:
 }
 ```
 
-### Configuration Options
-
-```ruby
-DSPy::Instrumentation.configure do |config|
-  config.enabled = true
-  config.log_to_stdout = false
-  config.log_file = 'log/dspy.log'
-  config.log_level = :info
-  
-  # Custom payload enrichment
-  config.custom_options = lambda do |event|
-    {
-      timestamp: Time.current.iso8601,
-      hostname: Socket.gethostname,
-      request_id: Thread.current[:request_id]
-    }
-  end
-end
-```
-
 ### Integration with Monitoring Tools
 
 Subscribe to events for custom processing:

data/lib/dspy/instrumentation.rb

@@ -7,6 +7,13 @@ module DSPy
   # Core instrumentation module using dry-monitor for event emission
   # Provides extension points for logging, Langfuse, New Relic, and custom monitoring
   module Instrumentation
+    # Get the current logger subscriber instance (lazy initialization)
+    def self.logger_subscriber
+      @logger_subscriber ||= begin
+        require_relative 'subscribers/logger_subscriber'
+        DSPy::Subscribers::LoggerSubscriber.new
+      end
+    end
 
     def self.notifications
       @notifications ||= Dry::Monitor::Notifications.new(:dspy).tap do |n|
@@ -94,7 +101,13 @@ module DSPy
     end
 
     def self.emit_event(event_name, payload)
+      # Ensure logger subscriber is initialized
+      logger_subscriber
       notifications.instrument(event_name, payload)
     end
+
+    def self.setup_subscribers
+      # Lazy initialization - will be created when first accessed
+    end
   end
 end

data/lib/dspy/subscribers/logger_subscriber.rb

@@ -7,14 +7,20 @@ module DSPy
     class LoggerSubscriber
       extend T::Sig
 
-      sig { params(logger: T.nilable(Logger)).void }
+      sig { params(logger: T.nilable(T.any(Logger, Dry::Logger::Dispatcher))).void }
       def initialize(logger: nil)
-        @logger = T.let(logger || DSPy.config.logger, Logger)
+        @explicit_logger = T.let(logger, T.nilable(T.any(Logger, Dry::Logger::Dispatcher)))
         setup_event_subscriptions
       end
 
       private
 
+      # Always use the current configured logger or the explicit one
+      sig { returns(T.any(Logger, Dry::Logger::Dispatcher)) }
+      def logger
+        @explicit_logger || DSPy.config.logger
+      end
+
       sig { void }
       def setup_event_subscriptions
         # Subscribe to DSPy instrumentation events
@@ -82,18 +88,19 @@ module DSPy
         model = payload[:gen_ai_request_model] || payload[:model]
         duration = payload[:duration_ms]&.round(2)
         status = payload[:status]
-        tokens = if payload[:tokens_total]
-                   " (#{payload[:tokens_total]} tokens)"
-                 else
-                   ""
-                 end
-
-        status_emoji = status == 'success' ? '✅' : '❌'
-        @logger.info("#{status_emoji} LM Request [#{provider}/#{model}] - #{status} (#{duration}ms)#{tokens}")
-        
-        if status == 'error' && payload[:error_message]
-          @logger.error("  Error: #{payload[:error_message]}")
-        end
+        tokens = payload[:tokens_total]
+
+        log_parts = [
+          "event=lm_request",
+          "provider=#{provider}",
+          "model=#{model}",
+          "status=#{status}",
+          "duration_ms=#{duration}"
+        ]
+        log_parts << "tokens=#{tokens}" if tokens
+        log_parts << "error=\"#{payload[:error_message]}\"" if status == 'error' && payload[:error_message]
+
+        logger.info(log_parts.join(' '))
       end
 
       sig { params(event: T.untyped).void }
@@ -104,13 +111,16 @@ module DSPy
         status = payload[:status]
         input_size = payload[:input_size]
 
-        status_emoji = status == 'success' ? '🔮' : '❌'
-        @logger.info("#{status_emoji} Prediction [#{signature}] - #{status} (#{duration}ms)")
-        @logger.info("  Input size: #{input_size} chars") if input_size
-        
-        if status == 'error' && payload[:error_message]
-          @logger.error("  Error: #{payload[:error_message]}")
-        end
+        log_parts = [
+          "event=prediction",
+          "signature=#{signature}",
+          "status=#{status}",
+          "duration_ms=#{duration}"
+        ]
+        log_parts << "input_size=#{input_size}" if input_size
+        log_parts << "error=\"#{payload[:error_message]}\"" if status == 'error' && payload[:error_message]
+
+        logger.info(log_parts.join(' '))
       end
 
       sig { params(event: T.untyped).void }
@@ -122,14 +132,17 @@ module DSPy
         reasoning_steps = payload[:reasoning_steps]
         reasoning_length = payload[:reasoning_length]
 
-        status_emoji = status == 'success' ? '🧠' : '❌'
-        @logger.info("#{status_emoji} Chain of Thought [#{signature}] - #{status} (#{duration}ms)")
-        @logger.info("  Reasoning steps: #{reasoning_steps}") if reasoning_steps
-        @logger.info("  Reasoning length: #{reasoning_length} chars") if reasoning_length
-        
-        if status == 'error' && payload[:error_message]
-          @logger.error("  Error: #{payload[:error_message]}")
-        end
+        log_parts = [
+          "event=chain_of_thought",
+          "signature=#{signature}",
+          "status=#{status}",
+          "duration_ms=#{duration}"
+        ]
+        log_parts << "reasoning_steps=#{reasoning_steps}" if reasoning_steps
+        log_parts << "reasoning_length=#{reasoning_length}" if reasoning_length
+        log_parts << "error=\"#{payload[:error_message]}\"" if status == 'error' && payload[:error_message]
+
+        logger.info(log_parts.join(' '))
       end
 
       sig { params(event: T.untyped).void }
@@ -142,20 +155,18 @@ module DSPy
         tools_used = payload[:tools_used]
         final_answer = payload[:final_answer]
 
-        status_emoji = case status
-                       when 'success' then '🤖'
-                       when 'max_iterations' then '⏰'
-                       else '❌'
-                       end
-        
-        @logger.info("#{status_emoji} ReAct Agent [#{signature}] - #{status} (#{duration}ms)")
-        @logger.info("  Iterations: #{iteration_count}") if iteration_count
-        @logger.info("  Tools used: #{tools_used.join(', ')}") if tools_used&.any?
-        @logger.info("  Final answer: #{final_answer}") if final_answer
-        
-        if status == 'error' && payload[:error_message]
-          @logger.error("  Error: #{payload[:error_message]}")
-        end
+        log_parts = [
+          "event=react",
+          "signature=#{signature}",
+          "status=#{status}",
+          "duration_ms=#{duration}"
+        ]
+        log_parts << "iterations=#{iteration_count}" if iteration_count
+        log_parts << "tools_used=\"#{tools_used.join(',')}\"" if tools_used&.any?
+        log_parts << "final_answer=\"#{final_answer&.truncate(100)}\"" if final_answer
+        log_parts << "error=\"#{payload[:error_message]}\"" if status == 'error' && payload[:error_message]
+
+        logger.info(log_parts.join(' '))
       end
 
       sig { params(event: T.untyped).void }
@@ -167,14 +178,17 @@ module DSPy
         duration = payload[:duration_ms]&.round(2)
         status = payload[:status]
 
-        status_emoji = status == 'success' ? '🔄' : '❌'
-        @logger.info("#{status_emoji} ReAct Iteration #{iteration} - #{status} (#{duration}ms)")
-        @logger.info("  Thought: #{thought.truncate(100)}") if thought
-        @logger.info("  Action: #{action}") if action
-        
-        if status == 'error' && payload[:error_message]
-          @logger.error("  Error: #{payload[:error_message]}")
-        end
+        log_parts = [
+          "event=react_iteration",
+          "iteration=#{iteration}",
+          "status=#{status}",
+          "duration_ms=#{duration}"
+        ]
+        log_parts << "thought=\"#{thought&.truncate(100)}\"" if thought
+        log_parts << "action=\"#{action}\"" if action
+        log_parts << "error=\"#{payload[:error_message]}\"" if status == 'error' && payload[:error_message]
+
+        logger.info(log_parts.join(' '))
       end
 
       sig { params(event: T.untyped).void }
@@ -185,12 +199,16 @@ module DSPy
         duration = payload[:duration_ms]&.round(2)
         status = payload[:status]
 
-        status_emoji = status == 'success' ? '🔧' : '❌'
-        @logger.info("#{status_emoji} Tool Call [#{tool_name}] (Iteration #{iteration}) - #{status} (#{duration}ms)")
-        
-        if status == 'error' && payload[:error_message]
-          @logger.error("  Error: #{payload[:error_message]}")
-        end
+        log_parts = [
+          "event=tool_call",
+          "tool=#{tool_name}",
+          "iteration=#{iteration}",
+          "status=#{status}",
+          "duration_ms=#{duration}"
+        ]
+        log_parts << "error=\"#{payload[:error_message]}\"" if status == 'error' && payload[:error_message]
+
+        logger.info(log_parts.join(' '))
       end
     end
   end

data/lib/dspy.rb

@@ -11,23 +11,6 @@ module DSPy
   def self.logger
     config.logger
   end
-
-  # Convenient instrumentation configuration
-  def self.configure_instrumentation(&block)
-    require_relative 'dspy/instrumentation'
-    require_relative 'dspy/instrumentation/dry_monitor_bridge'
-    
-    Instrumentation.configure(&block)
-    
-    # Setup dry-monitor bridge for HTTP instrumentation
-    if Instrumentation.config.enabled
-      Instrumentation::DryMonitorBridge.setup!
-      
-      # Auto-enable logger subscriber for event-based logging
-      require_relative 'dspy/subscribers/logger_subscriber'
-      @logger_subscriber ||= Subscribers::LoggerSubscriber.new
-    end
-  end
 end
 
 require_relative 'dspy/module'
@@ -39,3 +22,6 @@ require_relative 'dspy/chain_of_thought'
 require_relative 'dspy/re_act'
 require_relative 'dspy/subscribers/logger_subscriber'
 require_relative 'dspy/tools'
+require_relative 'dspy/instrumentation'
+
+# LoggerSubscriber will be lazy-initialized when first accessed

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: dspy
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.3.1
 platform: ruby
 authors:
 - Vicente Reig Rincón de Arellano