legion-mcp 0.4.1 → 0.4.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 37f03ddf4778cc238c0e69b039b9cd6c55acc2ada6207ef32c777c844d60d5e1
-  data.tar.gz: ffe2b6b6da0930d795ca3965b86f5edabdf8f6b698232b110bd3ae6187ce0c20
+  metadata.gz: 423fca2b66220aa4bfd5dce33490a6fb92826da7e999a21be9afed00610fd435
+  data.tar.gz: 7e9a664b742ee174140f2463c008bd99475736afe074c056cf298d9742a7ec5d
 SHA512:
-  metadata.gz: a4c148c867a384494dd92847f6ec4f25b6010d73ce3f076e6d01c0f5ae47c8a7c6d8cfa909da58f067334612f7b7420e87e388c0910fad2edf604ea45a670206
-  data.tar.gz: eb8d5f6536df790298e4613a92f61f8a4e136d16d83ede2a99c92a9507ddfd8f7301fe52a12678f891b0227e1568660b77db008b09bd9e1a98f55644e64a56b2
+  metadata.gz: d610777e7f105a5b72e4a58fb0a06cd129361639837638b49888de9b6feeb3697a5147184d5d415ba95315d2bafcf3011b9a6c5d7515b8ceec3155a8173477a9
+  data.tar.gz: 6c74faf7a062f61e8b9e10d79b6236dc9b361d6b5ff657bfe651bfa731f6a633a8c8acaf0a68f907b49cd333c4328d77e919d45a114c8e8b7a40323bbfeb9dac

data/CHANGELOG.md

@@ -1,5 +1,17 @@
 # legion-mcp Changelog
 
+## [0.4.2] - 2026-03-22
+
+### Added
+- `legion.ask_peer` — synchronous RPC query to a specific mesh peer via `lex-mesh` `request_task`
+- `legion.list_peers` — list all registered mesh agents, with optional capability filter via `find_agents`
+- `legion.notify_peer` — fire-and-forget unicast notification to a specific mesh agent via `send_message`
+- `legion.broadcast_peers` — broadcast to all agents or multicast to a capability group via `send_message`
+- `legion.mesh_status` — retrieve current mesh network state via `mesh_status`
+- All 5 tools registered in `TOOL_CLASSES`; total tool count raised from 45 to 50
+- Specs for all 5 new tools (25 examples)
+- Updated `server_spec.rb` tool count assertion from 45 to 50
+
 ## [0.4.1] - 2026-03-19
 
 ### Added

data/CODEOWNERS

@@ -0,0 +1,39 @@
+# Default owner — all files
+* @Esity
+
+# Core library code
+# lib/ @Esity @future-ai-team
+
+# MCP tools (35 tool subclasses)
+# lib/legion/mcp/tools/ @Esity @future-ai-team
+
+# MCP resources
+# lib/legion/mcp/resources/ @Esity @future-ai-team
+
+# Tiered Behavioral Intelligence (TBI) — pattern store, tier router, context guard
+# lib/legion/mcp/pattern_store.rb @Esity @future-ai-team
+# lib/legion/mcp/tier_router.rb @Esity @future-ai-team
+# lib/legion/mcp/context_guard.rb @Esity @future-ai-team
+
+# Semantic matching and embeddings
+# lib/legion/mcp/context_compiler.rb @Esity @future-ai-team
+# lib/legion/mcp/embedding_index.rb @Esity @future-ai-team
+
+# Observer pipeline and usage filter
+# lib/legion/mcp/observer.rb @Esity @future-ai-team
+# lib/legion/mcp/usage_filter.rb @Esity @future-ai-team
+
+# Tool governance
+# lib/legion/mcp/tool_governance.rb @Esity @future-security-team
+
+# Authentication
+# lib/legion/mcp/auth.rb @Esity @future-security-team
+
+# Specs
+# spec/ @Esity @future-contributors
+
+# Documentation
+# *.md @Esity @future-docs-team
+
+# CI/CD
+# .github/ @Esity

data/lib/legion/mcp/server.rb

@@ -50,6 +50,11 @@ require_relative 'cold_start'
 require_relative 'tools/do_action'
 require_relative 'tools/plan_action'
 require_relative 'tools/discover_tools'
+require_relative 'tools/ask_peer'
+require_relative 'tools/list_peers'
+require_relative 'tools/notify_peer'
+require_relative 'tools/broadcast_peers'
+require_relative 'tools/mesh_status'
 require_relative 'resources/runner_catalog'
 require_relative 'resources/extension_info'
 
@@ -101,7 +106,12 @@ module Legion
         Tools::EvalResults,
         Tools::DoAction,
         Tools::PlanAction,
-        Tools::DiscoverTools
+        Tools::DiscoverTools,
+        Tools::AskPeer,
+        Tools::ListPeers,
+        Tools::NotifyPeer,
+        Tools::BroadcastPeers,
+        Tools::MeshStatus
       ].freeze
 
       class << self

data/lib/legion/mcp/tools/ask_peer.rb

@@ -0,0 +1,56 @@
+# frozen_string_literal: true
+
+module Legion
+  module MCP
+    module Tools
+      class AskPeer < ::MCP::Tool
+        tool_name 'legion.ask_peer'
+        description 'Send a synchronous query to a specific mesh peer and return the result.'
+
+        input_schema(
+          properties: {
+            to:      { type: 'string', description: 'Agent ID or capability name to route to' },
+            query:   { type: 'string', description: 'The question or request to send to the peer' },
+            timeout: { type: 'integer', description: 'Seconds to wait for response (default 30)' }
+          },
+          required:   %w[to query]
+        )
+
+        class << self
+          def call(to:, query:, timeout: 30)
+            return error_response('lex-mesh is not available') unless mesh_available?
+
+            result = mesh_client.request_task(
+              from:    'legion.mcp',
+              to:      to,
+              task:    'query',
+              payload: { query: query },
+              timeout: timeout
+            )
+            text_response(result)
+          rescue StandardError => e
+            error_response("Failed to query peer: #{e.message}")
+          end
+
+          private
+
+          def mesh_available?
+            defined?(Legion::Extensions::Mesh::Client)
+          end
+
+          def mesh_client
+            @mesh_client ||= Legion::Extensions::Mesh::Client.new
+          end
+
+          def text_response(data)
+            ::MCP::Tool::Response.new([{ type: 'text', text: Legion::JSON.dump(data) }])
+          end
+
+          def error_response(msg)
+            ::MCP::Tool::Response.new([{ type: 'text', text: Legion::JSON.dump({ error: msg }) }], error: true)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/legion/mcp/tools/broadcast_peers.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+module Legion
+  module MCP
+    module Tools
+      class BroadcastPeers < ::MCP::Tool
+        tool_name 'legion.broadcast_peers'
+        description 'Broadcast a message to all mesh agents, or multicast to agents with a specific capability.'
+
+        input_schema(
+          properties: {
+            message:    { type: 'string', description: 'Message content to broadcast' },
+            capability: { type: 'string', description: 'If provided, multicast only to agents with this capability' }
+          },
+          required:   %w[message]
+        )
+
+        class << self
+          def call(message:, capability: nil)
+            return error_response('lex-mesh is not available') unless mesh_available?
+
+            pattern = capability ? :multicast : :broadcast
+            result  = mesh_client.send_message(
+              from:    'legion.mcp',
+              to:      capability || :all,
+              pattern: pattern,
+              payload: { message: message }
+            )
+            text_response(result)
+          rescue StandardError => e
+            error_response("Failed to broadcast: #{e.message}")
+          end
+
+          private
+
+          def mesh_available?
+            defined?(Legion::Extensions::Mesh::Client)
+          end
+
+          def mesh_client
+            @mesh_client ||= Legion::Extensions::Mesh::Client.new
+          end
+
+          def text_response(data)
+            ::MCP::Tool::Response.new([{ type: 'text', text: Legion::JSON.dump(data) }])
+          end
+
+          def error_response(msg)
+            ::MCP::Tool::Response.new([{ type: 'text', text: Legion::JSON.dump({ error: msg }) }], error: true)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/legion/mcp/tools/list_peers.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+module Legion
+  module MCP
+    module Tools
+      class ListPeers < ::MCP::Tool
+        tool_name 'legion.list_peers'
+        description 'List all registered mesh agents, optionally filtered by capability.'
+
+        input_schema(
+          properties: {
+            capability: { type: 'string', description: 'Filter agents by capability' }
+          }
+        )
+
+        class << self
+          def call(capability: nil)
+            return error_response('lex-mesh is not available') unless mesh_available?
+
+            result = mesh_client.find_agents(capability: capability)
+            text_response(result)
+          rescue StandardError => e
+            error_response("Failed to list peers: #{e.message}")
+          end
+
+          private
+
+          def mesh_available?
+            defined?(Legion::Extensions::Mesh::Client)
+          end
+
+          def mesh_client
+            @mesh_client ||= Legion::Extensions::Mesh::Client.new
+          end
+
+          def text_response(data)
+            ::MCP::Tool::Response.new([{ type: 'text', text: Legion::JSON.dump(data) }])
+          end
+
+          def error_response(msg)
+            ::MCP::Tool::Response.new([{ type: 'text', text: Legion::JSON.dump({ error: msg }) }], error: true)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/legion/mcp/tools/mesh_status.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+module Legion
+  module MCP
+    module Tools
+      class MeshStatus < ::MCP::Tool
+        tool_name 'legion.mesh_status'
+        description 'Get current mesh network status including registered agents and topology.'
+
+        input_schema(properties: {})
+
+        class << self
+          def call
+            return error_response('lex-mesh is not available') unless mesh_available?
+
+            result = mesh_client.mesh_status
+            text_response(result)
+          rescue StandardError => e
+            error_response("Failed to get mesh status: #{e.message}")
+          end
+
+          private
+
+          def mesh_available?
+            defined?(Legion::Extensions::Mesh::Client)
+          end
+
+          def mesh_client
+            @mesh_client ||= Legion::Extensions::Mesh::Client.new
+          end
+
+          def text_response(data)
+            ::MCP::Tool::Response.new([{ type: 'text', text: Legion::JSON.dump(data) }])
+          end
+
+          def error_response(msg)
+            ::MCP::Tool::Response.new([{ type: 'text', text: Legion::JSON.dump({ error: msg }) }], error: true)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/legion/mcp/tools/notify_peer.rb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+module Legion
+  module MCP
+    module Tools
+      class NotifyPeer < ::MCP::Tool
+        tool_name 'legion.notify_peer'
+        description 'Send a fire-and-forget async notification to a specific mesh agent.'
+
+        input_schema(
+          properties: {
+            to:      { type: 'string', description: 'Target agent ID' },
+            message: { type: 'string', description: 'Notification content to send' }
+          },
+          required:   %w[to message]
+        )
+
+        class << self
+          def call(to:, message:)
+            return error_response('lex-mesh is not available') unless mesh_available?
+
+            result = mesh_client.send_message(
+              from:    'legion.mcp',
+              to:      to,
+              pattern: :unicast,
+              payload: { message: message }
+            )
+            text_response(result)
+          rescue StandardError => e
+            error_response("Failed to notify peer: #{e.message}")
+          end
+
+          private
+
+          def mesh_available?
+            defined?(Legion::Extensions::Mesh::Client)
+          end
+
+          def mesh_client
+            @mesh_client ||= Legion::Extensions::Mesh::Client.new
+          end
+
+          def text_response(data)
+            ::MCP::Tool::Response.new([{ type: 'text', text: Legion::JSON.dump(data) }])
+          end
+
+          def error_response(msg)
+            ::MCP::Tool::Response.new([{ type: 'text', text: Legion::JSON.dump({ error: msg }) }], error: true)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/legion/mcp/version.rb

