llmemory 0.1.1 → 0.1.7

data/lib/llmemory/dashboard/config/routes.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+Llmemory::Dashboard::Engine.routes.draw do
+  root to: "users#index"
+  get "u/:user_id", to: "users#show", as: :user
+  get "u/:user_id/short_term", to: "short_term#show", as: :user_short_term
+  get "u/:user_id/long_term", to: "long_term#index", as: :user_long_term
+  get "u/:user_id/long_term/categories", to: "long_term#categories", as: :user_long_term_categories
+  get "u/:user_id/graph", to: "graph#index", as: :user_graph
+  get "u/:user_id/stats", to: "stats#index", as: :user_stats
+  get "search", to: "search#index", as: :search
+end

data/lib/llmemory/dashboard/engine.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module Llmemory
+  module Dashboard
+    class Engine < ::Rails::Engine
+      isolate_namespace Llmemory::Dashboard
+    end
+  end
+end

data/lib/llmemory/dashboard.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+unless defined?(Rails)
+  raise LoadError, "llmemory/dashboard requires Rails. " \
+    "Use the CLI for non-Rails environments: `llmemory --help`"
+end
+
+require_relative "dashboard/engine"

data/lib/llmemory/llm.rb

@@ -6,10 +6,11 @@ require_relative "llm/anthropic"
 
 module Llmemory
   module LLM
-    def self.client
+    def self.client(api_key: nil)
+      opts = api_key.to_s.empty? ? {} : { api_key: api_key }
       case Llmemory.configuration.llm_provider.to_sym
-      when :openai then OpenAI.new
-      when :anthropic then Anthropic.new
+      when :openai then OpenAI.new(**opts)
+      when :anthropic then Anthropic.new(**opts)
       else
         raise Llmemory::ConfigurationError, "Unknown LLM provider: #{Llmemory.configuration.llm_provider}"
       end

data/lib/llmemory/long_term/file_based/storages/active_record_storage.rb

@@ -114,6 +114,30 @@ module Llmemory
             LlmemoryResource.where(user_id: user_id, id: resource_ids).destroy_all
           end
 
+          def list_users
+            (LlmemoryResource.distinct.pluck(:user_id) +
+             LlmemoryItem.distinct.pluck(:user_id) +
+             LlmemoryCategory.distinct.pluck(:user_id)).uniq
+          end
+
+          def list_resources(user_id:, limit: nil)
+            scope = LlmemoryResource.where(user_id: user_id).order(:created_at)
+            scope = scope.limit(limit) if limit && limit.to_i.positive?
+            scope.map { |r| row_to_resource(r) }
+          end
+
+          def list_items(user_id:, category: nil, limit: nil)
+            scope = LlmemoryItem.where(user_id: user_id)
+            scope = scope.where(category: category) if category
+            scope = scope.order(:created_at)
+            scope = scope.limit(limit) if limit && limit.to_i.positive?
+            scope.map { |r| row_to_item(r) }
+          end
+
+          def count_items(user_id:)
+            LlmemoryItem.where(user_id: user_id).count
+          end
+
           private
 
           def sanitize_like(str)

data/lib/llmemory/long_term/file_based/storages/base.rb

@@ -64,6 +64,22 @@ module Llmemory
           def archive_resources(user_id, resource_ids)
             raise NotImplementedError, "#{self.class}#archive_resources must be implemented"
           end
+
+          def list_users
+            raise NotImplementedError, "#{self.class}#list_users must be implemented"
+          end
+
+          def list_resources(user_id:, limit: nil)
+            raise NotImplementedError, "#{self.class}#list_resources must be implemented"
+          end
+
+          def list_items(user_id:, category: nil, limit: nil)
+            raise NotImplementedError, "#{self.class}#list_items must be implemented"
+          end
+
+          def count_items(user_id:)
+            raise NotImplementedError, "#{self.class}#count_items must be implemented"
+          end
         end
       end
     end

data/lib/llmemory/long_term/file_based/storages/database_storage.rb

@@ -162,6 +162,41 @@ module Llmemory
             resource_ids.each { |id| conn.exec_params("DELETE FROM llmemory_resources WHERE user_id = $1 AND id = $2", [user_id, id]) }
           end
 
