dspy 0.4.0 → 0.5.0

data/lib/dspy.rb

@@ -2,17 +2,106 @@
 require 'sorbet-runtime'
 require 'dry-configurable'
 require 'dry/logger'
+require 'securerandom'
 
 require_relative 'dspy/version'
 
 module DSPy
   extend Dry::Configurable
+
+  # Timestamp format options for instrumentation events
+  class TimestampFormat < T::Enum
+    enums do
+      ISO8601 = new('iso8601')
+      RFC3339_NANO = new('rfc3339_nano')
+      UNIX_NANO = new('unix_nano')
+    end
+  end
+  
   setting :lm
   setting :logger, default: Dry.Logger(:dspy, formatter: :string)
+  
+  # Nested instrumentation configuration using proper dry-configurable syntax
+  setting :instrumentation do
+    # Core settings
+    setting :enabled, default: false
+    setting :subscribers, default: []
+    setting :sampling_rate, default: 1.0
+    setting :trace_level, default: :standard
+    setting :async_processing, default: false
+    setting :buffer_size, default: 1000
+    setting :flush_interval, default: 30
+    setting :error_reporting, default: false
+    setting :error_service, default: nil
+    setting :sampling_rules, default: {}
+    setting :timestamp_format, default: TimestampFormat::ISO8601
+
+    # Nested correlation ID configuration
+    setting :correlation_id do
+      setting :enabled, default: false
+      setting :header, default: 'X-Correlation-ID'
+      setting :generator, default: -> { SecureRandom.uuid }
+    end
+
+    # Nested logger configuration
+    setting :logger do
+      setting :level, default: :info
+      setting :include_payloads, default: true
+      setting :correlation_id, default: true
+      setting :sampling, default: {}
+      setting :sampling_conditions, default: {}
+    end
+
+    # Nested OpenTelemetry configuration
+    setting :otel do
+      setting :tracer_name, default: 'dspy-ruby'
+      setting :service_name, default: 'dspy-application'
+      setting :service_version, default: DSPy::VERSION
+      setting :endpoint, default: -> { ENV['OTEL_EXPORTER_OTLP_ENDPOINT'] }
+    end
+
+    # Nested New Relic configuration
+    setting :newrelic do
+      setting :app_name, default: 'DSPy Application'
+      setting :license_key, default: -> { ENV['NEW_RELIC_LICENSE_KEY'] }
+      setting :custom_attributes, default: {}
+    end
+
+    # Nested Langfuse configuration
+    setting :langfuse do
+      setting :public_key, default: -> { ENV['LANGFUSE_PUBLIC_KEY'] }
+      setting :secret_key, default: -> { ENV['LANGFUSE_SECRET_KEY'] }
+      setting :host, default: -> { ENV['LANGFUSE_HOST'] }
+      setting :track_tokens, default: true
+      setting :track_costs, default: true
+      setting :track_prompts, default: true
+    end
+  end
 
   def self.logger
     config.logger
   end
+
+  # Validation methods for instrumentation configuration
+  def self.validate_instrumentation!
+    config = self.config.instrumentation
+    
+    raise ArgumentError, "Sampling rate must be between 0.0 and 1.0" unless config.sampling_rate.between?(0.0, 1.0)
+    raise ArgumentError, "Buffer size must be positive" unless config.buffer_size > 0
+    raise ArgumentError, "Flush interval must be positive" unless config.flush_interval > 0
+    raise ArgumentError, "Invalid trace level" unless [:minimal, :standard, :detailed].include?(config.trace_level)
+    raise ArgumentError, "Invalid timestamp format" unless config.timestamp_format.is_a?(TimestampFormat)
+    
+    if config.enabled && config.subscribers.empty?
+      raise ArgumentError, "Must specify at least one subscriber when instrumentation is enabled"
+    end
+    
+    # Validate subscribers are valid symbols
+    invalid_subscribers = config.subscribers - [:logger, :otel, :newrelic, :langfuse]
+    unless invalid_subscribers.empty?
+      raise ArgumentError, "Invalid subscribers: #{invalid_subscribers.join(', ')}"
+    end
+  end
 end
 
 require_relative 'dspy/module'

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: dspy
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.5.0
 platform: ruby
 authors:
 - Vicente Reig Rincón de Arellano
 bindir: bin
 cert_chain: []
-date: 2025-07-01 00:00:00.000000000 Z
+date: 2025-07-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: dry-configurable
@@ -159,6 +159,9 @@ files:
 - lib/dspy/lm/adapters/openai_adapter.rb
 - lib/dspy/lm/errors.rb
 - lib/dspy/lm/response.rb
+- lib/dspy/mixins/instrumentation_helpers.rb
+- lib/dspy/mixins/struct_builder.rb
+- lib/dspy/mixins/type_coercion.rb
 - lib/dspy/module.rb
 - lib/dspy/predict.rb
 - lib/dspy/prompt.rb