clag 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 29a6ab190bdd6accfd67782655a99b3f255c0d5b217a18fa41ddd2bf1f837dea
+  data.tar.gz: 6ad8f31dcebbcc91a8e17d1cb4a90de81ce93f91799de6a7e7e3abd721f15017
+SHA512:
+  metadata.gz: b7751ed524c187b0925610419caaedce08605caaea43df5066def060dfd8fcb7ee112afa0c8185ef684103d9924f6b06d24475fe81d2ee552ebe9b698fad9336
+  data.tar.gz: d6ba64383b5500c849179203b4aac5f4d88ecd048319b0a9ce2a87946cb8a8c7e558316b5763d660a329eb1a201fd6052278429fbb5a657f7cce0782df5295a2

data/.gitignore

@@ -0,0 +1,16 @@
+*.gem
+.rvmrc
+.ruby-version
+.ruby-gemset
+.bundle
+Gemfile.lock
+pkg/*
+coverage.data
+coverage/*
+.yardoc
+doc/*
+tmp
+vendor/bundle
+*.swp
+*.swo
+*.DS_Store

data/Gemfile

@@ -0,0 +1,9 @@
+source 'https://rubygems.org'
+
+gemspec
+
+group :test do
+  gem 'mocha', '~> 1.5.0', require: false
+  gem 'minitest', '>= 5.0.0', require: false
+  gem 'minitest-reporters', require: false
+end

data/README.md

@@ -0,0 +1,30 @@
+# clag - Command Line AI Gem
+
+Tired of trying to remember the exact flags to use or digging through
+documentation or googling to find how to do the thing you're trying to do?
+
+Suffer no more! Simply describe what you're trying to do and generate the
+command with the help of an LLM!
+
+## Installation
+
+* Get an API key from OpenAI for gpt4-turbo: https://platform.openai.com/
+
+* Set your API key as OPENAI\_API\_KEY in your environment
+
+* Install the gem
+`gem install clag`
+
+* Generate commands
+`clag g "create a new ruby on rails project using postgres and tailwindcss"`
+
+## Usage
+
+Currently support one command: "g".
+
+`clag g "the command you'd like to generate"`
+
+## Contributing
+
+Bug reports and pull requests are welcome on Github at
+https://github.com/sublayerapp/clag

data/bin/testunit

@@ -0,0 +1,23 @@
+#!/usr/bin/env ruby
+
+require 'rubygems'
+require 'bundler/setup'
+
+root = File.expand_path('../..', __FILE__)
+TEST_ROOT = root + '/test'
+
+$LOAD_PATH.unshift(TEST_ROOT)
+
+def test_files
+  Dir.glob(TEST_ROOT + "/**/*_test.rb")
+end
+
+if ARGV.empty?
+  test_files.each { |f| require(f) }
+  exit 0
+end
+
+# A list of files is presumed to be specified
+ARGV.each do |a|
+  require a.sub(%r{^test/}, '')
+end

data/clag.gemspec

@@ -0,0 +1,27 @@
+require_relative "lib/clag/version"
+
+Gem::Specification.new do |spec|
+  spec.name        = 'clag'
+  spec.version     = Clag::VERSION
+  spec.authors     = ['Scott Werner']
+  spec.email       = ['scott@sublayer.com']
+  spec.homepage    = 'https://github.com/sublayerapp/clag'
+  spec.summary     = 'Generate command line commands in your terminal using an LLM'
+  spec.description = 'Clag is a command line tool that generates command line commands right in your terminal and puts it into your clipboard for you to paste into your terminal.'
+  spec.license     = 'MIT'
+
+  spec.files       = `git ls-files`.split("\n")
+  spec.bindir      = 'exe'
+  spec.executables << 'clag'
+  spec.require_paths = ['lib']
+
+  spec.required_ruby_version = '>= 3'
+
+  spec.add_dependency 'cli-kit', '~> 5'
+  spec.add_dependency 'cli-ui', '~> 2.2.3'
+  spec.add_dependency 'ruby-openai', '~> 6'
+  spec.add_dependency 'clipboard', '~> 1.3'
+  spec.add_dependency 'activesupport'
+
+  spec.add_development_dependency 'rake', '~> 10.0'
+end