+          def list_users
+            ensure_tables!
+            (conn.exec("SELECT DISTINCT user_id FROM llmemory_resources").map { |r| r["user_id"] } +
+             conn.exec("SELECT DISTINCT user_id FROM llmemory_items").map { |r| r["user_id"] } +
+             conn.exec("SELECT DISTINCT user_id FROM llmemory_categories").map { |r| r["user_id"] }).uniq
+          end
+
+          def list_resources(user_id:, limit: nil)
+            ensure_tables!
+            sql = "SELECT id, text, created_at FROM llmemory_resources WHERE user_id = $1 ORDER BY created_at"
+            sql += " LIMIT #{limit.to_i}" if limit && limit.to_i.positive?
+            rows = conn.exec_params(sql, [user_id])
+            rows_to_resources(rows)
+          end
+
+          def list_items(user_id:, category: nil, limit: nil)
+            ensure_tables!
+            sql = "SELECT id, category, content, source_resource_id, created_at FROM llmemory_items WHERE user_id = $1"
+            params = [user_id]
+            if category
+              sql += " AND category = $2"
+              params << category
+            end
+            sql += " ORDER BY created_at"
+            sql += " LIMIT #{limit.to_i}" if limit && limit.to_i.positive?
+            rows = params.size == 1 ? conn.exec_params(sql, params) : conn.exec_params(sql, params)
+            rows_to_items(rows)
+          end
+
+          def count_items(user_id:)
+            ensure_tables!
+            result = conn.exec_params("SELECT COUNT(*) AS c FROM llmemory_items WHERE user_id = $1", [user_id])
+            result.first["c"].to_i
+          end
+
           private
 
           def conn

data/lib/llmemory/long_term/file_based/storages/file_storage.rb

@@ -124,6 +124,27 @@ module Llmemory
             resource_ids.each { |id| File.delete(resource_path(user_id, id)) if File.file?(resource_path(user_id, id)) }
           end
 
+          def list_users
+            return [] unless Dir.exist?(@base_path)
+            Dir.children(@base_path).select { |e| File.directory?(File.join(@base_path, e)) && !e.start_with?(".") }
+          end
+
+          def list_resources(user_id:, limit: nil)
+            list = get_all_resources(user_id)
+            limit ? list.take(limit) : list
+          end
+
+          def list_items(user_id:, category: nil, limit: nil)
+            list = get_all_items(user_id)
+            list = list.select { |i| (i[:category] || i["category"]).to_s == category.to_s } if category
+            list = list.take(limit) if limit
+            list
+          end
+
+          def count_items(user_id:)
+            get_all_items(user_id).size
+          end
+
           private
 
           def user_path(user_id, *parts)

data/lib/llmemory/long_term/file_based/storages/memory_storage.rb

@@ -93,6 +93,29 @@ module Llmemory
           def archive_resources(user_id, resource_ids)
             @resources[user_id].reject! { |r| resource_ids.include?(r[:id]) }
           end
+
+          def list_users
+            (@resources.keys + @items.keys + @categories.keys).uniq
+          end
+
+          def list_resources(user_id:, limit: nil)
+            list = @resources[user_id].dup
+            limit ? list.take(limit) : list
+          end
+
+          def list_items(user_id:, category: nil, limit: nil)
+            list = if category
+              @items[user_id].select { |i| i[:category].to_s == category.to_s }
+            else
+              @items[user_id].dup
+            end
+            list = list.take(limit) if limit
+            list
+          end
+
+          def count_items(user_id:)
+            @items[user_id].size
+          end
         end
       end
     end

data/lib/llmemory/long_term/graph_based/storages/active_record_storage.rb

@@ -55,8 +55,11 @@ module Llmemory
             record_to_node(rec) if rec
           end
 
