nano-bots 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: eb32dfa429c178b7af6c3f9a4c8046846ab9ae894c94bbf2038644ceef9c2368
+  data.tar.gz: 21e37c25c085c27f0f0357f8bb878cba2a366641f9d4649dc25536bcd51afc28
+SHA512:
+  metadata.gz: 0a4a1f1a7f33eb6da088b8418cd0d4da61d8e6890ee8b6a0276330217164966b7266c032eabf3e3454e7879bd5e525b47cc99eff40259b7a1a9f9cf86a72db4f
+  data.tar.gz: 2098e8e5da98da2499ea4267e70be61ba9a06feb5c3fb6375d8ff05dbd01ae72134d34e5205884af80f3c4029c32dc09fec3c91b744ee6f61b05db8a5309b8ec

data/.gitignore

@@ -0,0 +1,2 @@
+.env
+*.gem

data/.rspec

@@ -0,0 +1 @@
+--require spec_helper

data/.rubocop.yml

@@ -0,0 +1,9 @@
+AllCops:
+  TargetRubyVersion: 3.1.4
+  NewCops: enable
+
+Style/Documentation:
+  Enabled: false
+
+require:
+ - rubocop-rspec

data/Gemfile

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+source 'https://rubygems.org'
+
+gemspec
+
+group :test, :development do
+  gem 'rspec', '~> 3.12'
+  gem 'rubocop', '~> 1.47'
+  gem 'rubocop-rspec', '~> 2.22'
+end

data/Gemfile.lock

@@ -0,0 +1,88 @@
+PATH
+  remote: .
+  specs:
+    nano-bots (0.0.1)
+      babosa (~> 2.0)
+      dotenv (~> 2.8, >= 2.8.1)
+      faraday (~> 2.7, >= 2.7.4)
+      pry (~> 0.14.2)
+      rainbow (~> 3.1, >= 3.1.1)
+      ruby-openai (~> 4.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    ast (2.4.2)
+    babosa (2.0.0)
+    coderay (1.1.3)
+    diff-lcs (1.5.0)
+    dotenv (2.8.1)
+    faraday (2.7.4)
+      faraday-net_http (>= 2.0, < 3.1)
+      ruby2_keywords (>= 0.0.4)
+    faraday-multipart (1.0.4)
+      multipart-post (~> 2)
+    faraday-net_http (3.0.2)
+    json (2.6.3)
+    method_source (1.0.0)
+    multipart-post (2.3.0)
+    parallel (1.23.0)
+    parser (3.2.2.1)
+      ast (~> 2.4.1)
+    pry (0.14.2)
+      coderay (~> 1.1)
+      method_source (~> 1.0)
+    rainbow (3.1.1)
+    regexp_parser (2.8.0)
+    rexml (3.2.5)
+    rspec (3.12.0)
+      rspec-core (~> 3.12.0)
+      rspec-expectations (~> 3.12.0)
+      rspec-mocks (~> 3.12.0)
+    rspec-core (3.12.2)
+      rspec-support (~> 3.12.0)
+    rspec-expectations (3.12.3)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.12.0)
+    rspec-mocks (3.12.5)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.12.0)
+    rspec-support (3.12.0)
+    rubocop (1.50.2)
+      json (~> 2.3)
+      parallel (~> 1.10)
+      parser (>= 3.2.0.0)
+      rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 1.8, < 3.0)
+      rexml (>= 3.2.5, < 4.0)
+      rubocop-ast (>= 1.28.0, < 2.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 2.4.0, < 3.0)
+    rubocop-ast (1.28.1)
+      parser (>= 3.2.1.0)
+    rubocop-capybara (2.18.0)
+      rubocop (~> 1.41)
+    rubocop-factory_bot (2.22.0)
+      rubocop (~> 1.33)
+    rubocop-rspec (2.22.0)
+      rubocop (~> 1.33)
+      rubocop-capybara (~> 2.17)
+      rubocop-factory_bot (~> 2.22)
+    ruby-openai (4.0.0)
+      faraday (>= 1)
+      faraday-multipart (>= 1)
+    ruby-progressbar (1.13.0)
+    ruby2_keywords (0.0.5)
+    unicode-display_width (2.4.2)
+
+PLATFORMS
+  x86_64-linux
+
+DEPENDENCIES
+  nano-bots!
+  rspec (~> 3.12)
+  rubocop (~> 1.47)
+  rubocop-rspec (~> 2.22)
+
+BUNDLED WITH
+   2.4.13

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 icebaker
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,173 @@
+# Nano Bots 💎 🤖
+
+A Ruby implementation of the [Nano Bots](https://github.com/icebaker/nano-bots) specification.
+
+![Ruby Nano Bots](https://user-images.githubusercontent.com/113217272/237839690-7880915a-b287-4484-a75e-0b96284b8a32.png)
+_Image artificially created by Midjourney through a prompt generated by a Nano Bot specialized in Midjourney._
+
+https://user-images.githubusercontent.com/113217272/237840989-1e29a5cc-6644-48d0-87b4-62798dc6ebd3.mp4
+
+- [Setup](#setup)
+- [Usage](#usage)
+  - [Command Line](#command-line)
+  - [Library](#library)
+- [Cartridges](#cartridges)
+- [Development](#development)
+  - [Publish to RubyGems](#publish-to-rubygems)
+
+## Setup
+
+For a system usage:
+
+```sh
+gem install nano-bots -v 0.0.1
+```
+
+To use it in a project, add it to your `Gemfile`:
+
+```ruby
+gem 'nano-bots', '~> 0.0.1'
+```
+
+```sh
+bundle install
+```
+
+For credentials and configurations, relevant environment variables can be set in your `.bashrc`, `.zshrc`, or equivalent files, as well as in your Docker Container or System Environment. Example:
+
+```sh
+export OPENAI_API_ADDRESS=https://api.openai.com
+export OPENAI_API_ACCESS_TOKEN=your-token
+export OPENAI_API_USER_IDENTIFIER=your-user
+
+export NANO_BOTS_STATE_DIRECTORY=/home/user/.local/state/nano-bots
+export NANO_BOTS_CARTRIDGES_DIRECTORY=/home/user/.local/share/nano-bots/cartridges
+```
+
+Alternatively, if your current directory has a `.env` file with the environment variables, they will be automatically loaded.
+
+## Usage
+
+### Command Line
+
+After installing the gem, the `rnb` binary command will be available for your project or system.
+
+Examples of usage:
+
+```bash
+rnb to-en-us-translator.yml - eval "Salut, comment ça va?"
+# => Hello, how are you doing?
+
+rnb midjourney.yml - eval "happy and friendly cyberpunk robot"
+# => The robot exploring a bustling city, surrounded by neon lights
+#    and high-rise buildings. The prompt should include colorful
+#    lighting and a sense of excitement in the facial expression.
+
+rnb lisp.yml - eval "(+ 1 2)"
+# => 3
+
+cat article.txt |
+  rnb to-en-us-translator.yml - eval |
+  rnb summarizer.yml - eval
+# -> LLM stands for Large Language Model, which refers to an
+#    artificial intelligence algorithm capable of processing
+#    and understanding vast amounts of natural language data,
+#    allowing it to generate human-like responses and perform
+#    a range of language-related tasks.
+```
+
+```bash
+rnb assistant.yml - repl
+```
+
+All of the commands above are stateless. If you want to preserve the history of your interactions, replace the `-` with a state key. You can use a simple key, such as your username, or a randomly generated one:
+
+```ruby
+require 'securerandom'
+
+SecureRandom.hex # => 6ea6c43c42a1c076b1e3c36fa349ac2c
+```
+
+```bash
+rnb assistant.yml your-user eval "Salut, comment ça va?"
+rnb assistant.yml your-user repl
+
+rnb assistant.yml 6ea6c43c42a1c076b1e3c36fa349ac2c eval "Salut, comment ça va?"
+rnb assistant.yml 6ea6c43c42a1c076b1e3c36fa349ac2c repl
+```
+
+### Library
+
+To use it as a library:
+
+```ruby
+require 'nano-bots/cli' # Equivalent to the `rnb` command.
+```
+
+```ruby
+require 'nano-bots'
+
+NanoBot.cli # Equivalent to the `rnb` command.
+
+NanoBot.repl(cartridge: 'cartridge.yml') # Starts a new REPL.
+
+bot = NanoBot.new(cartridge: 'cartridge.yml')
+
+bot.eval('Hello')
+
+bot.repl # Starts a new REPL.
+
+NanoBot.repl(cartridge: 'cartridge.yml', state: '6ea6c43c42a1c076b1e3c36fa349ac2c')
+
+bot = NanoBot.new(cartridge: 'cartridge.yml', state: '6ea6c43c42a1c076b1e3c36fa349ac2c')
+```
+
+## Cartridges
+
+Here's what a Nano Bot Cartridge looks like:
+
+```yaml
+---
+name: Assistant
+version: 0.0.1
+
+behaviors:
+  interaction:
+    directive: You are a helpful assistant.
+
+interfaces:
+  repl:
+    prompt:
+      - text: '🤖'
+      - text: '> '
+        color: blue
+
+provider:
+  name: openai
+  settings:
+    model: gpt-3.5-turbo
+    credentials:
+      address: ENV/OPENAI_API_ADDRESS
+      access-token: ENV/OPENAI_API_ACCESS_TOKEN
+      user-identifier: ENV/OPENAI_API_USER_IDENTIFIER
+```
+
+Check the Nano Bots specification to learn more about [how to build cartridges](https://icebaker.github.io/nano-bots/#/README?id=cartridges).
+
+## Development
+
+```bash
+bundle
+rubocop -A
+rspec
+```
+
+### Publish to RubyGems
+
+```bash
+gem build nano-bots.gemspec
+
+gem signin
+
+gem push nano-bots-0.0.1.gem
+```

data/bin/rnb

@@ -0,0 +1,4 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require 'nano-bots/cli'

data/components/provider.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+require 'openai'
+
+require_relative './providers/openai'
+
+module NanoBot
+  module Components
+    class Provider
+      def self.new(provider)
+        case provider[:name]
+        when 'openai'
+          Providers::OpenAI.new(provider[:settings])
+        else
+          raise "Unsupported provider #{provider[:name]}"
+        end
+      end
+    end
+  end
+end

data/components/providers/base.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+require 'openai'
+
+module NanoBot
+  module Components
+    module Providers
+      class Base
+        def evaluate(_payload)
+          raise NoMethodError, "The 'evaluate' method is not implemented for the current provider."
+        end
+      end
+    end
+  end
+end

data/components/providers/openai.rb

@@ -0,0 +1,79 @@
+# frozen_string_literal: true
+
+require 'openai'
+
+require_relative './base'
+
+module NanoBot
+  module Components
+    module Providers
+      class OpenAI < Base
+        CHAT_SETTINGS = %i[
+          model stream temperature top_p n stop max_tokens
+          presence_penalty frequency_penalty logit_bias
+        ].freeze
+
+        attr_reader :settings
+
+        def initialize(settings)
+          @settings = settings
+
+          @client = ::OpenAI::Client.new(
+            uri_base: "#{@settings[:credentials][:address].sub(%r{/$}, '')}/",
+            access_token: @settings[:credentials][:'access-token']
+          )
+        end
+
+        def evaluate(input, &block)
+          messages = input[:history].map do |event|
+            { role: event[:who] == 'user' ? 'user' : 'assistant',
+              content: event[:message] }
+          end
+
+          %i[instruction backdrop directive].each do |key|
+            next unless input[:behavior][key]
+
+            messages.prepend(
+              { role: key == :directive ? 'system' : 'user',
+                content: input[:behavior][key] }
+            )
+          end
+
+          payload = {
+            model: @settings[:model],
+            user: @settings[:credentials][:'user-identifier'],
+            messages:
+          }
+
+          CHAT_SETTINGS.each do |key|
+            payload[key] = @settings[key] if @settings.key?(key)
+          end
+
+          payload.delete(:logit_bias) if payload.key?(:logit_bias) && payload[:logit_bias].nil?
+
+          if @settings[:stream] && input[:interface][:stream]
+            content = ''
+
+            payload[:stream] = proc do |chunk, _bytesize|
+              partial = chunk.dig('choices', 0, 'delta', 'content')
+              if partial
+                content += partial
+                block.call({ who: 'AI', message: partial }, false)
+              end
+
+              block.call({ who: 'AI', message: content }, true) if chunk.dig('choices', 0, 'finish_reason')
+            end
+
+            @client.chat(parameters: payload)
+          else
+            result = @client.chat(parameters: payload)
+
+            raise StandardError, result['error'] if result['error']
+
+            block.call({ who: 'AI', message: result.dig('choices', 0, 'message', 'content') }, true)
+          end
+        end
+      end
+    end
+  end
+end

data/components/storage.rb

@@ -0,0 +1,76 @@
+# frozen_string_literal: true
+
+require 'babosa'
+
+require_relative '../logic/helpers/hash'
+
+module NanoBot
+  module Components
+    class Storage
+      def self.build_path_and_ensure_state_file!(key, cartridge)
+        path = [
+          Logic::Helpers::Hash.fetch(cartridge, %i[state directory]),
+          ENV.fetch('NANO_BOTS_STATE_DIRECTORY', nil)
+        ].find do |candidate|
+          !candidate.nil? && !candidate.empty?
+        end
+
+        path = "#{user_home!.sub(%r{/$}, '')}/.local/state/nano-bots" if path.nil?
+
+        path = "#{path.sub(%r{/$}, '')}/nano-bots-rb/#{cartridge[:name].to_slug.normalize}"
+        path = "#{path}/#{cartridge[:version].to_slug.normalize}/#{key.to_slug.normalize}"
+        path = "#{path}/state.json"
+
+        FileUtils.mkdir_p(File.dirname(path))
+
+        File.write(path, JSON.generate({ key:, history: [] })) unless File.exist?(path)
+
+        path
+      end
+
+      def self.cartridge_path(path)
+        partial = File.join(File.dirname(path), File.basename(path, File.extname(path)))
+
+        candidates = [
+          path,
+          "#{partial}.yml",
+          "#{partial}.yaml"
+        ]
+
+        unless ENV.fetch('NANO_BOTS_CARTRIDGES_DIRECTORY', nil).nil?
+          directory = ENV.fetch('NANO_BOTS_CARTRIDGES_DIRECTORY').sub(%r{/$}, '')
+
+          partial = File.join(File.dirname(partial), File.basename(partial, File.extname(partial)))
+
+          partial = path.sub(%r{^\.?/}, '')
+
+          candidates << "#{directory}/#{partial}"
+          candidates << "#{directory}/#{partial}.yml"
+          candidates << "#{directory}/#{partial}.yaml"
+        end
+
+        directory = "#{user_home!.sub(%r{/$}, '')}/.local/share/nano-bots/cartridges"
+
+        partial = File.join(File.dirname(partial), File.basename(partial, File.extname(partial)))
+
+        partial = path.sub(%r{^\.?/}, '')
+
+        candidates << "#{directory}/#{partial}"
+        candidates << "#{directory}/#{partial}.yml"
+        candidates << "#{directory}/#{partial}.yaml"
+
+        candidates = candidates.uniq
+
+        candidates.find do |candidate|
+          File.exist?(candidate) && File.file?(candidate)
+        end
+      end
+
+      def self.user_home!
+        [Dir.home, `echo ~`.strip, '~'].find do |candidate|
+          !candidate.nil? && !candidate.empty?
+        end
+      end
+    end
+  end
+end

data/controllers/instance.rb

@@ -0,0 +1,65 @@
+# frozen_string_literal: true
+
+require 'yaml'
+
+require_relative '../logic/helpers/hash'
+require_relative '../components/provider'
+require_relative '../components/storage'
+require_relative './interfaces/repl'
+require_relative './session'
+
+module NanoBot
+  module Controllers
+    class Instance
+      def initialize(cartridge_path:, state: nil)
+        load_cartridge!(cartridge_path)
+
+        provider = Components::Provider.new(@cartridge[:provider])
+
+        @session = Session.new(provider:, cartridge: @cartridge, state:)
+      end
+
+      def debug
+        @session.debug
+      end
+
+      def eval(input)
+        @session.evaluate_and_print(input, mode: 'eval')
+      end
+
+      def repl
+        Interfaces::REPL.start(@cartridge, @session)
+      end
+
+      private
+
+      def load_cartridge!(path)
+        @cartridge = Logic::Helpers::Hash.symbolize_keys(
+          YAML.safe_load(
+            File.read(Components::Storage.cartridge_path(path)),
+            permitted_classes: [Symbol]
+          )
+        )
+
+        inject_environment_variables!(@cartridge)
+      end
+
+      def inject_environment_variables!(node)
+        case node
+        when Hash
+          node.each do |key, value|
+            node[key] = inject_environment_variables!(value)
+          end
+        when Array
+          node.each_with_index do |value, index|
+            node[index] = inject_environment_variables!(value)
+          end
+        when String
+          node.start_with?('ENV') ? ENV.fetch(node.sub(/^ENV./, ''), nil) : node
+        else
+          node
+        end
+      end
+    end
+  end
+end

data/controllers/interfaces/cli.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+require_relative '../instance'
+require_relative '../../static/gem'
+
+module NanoBot
+  module Controllers
+    module Interfaces
+      module CLI
+        def self.handle!
+          case ARGV[0]
+          when 'version'
+            puts NanoBot::GEM[:version]
+            exit
+          when 'help', '', nil
+            puts "Ruby Nano Bots #{NanoBot::GEM[:version]}"
+            puts '  rnb cartridge.yml - eval "Hello"'
+            puts '  rnb cartridge.yml - repl'
+            puts '  rnb cartridge.yml - debug'
+            puts '  rnb cartridge.yml STATE-KEY eval "Hello"'
+            puts '  rnb cartridge.yml STATE-KEY repl'
+            puts '  rnb cartridge.yml STATE-KEY debug'
+            puts '  rnb version'
+            exit
+          end
+
+          params = { cartridge_path: ARGV[0], state: ARGV[1], command: ARGV[2] }
+
+          bot = Instance.new(cartridge_path: params[:cartridge_path], state: params[:state])
+
+          case params[:command]
+          when 'eval'
+            params[:input] = ARGV[3..]&.join(' ')
+            params[:input] = $stdin.read.chomp if params[:input].nil? || params[:input].empty?
+            bot.eval(params[:input])
+          when 'repl'
+            bot.repl
+          when 'debug'
+            bot.debug
+          else
+            raise "TODO: [#{params[:command]}]"
+          end
+        end
+      end
+    end
+  end
+end

data/controllers/interfaces/repl.rb

@@ -0,0 +1,67 @@
+# frozen_string_literal: true
+
+require 'pry'
+require 'rainbow'
+
+require_relative '../../logic/helpers/hash'
+
+module NanoBot
+  module Controllers
+    module Interfaces
+      module REPL
+        def self.start(cartridge, session)
+          if Logic::Helpers::Hash.fetch(
+            cartridge, %i[interfaces repl prefix]
+          )
+            session.print(Logic::Helpers::Hash.fetch(cartridge,
+                                                     %i[interfaces repl prefix]))
+          end
+
+          session.boot(mode: 'repl')
+
+          session.print(Logic::Helpers::Hash.fetch(cartridge, %i[interfaces repl postfix]) || "\n")
+
+          session.flush
+
+          prompt = build_prompt(cartridge[:interfaces][:repl][:prompt])
+
+          Pry.config.prompt = Pry::Prompt.new(
+            'REPL',
+            'REPL Prompt',
+            [proc { prompt }, proc { 'MISSING INPUT' }]
+          )
+
+          Pry.commands.block_command(/(.*)/, 'handler') do |line|
+            if Logic::Helpers::Hash.fetch(
+              cartridge, %i[interfaces repl prefix]
+            )
+              session.print(Logic::Helpers::Hash.fetch(
+                              cartridge, %i[interfaces repl prefix]
+                            ))
+            end
+
+            session.evaluate_and_print(line, mode: 'repl')
+            session.print(Logic::Helpers::Hash.fetch(cartridge, %i[interfaces repl postfix]) || "\n")
+            session.flush
+          end
+
+          Pry.start
+        end
+
+        def self.build_prompt(prompt)
+          result = ''
+
+          prompt.each do |partial|
+            result += if partial[:color]
+                        Rainbow(partial[:text]).send(partial[:color])
+                      else
+                        partial[:text]
+                      end
+          end
+
+          result
+        end
+      end
+    end
+  end
+end

data/controllers/session.rb

@@ -0,0 +1,114 @@
+# frozen_string_literal: true
+
+require 'babosa'
+
+require 'fileutils'
+
+require_relative '../logic/helpers/hash'
+require_relative '../components/storage'
+
+module NanoBot
+  module Controllers
+    STREAM_TIMEOUT_IN_SECONDS = 5
+
+    class Session
+      def initialize(provider:, cartridge:, state: nil)
+        @provider = provider
+        @cartridge = cartridge
+
+        @output = $stdout
+
+        @stateless = state.nil? || state.strip == '-' || state.strip.empty?
+
+        if @stateless
+          @state = { history: [] }
+        else
+          @state_path = Components::Storage.build_path_and_ensure_state_file!(
+            state.strip, @cartridge
+          )
+          @state = load_state
+        end
+      end
+
+      def debug
+        pp({
+             state: {
+               path: @state_path,
+               content: @state
+             }
+           })
+      end
+
+      def load_state
+        @state = Logic::Helpers::Hash.symbolize_keys(JSON.parse(File.read(@state_path)))
+      end
+
+      def store_state!
+        File.write(@state_path, JSON.generate(@state))
+      end
+
+      def boot(mode:)
+        return unless Logic::Helpers::Hash.fetch(@cartridge, %i[behaviors boot instruction])
+
+        behavior = Logic::Helpers::Hash.fetch(@cartridge, %i[behaviors boot]) || {}
+
+        input = { behavior:, history: [] }
+
+        process(input, mode:)
+      end
+
+      def evaluate_and_print(message, mode:)
+        behavior = Logic::Helpers::Hash.fetch(@cartridge, %i[behaviors interaction]) || {}
+
+        @state[:history] << ({ who: 'user', message: })
+
+        input = { behavior:, history: @state[:history] }
+
+        process(input, mode:)
+      end
+
+      def process(input, mode:)
+        streaming = @provider.settings[:stream] && Logic::Helpers::Hash.fetch(
+          @cartridge, [:interfaces, mode.to_sym, :stream]
+        )
+
+        interface = Logic::Helpers::Hash.fetch(@cartridge, [:interfaces, mode.to_sym]) || {}
+
+        input[:interface] = interface
+
+        updated_at = Time.now
+
+        ready = false
+        @provider.evaluate(input) do |output, finished|
+          updated_at = Time.now
+          if finished
+            @state[:history] << output
+            self.print(output[:message]) unless streaming
+            unless Logic::Helpers::Hash.fetch(@cartridge, [:interfaces, mode.to_sym, :postfix]).nil?
+              self.print(Logic::Helpers::Hash.fetch(@cartridge, [:interfaces, mode.to_sym, :postfix]))
+            end
+            ready = true
+            flush
+          elsif streaming
+            self.print(output[:message])
+          end
+        end
+
+        until ready
+          seconds = (Time.now - updated_at).to_i
+          raise StandardError, 'The stream has become unresponsive.' if seconds >= STREAM_TIMEOUT_IN_SECONDS
+        end
+
+        store_state! unless @stateless
+      end
+
+      def flush
+        @output.flush
+      end
+
+      def print(content)
+        @output.write(content)
+      end
+    end
+  end
+end

data/logic/helpers/hash.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+module NanoBot
+  module Logic
+    module Helpers
+      module Hash
+        def self.symbolize_keys(object)
+          case object
+          when ::Hash
+            object.each_with_object({}) do |(key, value), result|
+              result[key.to_sym] = symbolize_keys(value)
+            end
+          when Array
+            object.map { |e| symbolize_keys(e) }
+          else
+            object
+          end
+        end
+
+        def self.fetch(object, path)
+          node = object
+
+          return nil unless node
+
+          path.each do |key|
+            node = node[key]
+            break if node.nil?
+          end
+
+          node
+        end
+      end
+    end
+  end
+end

data/nano-bots.gemspec

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+require_relative 'static/gem'
+
+Gem::Specification.new do |spec|
+  spec.name    = NanoBot::GEM[:name]
+  spec.version = NanoBot::GEM[:version]
+  spec.authors = [NanoBot::GEM[:author]]
+
+  spec.summary = NanoBot::GEM[:summary]
+  spec.description = NanoBot::GEM[:description]
+
+  spec.homepage = NanoBot::GEM[:github]
+
+  spec.license = NanoBot::GEM[:license]
+
+  spec.required_ruby_version = Gem::Requirement.new(">= #{NanoBot::GEM[:ruby]}")
+
+  spec.metadata['allowed_push_host'] = NanoBot::GEM[:gem_server]
+
+  spec.metadata['homepage_uri'] = spec.homepage
+  spec.metadata['source_code_uri'] = NanoBot::GEM[:github]
+
+  spec.files = Dir.chdir(File.expand_path(__dir__)) do
+    `git ls-files -z`.split("\x0").reject do |f|
+      f.match(%r{\A(?:test|spec|features)/})
+    end
+  end
+
+  spec.require_paths = ['ports/dsl']
+
+  spec.executables = ['rnb']
+
+  spec.add_dependency 'babosa', '~> 2.0'
+  spec.add_dependency 'dotenv', '~> 2.8', '>= 2.8.1'
+  spec.add_dependency 'faraday', '~> 2.7', '>= 2.7.4'
+  spec.add_dependency 'pry', '~> 0.14.2'
+  spec.add_dependency 'rainbow', '~> 3.1', '>= 3.1.1'
+  spec.add_dependency 'ruby-openai', '~> 4.0'
+
+  spec.metadata['rubygems_mfa_required'] = 'true'
+end

data/ports/dsl/nano-bots/cli.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+require 'nano-bots'
+
+NanoBot.cli

data/ports/dsl/nano-bots.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+require 'dotenv/load'
+
+require_relative '../../static/gem'
+require_relative '../../controllers/instance'
+require_relative '../../controllers/interfaces/cli'
+
+module NanoBot
+  def self.new(cartridge:, state: '-')
+    Controllers::Instance.new(cartridge_path: cartridge, state:)
+  end
+
+  def self.cli
+    Controllers::Interfaces::CLI.handle!
+  end
+
+  def self.repl(cartridge:, state: '-')
+    Controllers::Instance.new(cartridge_path: cartridge, state:).repl
+  end
+
+  def self.version
+    NanoBot::GEM[:version]
+  end
+end

data/static/gem.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module NanoBot
+  GEM = {
+    name: 'nano-bots',
+    version: '0.0.1',
+    author: 'icebaker',
+    summary: 'Ruby Implementation of Nano Bots: small, AI-powered bots',
+    description: 'Ruby Implementation of Nano Bots: small, AI-powered bots easily shared as a single file, designed to support multiple providers such as Vicuna, OpenAI ChatGPT, Google PaLM, Alpaca, and LLaMA.',
+    github: 'https://github.com/icebaker/ruby-nano-bots',
+    gem_server: 'https://rubygems.org',
+    license: 'MIT',
+    ruby: '3.1.4'
+  }.freeze
+end

metadata

@@ -0,0 +1,172 @@
+--- !ruby/object:Gem::Specification
+name: nano-bots
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- icebaker
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2023-05-12 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: babosa
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: dotenv
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.8'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.8.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.8'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.8.1
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.7'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.7.4
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.7'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.7.4
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.14.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.14.2
+- !ruby/object:Gem::Dependency
+  name: rainbow
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.1'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.1.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.1'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.1.1
+- !ruby/object:Gem::Dependency
+  name: ruby-openai
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.0'
+description: 'Ruby Implementation of Nano Bots: small, AI-powered bots easily shared
+  as a single file, designed to support multiple providers such as Vicuna, OpenAI
+  ChatGPT, Google PaLM, Alpaca, and LLaMA.'
+email: 
+executables:
+- rnb
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".rubocop.yml"
+- Gemfile
+- Gemfile.lock
+- LICENSE
+- README.md
+- bin/rnb
+- components/provider.rb
+- components/providers/base.rb
+- components/providers/openai.rb
+- components/storage.rb
+- controllers/instance.rb
+- controllers/interfaces/cli.rb
+- controllers/interfaces/repl.rb
+- controllers/session.rb
+- logic/helpers/hash.rb
+- nano-bots.gemspec
+- ports/dsl/nano-bots.rb
+- ports/dsl/nano-bots/cli.rb
+- static/gem.rb
+homepage: https://github.com/icebaker/ruby-nano-bots
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+  homepage_uri: https://github.com/icebaker/ruby-nano-bots
+  source_code_uri: https://github.com/icebaker/ruby-nano-bots
+  rubygems_mfa_required: 'true'
+post_install_message: 
+rdoc_options: []
+require_paths:
+- ports/dsl
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.1.4
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.4.10
+signing_key: 
+specification_version: 4
+summary: 'Ruby Implementation of Nano Bots: small, AI-powered bots'
+test_files: []