ruby_coded 0.1.1

data/lib/ruby_coded/tools/registry.rb

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+require_relative "read_file_tool"
+require_relative "list_directory_tool"
+require_relative "write_file_tool"
+require_relative "edit_file_tool"
+require_relative "create_directory_tool"
+require_relative "delete_path_tool"
+require_relative "run_command_tool"
+
+module RubyCoded
+  module Tools
+    # Builds and manages the set of tools available to the LLM in agentic mode.
+    class Registry
+      READONLY_TOOL_CLASSES = [
+        ReadFileTool,
+        ListDirectoryTool
+      ].freeze
+
+      TOOL_CLASSES = [
+        *READONLY_TOOL_CLASSES,
+        WriteFileTool,
+        EditFileTool,
+        CreateDirectoryTool,
+        DeletePathTool,
+        RunCommandTool
+      ].freeze
+
+      def initialize(project_root:)
+        @project_root = project_root
+      end
+
+      def build_tools
+        @build_tools ||= TOOL_CLASSES.map { |klass| klass.new(project_root: @project_root) }
+      end
+
+      def build_readonly_tools
+        @build_readonly_tools ||= READONLY_TOOL_CLASSES.map { |klass| klass.new(project_root: @project_root) }
+      end
+
+      def safe_tool?(tool_call_name)
+        klass = find_tool_class(tool_call_name)
+        klass && klass.risk_level == BaseTool::SAFE_RISK
+      end
+
+      def risk_level_for(tool_call_name)
+        klass = find_tool_class(tool_call_name)
+        klass&.risk_level || BaseTool::DANGEROUS_RISK
+      end
+
+      private
+
+      # RubyLLM may send the tool name as the short form ("read_file_tool")
+      # or the full namespaced form ("ruby_coded--tools--read_file_tool").
+      # Match on the short class-derived name against the last segment.
+      def find_tool_class(tool_call_name)
+        short = tool_call_name.split("--").last
+        TOOL_CLASSES.find { |k| [short, tool_call_name].include?(tool_name_for(k)) }
+      end
+
+      def tool_name_for(klass)
+        klass.name.split("::").last.gsub(/([a-z])([A-Z])/, '\1_\2').downcase
+      end
+    end
+  end
+end

data/lib/ruby_coded/tools/run_command_tool.rb

@@ -0,0 +1,75 @@
+# frozen_string_literal: true
+
+require "open3"
+require_relative "base_tool"
+
+module RubyCoded
+  module Tools
+    # Execute a shell command in the project directory and return its output
+    class RunCommandTool < BaseTool
+      description "Execute a shell command in the project directory and return its output"
+      risk :dangerous
+
+      TIMEOUT_SECONDS = 30
+      MAX_OUTPUT_CHARS = 5000
+
+      params do
+        string :command, description: "The shell command to execute"
+      end
+
+      def execute(command:)
+        stdout, stderr, status = run_with_timeout(command)
+
+        output = String.new
+        output << stdout unless stdout.empty?
+        output << "\nSTDERR:\n#{stderr}" unless stderr.empty?
+        output << "\nExit code: #{status.exitstatus}"
+
+        truncate_output(output)
+      rescue Errno::ENOENT => e
+        { error: "Command not found: #{e.message}" }
+      rescue StandardError => e
+        { error: "Command failed: #{e.message}" }
+      end
+
+      private
+
+      def run_with_timeout(command)
+        stdin, stdout_io, stderr_io, wait_thr = Open3.popen3(command, chdir: @project_root)
+        stdin.close
+
+        unless wait_thr.join(TIMEOUT_SECONDS)
+          kill_process(wait_thr.pid)
+          raise StandardError, "Command timed out after #{TIMEOUT_SECONDS} seconds"
+        end
+
+        [stdout_io.read, stderr_io.read, wait_thr.value]
+      ensure
+        [stdin, stdout_io, stderr_io].each { |io| io&.close unless io&.closed? }
+      end
+
+      def kill_process(pid)
+        Process.kill("TERM", pid)
+        sleep(0.5)
+        Process.kill("KILL", pid) if process_alive?(pid)
+      rescue Errno::ESRCH, Errno::EPERM
+        # Process already exited or not accessible
+      end
+
+      def process_alive?(pid)
+        Process.kill(0, pid)
+        true
+      rescue Errno::ESRCH, Errno::EPERM
+        false
+      end
+
+      def truncate_output(output)
+        if output.length > MAX_OUTPUT_CHARS
+          "#{output[0, MAX_OUTPUT_CHARS]}...(truncated, #{output.length} total characters)"
+        else
+          output
+        end
+      end
+    end
+  end
+end

