activematrix 0.0.7 → 0.0.8

data/lib/active_matrix/telemetry.rb

@@ -0,0 +1,134 @@
+# frozen_string_literal: true
+
+module ActiveMatrix
+  # OpenTelemetry integration for ActiveMatrix
+  #
+  # Provides distributed tracing for:
+  # - Agent lifecycle (connect, disconnect, error)
+  # - Message handling
+  # - Room operations
+  # - Matrix API calls
+  #
+  # @example Enable with OTLP exporter
+  #   ENV['OTEL_TRACES_EXPORTER'] = 'otlp'
+  #   ENV['OTEL_SERVICE_NAME'] = 'activematrix'
+  #   ActiveMatrix::Telemetry.configure!
+  #
+  # @example Enable with console exporter for debugging
+  #   ActiveMatrix::Telemetry.configure!(exporter: :console)
+  #
+  module Telemetry
+    TRACER_NAME = 'activematrix'
+    TRACER_VERSION = ActiveMatrix::VERSION
+
+    class << self
+      # @return [Boolean] whether OpenTelemetry is available
+      def available?
+        @available ||= begin
+          require 'opentelemetry/sdk'
+          true
+        rescue LoadError
+          false
+        end
+      end
+
+      # @return [Boolean] whether telemetry has been configured
+      def configured?
+        @configured ||= false
+      end
+
+      # Configure OpenTelemetry SDK for ActiveMatrix
+      #
+      # @param exporter [Symbol, nil] :console, :otlp, or nil for env-based config
+      # @param service_name [String] service name for traces
+      def configure!(exporter: nil, service_name: 'activematrix')
+        return false unless available?
+        return true if configured?
+
+        require 'opentelemetry/sdk'
+
+        case exporter
+        when :console
+          require 'opentelemetry/sdk'
+          OpenTelemetry::SDK.configure do |c|
+            c.service_name = service_name
+            c.add_span_processor(
+              OpenTelemetry::SDK::Trace::Export::SimpleSpanProcessor.new(
+                OpenTelemetry::SDK::Trace::Export::ConsoleSpanExporter.new
+              )
+            )
+          end
+        when :otlp
+          require 'opentelemetry/exporter/otlp'
+          ENV['OTEL_SERVICE_NAME'] ||= service_name
+          OpenTelemetry::SDK.configure
+        else
+          # Use environment variables
+          ENV['OTEL_SERVICE_NAME'] ||= service_name
+          OpenTelemetry::SDK.configure
+        end
+
+        @configured = true
+      end
+
+      # Get the ActiveMatrix tracer
+      #
+      # @return [OpenTelemetry::Trace::Tracer, NullTracer]
+      def tracer
+        return NullTracer.instance unless configured?
+
+        OpenTelemetry.tracer_provider.tracer(TRACER_NAME, TRACER_VERSION)
+      end
+
+      # Trace a block of code
+      #
+      # @param name [String] span name
+      # @param attributes [Hash] span attributes
+      # @yield [span] the current span
+      def trace(name, attributes: {}, kind: :internal, &)
+        return yield(NullSpan.instance) unless configured?
+
+        tracer.in_span(name, attributes: attributes, kind: kind, &)
+      end
+
+      # Record an exception on the current span
+      #
+      # @param exception [Exception]
+      # @param attributes [Hash] additional attributes
+      def record_exception(exception, attributes: {})
+        return unless configured?
+
+        span = OpenTelemetry::Trace.current_span
+        span.record_exception(exception, attributes: attributes)
+        span.status = OpenTelemetry::Trace::Status.error(exception.message)
+      end
+
+      # Shutdown the tracer provider
+      def shutdown
+        return unless configured?
+
+        OpenTelemetry.tracer_provider.shutdown
+        @configured = false
+      end
+    end
+
+    # Null tracer for when OTel is not available
+    class NullTracer
+      include Singleton
+
+      def in_span(_name, **_opts)
+        yield NullSpan.instance
+      end
+    end
+
+    # Null span for when OTel is not available
+    class NullSpan
+      include Singleton
+
+      def set_attribute(_key, _value); end
+      def add_event(_name, **_opts); end
+      def record_exception(_exception, **_opts); end
+      def status=(_status); end
+    end
+  end
+end

