composable_agents 3.3.0 → 3.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1f49d4d1885ee0ce3abc08d156910295fa39b602450f68588259473acd62d30a
-  data.tar.gz: 715281f951f66e05ca81b6a237b03c690ca319d9f6ee093471db560fd03ce441
+  metadata.gz: dafd767c4fb148d355237988c5b0e3d8a43a31710f234041e12bf12f1c3b4f44
+  data.tar.gz: ef63857b75133852cc606daeab198d82d6fb67079fb051cdd2805e151e601ddd
 SHA512:
-  metadata.gz: ac0d9cbbfd7a3e6c6155e7f3276264b7c86c1ed6f68ebab6742665b25d44d14c99d544e07ff2ca22dcf59d68af6dd8064a1612c727fc39aa4318ad2de1a28c8d
-  data.tar.gz: 7bdb521e572cfc1e75f108a4d2d46aaadd7ba409e7e2cebddef4e0062b6db2e83cb0ade32429e7b7d21651061ac56786201142952c7a339cf57c23870132ae2a
+  metadata.gz: 06ffc0718f7f653c7d75fe694ab2f38e4da7b48ef556f13bec3d7632cca3d929afcaeb3199ad9d9fd193cdce5ec8787095fc7a2efc2307e8745cd543c20a24a8
+  data.tar.gz: 0e6d0c71a145d87c70230e65181cd5bb8f4c615c64c6fee7fe3ae5580792eeaf3f17da66919b8cfbd3896506aad3f89bc60ae6e78d11b987a087cffb02bb7658

data/CHANGELOG.md

@@ -1,3 +1,15 @@
+# [v3.4.0](https://github.com/Muriel-Salvan/composable_agents/compare/v3.3.1...v3.4.0) (2026-11-03 13:46:46)
+
+### Features
+
+* [feat: add optional artifact support to retriable artifacts](https://github.com/Muriel-Salvan/composable_agents/commit/df88d8b5e4f6ef377dfab34fb0e7a3feeccb1b15)
+
+# [v3.3.1](https://github.com/Muriel-Salvan/composable_agents/compare/v3.3.0...v3.3.1) (2026-11-02 20:20:46)
+
+### Patches
+
+* [refactor: remove redundant instance variable initialization in retriable mixins](https://github.com/Muriel-Salvan/composable_agents/commit/de7fbde82ed2b9540831eeca976f44662a748af9)
+
 # [v3.3.0](https://github.com/Muriel-Salvan/composable_agents/compare/v3.2.0...v3.3.0) (2026-11-02 17:21:04)
 
 ## Global changes

data/README.md

@@ -495,6 +495,18 @@ When a proc returns a policy, the agent waits `wait_secs` seconds, applies the `
 #### `ComposableAgents::Mixins::RetriableArtifacts`
 
 - **Description:** Automatically retries the run when output artifacts declared in contracts are missing or in error on prompt-driven agents. Requires both the ArtifactContract and Retriable mixins to be prepended, and must be prepended on an agent descending from PromptDrivenAgent.
+
+- **Optional artifacts:** Artifacts can be marked as `optional: true` in their contract. When an optional artifact is missing, the run will not retry — it will complete successfully. This is useful for artifacts that are nice-to-have but not required for the agent to function.
+
+  Example contract with optional artifact:
+  ```ruby
+  output_artifacts_contracts: {
+    result: 'Final result',           # required artifact
+    logs: { description: 'Execution logs', optional: true }  # optional artifact
+  }
+  ```
+
+- **Configuration:** Configurable via `artifacts_errors_max_retries` (default: 3); raises `ArtifactsErrorsMaxRetriesExceededError` when the limit is exceeded.
 - **Public methods:**
   - `#initialize(*args, artifacts_errors_max_retries: 3, **kwargs)` — Registers a retry policy that re-executes the run with a prompt asking for missing artifacts when output artifacts are missing or in error. The artifacts_errors_max_retries parameter (default: 3) sets the maximum number of retries before raising ArtifactsErrorsMaxRetriesExceededError.
 - **Usage example:**

data/lib/composable_agents/mixins/retriable_artifacts.rb

@@ -23,7 +23,6 @@
       # @param kwargs [Hash] Keyword arguments passed to the parent initializer
       def initialize(*args, artifacts_errors_max_retries: 3, **kwargs)
         super(*args, **kwargs)
-        @retriable_artifacts_user_instructions = nil
         max_retries = artifacts_errors_max_retries
         artifacts_errors_retries = 0
         last_artifact_keys = nil
@@ -63,8 +62,13 @@
       #   as given by the {OutputArtifactsError} raised by the run (or empty if none).
       # @return [Hash{Symbol => Hash{Symbol => Object}}] Missing artifacts, per artifact name.
       def missing_artifacts(output_artifacts_errors)
+        output_artifacts = saved_output_artifacts
         normalized_output_artifacts_contracts
-          .reject { |artifact_name, _artifact_description| @output_artifacts.key?(artifact_name) }
+          .reject do |artifact_name, artifact_contract|
+            output_artifacts.key?(artifact_name) || (
+              artifact_contract[:optional] && !output_artifacts_errors[artifact_name]
+            )
+          end
           .to_h do |artifact_name, artifact_description|
             [
               artifact_name,

data/lib/composable_agents/mixins/retriable_cline.rb

@@ -27,7 +27,6 @@ module ComposableAgents
         **kwargs
       )
         super(*args, **kwargs)
-        @retriable_cline_user_instructions = nil
         max_retries = cline_errors_max_retries
         initial_delay = cline_errors_retry_initial_delay_secs
         backoff_factor = cline_errors_retry_backoff_factor

data/lib/composable_agents/prompt_driven_agent.rb

@@ -74,7 +74,6 @@ module ComposableAgents
       @input_artifacts = input_artifacts
       @system_prompt = render_system_prompt(render_instructions(@system_instructions))
       logger.debug "System prompt: #{@system_prompt}"
-      # TODO: Merge converse and prompt directly here. No need for this extra complexity now that Retriable has been moved out.
       converse(user_instructions, input_artifacts: @input_artifacts, author: 'User')
       # Raise an exception if some output artifacts have errors.
       output_artifacts_errors = output_artifacts_errors_to_raise
@@ -153,6 +152,13 @@ module ComposableAgents
         "but the following error occurred: #{error}"
     end
 
+    # Return the currently saved output artifacts
+    #
+    # @return [Hash{Symbol => Object}] The currently saved output artifacts
+    def saved_output_artifacts
+      @output_artifacts
+    end
+
     private
 
     # Get the output artifacts errors that should raise an {OutputArtifactsError} at the end of a run.

data/lib/composable_agents/version.rb

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

metadata

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