composable_agents 3.5.0 → 3.6.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 132190ec03c57ad131b72ea3ec35026ec960df4afa592db2de817986ca52f716
-  data.tar.gz: dd2f18c46f0b902002dba6dc1e00426723de74bab9311926440122ca810a6426
+  metadata.gz: a8beed86d59f68e57d0efe7b2d09ec966defeee15fce9affb654762a81eb737d
+  data.tar.gz: 11c7329165a29b9549e7e170a5c9e753b745bebca3d1d720c724106ed01ac9f1
 SHA512:
-  metadata.gz: e008ab4e1124e9b2943af61bc31c1d7290f2b2cee575fb6469776e337a141e32a6c2978f156ff5d79cc49e7654663324e7eee91d7521f02ecfb775cac352f8ff
-  data.tar.gz: 0f3cda8a0158bf4946a4a4392426dc670d095b6c607999928babb251f9fb6ebdefe12885a62f7d3b8e94566aa42eeaff34749ac6a6f6a744138c4527bd7a9ce1
+  metadata.gz: 2bba9c989b743c4319e2834aa6cc831b300b86931d19ecade706c8523bf5d86061b3ff70bdfedf3d3cc69e68f74cdadef867543f885dc248fcccf803f58975fd
+  data.tar.gz: 9ce20af1669b8be9c296d0b64ef3a318db2e675d8cdd42247cd88fabf1b9c56a83bc486f89c38505521f7d4e3a2b14e4abd1b7e5cbf68e77d2772d9ce9a8d49b

data/CHANGELOG.md

@@ -1,3 +1,21 @@
+# [v3.6.1](https://github.com/Muriel-Salvan/composable_agents/compare/v3.6.0...v3.6.1) (2026-11-07 16:11:50)
+
+### Patches
+
+* [test: add logger coverage and improve SimpleCov configuration](https://github.com/Muriel-Salvan/composable_agents/commit/68804370a2d54917eb3792ec4932db3fc4941b4a)
+
+# [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

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.pretty_generate(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.5.0'
+  VERSION = '3.6.1'
 end

metadata

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