data/dev.yml

@@ -0,0 +1,3 @@
+up:
+  - ruby: 2.5.0
+  - bundler

data/exe/clag

@@ -0,0 +1,19 @@
+#!/usr/bin/env ruby
+
+Encoding.default_external = Encoding::UTF_8
+Encoding.default_internal = Encoding::UTF_8
+
+unshift_path = ->(path) {
+  p = File.expand_path("../../#{path}", __FILE__)
+  $LOAD_PATH.unshift(p) unless $LOAD_PATH.include?(p)
+}
+unshift_path.call('lib')
+require 'bundler/setup'
+
+unshift_path.call('vendor/gems/sublayer/lib')
+
+require 'clag'
+
+exit(Clag::ErrorHandler.call do
+  Clag::EntryPoint.call(ARGV.dup)
+end)

data/lib/clag/commands/generate.rb

@@ -0,0 +1,36 @@
+require 'clag'
+require "clipboard"
+
+module Clag
+  module Commands
+    class Generate < Clag::Command
+      def call(args, _name)
+        input = args.join(" ")
+
+        if ENV['OPENAI_API_KEY'].nil?
+          puts CLI::UI.fmt("{{red:OPENAI_API_KEY is not set. Please set it before continuing.}}")
+          return
+        end
+
+        if input.nil?
+          puts "Please provide input to generate options."
+          return
+        end
+
+        results = Sublayer::Agents::GenerateCommandLineCommandAgent.new(description: input).execute
+
+        if results == 'unknown'
+          puts CLI::UI.fmt("{{yellow:Unable to generate command. Please try again or provide more information.}}")
+          return
+        end
+
+        Clipboard.copy(results)
+        puts "\e[1;32m#{results}\e[0m\nCopied to clipboard."
+      end
+
+      def self.help
+        "Generate a command-line command and store it in the clipboard. \nUsage: {{command:#{Clag::TOOL_NAME} g \"the command you want to generate\"}}"
+      end
+    end
+  end
+end

data/lib/clag/commands/help.rb

@@ -0,0 +1,23 @@
+require 'clag'
+
+module Clag
+  module Commands
+    class Help < Clag::Command
+      def call(args, _name)
+        puts CLI::UI.fmt("{{bold:Available commands}}")
+        puts ""
+
+        Clag::Commands::Registry.resolved_commands.each do |name, klass|
+          next if name == "help"
+          puts CLI::UI.fmt("{{command:#{Clag::TOOL_NAME} #{name}}}")
+
+          if help = klass.help
+            puts CLI::UI.fmt(help)
+          end
+
+          puts ""
+        end
+      end
+    end
+  end
+end

data/lib/clag/commands.rb

@@ -0,0 +1,15 @@
+require 'clag'
+
+module Clag
+  module Commands
+    Registry = CLI::Kit::CommandRegistry.new(default: 'help')
+
+    def self.register(const, cmd, path)
+      autoload(const, path)
+      Registry.add(->() { const_get(const) }, cmd)
+    end
+
+    register :Generate, 'g', 'clag/commands/generate'
+    register :Help, 'help', 'clag/commands/help'
+  end
+end

data/lib/clag/entry_point.rb

@@ -0,0 +1,11 @@
+require 'clag'
+
+module Clag
+  module EntryPoint
+    def self.call(args)
+      cmd, command_name, args = Clag::Resolver.call(args)
+
+      Clag::Executor.call(cmd, command_name, args)
+    end
+  end
+end

data/lib/clag/version.rb

@@ -0,0 +1,3 @@
+module Clag
+  VERSION = '0.0.1'
+end

data/lib/clag.rb

@@ -0,0 +1,26 @@
+require 'cli/ui'
+require 'cli/kit'
+require "sublayer"
+
+CLI::UI::StdoutRouter.enable
+
+module Clag
+  TOOL_NAME = 'clag'
+  ROOT      = File.expand_path('../..', __FILE__)
+  LOG_FILE  = '/tmp/clag.log'
+
+  autoload(:EntryPoint, 'clag/entry_point')
+  autoload(:Commands,   'clag/commands')
+
+
+  Config = CLI::Kit::Config.new(tool_name: TOOL_NAME)
+  Command = CLI::Kit::BaseCommand
+
+  Executor = CLI::Kit::Executor.new(log_file: LOG_FILE)
+  Resolver = CLI::Kit::Resolver.new(
+    tool_name: TOOL_NAME,
+    command_registry: Clag::Commands::Registry
+  )
+
+  ErrorHandler = CLI::Kit::ErrorHandler.new(log_file: LOG_FILE)
+end

