actionmcp 0.54.0 → 0.55.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8f3d6323b7f8ce694050a031c566f30e33d637116e2869cda61fbbaad0702411
-  data.tar.gz: ef8bfccea1b3109146b3e490340a44c4a6071e08c6aed3bd72ddecd5fd95638a
+  metadata.gz: 24a0298e6a7ed25d658bdb17c2161911a1c8e8ac199a5bd0e2b553a47e1d809f
+  data.tar.gz: 2066c3f6af2375dee54736d44f67b022c791c5b85cb7022cc1abd3ae6e9627f8
 SHA512:
-  metadata.gz: 2665d85224ce5b07a115936d1f1d159b70c8068a8a221e2f196bebd9564b9e753a73acd15b86241b04d277e70dc6dc5db818fecda505cfab9beb999d8483aecb
-  data.tar.gz: 56a568c5aca9693534a46d1013a9fdd8cb168a92e10b6c947dc02bb345f0c0a4f5b812edac990ddaa84c0ba589c500d47b7841f22b8542b1f36a120d2c8a1756
+  metadata.gz: 896039f7d34cae5e00d8e5c01717b12e4d806c2502f5cd6bf8da0a4d1556f30e90f26a4cddd0e7817d72d70443b94054f1071ad3bf40ab48f64e8be3a96e1927
+  data.tar.gz: a5a65421f027c10abcb0015ac8339ef06010c25a25c95eb24b7aba4f52504a813ee4105a10071ac68a66355671e0ee7894ca42a6785d67ccdfdc9f82f53163cd

data/README.md

@@ -357,7 +357,7 @@ ActionMCP includes three session store implementations:
 
 ### Configuration
 
-You can configure the session store type in your Rails configuration:
+You can configure the session store type in your Rails configuration or `config/mcp.yml`:
 
 ```ruby
 # config/application.rb or environment files
@@ -366,11 +366,34 @@ Rails.application.configure do
 end
 ```
 
+Or in `config/mcp.yml`:
+
+```yaml
+# Global session store type (used by both client and server)
+session_store_type: volatile
+
+# Client-specific session store type (falls back to session_store_type if not specified)
+client_session_store_type: volatile
+
+# Server-specific session store type (falls back to session_store_type if not specified)  
+server_session_store_type: active_record
+```
+
 The defaults are:
 - Production: `:active_record`
 - Development: `:volatile`
 - Test: `:volatile` (or `:test` when using TestHelper)
 
