composable_agents 3.0.0 → 3.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a0ee11ea2faf7acea0c666c5dda07d94ba31eca150153c07c5ed8b8a8f408195
-  data.tar.gz: f5385011f38ce4ce3968e2b67f1866fe0134c94432dcc9c58d6373a8421af901
+  metadata.gz: aee730a3031c19e5b24bdd00a7a1fea08e590ff99916b61d4d20caa1c6f5d6db
+  data.tar.gz: 38195f2c530d077d429d5e3c253c96d0b41d4660b159aea68cf610fb26f3c10b
 SHA512:
-  metadata.gz: 21967310c2483efc63f164ca2a2c46f9d96c5965253bcd6fc036a4717d2ad0ce46536001a172ea440476df0e6c0039134d98baed9e8d359b429130882837f83b
-  data.tar.gz: 93d7d8bea59ec3a9a6aa7a7a021948a7af38a9292566418de1387dfc35ef22b98cad4bd56d4bee7c607e5591f1050bab6cb576488ba444db62184839572cc46b
+  metadata.gz: bc150e2714463ef82f7dbdac5a90716b06643728ea839c1c8b60643d2175730efdfbe10ee855d5536dc268a654678a470757e16e3a3fea169bbb44dffde6e1cb
+  data.tar.gz: 992a6ef86a797cdd5110a0398e22a223d93e0bb7c0b4ec531ec25ec98466edc99cf20b3521f8118194cd32ecb1c02d1de898ea0ad5c8a9a1f5f92ea31a4345e4

data/CHANGELOG.md

@@ -1,3 +1,27 @@
+# [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
+### Patches
+
+* [feat(cline): introduce ClineError and extract MissingSkillError](https://github.com/Muriel-Salvan/composable_agents/commit/ba02df7d666c96c7cfc23a1b5a7eb92274a9e496)
+
+## Changes for cline
+### Features
+
+* [feat(cline): introduce ClineError and extract MissingSkillError](https://github.com/Muriel-Salvan/composable_agents/commit/ba02df7d666c96c7cfc23a1b5a7eb92274a9e496)
+
 # [v3.0.0](https://github.com/Muriel-Salvan/composable_agents/compare/v2.2.0...v3.0.0) (2026-11-01 12:34:56)
 
 ## Global changes

data/README.md

@@ -48,6 +48,7 @@ Whether you're building a code review assistant, a document summarizer, or a mul
     - [`ComposableAgents::AiAgents::Agent < PromptDrivenAgent`](#composableagentsaiagentsagent--promptdrivenagent)
     - [`ComposableAgents::Cline::Agent < PromptDrivenAgent`](#composableagentsclineagent--promptdrivenagent)
     - [`ComposableAgents::Cline::MissingSkillError < RuntimeError`](#composableagentsclinemissingskillerror--runtimeerror)
+    - [`ComposableAgents::Cline::ClineError < RuntimeError`](#composableagentsclineerror--runtimeerror)
   - [Mixins](#mixins)
     - [`ComposableAgents::Logger < ::Logger`](#composableagentslogger--logger)
     - [`ComposableAgents::Mixins::Resumable`](#composableagentsmixinsresumable)
@@ -363,6 +364,11 @@ The project is a Ruby library (not a CLI) — users install the gem and use its
 - **Description:** Raised by `Cline::Agent` when a referenced skill is not found in the global or project Cline configuration.
 - **Full documentation:** [cline/agent.rb on GitHub](https://github.com/Muriel-Salvan/composable_agents/blob/main/lib/composable_agents/cline/agent.rb)
 
+#### `ComposableAgents::Cline::ClineError < RuntimeError`
+
+- **Description:** Raised by `Cline::Agent` when a Cline CLI run fails.
+- **Full documentation:** [cline/cline_error.rb on GitHub](https://github.com/Muriel-Salvan/composable_agents/blob/main/lib/composable_agents/cline/cline_error.rb)
+
 ---
 
 ### Mixins
@@ -457,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/cline/agent.rb

@@ -3,10 +3,6 @@ require 'cline'
 module ComposableAgents
   # All agents from this module work with the awesome cline-rb Rubygem
   module Cline
-    # Missin skill error
-    class MissingSkillError < RuntimeError
-    end
-
     # Agent implementation that uses an ai-agent's AgentRunner.
     # This agent publishes the following run information:
     # - usage [Hash] Cumulative usage of the API requests (cost and tokens) made during the run.
@@ -168,7 +164,7 @@ module ComposableAgents
           end,
           **@cli_options
         )
-        raise "Error: #{extract_error_message(result[:error])}".strip if result[:error]
+        raise ClineError, "Error: #{extract_error_message(result[:error])}".strip if result[:error]
 
         # Keep the context in case we need to resume it
         if cline_cli.session&.messages

data/lib/composable_agents/cline/cline_error.rb

@@ -0,0 +1,7 @@
+module ComposableAgents
+  module Cline
+    # Error raised when a Cline CLI run fails.
+    class ClineError < RuntimeError
+    end
+  end
+end

data/lib/composable_agents/cline/missing_skill_error.rb

@@ -0,0 +1,7 @@
+module ComposableAgents
+  module Cline
+    # Missing skill error
+    class MissingSkillError < RuntimeError
+    end
+  end
+end

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.0.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.0.0
+  version: 3.2.0
 platform: ruby
 authors:
 - Muriel Salvan
@@ -82,6 +82,8 @@ files:
 - lib/composable_agents/ai_agents/tools/get_artifact_tool.rb
 - lib/composable_agents/artifacts_errors_max_retries_exceeded_error.rb
 - lib/composable_agents/cline/agent.rb
+- lib/composable_agents/cline/cline_error.rb
+- lib/composable_agents/cline/missing_skill_error.rb
 - lib/composable_agents/instructions.rb
 - lib/composable_agents/logger.rb
 - lib/composable_agents/logger/tagged.rb