-          def list_nodes(user_id)
-            LlmemoryGraphNode.where(user_id: user_id).map { |r| record_to_node(r) }
+          def list_nodes(user_id, entity_type: nil, limit: nil)
+            scope = LlmemoryGraphNode.where(user_id: user_id)
+            scope = scope.where(entity_type: entity_type) if entity_type
+            scope = scope.limit(limit) if limit && limit.to_i.positive?
+            scope.map { |r| record_to_node(r) }
           end
 
           def save_edge(user_id, edge)
@@ -99,6 +102,26 @@ module Llmemory
             true
           end
 
+          def list_users
+            (LlmemoryGraphNode.distinct.pluck(:user_id) + LlmemoryGraphEdge.distinct.pluck(:user_id)).uniq
+          end
+
+          def list_edges(user_id, subject_id: nil, predicate: nil, limit: nil)
+            scope = LlmemoryGraphEdge.where(user_id: user_id, archived_at: nil)
+            scope = scope.where(subject_id: subject_id) if subject_id
+            scope = scope.where(predicate: predicate) if predicate
+            scope = scope.limit(limit) if limit && limit.to_i.positive?
+            scope.map { |r| record_to_edge(r) }
+          end
+
+          def count_nodes(user_id)
+            LlmemoryGraphNode.where(user_id: user_id).count
+          end
+
+          def count_edges(user_id)
+            LlmemoryGraphEdge.where(user_id: user_id, archived_at: nil).count
+          end
+
           private
 
           def record_to_node(r)

data/lib/llmemory/long_term/graph_based/storages/base.rb

@@ -17,7 +17,7 @@ module Llmemory
             raise NotImplementedError, "#{self.class}#find_node_by_name must be implemented"
           end
 
-          def list_nodes(user_id)
+          def list_nodes(user_id, entity_type: nil, limit: nil)
             raise NotImplementedError, "#{self.class}#list_nodes must be implemented"
           end
 
@@ -32,6 +32,22 @@ module Llmemory
           def archive_edge(user_id, edge_id, archived_at: nil)
             raise NotImplementedError, "#{self.class}#archive_edge must be implemented"
           end
+
+          def list_users
+            raise NotImplementedError, "#{self.class}#list_users must be implemented"
+          end
+
+          def list_edges(user_id, subject_id: nil, predicate: nil, limit: nil)
+            raise NotImplementedError, "#{self.class}#list_edges must be implemented"
+          end
+
+          def count_nodes(user_id)
+            raise NotImplementedError, "#{self.class}#count_nodes must be implemented"
+          end
+
+          def count_edges(user_id)
+            raise NotImplementedError, "#{self.class}#count_edges must be implemented"
+          end
         end
       end
     end

data/lib/llmemory/long_term/graph_based/storages/memory_storage.rb

@@ -43,8 +43,10 @@ module Llmemory
             @nodes[user_id].values.find { |n| n.entity_type == entity_type.to_s && n.name.to_s == name.to_s }
           end
 
-          def list_nodes(user_id)
-            @nodes[user_id].values.to_a
+          def list_nodes(user_id, entity_type: nil, limit: nil)
+            list = @nodes[user_id].values
+            list = list.select { |n| n.entity_type.to_s == entity_type.to_s } if entity_type
+            limit ? list.take(limit) : list
           end
 
           def save_edge(user_id, edge)
@@ -99,6 +101,23 @@ module Llmemory
             )
             true
           end
+
+          def list_users
+            (@nodes.keys + @edges.keys).uniq
+          end
+
+          def list_edges(user_id, subject_id: nil, predicate: nil, limit: nil)
+            list = find_edges(user_id, subject_id: subject_id, predicate: predicate, object_id: nil, include_archived: false)
+            limit ? list.take(limit) : list
+          end
+
+          def count_nodes(user_id)
+            @nodes[user_id].size
+          end
+
+          def count_edges(user_id)
+            @edges[user_id].count { |e| !e.archived? }
+          end
         end
       end
     end

data/lib/llmemory/memory.rb

@@ -9,13 +9,14 @@ module Llmemory
     DEFAULT_SESSION_ID = "default"
     STATE_KEY_MESSAGES = :messages
 
