ask-mcp 0.4.3 → 0.4.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 216830ce0b59a08b19729d557bb9401779636c1dca5330fb0e051a23bbdb9f5c
-  data.tar.gz: 15d71f1b331f2e4cd6df5b22f44fa99f05b83ec1ae101ebb6f532b978492aa41
+  metadata.gz: 5d5c902336445279874512b3b83fea5c1f19b0de0640ceefe6d0bc61c6dd6f4e
+  data.tar.gz: a4b94e8307ef2d7b8aa2b2a6fee63a14dd45584f910f6db1c1db4b0826728699
 SHA512:
-  metadata.gz: 3a7911d8b7e26ef924f799caa3e6a22d716245ed8ae3aec3575f9b28da71ee636ff83bd3fcd8af79f9789ecd2c5790a0f0f49f06fa9388dbb5275549b9a075fc
-  data.tar.gz: e5a56e4364d6c6048199151dfb09e117fcf86cc272d4f9a98958899e36ef603ff1d5e903be9f31cac59f20fa6f89faf8221f9ca951230886b6f23ba275a02c58
+  metadata.gz: ef659cb4cedd858c26a7cb8acb5a5cbef3f7dc4d4ec8bd88967cfbcb0437e94d333eb34d7336147298b172ea04fd1715bcae7e2de2ba5133e0b3b81a3d3cd1bf
+  data.tar.gz: 2bf513b38edd2eb62c72ad385908c7483972d11a802f22c5f6b7f8389110d55f2650c5c7ac6ba4a733a135a5de3424b35f2437455d43f466667dfe22c1a3c88d

data/CHANGELOG.md

@@ -1,3 +1,26 @@
+## [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
+
+- **Hash tool results are JSON-serialized instead of emitted raw** —
+  `ToolServer#wrap_result`/`success_result` used `result[:summary]` as the
+  content `text` whenever a Hash result had a `summary` key. When `summary`
+  was itself a Hash (e.g. `schema_graph`'s summary), the server emitted a
+  non-string content item that spec-compliant MCP clients reject. String
+  `summary` values are still honored as a shorthand; any other Hash result is
+  `JSON.generate`d so `text` is always a String.
+
 ## [0.4.3] - 2026-08-04
 
 ### Added

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

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require "json"
+
 module Ask
   module MCP
     module Adapters
@@ -59,7 +61,7 @@ module Ask
         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.)
@@ -69,21 +71,47 @@ module Ask
             return error_result(result.respond_to?(:error_message) ? result.error_message : result.to_s)
           end
 
-          # Everything else — treat as success
-          text = result.is_a?(Hash) ? (result[:summary] || result.to_s) : result.to_s
-          { content: [{ type: "text", text: text }], isError: false }
+          # Everything else — treat as success. Hashes are JSON-serialized so
+          # the content text is always a String (MCP content items require
+          # string `text`). A String `:summary` is honored as a shorthand.
+          text = if result.is_a?(Hash)
+                   result[:summary].is_a?(String) ? result[:summary] : JSON.generate(result)
+                 else
+                   result.to_s
+                 end
+          text_result(text)
         end
 
         def success_result(result, _ok)
           output = result.respond_to?(:output) ? result.output : result.to_s
-          text = output.is_a?(Hash) ? (output[:summary] || output.to_s) : output.to_s
-          { content: [{ type: "text", text: text }], isError: false }
+          text = if output.is_a?(Hash)
+                   output[:summary].is_a?(String) ? output[:summary] : JSON.generate(output)
+                 else
+                   output.to_s
+                 end
+          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.3"
+    VERSION = "0.4.5"
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ask-mcp
 version: !ruby/object:Gem::Version
-  version: 0.4.3
+  version: 0.4.5
 platform: ruby
 authors:
 - Kaka Ruto