data/lib/active_matrix/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ActiveMatrix
-  VERSION = '0.0.7'
+  VERSION = '0.0.8'
 end

data/lib/active_matrix.rb

@@ -28,7 +28,9 @@ module ActiveMatrix
                   :conversation_stale_after, :memory_cleanup_interval,
                   :event_queue_size, :event_processing_timeout,
                   :max_clients_per_homeserver, :client_idle_timeout,
-                  :agent_log_level, :log_agent_events
+                  :agent_log_level, :log_agent_events,
+                  # Daemon settings
+                  :daemon_workers, :probe_port, :probe_host, :shutdown_timeout
 
     def initialize
       # Set defaults
@@ -44,6 +46,11 @@ module ActiveMatrix
       @client_idle_timeout = 300 # 5 minutes
       @agent_log_level = :info
       @log_agent_events = false
+      # Daemon defaults
+      @daemon_workers = 1
+      @probe_port = 3042
+      @probe_host = '127.0.0.1'
+      @shutdown_timeout = 30
     end
   end
 
@@ -80,10 +87,13 @@ module ActiveMatrix
   Loader.ignore("#{__dir__}/generators")
   Loader.ignore("#{__dir__}/activematrix.rb")
 
-  # Ignore files that don't follow Zeitwerk naming conventions
+  # Ignore files that don't follow Zeitwerk naming conventions or are standalone
   Loader.ignore("#{__dir__}/active_matrix/errors.rb")
   Loader.ignore("#{__dir__}/active_matrix/events.rb")
   Loader.ignore("#{__dir__}/active_matrix/uri_module.rb")
