ask-anychat-mcp 0.1.3 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6cf6958b5eed0908cac43ec76af75571c33b871b1e4ffa3afb99356d16143012
-  data.tar.gz: 3628437ee87c0ab8ea914ba872d7d0128457d3ce966382eac4b2e08a533abb94
+  metadata.gz: 6b50da5003746ae251f776068ad9c9fef8003d7b12eccb8422f0b7d4b8f3f950
+  data.tar.gz: 262d3edeb900d4e734de383c2c2a4410c19ba8d958cee4a0a151b3a514b471cd
 SHA512:
-  metadata.gz: 1026b9516818cf7fc7c53462d14838d116a28ee891d82f76446f2fe9ad8c81e872929486e9227487e19b39195a770894049b07d488d12412576c5024bee8aba1
-  data.tar.gz: 2fce346e1848cba79da04c164935cabd2664ecb48f07be3a3decd72b1da3dd2c9f0e9bbaf8c5e73221584a429b26c88fa91801a6c06759f7e199e5a24ae012ce
+  metadata.gz: 62ca9bbb4f3c743684a6bc7462dc113708b312b7e15b73c327bda065ec53c8117b0d80262153773a902a1bb3851e8b20aaced077328ffb93dd5ffab2666b36d8
+  data.tar.gz: ecf788ecb55faf6fe0465f3049289aa55421773f95b2ed157646f93de8e5d85edcb605a577e9427565528d28c6d202d9d33c0048f2295cfa6437319ac007a597

data/lib/ask/anychat/mcp/tools/browse_pages.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+module Ask
+  module AnyChat
+    module MCP
+      module Tools
+        # Every page an agent may read, across its sources.
+        class BrowsePages < Tool
+          tool_name "ask_anychat_browse_pages"
+          description "List every page an agent may read in a source — the manifest — " \
+                      "with set-aside pages already left out. Use this to find a page, " \
+                      "then read it by reference."
+          params(
+            type: "object",
+            properties: {
+              workspace: {
+                type: "string",
+                description: "The workspace's username"
+              },
+              agent: {
+                type: "string",
+                description: "The agent's handle"
+              },
+              source: {
+                type: "string",
+                description: "The source's handle, as list_sources reports it"
+              }
+            },
+            required: %w[workspace agent source]
+          )
+
+          private
+
+          def run(args)
+            pages = anychat.agent_source_pages(args["workspace"], args["agent"], args["source"])
+            return "This source has no pages yet." if pages.empty?
+
+            "#{pages.length} pages:\n#{pages.map { |p| "#{p['reference']} — #{p['title']}" }.join("\n")}"
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ask/anychat/mcp/tools/get_source.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+module Ask
+  module AnyChat
+    module MCP
+      module Tools
+        # One source of an agent's, and what was carved out of its grant.
+        class GetSource < Tool
+          tool_name "ask_anychat_get_source"
+          description "Show one source an agent reads, by the handle list_sources returns. " \
+                      "Includes which pages were set aside."
+          params(
+            type: "object",
+            properties: {
+              workspace: {
+                type: "string",
+                description: "The workspace's username"
+              },
+              agent: {
+                type: "string",
+                description: "The agent's handle"
+              },
+              source: {
+                type: "string",
+                description: "The source's handle, as list_sources reports it"
+              }
+            },
+            required: %w[workspace agent source]
+          )
+
+          private
+
+          def run(args)
+            source = anychat.agent_source(args["workspace"], args["agent"], args["source"])
+
+            lines = [
+              "#{source['name']} (#{source['kind']}) at #{source['address']}"
+            ]
+            if source["excluded_paths"]&.any?
+              lines << "Set aside: #{source['excluded_paths'].join(', ')}"
+            else
+              lines << "All pages available."
+            end
+            lines.join("\n")
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ask/anychat/mcp/tools/list_sources.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+module Ask
+  module AnyChat
+    module MCP
+      module Tools
+        # What an agent reads: the sources it was granted.
+        class ListSources < Tool
+          tool_name "ask_anychat_list_sources"
+          description "List the sources an agent may read — the websites the workspace " \
+                      "connected or the corpora it holds. Use this before browsing or " \
+                      "reading pages, and before changing what an agent answers from."
+          params(
+            type: "object",
+            properties: {
+              workspace: {
+                type: "string",
+                description: "The workspace's username, the first half of /<workspace>/<agent>"
+              },
+              agent: {
+                type: "string",
+                description: "The agent's handle, the second half of /<workspace>/<agent>"
+              }
+            },
+            required: %w[workspace agent]
+          )
+
+          private
+
+          def run(args)
+            sources = anychat.agent_sources(args["workspace"], args["agent"])
+            return "This agent has no sources yet." if sources.empty?
+
+            sources.map { |source| line(args["workspace"], args["agent"], source) }.join("\n")
+          end
+
+          def line(workspace, agent, source)
+            parts = ["#{source['name']} at /#{workspace}/#{agent}/#{source['handle']}"]
+            parts << "(#{source['kind']})" if source["kind"]
+            if source["excluded_paths"]&.any?
+              parts << "— set aside: #{source['excluded_paths'].join(', ')}"
+            end
+            parts.join(" ")
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ask/anychat/mcp/tools/read_page.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+module Ask
+  module AnyChat
+    module MCP
+      module Tools
+        # One page of an agent's source, as clean markdown.
+        class ReadPage < Tool
+          tool_name "ask_anychat_read_page"
+          description "Read one page an agent may read, by its reference, as clean " \
+                      "markdown — from the content plane, or from the website itself " \
+                      "when the plane has nothing stored."
+          params(
+            type: "object",
+            properties: {
+              workspace: {
+                type: "string",
+                description: "The workspace's username"
+              },
+              agent: {
+                type: "string",
+                description: "The agent's handle"
+              },
+              source: {
+                type: "string",
+                description: "The source's handle, as list_sources reports it"
+              },
+              reference: {
+                type: "string",
+                description: "The page path, e.g. /pricing or /docs/cli"
+              }
+            },
+            required: %w[workspace agent source reference]
+          )
+
+          private
+
+          def run(args)
+            page = anychat.agent_source_page(
+              args["workspace"], args["agent"], args["source"], args["reference"]
+            )
+
+            "#{page['title']}\n\n#{page['content']}"
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ask/anychat/mcp/tools/search_pages.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+module Ask
+  module AnyChat
+    module MCP
+      module Tools
+        # Search what an agent reads, within the pages it may read.
+        class SearchPages < Tool
+          tool_name "ask_anychat_search_pages"
+          description "Search the pages an agent may read in a source. Returns " \
+                      "references, titles, and snippets — read one by reference " \
+                      "for the whole page."
+          params(
+            type: "object",
+            properties: {
+              workspace: {
+                type: "string",
+                description: "The workspace's username"
+              },
+              agent: {
+                type: "string",
+                description: "The agent's handle"
+              },
+              source: {
+                type: "string",
+                description: "The source's handle, as list_sources reports it"
+              },
+              query: {
+                type: "string",
+                description: "What to look for"
+              }
+            },
+            required: %w[workspace agent source query]
+          )
+
+          private
+
+          def run(args)
+            results = anychat.agent_source_search(
+              args["workspace"], args["agent"], args["source"], args["query"]
+            )
+            return "Nothing found for #{args["query"]}." if results.empty?
+
+            results.map { |r| "#{r['reference']} — #{r['title']}: #{r['snippet']}" }.join("\n")
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ask/anychat/mcp/tools.rb

