composable_agents 3.1.0 → 3.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 13903597d02eeacf544613b91cf9c60de076d39ecd2f3cd22b549e8a992646aa
-  data.tar.gz: 33bfbf930e6a4e43d87efadecbc1efc8a4ccf8ba29f804757b53c281d1db702f
+  metadata.gz: aee730a3031c19e5b24bdd00a7a1fea08e590ff99916b61d4d20caa1c6f5d6db
+  data.tar.gz: 38195f2c530d077d429d5e3c253c96d0b41d4660b159aea68cf610fb26f3c10b
 SHA512:
-  metadata.gz: 9102890f35cef152fa02cd9ec0a2ce960b27112c4e3134865accee7c7e8b1eb8e53914ca8030543b4c35a72dfe0d7a5c07c6172d61152c90cead8bdc4183b030
-  data.tar.gz: 5e0c71dd4d3aefd7b02a1e4183151d85e7b6ea5f8eb498589e2d5dde099ff4706d10d186dfa214c665bbffb30b74eaed9c8f4b2fe0ab4e81e6f5e238ed979ff5
+  metadata.gz: bc150e2714463ef82f7dbdac5a90716b06643728ea839c1c8b60643d2175730efdfbe10ee855d5536dc268a654678a470757e16e3a3fea169bbb44dffde6e1cb
+  data.tar.gz: 992a6ef86a797cdd5110a0398e22a223d93e0bb7c0b4ec531ec25ec98466edc99cf20b3521f8118194cd32ecb1c02d1de898ea0ad5c8a9a1f5f92ea31a4345e4

data/CHANGELOG.md

