composable_agents 3.5.0 → 3.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 132190ec03c57ad131b72ea3ec35026ec960df4afa592db2de817986ca52f716
-  data.tar.gz: dd2f18c46f0b902002dba6dc1e00426723de74bab9311926440122ca810a6426
+  metadata.gz: 491a6d82dbce4b508dc8d83cda6d067b1ad13db47c0099e682beb900bf7964de
+  data.tar.gz: 1b488811d68e2d2233621111cf053df6e1b55fd15d7a686502b8eded4a4a04e7
 SHA512:
-  metadata.gz: e008ab4e1124e9b2943af61bc31c1d7290f2b2cee575fb6469776e337a141e32a6c2978f156ff5d79cc49e7654663324e7eee91d7521f02ecfb775cac352f8ff
-  data.tar.gz: 0f3cda8a0158bf4946a4a4392426dc670d095b6c607999928babb251f9fb6ebdefe12885a62f7d3b8e94566aa42eeaff34749ac6a6f6a744138c4527bd7a9ce1
+  metadata.gz: 50c6da2263939742f55d9f8e324e5ffc78ab266c053b5831918520cb2c1cbb0377e7980b9a979984446260abfec1f2fe05e9b27e72ba9276594b49106ae0d071
+  data.tar.gz: dad24a674070a0dc75c0c9b7eb3c04fd70140b521a12ff8058c86b16856150d828cf08934bd9506ab8af9df4f4065e6ebf615e626cd75ed94a73133e756944eb

data/CHANGELOG.md

@@ -1,3 +1,15 @@
+# [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.0'
 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.0
 platform: ruby
 authors:
 - Muriel Salvan