rails_orchestrator 0.1.0 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ad0ec91cbefd4c8e690a05ebf1dc856b8a150b327ef2831ac97ff48353be8306
-  data.tar.gz: 616f18aa8047af98fe2c7ce928cdf7cba36d813afdb4110c36e73ff017362782
+  metadata.gz: 0d2f38594952e49f0d659722dcb48401a6d5f2427d48781ac2048433bd84557b
+  data.tar.gz: 4841db7dd3ff00b4befc942d7706ea13474a94a6efb1405070ef20472c10335f
 SHA512:
-  metadata.gz: 3953ffb04fcd799ee99ee9209158feec39781b68236db0548627ac55932c62a39e16b67e3904dbb8e71f53413a3d80fdcf7092bf8301c140e496b05603a363ca
-  data.tar.gz: 9b86fb351556db3be676bcb13752cf54bd103768d46ecc47611fa209a5f59843b36e6647e055cfc1b46f25070df7c05103bc28c8c261f0b6e5c9cee7633409ed
+  metadata.gz: 53eaa449566c589561b0a091be660075ec3a91c97a5f8559878c11e9477fdb22f4f748b9ca56917fa471c030a7277f913614d5e3898baf8a994eb52f25581b45
+  data.tar.gz: 14d45a700a36801ce88878ee3ba9624637943245177fbdf4c2aee7b8f6ca44ec98d13b593c7e12c884a1f4380e100df55280303cf05e5bf6ac474bf9aa1bbd4b

data/.rspec

@@ -0,0 +1,2 @@
+--require spec_helper
+--format documentation

data/.rubocop.yml

@@ -0,0 +1,35 @@
+AllCops:
+  TargetRubyVersion: 3.0
+  NewCops: enable
+  SuggestExtensions: false
+
+Style/StringLiterals:
+  EnforcedStyle: double_quotes
+
+Style/StringLiteralsInInterpolation:
+  EnforcedStyle: double_quotes
+
+Layout/LineLength:
+  Max: 120
+
+Metrics/BlockLength:
+  Exclude:
+    - "spec/**/*"
+    - "*.gemspec"
+
+Metrics/AbcSize:
+  Exclude:
+    - "spec/**/*"
+
+Metrics/MethodLength:
+  Exclude:
+    - "spec/**/*"
+
+Style/Documentation:
+  Enabled: false
+
+Gemspec/DevelopmentDependencies:
+  Enabled: false
+
+Gemspec/RequireMFA:
+  Enabled: false

data/README.md

@@ -1,31 +1,72 @@
 # RailsOrchestrator
 
-TODO: Delete this and the text below, and describe your gem
-
-Welcome to your new gem! In this directory, you'll find the files you need to be able to package up your Ruby library into a gem. Put your Ruby code in the file `lib/rails_orchestrator`. To experiment with that code, run `bin/console` for an interactive prompt.
+A framework to build AI agents in Rails applications. Send conversations to a local LLM (Ollama, etc.) and get responses.
 
 ## Installation
 
-TODO: Replace `UPDATE_WITH_YOUR_GEM_NAME_PRIOR_TO_RELEASE_TO_RUBYGEMS_ORG` with your gem name right after releasing it to RubyGems.org. Please do not do it earlier due to security reasons. Alternatively, replace this section with instructions to install your gem from git if you don't plan to release to RubyGems.org.
+Add to your Gemfile:
 
-Install the gem and add to the application's Gemfile by executing:
+```ruby
+gem "rails_orchestrator"
+```
 
-    $ bundle add UPDATE_WITH_YOUR_GEM_NAME_PRIOR_TO_RELEASE_TO_RUBYGEMS_ORG
+Then run `bundle install`.
 
-If bundler is not being used to manage dependencies, install the gem by executing:
+## Usage
 
-    $ gem install UPDATE_WITH_YOUR_GEM_NAME_PRIOR_TO_RELEASE_TO_RUBYGEMS_ORG
+### Configuration
 
-## Usage
+```ruby
+RailsOrchestrator.configure do |config|
+  config.base_url = "http://localhost:11434" # default
+  config.model = "llama3"                    # default
+  config.request_timeout = 120               # default, in seconds
+end
+```
 
-TODO: Write usage instructions here
+### Sending a conversation
 
