rixie 0.1.0

data/lib/rixie/tool/file_search.rb

@@ -0,0 +1,72 @@
+# frozen_string_literal: true
+
+require_relative "file_sandbox"
+
+module Rixie
+  class Tool
+    DEFAULT_FILE_SEARCH_RESULTS = 50
+    DEFAULT_FILE_SEARCH_GLOB = "**/*"
+    private_constant :DEFAULT_FILE_SEARCH_RESULTS, :DEFAULT_FILE_SEARCH_GLOB
+
+    build = ->(root_dir: nil) {
+      Tool.new(
+        name: "file_search",
+        description: "Search file contents for a regex pattern within the configured root directory. " \
+                     "Returns matching lines in 'path:lineno:content' format. " \
+                     "Binary files are skipped.",
+        input_schema: {
+          type: "object",
+          properties: {
+            pattern: {
+              type: "string",
+              description: "Regex pattern to search for"
+            },
+            glob: {
+              type: "string",
+              description: "Optional glob filter for files. Defaults to '#{DEFAULT_FILE_SEARCH_GLOB}'."
+            },
+            max_results: {
+              type: "integer",
+              description: "Maximum matches to return. Defaults to #{DEFAULT_FILE_SEARCH_RESULTS}."
+            }
+          },
+          required: ["pattern"]
+        },
+        call: ->(args) {
+          begin
+            base = FileSandbox.root(root_dir)
+            pattern = (args["pattern"] || args[:pattern]).to_s
+            glob = (args["glob"] || args[:glob] || DEFAULT_FILE_SEARCH_GLOB).to_s
+            max = (args["max_results"] || args[:max_results] || DEFAULT_FILE_SEARCH_RESULTS).to_i
+            regex = Regexp.new(pattern)
+
+            results = []
+            catch(:done) do
+              Dir.glob(glob, base: base).sort.each do |rel|
+                full = begin
+                  FileSandbox.resolve(base, rel)
+                rescue FileSandbox::PathError
+                  next
+                end
+                next unless File.file?(full)
+                next if FileSandbox.binary?(full)
+
+                File.foreach(full).with_index(1) do |line, lineno|
+                  next unless line.match?(regex)
+                  results << "#{rel}:#{lineno}:#{line.chomp}"
+                  throw :done if results.size >= max
+                end
+              end
+            end
+
+            results.empty? ? "No matches found." : results.join("\n")
+          rescue RegexpError => e
+            "Error: invalid regex: #{e.message}"
+          end
+        }
+      )
+    }
+    FileSearch = build.call
+    FileSearch.define_singleton_method(:with, &build)
+  end
+end

data/lib/rixie/tool/human_input.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module Rixie
+  class Tool
+    HumanInput = Tool.new(
+      name: "human_input",
+      description: "Call this tool when you need input, clarification, or approval from " \
+                   "the user before proceeding. The user will see your question and reply " \
+                   "in the next message.",
+      input_schema: {
+        type: "object",
+        properties: {
+          question: {
+            type: "string",
+            description: "The question or prompt to present to the user"
+          }
+        },
+        required: ["question"]
+      },
+      call: ->(args) { args["question"] },
+      return_direct: true
+    )
+  end
+end

data/lib/rixie/tool/web_search.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module Rixie
+  class Tool
+    build = ->(provider: Search::DuckDuckGo.new, max_results: 5) {
+      Tool.new(
+        name: "web_search",
+        description: "Search the web for current information. Returns a list of relevant results with titles, snippets, and URLs.",
+        input_schema: {
+          type: "object",
+          properties: {
+            query: {
+              type: "string",
+              description: "The search query"
+            }
+          },
+          required: ["query"]
+        },
+        call: ->(args) {
+          results = provider.search(args["query"], max_results: max_results)
+          if results.empty?
+            "No results found."
+          else
+            results.map.with_index(1) { |r, i|
+              "#{i}. #{r[:title]}\n   #{r[:snippet]}\n   URL: #{r[:url]}"
+            }.join("\n\n")
+          end
+        }
+      )
+    }
+    WebSearch = build.call
+    WebSearch.define_singleton_method(:with, &build)
+  end
+end

data/lib/rixie/tool/wikipedia_search.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+module Rixie
+  class Tool
+    build = ->(language: Search::Wikipedia::DEFAULT_LANGUAGE, max_results: Search::Wikipedia::DEFAULT_MAX_RESULTS) {
+      provider = Search::Wikipedia.new(language: language)
+      Tool.new(
+        name: "wikipedia_search",
+        description: "Search Wikipedia for encyclopedic information about people, places, " \
+                     "concepts, or events. Returns titles, snippets, and article URLs. " \
+                     "Use this when you need authoritative reference information rather " \
+                     "than general web results.",
+        input_schema: {
+          type: "object",
+          properties: {
+            query: {
+              type: "string",
+              description: "The search query"
+            }
+          },
+          required: ["query"]
+        },
+        call: ->(args) {
+          results = provider.search(args["query"] || args[:query], max_results: max_results)
+          if results.empty?
+            "No results found."
+          else
+            results.map.with_index(1) { |r, i|
+              "#{i}. #{r[:title]}\n   #{r[:snippet]}\n   URL: #{r[:url]}"
+            }.join("\n\n")
+          end
+        }
+      )
+    }
+    WikipediaSearch = build.call
+    WikipediaSearch.define_singleton_method(:with, &build)
+  end
+end

