lex-mesh 0.3.0 → 0.3.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d736de5644beff024c6acc40ededd1eface48a64dc919b4f1033e0971a7af71f
-  data.tar.gz: e58b0661aab721ebaf1c7f413691a41f2a5f0f1e455710b3d27f79ad687655fb
+  metadata.gz: aea56c9f61a9f536a407fdfee61d76717c92e9dd688365f58c33d6442ccb9d77
+  data.tar.gz: abfe8aa793907b98e051f5083c149a6f414fa0135261a603fbd50822bc0c9a93
 SHA512:
-  metadata.gz: d1abfff1fe01a29d3b9be8ee75c5f949f753a9fdf33df340e1362ef758236fb411a826eb0ae3c448bc330b8bc06cff725f35d10b5767f39ca7a8ffcb06969782
-  data.tar.gz: e1266fc12dd23f183439f2ed5c1d2a21a1c11b824652e918b6fc398df40eea46cc5aa0dbabbb14e99b8f41aa4b0cd2e99d71a259aaba8de595088c51336c7a62
+  metadata.gz: 4fdba6f4567ca4bf713964d309ef421297c469c82bd619153297a39ad17327b784b3fac74ddf187a1e97f5c12c40ebc6983862639bb5a02f13f26af928487e6c
+  data.tar.gz: a7078556f34fd735dcb9186fa9c5d6b04ecbbe73b08db08baf2d0056be9afcf94534c34aaa1d0b03a32291e9088e947670c65d0921d78d912b2fc7ca008c5b72

data/lex-mesh.gemspec

@@ -28,4 +28,12 @@ Gem::Specification.new do |spec|
 
   spec.add_dependency 'base64'
   spec.add_dependency 'ed25519', '~> 1.3'
+
+  spec.add_dependency 'legion-cache',     '>= 1.3.11'
+  spec.add_dependency 'legion-crypt',     '>= 1.4.9'
+  spec.add_dependency 'legion-data',      '>= 1.4.17'
+  spec.add_dependency 'legion-json',      '>= 1.2.1'
+  spec.add_dependency 'legion-logging',   '>= 1.3.2'
+  spec.add_dependency 'legion-settings',  '>= 1.3.14'
+  spec.add_dependency 'legion-transport', '>= 1.3.9'
 end

data/lib/legion/extensions/mesh/helpers/registry.rb

@@ -50,10 +50,16 @@ module Legion
             agent_ids.filter_map { |id| @agents[id] }
           end
 
-          def route_message(from:, to: nil, capability: nil, pattern: :unicast, payload: {})
+          def route_message(from:, to: nil, capability: nil, pattern: :unicast, payload: {}, hops: 0)
+            if hops >= Topology::MAX_HOPS
+              return { from: from, to: to, capability: capability, pattern: pattern,
+                       payload: payload, hops: hops, at: Time.now.utc,
+                       delivered_to: [], rejected: :max_hops_exceeded }
+            end
+
             msg = {
               from: from, to: to, capability: capability,
-              pattern: pattern, payload: payload, at: Time.now.utc
+              pattern: pattern, payload: payload, hops: hops, at: Time.now.utc
             }
 
             targets = case pattern

data/lib/legion/extensions/mesh/runners/delegation.rb

@@ -9,7 +9,7 @@ module Legion
         module Delegation
           include Legion::Extensions::Helpers::Lex if defined?(Legion::Extensions::Helpers::Lex)
 
-          def delegate(from:, to:, task_context:, consent_level: :execute, parent_delegation_id: nil, **) # rubocop:disable Metrics/ParameterLists
+          def delegate(from:, to:, task_context:, consent_level: :execute, parent_delegation_id: nil, **)
             result = delegation_tracker.create(
               from:                 from,
               to:                   to,
@@ -66,7 +66,7 @@ module Legion
               detail:       { to: record[:to_agent_id], depth: record[:depth], consent: record[:consent_level] }
             ).publish
           rescue StandardError => e
-            Legion::Logging.warn "[mesh] failed to publish #{event_type}: #{e.message}" if defined?(Legion::Logging)
+            log.warn "[mesh] failed to publish #{event_type}: #{e.message}"
           end
 
           def delegation_tracker

data/lib/legion/extensions/mesh/runners/mesh.rb

