active_harness 0.2.39 → 0.2.40

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 656a10b468592b8e0c53c2c93a8fbf7b8536420f94bd0cb7a61255d432ee78ed
-  data.tar.gz: 29de2c821b23ba363ef1596fb545035fbd1191ca6487161f6b9f30b39fe960db
+  metadata.gz: 4246d31550942e31c26ec9a708f49aae5b2e0f385a32aeaa06d6d6a75f2849ee
+  data.tar.gz: d7f12a75e7f72e3d004bfd3b64a094e99a082992fd0077e69253bddf97b919f0
 SHA512:
-  metadata.gz: 9d0d4c4114ed028a603a783841c5205163f1f02203e7c010d5c806a8e673644b391cbfb636bbb1c4d77eb40a807907e63380213b087ab3c5515491c1c2c64fcf
-  data.tar.gz: 84b154cb18717e6183337d728a6eb3ec9d34753856d6acc8fbf96c90e06a6e0db799b961b3f8d5bd7dc3984797bed401429a3110573243379eb471fcd84f160b
+  metadata.gz: 81cf0f7cb7f5f54c2a996097e34461f724bd66da920db0cee57cc84f558f8430bc83ad1e914c62a56f3493e890c993c9f2dd9408c161563ae8c161f5ac03e4d5
+  data.tar.gz: e144ed04675d274af6d66157a2f733e1cb65342adc7312b10428e9afc3c135b64af616218d6bb9ddbfb36948efd0e83b817f36654523f910c51d4797e07674e6

data/lib/active_harness/agent/image.rb

@@ -7,6 +7,10 @@ module ActiveHarness
       #     image true
       #     size  "1024x1024"
       #
+      #     # Optional: base style/formatting guidance, prepended to @input
+      #     # to form the final image prompt (see Agent#build_image_prompt).
+      #     system_prompt "Watercolor style, soft pastel colors, no text overlays."
+      #
       #     model do
       #       use      provider: :openrouter, model: "openai/gpt-5-image-mini"
       #       fallback provider: :openai,     model: "gpt-image-1"

data/lib/active_harness/agent/providers.rb

@@ -47,7 +47,7 @@ module ActiveHarness
 
     def attempt_model(entry, system_prompt)
       return attempt_via_custom_llm(entry, system_prompt) if @config[:custom_llm_backend]
-      return attempt_image_model(entry)                   if @config[:image]
+      return attempt_image_model(entry, system_prompt)     if @config[:image]
 
       provider = resolve_provider(entry[:provider])
       messages = build_messages(system_prompt, @input)
@@ -58,17 +58,26 @@ module ActiveHarness
       provider.call(**opts)
     end
 
-    def attempt_image_model(entry)
+    def attempt_image_model(entry, system_prompt)
       factory = IMAGE_PROVIDERS[entry[:provider].to_sym]
       raise ArgumentError, "Provider #{entry[:provider].inspect} does not support image generation. " \
                            "Supported image providers: #{IMAGE_PROVIDERS.keys.join(', ')}" unless factory
 
       size = entry[:size] || @config[:image_size] || "1024x1024"
-      opts = { model: entry[:model], prompt: @input.to_s, size: size }
+      opts = { model: entry[:model], prompt: build_image_prompt(system_prompt, @input.to_s), size: size }
       opts[:quality] = entry[:quality] if entry[:quality]
       factory.call.call(**opts)
     end
 
+    # Image APIs take a single prompt string (no system/user role split), so the
+    # system prompt — e.g. base style/formatting guidance — is prepended to the
+    # user's input rather than sent as a separate message.
+    def build_image_prompt(system_prompt, input)
+      return input if system_prompt.nil? || system_prompt.to_s.strip.empty?
+
+      "#{system_prompt}\n\n#{input}"
+    end
+
     def resolve_provider(name)
       factory = PROVIDERS[name.to_sym]
       raise ArgumentError, "Unknown provider: #{name.inspect}. Supported: #{PROVIDERS.keys.join(', ')}" unless factory

data/lib/active_harness/memory.rb

@@ -10,14 +10,21 @@ module ActiveHarness
   # It does NOT automatically inject history into LLM messages.
   # Injection is always manual — you control when and how context is used.
   #
-  # --- Recording (automatic) ---
+  # --- Recording ---
   #
-  # When a Memory object is passed to an agent, the agent automatically
-  # saves each successful turn (request + response) after the call.
+  # Passing a Memory object to Agent.call(memory:) does NOT by itself save
+  # anything — Agent never calls #load or #record on it. Loading and
+  # recording turns for a bare agent call is entirely manual (e.g. via
+  # before_call/after_call hooks calling @memory.load / @memory.record).
+  #
+  # Pipeline is the one place recording is automatic: when a Memory is
+  # passed to Pipeline#call, the pipeline itself calls #load before running
+  # steps and #record after a successful run — independent of any hooks the
+  # individual agents define.
   #
   #   memory = ActiveHarness::Memory.new(session_id: "u42", depth: 8)
   #   SupportAgent.call(input: "Hello", memory: memory)
-  #   # => turn is saved to storage/ai/memory/u42.json
+  #   # => nothing is saved unless SupportAgent's own hooks record it
   #
   # --- Manual injection patterns ---
   #

data/lib/active_harness/pipeline/README.md

@@ -25,7 +25,7 @@ pipeline.call
 
 pipeline.output       # => final payload string (nil if stopped)
 pipeline.stopped?     # => false
-pipeline.step_results # => { translate: <Result>, injection_guard: <Result>, ... }
+pipeline.steps.to_a   # => [[:translate, <TranslationAgent>, <Result>], [:injection_guard, <InjectionGuardAgent>, <Result>], ...]
 ```
 
 ## Step types

data/lib/active_harness.rb

@@ -32,7 +32,7 @@ require_relative "active_harness/pipeline"
 require_relative "active_harness/railtie" if defined?(Rails::Railtie)
 
 module ActiveHarness
-  VERSION = "0.2.39"
+  VERSION = "0.2.40"
 
   class << self
     # Configure ActiveHarness.

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: active_harness
 version: !ruby/object:Gem::Version
-  version: 0.2.39
+  version: 0.2.40
 platform: ruby
 authors:
 - the-teacher
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2026-06-15 00:00:00.000000000 Z
+date: 2026-07-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: concurrent-ruby