data/lib/ruby_coded/tools/system_prompt.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module RubyCoded
+  module Tools
+    module SystemPrompt # :nodoc:
+      TEMPLATE = <<~PROMPT
+        You are a coding assistant with access to the project directory: %<project_root>s
+
+        You have tools to interact with the file system. Use them when the user asks you to read, explore, create, modify, or delete files and directories.
+
+        Guidelines:
+        - Always use paths relative to the project root.
+        - Before making changes, read the relevant files to understand the current state.
+        - Explain what you plan to do before doing it.
+        - The user will be asked to confirm destructive operations (write, edit, delete).
+        - When listing directories, start with the project root to orient yourself.
+        - Be concise in your explanations but thorough in your actions.
+
+        Efficiency:
+        - You have a budget of %<max_write_rounds>d write/edit/delete tool calls that auto-resets when reached, and a hard limit of %<max_total_rounds>d total tool calls per request.
+        - Read operations (read_file, list_directory) do not count toward the write budget.
+        - Use edit_file for targeted changes — avoid rewriting entire files unnecessarily.
+        - If you receive a warning about approaching the total limit, wrap up the most critical changes first.
+      PROMPT
+
+      def self.build(project_root:, max_write_rounds: 50, max_total_rounds: 200)
+        format(TEMPLATE, project_root: project_root, max_write_rounds: max_write_rounds,
+                         max_total_rounds: max_total_rounds)
+      end
+    end
+  end
+end

data/lib/ruby_coded/tools/tool_rejected_error.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module RubyCoded
+  module Tools
+    class ToolRejectedError < StandardError; end
+  end
+end

data/lib/ruby_coded/tools/write_file_tool.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+require_relative "base_tool"
+
+module RubyCoded
+  module Tools
+    # Create a new file or overwrite an existing file with the given content
+    class WriteFileTool < BaseTool
+      description "Create a new file or overwrite an existing file with the given content"
+      risk :confirm
+
+      params do
+        string :path, description: "Relative file path from the project root"
+        string :content, description: "The full content to write into the file"
+      end
+
+      def execute(path:, content:)
+        full_path = validate_path!(path)
+        return full_path if full_path.is_a?(Hash)
+
+        dir = File.dirname(full_path)
+        FileUtils.mkdir_p(dir) unless File.directory?(dir)
+
+        File.write(full_path, content)
+        "File written: #{path} (#{content.bytesize} bytes)"
+      rescue SystemCallError => e
+        { error: "Failed to write #{path}: #{e.message}" }
+      end
+    end
+  end
+end

data/lib/ruby_coded/version.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+# This module contains the version of the RubyCoded gem
+module RubyCoded
+  VERSION = "0.1.1"
+
+  def self.gem_version
+    Gem::Version.new(VERSION).freeze
+  end
+end

data/lib/ruby_coded.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+require_relative "ruby_coded/version"
+require_relative "ruby_coded/config/user_config"
+require_relative "ruby_coded/auth/auth_manager"
+require_relative "ruby_coded/initializer"
+require_relative "ruby_coded/plugins"
+
+raise "This gem requires Ruby 3.3.0 or higher" if Gem::Version.new(RUBY_VERSION) < Gem::Version.new("3.3.0")
+
+# Main module for the RubyCoded gem
+module RubyCoded
+  def self.start
+    Initializer.new
+  end
+end

data/sig/ruby_coded.rbs

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

metadata