-## Development
+```ruby
+conversation = RailsOrchestrator::Conversation.new
+conversation.system("You are a helpful assistant.")
+conversation.user("Hello!")
+
+client = RailsOrchestrator::Client.new
+response = client.chat(conversation)
+response.content # => "Hi there!"
+```
+
+You can also pass plain arrays:
 
-After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake none` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+```ruby
+response = client.chat([{ role: "user", content: "Hello" }])
+```
 
-To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+### Error handling
+
+```ruby
+begin
+  response = client.chat(conversation)
+rescue RailsOrchestrator::ConnectionError => e
+  # Network failure (connection refused, timeout, etc.)
+rescue RailsOrchestrator::ApiError => e
+  e.status # HTTP status code
+  e.body   # Raw response body
+end
+```
+
+## Development
+
+```sh
+bundle install
+bundle exec rspec
+bundle exec rubocop
+```
 
 ## Contributing
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/rails_orchestrator.
+Bug reports and pull requests are welcome on GitHub at https://github.com/jpmsantana/rails_orchestrator.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/Rakefile

@@ -1,4 +1,8 @@
 # frozen_string_literal: true
 
 require "bundler/gem_tasks"
-task default: %i[]
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task default: :spec

data/lib/rails_orchestrator/client.rb

@@ -0,0 +1,63 @@
+# frozen_string_literal: true
+
+require "net/http"
+require "json"
+require "uri"
+
+module RailsOrchestrator
+  class Client
+    def initialize(config: nil)
+      @config = config || RailsOrchestrator.configuration
+    end
+
+    def chat(messages)
+      messages = messages.to_a if messages.is_a?(Conversation)
+      messages = normalize_messages(messages)
+
+      body = { model: @config.model, messages: messages, stream: false }
+      Response.new(post("/api/chat", body))
+    end
+
+    private
+
+    def normalize_messages(messages)
+      messages.map do |msg|
+        if msg.is_a?(Hash)
+          { role: msg[:role] || msg["role"], content: msg[:content] || msg["content"] }
+        else
+          msg.to_h
+        end
+      end
+    end
+
+    def post(path, body)
+      uri = URI.join(@config.base_url, path)
+      response = execute_request(uri, body)
+      handle_response(response)
+    rescue Errno::ECONNREFUSED, Errno::ECONNRESET, Net::OpenTimeout, Net::ReadTimeout, SocketError => e
+      raise ConnectionError, "Failed to connect to #{@config.base_url}: #{e.message}"
+    end
+
+    def execute_request(uri, body)
+      request = Net::HTTP::Post.new(uri)
+      request["Content-Type"] = "application/json"
+      request.body = JSON.generate(body)
+
+      http = Net::HTTP.new(uri.host, uri.port)
+      http.read_timeout = @config.request_timeout
+      http.open_timeout = @config.request_timeout
+      http.request(request)
+    end
+
+    def handle_response(response)
+      unless response.is_a?(Net::HTTPSuccess)
+        raise ApiError.new(
+          "API request failed with status #{response.code}",
+          status: response.code.to_i, body: response.body
+        )
+      end
+
+      JSON.parse(response.body)
+    end
+  end
+end

data/lib/rails_orchestrator/configuration.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module RailsOrchestrator
+  class Configuration
+    attr_accessor :base_url, :model, :request_timeout
+
+    def initialize
+      @base_url = "http://localhost:11434"
+      @model = "llama3"
+      @request_timeout = 120
+    end
+  end
+end

data/lib/rails_orchestrator/conversation.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+module RailsOrchestrator
+  class Conversation
+    include Enumerable
+
+    def initialize
+      @messages = []
+    end
+
+    def system(content)
+      @messages << Message.new(role: "system", content: content)
+      self
+    end
+
+    def user(content)
+      @messages << Message.new(role: "user", content: content)
+      self
+    end
+
+    def assistant(content)
+      @messages << Message.new(role: "assistant", content: content)
+      self
+    end
+
+    def each(&block)
+      @messages.each(&block)
+    end
+
+    def to_a
+      @messages.map(&:to_h)
+    end
+
+    def size
+      @messages.size
+    end
+  end
+end

data/lib/rails_orchestrator/errors.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module RailsOrchestrator
+  class Error < StandardError; end
+  class ConnectionError < Error; end
+
+  class ApiError < Error
+    attr_reader :status, :body
+
+    def initialize(message, status:, body:)
+      @status = status
+      @body = body
+      super(message)
+    end
+  end
+end

data/lib/rails_orchestrator/message.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module RailsOrchestrator
+  class Message
+    attr_reader :role, :content
+
+    def initialize(role:, content:)
+      @role = role.to_s
+      @content = content
+    end
+
+    def to_h
+      { role: @role, content: @content }
+    end
+
+    def ==(other)
+      other.is_a?(Message) && role == other.role && content == other.content
+    end
+  end
+end

data/lib/rails_orchestrator/response.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module RailsOrchestrator
+  class Response
+    attr_reader :raw
+
+    def initialize(raw)
+      @raw = raw
+    end
+
+    def content
+      # Ollama format
+      if raw.key?("message")
+        raw.dig("message", "content")
+      # OpenAI-compatible format
+      elsif raw.key?("choices")
+        raw.dig("choices", 0, "message", "content")
+      end
+    end
+
+    def model
+      raw["model"]
+    end
+
+    def done?
+      raw["done"] == true
+    end
+  end
+end

data/lib/rails_orchestrator/version.rb

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

data/lib/rails_orchestrator.rb

@@ -1,7 +1,25 @@
 # frozen_string_literal: true
 
 require_relative "rails_orchestrator/version"
+require_relative "rails_orchestrator/errors"
+require_relative "rails_orchestrator/configuration"
+require_relative "rails_orchestrator/message"
+require_relative "rails_orchestrator/conversation"
+require_relative "rails_orchestrator/response"
+require_relative "rails_orchestrator/client"
 
 module RailsOrchestrator
-  class Error < StandardError; end
+  class << self
+    def configuration
+      @configuration ||= Configuration.new
+    end
+
+    def configure
+      yield(configuration)
+    end
+
+    def reset_configuration!
+      @configuration = Configuration.new
+    end
+  end
 end

data/rails_orchestrator.gemspec

@@ -9,7 +9,9 @@ Gem::Specification.new do |spec|
   spec.email = ["jpmsantana14@gmail.com"]
 
   spec.summary = "A framework to build AI agents in Rails applications with tool support, memory and orchestration."
-  spec.description = "RailsOrchestrator provides a structured framework for building AI agents in Ruby on Rails applications. It includes tool support, memory management, and orchestration capabilities for composing complex agent workflows."
+  spec.description = "RailsOrchestrator provides a structured framework for building AI agents " \
+                     "in Ruby on Rails applications. It includes tool support, memory management, " \
+                     "and orchestration capabilities for composing complex agent workflows."
   spec.homepage = "https://github.com/jpmsantana/rails_orchestrator"
   spec.license = "MIT"
   spec.required_ruby_version = ">= 3.0.0"
@@ -32,9 +34,6 @@ Gem::Specification.new do |spec|
   spec.executables = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
   spec.require_paths = ["lib"]
 
-  # Uncomment to register a new dependency of your gem
-  # spec.add_dependency "example-gem", "~> 1.0"
-
-  # For more information and examples about making a new gem, check out our
-  # guide at: https://bundler.io/guides/creating_gem.html
+  spec.add_development_dependency "rspec", "~> 3.0"
+  spec.add_development_dependency "rubocop", "~> 1.21"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rails_orchestrator
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 1.0.0
 platform: ruby
 authors:
 - João Paulo Moreira Sant'ana
@@ -9,7 +9,35 @@ autorequire:
 bindir: exe
 cert_chain: []
 date: 2026-02-02 00:00:00.000000000 Z
-dependencies: []
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.21'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.21'
 description: RailsOrchestrator provides a structured framework for building AI agents
   in Ruby on Rails applications. It includes tool support, memory management, and
   orchestration capabilities for composing complex agent workflows.
@@ -19,10 +47,18 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- ".rspec"
+- ".rubocop.yml"
 - LICENSE.txt
 - README.md
 - Rakefile
 - lib/rails_orchestrator.rb
+- lib/rails_orchestrator/client.rb
+- lib/rails_orchestrator/configuration.rb
+- lib/rails_orchestrator/conversation.rb
+- lib/rails_orchestrator/errors.rb
+- lib/rails_orchestrator/message.rb
+- lib/rails_orchestrator/response.rb
 - lib/rails_orchestrator/version.rb
 - rails_orchestrator.gemspec
 - sig/rails_orchestrator.rbs