data/test/example_test.rb

@@ -0,0 +1,17 @@
+require 'test_helper'
+
+module Clag
+  class ExampleTest < Minitest::Test
+    include CLI::Kit::Support::TestHelper
+
+    def test_example
+      CLI::Kit::System.fake("ls -al", stdout: "a\nb", success: true)
+
+      out, = CLI::Kit::System.capture2('ls', '-al')
+      assert_equal %w(a b), out.split("\n")
+
+      errors = assert_all_commands_run(should_raise: false)
+      assert_nil errors, "expected command to run successfully"
+    end
+  end
+end

data/test/test_helper.rb

@@ -0,0 +1,22 @@
+begin
+  addpath = lambda do |p|
+    path = File.expand_path("../../#{p}", __FILE__)
+    $LOAD_PATH.unshift(path) unless $LOAD_PATH.include?(path)
+  end
+  addpath.call("lib")
+end
+
+require 'cli/kit'
+
+require 'fileutils'
+require 'tmpdir'
+require 'tempfile'
+
+require 'rubygems'
+require 'bundler/setup'
+
+CLI::UI::StdoutRouter.enable
+
+require 'minitest/autorun'
+require "minitest/unit"
+require 'mocha/minitest'

data/vendor/gems/sublayer/.gitignore

@@ -0,0 +1,16 @@
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+
+/.sublayer/
+
+.rspec_status
+.idea/
+
+*.log
+*.gem

data/vendor/gems/sublayer/Gemfile

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+source "https://rubygems.org"
+
+# Specify your gem's dependencies in sublayer_ruby.gemspec
+gemspec

data/vendor/gems/sublayer/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 Sublayer
+
+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/vendor/gems/sublayer/README.md

