lex-memory 0.1.2 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 887236dfa6fe8f5f792dc57af29a84b1404bac3938fd3482644e15cbdfde394d
-  data.tar.gz: 751161d389e5b4c2a4ecb690b31c0a2223a2e4a7d205623c40585131dedbd75b
+  metadata.gz: 82f15c25a2be58044cf03787524080a9215578ab854733cf500bc97d68cd3424
+  data.tar.gz: f93a129b74c70e1ae602b14c53967f658171b8ff9b783c14f28ba0c1f9d015e8
 SHA512:
-  metadata.gz: 25fdd67e7aa1b5ed17fbe66253c9a4b925cfd0d82dcc2ccafe63a08f06f7a7126c8b33b99163d415043b43c3456be6a6ff43d1912de27580d255e2e033e176f0
-  data.tar.gz: eda7ac4517f976d8b6f2672c872487e649970df67c1cb89a8249205f8c4294717f965871f6f43e7ab3deb9feefd68df15d1bb2af2f9a57002f2b956036a26f4b
+  metadata.gz: c639e1b1ad0b3a19c454f37704a7b97fcf5e933c079be7d91dfb54215c6bbd334a2f79ae44c381a1560d92a3e7e76bbf8ed3b5b575ccd7c8307c7cec42fd06a6
+  data.tar.gz: a97d6a06e69470aadca4f7fadc92a7f4118818a13203a780506051e83e9f3990023dee1996cfc9863339e709882b24e755e9aaaf4d886e82290e691b950e319d

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 # Changelog
 
-## [Unreleased]
+## [0.2.0] - 2026-03-17
+
+### Added
+- `PersistentStore`: Sequel-backed durable memory storage per agent (write, read, touch, count, total_bytes, eviction)
+- `Quota`: per-agent trace count and byte size limits with LRU/confidence eviction strategies
+- `BatchDecay`: periodic DB-backed confidence reduction with configurable rate and min threshold
 
 ## [0.1.2] - 2026-03-16
 

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    lex-memory (0.1.2)
+    lex-memory (0.2.0)
 
 GEM
   remote: https://rubygems.org/
@@ -76,6 +76,7 @@ GEM
     sqlite3 (2.9.2)
       mini_portile2 (~> 2.8.0)
     sqlite3 (2.9.2-arm64-darwin)
+    sqlite3 (2.9.2-x86_64-linux-gnu)
     unicode-display_width (3.2.0)
       unicode-emoji (~> 4.1)
     unicode-emoji (4.2.0)
@@ -83,6 +84,7 @@ GEM
 PLATFORMS
   arm64-darwin-25
   ruby
+  x86_64-linux
 
 DEPENDENCIES
   lex-memory!

data/lib/legion/extensions/memory/batch_decay.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+module Legion
+  module Extensions
+    module Memory
+      module BatchDecay
+        DEFAULTS = {
+          rate:           0.999,
+          min_confidence: 0.01,
+          interval_hours: 1
+        }.freeze
+
+        class << self
+          def apply!(agent_id: nil, rate: DEFAULTS[:rate], min_confidence: DEFAULTS[:min_confidence])
+            return { updated: 0, evicted: 0 } unless db_ready?
+
+            conn = Legion::Data.connection
+            ds = conn[PersistentStore::TABLE]
+            ds = ds.where(agent_id: agent_id) if agent_id
+
+            updated = ds.where { confidence > min_confidence }
+                        .update(confidence: Sequel[:confidence] * rate)
+
+            evicted = ds.where { confidence <= min_confidence }.delete
+
+            { updated: updated, evicted: evicted }
+          end
+
+          private
+
+          def db_ready?
+            defined?(Legion::Data) && Legion::Data.connection&.table_exists?(PersistentStore::TABLE)
+          rescue StandardError
+            false
+          end
+        end
+      end
+    end
+  end
+end

data/lib/legion/extensions/memory/persistent_store.rb