+### Separate Client and Server Session Stores
+
+You can configure different session store types for client and server operations:
+
+- **`session_store_type`**: Global setting used by both client and server when specific types aren't set
+- **`client_session_store_type`**: Session store used by ActionMCP client connections (falls back to global setting)
+- **`server_session_store_type`**: Session store used by ActionMCP server sessions (falls back to global setting)
+
+This allows you to optimize each component separately. For example, you might use volatile storage for client sessions (faster, temporary) while using persistent storage for server sessions (maintains state across restarts).
+
 ### Using Different Session Stores
 
 ```ruby

data/app/models/action_mcp/session/message.rb

@@ -4,17 +4,17 @@
 #
 # Table name: action_mcp_session_messages
 #
-#  id                   :bigint           not null, primary key
-#  direction            :string           default("client"), not null
-#  is_ping              :boolean          default(FALSE), not null
-#  message_json         :json
-#  message_type         :string           not null
-#  request_acknowledged :boolean          default(FALSE), not null
-#  request_cancelled    :boolean          default(FALSE), not null
-#  created_at           :datetime         not null
-#  updated_at           :datetime         not null
-#  jsonrpc_id           :string
-#  session_id           :string           not null
+#  id                                     :bigint           not null, primary key
+#  direction(The message recipient)       :string           default("client"), not null
+#  is_ping(Whether the message is a ping) :boolean          default(FALSE), not null
+#  message_json                           :json
+#  message_type(The type of the message)  :string           not null
+#  request_acknowledged                   :boolean          default(FALSE), not null
+#  request_cancelled                      :boolean          default(FALSE), not null
+#  created_at                             :datetime         not null
+#  updated_at                             :datetime         not null
+#  jsonrpc_id                             :string
+#  session_id                             :string           not null
 #
 # Indexes
 #
@@ -22,7 +22,7 @@
 #
 # Foreign Keys
 #
-#  fk_rails_...  (session_id => action_mcp_sessions.id) ON DELETE => cascade ON UPDATE => cascade
+#  fk_action_mcp_session_messages_session_id  (session_id => action_mcp_sessions.id) ON DELETE => cascade ON UPDATE => cascade
 #
 module ActionMCP
   class Session

data/app/models/action_mcp/session.rb

@@ -4,28 +4,28 @@
 #
 # Table name: action_mcp_sessions
 #
-#  id                     :string           not null, primary key
-#  authentication_method  :string           default("none")
-#  client_capabilities    :json
-#  client_info            :json
-#  ended_at               :datetime
-#  initialized            :boolean          default(FALSE), not null
-#  messages_count         :integer          default(0), not null
-#  oauth_access_token     :string
-#  oauth_refresh_token    :string
-#  oauth_token_expires_at :datetime
-#  oauth_user_context     :json
-#  prompt_registry        :json
-#  protocol_version       :string
-#  resource_registry      :json
-#  role                   :string           default("server"), not null
-#  server_capabilities    :json
-#  server_info            :json
-#  sse_event_counter      :integer          default(0), not null
-#  status                 :string           default("pre_initialize"), not null
-#  tool_registry          :json
-#  created_at             :datetime         not null
-#  updated_at             :datetime         not null
+#  id                                                  :string           not null, primary key
+#  authentication_method                               :string           default("none")
+#  client_capabilities(The capabilities of the client) :json
+#  client_info(The information about the client)       :json
+#  ended_at(The time the session ended)                :datetime
+#  initialized                                         :boolean          default(FALSE), not null
+#  messages_count                                      :integer          default(0), not null
+#  oauth_access_token                                  :string
+#  oauth_refresh_token                                 :string
+#  oauth_token_expires_at                              :datetime
+#  oauth_user_context                                  :json
+#  prompt_registry                                     :json
+#  protocol_version                                    :string
+#  resource_registry                                   :json
+#  role(The role of the session)                       :string           default("server"), not null
+#  server_capabilities(The capabilities of the server) :json
+#  server_info(The information about the server)       :json
+#  sse_event_counter                                   :integer          default(0), not null
+#  status                                              :string           default("pre_initialize"), not null
+#  tool_registry                                       :json
+#  created_at                                          :datetime         not null
+#  updated_at                                          :datetime         not null
 #
 # Indexes
 #

data/lib/action_mcp/client/session_store_factory.rb

@@ -20,16 +20,7 @@ module ActionMCP
       end
 
       def self.default_type
-        # Ensure Rails is defined or provide a fallback if this code can run
-        # outside a Rails environment.
-        # Will refactor this soon
-        if defined?(Rails) && Rails.env.test?
-          :volatile  # Use volatile for tests unless explicitly using :test
-        elsif defined?(Rails) && Rails.env.production?
-          :active_record
-        else
-          :volatile # Default for development or non-Rails environments
-        end
+        ActionMCP.configuration.client_session_store_type
       end
     end
   end

data/lib/action_mcp/configuration.rb

@@ -41,6 +41,8 @@ module ActionMCP
                   :gateway_class,
                   # --- Session Store Options ---
                   :session_store_type,
+                  :client_session_store_type,
+                  :server_session_store_type,
                   # --- Pub/Sub and Thread Pool Options ---
                   :adapter,
                   :min_threads,
@@ -75,6 +77,8 @@ module ActionMCP
 
       # Session Store
       @session_store_type = Rails.env.production? ? :active_record : :volatile
+      @client_session_store_type = nil # defaults to session_store_type
+      @server_session_store_type = nil # defaults to session_store_type
     end
 
     def name
@@ -185,6 +189,16 @@ module ActionMCP
       capabilities
     end
 
+    # Get effective client session store type (falls back to global session_store_type)
+    def client_session_store_type
+      @client_session_store_type || @session_store_type
+    end
+
+    # Get effective server session store type (falls back to global session_store_type)
+    def server_session_store_type
+      @server_session_store_type || @session_store_type
+    end
+
     def apply_profile_options
       profile = @profiles[active_profile]
       return unless profile && profile[:options]
@@ -254,6 +268,15 @@ module ActionMCP
       if app_config["connects_to"]
         @connects_to = app_config["connects_to"]
       end
+
+      # Extract client and server session store types
+      if app_config["client_session_store_type"]
+        @client_session_store_type = app_config["client_session_store_type"].to_sym
+      end
+
+      if app_config["server_session_store_type"]
+        @server_session_store_type = app_config["server_session_store_type"].to_sym
+      end
     end
 
     def should_include_all?(type)

data/lib/action_mcp/server/session_store_factory.rb

@@ -19,13 +19,7 @@ module ActionMCP
       end
 
       def self.default_type
-        if Rails.env.test?
-          :volatile # Use volatile for tests unless explicitly using :test
-        elsif Rails.env.production?
-          :active_record
-        else
-          :volatile
-        end
+        ActionMCP.configuration.server_session_store_type
       end
     end
   end

data/lib/action_mcp/server.rb

@@ -31,7 +31,7 @@ module ActionMCP
     # Access the session store
     def session_store
       @session_store ||= SessionStoreFactory.create(
-        ActionMCP.configuration.session_store_type
+        ActionMCP.configuration.server_session_store_type
       )
     end
 

data/lib/action_mcp/version.rb

@@ -2,7 +2,7 @@
 
 require_relative "gem_version"
 module ActionMCP
-  VERSION = "0.54.0"
+  VERSION = "0.55.0"
 
   class << self
     alias version gem_version

data/lib/generators/action_mcp/install/templates/mcp.yml

@@ -6,6 +6,16 @@ shared:
   # Authentication configuration - array of methods to try in order
   authentication: ["none"]  # No authentication required by default
   
+  # Session store configuration
+  # Global session store type used by both client and server (default: volatile in dev/test, active_record in production)
+  # session_store_type: volatile
+  
+  # Client-specific session store type (falls back to session_store_type if not specified)
+  # client_session_store_type: volatile
+  
+  # Server-specific session store type (falls back to session_store_type if not specified)
+  # server_session_store_type: active_record
+  
   # OAuth configuration (if using OAuth authentication)
   # oauth:
   #   provider: "demo_oauth_provider"
@@ -13,7 +23,7 @@ shared:
   #   enable_dynamic_registration: true
   #   enable_token_revocation: true
   #   pkce_required: true
-  #   issuer_url: <%= ENV.fetch("OAUTH_ISSUER_URL") { "https://yourapp.com" } %>
+  #   issuer_url: https://yourapp.com
   
   # MCP capability profiles
   profiles:
@@ -36,13 +46,20 @@ shared:
       options:
         list_changed: false
         logging_enabled: false
-        logging_level: :warn
+        logging_level: warn
         resources_subscribe: false
 
 # Development environment
 development:
   # Use simple pub/sub adapter for development
   adapter: simple
+  
+  # Session store examples for development
+  # Use volatile client sessions for faster development
+  # client_session_store_type: volatile
+  # Use persistent server sessions to maintain state across restarts
+  # server_session_store_type: active_record
+  
   # Thread pool configuration (optional)
   # min_threads: 5     # Minimum number of threads in the pool
   # max_threads: 10    # Maximum number of threads in the pool
@@ -55,6 +72,9 @@ test:
   
   # Test adapter for testing
   adapter: test
+  
+  # Use volatile sessions for testing (fast cleanup)
+  # session_store_type: volatile
 
 # Production environment
 production:
@@ -68,7 +88,7 @@ production:
     enable_dynamic_registration: true
     enable_token_revocation: true
     pkce_required: true
-    issuer_url: <%= ENV.fetch("OAUTH_ISSUER_URL") { "https://yourapp.com" } %>
+    issuer_url: https://yourapp.com
   
   # Additional production profiles for external clients
   profiles:
@@ -77,6 +97,13 @@ production:
       prompts: []
       resources: []
   
+  # Production session store configuration
+  # Use persistent storage for production reliability
+  # session_store_type: active_record
+  # Or configure separately:
+  # client_session_store_type: active_record  # Client connections persist across restarts
+  # server_session_store_type: active_record  # Server state persists across deployments
+  
   # Choose one of the following adapters:
   
   # 1. Database-backed adapter (recommended)
@@ -91,8 +118,8 @@ production:
 
   # 2. Redis-backed adapter (alternative)
   # adapter: redis
-  # url: <%= ENV.fetch("REDIS_URL") { "redis://localhost:6379/1" } %>
-  # channel_prefix: <%= Rails.application.class.module_parent_name.underscore %>_production
+  # url: redis://localhost:6379/1
+  # channel_prefix: my_mcp_app_production
   # min_threads: 10    # Minimum number of threads in the pool
   # max_threads: 20    # Maximum number of threads in the pool
   # max_queue: 500     # Maximum number of tasks that can be queued

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: actionmcp
 version: !ruby/object:Gem::Version
-  version: 0.54.0
+  version: 0.55.0
 platform: ruby
 authors:
 - Abdelkader Boudih