omniai-tools 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 404c95beb54e2092a9a694887ba55a2e8ac8ec736bed56b755cfe34d0906cf9e
-  data.tar.gz: f07bf709204ea5a472733695e45870bbbf51b5f89a7d817d290e9e926cf4a57d
+  metadata.gz: 04d1c28a8b8a92c2cc6c0ada9976d58ee2aed291fe25368356ce9a055b14cc7e
+  data.tar.gz: 5afcc660cd72ef9ed7cea14fb6478a3239af14d8e519e3ba2bb89c32ccfaeb97
 SHA512:
-  metadata.gz: 206fda9b71017456d3d4f6d2c590849b93bf302c298916fe64fdd9552429357b35c86a01fde359f0ff7e63fc6202429e9bf16e4c4563a61b7ddc065a77c404e8
-  data.tar.gz: c7a122e9c86e418825285c4503236eb921570980eba9c8586c509243d2bb9ee7d3bb2d0da2187f331c8c53647153c2109b258d44ed52f12b1929e8cf08d8d93e
+  metadata.gz: f1331d0fc5ed4b89072e8d793620b7531d240556bca49be4a6a9b16e3368a96df3d8ca7a45c4e50198d97850b50ee13319875d4a8152ea8e7c93676d3eb81653
+  data.tar.gz: 39ac4a40cbcafe9876e51c9a7a5f8b63c3d51c9bfc7f63afe6a47e209ed0ee6acbdb8d7c5845e3f9b7fab3ed6dac8eb946eda1a69d900f8a3d897cee67bb3b52

data/Gemfile

@@ -7,6 +7,7 @@ gemspec
 gem "factory_bot"
 gem "irb"
 gem "rake"
+gem "redcarpet"
 gem "rspec"
 gem "rspec_junit_formatter"
 gem "rubocop"

data/README.md

