vector_mcp 0.6.0 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '09966af580b3bf36b9e17f89ef7b592391c42e63b974a17a1db6a852466b9a56'
-  data.tar.gz: 0d04775542e96421bed373179fbfb13864ddfb0aa8256eabea4fddf966d47860
+  metadata.gz: 19883e6171b2fc442256036ec7841130c8ef557f7b5a58c354aa3880c6910907
+  data.tar.gz: 4e5d96fe5172319af0af30f8118704c469ccb9bfc543dead9907b4c42a0b0373
 SHA512:
-  metadata.gz: 33da62c2ffd5dcab4f5e0f7a74426e52885effb4d09c0d82cb479611df838401bfb0de9edb2777a7bb9f21cca190499fa33ff25ee14c46c42a26183b58efa152
-  data.tar.gz: 695aa730c3116bdad34191e3b2b38a0ffea1f10772a2b0e27306f2044b934ab7f576999c13c7bf7568a904af8f82eb8c144830e4a4aebd3aaaec4e8997865430
+  metadata.gz: 276a4391c46cce453ecda4cdb1582f19b0b06f762a737c30e2369bdc4a3e42f6a95f83eef46b62e9cded7e4be28095f780bf0bc8edcfe2f533fea449cabd9e6e
+  data.tar.gz: d57ebbcbd8d8bc3cbbbf110aa3b669ef54ba41fbdcc848f3dd06b2f3bc1610b6be7552ff67d3dd6467498d6240b9e0b761096d0f138656e5a189d4fdd48fac5f

data/CHANGELOG.md

@@ -1,3 +1,15 @@
+## [0.7.0] – 2026-08-15
+
+### Removed (deprecated in 0.6.0)
+
+* **The request-scoped API on `Session`**: `request_context=`, `update_request_context`, `request_headers?`, `request_params?`, `request_header`, `request_param`. Request-scoped data lives on the per-request `VectorMCP::Invocation` passed to handlers; sessions keep only their creation-time context.
+* **`Server#handle_message`'s third `session_id` argument** — the signature is now `handle_message(message, session)`.
+
+### Changed
+
+* **Docs and examples teach the invocation-based handler signatures** (`do |args, invocation|`); handlers written against the legacy security-context argument continue to work via the invocation's forwarded auth API.
+* **Stream handler drops the legacy session-id connection keying** — streaming connections are tracked solely by stream ID (per-stream, resumable); the dead session-id fallback lookups are removed.
+
 ## [0.6.0] – 2026-07-19
 
 ### Added

data/lib/vector_mcp/server/message_handling.rb

@@ -12,12 +12,11 @@ module VectorMCP
       # @param message [Hash] The parsed JSON-RPC message object.
       # @param session [VectorMCP::Session, VectorMCP::Invocation] The session (or per-request
       #   invocation view of it) this message belongs to.
-      # @param session_id [String, nil] Deprecated: defaults to session.id; used only for log prefixes.
       # @return [Object, nil] For requests, returns the result data to be sent in the JSON-RPC response.
       #   For notifications, returns `nil`.
       # @raise [VectorMCP::ProtocolError] if the message is invalid or an error occurs during handling.
-      def handle_message(message, session, session_id = nil)
-        session_id ||= session.id
+      def handle_message(message, session)
+        session_id = session.id
         id = message["id"]
         method = message["method"]
         params = message["params"] || {}

data/lib/vector_mcp/session.rb

@@ -113,69 +113,11 @@ module VectorMCP
       Time.now - @created_at
     end
 
