actionmcp 0.100.1 → 0.101.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5df97e0bdac66054109edabe63756d639e74bb3068d70d4028bd990b2bee8442
-  data.tar.gz: db73f42cf5307f09e3b4484799057fc10ee4a5341efa58aef99ab25be82abc4c
+  metadata.gz: 9bf1821cef23dc83ceb6798b128cecc43a2585d3bd7c75996824cbfb960f085a
+  data.tar.gz: fb1b755390487c5b4fff6a75e94540470ef21135bed4978465da9f16f8f201c3
 SHA512:
-  metadata.gz: 0fa54e67f4f7c5e60ba16bd708557534e3b374e19e16d8456289e269e3649c4117407d5e6b4c2ce5c3645476084ab7444e81681a7a900953b4d25da50e534ddc
-  data.tar.gz: 1b783e0ddb8c502cf9438049b7f88c74a89e2bb8e48fdd795789741a7de77b12507412c4b66116b299f7a6b7c75b0279bddf787c6ca522e246e66bee139dd694
+  metadata.gz: a0764d4fea510580d99b6b51428b91545bfd17d9e6ae9828a88b127e6d91c2f5f1d77fb0816f4043ed6de596c0c55719d2b16c73efc38a7dedf5ff027a5236a4
+  data.tar.gz: d828f74be45e7b33877b01265a159fcc76961bba326ac4f31205243bd6bbcd5cb1f4935be627d5ae6bb8aad1fa7644f8611b2514637f94cab74eab7f6184a2d8

data/lib/action_mcp/configuration.rb

@@ -47,7 +47,9 @@ module ActionMCP
                   # --- Tasks Options (MCP 2025-11-25) ---
                   :tasks_enabled,
                   :tasks_list_enabled,
-                  :tasks_cancel_enabled
+                  :tasks_cancel_enabled,
+                  # --- Schema Validation Options ---
+                  :validate_structured_content
 
     def initialize
       @logging_enabled = false
@@ -69,6 +71,9 @@ module ActionMCP
       @tasks_list_enabled = true
       @tasks_cancel_enabled = true
 
+      # Schema validation - disabled by default for backward compatibility
+      @validate_structured_content = false
+
       # Gateway - resolved lazily to account for Zeitwerk autoloading
       @gateway_class_name = nil
 

data/lib/action_mcp/output_schema_builder.rb

@@ -127,12 +127,12 @@ module ActionMCP
     end
 
     # Define an object property
-    # @param name [Symbol] Object property name
+    # @param name [Symbol, nil] Object property name. If nil, returns schema directly (for array items)
     # @param required [Boolean] Whether the object is required
     # @param description [String] Property description
     # @param additional_properties [Boolean, Hash] Whether to allow additional properties
     # @param block [Proc] Block defining object properties
-    def object(name, required: false, description: nil, additional_properties: nil, &block)
+    def object(name = nil, required: false, description: nil, additional_properties: nil, &block)
       raise ArgumentError, "Object definition requires a block" unless block_given?
 
       # Create nested builder for object properties
@@ -149,10 +149,14 @@ module ActionMCP
       # Add additionalProperties if specified
       add_additional_properties_to_schema(schema, additional_properties)
 
-      @properties[name.to_s] = schema
-      @required << name.to_s if required
-
-      name.to_s
+      if name
+        @properties[name.to_s] = schema
+        @required << name.to_s if required
+        name.to_s
+      else
+        # Return schema directly for use in array items
+        schema
+      end
     end
 
     # Set additionalProperties for the root schema

data/lib/action_mcp/tool.rb

@@ -490,6 +490,9 @@ module ActionMCP
     # Override render to collect Content objects and support structured content
     def render(structured: nil, **args)
       if structured
+        # Validate structured content against output_schema if enabled
+        validate_structured_content!(structured) if self.class._output_schema
+
         # Render structured content
         set_structured_content(structured)
         structured
@@ -553,6 +556,42 @@ module ActionMCP
       @response.set_structured_content(content)
     end
 
+    # Validates structured content against the declared output_schema
+    # Only runs if validate_structured_content is enabled in configuration
+    # @param content [Hash] The structured content to validate
+    # @raise [StructuredContentValidationError] If content doesn't match schema
+    def validate_structured_content!(content)
+      return unless ActionMCP.configuration.validate_structured_content
+
+      schema = self.class._output_schema
+      return unless schema.present?
+
+      # Lazy load json_schemer - only required if validation is enabled
+      gem "json_schemer", ">= 2.4"
+      require "json_schemer"
+
+      schemer = JSONSchemer.schema(schema.deep_stringify_keys)
+      errors = schemer.validate(deep_stringify_content(content)).to_a
+
+      return if errors.empty?
+
+      error_messages = errors.map { |e| e["error"] }.join(", ")
+      raise ActionMCP::StructuredContentValidationError,
+            "Structured content does not match output_schema: #{error_messages}"
+    end
+
+    # Deep stringify keys for validation (handles symbols and nested structures)
+    def deep_stringify_content(content)
+      case content
+      when Hash
+        content.transform_keys(&:to_s).transform_values { |v| deep_stringify_content(v) }
+      when Array
+        content.map { |v| deep_stringify_content(v) }
+      else
+        content
+      end
+    end
+
     private
 
 

data/lib/action_mcp/version.rb

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

data/lib/action_mcp.rb

@@ -31,6 +31,9 @@ module ActionMCP
   require_relative "action_mcp/version"
   require_relative "action_mcp/client"
 
+  # Error raised when structured content doesn't match the declared output_schema
+  class StructuredContentValidationError < StandardError; end
+
   # Protocol version constants
   SUPPORTED_VERSIONS = [
     "2025-11-25", # The Task Master - Tasks, icons, tool naming, polling SSE

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: actionmcp
 version: !ruby/object:Gem::Version
-  version: 0.100.1
+  version: 0.101.0
 platform: ruby
 authors:
 - Abdelkader Boudih
@@ -125,16 +125,16 @@ dependencies:
   name: json_schemer
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '2.0'
+        version: '2.4'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '2.0'
+        version: '2.4'
 description: A streamlined, production-focused toolkit for building MCP servers in
   Rails applications. Provides essential base classes, authentication gateways, and
   HTTP transport with minimal dependencies.