dspy 1.0.0 → 1.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 85ae2299dbddc20bfd710c68e9e8dfbeeb201b742e3fd18b768669ddc4443261
-  data.tar.gz: ba0ee2d5f637f499448e456fb58f0513aa58b5b258e754bf1b32839ea8c49b63
+  metadata.gz: b4a5f4d14d66f2be69cb22fb8a464de7272080fcd9d6978b9e53ead8ca71753e
+  data.tar.gz: c7ba793f96742801e903e08b8615145f99f5d38abea9411c49c8a04028759f41
 SHA512:
-  metadata.gz: 310de5ce11b23d29bd168069eae4f5ce3ac154ba91974c96b9d70e5d02a0dcb45122dc4c83f80097a409ff448a0a30d45ebec3ff0883d80b2cdd8f1215d2dfff
-  data.tar.gz: 1ce5ff1bfe900bcedabab28efba1e8352fed81c6cbf458d5b7c54e8f7eea29fa6b7ee33a62dcc73b456ede6181a85bbf055541e4fb70037ac4de05e3be2b8ce9
+  metadata.gz: 1c6aa6ae8e37e7c4538d05c6c881e78e9329ea40341aaf982c7dfc44cac60257b8e403850e59e495ba6b9633fd0268b796015371d93502ef54ae58b3d04f2804
+  data.tar.gz: d0b9fa562e22160fe1299cf8a7dbb56d973af727ccd4678bafe3b3a59e4c922776c492744eccd87d7b1eb8c181a7db69468e62e2c36e8d5f7e10d21e856a1ff4

data/lib/dspy/mixins/type_coercion.rb

@@ -299,9 +299,11 @@ module DSPy
       # Coerces an array value, converting each element as needed
       sig { params(value: T.untyped, prop_type: T.untyped).returns(T.untyped) }
       def coerce_array_value(value, prop_type)
-        return value unless value.is_a?(Array)
         return value unless prop_type.is_a?(T::Types::TypedArray)
 
+        value = try_parse_string_to_array(value)
+        return value unless value.is_a?(Array)
+
         element_type = prop_type.type
         value.map { |element| coerce_value_to_type(element, element_type) }
       end
@@ -347,6 +349,18 @@ module DSPy
         value
       end
 
+      # Attempts to parse a JSON string into an Array.
+      # Returns the parsed Array on success, or the original value otherwise.
+      sig { params(value: T.untyped).returns(T.untyped) }
+      def try_parse_string_to_array(value)
+        return value unless value.is_a?(String)
+
+        parsed = JSON.parse(value)
+        parsed.is_a?(Array) ? parsed : value
+      rescue JSON::ParserError
+        value
+      end
+
       # Attempts to parse a JSON string into a Hash.
       # Returns the parsed Hash on success, or the original value otherwise.
       sig { params(value: T.untyped).returns(T.untyped) }

data/lib/dspy/re_act.rb

@@ -110,6 +110,8 @@ module DSPy
     end
 
     FINISH_ACTION = "finish"
+    THOUGHT_LOOP_INSTRUCTION = "Generate a thought about what to do next to process the given inputs."
+    OBSERVATION_LOOP_INSTRUCTION = "Process the observation from a tool and decide what to do next."
     sig { returns(T.class_of(DSPy::Signature)) }
     attr_reader :original_signature_class
 
@@ -198,7 +200,9 @@ module DSPy
     def with_instruction(instruction)
       clone = self.class.new(@original_signature_class, tools: @tools.values, max_iterations: @max_iterations)
       thought_generator = clone.instance_variable_get(:@thought_generator)
+      observation_processor = clone.instance_variable_get(:@observation_processor)
       clone.instance_variable_set(:@thought_generator, thought_generator.with_instruction(instruction))
+      clone.instance_variable_set(:@observation_processor, observation_processor.with_instruction(instruction))
       clone
     end
 
@@ -224,6 +228,14 @@ module DSPy
 
     private
 
+    sig { params(signature_class: T.class_of(DSPy::Signature), loop_instruction: String).returns(String) }
+    def loop_description(signature_class, loop_instruction)
+      [
+        signature_class.description,
+        loop_instruction
+      ].compact.reject(&:empty?).join("\n\n")
+    end
+
     # Serialize value for LLM display
     sig { params(value: T.untyped).returns(T.untyped) }
     def serialize_for_llm(value)
@@ -302,6 +314,13 @@ module DSPy
       action_enum_class = @action_enum_class
       input_context_type = signature_class.input_struct_class || String
 
+      # Carry the user signature's instructions into the loop prompt, then append the
+      # loop mechanics — mirroring Python DSPy's ReAct, which prepends
+      # signature.instructions to the react predictor's instructions. Without this the
+      # user's task description never reaches the LM: it is only set on the enhanced
+      # signature used for typing, which issues no LM calls.
+      thought_description = loop_description(signature_class, THOUGHT_LOOP_INSTRUCTION)
+
       # Get the output field type for the final_answer field
       output_field_name = signature_class.output_struct_class.props.keys.first
       output_field_type = signature_class.output_struct_class.props[output_field_name][:type_object]
@@ -309,7 +328,7 @@ module DSPy
       # Create new class that inherits from DSPy::Signature
       Class.new(DSPy::Signature) do
         # Set description
-        description "Generate a thought about what to do next to process the given inputs."
+        description thought_description
 
         # Define input fields
         input do
@@ -339,10 +358,12 @@ module DSPy
     sig { params(signature_class: T.class_of(DSPy::Signature), data_format: Symbol).returns(T.class_of(DSPy::Signature)) }
     def create_observation_signature(signature_class, data_format)
       input_context_type = signature_class.input_struct_class || String
+      observation_description = loop_description(signature_class, OBSERVATION_LOOP_INSTRUCTION)
+
       # Create new class that inherits from DSPy::Signature
       Class.new(DSPy::Signature) do
         # Set description
-        description "Process the observation from a tool and decide what to do next."
+        description observation_description
 
         # Define input fields
         input do

data/lib/dspy/version.rb

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

metadata

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