roast-ai 0.3.1 → 0.4.0

data/lib/roast/workflow/step_type_resolver.rb

@@ -10,10 +10,12 @@ module Roast
       ITERATION_STEP = :iteration
       CONDITIONAL_STEP = :conditional
       CASE_STEP = :case
+      INPUT_STEP = :input
       HASH_STEP = :hash
       PARALLEL_STEP = :parallel
       STRING_STEP = :string
       STANDARD_STEP = :standard
+      AGENT_STEP = :agent
 
       # Special step names for iterations
       ITERATION_STEPS = ["repeat", "each"].freeze
@@ -24,6 +26,9 @@ module Roast
       # Special step name for case statements
       CASE_STEPS = ["case"].freeze
 
+      # Special step name for input steps
+      INPUT_STEPS = ["input"].freeze
+
       class << self
         # Resolve the type of a step
         # @param step [String, Hash, Array] The step to analyze
@@ -49,6 +54,13 @@ module Roast
           step.is_a?(String) && step.start_with?("$(")
         end
 
+        # Check if a step is an agent step
+        # @param step [String] The step to check
+        # @return [Boolean] true if it's an agent step
+        def agent_step?(step)
+          step.is_a?(String) && step.start_with?("^")
+        end
+
         # Check if a step is a glob pattern
         # @param step [String] The step to check
         # @param context [WorkflowContext, nil] The workflow context
@@ -90,13 +102,24 @@ module Roast
           CASE_STEPS.include?(step_name)
         end
 
+        # Check if a step is an input step
+        # @param step [Hash] The step to check
+        # @return [Boolean] true if it's an input step
+        def input_step?(step)
+          return false unless step.is_a?(Hash)
+
+          step_name = step.keys.first
+          INPUT_STEPS.include?(step_name)
+        end
+
         # Extract the step name from various step formats
         # @param step [String, Hash, Array] The step
         # @return [String, nil] The step name or nil
         def extract_name(step)
           case step
           when String
-            step
+            # Strip ^ prefix for agent steps
+            agent_step?(step) ? step[1..] : step
           when Hash
             step.keys.first
           when Array
@@ -109,6 +132,8 @@ module Roast
         def resolve_string_step(step, context)
           if command_step?(step)
             COMMAND_STEP
+          elsif agent_step?(step)
+            AGENT_STEP
           elsif glob_step?(step, context)
             GLOB_STEP
           else
@@ -123,6 +148,8 @@ module Roast
             CONDITIONAL_STEP
           elsif case_step?(step)
             CASE_STEP
+          elsif input_step?(step)
+            INPUT_STEP
           else
             HASH_STEP
           end

data/lib/roast/workflow/validator.rb

@@ -1,9 +1,5 @@
 # frozen_string_literal: true
 
-require "json-schema"
-require "json"
-require "yaml"
-
 module Roast
   module Workflow
     class Validator

data/lib/roast/workflow/workflow_executor.rb

@@ -1,21 +1,5 @@
 # frozen_string_literal: true
 
-require "English"
-
-require "roast/workflow/command_executor"
-require "roast/workflow/conditional_executor"
-require "roast/workflow/error_handler"
-require "roast/workflow/interpolator"
-require "roast/workflow/iteration_executor"
-require "roast/workflow/parallel_executor"
-require "roast/workflow/state_manager"
-require "roast/workflow/step_executor_factory"
-require "roast/workflow/step_executor_coordinator"
-require "roast/workflow/step_loader"
-require "roast/workflow/step_orchestrator"
-require "roast/workflow/step_type_resolver"
-require "roast/workflow/workflow_context"
-
 module Roast
   module Workflow
     # Handles the execution of workflow steps, including orchestration and threading

data/lib/roast/workflow/workflow_initializer.rb

@@ -1,12 +1,5 @@
 # frozen_string_literal: true
 
-require "raix"
-require "roast/initializers"
-require "roast/helpers/function_caching_interceptor"
-require "roast/helpers/logger"
-require "roast/workflow/base_workflow"
-require "roast/workflow/interpolator"
-
 module Roast
   module Workflow
     # Handles initialization of workflow dependencies: initializers, tools, and API clients
@@ -103,7 +96,7 @@ module Roast
         # Validate the client configuration by making a test API call
         validate_api_client(client) if client
       rescue OpenRouter::ConfigurationError, Faraday::UnauthorizedError => e
