ruby_agent 0.2.1 → 0.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '039e385b0c47944839ae33f1b8e4ed75e499803ae06538e9da4c3a9899dbe247'
-  data.tar.gz: 6726c84e2a9fbb9f795300dbb8995fba831bb989540681ce35c3b6604c9c6b35
+  metadata.gz: 4f16c4c8fdacecaee67784197c3a8fe8b0e00adc248115c3d8c8f873d954fafd
+  data.tar.gz: c94d916ea812575d2227a822df90cdb5dbdfe9ee41794af1be0375cc4aa4d9ee
 SHA512:
-  metadata.gz: 787bdc5703131d4169ca2fb53175ce3cc920330fd398e34c881ab2fbf4bfdf73a360a3459a60891fbdd05bb4891a7ff41f74efca715ef126164e63a128daf5ef
-  data.tar.gz: 0c273eb33000ddc93e065a3b1d43483012012fa350e67bcae2f96def1d882d3f7e2846659fbca4287b5b0e280201023c0469cccfeec72b8282a0d218d831854c
+  metadata.gz: 46cf5e8405ce2661346832274d770c2ccdc19c55e53797553a7f9794f402fe654134b44908c2b46a0bf02bda13dc73d96b688a6f8a7de300bdd7ae85fd228700
+  data.tar.gz: 8fb706b0a8f0b88eb50fdea84081aa2ef8b3e581bdbf6de4f70d230c92ca99103f123a3781e8be7ff9ecd791977b42043a8eb04b05fffede4a1645914a074c45

data/.rubocop.yml

@@ -0,0 +1,58 @@
+AllCops:
+  NewCops: enable
+  TargetRubyVersion: 3.4
+  SuggestExtensions: false
+  Exclude:
+    - 'vendor/**/*'
+    - 'tmp/**/*'
+    - 'bin/**/*'
+
+Style/Documentation:
+  Enabled: false
+
+Style/StringLiterals:
+  EnforcedStyle: double_quotes
+
+Style/FrozenStringLiteralComment:
+  Enabled: false
+
+Layout/LineLength:
+  Max: 125
+
+Metrics/MethodLength:
+  Max: 50
+
+Metrics/AbcSize:
+  Max: 40
+
+Metrics/CyclomaticComplexity:
+  Max: 25
+
+Metrics/PerceivedComplexity:
+  Max: 25
+
+Metrics/BlockNesting:
+  Max: 5
+
+Metrics/BlockLength:
+  Exclude:
+    - 'test/**/*'
+    - 'Rakefile'
+
+Metrics/ClassLength:
+  Max: 350
+
+Metrics/ParameterLists:
+  Max: 10
+
+Lint/UnusedMethodArgument:
+  AllowUnusedKeywordArguments: true
+
+Lint/EmptyBlock:
+  Enabled: false
+
+Lint/SuppressedException:
+  AllowComments: true
+
+Gemspec/RequiredRubyVersion:
+  Enabled: false

data/Gemfile

@@ -0,0 +1,12 @@
+source "https://rubygems.org"
+
+gemspec
+
+gem "minitest", "~> 5.0"
+gem "minitest-reporters", "~> 1.6"
+gem "rake", "~> 13.0"
+
+group :development do
+  gem "bundler-audit", "~> 0.9", require: false
+  gem "rubocop", "~> 1.50", require: false
+end

data/README.md