@@ -5,3 +5,83 @@
 [![GitHub](https://img.shields.io/badge/github-repo-blue.svg)](https://github.com/ksylvest/omniai-tools)
 [![Yard](https://img.shields.io/badge/docs-site-blue.svg)](https://omniai-tools.ksylvest.com)
 [![CircleCI](https://img.shields.io/circleci/build/github/ksylvest/omniai-tools)](https://circleci.com/gh/ksylvest/omniai-tools)
+
+`OmniAI::Tools` is a library of pre-built tools to simplify integrating common tasks w/ [OmniAI](https://github.com/ksylvest/omniai).
+
+## Disk
+
+Disk tools are focused on creating / updating / deleting files and directories within a "root":
+
+```ruby
+require "omniai/openai"
+require "omniai/tools"
+
+print "Root (e.g. /usr/src/project): "
+root = gets.strip
+
+client = OmniAI::OpenAI::Client.new
+logger = Logger.new($stdout)
+
+tools = [
+  OmniAI::Tools::Disk::DirectoryCreateTool,
+  OmniAI::Tools::Disk::DirectoryDeleteTool,
+  OmniAI::Tools::Disk::FileCreateTool,
+  OmniAI::Tools::Disk::FileDeleteTool,
+  OmniAI::Tools::Disk::FileMoveTool,
+  OmniAI::Tools::Disk::FileReplaceTool,
+  OmniAI::Tools::Disk::FileReadTool,
+  OmniAI::Tools::Disk::FileWriteTool,
+  OmniAI::Tools::Disk::SummaryTool,
+].map { |klass| klass.new(root:, logger:) }
+
+puts "Type 'exit' or 'quit' to leave."
+
+prompt = OmniAI::Chat::Prompt.build do |builder|
+  builder.system "Use tools to manage files and directories as requested."
+end
+
+loop do
+  print "# "
+  text = gets.strip
+  break if %w[exit quit].include?(text)
+
+  prompt.user(text)
+  response = client.chat(prompt, stream: $stdout, tools:)
+  prompt.assistant(response.text)
+end
+```
+
+## Docker
+
+Disk tools are focused on running commands through Docker via compose:
+
+```ruby
+require "omniai/openai"
+require "omniai/tools"
+
+print "Root (e.g. /usr/src/project): "
+root = gets.strip
+
+client = OmniAI::OpenAI::Client.new
+logger = Logger.new($stdout)
+
+tools = [
+  OmniAI::Tools::Docker::ComposeRunTool,
+].map { |klass| klass.new(root:, logger:) }
+
+puts "Type 'exit' or 'quit' to leave."
+
+prompt = OmniAI::Chat::Prompt.build do |builder|
+  builder.system "Use tools to interact with docker."
+end
+
+loop do
+  print "# "
+  text = gets.strip
+  break if %w[exit quit].include?(text)
+
+  prompt.user(text)
+  response = client.chat(prompt, stream: $stdout, tools:)
+  prompt.assistant(response.text)
+end
+```

data/bin/setup

@@ -4,5 +4,3 @@ IFS=$'\n\t'
 set -vx
 
 bundle install
-
-# Do any other automated setup that you need to do here

data/lib/omniai/tools/disk/base_tool.rb

@@ -18,7 +18,6 @@ module OmniAI
 
       protected
 
-        # @param directory [Pathname]
         # @param path [String]
         #
         # @raise [SecurityError]

data/lib/omniai/tools/disk/directory_create_tool.rb

@@ -11,6 +11,8 @@ module OmniAI
 
         parameter :path, :string, description: "a path to the directory (e.g. `./foo/bar`)"
 
+        required %i[path]
+
         # @param path [String]
         #
         # @return [String]

data/lib/omniai/tools/disk/directory_delete_tool.rb

@@ -11,6 +11,8 @@ module OmniAI
 
         parameter :path, :string, description: "a path to the directory (e.g. `./foo/bar`)"
 
+        required %i[path]
+
         # @param path [String]
         #
         # @return [String]

data/lib/omniai/tools/disk/file_create_tool.rb

@@ -11,6 +11,8 @@ module OmniAI
 
         parameter :path, :string, description: "a path to the file (e.g. `./README.md`)"
 
+        required %i[path]
+
         # @param path [String]
         #
         # @return [String]

data/lib/omniai/tools/disk/file_delete_tool.rb

@@ -11,6 +11,8 @@ module OmniAI
 
         parameter :path, :string, description: "a path to the directory (e.g. `./foo/bar`)"
 
+        required %i[path]
+
         # @param path [String]
         #
         # @raise [SecurityError]

data/lib/omniai/tools/disk/file_move_tool.rb

@@ -15,6 +15,8 @@ module OmniAI
         parameter :old_path, :string, description: "a path (e.g. `./old.rb`)"
         parameter :new_path, :string, description: "a path (e.g. `./new.rb`)"
 
+        required %i[old_path new_path]
+
         # @param old_path [String]
         # @param new_path [String]
         #

data/lib/omniai/tools/disk/file_read_tool.rb

@@ -11,6 +11,8 @@ module OmniAI
 
         parameter :path, :string, description: "a path (e.g. `./main.rb`)"
 
+        required %i[path]
+
         # @param path [String]
         #
         # @return [String]

data/lib/omniai/tools/disk/file_replace_tool.rb

@@ -17,6 +17,8 @@ module OmniAI
         parameter :new_text, :string, description: "the new text (e.g. `puts 'DEF'`)"
         parameter :path, :string, description: "a path (e.g. `./main.rb`)"
 
+        required %i[old_text new_text path]
+
         # @param path [String]
         # @param old_text [String]
         # @param new_text [String]

data/lib/omniai/tools/disk/file_write_tool.rb

@@ -12,6 +12,8 @@ module OmniAI
         parameter :path, :string, description: "a path for the file (e.g. `./main.rb`)"
         parameter :text, :string, description: "the text to write to the file (e.g. `puts 'Hello World'`)"
 
+        required %i[path text]
+
         # @param path [String]
         # @param text [String]
         #

data/lib/omniai/tools/version.rb

@@ -2,6 +2,6 @@
 
 module OmniAI
   module Tools
-    VERSION = "0.1.0"
+    VERSION = "0.2.0"
   end
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: omniai-tools
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Kevin Sylvestre
 bindir: exe
 cert_chain: []
-date: 2025-04-22 00:00:00.000000000 Z
+date: 2025-04-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: omniai
@@ -83,7 +83,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.6
+rubygems_version: 3.6.3
 specification_version: 4
 summary: A set of tools built for usage with OmniAI.
 test_files: []