hellm 0.0.2 → 0.0.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c138b33e657f7ed52bdc37c4b9883574eeef25b6e479d4760922f6e4300a5c30
-  data.tar.gz: be896fe016921e7e0ce7924512ca5277b96d83bdd49b90182996002d0fc73ca6
+  metadata.gz: 11522217c18c262d67881d31f50efb136d43fb3f9465c3ed25cbf95659b927ef
+  data.tar.gz: bf00259cd39073946654e42e8c63a04fe95310fbd94b12d772929c7fc8194b5c
 SHA512:
-  metadata.gz: d516481c8315a8133db672a29c166b45962433693553d15ce725fbf6a0c3070933184cf2b861b82be33ea0b8b5a51ec18e110962d88dccea83583a0c13f49550
-  data.tar.gz: 205aecc4a739328e1860b00a5681a4de55eb5c72172cd174e088d864b86f5c2d920e0b6936f706445e4d5108402cd2301748ccf9618b74b9ea29475a5145315c
+  metadata.gz: cf31d07cca0558b43e1fbbcaf338493e268352867e450b1f98cda732f8728fe5685dbb6a10e23ccb749e7b323d59e3673e0bdaace0a2629c623c83013bb2355d
+  data.tar.gz: 48919c27642fba873c2d4348b933fc899bb3735e42e57590639c058cb835462727c3ac91861754ba279aebf4c82eae7d9e737884c4fbae486130e89534d8fea1

data/ARCHITECTURE.md

@@ -140,6 +140,24 @@ Responsibilities:
 - Builds dynamic Langchain tools that proxy calls into sub-agents
 - Starts a fresh sub-agent session per invocation
 
+### Hellm::Tools::WebFetchTool
+
+Location: lib/hellm/tools/web_fetch_tool.rb
+
+Responsibilities:
+- Reads raw content from HTTP(S) URLs
+- Extracts plain text from HTML pages using Nokogiri
+- Returns resilient error strings for network/parsing failures
+
+### Hellm::Tools::BraveSearchTool
+
+Location: lib/hellm/tools/brave_search_tool.rb
+
+Responsibilities:
+- Calls Brave::SearchApi for web search requests
+- Exposes query/count/offset/country parameters as a tool function
+- Serializes search responses to JSON for agent consumption
+
 ## Configuration Model
 
 Project configuration is stored in a `.hellm` directory with the following structure:
@@ -172,8 +190,8 @@ Current technical risks:
 - Minimal validation of markdown frontmatter means malformed config errors may surface late.
 
 Testing status:
-- RSpec covers core behavior for Builder, Registry, tools, and LLM-free Agent logic.
-- SimpleCov runs with the suite and writes coverage output to log/coverage.
+- RSpec covers core behavior for Builder, Registry, tool classes (including WebFetchTool and BraveSearchTool), and LLM-free Agent logic.
+- SimpleCov runs with the suite and writes coverage output to log/reports/coverage.
 
 ## Future Hardening Priorities
 

data/README.md

@@ -47,7 +47,12 @@ hellm Alfred "Tell me your favorite color and which month fits it."
 
 The framework provides the following tools for agents to use:
 
-* `calculator` - a simple calculator for basic arithmetic operations.
+| Tool Name     | Aliases                 | Description                                             |
+| ------------- | ----------------------- | ------------------------------------------------------- |
+| `calculator`  |                         | a simple calculator for basic arithmetic operations.    |
+| `webfetch`    | `web`                   | fetches web pages or other content from URLs.           |
+| `websearch`   | `web`                   | performs web searches and returns search results.       |
+| `web`         |                         | combines web fetching and web searching capabilities.   |
 
 
 ### Custom Tools

data/VERSION

@@ -1 +1 @@
-0.0.2
+0.0.4

data/example/.hellm/agents/alfred.agent.md

@@ -1,7 +1,7 @@
 ---
 name: Alfred
 description: "General purpose agent."
-tools: [agent]
+tools: [agent, web]
 agents: [Mathematician]
 ---
 

data/example/example2.sh

