activematrix 0.0.5 → 0.0.8

metadata

@@ -1,15 +1,43 @@
 --- !ruby/object:Gem::Specification
 name: activematrix
 version: !ruby/object:Gem::Version
-  version: 0.0.5
+  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:
+    - - ">="
+      - !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: mocha
   requirement: !ruby/object:Gem::Requirement
@@ -24,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
@@ -38,6 +80,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: rails_lens
+  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: rake
   requirement: !ruby/object:Gem::Requirement
@@ -178,76 +234,150 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '3.19'
+- !ruby/object:Gem::Dependency
+  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: concurrent-ruby
+  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: 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.40.0
+        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: 0.40.0
+        version: '1.0'
 - !ruby/object:Gem::Dependency
   name: zeitwerk
   requirement: !ruby/object:Gem::Requirement
@@ -262,12 +392,18 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '2.6'
-description: A Ruby on Rails gem that provides seamless integration with the Matrix
-  protocol, enabling Rails applications to connect and communicate with Matrix servers.
+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
@@ -277,28 +413,49 @@ files:
 - CHANGELOG.md
 - LICENSE.txt
 - README.md
+- app/jobs/active_matrix/application_job.rb
+- app/models/active_matrix/agent.rb
+- app/models/active_matrix/agent/jobs/memory_reaper.rb
+- app/models/active_matrix/agent_store.rb
+- 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/is.rb
@@ -309,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
@@ -319,19 +477,20 @@ 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/agent_memory.rb
-- lib/generators/active_matrix/install/templates/conversation_context.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
-- lib/generators/active_matrix/install/templates/global_memory.rb
-- lib/generators/active_matrix/install/templates/matrix_agent.rb
 homepage: https://github.com/seuros/activematrix
 licenses:
 - MIT
 metadata:
   rubygems_mfa_required: 'true'
+  homepage_uri: https://github.com/seuros/activematrix
+  source_code_uri: https://github.com/seuros/activematrix
+  changelog_uri: https://github.com/seuros/activematrix/blob/master/CHANGELOG.md
+  documentation_uri: https://rubydoc.info/gems/activematrix
+  bug_tracker_uri: https://github.com/seuros/activematrix/issues
+  wiki_uri: https://github.com/seuros/activematrix/wiki
+  tags: matrix, matrix-protocol, matrix-sdk, matrix-api, matrix-client, rails, rails-engine,
+    activerecord, activejob, rails-integration, bot, chatbot, multi-agent, agent-system,
+    bot-framework, real-time, messaging, communication, chat, state-machine
 rdoc_options: []
 require_paths:
 - lib
@@ -346,7 +505,8 @@ 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 gem for connecting to Matrix protocol
+summary: Rails-native Matrix SDK for building multi-agent bot systems and real-time
+  communication
 test_files: []

data/lib/generators/active_matrix/install/templates/agent_memory.rb

@@ -1,47 +0,0 @@
-# frozen_string_literal: true
-
-class AgentMemory < ApplicationRecord
-  belongs_to :matrix_agent
-
-  validates :key, presence: true, uniqueness: { scope: :matrix_agent_id }
-
-  scope :active, -> { where('expires_at IS NULL OR expires_at > ?', Time.current) }
-  scope :expired, -> { where('expires_at <= ?', Time.current) }
-
-  # Automatically clean up expired memories
-  after_commit :schedule_cleanup, if: :expires_at?
-
-  def expired?
-    expires_at.present? && expires_at <= Time.current
-  end
-
-  def ttl=(seconds)
-    self.expires_at = seconds.present? ? Time.current + seconds : nil
-  end
-
-  def ttl
-    return nil unless expires_at.present?
-
-    remaining = expires_at - Time.current
-    [remaining, 0].max
-  end
-
-  # Cache integration
-  def cache_key
-    "agent_memory/#{matrix_agent_id}/#{key}"
-  end
-
-  def write_to_cache
-    Rails.cache.write(cache_key, value, expires_in: ttl)
-  end
-
-  def self.cleanup_expired!
-    expired.destroy_all
-  end
-
-  private
-
-  def schedule_cleanup
-    AgentMemoryCleanupJob.set(wait_until: expires_at).perform_later if defined?(AgentMemoryCleanupJob)
-  end
-end

data/lib/generators/active_matrix/install/templates/conversation_context.rb

@@ -1,72 +0,0 @@
-# frozen_string_literal: true
-
-class ConversationContext < ApplicationRecord
-  belongs_to :matrix_agent
-
-  validates :user_id, presence: true
-  validates :room_id, presence: true
-  validates :user_id, uniqueness: { scope: %i[matrix_agent_id room_id] }
-
-  # Configuration
-  MAX_HISTORY_SIZE = 20
-
-  # Scopes
-  scope :recent, -> { order(last_message_at: :desc) }
-  scope :active, -> { where('last_message_at > ?', 1.hour.ago) }
-  scope :stale, -> { where('last_message_at < ?', 1.day.ago) }
-
-  # Add a message to the history
-  def add_message(message_data)
-    messages = message_history['messages'] || []
-
-    # Add new message
-    messages << {
-      'event_id' => message_data[:event_id],
-      'sender' => message_data[:sender],
-      'content' => message_data[:content],
-      'timestamp' => message_data[:timestamp] || Time.current.to_i
-    }
-
-    # Keep only recent messages
-    messages = messages.last(MAX_HISTORY_SIZE)
-
-    # Update record
-    self.message_history = { 'messages' => messages }
-    self.last_message_at = Time.current
-    self.message_count = messages.size
-    save!
-
-    # Update cache
-    write_to_cache
-  end
-
-  # Get recent messages
-  def recent_messages(limit = 10)
-    messages = message_history['messages'] || []
-    messages.last(limit)
-  end
-
-  # Clear old messages but keep context
-  def prune_history!
-    messages = message_history['messages'] || []
-    self.message_history = { 'messages' => messages.last(5) }
-    save!
-  end
-
-  # Cache integration
-  def cache_key
-    "conversation/#{matrix_agent_id}/#{user_id}/#{room_id}"
-  end
-
-  def write_to_cache
-    Rails.cache.write(cache_key, {
-                        context: context,
-                        recent_messages: recent_messages,
-                        last_message_at: last_message_at
-                      }, expires_in: 1.hour)
-  end
-
-  def self.cleanup_stale!
-    stale.destroy_all
-  end
-end