@@ -5,19 +5,29 @@ require_relative "tools/get_agent"
 require_relative "tools/create_agent"
 require_relative "tools/update_agent"
 require_relative "tools/delete_agent"
+require_relative "tools/list_sources"
+require_relative "tools/get_source"
+require_relative "tools/browse_pages"
+require_relative "tools/read_page"
+require_relative "tools/search_pages"
 
 module Ask
   module AnyChat
     module MCP
       # Every tool this server exposes, in the order a model should reach for
-      # them: read, then write, then retire.
+      # them: agents first, then sources, then pages.
       module Tools
         ALL = [
           ListAgents,
           GetAgent,
           CreateAgent,
           UpdateAgent,
-          DeleteAgent
+          DeleteAgent,
+          ListSources,
+          GetSource,
+          BrowsePages,
+          ReadPage,
+          SearchPages
         ].freeze
       end
     end

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

@@ -3,7 +3,7 @@
 module Ask
   module AnyChat
     module MCP
-      VERSION = "0.1.3"
+      VERSION = "0.2.0"
     end
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ask-anychat-mcp
 version: !ruby/object:Gem::Version
-  version: 0.1.3
+  version: 0.2.0
 platform: ruby
 authors:
 - Kaka Ruto
@@ -85,10 +85,15 @@ files:
 - lib/ask/anychat/mcp.rb
 - lib/ask/anychat/mcp/tool.rb
 - lib/ask/anychat/mcp/tools.rb
+- lib/ask/anychat/mcp/tools/browse_pages.rb
 - lib/ask/anychat/mcp/tools/create_agent.rb
 - lib/ask/anychat/mcp/tools/delete_agent.rb
 - lib/ask/anychat/mcp/tools/get_agent.rb
+- lib/ask/anychat/mcp/tools/get_source.rb
 - lib/ask/anychat/mcp/tools/list_agents.rb
+- lib/ask/anychat/mcp/tools/list_sources.rb
+- lib/ask/anychat/mcp/tools/read_page.rb
+- lib/ask/anychat/mcp/tools/search_pages.rb
 - lib/ask/anychat/mcp/tools/update_agent.rb
 - lib/ask/anychat/mcp/version.rb
 homepage: https://github.com/ask-rb/ask-anychat-mcp