-        error = Roast::AuthenticationError.new("API authentication failed: No API token provided or token is invalid")
+        error = Roast::Errors::AuthenticationError.new("API authentication failed: No API token provided or token is invalid")
         error.set_backtrace(e.backtrace)
 
         ActiveSupport::Notifications.instrument("roast.workflow.start.error", {

data/lib/roast/workflow/workflow_runner.rb

@@ -1,12 +1,5 @@
 # frozen_string_literal: true
 
-require "erb"
-require "roast/workflow/replay_handler"
-require "roast/workflow/workflow_executor"
-require "roast/workflow/output_handler"
-require "roast/workflow/base_workflow"
-require "roast/workflow/dot_access_hash"
-
 module Roast
   module Workflow
     # Handles running workflows for files/targets and orchestrating execution

data/lib/roast/workflow.rb

@@ -1,20 +1,5 @@
 # frozen_string_literal: true
 
-require "roast/workflow/base_step"
-require "roast/workflow/prompt_step"
-require "roast/workflow/base_iteration_step"
-require "roast/workflow/repeat_step"
-require "roast/workflow/each_step"
-require "roast/workflow/base_workflow"
-require "roast/workflow/configuration"
-require "roast/workflow/workflow_execution_context"
-require "roast/workflow/workflow_executor"
-require "roast/workflow/configuration_parser"
-require "roast/workflow/validator"
-require "roast/workflow/state_repository"
-require "roast/workflow/session_manager"
-require "roast/workflow/file_state_repository"
-
 module Roast
   module Workflow
   end

data/lib/roast.rb

@@ -1,24 +1,43 @@
 # frozen_string_literal: true
 
+# Standard library requires
+require "digest"
+require "English"
+require "erb"
+require "fileutils"
+require "json"
+require "logger"
+require "net/http"
+require "open3"
+require "pathname"
+require "securerandom"
+require "tempfile"
+require "uri"
+require "yaml"
+
+# Third-party gem requires
 require "active_support"
 require "active_support/cache"
-require "active_support/notifications"
 require "active_support/core_ext/hash/indifferent_access"
+require "active_support/core_ext/module/delegation"
 require "active_support/core_ext/string"
 require "active_support/core_ext/string/inflections"
-require "active_support/core_ext/module/delegation"
 require "active_support/isolated_execution_state"
-require "fileutils"
+require "active_support/notifications"
 require "cli/ui"
+require "diff/lcs"
+require "json-schema"
 require "raix"
+require "raix/chat_completion"
+require "raix/function_dispatch"
 require "thor"
-require "roast/errors"
-require "roast/helpers"
-require "roast/initializers"
-require "roast/resources"
-require "roast/tools"
-require "roast/version"
-require "roast/workflow"
+
+# Autoloading setup
+require "zeitwerk"
+
+# Set up Zeitwerk autoloader
+loader = Zeitwerk::Loader.for_gem
+loader.setup
 
 module Roast
   ROOT = File.expand_path("../..", __FILE__)
@@ -63,6 +82,32 @@ module Roast
       end
     end
 
+    desc "list", "List workflows visible to Roast and their source"
+    def list
+      roast_dir = File.join(Dir.pwd, "roast")
+
+      unless File.directory?(roast_dir)
+        raise Thor::Error, "No roast/ directory found in current path"
+      end
+
+      workflow_files = Dir.glob(File.join(roast_dir, "**/workflow.yml")).sort
+
+      if workflow_files.empty?
+        raise Thor::Error, "No workflow.yml files found in roast/ directory"
+      end
+
+      puts "Available workflows:"
+      puts
+
+      workflow_files.each do |file|
+        workflow_name = File.dirname(file.sub("#{roast_dir}/", ""))
+        puts "  #{workflow_name} (from project)"
+      end
+
+      puts
+      puts "Run a workflow with: roast execute <workflow_name>"
+    end
+
     private
 
     def show_example_picker

data/roast.gemspec

@@ -37,11 +37,12 @@ Gem::Specification.new do |spec|
   spec.require_paths = ["lib"]
 
   spec.add_dependency("activesupport", ">= 7.0")
-  spec.add_dependency("cli-ui")
+  spec.add_dependency("cli-ui", "2.3.0")
   spec.add_dependency("diff-lcs", "~> 1.5")
   spec.add_dependency("faraday-retry")
   spec.add_dependency("json-schema")
   spec.add_dependency("open_router", "~> 0.3")
   spec.add_dependency("raix", "~> 1.0")
   spec.add_dependency("thor", "~> 1.3")
+  spec.add_dependency("zeitwerk", "~> 2.6")
 end

data/schema/workflow.json

@@ -206,6 +206,52 @@
                 }
               },
               "required": ["case", "when"]
+            },
+            {
+              "type": "object",
+              "properties": {
+                "input": {
+                  "type": "object",
+                  "properties": {
+                    "prompt": {
+                      "type": "string",
+                      "description": "The prompt text to display to the user"
+                    },
+                    "name": {
+                      "type": "string",
+                      "description": "Optional name to store the input value in workflow state"
+                    },
+                    "type": {
+                      "type": "string",
+                      "enum": ["text", "boolean", "choice", "password"],
+                      "default": "text",
+                      "description": "The type of input to collect"
+                    },
+                    "required": {
+                      "type": "boolean",
+                      "default": false,
+                      "description": "Whether the input is required"
+                    },
+                    "default": {
+                      "description": "Default value for the input"
+                    },
+                    "timeout": {
+                      "type": "number",
+                      "description": "Optional timeout in seconds"
+                    },
+                    "options": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      },
+                      "description": "Options for choice type inputs"
+                    }
+                  },
+                  "required": ["prompt"],
+                  "additionalProperties": false
+                }
+              },
+              "required": ["input"]
             }
           ]
         }

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: roast-ai
 version: !ruby/object:Gem::Version