+  Loader.ignore("#{__dir__}/active_matrix/cli.rb")
+  Loader.ignore("#{__dir__}/active_matrix/daemon.rb")
+  Loader.ignore("#{__dir__}/active_matrix/daemon")
 
   # Configure inflections for special cases
   Loader.inflector.inflect(

data/lib/generators/active_matrix/install/install_generator.rb

@@ -1,22 +1,16 @@
 # frozen_string_literal: true
 
 require 'rails/generators'
-require 'rails/generators/active_record'
 
 module ActiveMatrix
   module Generators
     class InstallGenerator < Rails::Generators::Base
-      include ActiveRecord::Generators::Migration
-
       source_root File.expand_path('templates', __dir__)
 
-      desc 'Creates ActiveMatrix migrations and initializers'
+      desc 'Installs ActiveMatrix initializer and copies migrations'
 
-      def create_migrations
-        migration_template 'create_matrix_agents.rb', 'db/migrate/create_matrix_agents.rb'
-        migration_template 'create_agent_memories.rb', 'db/migrate/create_agent_memories.rb'
-        migration_template 'create_conversation_contexts.rb', 'db/migrate/create_conversation_contexts.rb'
-        migration_template 'create_global_memories.rb', 'db/migrate/create_global_memories.rb'
+      def copy_migrations
+        rails_command 'active_matrix:install:migrations', inline: true
       end
 
       def create_initializer
@@ -26,12 +20,6 @@ module ActiveMatrix
       def display_post_install
         readme 'README' if behavior == :invoke
       end
-
-      private
-
-      def migration_version
-        "[#{ActiveRecord::VERSION::MAJOR}.#{ActiveRecord::VERSION::MINOR}]"
-      end
     end
   end
 end

data/lib/generators/active_matrix/install/templates/README

@@ -2,6 +2,9 @@
 
 ActiveMatrix Multi-Agent System has been installed!
 
+Requirements:
+- PostgreSQL 18+ (for UUIDv7 support)
+
 Next steps:
 
 1. Run migrations:
@@ -11,7 +14,7 @@ Next steps:
    rails generate active_matrix:bot MyFirstBot
 
 3. Configure your agents in the Rails console:
-   agent = MatrixAgent.create!(
+   agent = ActiveMatrix::Agent.create!(
      name: 'captain',
      homeserver: 'https://matrix.org',
      username: 'captain_bot',
@@ -25,6 +28,6 @@ Next steps:
 Or start individual agents:
    ActiveMatrix::AgentManager.instance.start_agent(agent)
 
-For more information, visit: https://github.com/seuros/agent_smith
+For more information, visit: https://github.com/seuros/activematrix
 
 ===============================================================================

metadata

@@ -1,17 +1,31 @@
 --- !ruby/object:Gem::Specification
 name: activematrix
 version: !ruby/object:Gem::Version
-  version: 0.0.7
+  version: 0.0.8
 platform: ruby
 authors:
 - Abdelkader Boudih
 - Alexander Olofsson
-bindir: bin
+bindir: exe
 cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: maxitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.0'
+- !ruby/object:Gem::Dependency
+  name: opentelemetry-sdk
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -38,6 +52,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: state_machines-mermaid
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: ostruct
   requirement: !ruby/object:Gem::Requirement
@@ -53,7 +81,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: rake
+  name: rails_lens
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -67,7 +95,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: rubocop
+  name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -81,7 +109,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: rubocop-minitest
+  name: rubocop
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -95,7 +123,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: rubocop-performance
+  name: rubocop-minitest
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -109,7 +137,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: rubocop-rails
+  name: rubocop-performance
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -123,7 +151,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: simplecov
+  name: rubocop-rails
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -137,19 +165,19 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: sqlite3
+  name: simplecov
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '2.0'
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '2.0'
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: syslog
   requirement: !ruby/object:Gem::Requirement
@@ -210,86 +238,146 @@ dependencies:
   name: activejob
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '8.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '9'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '8.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '9'
 - !ruby/object:Gem::Dependency
   name: activerecord
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '8.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '9'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '8.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '9'
 - !ruby/object:Gem::Dependency
-  name: bcrypt
+  name: async
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '3.1'
+        version: '2.21'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '3.1'
+        version: '2.21'
+- !ruby/object:Gem::Dependency
+  name: async-http
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.86'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.86'
 - !ruby/object:Gem::Dependency
-  name: concurrent-ruby
+  name: bcrypt
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.2'
+        version: '3.1'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.2'
+        version: '3.1'
 - !ruby/object:Gem::Dependency
   name: railties
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '8.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '9'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '8.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '9'
+- !ruby/object:Gem::Dependency
+  name: pg
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.6'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.6'
 - !ruby/object:Gem::Dependency
   name: state_machines-activerecord
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "<="
+    - - ">="
       - !ruby/object:Gem::Version
         version: 0.100.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "<="
+    - - ">="
       - !ruby/object:Gem::Version
         version: 0.100.0
+- !ruby/object:Gem::Dependency
+  name: thor
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.0'
 - !ruby/object:Gem::Dependency
   name: zeitwerk
   requirement: !ruby/object:Gem::Requirement
@@ -304,19 +392,18 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '2.6'
-description: "ActiveMatrix is a comprehensive Rails-native Matrix SDK that enables
-  developers to build sophisticated multi-agent bot systems \nand real-time communication
-  features. This gem provides deep Rails integration with ActiveRecord models, state
-  machines for \nbot lifecycle management, multi-tiered memory systems, intelligent
-  event routing, connection pooling, and built-in \ninter-agent communication. Perfect
-  for building chatbots, automation systems, monitoring agents, and collaborative
-  AI \nsystems within Rails applications. Features include command handling, room
-  management, media support, end-to-end encryption \ncapabilities, and extensive protocol
-  support (CS, AS, IS, SS).\n"
+description: |
+  ActiveMatrix is a comprehensive Rails-native Matrix SDK that enables developers to build sophisticated multi-agent bot systems
+  and real-time communication features. This gem provides deep Rails integration with ActiveRecord models, state machines for
+  bot lifecycle management, multi-tiered memory systems, intelligent event routing, connection pooling, and built-in
+  inter-agent communication. Perfect for building chatbots, automation systems, monitoring agents, and collaborative AI
+  systems within Rails applications. Features include command handling, room management, media support, end-to-end encryption
+  capabilities, and extensive protocol support (CS, AS, IS, SS).
 email:
 - terminale@gmail.com
 - ace@haxalot.com
-executables: []
+executables:
+- activematrix
 extensions: []
 extra_rdoc_files:
 - CHANGELOG.md
@@ -333,32 +420,44 @@ files:
 - app/models/active_matrix/application_record.rb
 - app/models/active_matrix/chat_session.rb
 - app/models/active_matrix/knowledge_base.rb
+- exe/activematrix
 - lib/active_matrix.rb
 - lib/active_matrix/account_data_cache.rb
 - lib/active_matrix/agent_manager.rb
 - lib/active_matrix/agent_registry.rb
 - lib/active_matrix/api.rb
+- lib/active_matrix/async_query.rb
 - lib/active_matrix/bot.rb
 - lib/active_matrix/bot/base.rb
+- lib/active_matrix/bot/builtin_commands.rb
+- lib/active_matrix/bot/command_parser.rb
 - lib/active_matrix/bot/multi_instance_base.rb
 - lib/active_matrix/cacheable.rb
+- lib/active_matrix/cli.rb
 - lib/active_matrix/client.rb
 - lib/active_matrix/client_pool.rb
+- lib/active_matrix/daemon.rb
+- lib/active_matrix/daemon/probe_server.rb
+- lib/active_matrix/daemon/signal_handler.rb
+- lib/active_matrix/daemon/worker.rb
 - lib/active_matrix/engine.rb
 - lib/active_matrix/errors.rb
 - lib/active_matrix/event_router.rb
 - lib/active_matrix/events.rb
 - lib/active_matrix/extensions.rb
+- lib/active_matrix/instrumentation.rb
 - lib/active_matrix/logging.rb
 - lib/active_matrix/memory.rb
 - lib/active_matrix/memory/agent_memory.rb
 - lib/active_matrix/memory/base.rb
 - lib/active_matrix/memory/conversation_memory.rb
 - lib/active_matrix/memory/global_memory.rb
+- lib/active_matrix/message_dispatcher.rb
+- lib/active_matrix/metrics.rb
 - lib/active_matrix/mxid.rb
+- lib/active_matrix/presence_manager.rb
 - lib/active_matrix/protocols/as.rb
 - lib/active_matrix/protocols/cs.rb
-- lib/active_matrix/protocols/cs/message_relationships.rb
 - lib/active_matrix/protocols/is.rb
 - lib/active_matrix/protocols/msc.rb
 - lib/active_matrix/protocols/ss.rb
@@ -367,6 +466,7 @@ files:
 - lib/active_matrix/room.rb
 - lib/active_matrix/rooms/space.rb
 - lib/active_matrix/state_event_cache.rb
+- lib/active_matrix/telemetry.rb
 - lib/active_matrix/uri_module.rb
 - lib/active_matrix/user.rb
 - lib/active_matrix/version.rb
@@ -377,10 +477,6 @@ files:
 - lib/generators/active_matrix/install/install_generator.rb
 - lib/generators/active_matrix/install/templates/README
 - lib/generators/active_matrix/install/templates/active_matrix.rb
-- lib/generators/active_matrix/install/templates/create_agent_memories.rb
-- lib/generators/active_matrix/install/templates/create_conversation_contexts.rb
-- lib/generators/active_matrix/install/templates/create_global_memories.rb
-- lib/generators/active_matrix/install/templates/create_matrix_agents.rb
 homepage: https://github.com/seuros/activematrix
 licenses:
 - MIT
@@ -409,7 +505,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.7
+rubygems_version: 4.0.1
 specification_version: 4
 summary: Rails-native Matrix SDK for building multi-agent bot systems and real-time
   communication