ask-web-fetch 0.7.0 → 0.7.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6f73de0a29e2d37986a2b05a930640143f5566011782b5d68eed318bd82db746
-  data.tar.gz: 86ee4e5a800bf7fa67df0a652f40f0058ba5e1c1fa00e77a63b737017e61fbf0
+  metadata.gz: efa999aac8d4321c2e8e6d463ace6c3f5ec5e95a62973ad06593c4714e1ffab1
+  data.tar.gz: 9a9e59e8da81bb4238bf1a08b0ba84634553dfd3caac99763a7bb52a54d9ac6e
 SHA512:
-  metadata.gz: 9b3fe951669c892269d18304d4242786637df6b4f1ddd39aa4bfbc70d2241f90193701665f9141f5c7e816ba12e1a7bd5c48b98d2f0748ce1e093cfc70c5cd16
-  data.tar.gz: f372adee62b1ab72695509aa6bac61d105a9dc64e5209d368273c8667fc62145075b978bd572b426bd54a42770a31f0ff192245f9f37b8f9c1c9e121a3fa0360
+  metadata.gz: af1e312f91b9e5ea72679b7e877232cc3e4e9639b3fdf3e98291810377a450a5ce180bb4664ca651c8ccd2084220632890da92fe4eaf8c1ca472e6ba464d60ff
+  data.tar.gz: 3951989986d476f6bc008712e6451ccb148c9fbe33537544061486d15c79443e0368dd668ef40b35287173ad41f569fc519130a9cb5368e78da16eafbcdf2c91

data/lib/ask/web_fetch/tool.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+require 'ask-tools'
+
+module Ask
+  module Tools
+    # The native agent tool for web fetch — the Ask::Tool framing of the
+    # library. Consumed WITHOUT MCP by agent frameworks (ask-agent's
+    # `tool: :web_fetch`, ask-app-server, llm-proxy) that resolve tools
+    # from the Ask::Tools registry. It is a pure adapter: the capability
+    # (chain, collapse, format) lives in Ask::WebFetch, and this file is
+    # loaded only when ask-tools is present (see lib/ask/web_fetch.rb), so
+    # the library itself never depends on it.
+    class WebFetch < Ask::Tool
+      # Chain configuration delegates to the library — swap or extend
+      # backends here or via Ask::WebFetch.backends.
+      def self.backends
+        Ask::WebFetch.backends
+      end
+
+      def self.backends=(chain)
+        Ask::WebFetch.backends = chain
+      end
+
+      description 'Fetch a URL and return its content as clean markdown for LLM consumption. ' \
+                  'Use this to read web pages, articles, and documentation.'
+
+      params(
+        type: 'object',
+        properties: {
+          url: { type: 'string', description: 'The URL to fetch' },
+          max_chars: { type: 'integer', description: 'Maximum number of characters to return (default 20000)' }
+        },
+        required: ['url']
+      )
+
+      def execute(url:, max_chars: Ask::WebFetch::DEFAULT_MAX_CHARS)
+        Ask::Result.ok(data: Ask::WebFetch.fetch(url, max_chars: max_chars))
+      end
+    end
+  end
+end
+
+Ask::Tools.register(Ask::Tools::WebFetch)

data/lib/ask/web_fetch/version.rb

@@ -2,6 +2,6 @@
 
 module Ask
   module WebFetch
-    VERSION = '0.7.0'
+    VERSION = '0.7.1'
   end
 end

data/lib/ask/web_fetch.rb

@@ -10,6 +10,19 @@ require_relative 'web_fetch/backends/crawl4ai'
 require_relative 'web_fetch/backends/jina'
 require_relative 'web_fetch/backends/browser'
 
+# The native agent tool (Ask::Tools::WebFetch) is an OPTIONAL integration:
+# it loads and registers only when ask-tools is present. The library works
+# standalone — backend-only consumers (crawlers, pipelines) pay nothing —
+# while agent frameworks (ask-agent, ask-app-server, llm-proxy) all ship
+# ask-tools and get the registry tool with no extra step. Only the
+# ask-tools miss is swallowed; any other LoadError is real.
+begin
+  require 'ask-tools'
+  require_relative 'web_fetch/tool'
+rescue LoadError => e
+  raise unless e.path == 'ask-tools'
+end
+
 module Ask
   # Fetches a URL and returns its content as clean markdown for LLM
   # consumption. The capability layer: a pluggable backend chain, a

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ask-web-fetch
 version: !ruby/object:Gem::Version
-  version: 0.7.0
+  version: 0.7.1
 platform: ruby
 authors:
 - Kaka Ruto
@@ -107,6 +107,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '3.26'
+- !ruby/object:Gem::Dependency
+  name: ask-tools
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.1'
 description: 'Fetches a URL and converts its content to clean markdown for LLM consumption.
   A pluggable backend chain: pure Ruby httpx + Nokogiri + reverse_markdown by default,
   a Jina Reader fallback for JS-rendered or blocked pages, and a real-Chrome fallback
@@ -133,6 +147,7 @@ files:
 - lib/ask/web_fetch/http.rb
 - lib/ask/web_fetch/markdown.rb
 - lib/ask/web_fetch/noise_filter.rb
+- lib/ask/web_fetch/tool.rb
 - lib/ask/web_fetch/version.rb
 homepage: https://github.com/ask-rb/ask-web-fetch
 licenses: