legion-gaia 0.9.26 → 0.9.27

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0bd458b6bb7a1f5f9625afb623eda2e0d343707d7e1b0c7223112807a01c6156
-  data.tar.gz: 23efe96dd88bf05ed4cba417b956dbcd1245f543c914baa18451ab52bc31fa6f
+  metadata.gz: 6cb8b5e651481a25407e6431621202c5b29e421eb13f7281c02347373169e576
+  data.tar.gz: 781ac8b692dff9d7e1d7e258415b93d99b700967d033b0cde67ed2d930d28f32
 SHA512:
-  metadata.gz: 3d93060f86928ce533879622b08c81944140eae71b9590ee6ba04dd4904e513379fc77d3f6388b023b94ce7ddcbf69554d2bcffb3cc78d27d13fd5599e844290
-  data.tar.gz: cfc4492c4027b02d0ef765808d61e44ebf9a18fa8133750d5910236304cb8d2bdb65f5faf92622f5835855776843bb0e4bab3b6575bc458678c08495dfa07ba4
+  metadata.gz: 915bc653dc93ed27a1fcf2ddc6ecfee1a350465914d6f6600fe4c152c8aa0c309a63845dcb6065b12fc4b9fd8262f688f939c9a8e4b99df57e327d66c73ddca1
+  data.tar.gz: bb37d7e68883d1446176cfab34e49287df418736a82b91bc1cab6e998f19d73dc49f3c6023861eb24c92d82503d792a0b388e15d49f1cff98bccc8ef26d20749

data/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## [0.9.27] - 2026-03-28
+
+### Added
+- `Legion::Gaia::Routes` self-registering Sinatra route module (`lib/legion/gaia/routes.rb`): extracts all `/api/gaia/*` route handlers from LegionIO. Self-registers with `Legion::API.register_library_routes('gaia', Routes)` during boot. Includes fallback helpers for standalone mounting.
+
 ## [0.9.26] - 2026-03-25
 
 ### Added

data/lib/legion/gaia/routes.rb