data/lib/rixie/tool.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module Rixie
+  class Tool
+    attr_reader :name, :description, :input_schema
+
+    def initialize(name:, description:, input_schema:, call:, return_direct: false)
+      @name = name
+      @description = description
+      @input_schema = input_schema
+      @call = call
+      @return_direct = return_direct
+    end
+
+    def return_direct?
+      @return_direct
+    end
+
+    def call(arguments)
+      @call.call(arguments)
+    end
+  end
+end

data/lib/rixie/tool_executor.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module Rixie
+  class ToolExecutor
+    Result = Data.define(:tool_call_id, :content, :error) do
+      def success? = error.nil?
+      def error? = !error.nil?
+    end
+
+    def initialize(tools: [])
+      @tools = tools.each_with_object({}) { |t, h| h[t.name] = t }
+    end
+
+    def execute(tool_call)
+      tool = @tools[tool_call.name]
+      raise Rixie::ToolNotFoundError, "Tool not found: #{tool_call.name.inspect}" if tool.nil?
+
+      content = tool.call(tool_call.arguments)
+      Result.new(tool_call_id: tool_call.id, content: content.to_s, error: nil)
+    rescue ToolNotFoundError
+      raise # configuration bug, not a tool runtime error — let it propagate
+    rescue => e
+      Result.new(tool_call_id: tool_call.id, content: "Error: #{e.message}", error: e)
+    end
+
+    def return_direct?(tool_calls)
+      tool_calls.any? { |tc| @tools[tc.name]&.return_direct? }
+    end
+
+    def definitions
+      @tools.values
+    end
+  end
+end

data/lib/rixie/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Rixie
+  VERSION = "0.1.0"
+end

data/lib/rixie.rb

@@ -0,0 +1,74 @@
+# frozen_string_literal: true
+
+require_relative "rixie/version"
+require_relative "rixie/error"
+require_relative "rixie/http/client"
+require_relative "rixie/configuration"
+require_relative "rixie/event"
+require_relative "rixie/event_listener"
+require_relative "rixie/subscriber"
+require_relative "rixie/subscribers/event_severity"
+require_relative "rixie/subscribers/logger"
+require_relative "rixie/subscribers/json_logger"
+require_relative "rixie/llm/tool_call"
+require_relative "rixie/message"
+require_relative "rixie/llm/response"
+require_relative "rixie/llm/client"
+require_relative "rixie/llm/adapter/dummy"
+require_relative "rixie/tool"
+require_relative "rixie/tool/human_input"
+require_relative "rixie/tool/fetch"
+require_relative "rixie/tool/current_time"
+require_relative "rixie/tool/calculator"
+require_relative "rixie/tool/file_read"
+require_relative "rixie/tool/file_list"
+require_relative "rixie/tool/file_search"
+require_relative "rixie/tool_executor"
+require_relative "rixie/prompt_builder"
+require_relative "rixie/token_counter"
+require_relative "rixie/context/history"
+require_relative "rixie/context/plan"
+require_relative "rixie/context/summary"
+require_relative "rixie/agent"
+require_relative "rixie/agent/plan"
+require_relative "rixie/agent/re_act"
+require_relative "rixie/agent/compressor"
+require_relative "rixie/store/base"
+require_relative "rixie/store/memory"
+require_relative "rixie/store/null"
+require_relative "rixie/run"
+require_relative "rixie/strategy/simple"
+require_relative "rixie/strategy/plan_execute"
+require_relative "rixie/strategy/re_act"
+require_relative "rixie/task"
+require_relative "rixie/session"
+require_relative "rixie/mcp"
+require_relative "rixie/search/base"
+require_relative "rixie/search/duck_duck_go"
+require_relative "rixie/search/wikipedia"
+require_relative "rixie/tool/web_search"
+require_relative "rixie/tool/wikipedia_search"
+
+module Rixie
+  module LLM
+    module Adapter; end
+  end
+
+  class << self
+    def configure
+      yield config
+    end
+
+    def config
+      @config ||= Configuration.new
+    end
+
+    def reset!
+      @config = Configuration.new
+    end
+
+    def logger
+      config.logger
+    end
+  end
+end

data/sig/rixie.rbs

