phronomy 0.26.0 → 0.28.0

data/lib/phronomy/agent/before_llm_input.rb

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+
+module Phronomy
+  module Agent
+    module BeforeLLMInput
+      def self.included(base)
+        base.extend(ClassMethods)
+      end
+
+      module ClassMethods
+        def before_llm_input(callable = nil, &block)
+          if callable.nil? && !block_given?
+            @before_llm_input
+          else
+            @before_llm_input = callable || block
+          end
+        end
+
+        def _before_llm_input = @before_llm_input
+      end
+
+      attr_accessor :before_llm_input
+
+      private
+
+      def run_before_llm_input_hooks(call_sequence:, config:)
+        hooks = [
+          Phronomy::Agent::Settings.current.before_llm_input,
+          self.class._before_llm_input,
+          @before_llm_input
+        ].compact
+        return Phronomy::Context::LLMInputPatch.empty if hooks.empty?
+
+        definition = self.class.agent_definition
+        context = Phronomy::Context::LLMInputBuildContext.new(
+          agent_id: agent_id,
+          agent_definition_id: definition.fetch(:id),
+          agent_definition_version: definition.fetch(:version),
+          config: config,
+          call_sequence: call_sequence
+        )
+        model_patch = {}
+        segments = []
+
+        hooks.each do |hook|
+          result = hook.call(context)
+          check_cancellation!(config, "invocation cancelled during before_llm_input hook")
+          next if result.nil?
+          unless result.is_a?(Phronomy::Context::LLMInputPatch)
+            raise TypeError,
+              "before_llm_input must return Phronomy::Context::LLMInputPatch or nil, got #{result.class}"
+          end
+          model_patch.merge!(result.model_config_patch) if result.model_config_patch
+          segments.concat(Array(result.segment_candidates))
+        end
+
+        Phronomy::Context::LLMInputPatch.new(
+          model_config_patch: model_patch.empty? ? nil : model_patch,
+          segment_candidates: segments.empty? ? nil : segments
+        )
+      end
+    end
+  end
+end

data/lib/phronomy/{agent.rb → agent/composition/run_once.rb}

@@ -1,9 +1,10 @@
 # frozen_string_literal: true
 
+# This convenience API composes a fresh ephemeral Persistence with an Agent.
+# The application entry loads the method definition; Agent execution does not
+# delegate to or require this higher-level composition implementation.
 module Phronomy
   module Agent
-    StreamEvent = Data.define(:type, :payload)
-
     def self.run_once(
       definition:,
       input:,
@@ -17,7 +18,7 @@ module Phronomy
         raise ArgumentError, "Provide either on_event: or a block, not both"
       end
 
-      persistence = Phronomy::Persistence::InMemory.new
+      persistence = Phronomy::PersistenceComposition.agent
       agent = definition.create(
         context: context,
         knowledge: knowledge,
@@ -29,13 +30,3 @@ module Phronomy
     end
   end
 end
-
-require_relative "agent/async_event_api"
-
-unless Phronomy::Agent::Base < Phronomy::Agent::AsyncEventApi
-  Phronomy::Agent::Base.prepend(Phronomy::Agent::AsyncEventApi)
-end
-
-# Durable Agent Recovery and Agent-incarnation event binding.
-require_relative "agent/recovery_support"
-require_relative "agent/recovery_coordinator"

data/lib/phronomy/agent/context_candidate_resolver.rb

@@ -43,7 +43,7 @@ module Phronomy
           "source_sequence" => record.sequence
         )
 
-        Selection::Candidate.new(
+        Phronomy::Context::Candidate.new(
           candidate_id: "record:#{record.record_id}",
           source_kind: source_kind,
           category: record.kind,
@@ -55,7 +55,7 @@ module Phronomy
           llm_call_id: record.llm_call_id,
           tool_call_id: tool_call_id,
           sequence: sequence,
-          constraint: Selection::Constraint.selectable(origin: :context_policy),
+          constraint: Phronomy::Context::Constraint.selectable(origin: :context_policy),
           priority: (source_kind == :working) ? 100 : 0,
           metadata: metadata
         )

data/lib/phronomy/agent/context_importer.rb

@@ -8,8 +8,8 @@ module Phronomy
       ) do
         def initialize(**values)
           super(**values.merge(
-            content: Immutable.copy(values[:content]),
-            metadata: Immutable.copy(values[:metadata] || {})
+            content: Phronomy::Values::Immutable.copy(values[:content]),
+            metadata: Phronomy::Values::Immutable.copy(values[:metadata] || {})
           ))
           freeze
         end