-  version: 0.3.1
+  version: 0.4.0
 platform: ruby
 authors:
 - Shopify
@@ -27,16 +27,16 @@ dependencies:
   name: cli-ui
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - '='
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 2.3.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - '='
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 2.3.0
 - !ruby/object:Gem::Dependency
   name: diff-lcs
   requirement: !ruby/object:Gem::Requirement
@@ -121,6 +121,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: zeitwerk
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.6'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.6'
 description: Roast is a Ruby library for running structured AI workflows along with
   many building blocks for creating and executing them
 email:
@@ -148,14 +162,26 @@ files:
 - Rakefile
 - bin/console
 - bin/roast
+- claude-swarm.yml
+- docs/AGENT_STEPS.md
 - docs/INSTRUMENTATION.md
 - docs/ITERATION_SYNTAX.md
+- examples/agent_workflow/README.md
+- examples/agent_workflow/apply_refactorings/prompt.md
+- examples/agent_workflow/identify_code_smells/prompt.md
+- examples/agent_workflow/summarize_improvements/prompt.md
+- examples/agent_workflow/workflow.yml
 - examples/api_workflow/README.md
 - examples/api_workflow/fetch_api_data/prompt.md
 - examples/api_workflow/generate_report/prompt.md
 - examples/api_workflow/prompt.md
 - examples/api_workflow/transform_data/prompt.md
 - examples/api_workflow/workflow.yml
+- examples/available_tools_demo/README.md
+- examples/available_tools_demo/analyze_files/prompt.md
+- examples/available_tools_demo/explore_directory/prompt.md
+- examples/available_tools_demo/workflow.yml
+- examples/available_tools_demo/write_summary/prompt.md
 - examples/bash_prototyping/README.md
 - examples/bash_prototyping/analyze_network/prompt.md
 - examples/bash_prototyping/analyze_system/prompt.md
@@ -300,6 +326,14 @@ files:
 - examples/tool_config_example/README.md
 - examples/tool_config_example/example_step/prompt.md
 - examples/tool_config_example/workflow.yml
+- examples/user_input/README.md
+- examples/user_input/funny_name/create_backstory/prompt.md
+- examples/user_input/funny_name/workflow.yml
+- examples/user_input/generate_summary/prompt.md
+- examples/user_input/simple_input_demo/workflow.yml
+- examples/user_input/survey_workflow.yml
+- examples/user_input/welcome_message/prompt.md
+- examples/user_input/workflow.yml
 - examples/workflow_generator/README.md
 - examples/workflow_generator/analyze_user_request/prompt.md
 - examples/workflow_generator/create_workflow_files/prompt.md
@@ -312,7 +346,6 @@ files:
 - lib/roast.rb
 - lib/roast/errors.rb
 - lib/roast/factories/api_provider_factory.rb
-- lib/roast/helpers.rb
 - lib/roast/helpers/function_caching_interceptor.rb
 - lib/roast/helpers/logger.rb
 - lib/roast/helpers/minitest_coverage_runner.rb
@@ -344,6 +377,7 @@ files:
 - lib/roast/value_objects/workflow_path.rb
 - lib/roast/version.rb
 - lib/roast/workflow.rb
+- lib/roast/workflow/agent_step.rb
 - lib/roast/workflow/api_configuration.rb
 - lib/roast/workflow/base_iteration_step.rb
 - lib/roast/workflow/base_step.rb
@@ -363,6 +397,8 @@ files:
 - lib/roast/workflow/expression_evaluator.rb
 - lib/roast/workflow/expression_utils.rb
 - lib/roast/workflow/file_state_repository.rb
+- lib/roast/workflow/input_executor.rb
+- lib/roast/workflow/input_step.rb
 - lib/roast/workflow/interpolator.rb
 - lib/roast/workflow/iteration_executor.rb
 - lib/roast/workflow/llm_boolean_coercer.rb
@@ -383,6 +419,7 @@ files:
 - lib/roast/workflow/step_executors/hash_step_executor.rb
 - lib/roast/workflow/step_executors/parallel_step_executor.rb
 - lib/roast/workflow/step_executors/string_step_executor.rb
+- lib/roast/workflow/step_factory.rb
 - lib/roast/workflow/step_finder.rb
 - lib/roast/workflow/step_loader.rb
 - lib/roast/workflow/step_orchestrator.rb

data/lib/roast/helpers.rb

@@ -1,12 +0,0 @@
-# frozen_string_literal: true
-
-require "roast/helpers/logger"
-require "roast/helpers/path_resolver"
-require "roast/helpers/prompt_loader"
-require "roast/helpers/minitest_coverage_runner"
-require "roast/helpers/function_caching_interceptor"
-
-module Roast
-  module Helpers
-  end
-end