@@ -2,6 +2,6 @@
 
 module Legion
   module MCP
-    VERSION = '0.4.1'
+    VERSION = '0.4.2'
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: legion-mcp
 version: !ruby/object:Gem::Version
-  version: 0.4.1
+  version: 0.4.2
 platform: ruby
 authors:
 - Esity
@@ -110,6 +110,7 @@ files:
 - ".rubocop.yml"
 - CHANGELOG.md
 - CLAUDE.md
+- CODEOWNERS
 - Gemfile
 - LICENSE
 - README.md
@@ -134,6 +135,8 @@ files:
 - lib/legion/mcp/server.rb
 - lib/legion/mcp/tier_router.rb
 - lib/legion/mcp/tool_governance.rb
+- lib/legion/mcp/tools/ask_peer.rb
+- lib/legion/mcp/tools/broadcast_peers.rb
 - lib/legion/mcp/tools/create_chain.rb
 - lib/legion/mcp/tools/create_relationship.rb
 - lib/legion/mcp/tools/create_schedule.rb
@@ -159,10 +162,13 @@ files:
 - lib/legion/mcp/tools/get_task_logs.rb
 - lib/legion/mcp/tools/list_chains.rb
 - lib/legion/mcp/tools/list_extensions.rb
+- lib/legion/mcp/tools/list_peers.rb
 - lib/legion/mcp/tools/list_relationships.rb
 - lib/legion/mcp/tools/list_schedules.rb
 - lib/legion/mcp/tools/list_tasks.rb
 - lib/legion/mcp/tools/list_workers.rb
+- lib/legion/mcp/tools/mesh_status.rb
+- lib/legion/mcp/tools/notify_peer.rb
 - lib/legion/mcp/tools/plan_action.rb
 - lib/legion/mcp/tools/prompt_list.rb
 - lib/legion/mcp/tools/prompt_run.rb