@@ -0,0 +1,90 @@
+# frozen_string_literal: true
+
+module Legion
+  module Extensions
+    module Memory
+      class PersistentStore
+        TABLE = :memory_traces
+
+        def initialize(agent_id:)
+          @agent_id = agent_id
+        end
+
+        def write(trace_type:, content:, associations: {}, confidence: 1.0)
+          return nil unless db_ready?
+
+          Legion::Data.connection[TABLE].insert(
+            agent_id:     @agent_id,
+            trace_type:   trace_type.to_s,
+            content:      content.is_a?(String) ? content : Legion::JSON.dump(content),
+            associations: Legion::JSON.dump(associations),
+            confidence:   confidence,
+            created_at:   Time.now,
+            accessed_at:  Time.now
+          )
+        end
+
+        def read(trace_type: nil, limit: 50, min_confidence: 0.0)
+          return [] unless db_ready?
+
+          ds = Legion::Data.connection[TABLE].where(agent_id: @agent_id)
+          ds = ds.where(trace_type: trace_type.to_s) if trace_type
+          ds = ds.where { confidence >= min_confidence }
+          ds.order(Sequel.desc(:accessed_at)).limit(limit).all
+        end
+
+        def touch(id)
+          return unless db_ready?
+
+          Legion::Data.connection[TABLE]
+                      .where(id: id, agent_id: @agent_id)
+                      .update(accessed_at: Time.now)
+        end
+
+        def count
+          return 0 unless db_ready?
+
+          Legion::Data.connection[TABLE].where(agent_id: @agent_id).count
+        end
+
+        def total_bytes
+          return 0 unless db_ready?
+
+          Legion::Data.connection[TABLE]
+                      .where(agent_id: @agent_id)
+                      .sum(Sequel.function(:length, :content)) || 0
+        end
+
+        def delete_lowest_confidence(count: 1)
+          return 0 unless db_ready?
+
+          ids = Legion::Data.connection[TABLE]
+                            .where(agent_id: @agent_id)
+                            .order(:confidence)
+                            .limit(count)
+                            .select(:id)
+          Legion::Data.connection[TABLE].where(id: ids).delete
+        end
+
+        def delete_least_recently_used(count: 1)
+          return 0 unless db_ready?
+
+          ids = Legion::Data.connection[TABLE]
+                            .where(agent_id: @agent_id)
+                            .order(:accessed_at)
+                            .limit(count)
+                            .select(:id)
+          Legion::Data.connection[TABLE].where(id: ids).delete
+        end
+
+        private
+
+        def db_ready?
+          defined?(Legion::Data) && Legion::Data.connection&.table_exists?(TABLE)
+        rescue StandardError
+          false
+        end
+      end
+    end
+  end
+end

data/lib/legion/extensions/memory/quota.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+module Legion
+  module Extensions
+    module Memory
+      class Quota
+        DEFAULTS = {
+          max_traces: 10_000,
+          max_bytes:  52_428_800, # 50MB
+          eviction:   :lru
+        }.freeze
+
+        attr_reader :max_traces, :max_bytes, :eviction
+
+        def initialize(**opts)
+          config = DEFAULTS.merge(opts)
+          @max_traces = config[:max_traces]
+          @max_bytes = config[:max_bytes]
+          @eviction = config[:eviction].to_sym
+        end
+
+        def enforce!(store)
+          evict_count = store.count - max_traces
+          evict!(store, evict_count) if evict_count.positive?
+
+          overage = store.total_bytes - max_bytes
+          evict!(store, estimate_eviction_count(overage)) if overage.positive?
+        end
+
+        def within_limits?(store)
+          store.count <= max_traces && store.total_bytes <= max_bytes
+        end
+
+        private
+
+        def evict!(store, count)
+          return if count <= 0
+
+          case eviction
+          when :lru then store.delete_least_recently_used(count: count)
+          when :lowest_confidence then store.delete_lowest_confidence(count: count)
+          end
+        end
+
+        def estimate_eviction_count(overage_bytes)
+          [(overage_bytes / 1024.0 * 10).ceil, 1].max
+        end
+      end
+    end
+  end
+end

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

@@ -3,7 +3,7 @@
 module Legion
   module Extensions
     module Memory
-      VERSION = '0.1.2'
+      VERSION = '0.2.0'
     end
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: lex-memory
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.2.0
 platform: ruby
 authors:
 - Esity
@@ -30,6 +30,7 @@ files:
 - lib/legion/extensions/memory.rb
 - lib/legion/extensions/memory/actors/decay.rb
 - lib/legion/extensions/memory/actors/tier_migration.rb
+- lib/legion/extensions/memory/batch_decay.rb
 - lib/legion/extensions/memory/client.rb
 - lib/legion/extensions/memory/helpers/cache_store.rb
 - lib/legion/extensions/memory/helpers/decay.rb
@@ -38,6 +39,8 @@ files:
 - lib/legion/extensions/memory/helpers/trace.rb
 - lib/legion/extensions/memory/local_migrations/20260316000001_create_memory_traces.rb
 - lib/legion/extensions/memory/local_migrations/20260316000002_create_memory_associations.rb
+- lib/legion/extensions/memory/persistent_store.rb
+- lib/legion/extensions/memory/quota.rb
 - lib/legion/extensions/memory/runners/consolidation.rb
 - lib/legion/extensions/memory/runners/traces.rb
 - lib/legion/extensions/memory/version.rb