ask-web-fetch-mcp 0.6.8 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7e251ef67fddb05e237d910c336a4fbfc58fe5d6c18ae3edcd32986ff8a5601e
-  data.tar.gz: dcee122644c6264a54b9cf5129960a5698af95b7a3ca2425d2bd6285bd1d0014
+  metadata.gz: c93ebb268775dc96095fee1f9843e8dadabd8a8ecf5b4945d29d35ad4ef2479e
+  data.tar.gz: 8e2952f51b68d0274b1a9b6cdbe54cb4355bfe401c15116d630d7cf5d73e47e9
 SHA512:
-  metadata.gz: 9cbf769e93940fb885c002fe19408b11323c9c6f954dd90d2aa1c83cb6ed0682f7bf53ab3eb76ead04e6f9e9ecfd356ba4f655f50eece6d2a90f6bcaf817118b
-  data.tar.gz: 2af9127603559c89ba8401407aa3a092747381ff65073ba53cea330e246f8b3bfc0fed0341df237dc0a820ae36d2a5b49767f5bd36d7785d973b67b5ec6f628d
+  metadata.gz: aa93bb7fcc44565dcd2916dce258c8af427d4f1d5868b8d19bcaf5e3dc2a53f5b038b925b65ce017ae9faca391bbecc70885d9b056542a8d738eea12673fbe4b
+  data.tar.gz: 50ad953f99c9e4611dec53e821188d3bfd2eff785444cc90dbbed536372e8486b3df1afa9a678fe080e5c6abf90093035b50f89e7e03a75e4b7804f613878688

data/CHANGELOG.md

@@ -1,10 +1,20 @@
-## [0.6.7] — 2026-09-09
+## [0.7.0] — 2026-09-09
 
 ### Changed
 
-- Depends on `ask-web-fetch >= 0.7.5` for structured error classes,
-  HTTP status codes on errors, 404 content extraction, agent-native
-  content negotiation, and Turnstile false-positive fix.
+- **Errors are returned as formatted strings, not raised.** The MCP tool
+  now catches `Ask::WebFetch::Error` and returns a formatted error string
+  with class, message, and hint — so the agent gets our gem's diagnostics
+  instead of ZCode's generic "Request timed out" when the fetch takes
+  longer than the transport timeout.
+
+## [0.6.8] — 2026-09-09
+
+### Changed
+
+- Depends on `ask-web-fetch >= 0.7.6` for error hints, structured error
+  classes with HTTP status, 404 content extraction, agent-native content
+  negotiation, and Turnstile false-positive fix.
 
 ## [0.6.0] — 2026-08-12
 

data/lib/ask/web_fetch/mcp/tool.rb

@@ -32,10 +32,9 @@ module Ask
         end
 
         # Returns the fetched markdown (a String is a success for the
-        # adapter) or raises. The terminal verdicts — ParkedDomainError,
-        # EmptyContentError, FetchError — reach the client as their class,
-        # so it never retries the unretryable; transient failures raise
-        # the base Error.
+        # adapter). On failure, returns a formatted error string with the
+        # error class, message, and hint — so the agent gets our gem's
+        # diagnostics instead of ZCode's generic timeout.
         def call(args)
           extra = args.keys.map(&:to_s) - params_schema['properties'].keys
           unless extra.empty?
@@ -48,6 +47,16 @@ module Ask
 
           max_chars = args['max_chars']
           Ask::WebFetch.fetch(url, max_chars: max_chars || Ask::WebFetch::DEFAULT_MAX_CHARS)
+        rescue Ask::WebFetch::Error => e
+          format_error(e)
+        end
+
+        private
+
+        def format_error(e)
+          parts = ["Error: #{e.class.name.split('::').last}: #{e.message}"]
+          parts << "Hint: #{e.hint}" if e.respond_to?(:hint) && e.hint
+          parts.join("\n")
         end
       end
     end

data/lib/ask/web_fetch/mcp/version.rb

@@ -3,7 +3,7 @@
 module Ask
   module WebFetch
     module MCP
-      VERSION = '0.6.8'
+      VERSION = '0.7.0'
     end
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ask-web-fetch-mcp
 version: !ruby/object:Gem::Version
-  version: 0.6.8
+  version: 0.7.0
 platform: ruby
 authors:
 - Kaka Ruto
@@ -29,14 +29,14 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.7.5
+        version: 0.7.6
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.7.5
+        version: 0.7.6
 - !ruby/object:Gem::Dependency
   name: minitest
   requirement: !ruby/object:Gem::Requirement