@@ -0,0 +1,52 @@
+# Sublayer
+
+An AI agent framework
+
+## Installation
+
+Install the gem by running the following commands:
+
+    $ bundle
+    $ gem build sublayer.gemspec
+    $ gem install sublayer-0.0.1.gem
+
+Your OpenAI API key needs to be accessible in your environment at OPENAI\_API\_KEY
+
+Your default editor for your environment is also used.
+
+## Usage
+
+### * Interactive CLI
+
+You can use the gem by running the command `sublayer` in any project directory.
+This will open an interactive shell where all file operations are run relative
+to that root project directory.
+
+In the interactive shell, you're able to create new agents specific to your
+project, generate code, modify existing files, and save the resulting code from
+those agent commands.
+
+### * Simple TDD Pair (experimental / dangerous)
+
+**Warning:** This will generate code from GPT4 and run it as called from your
+tests. Use at your own risk.
+
+Usage: `sublayer_simple_tdd_pair "TEST_RUN_COMMAND" "FILE_UNDER_TEST"`
+
+This command will run the TEST_RUN_COMMAND, send the test output, the tests, and
+the FILE\_UNDER\_TEST to GPT4 and will attempt to edit FILE\_UNDER\_TEST and
+rerun the tests until they pass.
+
+To do use it like in [this
+loom](https://www.loom.com/share/6970b51856b04a91b792f14e848e9b6d) you'll need
+to install entr: `brew install entr`
+
+The command I'm running there is: `ls ./day3/*.rb | entr sublayer_simple_tdd_pair "rspec ./day3/santa_spec.rb" "./day3/santa.rb"`
+
+## Development
+
+TBD
+
+## Contributing
+
+TBD

data/vendor/gems/sublayer/Rakefile

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

data/vendor/gems/sublayer/lib/sublayer/agents/generate_code_given_description_agent.rb

@@ -0,0 +1,35 @@
+module Sublayer
+  module Agents
+    class GenerateCodeGivenDescriptionAgent
+      include Sublayer::Capabilities::LLMAssistance
+      include Sublayer::Capabilities::HumanAssistance
+
+      attr_reader :description, :technologies, :results
+
+      llm_result_format type: :single_string,
+        name: "generated_code",
+        description: "The generated code in the requested language"
+
+      def initialize(description:, technologies:)
+        @description = description
+        @technologies = technologies
+      end
+
+      def execute
+        @results = human_assistance_with(llm_generate)
+      end
+
+      def prompt
+        <<-PROMPT
+        You are an expert programmer in #{technologies.join(", ")}.
+
+        You are tasked with writing code using the following technologies: #{technologies.join(", ")}.
+
+        The description of the task is #{description}
+
+        Take a deep breath and think step by step before you start coding.
+        PROMPT
+      end
+    end
+  end
+end

data/vendor/gems/sublayer/lib/sublayer/agents/generate_command_agent.rb

@@ -0,0 +1,37 @@
+module Sublayer
+  module Agents
+    class GenerateCommandLineCommandAgent
+      include Sublayer::Capabilities::LLMAssistance
+      include Sublayer::Capabilities::HumanAssistance
+
+      attr_reader :description, :results
+
+      llm_result_format type: :single_string,
+        name: "command",
+        description: "The command line command for the user to run or 'unknown'"
+
+      def initialize(description:)
+        @description = description
+      end
+
+      def execute
+        @results = llm_generate
+      end
+
+      def prompt
+        <<-PROMPT
+        You are an expert in command line operations.
+
+        You are tasked with finding or crafting a command line command to achieve the following:
+
+        #{description}
+
+        Considering best practices, what should be run on the command line to achieve this.
+
+        If no command is possible, respond with 'unknown'
+
+        PROMPT
+      end
+    end
+  end
+end

data/vendor/gems/sublayer/lib/sublayer/agents/json_fixing_agent.rb

@@ -0,0 +1,32 @@
+module Sublayer
+  module Agents
+    class JSONFixingAgent
+      include Sublayer::Capabilities::LLMAssistance
+      include Sublayer::Capabilities::HumanAssistance
+
+      attr_reader :invalid_json, :results
+
+      llm_result_format type: :single_string,
+        name: "valid_json",
+        description: "The valid JSON string"
+
+      def initialize(invalid_json:)
+        @invalid_json = invalid_json
+      end
+
+      def execute
+        @results = llm_generate
+      end
+
+      def prompt
+        <<-PROMPT
+        You are an expert in JSON parsing.
+
+        The given string is not a valid JSON: #{invalid_json}
+
+        Please fix this and produce a valid JSON.
+        PROMPT
+      end
+    end
+  end
+end

data/vendor/gems/sublayer/lib/sublayer/agents/modify_file_contents_agent.rb

@@ -0,0 +1,38 @@
+module Sublayer
+  module Agents
+    class ModifyFileContentsAgent
+      include Sublayer::Capabilities::LLMAssistance
+      include Sublayer::Capabilities::HumanAssistance
+
+      attr_reader :file_path, :description, :technologies, :results
+
+      llm_result_format type: :single_string,
+        name: "modified_file_contents",
+        description: "The modified file contents"
+
+      def initialize(file_path:, description:, technologies:)
+        @file_path = file_path
+        @description = description
+        @technologies = technologies
+      end
+
+      def execute
+        @results = human_assistance_with(llm_generate)
+      end
+
+      def prompt
+        <<-PROMPT
+        You are an expert programmer in #{technologies.join(", ")}.
+
+        Here are the original file contents:
+
+        #{File.read(@file_path)}
+
+        The description of the changes to make is: #{description}
+
+        Please make the necessary changes to this file.
+        PROMPT
+      end
+    end
+  end
+end

data/vendor/gems/sublayer/lib/sublayer/agents/save_file_contents_agent.rb

@@ -0,0 +1,18 @@
+module Sublayer
+  module Agents
+    class SaveFileContentsAgent
+      attr_reader :file_contents, :file_path
+
+      def initialize(file_contents:, file_path:)
+        @file_contents = file_contents
+        @file_path = file_path
+      end
+
+      def execute
+        File.open(file_path, "w") do |file|
+          file.write(file_contents)
+        end
+      end
+    end
+  end
+end

data/vendor/gems/sublayer/lib/sublayer/capabilities/human_assistance.rb

@@ -0,0 +1,23 @@
+require "tempfile"
+
+module Sublayer
+  module Capabilities
+    module HumanAssistance
+      def human_assistance_with(string_to_assist_with)
+        tempfile = Tempfile.new("some_tempfile_to_assist_with")
+        tempfile.write(string_to_assist_with)
+        tempfile.close
+
+        system("$EDITOR #{tempfile.path}")
+
+        tempfile.open
+        results = tempfile.read
+
+        tempfile.close
+        tempfile.unlink
+
+        results.chomp
+      end
+    end
+  end
+end

data/vendor/gems/sublayer/lib/sublayer/capabilities/llm_assistance.rb

@@ -0,0 +1,45 @@
+require "openai"
+
+module Sublayer
+  module Capabilities
+    module LLMAssistance
+      def self.included(base)
+        base.extend(ClassMethods)
+      end
+
+      module ClassMethods
+        def llm_result_format(type:, name:, description:)
+          output_function = Sublayer::Components::OutputFunction.create(type: type, name: name, description: description)
+          const_set(:OUTPUT_FUNCTION, output_function)
+        end
+      end
+
+      def llm_generate
+        client = OpenAI::Client.new(access_token: ENV["OPENAI_API_KEY"])
+
+        response = client.chat(
+          parameters: {
+            model: "gpt-4-turbo-preview",
+            messages: [
+              {
+                "role": "user",
+                "content": prompt
+              }
+            ],
+            function_call: { name: self.class::OUTPUT_FUNCTION.name },
+            functions: [
+              self.class::OUTPUT_FUNCTION.to_hash
+            ]
+          }
+        )
+
+        message = response.dig("choices", 0, "message")
+        raise "No function called" unless message["function_call"]
+
+        function_name = message.dig("function_call", self.class::OUTPUT_FUNCTION.name)
+        args_from_llm = message.dig("function_call", "arguments")
+        JSON.parse(args_from_llm)[self.class::OUTPUT_FUNCTION.name]
+      end
+    end
+  end
+end

data/vendor/gems/sublayer/lib/sublayer/components/output_function.rb

@@ -0,0 +1,23 @@
+module Sublayer
+  module Components
+    class OutputFunction
+      include Sublayer::Components
+
+      attr_reader :name
+
+      def self.create(options)
+        ("Sublayer::Components::"+options[:type].to_s.camelize).constantize.new(options)
+      end
+
+      def to_hash
+        # Raise not implemented error
+        raise NotImplementedError
+      end
+
+      private
+
+      def list_of_objects_hash
+      end
+    end
+  end
+end

data/vendor/gems/sublayer/lib/sublayer/components/output_function_formats/list_of_objects.rb

@@ -0,0 +1,30 @@
+module Sublayer
+  module Components
+    class ListOfObjects < OutputFunction
+      def initialize(options)
+        @name = options[:name]
+        @description = options[:description]
+        @structure = options[:structure]
+      end
+
+      def to_hash
+        {
+          name: @name,
+          description: @description,
+          parameters: {
+            type: "object",
+            properties: {
+              @name.to_sym => {
+                type: "array",
+                items: {
+                  type: "object",
+                  properties: @structure.transform_values { |desc| { type: "string", description: desc.capitalize } }
+                }
+              }
+            }
+          }
+        }
+      end
+    end
+  end
+end

data/vendor/gems/sublayer/lib/sublayer/components/output_function_formats/single_string.rb

@@ -0,0 +1,26 @@
+module Sublayer
+  module Components
+    class SingleString < OutputFunction
+      def initialize(options)
+        @name = options[:name]
+        @description = options[:description]
+      end
+
+      def to_hash
+        {
+          name: @name,
+          description: @description,
+          parameters: {
+            type: "object",
+            properties: {
+              @name => {
+                type: "string",
+                description: @description
+              }
+            }
+          }
+        }
+      end
+    end
+  end
+end

data/vendor/gems/sublayer/lib/sublayer/enhancements/json.rb

@@ -0,0 +1,9 @@
+module JSON
+  class << self
+    alias_method :original_parse, :parse
+
+    def parse(json, options = {})
+      original_parse(json, options).with_indifferent_access
+    end
+  end
+end

data/vendor/gems/sublayer/lib/sublayer/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Sublayer
+  VERSION = "0.0.1"
+end

data/vendor/gems/sublayer/lib/sublayer.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+require 'active_support'
+require 'active_support/core_ext/hash/indifferent_access'
+require 'active_support/inflector'
+require_relative "sublayer/version"
+
+if !File.directory?(File.join(Dir.pwd, ".sublayer", "agents"))
+  Dir.mkdir(File.join(Dir.pwd, ".sublayer"))
+  Dir.mkdir(File.join(Dir.pwd, ".sublayer", "agents"))
+end
+
+# List of directories to load files from
+LOAD_PATHS = [
+  File.join(__dir__, 'sublayer', 'components'),
+  File.join(__dir__, 'sublayer', 'components', 'output_function_formats'),
+  File.join(__dir__, 'sublayer', 'capabilities'),
+  File.join(__dir__, 'sublayer', 'agents'),
+  File.join(Dir.pwd, '.sublayer', 'agents')
+]
+
+
+# Load files from each directory in the list
+LOAD_PATHS.each do |load_path|
+  Dir.glob(File.join(load_path, '*.rb')).each do |file|
+    require_relative file
+  end
+end
+
+require_relative "sublayer/enhancements/json.rb"
+
+module Sublayer
+  class Error < StandardError; end
+
+  # Defines a method to reload all the agents
+  def self.reload_agents
+    LOAD_PATHS.each do |load_path|
+      Dir.glob(File.join(load_path, '*.rb')) do |file|
+        load file
+      end
+    end
+  end
+
+  def self.cwd
+    Dir.pwd
+  end
+end

data/vendor/gems/sublayer/spec/components/output_function_spec.rb

@@ -0,0 +1,73 @@
+require "spec_helper"
+
+RSpec.describe Sublayer::Components::OutputFunction do
+  describe "#to_hash" do
+    context "type: :single_string" do
+      it "formats the hash output correctly" do
+        output_function = Sublayer::Components::OutputFunction.create(type: :single_string, name: "modified_file_contents", description: "The modified file contents")
+        expect(output_function.to_hash).to eq(
+          {
+            name: "modified_file_contents",
+            description: "The modified file contents",
+            parameters: {
+              type: "object",
+              properties: {
+                "modified_file_contents" => {
+                  type: "string",
+                  description: "The modified file contents"
+                }
+              }
+            }
+          }
+        )
+      end
+    end
+
+    context "type: :list_of_objects" do
+      it "formats the hash output correctly" do
+        output_function = Sublayer::Components::OutputFunction.create(
+          type: :list_of_objects,
+          name: "retrieved_steps",
+          description: "The retrieved steps for performing the given coding task",
+          structure: {
+            category: "The category of the step",
+            command: "The command to run on the command line",
+            description: "The description of what the command is for"
+          }
+        )
+
+        expect(output_function.to_hash).to eq(
+          {
+            name: "retrieved_steps",
+            description: "The retrieved steps for performing the given coding task",
+            parameters: {
+              type: "object",
+              properties: {
+                retrieved_steps: {
+                  type: "array",
+                  items: {
+                    type: "object",
+                    properties: {
+                      category: {
+                        type: "string",
+                        description: "The category of the step"
+                      },
+                      command: {
+                        type: "string",
+                        description: "The command to run on the command line"
+                      },
+                      description: {
+                        type: "string",
+                        description: "The description of what the command is for"
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          }
+        )
+      end
+    end
+  end
+end

data/vendor/gems/sublayer/spec/spec_helper.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+require "sublayer"
+
+RSpec.configure do |config|
+  # Enable flags like --only-failures and --next-failure
+  config.example_status_persistence_file_path = ".rspec_status"
+
+  # Disable RSpec exposing methods globally on `Module` and `main`
+  config.disable_monkey_patching!
+
+  config.expect_with :rspec do |c|
+    c.syntax = :expect
+  end
+end

data/vendor/gems/sublayer/sublayer.gemspec

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+require_relative "lib/sublayer/version"
+
+Gem::Specification.new do |spec|
+  spec.name = "sublayer"
+  spec.version = Sublayer::VERSION
+  spec.authors = ["Scott Werner"]
+  spec.email = ["scott@sublayer.com"]
+  spec.license = "MIT"
+
+  spec.summary = "A ruby library for interacting with and orchestrating AI agents"
+  spec.description = "A command line framework for building, generating, and orchestrating AI agents."
+  spec.homepage = "https://www.sublayer.com"
+  spec.required_ruby_version = ">= 2.6.0"
+
+  spec.metadata["homepage_uri"] = spec.homepage
+
+  # Specify which files should be added to the gem when it is released.
+  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
+  spec.files = Dir.chdir(__dir__) do
+    `git ls-files -z`.split("\x0").reject do |f|
+      (File.expand_path(f) == __FILE__) ||
+        f.start_with?(*%w[bin/ test/ spec/ features/ .git .circleci appveyor Gemfile])
+    end
+  end
+
+  spec.executables << "sublayer"
+  spec.executables << "sublayer_simple_tdd_pair"
+  spec.require_paths = ["lib"]
+
+  spec.add_dependency "ruby-openai"
+  spec.add_dependency "colorize"
+  spec.add_dependency "activesupport"
+
+  spec.add_development_dependency "rspec", "~> 3.12"
+  spec.add_development_dependency "pry", " ~> 0.14"
+end

metadata

@@ -0,0 +1,165 @@
+--- !ruby/object:Gem::Specification
+name: clag
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Scott Werner
+autorequire:
+bindir: exe
+cert_chain: []
+date: 2024-01-26 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: cli-kit
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5'
+- !ruby/object:Gem::Dependency
+  name: cli-ui
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.2.3
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.2.3
+- !ruby/object:Gem::Dependency
+  name: ruby-openai
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6'
+- !ruby/object:Gem::Dependency
+  name: clipboard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+description: Clag is a command line tool that generates command line commands right
+  in your terminal and puts it into your clipboard for you to paste into your terminal.
+email:
+- scott@sublayer.com
+executables:
+- clag
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- Gemfile
+- README.md
+- bin/testunit
+- clag.gemspec
+- dev.yml
+- exe/clag
+- lib/clag.rb
+- lib/clag/commands.rb
+- lib/clag/commands/generate.rb
+- lib/clag/commands/help.rb
+- lib/clag/entry_point.rb
+- lib/clag/version.rb
+- test/example_test.rb
+- test/test_helper.rb
+- vendor/gems/sublayer/.gitignore
+- vendor/gems/sublayer/Gemfile
+- vendor/gems/sublayer/LICENSE
+- vendor/gems/sublayer/README.md
+- vendor/gems/sublayer/Rakefile
+- vendor/gems/sublayer/lib/sublayer.rb
+- vendor/gems/sublayer/lib/sublayer/agents/generate_code_given_description_agent.rb
+- vendor/gems/sublayer/lib/sublayer/agents/generate_command_agent.rb
+- vendor/gems/sublayer/lib/sublayer/agents/json_fixing_agent.rb
+- vendor/gems/sublayer/lib/sublayer/agents/modify_file_contents_agent.rb
+- vendor/gems/sublayer/lib/sublayer/agents/save_file_contents_agent.rb
+- vendor/gems/sublayer/lib/sublayer/capabilities/human_assistance.rb
+- vendor/gems/sublayer/lib/sublayer/capabilities/llm_assistance.rb
+- vendor/gems/sublayer/lib/sublayer/components/output_function.rb
+- vendor/gems/sublayer/lib/sublayer/components/output_function_formats/list_of_objects.rb
+- vendor/gems/sublayer/lib/sublayer/components/output_function_formats/single_string.rb
+- vendor/gems/sublayer/lib/sublayer/enhancements/json.rb
+- vendor/gems/sublayer/lib/sublayer/version.rb
+- vendor/gems/sublayer/spec/components/output_function_spec.rb
+- vendor/gems/sublayer/spec/spec_helper.rb
+- vendor/gems/sublayer/sublayer.gemspec
+homepage: https://github.com/sublayerapp/clag
+licenses:
+- MIT
+metadata: {}
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.3.26
+signing_key:
+specification_version: 4
+summary: Generate command line commands in your terminal using an LLM
+test_files: []