@@ -10,41 +10,41 @@ module Legion
 
           def register(agent_id:, capabilities: [], endpoint: nil, **)
             mesh_registry.register_agent(agent_id, capabilities: capabilities, endpoint: endpoint)
-            Legion::Logging.info "[mesh] registered: agent=#{agent_id} capabilities=#{capabilities.join(',')}"
+            log.info "[mesh] registered: agent=#{agent_id} capabilities=#{capabilities.join(',')}"
             { registered: true, agent_id: agent_id }
           end
 
           def unregister(agent_id:, **)
             result = mesh_registry.unregister_agent(agent_id)
             if result
-              Legion::Logging.info "[mesh] unregistered: agent=#{agent_id}"
+              log.info "[mesh] unregistered: agent=#{agent_id}"
               publish_mesh_departure(agent_id: agent_id, capabilities: result[:capabilities] || [])
               { unregistered: true }
             else
-              Legion::Logging.debug "[mesh] unregister failed: agent=#{agent_id} not found"
+              log.debug "[mesh] unregister failed: agent=#{agent_id} not found"
               { error: :not_found }
             end
           end
 
           def heartbeat(agent_id:, **)
             result = mesh_registry.heartbeat(agent_id)
-            Legion::Logging.debug "[mesh] heartbeat: agent=#{agent_id} alive=#{!result.nil?}"
+            log.debug "[mesh] heartbeat: agent=#{agent_id} alive=#{!result.nil?}"
             result ? { alive: true } : { error: :not_registered }
           end
 
-          def send_message(from:, to: nil, capability: nil, pattern: :unicast, payload: {}, **) # rubocop:disable Metrics/ParameterLists
+          def send_message(from:, to: nil, capability: nil, pattern: :unicast, payload: {}, **)
             return { error: :invalid_pattern } unless Helpers::Topology.valid_pattern?(pattern)
 
             msg = mesh_registry.route_message(from: from, to: to, capability: capability,
                                               pattern: pattern, payload: payload)
             count = msg[:delivered_to].size
-            Legion::Logging.debug "[mesh] message: from=#{from} pattern=#{pattern} delivered=#{count} to=#{msg[:delivered_to].join(',')}"
+            log.debug "[mesh] message: from=#{from} pattern=#{pattern} delivered=#{count} to=#{msg[:delivered_to].join(',')}"
             { sent: true, delivered_to: msg[:delivered_to], count: count }
           end
 
           def find_agents(capability:, **)
             agents = mesh_registry.find_by_capability(capability)
-            Legion::Logging.debug "[mesh] find: capability=#{capability} found=#{agents.size}"
+            log.debug "[mesh] find: capability=#{capability} found=#{agents.size}"
             { agents: agents.map { |a| a[:agent_id] }, count: agents.size }
           end
 
@@ -52,14 +52,14 @@ module Legion
             online = mesh_registry.online_agents
             total = mesh_registry.count
             msgs = mesh_registry.messages.size
-            Legion::Logging.debug "[mesh] status: total=#{total} online=#{online.size} messages=#{msgs}"
+            log.debug "[mesh] status: total=#{total} online=#{online.size} messages=#{msgs}"
             { total: total, online: online.size, message_count: msgs }
           end
 
           def expire_silent_agents(**)
             expired = mesh_registry.expire_silent_agents
             expired.each do |agent_id|
-              Legion::Logging.info "[mesh] expired silent agent: #{agent_id}"
+              log.info "[mesh] expired silent agent: #{agent_id}"
             end
             { success: true, expired: expired, count: expired.size }
           end
@@ -116,9 +116,9 @@ module Legion
             Legion::Extensions::Mesh::Transport::Messages::MeshDeparture.new(
               agent_id: agent_id, capabilities: capabilities
             ).publish
-            Legion::Logging.debug "[mesh] departure signal published: agent=#{agent_id}"
+            log.debug "[mesh] departure signal published: agent=#{agent_id}"
           rescue StandardError => e
-            Legion::Logging.warn "[mesh] failed to publish departure signal: #{e.message}"
+            log.warn "[mesh] failed to publish departure signal: #{e.message}"
           end
 
           def publish_gossip_message(peers)

data/lib/legion/extensions/mesh/runners/preferences.rb

@@ -75,10 +75,12 @@ module Legion
 
           def local_agent_id
             if defined?(Legion::Settings)
