legion-llm 0.5.22 → 0.5.23

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7e7ff9c35609294ace1f203076485aaba0a811ba0adbe7d01197ce91de7a06ea
-  data.tar.gz: c493d891ded32632daf9b7e367fa115efc9903cc63d408c8c0799bb8bc242ca1
+  metadata.gz: 9bfeb8ca0bacd82ef217f76275e20d8df7a15f83a324bcf9f090232ed7374837
+  data.tar.gz: cb4ceb07ae6004670a9e582a1fad6d3d2bc9a87e5a123116ff1ef995e5576744
 SHA512:
-  metadata.gz: 2cd3766d938ba6814f2a14af190441a0d9b0e011538da22744729b678313ff03045fc84ae4e1ecab7dcff9ac31a1d4d92afdff25d3b5e7ca322a0303ef54c0fa
-  data.tar.gz: 3a03dd436e31b0d02290e23af4cadc755136c89321af205a83c0c18dac4cac9a8f320875a578ac6405dafd409a0b3bc516431d1dff34670731ab803618df36ae
+  metadata.gz: 0a24a288be1a94ef846aea5c47871c7f7875e99749078a77a431af854fbdbf3582cfdf1191aa570d9ae08d77f723bb653fa4b431258c77f5e050e2bd8ec367ef
+  data.tar.gz: '0508aced0a6e1e8f09fb2e6ae2c8121f81d2b8efe765e37b1bb7d23c5ae688dcb9dc314c0a92cb6caef004c0ee8767f3b79e961728d3f278a5ceaf99bd16d844'

data/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 ## [Unreleased]
 
+## [0.5.23] - 2026-03-31
+
+### Added
+- `Hooks::Reciprocity` — after_chat hook that records a `:given` social exchange event via `Social::Social::Client#record_exchange` when a caller with identity receives an LLM response; silently no-ops when social extension or identity is absent
+- Partner context enrichment in `Pipeline::Steps::GaiaAdvisory` (step 7) — when the caller identity is registered as a partner in `Legion::Gaia::BondRegistry`, the advisory data is enriched with a `:partner_context` hash containing standing, compatibility, recent_sentiment, and interaction_pattern; sourced from Apollo Local `partner`-tagged entries with full graceful degradation when Apollo is unavailable
+
 ## [0.5.22] - 2026-03-31
 
 ### Added

data/lib/legion/llm/hooks/reciprocity.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+module Legion
+  module LLM
+    module Hooks
+      # Records a :given exchange event on the social graph whenever the LLM
+      # responds to a caller that carries an identity. Runs as an after_chat hook.
+      #
+      # The hook is intentionally lightweight — it does not block the response
+      # path and silently swallows all errors so a social-layer problem never
+      # surfaces to the caller.
+      module Reciprocity
+        module_function
+
+        def install
+          Legion::LLM::Hooks.after_chat do |caller: nil, **|
+            record_reciprocity(caller: caller)
+            nil
+          end
+        end
+
+        def record_reciprocity(caller:)
+          identity = caller&.dig(:requested_by, :identity)
+          return unless identity
+
+          runner = social_runner
+          return unless runner
+
+          runner.record_exchange(agent_id: identity, action: :communication, direction: :given)
+        rescue StandardError => e
+          Legion::Logging.debug "[LLM::Reciprocity] hook error: #{e.message}" if defined?(Legion::Logging)
+        end
+
+        def social_runner
+          return nil unless defined?(Legion::Extensions::Agentic::Social::Social::Client)
+
+          Legion::Extensions::Agentic::Social::Social::Client.new
+        rescue StandardError => e
+          Legion::Logging.debug "[LLM::Reciprocity] social_runner error: #{e.message}" if defined?(Legion::Logging)
+          nil
+        end
+      end
+    end
+  end
+end

data/lib/legion/llm/hooks.rb

@@ -6,6 +6,7 @@ require 'legion/llm/hooks/metering'
 require 'legion/llm/hooks/cost_tracking'
 require 'legion/llm/hooks/budget_guard'
 require 'legion/llm/hooks/reflection'
+require 'legion/llm/hooks/reciprocity'
 
 module Legion
   module LLM

data/lib/legion/llm/pipeline/steps/gaia_advisory.rb

@@ -19,6 +19,8 @@ module Legion
 
             return if advisory.nil? || advisory.empty?
 