@@ -0,0 +1,3 @@
+#!/usr/bin/bash
+
+ ../bin/hellm Alfred what products is ubity advertising on its homepage at https://ubity.io

data/lib/brave/search_api/client.rb

@@ -0,0 +1,34 @@
+module Brave
+  module SearchApi
+    class Client
+      BASE_URL = "https://api.search.brave.com/res/v1/web/search"
+
+      def initialize(api_key)
+        @api_key = api_key
+      end
+
+      def search(query, country: nil, count: 10, offset: 0)
+        uri = URI(BASE_URL)
+        params = {
+          q: query,
+          count: count,
+          offset: offset,
+          country: country
+        }
+
+        headers = {
+          "X-Subscription-Token" => @api_key,
+          "Content-Type" => "application/json"
+        }
+
+        response = Net::HTTP.post(uri, params.to_json, headers)
+
+        if response.is_a?(Net::HTTPSuccess)
+          JSON.parse(response.body)
+        else
+          raise "Brave Search API request failed with status #{response.code}: #{response.message}"
+        end
+      end
+    end
+  end
+end

data/lib/brave/search_api.rb

@@ -0,0 +1,10 @@
+require_relative "search_api/client"
+
+module Brave
+  module SearchApi
+    def self.search(query, country: nil, count: 10, offset: 0)
+      client = Client.new(Brave.api_key)
+      client.search(query, country: country, count: count, offset: offset)
+    end
+  end
+end

data/lib/brave.rb

@@ -0,0 +1,7 @@
+require_relative "brave/search_api"
+
+module Brave
+  def self.api_key
+    ENV["BRAVE_API_KEY"]
+  end
+end

data/lib/hellm/agent.rb

@@ -41,8 +41,6 @@ class Hellm::Agent
     self.stream_adapter = stream_adapter || Hellm::StreamAdapter.new
     self.agents = agents || []
     self.tools = tools || []
-    # remove "agent" from tools, this ability is controlled by the presence of agents
-    self.tools.reject!{|t| t == "agent"}
   end
 
 

data/lib/hellm/builder.rb

@@ -1,8 +1,10 @@
+require_relative "markdown_file"
+require_relative "stream_adapter"
 require_relative "agent"
 require_relative "skill"
-require_relative "stream_adapter"
 require_relative "tools/skill_tool"
-require_relative "markdown_file"
+require_relative "tools/web_fetch_tool"
+require_relative "tools/brave_search_tool"
 
 class Hellm::Builder
   attr_accessor :project_dir, :hellm_dir, :stream_adapter
@@ -42,6 +44,8 @@ class Hellm::Builder
   private
     def add_builtin_tools_to_registry
       Hellm::Tools::Registry.instance.add(:calculator) { Langchain::Tool::Calculator.new }
+      Hellm::Tools::Registry.instance.add(:bravesearch) { Hellm::Tools::BraveSearchTool.new }
+      Hellm::Tools::Registry.instance.add(:webfetch) { Hellm::Tools::WebFetchTool.new }
     end
 
     def get_skills_from_project_dir
@@ -69,7 +73,7 @@ class Hellm::Builder
         markdown_file = Hellm::MarkdownFile.read(file)
 
         tools = markdown_file.fetch("tools", [])