-              Legion::Settings['client']['name']
+              Legion::Settings[:client][:name]
             else
               'unknown'
             end
+          rescue StandardError
+            'unknown'
           end
 
           def publish_preference_response(msg, profile)

data/lib/legion/extensions/mesh/runners/task_request.rb

@@ -15,7 +15,7 @@ module Legion
 
           DEFAULT_TIMEOUT = 30
 
-          def request_task(from:, to:, task:, payload:, timeout: DEFAULT_TIMEOUT, consent_level: :execute, **) # rubocop:disable Metrics/ParameterLists
+          def request_task(from:, to:, task:, payload:, timeout: DEFAULT_TIMEOUT, consent_level: :execute, **)
             target_id = resolve_target(to)
             return { success: false, reason: :no_agent_found, requested: to } unless target_id
 
@@ -37,7 +37,7 @@ module Legion
                          payload: { type: :task_request, correlation_id: correlation_id,
                                     task: task, payload: payload, reply_to: from })
 
-            Legion::Logging.info "[mesh-task] request: from=#{from} to=#{target_id} task=#{task} cid=#{correlation_id[0..11]}"
+            log.info "[mesh-task] request: from=#{from} to=#{target_id} task=#{task} cid=#{correlation_id[0..11]}"
             { success: true, correlation_id: correlation_id, delegation_id: delegation[:delegation_id],
               target_agent: target_id }
           end
@@ -45,7 +45,7 @@ module Legion
           def handle_task_reply(correlation_id:, result:, **)
             resolved = task_pending.resolve(correlation_id: correlation_id, result: result)
             if resolved
-              Legion::Logging.debug "[mesh-task] reply resolved: cid=#{correlation_id[0..11]}"
+              log.debug "[mesh-task] reply resolved: cid=#{correlation_id[0..11]}"
               { success: true, resolved: true, correlation_id: correlation_id }
             else
               { success: false, reason: :not_found, correlation_id: correlation_id }
@@ -58,7 +58,7 @@ module Legion
 
           def expire_pending_tasks(**)
             expired = task_pending.expire
-            Legion::Logging.debug "[mesh-task] expired #{expired.size} pending tasks" unless expired.empty?
+            log.debug "[mesh-task] expired #{expired.size} pending tasks" unless expired.empty?
             { success: true, expired_count: expired.size, expired_ids: expired }
           end
 

data/lib/legion/extensions/mesh/version.rb

@@ -3,7 +3,7 @@
 module Legion
   module Extensions
     module Mesh
-      VERSION = '0.3.0'
+      VERSION = '0.3.2'
     end
   end
 end

data/spec/legion/extensions/mesh/helpers/registry_spec.rb

@@ -239,6 +239,40 @@ RSpec.describe Legion::Extensions::Mesh::Helpers::Registry do
       end
     end
 
+    describe 'hop-count enforcement' do
+      it 'delivers normally when hops is below MAX_HOPS' do
+        result = registry.route_message(from: 'sender', to: 'a1', pattern: :unicast, hops: 0)
+        expect(result[:delivered_to]).to eq(['a1'])
+        expect(result[:rejected]).to be_nil
+      end
+
+      it 'rejects when hops equals MAX_HOPS' do
+        result = registry.route_message(from: 'sender', to: 'a1', pattern: :unicast,
+                                        hops: Legion::Extensions::Mesh::Helpers::Topology::MAX_HOPS)
+        expect(result[:delivered_to]).to eq([])
+        expect(result[:rejected]).to eq(:max_hops_exceeded)
+      end
+
+      it 'rejects when hops exceeds MAX_HOPS' do
+        result = registry.route_message(from: 'sender', to: 'a1', pattern: :unicast,
+                                        hops: Legion::Extensions::Mesh::Helpers::Topology::MAX_HOPS + 1)
+        expect(result[:delivered_to]).to eq([])
+        expect(result[:rejected]).to eq(:max_hops_exceeded)
+      end
+
+      it 'includes :max_hops_exceeded in the rejected field' do
+        result = registry.route_message(from: 'sender', pattern: :broadcast,
+                                        hops: Legion::Extensions::Mesh::Helpers::Topology::MAX_HOPS)
+        expect(result[:rejected]).to eq(:max_hops_exceeded)
+      end
+
+      it 'defaults hops to 0 for backward compatibility' do
+        result = registry.route_message(from: 'sender', to: 'a1', pattern: :unicast)
+        expect(result[:delivered_to]).to eq(['a1'])
+        expect(result[:rejected]).to be_nil
+      end
+    end
+
     describe 'message buffer cap' do
       it 'shifts old messages when buffer exceeds 1000' do
         1001.times { |i| registry.route_message(from: 'sender', to: "a#{i}", pattern: :unicast) }