@@ -1,3 +1,15 @@
+# [v3.2.0](https://github.com/Muriel-Salvan/composable_agents/compare/v3.1.0...v3.2.0) (2026-11-02 16:54:36)
+
+## Global changes
+### Patches
+
+* [feat(Retriable): enhance retry policy options with new_input_artifacts, altering retried input artifacts](https://github.com/Muriel-Salvan/composable_agents/commit/e4ee0fe4105bdddb87670817006aedee6a7f3840)
+
+## Changes for Retriable
+### Features
+
+* [feat(Retriable): enhance retry policy options with new_input_artifacts, altering retried input artifacts](https://github.com/Muriel-Salvan/composable_agents/commit/e4ee0fe4105bdddb87670817006aedee6a7f3840)
+
 # [v3.1.0](https://github.com/Muriel-Salvan/composable_agents/compare/v3.0.0...v3.1.0) (2026-11-01 13:55:18)
 
 ## Global changes

data/README.md

@@ -463,11 +463,14 @@ Mixins are `prepend`-ed into an agent class to add specific capabilities.
 
 #### `ComposableAgents::Mixins::Retriable`
 
-- **Description:** Adds conditional retry capabilities to agents. Retry condition procs are registered with `#retry_on` (or `#with_retry_on` for temporary activation) and are evaluated at the end of each run. A proc receives the agent instance and the exception raised by `run` (or `nil` if none) and returns either `nil` (no retry) or a policy hash with `:wait_secs` and optional `:modifier` keys. When a proc returns a policy, the agent waits `wait_secs` seconds, optionally calls the policy's `modifier`, and re-runs. If `run` raised an exception and no proc returned a retry policy, the exception is re-raised to the caller.
+- **Description:** Adds conditional retry capabilities to agents. Retry condition procs are registered with `#retry_on` (or `#with_retry_on` for temporary activation) and are evaluated at the end of each run. A proc receives the agent instance and the exception raised by `run` (or `nil` if none) and returns either `nil` (no retry) or a policy hash with optional keys to describe the policy:
+  - `:wait_secs` — Wait time in seconds before retrying (defaults to 0).
+  - `:modifier` — Proc called with the agent before retrying ( defaults to doing nothing).
+  - `:new_input_artifacts` — Hash of input artifacts to add to the retried run (defaults to `{}`).
+When a proc returns a policy, the agent waits `wait_secs` seconds, applies the `modifier` proc (if any), merges the `new_input_artifacts` into the retry input, and re-runs. If `run` raised an exception and no proc returned a retry policy, the exception is re-raised to the caller.
 - **Public methods:**
-  - `#retry_on(proc)` — Register a retry condition proc. Returns `self` so calls can be chained.
+  - `#retry_on(proc)` — Register a retry condition proc.
   - `#with_retry_on(proc, &block)` — Register a retry proc for the duration of a block, then unregister it when the block returns (even if it raises).
-  - policy hash — Configuration with optional `:wait_secs` (seconds to wait before retrying, defaults to 0) and optional `:modifier` (proc called with the agent before retrying).
 - **Usage example:**
   ```ruby
   class MyAgent < ComposableAgents::Agent

data/lib/composable_agents/mixins/retriable.rb

@@ -17,14 +17,13 @@ module ComposableAgents
     # * Each registered proc is kept in an internal array, in registration order.
     # * A proc receives the agent's instance and the exception raised by `run`
     #   (or `nil` if none) and returns either `nil` (no retry) or a policy hash
-    #   with optional `:wait_secs` and optional `:modifier` keys.
+    #   (see Retriable#retry_on).
     # * The run method is wrapped: it calls the original run, then evaluates the
     #   registered procs in order until one returns a non-nil policy hash.
     # * If `run` raised an exception and no proc returned a non-nil policy hash,
     #   the exception is re-raised to the caller.
     # * If a proc decides to retry: wait for `wait_secs` seconds, then call the
-    #   `modifier` proc (if any), then call run again.
-    #
+    #   `modifier` proc (if any), merge the `new_input_artifacts` into the retry input, and call run again.
     module Retriable
       # @!group Public API
 
@@ -41,8 +40,9 @@ module ComposableAgents
       #   - param exception [Exception, nil] The exception that was raised by the run, or nil if none.
       #   - result [Hash\\{Symbol => Object}] Definition of the retry policy, with optional properties:
       #     - wait_secs [Integer, Float] Wait time in seconds before retrying (defaults to 0).
-      #     - modifier [Proc] Code called to modify the agent's state before retrying (defaults to doing nothing).
+      #     - modifier [#call(agent)] Code called to modify the agent's state before retrying (defaults to doing nothing).
       #       - param agent [Agent] The agent for which the retry is considered.
+      #     - new_input_artifacts [Hash\\{Symbol => Object}] New input artifacts that need to be added to the retried run (defaults to {}).
       # @return [self]
       def retry_on(proc)
         retry_policies << proc
@@ -78,12 +78,13 @@ module ComposableAgents
       # @param input_artifacts [Hash{Symbol => Object}] input artifacts
       # @return [Hash{Symbol => Object}] output artifacts from the last run
       def run(**input_artifacts)
+        retry_input_artifacts = input_artifacts.dup
         output_artifacts = nil
         retry_index = 0
         loop do
           exception = nil
           begin
-            output_artifacts = super
+            output_artifacts = super(**retry_input_artifacts)
           rescue StandardError => e
             exception = e
           end
@@ -98,6 +99,7 @@ module ComposableAgents
             logger.debug "Retry ##{retry_index}: re-running in #{wait_secs}s#{" (exception #{exception})" if exception}"
             sleep(wait_secs) if wait_secs.positive?
             policy[:modifier]&.call(self)
+            retry_input_artifacts.merge!(policy[:new_input_artifacts] || {})
           else
             raise exception if exception
 

data/lib/composable_agents/mixins/retriable_artifacts.rb

@@ -49,27 +49,12 @@
                     "Maximum number of retries (#{max_retries}) exceeded. Missing or errored artifacts: #{artifact_keys.join(', ')}"
             else
               artifacts_errors_retries += 1
-              { modifier: proc { @overridden_user_instructions = missing_output_user_instructions(missing) } }
+              { new_input_artifacts: { user_instructions: missing_output_user_instructions(missing) } }
             end
           end
         )
       end
 
-      # Execute the agent to generate some output artifacts based on some input artifacts.
-      # On retry, uses +@overridden_user_instructions+ (set by the retry policy's modifier)
-      # instead of the original +user_instructions+.
-      #
-      # @param user_instructions [Object, nil] Instructions for the user prompt, that will be rendered.
-      # @param input_artifacts [Hash{Symbol => Object}] The input artifacts content, per artifact name
-      # @return [Hash{Symbol => Object}] The output artifacts
-      def run(user_instructions: nil, **input_artifacts)
-        if @overridden_user_instructions
-          user_instructions = @overridden_user_instructions
-          @overridden_user_instructions = nil
-        end
-        super
-      end
-
       private
 
       # Compute the missing output artifacts with their descriptions and errors.

data/lib/composable_agents/version.rb

@@ -2,5 +2,5 @@ module ComposableAgents
   # @!group Public API
 
   # Gem version
-  VERSION = '3.1.0'
+  VERSION = '3.2.0'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: composable_agents
 version: !ruby/object:Gem::Version
-  version: 3.1.0
+  version: 3.2.0
 platform: ruby
 authors:
 - Muriel Salvan