-    # Sets the request context for this session.
-    #
-    # @deprecated Will be removed in 0.7. Request-scoped data travels on the
-    #   per-request {VectorMCP::Invocation} passed to handlers.
-    # @param context [RequestContext, Hash] The request context to set.
-    # @return [RequestContext] The newly set request context.
-    # @raise [ArgumentError] If the context is not a RequestContext or Hash.
-    def request_context=(context)
-      deprecated_request_api(:request_context=)
-      @request_context = case context
-                         when RequestContext
-                           context
-                         when Hash
-                           RequestContext.new(**context)
-                         else
-                           raise ArgumentError, "Request context must be a RequestContext or Hash, got #{context.class}"
-                         end
-    end
-
-    # Updates the request context with new data.
-    #
-    # @deprecated Will be removed in 0.7. Use the per-request invocation's
-    #   {VectorMCP::Invocation#update_request_context} instead.
-    # @param attributes [Hash] The attributes to merge into the request context.
-    # @return [RequestContext] The updated request context.
-    def update_request_context(**attributes)
-      deprecated_request_api(:update_request_context)
-      @request_context = @request_context.merge(attributes)
-    end
-
-    # @deprecated Will be removed in 0.7. Use the per-request invocation's
-    #   {VectorMCP::Invocation#request_headers?} instead.
-    # @return [Boolean] True if the request context has headers.
-    def request_headers?
-      deprecated_request_api(:request_headers?)
-      @request_context.headers?
-    end
-
-    # @deprecated Will be removed in 0.7. Use the per-request invocation's
-    #   {VectorMCP::Invocation#request_params?} instead.
-    # @return [Boolean] True if the request context has parameters.
-    def request_params?
-      deprecated_request_api(:request_params?)
-      @request_context.params?
-    end
-
-    # @deprecated Will be removed in 0.7. Use the per-request invocation's
-    #   {VectorMCP::Invocation#request_header} instead.
-    # @param name [String] The header name.
-    # @return [String, nil] The header value or nil if not found.
-    def request_header(name)
-      deprecated_request_api(:request_header)
-      @request_context.header(name)
-    end
-
-    # @deprecated Will be removed in 0.7. Use the per-request invocation's
-    #   {VectorMCP::Invocation#request_param} instead.
-    # @param name [String] The parameter name.
-    # @return [String, nil] The parameter value or nil if not found.
-    def request_param(name)
-      deprecated_request_api(:request_param)
-      @request_context.param(name)
-    end
+    # NOTE: The request-scoped convenience API that used to live here
+    # (request_context=, update_request_context, request_headers?,
+    # request_params?, request_header, request_param) was removed in 0.7.
+    # Request-scoped data travels on the per-request {VectorMCP::Invocation}
+    # passed to handlers; the session only keeps its creation-time context.
 
     # Helper to check client capabilities later if needed
     # def supports?(capability_key)
@@ -238,16 +180,6 @@ module VectorMCP
 
     private
 
-    # Emit the standard deprecation warning for the request-scoped Session API.
-    # @api private
-    def deprecated_request_api(method_name)
-      VectorMCP.deprecation_warning(
-        "Session##{method_name} is deprecated and will be removed in 0.7; " \
-        "request-scoped data lives on the per-request invocation passed to handlers " \
-        "(e.g. invocation.request_header)"
-      )
-    end
-
     # Validates that sampling can be performed on this session.
     # @api private
     # @raise [StandardError, InitializationError] if preconditions are not met.

data/lib/vector_mcp/transport/http_stream/stream_handler.rb

@@ -223,7 +223,7 @@ module VectorMCP
           loop do
             sleep(30) # Send heartbeat every 30 seconds
 
-            connection = @active_connections[stream_id] || @active_connections[session.id]
+            connection = @active_connections[stream_id]
             break if connection.nil? || connection.closed?
 
             # Check if connection has been alive too long
@@ -278,11 +278,9 @@ module VectorMCP
         # @return [void]
         def cleanup_connection(session, connection = nil)
           connection ||= session.streaming_connection
-          connection ||= @active_connections[session.id]
           return unless connection
 
           @active_connections.delete(connection.stream_id)
-          @active_connections.delete(session.id) if @active_connections[session.id] == connection
 
           connection.close
           @transport.session_manager.remove_streaming_connection(session, connection)
@@ -324,16 +322,9 @@ module VectorMCP
         end
 
         def active_connections_for_session(session)
-          connections = session.streaming_connections.values.select do |connection|
+          session.streaming_connections.values.select do |connection|
             @active_connections[connection.stream_id] == connection && !connection.closed?
           end
-
-          legacy_connection = @active_connections[session.id]
-          connections << legacy_connection if legacy_connection &&
-                                              !legacy_connection.closed? &&
-                                              !connections.include?(legacy_connection)
-
-          connections
         end
 
         def preferred_connection_for(session, connections)

data/lib/vector_mcp/version.rb

@@ -2,5 +2,5 @@
 
 module VectorMCP
   # The current version of the VectorMCP gem.
-  VERSION = "0.6.0"
+  VERSION = "0.7.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: vector_mcp
 version: !ruby/object:Gem::Version
-  version: 0.6.0
+  version: 0.7.0
 platform: ruby
 authors:
 - Sergio Bayona