+            enrich_advisory_with_partner_context(advisory)
+
             @enrichments['gaia:advisory'] = {
               content:   advisory_summary(advisory),
               data:      advisory,
@@ -48,6 +50,29 @@ module Legion
             @warnings << "GAIA advisory error: #{e.message}"
           end
 
+          # Exposed as a public method so specs can stub it on instances.
+          def build_partner_context(identity)
+            return default_partner_context unless apollo_local_available?
+
+            entries = ::Legion::Apollo::Local.query(
+              text:  identity,
+              tags:  ['partner'],
+              limit: 5
+            )
+
+            results = entries.is_a?(Hash) ? (entries[:results] || []) : Array(entries)
+
+            {
+              standing:            extract_standing(results),
+              compatibility:       extract_compatibility(results),
+              recent_sentiment:    extract_sentiment(results),
+              interaction_pattern: extract_interaction_pattern(results)
+            }
+          rescue StandardError => e
+            Legion::Logging.debug "[GaiaAdvisory] build_partner_context error: #{e.message}" if defined?(Legion::Logging)
+            nil
+          end
+
           private
 
           def advisory_summary(advisory)
@@ -57,6 +82,84 @@ module Legion
             parts << "suppress:#{advisory[:suppress]&.join(',')}" if advisory[:suppress]
             parts.empty? ? 'no enrichment' : parts.join(', ')
           end
+
+          def enrich_advisory_with_partner_context(advisory)
+            return unless defined?(::Legion::Gaia::BondRegistry)
+
+            identity = @request.caller&.dig(:requested_by, :identity)
+            return unless identity
+            return unless ::Legion::Gaia::BondRegistry.partner?(identity)
+
+            partner_ctx = build_partner_context(identity)
+            advisory[:partner_context] = partner_ctx if partner_ctx
+          rescue StandardError => e
+            Legion::Logging.debug "[GaiaAdvisory] partner context error: #{e.message}" if defined?(Legion::Logging)
+          end
+
+          def apollo_local_available?
+            defined?(::Legion::Apollo::Local) && ::Legion::Apollo::Local.started?
+          rescue StandardError
+            false
+          end
+
+          def default_partner_context
+            {
+              standing:            :unknown,
+              compatibility:       nil,
+              recent_sentiment:    :neutral,
+              interaction_pattern: :unknown
+            }
+          end
+
+          def extract_standing(results)
+            entry = results.find { |r| r[:content].to_s.match?(/standing/i) }
+            return :unknown unless entry
+
+            content = entry[:content].to_s
+            if content.match?(/good|trusted|positive/i)
+              :good
+            elsif content.match?(/poor|untrusted|negative/i)
+              :poor
+            else
+              :neutral
+            end
+          end
+
+          def extract_compatibility(results)
+            entry = results.find { |r| r[:content].to_s.match?(/compat/i) }
+            return nil unless entry
+
+            match = entry[:content].to_s.match(/(\d+(?:\.\d+)?)/)
+            match ? match[1].to_f : nil
+          end
+
+          def extract_sentiment(results)
+            entry = results.find { |r| r[:content].to_s.match?(/sentiment|empathy|affect/i) }
+            return :neutral unless entry
+
+            content = entry[:content].to_s
+            if content.match?(/positive|happy|pleasant/i)
+              :positive
+            elsif content.match?(/negative|unhappy|tense/i)
+              :negative
+            else
+              :neutral
+            end
+          end
+
+          def extract_interaction_pattern(results)
+            entry = results.find { |r| r[:content].to_s.match?(/interaction|memory|trace/i) }
+            return :unknown unless entry
+
+            content = entry[:content].to_s
+            if content.match?(/frequent|regular|daily/i)
+              :frequent
+            elsif content.match?(/occasional|sometimes/i)
+              :occasional
+            else
+              :infrequent
+            end
+          end
         end
       end
     end

data/lib/legion/llm/version.rb

@@ -2,6 +2,6 @@
 
 module Legion
   module LLM
-    VERSION = '0.5.22'
+    VERSION = '0.5.23'
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: legion-llm
 version: !ruby/object:Gem::Version
-  version: 0.5.22
+  version: 0.5.23
 platform: ruby
 authors:
 - Esity
@@ -253,6 +253,7 @@ files:
 - lib/legion/llm/hooks/cost_tracking.rb
 - lib/legion/llm/hooks/metering.rb
 - lib/legion/llm/hooks/rag_guard.rb
+- lib/legion/llm/hooks/reciprocity.rb
 - lib/legion/llm/hooks/reflection.rb
 - lib/legion/llm/hooks/response_guard.rb
 - lib/legion/llm/off_peak.rb