@@ -0,0 +1,206 @@
+--- !ruby/object:Gem::Specification
+name: ruby_coded
+version: !ruby/object:Gem::Version
+  version: 0.1.1
+platform: ruby
+authors:
+- Cesar Rodriguez
+autorequire:
+bindir: exe
+cert_chain: []
+date: 2026-04-15 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: ratatui_ruby
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.4'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.4'
+- !ruby/object:Gem::Dependency
+  name: ruby_llm
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.13'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.13'
+- !ruby/object:Gem::Dependency
+  name: tty-prompt
+  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'
+- !ruby/object:Gem::Dependency
+  name: unicode-display_width
+  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'
+- !ruby/object:Gem::Dependency
+  name: webrick
+  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: RubyCoded is a terminal-based AI coding assistant built in Ruby. It provides
+  a full TUI chat interface with support for multiple LLM providers (OpenAI, Anthropic,
+  etc.), an agent mode with filesystem tools for reading, writing, and editing project
+  files, a plan mode for structured task planning, and a plugin system for extensibility.
+email:
+- cesar.rodriguez.lara54@gmail.com
+executables:
+- ruby_coded
+extensions: []
+extra_rdoc_files: []
+files:
+- ".github/workflows/ci.yml"
+- ".github/workflows/release.yml"
+- ".rubocop_todo.yml"
+- CHANGELOG.md
+- CODE_OF_CONDUCT.md
+- LICENSE.txt
+- README.md
+- Rakefile
+- exe/ruby_coded
+- lib/ruby_coded.rb
+- lib/ruby_coded/auth/auth_manager.rb
+- lib/ruby_coded/auth/callback_servlet.rb
+- lib/ruby_coded/auth/credentials_store.rb
+- lib/ruby_coded/auth/oauth_callback_server.rb
+- lib/ruby_coded/auth/pkce.rb
+- lib/ruby_coded/auth/providers/anthropic.rb
+- lib/ruby_coded/auth/providers/openai.rb
+- lib/ruby_coded/chat/app.rb
+- lib/ruby_coded/chat/app/event_dispatch.rb
+- lib/ruby_coded/chat/command_handler.rb
+- lib/ruby_coded/chat/command_handler/agent_commands.rb
+- lib/ruby_coded/chat/command_handler/history_commands.rb
+- lib/ruby_coded/chat/command_handler/model_commands.rb
+- lib/ruby_coded/chat/command_handler/plan_commands.rb
+- lib/ruby_coded/chat/command_handler/token_commands.rb
+- lib/ruby_coded/chat/command_handler/token_formatting.rb
+- lib/ruby_coded/chat/help.txt
+- lib/ruby_coded/chat/input_handler.rb
+- lib/ruby_coded/chat/input_handler/modal_inputs.rb
+- lib/ruby_coded/chat/input_handler/normal_mode_input.rb
+- lib/ruby_coded/chat/llm_bridge.rb
+- lib/ruby_coded/chat/llm_bridge/plan_mode.rb
+- lib/ruby_coded/chat/llm_bridge/streaming_retries.rb
+- lib/ruby_coded/chat/llm_bridge/tool_call_handling.rb
+- lib/ruby_coded/chat/model_filter.rb
+- lib/ruby_coded/chat/plan_clarification_parser.rb
+- lib/ruby_coded/chat/renderer.rb
+- lib/ruby_coded/chat/renderer/chat_panel.rb
+- lib/ruby_coded/chat/renderer/chat_panel_input.rb
+- lib/ruby_coded/chat/renderer/chat_panel_thinking.rb
+- lib/ruby_coded/chat/renderer/model_selector.rb
+- lib/ruby_coded/chat/renderer/plan_clarifier.rb
+- lib/ruby_coded/chat/renderer/plan_clarifier_layout.rb
+- lib/ruby_coded/chat/renderer/status_bar.rb
+- lib/ruby_coded/chat/state.rb
+- lib/ruby_coded/chat/state/message_assistant.rb
+- lib/ruby_coded/chat/state/message_token_tracking.rb
+- lib/ruby_coded/chat/state/messages.rb
+- lib/ruby_coded/chat/state/model_selection.rb
+- lib/ruby_coded/chat/state/plan_tracking.rb
+- lib/ruby_coded/chat/state/scrollable.rb
+- lib/ruby_coded/chat/state/token_cost.rb
+- lib/ruby_coded/chat/state/tool_confirmation.rb
+- lib/ruby_coded/config/user_config.rb
+- lib/ruby_coded/errors/auth_error.rb
+- lib/ruby_coded/initializer.rb
+- lib/ruby_coded/initializer/cover.rb
+- lib/ruby_coded/plugins.rb
+- lib/ruby_coded/plugins/base.rb
+- lib/ruby_coded/plugins/command_completion/input_extension.rb
+- lib/ruby_coded/plugins/command_completion/plugin.rb
+- lib/ruby_coded/plugins/command_completion/renderer_extension.rb
+- lib/ruby_coded/plugins/command_completion/state_extension.rb
+- lib/ruby_coded/plugins/registry.rb
+- lib/ruby_coded/strategies/api_key_strategy.rb
+- lib/ruby_coded/strategies/base.rb
+- lib/ruby_coded/strategies/oauth_strategy.rb
+- lib/ruby_coded/tools/agent_cancelled_error.rb
+- lib/ruby_coded/tools/agent_iteration_limit_error.rb
+- lib/ruby_coded/tools/base_tool.rb
+- lib/ruby_coded/tools/create_directory_tool.rb
+- lib/ruby_coded/tools/delete_path_tool.rb
+- lib/ruby_coded/tools/edit_file_tool.rb
+- lib/ruby_coded/tools/list_directory_tool.rb
+- lib/ruby_coded/tools/plan_system_prompt.rb
+- lib/ruby_coded/tools/read_file_tool.rb
+- lib/ruby_coded/tools/registry.rb
+- lib/ruby_coded/tools/run_command_tool.rb
+- lib/ruby_coded/tools/system_prompt.rb
+- lib/ruby_coded/tools/tool_rejected_error.rb
+- lib/ruby_coded/tools/write_file_tool.rb
+- lib/ruby_coded/version.rb
+- sig/ruby_coded.rbs
+homepage: https://github.com/MrCesar107/ruby_code
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+  homepage_uri: https://github.com/MrCesar107/ruby_code
+  source_code_uri: https://github.com/MrCesar107/ruby_code
+  changelog_uri: https://github.com/MrCesar107/ruby_code/blob/main/CHANGELOG.md
+  rubygems_mfa_required: 'true'
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.3.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.22
+signing_key:
+specification_version: 4
+summary: AI-powered terminal coding assistant with agent mode, plan mode, and multi-provider
+  LLM support.
+test_files: []