composable_agents 3.7.0 → 3.7.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 753d56bfc73e0b268d107ae37338f3efa465fc1fe559813228aa3498e6544d9e
-  data.tar.gz: 21ac2d0a614a3044f392675dd988dce82c4ffcc5cb2c5192ae9a8f32416bab1d
+  metadata.gz: ca528fbcd43384651ac041c0b1f2b20fa437209cffb628a6bcd585e8dc3e1e35
+  data.tar.gz: 0e11d4f796c723f0682af2d92a0b9c1642feb7ac18aa5bc9665e134a248e2405
 SHA512:
-  metadata.gz: 39d7fb3e1d61adb4ed78ca652b1f1aa5fc9b689cea004305de6ba14a56646725762ffb1c72965a69a516c804c5f3231197b474ebdcc4119830f708c9c85135b0
-  data.tar.gz: b2a60316353effb352cd785e54faa5f0b3d07a01f3c46fdf447f0dfdb57dc990f495ed12fddaf70eeb800cccac4b05b71ac14543bf9057c17b32f90a313dd09a
+  metadata.gz: b73237c63d9c118f059472397c7b1d9132d96cdaa529fd5ece002a6a1a4df826fb4fb1ba2904202a055478081ae389ec5edc6162353290337071bd8af880d08c
+  data.tar.gz: 74b7902c87e91a3a6f3ce5377958bddad512d55c1495577f3c5c765c346fe9b2c92158a70d61001b5b454d3c66e9e481e3a116155d24b278fbaa2508a373c2ec

data/CHANGELOG.md