data/spec/legion/extensions/mesh/transport/queues/gossip_spec.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+unless defined?(Legion::Transport::Queue)
+  module Legion
+    module Transport
+      class Queue
+        def initialize(**); end
+      end
+    end
+  end
+end
+
+unless defined?(Legion::Transport::Exchanges::Node)
+  module Legion
+    module Transport
+      module Exchanges
+        class Node # rubocop:disable Lint/EmptyClass
+        end
+      end
+    end
+  end
+end
+
+require 'legion/extensions/mesh/transport/queues/gossip'
+
+RSpec.describe Legion::Extensions::Mesh::Transport::Queues::Gossip do
+  subject(:queue) { described_class.allocate }
+
+  describe '#queue_name' do
+    it "returns 'mesh.gossip'" do
+      expect(queue.queue_name).to eq('mesh.gossip')
+    end
+  end
+
+  describe '#exchange' do
+    it 'returns Legion::Transport::Exchanges::Node' do
+      expect(queue.exchange).to eq(Legion::Transport::Exchanges::Node)
+    end
+  end
+
+  describe '#routing_key' do
+    it "returns 'mesh.gossip'" do
+      expect(queue.routing_key).to eq('mesh.gossip')
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -1,16 +1,43 @@
 # frozen_string_literal: true
 
 require 'bundler/setup'
+require 'legion/logging'
+require 'legion/settings'
+require 'legion/cache/helper'
+require 'legion/crypt/helper'
+require 'legion/data/helper'
+require 'legion/json/helper'
+require 'legion/transport'
 
 module Legion
-  module Logging
-    def self.debug(_msg); end
-    def self.info(_msg); end
-    def self.warn(_msg); end
-    def self.error(_msg); end
+  module Extensions
+    module Helpers
+      module Lex
+        include Legion::Logging::Helper
+        include Legion::Settings::Helper
+        include Legion::Cache::Helper
+        include Legion::Crypt::Helper
+        include Legion::Data::Helper
+        include Legion::JSON::Helper
+        include Legion::Transport::Helper
+      end
+    end
+
+    module Actors
+      class Every
+        include Helpers::Lex
+      end
+
+      class Once
+        include Helpers::Lex
+      end
+    end
   end
 end
 
+Legion::Settings.loader.settings[:client] ||= {}
+Legion::Settings.loader.settings[:client][:name] = 'test-agent'
+
 require 'legion/extensions/mesh'
 
 RSpec.configure do |config|

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: lex-mesh
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.3.2
 platform: ruby
 authors:
 - Esity
@@ -37,6 +37,104 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: legion-cache
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.3.11
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.3.11
+- !ruby/object:Gem::Dependency
+  name: legion-crypt
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.4.9
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.4.9
+- !ruby/object:Gem::Dependency
+  name: legion-data
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.4.17
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.4.17
+- !ruby/object:Gem::Dependency
+  name: legion-json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.2.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.2.1
+- !ruby/object:Gem::Dependency
+  name: legion-logging
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.3.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.3.2
+- !ruby/object:Gem::Dependency
+  name: legion-settings
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.3.14
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.3.14
+- !ruby/object:Gem::Dependency
+  name: legion-transport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.3.9
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.3.9
 description: Agent-to-agent mesh communication protocol for brain-modeled agentic
   AI
 email:
@@ -92,6 +190,7 @@ files:
 - spec/legion/extensions/mesh/transport/messages/mesh_departure_spec.rb
 - spec/legion/extensions/mesh/transport/messages/preference_query_spec.rb
 - spec/legion/extensions/mesh/transport/messages/preference_response_spec.rb
+- spec/legion/extensions/mesh/transport/queues/gossip_spec.rb
 - spec/legion/extensions/mesh/transport/queues/preference_spec.rb
 - spec/spec_helper.rb
 homepage: https://github.com/LegionIO/lex-mesh