boxcars 0.1.1 → 0.1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6ffc107602f3a2ae47bdb5b5410f6abc8c2ea2c3a13f350630e4d3ece92768f7
-  data.tar.gz: d4fcc08768de5f512a15bf0ca929d50b2a7296937c27c0f1b390189bf0956782
+  metadata.gz: 1d5ae0de1aba4038723912365d6ac1d50da0e34a40aad508130ecc86e71f91de
+  data.tar.gz: e0430621516358a59b7eeaadfa44fe78eed0b3ef92d929c264435d0946dbce5e
 SHA512:
-  metadata.gz: b89e78ce7fec471c8c4f03d32a37bdffd5d1371ac474d14f7e1c90e653ccce62b30a95a845c5c1c1013f5a028c00bb3c87c35cc1394add0554bb33e232b6de63
-  data.tar.gz: 9007dcd0b5dfc8d3b886579cd563b085c04c471ffc3bb167f5d80adb74f85ceacdd5d40942f1772bd59ce4da5903deec2262420e28eba430394d0f831d6cd751
+  metadata.gz: a054ad6b3b3caef1c6bb39fbd9a667779c4dc638800e905b717285b8f5dde4a578e3325373176b099af9f4f7d07b6f7803f87fe67c4f771bfce8894ef209188e
+  data.tar.gz: f3a3020bd0c393c25cd430b8702e26a7a39b87127372787c416042da63c6fb90826773ca81a456ba67a1add908790620757d8b9aab4db32269e3391d576c5ea5

data/CHANGELOG.md

@@ -1,7 +1,36 @@
-## [0.1.1] - 2o23-02-16
-Changed
-- updated to OpenAI gem 3.0
+# Changelog
 
-## [0.1.0] - 2023-02-15
+## [Unreleased](https://github.com/BoxcarsAI/boxcars/tree/HEAD)
 