-    def initialize(user_id:, session_id: DEFAULT_SESSION_ID, checkpoint: nil, long_term: nil, long_term_type: nil, retrieval_engine: nil)
+    def initialize(user_id:, session_id: DEFAULT_SESSION_ID, checkpoint: nil, long_term: nil, long_term_type: nil, retrieval_engine: nil, api_key: nil)
       @user_id = user_id
       @session_id = session_id
       @checkpoint = checkpoint || ShortTerm::Checkpoint.new(user_id: user_id, session_id: session_id)
+      @llm = api_key.to_s.empty? ? nil : Llmemory::LLM.client(api_key: api_key)
       type = long_term_type || Llmemory.configuration.long_term_type || :file_based
       @long_term = long_term || build_long_term(type)
-      @retrieval_engine = retrieval_engine || Retrieval::Engine.new(@long_term)
+      @retrieval_engine = retrieval_engine || Retrieval::Engine.new(@long_term, llm: @llm)
     end
 
     def add_message(role:, content:)
@@ -58,14 +59,16 @@ module Llmemory
     private
 
     def build_long_term(long_term_type)
+      llm_opts = @llm ? { llm: @llm } : {}
       case long_term_type.to_s.to_sym
       when :graph_based
         LongTerm::GraphBased::Memory.new(
           user_id: @user_id,
-          storage: LongTerm::GraphBased::Storages.build
+          storage: LongTerm::GraphBased::Storages.build,
+          **llm_opts
         )
       else
-        LongTerm::FileBased::Memory.new(user_id: @user_id, storage: LongTerm::FileBased::Storages.build)
+        LongTerm::FileBased::Memory.new(user_id: @user_id, storage: LongTerm::FileBased::Storages.build, **llm_opts)
       end
     end
 

data/lib/llmemory/short_term/stores/active_record_store.rb

@@ -46,6 +46,14 @@ module Llmemory
           true
         end
 
+        def list_users
+          Llmemory::ShortTerm::Stores::ActiveRecordCheckpoint.distinct.pluck(:user_id)
+        end
+
+        def list_sessions(user_id:)
+          Llmemory::ShortTerm::Stores::ActiveRecordCheckpoint.where(user_id: user_id).pluck(:session_id)
+        end
+
         private
 
         def deserialize(data)

data/lib/llmemory/short_term/stores/base.rb

@@ -15,6 +15,14 @@ module Llmemory
         def delete(user_id, session_id)
           raise NotImplementedError, "#{self.class}#delete must be implemented"
         end
+
+        def list_users
+          raise NotImplementedError, "#{self.class}#list_users must be implemented"
+        end
+
+        def list_sessions(user_id:)
+          raise NotImplementedError, "#{self.class}#list_sessions must be implemented"
+        end
       end
     end
   end

data/lib/llmemory/short_term/stores/memory_store.rb

@@ -26,6 +26,15 @@ module Llmemory
           true
         end
 
+        def list_users
+          @store.keys.map { |k| k.split(":", 2).first }.uniq
+        end
+
+        def list_sessions(user_id:)
+          prefix = "#{user_id}:"
+          @store.keys.select { |k| k.start_with?(prefix) }.map { |k| k.split(":", 2).last }
+        end
+
         private
 
         def key_for(user_id, session_id)

data/lib/llmemory/short_term/stores/postgres_store.rb

@@ -44,6 +44,21 @@ module Llmemory
           true
         end
 
+        def list_users
+          ensure_table!
+          result = conn.exec("SELECT DISTINCT user_id FROM llmemory_checkpoints")
+          result.map { |r| r["user_id"] }
+        end
+
+        def list_sessions(user_id:)
+          ensure_table!
+          result = conn.exec_params(
+            "SELECT session_id FROM llmemory_checkpoints WHERE user_id = $1",
+            [user_id]
+          )
+          result.map { |r| r["session_id"] }
+        end
+
         private
 
         def conn

data/lib/llmemory/short_term/stores/redis_store.rb

@@ -26,6 +26,16 @@ module Llmemory
           true
         end
 
+        def list_users
+          keys = redis.keys("llmemory:checkpoint:*:*")
+          keys.map { |k| k.split(":")[2] }.uniq
+        end
+
+        def list_sessions(user_id:)
+          keys = redis.keys("llmemory:checkpoint:#{user_id}:*")
+          keys.map { |k| k.split(":", 4).last }
+        end
+
         private
 
         def redis