-        tools << "skill"
+        tools << "default"
 
         Hellm::Agent.new(
           model: markdown_file.fetch("model"),

data/lib/hellm/tools/brave_search_tool.rb

@@ -0,0 +1,20 @@
+require "brave"
+
+module Hellm::Tools
+  class BraveSearchTool
+    extend Langchain::ToolDefinition
+
+    define_function :search, description: "Performs a web search using 'Brave Search' search engine." do
+      property :query, type: "string", description: "The search query.", required: true
+      property :count, type: "integer", description: "The number of search results to return.", required: false
+      property :offset, type: "integer", description: "The offset for the search results.", required: false
+      property :country, type: "string", description: "The 2-letter country code for the search results.", required: false
+    end
+
+    def search(query:, count: 10, offset: 0, country: nil)
+      results = Brave::SearchApi.search(query, count: count, offset: offset, country: country)
+      results.to_json
+    end
+
+  end
+end

data/lib/hellm/tools/registry.rb

@@ -2,6 +2,14 @@ require_relative "agent_tool_factory"
 
 module Hellm::Tools
   class Registry
+    ALIASES = {
+      "default" => ["skill"],
+      "web" => ["webfetch", "bravesearch"],
+      "websearch" => ["bravesearch"],
+      "agent" => [] # agent tools are dynamically generated from registered agents
+    }
+
+
     def self.instance
       @instance ||= new
     end
@@ -19,6 +27,7 @@ module Hellm::Tools
     end
 
     def get(*tool_names)
+      tool_names = resolve_aliases(*tool_names)
       tools = tool_names.map do |tool_name|
         entry = @tools[tool_name.to_s]
         if entry.nil?
@@ -49,5 +58,11 @@ module Hellm::Tools
       def agent_tool_name(agent_name)
         "agent_tool_" + agent_name.gsub(/[\s-]+/, "_").downcase
       end
+
+      def resolve_aliases(*tool_names)
+        tool_names.map do |tool_name|
+          ALIASES.fetch(tool_name.to_s, [tool_name.to_s])
+        end.flatten
+      end
   end
 end

data/lib/hellm/tools/web_fetch_tool.rb

@@ -0,0 +1,32 @@
+require "open-uri"
+require "nokogiri"
+
+module Hellm::Tools
+  class WebFetchTool
+    extend Langchain::ToolDefinition
+
+    define_function :read, description: "Reads content from a URL. Use this function when you want to get text/binary raw data from the response, e.g. to check the HTML-code of a page." do
+      property :url, type: "string", description: "The URL to read from."
+    end
+
+    define_function :read_text, description: "Reads HTML text content from a URL. Use this function to extract text only from a HTML page." do
+      property :url, type: "string", description: "The URL to read from."
+    end
+
+    def read(url:)
+      URI.open(url).read
+    rescue StandardError => e
+      "Failed to read from URL #{url}: #{e.message}"
+    end
+
+    def read_text(url:)
+      html_content = URI.open(url).read
+      text = Nokogiri::HTML(html_content).text
+      lines = text.lines.map(&:strip).reject(&:empty?)
+      lines.join("\n")
+    rescue StandardError => e
+      "Failed to extract text from URL #{url}: #{e.message}"
+    end
+
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: hellm
 version: !ruby/object:Gem::Version
-  version: 0.0.2
+  version: 0.0.4
 platform: ruby
 authors:
 - ubity UG
@@ -67,19 +67,33 @@ dependencies:
       - !ruby/object:Gem::Version
         version: 1.6.5
 - !ruby/object:Gem::Dependency
-  name: google_search_results
+  name: nokogiri
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.2.0
+        version: 1.19.4
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.2.0
+        version: 1.19.4
+- !ruby/object:Gem::Dependency
+  name: gsearch-parser
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.2.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.2.2
 description: |
   Declarative agentic framework for LLMs, allowing you to build autonomous agents that can perform complex tasks and interact with the world, without writing code.
   Agents and skills are defined in markdown files, quite similar to how Github Copilot works.
@@ -102,7 +116,11 @@ files:
 - example/.hellm/agents/alfred.agent.md
 - example/.hellm/agents/mathematician.agent.md
 - example/.hellm/skills/farben/SKILL.md
-- example/example.sh
+- example/example1.sh
+- example/example2.sh
+- lib/brave.rb
+- lib/brave/search_api.rb
+- lib/brave/search_api/client.rb
 - lib/hellm.rb
 - lib/hellm/agent.rb
 - lib/hellm/builder.rb
@@ -110,8 +128,10 @@ files:
 - lib/hellm/skill.rb
 - lib/hellm/stream_adapter.rb
 - lib/hellm/tools/agent_tool_factory.rb
+- lib/hellm/tools/brave_search_tool.rb
 - lib/hellm/tools/registry.rb
 - lib/hellm/tools/skill_tool.rb
+- lib/hellm/tools/web_fetch_tool.rb
 - lib/hellm/version.rb
 - sig/hellm.rbs
 homepage: https://gitlab.com/ubity/gems/hellm