-- Initial release
+[Full Changelog](https://github.com/BoxcarsAI/boxcars/compare/v0.1.2...HEAD)
+
+**Closed issues:**
+
+- Make sure the yard docs are up to date and have coverage [\#7](https://github.com/BoxcarsAI/boxcars/issues/7)
+- Specs need environment variables to be set to run green [\#4](https://github.com/BoxcarsAI/boxcars/issues/4)
+
+**Merged pull requests:**
+
+- Get GitHub Actions to green [\#5](https://github.com/BoxcarsAI/boxcars/pull/5) ([petergoldstein](https://github.com/petergoldstein))
+- Fix typo introduced by merge.  Pull publish-rubygem into its own job [\#3](https://github.com/BoxcarsAI/boxcars/pull/3) ([petergoldstein](https://github.com/petergoldstein))
+
+## [v0.1.2](https://github.com/BoxcarsAI/boxcars/tree/v0.1.2) (2023-02-17)
+
+[Full Changelog](https://github.com/BoxcarsAI/boxcars/compare/v0.1.1...v0.1.2)
+
+**Merged pull requests:**
+
+- Run GitHub Actions against multiple Rubies [\#2](https://github.com/BoxcarsAI/boxcars/pull/2) ([petergoldstein](https://github.com/petergoldstein))
+- \[infra\] Added deployment step for the RubyGems [\#1](https://github.com/BoxcarsAI/boxcars/pull/1) ([AKovtunov](https://github.com/AKovtunov))
+
+## [v0.1.1](https://github.com/BoxcarsAI/boxcars/tree/v0.1.1) (2023-02-16)
+
+[Full Changelog](https://github.com/BoxcarsAI/boxcars/compare/v0.1.0...v0.1.1)
+
+## [v0.1.0](https://github.com/BoxcarsAI/boxcars/tree/v0.1.0) (2023-02-15)
+
+[Full Changelog](https://github.com/BoxcarsAI/boxcars/compare/e3c50bdc76f71c6d2abb012c38174633a5847028...v0.1.0)
+
+
+
+\* *This Changelog was automatically generated by [github_changelog_generator](https://github.com/github-changelog-generator/github-changelog-generator)*

data/Gemfile

@@ -22,3 +22,5 @@ gem "rubocop-rspec", "~> 2.17"
 gem "sqlite3", "~> 1.6"
 
 gem "activerecord", "~> 7.0"
+
+gem "github_changelog_generator", "~> 1.16"

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    boxcars (0.1.1)
+    boxcars (0.1.3)
       google_search_results (~> 2.2)
       ruby-openai (~> 3.0)
 
@@ -21,7 +21,28 @@ GEM
     addressable (2.8.1)
       public_suffix (>= 2.0.2, < 6.0)
     ast (2.4.2)
+    async (1.30.3)
+      console (~> 1.10)
+      nio4r (~> 2.3)
+      timers (~> 4.1)
+    async-http (0.60.1)
+      async (>= 1.25)
+      async-io (>= 1.28)
+      async-pool (>= 0.2)
+      protocol-http (~> 0.24.0)
+      protocol-http1 (~> 0.15.0)
+      protocol-http2 (~> 0.15.0)
+      traces (>= 0.8.0)
+    async-http-faraday (0.11.0)
+      async-http (~> 0.42)
+      faraday
+    async-io (1.34.3)
+      async
+    async-pool (0.3.12)
+      async (>= 1.25)
     concurrent-ruby (1.2.0)
+    console (1.16.2)
+      fiber-local
     crack (0.4.5)
       rexml
     debug (1.7.1)
@@ -29,6 +50,22 @@ GEM
       reline (>= 0.3.1)
     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-http-cache (2.4.1)
+      faraday (>= 0.8)
+    faraday-net_http (3.0.2)
+    fiber-local (1.0.0)
+    github_changelog_generator (1.16.4)
+      activesupport
+      async (>= 1.25.0)
+      async-http-faraday
+      faraday-http-cache
+      multi_json
+      octokit (~> 4.6)
+      rainbow (>= 2.2.1)
+      rake (>= 10.0)
     google_search_results (2.2.0)
     hashdiff (1.0.1)
     httparty (0.21.0)
@@ -37,15 +74,31 @@ GEM
     i18n (1.12.0)
       concurrent-ruby (~> 1.0)
     io-console (0.6.0)
+    io-console (0.6.0-java)
     irb (1.6.2)
       reline (>= 0.3.0)
     json (2.6.3)
+    json (2.6.3-java)
     mini_mime (1.1.2)
+    mini_portile2 (2.8.1)
     minitest (5.17.0)
+    multi_json (1.15.0)
     multi_xml (0.6.0)
+    nio4r (2.5.8)
+    nio4r (2.5.8-java)
+    octokit (4.25.1)
+      faraday (>= 1, < 3)
+      sawyer (~> 0.9)
     parallel (1.22.1)
     parser (3.2.1.0)
       ast (~> 2.4.1)
+    protocol-hpack (1.4.2)
+    protocol-http (0.24.1)
+    protocol-http1 (0.15.0)
+      protocol-http (~> 0.22)
+    protocol-http2 (0.15.1)
+      protocol-hpack (~> 1.4)
+      protocol-http (~> 0.18)
     public_suffix (5.0.1)
     rainbow (3.1.1)
     rake (13.0.6)
@@ -88,7 +141,16 @@ GEM
     ruby-openai (3.3.0)
       httparty (>= 0.18.1)
     ruby-progressbar (1.11.0)
+    ruby2_keywords (0.0.5)
+    sawyer (0.9.2)
+      addressable (>= 2.3.5)
+      faraday (>= 0.17.3, < 3)
+    sqlite3 (1.6.0)
+      mini_portile2 (~> 2.8.0)
     sqlite3 (1.6.0-x86_64-darwin)
+    sqlite3 (1.6.0-x86_64-linux)
+    timers (4.3.5)
+    traces (0.8.0)
     tzinfo (2.0.6)
       concurrent-ruby (~> 1.0)
     unicode-display_width (2.4.2)
@@ -99,13 +161,17 @@ GEM
       hashdiff (>= 0.4.0, < 2.0.0)
 
 PLATFORMS
+  universal-java-11
   x86_64-darwin-21
+  x86_64-darwin-22
+  x86_64-linux
 
 DEPENDENCIES
   activerecord (~> 7.0)
   boxcars!
   debug (~> 1.1)
   dotenv (~> 2.8)
+  github_changelog_generator (~> 1.16)
   rake (~> 13.0)
   rspec (~> 3.2)
   rubocop (~> 1.21)
@@ -116,4 +182,4 @@ DEPENDENCIES
   webmock (~> 3.18.1)
 
 BUNDLED WITH
-   2.2.32
+   2.4.7

data/README.md

@@ -1,8 +1,15 @@
 # Boxcars
 
-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/boxcars`. To experiment with that code, run `bin/console` for an interactive prompt.
+This gem lets you compose new systems with composability using systems like OpenAI, Search, and SQL (and many more).
 
-TODO: Delete this and the text above, and describe your gem
+The popular python library langchain is a precursor to this work, but we wanted to put a ruby spin on things and make it easier to get started.
+
+## Concepts
+All of these concepts are in a module named Boxcars:
+- Prompt: a prompt is used by an Engine to generate text results.
+- Engine: an entity that generates text from a Prompt.
+- Boxcar: an encapsulation that does one thing (search, math, SQL, etc) and a many use an Engine to get their work accomplished.cc
+- Train: given a list of Boxcars and an Engine, an answer if found by breaking the promlem into peices for an indvidual Boxcar to solve. This is all joined back together to yield a final result. There is currently only one implementation - ZeroShot. You can construct it directly, or just use `Boxcars::default_train`
 
 ## Installation
 
@@ -22,7 +29,74 @@ Or install it yourself as:
 
 ## Usage
 
-TODO: Write usage instructions here
+We will document many more examples soon, but here are a couple. The first step is to setup your environment variables for OpenAI and Serp (OPENAI_ACCESS_TOKEN, SERPAPI_API_KEY). If you don't want to set them in your environment, they can be passed in as well to the API.
+
+In the examples below, we added one rubygem to load the environment at the first line, but depending on what you want, you might not need this.
+```ruby
+require "dotenv/load"
+require "boxcars"
+```
+
+### Direct Boxcar Use
+
+```ruby
+# run the calculator
+engine = Boxcars::Openai.new(max_tokens: 256)
+calc = Boxcars::Calculator.new(engine: engine)
+puts calc.run "what is pi to the forth power divided by 22.1?"
+```
+This segment above (try it by pasting into an `irb` session)
+```text
+> Entering Calculator#run
+what is pi to the forth power divided by 22.1?
+RubyREPL: puts(Math::PI**4 / 22.1)
+Answer: 4.407651178009159
+
+4.407651178009159
+< Exiting Calculator#run
+4.407651178009159
+```
+
+Note that since Openai is currently the most used Engine, if you do not pass in an engine, it will default as expected. So, this is the equialent shorter version of the above script:
+```ruby
+# run the calculator
+calc = Boxcars::Calculator.new # just use the default Engine
+puts calc.run "what is pi to the forth power divided by 22.1?"
+```
+### Boxcars currently implemmented
+
+Here is what we have so far, but please put up a PR with your new ideas.
+- Search: uses the SERP API to do seaches
+- Calculator: uses an Engine to generate ruby code to do math
+- SQL: given an ActiveRecord connection, it will generate and run sql statments from a prompt.
+
+### Run a list of Boxcars
+```ruby
+# run a Train for a calculator, and search using default Engine
+boxcars = [Boxcars::Calculator.new, Boxcars::Serp.new]
+train = Boxcars.default_train.new(boxcars: boxcars)
+puts train.run "What is pi times the square root of the average temperature in Austin TX in January?"
+```
+This outputs:
+```text
+> Entering Zero Shot#run
+What is pi times the square root of the average temperature in Austin TX in January?
+Question: Average temperature in Austin TX in January
+Answer: increase from 62°F to 64°F
+#Observation: increase from 62°F to 64°F
+> Entering Calculator#run
+64°F x pi
+RubyREPL: puts (64 * Math::PI).round(2)
+Answer: 201.06
+
+201.06
+< Exiting Calculator#run
+#Observation: 201.06
+I now know the final answer
+Final Answer: 201.06
+< Exiting Zero Shot#run
+201.06
+```
 
 ## Development
 

data/Rakefile

@@ -10,3 +10,10 @@ require "rubocop/rake_task"
 RuboCop::RakeTask.new
 
 task default: %i[spec rubocop]
+
+require 'github_changelog_generator/task'
+
+GitHubChangelogGenerator::RakeTask.new :changelog do |config|
+  config.user = 'BoxcarsAI'
+  config.project = 'boxcars'
+end

data/boxcars.gemspec

@@ -9,7 +9,7 @@ Gem::Specification.new do |spec|
   spec.email = ["hi@boxcars.ai"]
 
   spec.summary = "Boxcars provide an API to connect together Boxcars and then conduct them. Inspired by python langchain."
-  spec.description = "You simply give a number of boxcars to a conductor, and it does the magic."
+  spec.description = "You simply give a number of boxcars to a train, and it does the magic."
   spec.homepage = "https://github.com/BoxcarsAI/boxcars"
   spec.license = "MIT"
   spec.required_ruby_version = ">= 2.6.0"

data/lib/boxcars/boxcar/calculator.rb

@@ -4,15 +4,15 @@
 module Boxcars
   # A Boxcar that interprets a prompt and executes ruby code to do math
   class Calculator < EngineBoxcar
+    # the description of this engine boxcar
     CALCDESC = "useful for when you need to answer questions about math"
     attr_accessor :input_key
 
-    # @param prompt [Boxcars::Prompt] The prompt to use for this boxcar.
-    # @param name [String] The name of the boxcar. Defaults to classname.
-    # @param description [String] A description of the boxcar.
-    # @param engine [Boxcars::Engine] The engine to user for this boxcar. Can be inherited from a conductor if nil.
+    # @param engine [Boxcars::Engine] The engine to user for this boxcar. Can be inherited from a train if nil.
+    # @param prompt [Boxcars::Prompt] The prompt to use for this boxcar. Defaults to built-in prompt.
     # @param input_key [Symbol] The key to use for the input. Defaults to :question.
     # @param output_key [Symbol] The key to use for the output. Defaults to :answer.
+    # @param kwargs [Hash] Any other keyword arguments to pass to the parent class.
     def initialize(engine: nil, prompt: nil, input_key: :question, output_key: :answer, **kwargs)
       # def initialize(engine:, prompt: my_prompt, input_key: :question, output_key: :answer, **kwargs)
       @input_key = input_key
@@ -24,14 +24,19 @@ module Boxcars
             output_key: output_key)
     end
 
+    # the prompt input keys
     def input_keys
       [input_key]
     end
 
+    # the output keys
     def output_keys
       [output_key]
     end
 
+    # call the calculator
+    # @param inputs [Hash] The inputs to the boxcar.
+    # @return [Hash] The outputs from the boxcar.
     def call(inputs:)
       t = predict(question: inputs[input_key], stop: ["```output"]).strip
       answer = get_answer(t)
@@ -58,7 +63,9 @@ module Boxcars
       end
     end
 
-    TEMPLATE = <<~IPT
+    # our template
+    # rubocop:disable Style/RedundantHeredocDelimiterQuotes
+    TEMPLATE = <<~'IPT'
       You are GPT-3, and you can't do math.
       You can do basic math, and your memorization abilities are impressive, but you can't do any complex calculations that a human could not do in their head. You also have an annoying tendency to just make up highly specific, but wrong, answers.
       So we hooked you up to a Ruby 3 kernel, and now you can execute ruby code. If anyone gives you a hard math problem, just use this format and we’ll take care of the rest:
@@ -93,6 +100,7 @@ module Boxcars
 
       Question: %<question>s
     IPT
+    # rubocop:enable Style/RedundantHeredocDelimiterQuotes
 
     # The prompt to use for the engine.
     def my_prompt

data/lib/boxcars/boxcar/engine_boxcar.rb

@@ -3,55 +3,48 @@
 # Boxcars is a framework for running a series of tools to get an answer to a question.
 module Boxcars
   # For Boxcars that use an engine to do their work.
-  # @abstract
-  class EngineBoxcar < Boxcars::Boxcar
+  class EngineBoxcar < Boxcar
     attr_accessor :prompt, :engine, :output_key
 
     # A Boxcar is a container for a single tool to run.
     # @param prompt [Boxcars::Prompt] The prompt to use for this boxcar with sane defaults.
     # @param name [String] The name of the boxcar. Defaults to classname.
     # @param description [String] A description of the boxcar.
-    # @param engine [Boxcars::Engine] The engine to user for this boxcar. Can be inherited from a conductor if nil.
-    def initialize(prompt:, engine:, output_key: "text", name: nil, description: nil)
+    # @param engine [Boxcars::Engine] The engine to user for this boxcar. Can be inherited from a train if nil.
+    def initialize(prompt:, engine: nil, output_key: "text", name: nil, description: nil)
       @prompt = prompt
-      @engine = engine
+      @engine = engine || Boxcars.default_engine.new
       @output_key = output_key
       super(name: name, description: description)
     end
 
+    # input keys for the prompt
     def input_keys
       prompt.input_variables
     end
 
+    # output keys
     def output_keys
       [output_key]
     end
 
-    # # Check that all inputs are present.
-    # def validate_inputs(inputs:)
-    #   missing_keys = input_keys - inputs.keys
-    #   raise Boxcars::ArgumentError, "Missing some input keys: #{missing_keys}" if missing_keys.any?
-
-    #   inputs
-    # end
-
-    # def validate_outputs(outputs:)
-    #   return if outputs.sort == output_keys.sort
-
-    #   raise Boxcars::ArgumentError, "Did not get out keys that were expected, got: #{outputs}. Expected: #{output_keys}"
-    # end
-
+    # generate a response from the engine
+    # @param input_list [Array<Hash>] A list of hashes of input values to use for the prompt.
+    # @return [Boxcars::EngineResult] The result from the engine.
     def generate(input_list:)
       stop = input_list[0][:stop]
       prompts = []
       input_list.each do |inputs|
         new_prompt = prompt.format(**inputs)
-        puts "Prompt after formatting:\n#{new_prompt.colorize(:cyan)}"
+        puts "Prompt after formatting:\n#{new_prompt.colorize(:cyan)}" if Boxcars.configuration.log_prompts
         prompts.push(new_prompt)
       end
       engine.generate(prompts: prompts, stop: stop)
     end
 
+    # apply a response from the engine
+    # @param input_list [Array<Hash>] A list of hashes of input values to use for the prompt.
+    # @return [Hash] A hash of the output key and the output value.
     def apply(input_list:)
       response = generate(input_list: input_list)
       response.generations.to_h do |generation|
@@ -59,10 +52,16 @@ module Boxcars
       end
     end
 
+    # predict a response from the engine
+    # @param kwargs [Hash] A hash of input values to use for the prompt.
+    # @return [String] The output value.
     def predict(**kwargs)
       apply(input_list: [kwargs])[output_key]
     end
 
+    # predict a response from the engine and parse it
+    # @param kwargs [Hash] A hash of input values to use for the prompt.
+    # @return [String] The output value.
     def predict_and_parse(**kwargs)
       result = predict(**kwargs)
       if prompt.output_parser
@@ -72,6 +71,9 @@ module Boxcars
       end
     end
 
+    # apply a response from the engine and parse it
+    # @param input_list [Array<Hash>] A list of hashes of input values to use for the prompt.
+    # @return [Array<String>] The output values.
     def apply_and_parse(input_list:)
       result = apply(input_list: input_list)
       if prompt.output_parser
@@ -81,6 +83,8 @@ module Boxcars
       end
     end
 
+    # check that there is exactly one output key
+    # @raise [Boxcars::ArgumentError] if there is not exactly one output key.
     def check_output_keys
       return unless output_keys.length != 1
 

data/lib/boxcars/boxcar/serp.rb

@@ -4,14 +4,14 @@ require 'google_search_results'
 module Boxcars
   # A Boxcar that uses the Google SerpAPI to get answers to questions.
   class Serp < Boxcar
+    # the description of this boxcar
     SERPDESC = "useful for when you need to answer questions about current events." \
                "You should ask targeted questions"
 
     # implements a boxcar that uses the Google SerpAPI to get answers to questions.
     # @param name [String] The name of the boxcar. Defaults to classname.
     # @param description [String] A description of the boxcar. Defaults to SERPDESC.
-    # @param engine [Boxcars::Engine] The engine to user for this boxcar. Can be inherited from a Conductor if nil.
-    #
+    # @param serpapi_api_key [String] The API key to use for the SerpAPI. Defaults to Boxcars.configuration.serpapi_api_key.
     def initialize(name: "Search", description: SERPDESC, serpapi_api_key: "not set")
       super(name: name, description: description)
       api_key = Boxcars.configuration.serpapi_api_key(serpapi_api_key: serpapi_api_key)

data/lib/boxcars/boxcar/sql.rb

@@ -4,16 +4,16 @@
 module Boxcars
   # A Boxcar that interprets a prompt and executes SQL code to get answers
   class SQL < EngineBoxcar
+    # the description of this engine boxcar
     SQLDESC = "useful for when you need to query a SQL database"
     attr_accessor :connection, :input_key
 
     # @param connection [ActiveRecord::Connection] The SQL connection to use for this boxcar.
-    # @param prompt [Boxcars::Prompt] The prompt to use for this boxcar.
-    # @param name [String] The name of the boxcar. Defaults to classname.
-    # @param description [String] A description of the boxcar.
-    # @param engine [Boxcars::Engine] The engine to user for this boxcar. Can be inherited from a conductor if nil.
+    # @param engine [Boxcars::Engine] The engine to user for this boxcar. Can be inherited from a train if nil.
     # @param input_key [Symbol] The key to use for the input. Defaults to :question.
     # @param output_key [Symbol] The key to use for the output. Defaults to :answer.
+    # @param kwargs [Hash] Any other keyword arguments to pass to the parent class. This can include
+    #   :name, :description and :prompt
     def initialize(connection:, engine: nil, input_key: :question, output_key: :answer, **kwargs)
       @connection = connection
       @input_key = input_key
@@ -25,14 +25,21 @@ module Boxcars
             output_key: output_key)
     end
 
+    # the input keys for the prompt
+    # @return [Array<Symbol>] The input keys for the prompt.
     def input_keys
       [input_key]
     end
 
+    # the output keys for the prompt
+    # @return [Array<Symbol>] The output keys for the prompt.
     def output_keys
       [output_key]
     end
 
+    # call the boxcar
+    # @param inputs [Hash] The inputs to the boxcar.
+    # @return [Hash] The outputs from the boxcar.
     def call(inputs:)
       t = predict(question: inputs[input_key], dialect: dialect, top_k: 5, table_info: schema, stop: ["Answer:"]).strip
       answer = get_answer(t)

data/lib/boxcars/boxcar.rb

@@ -11,7 +11,7 @@ module Boxcars
     # @param return_direct [Boolean] If true, return the output of this boxcar directly, without merging it with the inputs.
     def initialize(description:, name: nil, return_direct: false)
       @name = name || self.class.name
-      @description = description
+      @description = description || @name
       @return_direct = return_direct
     end
 
@@ -26,6 +26,8 @@ module Boxcars
     end
 
     # Check that all inputs are present.
+    # @param inputs [Hash] The inputs.
+    # @raise [RuntimeError] If the inputs are not the same.
     def validate_inputs(inputs:)
       missing_keys = input_keys - inputs.keys
       raise "Missing some input keys: #{missing_keys}" if missing_keys.any?
@@ -33,6 +35,9 @@ module Boxcars
       inputs
     end
 
+    # check that all outputs are present
+    # @param outputs [Array<String>] The output keys.
+    # @raise [RuntimeError] If the outputs are not the same.
     def validate_outputs(outputs:)
       return if outputs.sort == output_keys.sort
 
@@ -44,6 +49,28 @@ module Boxcars
       raise NotImplementedError
     end
 
+    # Apply the boxcar to a list of inputs.
+    # @param input_list [Array<Hash>] The list of inputs.
+    # @return [Array<Boxcars::Boxcar>] The list of outputs.
+    def apply(input_list:)
+      raise NotImplementedError
+    end
+
+    # Get an answer from the boxcar.
+    # @param args [Array] The positional arguments to pass to the boxcar.
+    # @param kwargs [Hash] The keyword arguments to pass to the boxcar.
+    # you can pass one or the other, but not both.
+    # @return [String] The answer to the question.
+    def run(*args, **kwargs)
+      puts "> Entering #{name}#run".colorize(:gray, style: :bold)
+      rv = do_run(*args, **kwargs)
+      puts "< Exiting #{name}#run".colorize(:gray, style: :bold)
+      rv
+    end
+
+    private
+
+    # Get an answer from the boxcar.
     def do_call(inputs:, return_only_outputs: false)
       inputs = our_inputs(inputs)
       output = nil
@@ -60,22 +87,6 @@ module Boxcars
       inputs.merge(output)
     end
 
-    def apply(input_list:)
-      input_list.map { |inputs| new(**inputs) }
-    end
-
-    # Get an answer from the boxcar.
-    # @param question [String] The question to ask the boxcar.
-    # @return [String] The answer to the question.
-    def run(*args, **kwargs)
-      puts "> Enterning #{name} boxcar#run".colorize(:gray, style: :bold)
-      rv = do_run(*args, **kwargs)
-      puts "< Exiting #{name} boxcar#run".colorize(:gray, style: :bold)
-      rv
-    end
-
-    private
-
     def do_run(*args, **kwargs)
       if kwargs.empty?
         raise Boxcars::ArgumentError, "run supports only one positional argument." if args.length != 1