@@ -0,0 +1,4 @@
+module Rixie
+  VERSION: String
+  # See the writing guide of rbs: https://github.com/ruby/rbs#guides
+end

metadata

@@ -0,0 +1,146 @@
+--- !ruby/object:Gem::Specification
+name: rixie
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- madogiwa0124
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: logger
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Rixie is a standalone Ruby gem for orchestrating AI agents. It provides
+  a clean abstraction for LLM communication, tool execution, and multi-step reasoning
+  strategies.
+email:
+- madogiwa0124@gmail.com
+executables:
+- rixie
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE.txt
+- README.md
+- bin/rixie
+- lib/rixie.rb
+- lib/rixie/agent.rb
+- lib/rixie/agent/compressor.rb
+- lib/rixie/agent/plan.rb
+- lib/rixie/agent/re_act.rb
+- lib/rixie/cli.rb
+- lib/rixie/cli/commands.rb
+- lib/rixie/cli/commands/base.rb
+- lib/rixie/cli/commands/compress.rb
+- lib/rixie/cli/commands/context.rb
+- lib/rixie/cli/commands/help.rb
+- lib/rixie/cli/commands/model.rb
+- lib/rixie/cli/commands/strategy.rb
+- lib/rixie/cli/markdown.rb
+- lib/rixie/cli/renderer.rb
+- lib/rixie/cli/spinner.rb
+- lib/rixie/cli/terminal.rb
+- lib/rixie/configuration.rb
+- lib/rixie/context/history.rb
+- lib/rixie/context/plan.rb
+- lib/rixie/context/summary.rb
+- lib/rixie/error.rb
+- lib/rixie/event.rb
+- lib/rixie/event/compression_end.rb
+- lib/rixie/event/compression_start.rb
+- lib/rixie/event/envelope.rb
+- lib/rixie/event/finished.rb
+- lib/rixie/event/llm_call_start.rb
+- lib/rixie/event/run_end.rb
+- lib/rixie/event/run_start.rb
+- lib/rixie/event/task_end.rb
+- lib/rixie/event/task_start.rb
+- lib/rixie/event/thought_completed.rb
+- lib/rixie/event/token.rb
+- lib/rixie/event/tool_call_end.rb
+- lib/rixie/event/tool_call_start.rb
+- lib/rixie/event/tool_calls_completed.rb
+- lib/rixie/event_listener.rb
+- lib/rixie/http/client.rb
+- lib/rixie/llm/adapter/dummy.rb
+- lib/rixie/llm/adapter/openai.rb
+- lib/rixie/llm/client.rb
+- lib/rixie/llm/client/resolver.rb
+- lib/rixie/llm/response.rb
+- lib/rixie/llm/tool_call.rb
+- lib/rixie/mcp.rb
+- lib/rixie/mcp/http.rb
+- lib/rixie/mcp/http/client.rb
+- lib/rixie/message.rb
+- lib/rixie/prompt_builder.rb
+- lib/rixie/run.rb
+- lib/rixie/search/base.rb
+- lib/rixie/search/duck_duck_go.rb
+- lib/rixie/search/wikipedia.rb
+- lib/rixie/session.rb
+- lib/rixie/store/base.rb
+- lib/rixie/store/memory.rb
+- lib/rixie/store/null.rb
+- lib/rixie/strategy/plan_execute.rb
+- lib/rixie/strategy/re_act.rb
+- lib/rixie/strategy/simple.rb
+- lib/rixie/subscriber.rb
+- lib/rixie/subscribers/event_severity.rb
+- lib/rixie/subscribers/json_logger.rb
+- lib/rixie/subscribers/logger.rb
+- lib/rixie/task.rb
+- lib/rixie/token_counter.rb
+- lib/rixie/tool.rb
+- lib/rixie/tool/calculator.rb
+- lib/rixie/tool/current_time.rb
+- lib/rixie/tool/fetch.rb
+- lib/rixie/tool/file_list.rb
+- lib/rixie/tool/file_read.rb
+- lib/rixie/tool/file_sandbox.rb
+- lib/rixie/tool/file_search.rb
+- lib/rixie/tool/human_input.rb
+- lib/rixie/tool/web_search.rb
+- lib/rixie/tool/wikipedia_search.rb
+- lib/rixie/tool_executor.rb
+- lib/rixie/version.rb
+- sig/rixie.rbs
+homepage: https://github.com/madogiwa0124/rixie
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/madogiwa0124/rixie
+  source_code_uri: https://github.com/madogiwa0124/rixie/tree/main
+  changelog_uri: https://github.com/madogiwa0124/rixie/blob/main/CHANGELOG.md
+  bug_tracker_uri: https://github.com/madogiwa0124/rixie/issues
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.4'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.6
+specification_version: 4
+summary: AI agent orchestration for Ruby
+test_files: []