data/lib/generators/active_matrix/install/templates/create_agent_memories.rb

@@ -1,17 +0,0 @@
-# frozen_string_literal: true
-
-class CreateAgentMemories < ActiveRecord::Migration<%= migration_version %>
-  def change
-    create_table :agent_memories do |t|
-      t.references :matrix_agent, null: false, foreign_key: true
-      t.string :key, null: false
-      t.jsonb :value, default: {}
-      t.datetime :expires_at
-      
-      t.timestamps
-      
-      t.index [:matrix_agent_id, :key], unique: true
-      t.index :expires_at
-    end
-  end
-end

data/lib/generators/active_matrix/install/templates/create_conversation_contexts.rb

@@ -1,21 +0,0 @@
-# frozen_string_literal: true
-
-class CreateConversationContexts < ActiveRecord::Migration<%= migration_version %>
-  def change
-    create_table :conversation_contexts do |t|
-      t.references :matrix_agent, null: false, foreign_key: true
-      t.string :user_id, null: false
-      t.string :room_id, null: false
-      t.jsonb :context, default: {}
-      t.jsonb :message_history, default: { messages: [] }
-      t.datetime :last_message_at
-      t.integer :message_count, default: 0
-      
-      t.timestamps
-      
-      t.index [:matrix_agent_id, :user_id, :room_id], unique: true, name: 'idx_conv_context_unique'
-      t.index :last_message_at
-      t.index :room_id
-    end
-  end
-end

data/lib/generators/active_matrix/install/templates/create_global_memories.rb

@@ -1,20 +0,0 @@
-# frozen_string_literal: true
-
-class CreateGlobalMemories < ActiveRecord::Migration<%= migration_version %>
-  def change
-    create_table :global_memories do |t|
-      t.string :key, null: false
-      t.jsonb :value, default: {}
-      t.string :category
-      t.datetime :expires_at
-      t.boolean :public_read, default: true
-      t.boolean :public_write, default: false
-      
-      t.timestamps
-      
-      t.index :key, unique: true
-      t.index :category
-      t.index :expires_at
-    end
-  end
-end

data/lib/generators/active_matrix/install/templates/create_matrix_agents.rb

@@ -1,26 +0,0 @@
-# frozen_string_literal: true
-
-class CreateMatrixAgents < ActiveRecord::Migration<%= migration_version %>
-  def change
-    create_table :matrix_agents do |t|
-      t.string :name, null: false
-      t.string :homeserver, null: false
-      t.string :username, null: false
-      t.string :encrypted_password
-      t.string :access_token
-      t.string :state, default: 'offline', null: false
-      t.string :bot_class, null: false
-      t.jsonb :settings, default: {}
-      t.string :last_sync_token
-      t.datetime :last_active_at
-      t.integer :rooms_count, default: 0
-      t.integer :messages_handled, default: 0
-      
-      t.timestamps
-      
-      t.index :name, unique: true
-      t.index :state
-      t.index [:homeserver, :username]
-    end
-  end
-end

data/lib/generators/active_matrix/install/templates/global_memory.rb

@@ -1,70 +0,0 @@
-# frozen_string_literal: true
-
-class GlobalMemory < ApplicationRecord
-  validates :key, presence: true, uniqueness: true
-
-  scope :active, -> { where('expires_at IS NULL OR expires_at > ?', Time.current) }
-  scope :expired, -> { where('expires_at <= ?', Time.current) }
-  scope :by_category, ->(category) { where(category: category) }
-  scope :readable, -> { where(public_read: true) }
-  scope :writable, -> { where(public_write: true) }
-
-  def expired?
-    expires_at.present? && expires_at <= Time.current
-  end
-
-  def readable_by?(agent)
-    public_read || (agent.is_a?(MatrixAgent) && agent.admin?)
-  end
-
-  def writable_by?(agent)
-    public_write || (agent.is_a?(MatrixAgent) && agent.admin?)
-  end
-
-  # Cache integration
-  def cache_key
-    "global/#{key}"
-  end
-
-  def write_to_cache
-    return unless active?
-
-    ttl = expires_at.present? ? expires_at - Time.current : nil
-    Rails.cache.write(cache_key, value, expires_in: ttl)
-  end
-
-  def self.get(key)
-    # Try cache first
-    cached = Rails.cache.read("global/#{key}")
-    return cached if cached.present?
-
-    # Fallback to database
-    memory = find_by(key: key)
-    return unless memory&.active?
-
-    memory.write_to_cache
-    memory.value
-  end
-
-  def self.set(key, value, category: nil, expires_in: nil, public_read: true, public_write: false)
-    memory = find_or_initialize_by(key: key)
-    memory.value = value
-    memory.category = category
-    memory.expires_at = expires_in.present? ? Time.current + expires_in : nil
-    memory.public_read = public_read
-    memory.public_write = public_write
-    memory.save!
-    memory.write_to_cache
-    memory
-  end
-
-  def self.cleanup_expired!
-    expired.destroy_all
-  end
-
-  private
-
-  def active?
-    !expired?
-  end
-end