composable_agents 3.3.1 → 3.4.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 25ea65199c3a7cbc39d42a1fc130212564879ca21a790a2a153cffdb842aa2c7
-  data.tar.gz: 68039d5cdcf0b94f31fcddf42900da77b8f5e8ce22c58f8b14aab706f284951b
+  metadata.gz: e8148fa849ff96e11a995eb6a0ad99f0b13d2628559b2beb45c2500e125c0318
+  data.tar.gz: fc1de0025450682dfbfe3088a75039af4497bb2575a0eda0dd31eca12d09582f
 SHA512:
-  metadata.gz: 9a707773175fb27c18ea2e96185e94da06f92541ceaa09c75cdf015f4f6cb29c41e779579f2b672336c73e4a243fdd46fe190717f018070979624e46c7502676
-  data.tar.gz: 4799b28d0665823cbca61eab7fd40714869475c9c817a1e8aa3e5e1518540cb41c36bb70a86d1bf4481e6b13378f6f410f5b7d5c594e90c54a2cac5e548e98b0
+  metadata.gz: c393a9e128304acda10e20d6e644515858c78ae643239e7bb4b40a96fc57a6758d186aab5701625bad811fec747d99b528341172da0d9a73c4a1ea9e3773cfb1
+  data.tar.gz: 0c31274bc54daa0023577f73c784533403e20bcfe8babc197beeb7a1b43a61455bb3b7c0cb456821e41472457dab99d0cabc17a41de214a1d2f9d22897c77b1b

data/CHANGELOG.md

@@ -1,3 +1,15 @@
+# [v3.4.1](https://github.com/Muriel-Salvan/composable_agents/compare/v3.4.0...v3.4.1) (2026-11-03 17:18:14)
+
+### Patches
+
+* [chore: update cline-rb to 2.2 and filter empty assistant messages](https://github.com/Muriel-Salvan/composable_agents/commit/7e166079df9bd949b86e7172dc06a4bc4f62d093)
+
+# [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

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/cline/agent.rb

@@ -170,32 +170,31 @@ module ComposableAgents
         if cline_cli.session&.messages
           @context.concat(
             cline_cli.session.messages.map.with_index do |message, idx_message|
-              {
-                role: message.role,
-                content: message.content.map.with_index do |content, idx_content|
-                  {
-                    type: content.type,
-                    text: (
-                      if idx_message.zero? && idx_content.zero?
-                        # First message is the user prompt, but we don't want to include the context from it
-                        user_prompt
-                      else
-                        content.text
-                      end
-                    ),
-                    input:
-                      if content.input
-                        {
-                          question: content.input.question,
-                          # The options are a Shale collection that JSON can't serialize: keep them as a plain Array
-                          options: content.input.options&.to_a
-                        }.compact
-                      end,
-                    content: content.content
-                  }.compact
-                end
-              }
-            end
+              curated_content = message.content.map.with_index do |content, idx_content|
+                curated_message = {
+                  type: content.type,
+                  text: (
+                    if idx_message.zero? && idx_content.zero?
+                      # First message is the user prompt, but we don't want to include the context from it
+                      user_prompt
+                    else
+                      content.thinking || content.text
+                    end
+                  ),
+                  input:
+                    if content.input&.question
+                      {
+                        question: content.input.question,
+                        # The options are a Shale collection that JSON can't serialize: keep them as a plain Array
+                        options: content.input.options&.to_a
+                      }.compact
+                    end,
+                  content: content.content
+                }.compact
+                curated_message.keys == [:type] ? nil : curated_message
+              end.compact
+              curated_content.empty? ? nil : { role: message.role, content: curated_content }
+            end.compact
           )
         end
 

data/lib/composable_agents/mixins/retriable_artifacts.rb

@@ -64,7 +64,11 @@
       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/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
@@ -212,13 +211,14 @@ module ComposableAgents
     # Track a message that is part of the conversation with this agent
     #
     # @param message [String, #to_hash, nil] The message content, as a String or an object that can be hashed, or nil if none.
+    #   Nil attributes of the hashed message are not kept in the conversation.
     # @param author [String] Author of the message.
     # @param question [Boolean] Is this message a question expecting a reply?
     def track_message(message:, author: 'Orchestrator', question: false)
       @conversation << {
         at: Time.now.utc,
         author:,
-        message: message.is_a?(String) ? message : message&.to_hash,
+        message: message.is_a?(String) ? message : message&.to_hash&.compact,
         question:
       }
     end

data/lib/composable_agents/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: composable_agents
 version: !ruby/object:Gem::Version
-  version: 3.3.1
+  version: 3.4.1
 platform: ruby
 authors:
 - Muriel Salvan
@@ -29,14 +29,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.1'
+        version: '2.2'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.1'
+        version: '2.2'
 - !ruby/object:Gem::Dependency
   name: commonmarker
   requirement: !ruby/object:Gem::Requirement