@@ -205,6 +205,64 @@ rescue RubyAgent::AgentError => e
 end
 ```
 
+## Development
+
+### Contributing
+
+1. Fork the repository: https://github.com/AllYourBot/ruby-agent
+2. Create a feature branch: `git checkout -b my-new-feature`
+3. Make your changes
+4. Run the CI suite locally to ensure everything passes:
+
+```bash
+# Run all CI tasks (linting + tests)
+rake ci
+
+# Or run tasks individually:
+rake ci:test   # Run test suite
+rake ci:lint   # Run RuboCop linter
+rake ci:scan   # Run security audit
+```
+
+5. Commit your changes: `git commit -am 'Add some feature'`
+6. Push to your fork: `git push origin my-new-feature`
+7. Create a Pull Request against the `main` branch
+
+### Running Tests Locally
+
+The test suite includes an integration test that runs Claude Code CLI locally:
+
+```bash
+# Run all tests
+rake test
+
+# Run a specific test
+ruby test/ruby_agent_test.rb --name test_simple_agent_query
+```
+
+**Note**: Tests require Claude Code CLI to be installed on your machine (see Prerequisites section).
+
+### Linting
+
+We use RuboCop for code linting:
+
+```bash
+# Check for linting issues
+rake ci:lint
+
+# Auto-fix linting issues
+bundle exec rubocop -a
+```
+
+### Publishing
+
+Publishing to RubyGems happens automatically via GitHub Actions when code is merged to `main`. The version number is read from `lib/ruby_agent/version.rb`.
+
+**Before merging a PR**, make sure to bump the version number appropriately:
+- Patch version (0.2.1 → 0.2.2) for bug fixes
+- Minor version (0.2.1 → 0.3.0) for new features
+- Major version (0.2.1 → 1.0.0) for breaking changes
+
 ## License
 
 MIT

data/Rakefile

@@ -0,0 +1,34 @@
+require "bundler/gem_tasks"
+require "rake/testtask"
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << "test"
+  t.libs << "lib"
+  t.test_files = FileList["test/**/*_test.rb"]
+end
+
+task default: :test
+
+namespace :ci do
+  desc "Run tests"
+  task :test do
+    sh "bundle exec rake test"
+  end
+
+  desc "Run linter"
+  task :lint do
+    sh "bundle exec rubocop"
+  rescue StandardError
+    puts "Rubocop not configured yet, skipping..."
+  end
+
+  desc "Run security scan"
+  task :scan do
+    sh "bundle exec bundler-audit check --update"
+  rescue StandardError
+    puts "Bundler-audit not installed, skipping..."
+  end
+end
+
+desc "Run all CI tasks"
+task ci: ["ci:lint", "ci:test"]

data/lib/ruby_agent/version.rb

@@ -1,3 +1,3 @@
 class RubyAgent
-  VERSION = "0.2.1"
+  VERSION = "0.2.2".freeze
 end

data/lib/ruby_agent.rb

@@ -46,15 +46,15 @@ class RubyAgent
     @pending_interrupt_request_id = nil
     @deferred_exit = false
 
-    unless @session_key
-      inject_streaming_response({
-        type: "system",
-        subtype: "prompt",
-        system_prompt: @system_prompt,
-        timestamp: Time.now.utc.iso8601(6),
-        received_at: Time.now.utc.iso8601(6)
-      })
-    end
+    return if @session_key
+
+    inject_streaming_response({
+                                type: "system",
+                                subtype: "prompt",
+                                system_prompt: @system_prompt,
+                                timestamp: Time.now.utc.iso8601(6),
+                                received_at: Time.now.utc.iso8601(6)
+                              })
   end
 
   def create_message_callback(name, &processor)
@@ -68,7 +68,7 @@ class RubyAgent
     @on_message_callback = block
   end
 
-  alias_method :on_event, :on_message
+  alias on_event on_message
 
   def on_error(&block)
     @on_error_callback = block
@@ -111,37 +111,37 @@ class RubyAgent
         @wait_thr = nil
       end
     end
-  rescue => e
+  rescue StandardError => e
     trigger_error(e)
     raise
   end
 
   def ask(text, sender_name: "User", additional: [])
     formatted_text = if sender_name.downcase == "system"
-      <<~TEXT.strip
-        <system>
-          #{text}
-        </system>
-      TEXT
-    else
-      "#{sender_name}: #{text}"
-    end
+                       <<~TEXT.strip
+                         <system>
+                           #{text}
+                         </system>
+                       TEXT
+                     else
+                       "#{sender_name}: #{text}"
+                     end
     formatted_text += extra_context(additional, sender_name:)
 
     inject_streaming_response({
-      type: "user",
-      subtype: "new_message",
-      sender_name:,
-      text:,
-      formatted_text:,
-      timestamp: Time.now.utc.iso8601(6)
-    })
+                                type: "user",
+                                subtype: "new_message",
+                                sender_name:,
+                                text:,
+                                formatted_text:,
+                                timestamp: Time.now.utc.iso8601(6)
+                              })
 
     send_message(formatted_text)
   end
 
   def ask_after_interrupt(text, sender_name: "User", additional: [])
-    @pending_ask_after_interrupt = {text:, sender_name:, additional:}
+    @pending_ask_after_interrupt = { text:, sender_name:, additional: }
   end
 
   def send_system_message(text)
@@ -171,7 +171,7 @@ class RubyAgent
 
     puts "→ stdout closed, waiting for process to exit..." if DEBUG
     exit_status = @wait_thr.value
-    puts "→ Process exited with status: #{exit_status.success? ? "success" : "failure"}" if DEBUG
+    puts "→ Process exited with status: #{exit_status.success? ? 'success' : 'failure'}" if DEBUG
     unless exit_status.success?
       stderr_output = @stderr.read
       raise ConnectionError, "Claude command failed: #{stderr_output}"
@@ -202,7 +202,9 @@ class RubyAgent
     request_id = "req_#{@request_counter}_#{SecureRandom.hex(4)}"
 
     @pending_interrupt_request_id = request_id if @pending_ask_after_interrupt
-    puts "→ Sending interrupt with request_id: #{request_id}, pending_ask: #{@pending_ask_after_interrupt ? true : false}" if DEBUG
+    if DEBUG
+      puts "→ Sending interrupt with request_id: #{request_id}, pending_ask: #{@pending_ask_after_interrupt ? true : false}"
+    end
 
     control_request = {
       type: "control_request",
@@ -213,14 +215,14 @@ class RubyAgent
     }
 
     inject_streaming_response({
-      type: "control",
-      subtype: "interrupt",
-      timestamp: Time.now.utc.iso8601(6)
-    })
+                                type: "control",
+                                subtype: "interrupt",
+                                timestamp: Time.now.utc.iso8601(6)
+                              })
 
     @stdin.puts JSON.generate(control_request)
     @stdin.flush
-  rescue => e
+  rescue StandardError => e
     warn "Failed to send interrupt signal: #{e.message}"
     raise
   end
@@ -239,7 +241,7 @@ class RubyAgent
     begin
       @stdin.close unless @stdin.closed?
       puts "→ stdin closed" if DEBUG
-    rescue => e
+    rescue StandardError => e
       warn "Error closing stdin during exit: #{e.message}"
     end
   end
@@ -267,7 +269,7 @@ class RubyAgent
 
   def build_mcp_config(mcp_servers)
     servers = mcp_servers.transform_keys { |k| k.to_s.gsub("_", "-") }
-    {mcpServers: servers}
+    { mcpServers: servers }
   end
 
   def parse_system_prompt(template_content, context_vars)
@@ -285,9 +287,7 @@ class RubyAgent
     binding_context = create_binding_context(**context_vars)
     result = erb.result(binding_context)
 
-    if result.include?("<%=") || result.include?("%>")
-      raise ParseError, "There was an error parsing the system prompt."
-    end
+    raise ParseError, "There was an error parsing the system prompt." if result.include?("<%=") || result.include?("%>")
 
     result
   end
@@ -319,13 +319,13 @@ class RubyAgent
 
     message_json = {
       type: "user",
-      message: {role: "user", content: content},
+      message: { role: "user", content: content },
       session_id: session_id
     }.compact
 
     @stdin.puts JSON.generate(message_json)
     @stdin.flush
-  rescue => e
+  rescue StandardError => e
     trigger_error(e)
     raise
   end
@@ -388,6 +388,7 @@ class RubyAgent
 
   def check_nested_content_types(message, all_messages)
     return unless message["message"].is_a?(Hash)
+
     content = message.dig("message", "content")
     return unless content.is_a?(Array)
 
@@ -406,7 +407,7 @@ class RubyAgent
   end
 
   def trigger_custom_message_callbacks(message, all_messages)
-    @custom_message_callbacks.each do |name, config|
+    @custom_message_callbacks.each_value do |config|
       processor = config[:processor]
       callback = config[:callback]
 

metadata

@@ -1,31 +1,36 @@
 --- !ruby/object:Gem::Specification
 name: ruby_agent
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.2.2
 platform: ruby
 authors:
 - Keith Schacht
+- Matt Lindsey
 bindir: exe
 cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
 dependencies: []
 description: A framework for building AI agents in Ruby
 email:
-- keith@keithschacht.com
+- krschacht@gmail.com
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- ".rubocop.yml"
+- Gemfile
 - LICENSE
 - README.md
+- Rakefile
 - lib/ruby_agent.rb
 - lib/ruby_agent/version.rb
-homepage: https://github.com/keithschacht/ruby-agent
+homepage: https://github.com/AllYourBot/ruby-agent
 licenses:
 - MIT
 metadata:
-  homepage_uri: https://github.com/keithschacht/ruby-agent
-  source_code_uri: https://github.com/keithschacht/ruby-agent
+  homepage_uri: https://github.com/AllYourBot/ruby-agent
+  source_code_uri: https://github.com/AllYourBot/ruby-agent
+  rubygems_mfa_required: 'true'
 rdoc_options: []
 require_paths:
 - lib
@@ -33,14 +38,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.7.0
+      version: 3.2.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.7
+rubygems_version: 3.6.9
 specification_version: 4
 summary: Ruby agent framework
 test_files: []