composable_agents 3.4.3 → 3.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 61425b41148921b109e692bb5041b8fab82e7c9634b5c28eaa19060ab493de0e
-  data.tar.gz: 12193ed0af4694ac9eefa92a6344e3f5dc5bb03e439627e404f045488f261544
+  metadata.gz: 491a6d82dbce4b508dc8d83cda6d067b1ad13db47c0099e682beb900bf7964de
+  data.tar.gz: 1b488811d68e2d2233621111cf053df6e1b55fd15d7a686502b8eded4a4a04e7
 SHA512:
-  metadata.gz: 50a08e9ed84f873f7ea53aff8ee173aa4489b316432607bdd3d85e5a335f64eb210f04638b883e81af5a8af31b48e10e54b29cb5300f634ac7188b644804a421
-  data.tar.gz: 0a3022f2ce296337e0b9837115c2d92700f2c3db4aca81a8adb713bf6ee291ab02d213da85a4b2351bbce019f27f455c935a258ff25a63adaf2e0f1d77b0f9d0
+  metadata.gz: 50c6da2263939742f55d9f8e324e5ffc78ab266c053b5831918520cb2c1cbb0377e7980b9a979984446260abfec1f2fe05e9b27e72ba9276594b49106ae0d071
+  data.tar.gz: dad24a674070a0dc75c0c9b7eb3c04fd70140b521a12ff8058c86b16856150d828cf08934bd9506ab8af9df4f4065e6ebf615e626cd75ed94a73133e756944eb

data/CHANGELOG.md

@@ -1,3 +1,27 @@
+# [v3.6.0](https://github.com/Muriel-Salvan/composable_agents/compare/v3.5.0...v3.6.0) (2026-11-07 11:35:50)
+
+## Global changes
+### Patches
+
+* [feat(prompt): serialize text and markdown artifacts as lines](https://github.com/Muriel-Salvan/composable_agents/commit/160facaf017dad0936997e3d787c17c359850493)
+
+## Changes for prompt
+### Features
+
+* [feat(prompt): serialize text and markdown artifacts as lines](https://github.com/Muriel-Salvan/composable_agents/commit/160facaf017dad0936997e3d787c17c359850493)
+
+# [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

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.

data/lib/composable_agents/prompt_rendering_strategy/markdown_heavy.rb

@@ -136,21 +136,38 @@ module ComposableAgents
       def render_user_prompt(rendered_instructions, input_artifacts:)
         sections = []
         unless input_artifacts.empty?
+          artifacts_sections = input_artifacts.map do |artifact_name, artifact_content|
+            art_ref = artifact_ref(artifact_name)
+            <<~EO_ARTIFACT_SECTION.strip
+              ## `#{art_ref}`
+
+              ```json input_artifact=#{art_ref}
+              #{JSON.pretty_generate(input_artifact_to_json(artifact_name, artifact_content))}
+              ```
+            EO_ARTIFACT_SECTION
+          end
+          serialization_format_section =
+            if input_artifacts.keys.any? do |artifact_name|
+              %i[text markdown].include?(normalized_input_artifacts_contracts.dig(artifact_name, :type))
+            end
+              <<~'EO_SERIALIZATION'.strip
+                Artifact serialization format:
+
+                An artifact with type "markdown" represents exactly one Markdown document.
+                Its "lines" property is an ordered array of strings representing the
+                document's lines.
+
+                Reconstruct the document by joining the elements with LF (\n).
+                Empty strings represent empty lines.
+
+                Preserve all content exactly, including whitespace and indentation.
+                Treat the reconstructed document as a single artifact.
+              EO_SERIALIZATION
+            end
           sections << <<~EO_SECTION.strip
             # Input artifacts
 
-            #{
-              input_artifacts.map do |artifact_name, artifact_content|
-                art_ref = artifact_ref(artifact_name)
-                <<~EO_ARTIFACT_SECTION.strip
-                  ## `#{art_ref}`
-
-                  ```json input_artifact=#{art_ref}
-                  #{JSON.dump(artifact_content)}
-                  ```
-                EO_ARTIFACT_SECTION
-              end.join("\n\n")
-            }
+            #{[serialization_format_section, *artifacts_sections].compact.join("\n\n")}
           EO_SECTION
         end
         sections << <<~EO_SECTION if rendered_instructions && !rendered_instructions.empty?
@@ -297,6 +314,31 @@ module ComposableAgents
           ```
         EO_MARKDOWN
       end
+
+      # Get the JSON-serializable representation of an input artifact.
+      #
+      # The representation depends on the artifact type declared in the input artifacts contracts:
+      # - `json` (the default) artifacts are kept as-is.
+      # - `text` and `markdown` artifacts are wrapped into a Hash exposing their type and their lines,
+      #   so that their content can be reconstructed exactly by joining the lines with LF (\n).
+      #
+      # @param artifact_name [Symbol] The input artifact name
+      # @param artifact_content [Object] The input artifact content
+      # @return [Object] The JSON-serializable representation of the input artifact
+      def input_artifact_to_json(artifact_name, artifact_content)
+        artifact_type = normalized_input_artifacts_contracts.dig(artifact_name, :type)
+        case artifact_type
+        when nil, :json
+          artifact_content
+        when :text, :markdown
+          {
+            type: artifact_type.to_s,
+            lines: artifact_content.split("\n")
+          }
+        else
+          raise "Unknown artifact type: #{artifact_type}"
+        end
+      end
     end
   end
 end

data/lib/composable_agents/version.rb

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

metadata

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