@@ -0,0 +1,154 @@
+# frozen_string_literal: true
+
+# Self-registering route module for legion-gaia.
+# All routes previously defined in LegionIO/lib/legion/api/gaia.rb now live here
+# and are mounted via Legion::API.register_library_routes when legion-gaia boots.
+#
+# LegionIO/lib/legion/api/gaia.rb is preserved for backward compatibility but guards
+# its registration with defined?(Legion::Gaia::Routes) so double-registration is avoided.
+
+module Legion
+  module Gaia
+    module Routes
+      def self.registered(app) # rubocop:disable Metrics/AbcSize,Metrics/CyclomaticComplexity,Metrics/MethodLength,Metrics/PerceivedComplexity
+        app.helpers do # rubocop:disable Metrics/BlockLength
+          unless method_defined?(:gaia_available?)
+            define_method(:gaia_available?) do
+              defined?(Legion::Gaia) && Legion::Gaia.respond_to?(:started?) && Legion::Gaia.started?
+            end
+          end
+
+          unless method_defined?(:gaia_buffer_max_size)
+            define_method(:gaia_buffer_max_size) do
+              return nil unless defined?(Legion::Gaia::SensoryBuffer)
+
+              Legion::Gaia::SensoryBuffer::MAX_BUFFER_SIZE
+            rescue NameError
+              nil
+            end
+          end
+
+          unless method_defined?(:build_channel_info)
+            define_method(:build_channel_info) do |channel_id, adapter|
+              info = { id: channel_id, started: adapter&.started? || false }
+              info[:capabilities] = adapter.capabilities if adapter.respond_to?(:capabilities)
+              info[:type] = adapter.class.name.split('::').last if adapter
+              info
+            end
+          end
+
+          unless method_defined?(:json_response)
+            define_method(:json_response) do |data, status_code: 200|
+              content_type :json
+              status status_code
+              Legion::JSON.dump({ data: data })
+            end
+          end
+
+          unless method_defined?(:json_error)
+            define_method(:json_error) do |code, message, status_code: 400|
+              content_type :json
+              status status_code
+              Legion::JSON.dump({ error: { code: code, message: message } })
+            end
+          end
+        end
+
+        register_status_route(app)
+        register_channels_route(app)
+        register_buffer_route(app)
+        register_sessions_route(app)
+        register_teams_webhook_route(app)
+      end
+
+      def self.register_status_route(app)
+        app.get '/api/gaia/status' do
+          if gaia_available?
+            json_response(Legion::Gaia.status)
+          else
+            json_response({ started: false }, status_code: 503)
+          end
+        end
+      end
+
+      def self.register_channels_route(app)
+        app.get '/api/gaia/channels' do
+          halt 503, json_error('gaia_unavailable', 'gaia is not started', status_code: 503) unless gaia_available?
+
+          registry = Legion::Gaia.channel_registry
+          return json_response({ channels: [] }) unless registry
+
+          channels = registry.active_channels.map do |ch_id|
+            adapter = registry.adapter_for(ch_id)
+            build_channel_info(ch_id, adapter)
+          end
+
+          json_response({ channels: channels, count: channels.size })
+        end
+      end
+
+      def self.register_buffer_route(app)
+        app.get '/api/gaia/buffer' do
+          halt 503, json_error('gaia_unavailable', 'gaia is not started', status_code: 503) unless gaia_available?
+
+          buffer = Legion::Gaia.sensory_buffer
+          json_response({
+                          depth: buffer&.size || 0,
+                          empty: buffer.nil? || buffer.empty?,
+                          max_size: gaia_buffer_max_size
+                        })
+        end
+      end
+
+      def self.register_sessions_route(app)
+        app.get '/api/gaia/sessions' do
+          halt 503, json_error('gaia_unavailable', 'gaia is not started', status_code: 503) unless gaia_available?
+
+          store = Legion::Gaia.session_store
+          json_response({
+                          count: store&.size || 0,
+                          active: gaia_available?
+                        })
+        end
+      end
+
+      def self.register_teams_webhook_route(app)
+        app.post '/api/channels/teams/webhook' do
+          if defined?(Legion::Logging)
+            Legion::Logging.debug "API: POST /api/channels/teams/webhook params=#{params.keys}"
+          end
+          body = request.body.read
+          activity = Legion::JSON.load(body)
+
+          adapter = Routes.teams_adapter
+          unless adapter
+            if defined?(Legion::Logging)
+              Legion::Logging.warn 'API POST /api/channels/teams/webhook returned 503: teams adapter not available'
+            end
+            halt 503, json_response({ error: 'teams adapter not available' }, status_code: 503)
+          end
+
+          input_frame = adapter.translate_inbound(activity)
+          Legion::Gaia.sensory_buffer&.push(input_frame) if defined?(Legion::Gaia)
+          Legion::Logging.info "API: accepted Teams webhook frame_id=#{input_frame&.id}" if defined?(Legion::Logging)
+          json_response({ status: 'accepted', frame_id: input_frame&.id })
+        end
+      end
+
+      def self.teams_adapter
+        return nil unless defined?(Legion::Gaia) && Legion::Gaia.respond_to?(:channel_registry)
+        return nil unless Legion::Gaia.channel_registry
+
+        Legion::Gaia.channel_registry.adapter_for(:teams)
+      rescue StandardError => e
+        Legion::Logging.warn "Gaia#teams_adapter failed: #{e.message}" if defined?(Legion::Logging)
+        nil
+      end
+
+      class << self
+        private :register_status_route, :register_channels_route, :register_buffer_route,
+                :register_sessions_route, :register_teams_webhook_route
+      end
+    end
+  end
+end

data/lib/legion/gaia/version.rb

@@ -2,6 +2,6 @@
 
 module Legion
   module Gaia
-    VERSION = '0.9.26'
+    VERSION = '0.9.27'
   end
 end

data/lib/legion/gaia.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require 'legion/gaia/version'
+require 'legion/gaia/routes'
 require 'legion/gaia/advisory'
 require 'legion/gaia/audit_observer'
 require 'legion/gaia/settings'
@@ -53,6 +54,7 @@ module Legion
         settings_hash = settings
         settings_hash[:connected] = true if settings_hash
 
+        register_routes
         check_teams_auth
 
         log_info "Legion::Gaia booted (#{@mode}): #{boot_summary}"
@@ -158,6 +160,15 @@ module Legion
 
       private
 
+      def register_routes
+        return unless defined?(Legion::API) && Legion::API.respond_to?(:register_library_routes)
+
+        Legion::API.register_library_routes('gaia', Legion::Gaia::Routes)
+        Legion::Logging.debug 'Legion::Gaia routes registered with API' if defined?(Legion::Logging)
+      rescue StandardError => e
+        Legion::Logging.warn "Legion::Gaia route registration failed: #{e.message}" if defined?(Legion::Logging)
+      end
+
       def boot_agent
         @sensory_buffer = SensoryBuffer.new
         @registry = Registry.instance

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: legion-gaia
 version: !ruby/object:Gem::Version
-  version: 0.9.26
+  version: 0.9.27
 platform: ruby
 authors:
 - Esity
@@ -435,6 +435,7 @@ files:
 - lib/legion/gaia/router/transport/queues/inbound.rb
 - lib/legion/gaia/router/transport/queues/outbound.rb
 - lib/legion/gaia/router/worker_routing.rb
+- lib/legion/gaia/routes.rb
 - lib/legion/gaia/runner_host.rb
 - lib/legion/gaia/sensory_buffer.rb
 - lib/legion/gaia/session_store.rb