@@ -1,3 +1,15 @@
+# [v3.7.1](https://github.com/Muriel-Salvan/composable_agents/compare/v3.7.0...v3.7.1) (2026-11-12 13:28:25)
+
+## Global changes
+### Patches
+
+* [fix(MarkdownHeavyFiles): lazy-init MarkdownHeavyFiles artifact dirs](https://github.com/Muriel-Salvan/composable_agents/commit/bb64c69e65a60130e356c70755d0b862586a5351)
+
+## Changes for MarkdownHeavyFiles
+### Patches
+
+* [fix(MarkdownHeavyFiles): lazy-init MarkdownHeavyFiles artifact dirs](https://github.com/Muriel-Salvan/composable_agents/commit/bb64c69e65a60130e356c70755d0b862586a5351)
+
 # [v3.7.0](https://github.com/Muriel-Salvan/composable_agents/compare/v3.6.1...v3.7.0) (2026-11-12 12:08:18)
 
 ## Global changes

data/README.md

@@ -679,7 +679,7 @@ Three strategies are included, mixed into the agent at initialization via `singl
 
 - **`PromptRenderingStrategy::Markdown`** — Clean, minimal Markdown. Simple instructions and artifact references.
 - **`PromptRenderingStrategy::MarkdownHeavy`** (default for Cline) — Elaborate prompts with execution checklists, structured artifact definition sections, and **JSON-based output parsing**. Agents format their artifacts as JSON blocks tagged with `output_artifact=NAME`, which the strategy parses back into the output hash. Includes type-aware parsing (`:text`, `:markdown`, `:json`).
-- **`PromptRenderingStrategy::MarkdownHeavyFiles`** — Same heavy Markdown behavior as `MarkdownHeavy`, but artifacts are persisted as files on disk instead of being in-lined or returned as JSON. Input artifacts are written to files that the assistant is asked to open, and output artifacts are expected as files that are read back from disk. Accepts an `artifacts_directory` constructor parameter (defaults to `#{composable_agents_dir}/artifacts`).
+- **`PromptRenderingStrategy::MarkdownHeavyFiles`** — Same heavy Markdown behavior as `MarkdownHeavy`, but artifacts are persisted as files on disk instead of being in-lined or returned as JSON. Input artifacts are written to files that the assistant is asked to open, and output artifacts are expected as files that are read back from disk. Accepts an `artifacts_directory` constructor parameter (defaults to `#{composable_agents_dir}/artifacts`); its artifacts directories are resolved lazily and created on first use.
 
 ### LLM backends: ai-agents vs cline-rb 🎯
 

data/lib/composable_agents/prompt_rendering_strategy/markdown_heavy_files.rb

@@ -15,10 +15,12 @@ module ComposableAgents
     # - `#parse_output_artifacts(text)` Parses a text that comes from the agent to retrieve output artifacts from files.
     # - `#artifact_ref(artifact_name) -> String` Returns the absolute path of the artifact file as seen by the assistant.
     #     This can be used to refer to the artifact names properly in the user or system instructions.
-    # The constructor accepts the following extra parameter:
-    # - `artifacts_directory` [String, nil] Directory where artifacts are persisted, or nil to default to
-    #   `#{composable_agents_dir}/artifacts`. Input and output artifacts are persisted in the
-    #   `input` and `output` sub-directories respectively.
+    # Artifacts are persisted in a directory that defaults to `#{composable_agents_dir}/artifacts`, where input and
+    # output artifacts are persisted in its `input` and `output` sub-directories respectively.
+    # Those directories are resolved lazily and created on disk the first time they are needed, so that no state
+    # needs to be initialized by this module's constructor.
+    # They can be customized using the `artifacts_directory` constructor parameter, when this strategy is
+    # included in a class.
     module MarkdownHeavyFiles
       # @!group Internal
 
@@ -29,12 +31,8 @@ module ComposableAgents
       # @param artifacts_directory [String, nil] Directory where artifacts are persisted, or nil to default to
       #   `#{composable_agents_dir}/artifacts`
       def initialize(*args, artifacts_directory: nil, **kwargs)
+        @artifacts_directory = artifacts_directory
         super(*args, **kwargs)
-        artifacts_directory ||= "#{@composable_agents_dir}/artifacts"
-        @input_artifacts_directory = File.join(artifacts_directory, 'input')
-        @output_artifacts_directory = File.join(artifacts_directory, 'output')
-        FileUtils.mkdir_p(@input_artifacts_directory)
-        FileUtils.mkdir_p(@output_artifacts_directory)
       end
 
       # Render the user prompt
@@ -134,6 +132,33 @@ module ComposableAgents
 
       private
 
+      # Get the directory where artifacts are persisted.
+      # Defaults to `#{composable_agents_dir}/artifacts`.
+      # Memoized. This directory is not created on disk until it is actually needed.
+      #
+      # @return [String] The directory where artifacts are persisted
+      def artifacts_directory
+        @artifacts_directory ||= "#{@composable_agents_dir}/artifacts"
+      end
+
+      # Get the directory where input artifacts are persisted.
+      # Created on disk the first time it is needed.
+      # Memoized.
+      #
+      # @return [String] The directory where input artifacts are persisted
+      def input_artifacts_directory
+        @input_artifacts_directory ||= File.join(artifacts_directory, 'input').tap { |dir| FileUtils.mkdir_p(dir) }
+      end
+
+      # Get the directory where output artifacts are persisted.
+      # Created on disk the first time it is needed.
+      # Memoized.
+      #
+      # @return [String] The directory where output artifacts are persisted
+      def output_artifacts_directory
+        @output_artifacts_directory ||= File.join(artifacts_directory, 'output').tap { |dir| FileUtils.mkdir_p(dir) }
+      end
+
       # Render the input artifacts concept section of the system prompt.
       #
       # @param input_contracts [Hash{Symbol => Hash{Symbol => Object}}] The normalized input artifacts contracts
@@ -218,7 +243,7 @@ module ComposableAgents
       # @return [String] The absolute path of the input artifact file
       def input_artifact_path(artifact_name)
         File.join(
-          @input_artifacts_directory,
+          input_artifacts_directory,
           "#{artifact_name}#{artifact_extension(normalized_input_artifacts_contracts.dig(artifact_name, :type))}"
         )
       end
@@ -229,7 +254,7 @@ module ComposableAgents
       # @return [String] The absolute path of the output artifact file
       def output_artifact_path(artifact_name)
         File.join(
-          @output_artifacts_directory,
+          output_artifacts_directory,
           "#{artifact_name}#{artifact_extension(normalized_output_artifacts_contracts.dig(artifact_name, :type))}"
         )
       end

data/lib/composable_agents/version.rb

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

metadata

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