ask-mcp 0.4.4 → 0.4.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4cccd828fe9bafe8d0873dab258aeef03824f1cce4c425869e9cd777924b7ff7
-  data.tar.gz: d30dbfb82b6e75cc953985f7a8035c71b3b1e31681c42fd1e14133ed19208068
+  metadata.gz: 8719aff67887e47eec36f7e8b8b7c822261cbf6e1120380580747691c4d2ef2b
+  data.tar.gz: a5c2006a33be93158838aa8fc0f0ae69c8f3a1ec2aa07fd1478cf88c50f2aa62
 SHA512:
-  metadata.gz: aa666b423416bf1c5b28181ac7fa535165e23fb1d4f9190dfb02f3395b8788c123a5d4c611784f3df59829d118c6b866fa50bf1bd3dfdbddfe43846d0bcedfd1
-  data.tar.gz: 407317ef9ab950450398c062cacba0c8c8ee05b1e37c7f81897aac6921937ec1bbb6f69ae331631410615f743989bf1b430175b4329f4071837dfa2e382eca85
+  metadata.gz: d5a909234ffdc34be3ee993118ae8145b971f120516e7eef66be8c1bf95b5a9b18e767a366e0abca51f5fd1d573186e60496404afeebcc2d66cc3d371a907a74
+  data.tar.gz: 8c058d280dd5da3aac82fcebe7aacddb3a7c5e8861375e987835294d99cfd6f4f79e12589f47b53773397267fbf7992a44f9548321b65cc6d6a108175fe800af

data/CHANGELOG.md

@@ -1,3 +1,14 @@
+## [0.4.5] - 2026-08-12
+
+### Added
+
+- **`structuredContent` mirroring in ToolServer results** — success results
+  now include a machine-readable `structuredContent` field (MCP 2025-06-18)
+  populated from the JSON text when it parses to an object or array. MCP
+  clients that render structured views (e.g. ZCode's "Structured content"
+  section) now display the parsed result instead of an empty block. Plain
+  text and `:summary` shorthand outputs are unaffected.
+
 ## [0.4.4] - 2026-08-10
 
 ### Fixed

data/lib/ask/mcp/adapters/tool_server.rb

@@ -47,6 +47,9 @@ module Ask
           end
 
           normalized = deep_stringify_keys(arguments)
+          violation = schema_violation(tool, normalized)
+          return error_result(violation) if violation
+
           result = tool.call(normalized)
           wrap_result(result)
         rescue StandardError => e
@@ -58,10 +61,34 @@ module Ask
 
         private
 
+        # Rejects arguments that don't match the tool's declared schema with
+        # a clear message — an unknown or missing parameter surfaces as such
+        # instead of leaking a raw ArgumentError from deep inside the tool.
+        # A tool that declares no schema (or no properties) accepts anything,
+        # preserving the duck-typed behavior for minimal tools.
+        def schema_violation(tool, args)
+          schema = tool.params_schema
+          return nil if schema.nil? || schema.empty?
+
+          properties = schema["properties"] || schema[:properties] || {}
+          allowed = properties.keys.map(&:to_s)
+          return nil if allowed.empty?
+
+          required = Array(schema["required"] || schema[:required]).map(&:to_s)
+
+          missing = required - args.keys
+          return "Missing required parameter(s) for #{tool.name}: #{missing.join(", ")}" if missing.any?
+
+          extra = args.keys - allowed
+          return "Unknown parameter(s) #{extra.join(", ")} for #{tool.name}. Expected: #{allowed.join(", ")}" if extra.any?
+
+          nil
+        end
+
         def wrap_result(result)
           # Plain strings are always a success
           if result.is_a?(String)
-            return { content: [{ type: "text", text: result }], isError: false }
+            return text_result(result)
           end
 
           # Result-like objects (Ask::Result, OpenStruct, etc.)
@@ -79,7 +106,7 @@ module Ask
                  else
                    result.to_s
                  end
-          { content: [{ type: "text", text: text }], isError: false }
+          text_result(text)
         end
 
         def success_result(result, _ok)
@@ -89,13 +116,29 @@ module Ask
                  else
                    output.to_s
                  end
-          { content: [{ type: "text", text: text }], isError: false }
+          text_result(text)
         end
 
         def error_result(message)
           { content: [{ type: "text", text: "Error: #{message}" }], isError: true }
         end
 
+        # Builds a success result. Mirrors JSON text into `structuredContent`
+        # (MCP 2025-06-18) when it parses, so clients can render a structured
+        # view instead of an empty section.
+        def text_result(text)
+          { content: [{ type: "text", text: text }], isError: false }.merge(structured_content_for(text))
+        end
+
+        def structured_content_for(text)
+          parsed = JSON.parse(text)
+          return {} unless parsed.is_a?(Hash) || parsed.is_a?(Array)
+
+          { structuredContent: parsed }
+        rescue JSON::ParserError
+          {}
+        end
+
         def deep_stringify_keys(obj)
           case obj
           when Hash then obj.each_with_object({}) { |(k, v), h| h[k.to_s] = deep_stringify_keys(v) }

data/lib/ask/mcp/version.rb

@@ -1,5 +1,5 @@
 module Ask
   module MCP
-    VERSION = "0.4.4"
+    VERSION = "0.4.6"
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ask-mcp
 version: !ruby/object:Gem::Version
-  version: 0.4.4
+  version: 0.4.6
 platform: ruby
 authors:
 - Kaka Ruto
@@ -149,7 +149,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.3
+rubygems_version: 4.0.18
 specification_version: 4
 summary: Model Context Protocol (MCP) client and server for Ruby
 test_files: []