composable_agents 3.4.2 → 3.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e7f5301018586fe1833b809177d6a65ea6354d15269a23a7cd2576b7a4e32fbf
-  data.tar.gz: 00ddb291d538fa3e10cc7e1f15988e5b1d61354daaecd80c56e95905f97f09e7
+  metadata.gz: 132190ec03c57ad131b72ea3ec35026ec960df4afa592db2de817986ca52f716
+  data.tar.gz: dd2f18c46f0b902002dba6dc1e00426723de74bab9311926440122ca810a6426
 SHA512:
-  metadata.gz: e60c04ab1c8ee42b3cd1701ee99e99641bef7285316979f726a60155d3a5f907955db3827972cedab6e7065b84e12df7d9817e188476a03e08d44759a577be49
-  data.tar.gz: 384d21b543720de613ffcc867a8a7ebb77fc983838c19b94a7e14eb2bee8c034f3c04f63c31a1b9de3950d51fcb05aa6b0a0d13e8555d2d154d299b9e91044cf
+  metadata.gz: e008ab4e1124e9b2943af61bc31c1d7290f2b2cee575fb6469776e337a141e32a6c2978f156ff5d79cc49e7654663324e7eee91d7521f02ecfb775cac352f8ff
+  data.tar.gz: 0f3cda8a0158bf4946a4a4392426dc670d095b6c607999928babb251f9fb6ebdefe12885a62f7d3b8e94566aa42eeaff34749ac6a6f6a744138c4527bd7a9ce1

data/CHANGELOG.md

@@ -1,3 +1,21 @@
+# [v3.5.0](https://github.com/Muriel-Salvan/composable_agents/compare/v3.4.3...v3.5.0) (2026-11-06 18:46:37)
+
+## Global changes
+### Patches
+
+* [feat(prompts): pretty-print JSON context and artifacts](https://github.com/Muriel-Salvan/composable_agents/commit/2c32832997d33431a5af0ec931627faa4a87a7a7)
+
+## Changes for prompts
+### Features
+
+* [feat(prompts): pretty-print JSON context and artifacts](https://github.com/Muriel-Salvan/composable_agents/commit/2c32832997d33431a5af0ec931627faa4a87a7a7)
+
+# [v3.4.3](https://github.com/Muriel-Salvan/composable_agents/compare/v3.4.2...v3.4.3) (2026-11-05 09:18:36)
+
+### Patches
+
+* [fix: normalize Cline session context with recursive JSON-safe conversion](https://github.com/Muriel-Salvan/composable_agents/commit/179334f05dbb758161c11c1d9b8d016c24d46909)
+
 # [v3.4.2](https://github.com/Muriel-Salvan/composable_agents/compare/v3.4.1...v3.4.2) (2026-11-04 16:45:13)
 
 ## Global changes

data/TODO.md

@@ -1,3 +1,5 @@
+* Add a new Breakable/Interruptable mixin for Cline::Agent with proper methods or config to define conditions to interrupt a run (could be based on timeouts, costs, tokens, infinite loops...).
+* Use a ContextSummarizer agent to shrink the context given in retries.
 * Add a new mixin for Cline::Agent with proper methods or config to define retries in case of errors, with exponential waits.
 * Add a new retry mixin for Cline::Agent with proper methods or config to define retries in case of errors and 429 issues to define fallback models in case of errors, with exponential waits (reuse code from the RetriableCline mixin).
 * Add a way to detect infinite loops in agents and act on it (maybe a mixin looking at prompts/messages).

data/lib/composable_agents/cline/agent.rb

@@ -122,7 +122,7 @@ module ComposableAgents
               Here is the conversation from a previous session for context:
 
               ```json
-              #{JSON.dump(@context)}
+              #{JSON.pretty_generate(@context)}
               ```
 
               Continue with the task, building on the work from the session above.
@@ -169,32 +169,33 @@ module ComposableAgents
         # Keep the context in case we need to resume it
         if cline_cli.session&.messages
           @context.concat(
-            cline_cli.session.messages.map.with_index do |message, idx_message|
-              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
+            deep_json_safe(
+              cline_cli.session.messages.map.with_index do |message, idx_message|
+                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,
+                          options: content.input.options
+                        }.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
-              curated_content.empty? ? nil : { role: message.role, content: curated_content }
-            end.compact
+            )
           )
         end
 

data/lib/composable_agents/prompt_driven_agent.rb

@@ -241,5 +241,24 @@ module ComposableAgents
         obj
       end
     end
+
+    # Recursively convert any value into a plain, JSON-serializable Ruby object.
+    # Some agent states contain Shale objects (e.g. Cline session messages from the cline-rb Rubygem).
+    # Shale's to_json accepts no positional argument, while the JSON gem calls to_json with the generator state,
+    # so JSON.dump raises ArgumentError on them. Their to_hash (and the to_hash of their collections and maps)
+    # returns the equivalent plain structure, so we recurse into it to normalize nested schemas, collections and maps.
+    #
+    # @param value [Object] Value to normalize
+    # @return [Object] Equivalent JSON-serializable value
+    def deep_json_safe(value)
+      case value
+      when Array
+        value.map { |element| deep_json_safe(element) }
+      when Hash
+        value.to_h { |key, element| [key, deep_json_safe(element)] }
+      else
+        value.respond_to?(:to_hash) ? deep_json_safe(value.to_hash) : value
+      end
+    end
   end
 end

data/lib/composable_agents/prompt_rendering_strategy/markdown_heavy.rb

@@ -146,7 +146,7 @@ module ComposableAgents
                   ## `#{art_ref}`
 
                   ```json input_artifact=#{art_ref}
-                  #{JSON.dump(artifact_content)}
+                  #{JSON.pretty_generate(artifact_content)}
                   ```
                 EO_ARTIFACT_SECTION
               end.join("\n\n")

data/lib/composable_agents/version.rb

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

metadata

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