data/lib/llmemory/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Llmemory
-  VERSION = "0.1.1"
+  VERSION = "0.1.7"
 end

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: llmemory
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.1.7
 platform: ruby
 authors:
 - llmemory
-autorequire: 
-bindir: bin
+bindir: exe
 cert_chain: []
-date: 2026-02-02 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -70,16 +69,50 @@ description: 'Memory infrastructure for agents: short-term checkpointing, long-t
   file-based and graph-based memory, retrieval with time decay, and maintenance jobs.'
 email:
 - ''
-executables: []
+executables:
+- llmemory
 extensions: []
 extra_rdoc_files: []
 files:
 - LICENSE.txt
 - README.md
+- exe/llmemory
 - lib/generators/llmemory/install/install_generator.rb
 - lib/generators/llmemory/install/templates/create_llmemory_tables.rb
 - lib/llmemory.rb
+- lib/llmemory/cli.rb
+- lib/llmemory/cli/commands/base.rb
+- lib/llmemory/cli/commands/long_term.rb
+- lib/llmemory/cli/commands/long_term/categories.rb
+- lib/llmemory/cli/commands/long_term/edges.rb
+- lib/llmemory/cli/commands/long_term/facts.rb
+- lib/llmemory/cli/commands/long_term/graph.rb
+- lib/llmemory/cli/commands/long_term/nodes.rb
+- lib/llmemory/cli/commands/long_term/resources.rb
+- lib/llmemory/cli/commands/search.rb
+- lib/llmemory/cli/commands/short_term.rb
+- lib/llmemory/cli/commands/stats.rb
+- lib/llmemory/cli/commands/users.rb
 - lib/llmemory/configuration.rb
+- lib/llmemory/dashboard.rb
+- lib/llmemory/dashboard/app/controllers/llmemory/dashboard/application_controller.rb
+- lib/llmemory/dashboard/app/controllers/llmemory/dashboard/graph_controller.rb
+- lib/llmemory/dashboard/app/controllers/llmemory/dashboard/long_term_controller.rb
+- lib/llmemory/dashboard/app/controllers/llmemory/dashboard/search_controller.rb
+- lib/llmemory/dashboard/app/controllers/llmemory/dashboard/short_term_controller.rb
+- lib/llmemory/dashboard/app/controllers/llmemory/dashboard/stats_controller.rb
+- lib/llmemory/dashboard/app/controllers/llmemory/dashboard/users_controller.rb
+- lib/llmemory/dashboard/app/views/layouts/application.html.erb
+- lib/llmemory/dashboard/app/views/llmemory/dashboard/graph/index.html.erb
+- lib/llmemory/dashboard/app/views/llmemory/dashboard/long_term/categories.html.erb
+- lib/llmemory/dashboard/app/views/llmemory/dashboard/long_term/index.html.erb
+- lib/llmemory/dashboard/app/views/llmemory/dashboard/search/index.html.erb
+- lib/llmemory/dashboard/app/views/llmemory/dashboard/short_term/show.html.erb
+- lib/llmemory/dashboard/app/views/llmemory/dashboard/stats/index.html.erb
+- lib/llmemory/dashboard/app/views/llmemory/dashboard/users/index.html.erb
+- lib/llmemory/dashboard/app/views/llmemory/dashboard/users/show.html.erb
+- lib/llmemory/dashboard/config/routes.rb
+- lib/llmemory/dashboard/engine.rb
 - lib/llmemory/extractors.rb
 - lib/llmemory/extractors/entity_relation_extractor.rb
 - lib/llmemory/extractors/fact_extractor.rb
@@ -141,7 +174,6 @@ licenses:
 metadata:
   homepage_uri: https://github.com/entaina/llmemory
   source_code_uri: https://github.com/entaina/llmemory
-post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -156,8 +188,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.10
-signing_key: 
+rubygems_version: 4.0.3
 specification_version: 4
 summary: Persistent memory system for LLM agents
 test_files: []