roast-ai 0.4.10 → 0.5.0

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: roast-ai
 version: !ruby/object:Gem::Version
-  version: 0.4.10
+  version: 0.5.0
 platform: ruby
 authors:
 - Shopify
@@ -23,34 +23,62 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '7.0'
+- !ruby/object:Gem::Dependency
+  name: async
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.34'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.34'
+- !ruby/object:Gem::Dependency
+  name: benchmark
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.4.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.4.1
 - !ruby/object:Gem::Dependency
   name: cli-kit
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '5.0'
+        version: '5.2'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '5.0'
+        version: '5.2'
 - !ruby/object:Gem::Dependency
   name: cli-ui
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '='
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.3.0
+        version: '2.7'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '='
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.3.0
+        version: '2.7'
 - !ruby/object:Gem::Dependency
   name: diff-lcs
   requirement: !ruby/object:Gem::Requirement
@@ -107,6 +135,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: 1.0.2
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 13.3.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 13.3.0
 - !ruby/object:Gem::Dependency
   name: ruby-graphviz
   requirement: !ruby/object:Gem::Requirement
@@ -186,6 +228,7 @@ executables:
 extensions: []
 extra_rdoc_files: []
 files:
+- ".claude/commands/docs/write-comments.md"
 - ".claude/settings.json"
 - ".github/CODEOWNERS"
 - ".github/workflows/ci.yaml"
@@ -202,6 +245,7 @@ files:
 - Gemfile.lock
 - LICENSE.md
 - README.md
+- README_LEGACY.md
 - Rakefile
 - bin/console
 - bin/roast
@@ -211,15 +255,29 @@ files:
 - bin/srb-rbi
 - bin/tapioca
 - claude-swarm.yml
+- dev.yml
 - docs/AGENT_STEPS.md
 - docs/INSTRUMENTATION.md
 - docs/ITERATION_SYNTAX.md
 - docs/VALIDATION.md
+- dsl/agent_sessions.rb
+- dsl/async_cogs.rb
+- dsl/async_cogs_complex.rb
+- dsl/call.rb
+- dsl/collect_from.rb
 - dsl/demo/Gemfile
 - dsl/demo/Gemfile.lock
 - dsl/demo/cogs/local.rb
 - dsl/demo/simple_external_cog.rb
-- dsl/less_simple.rb
+- dsl/json_output.rb
+- dsl/map.rb
+- dsl/map_reduce.rb
+- dsl/map_with_index.rb
+- dsl/next_break.rb
+- dsl/next_break_parallel.rb
+- dsl/outputs.rb
+- dsl/outputs_bang.rb
+- dsl/parallel_map.rb
 - dsl/plugin-gem-example/.gitignore
 - dsl/plugin-gem-example/Gemfile
 - dsl/plugin-gem-example/Gemfile.lock
@@ -228,11 +286,48 @@ files:
 - dsl/plugin-gem-example/lib/simple.rb
 - dsl/plugin-gem-example/lib/version.rb
 - dsl/plugin-gem-example/plugin-gem-example.gemspec
+- dsl/prompts/simple_prompt.md.erb
 - dsl/prototype.rb
-- dsl/scoped_executors.rb
-- dsl/simple.rb
+- dsl/repeat_loop_results.rb
+- dsl/ruby_cog.rb
+- dsl/simple_agent.rb
 - dsl/simple_chat.rb
+- dsl/simple_repeat.rb
+- dsl/skip.rb
 - dsl/step_communication.rb
+- dsl/targets_and_params.rb
+- dsl/temperature.rb
+- dsl/temporary_directory.rb
+- dsl/tutorial/01_your_first_workflow/README.md
+- dsl/tutorial/01_your_first_workflow/configured_chat.rb
+- dsl/tutorial/01_your_first_workflow/hello.rb
+- dsl/tutorial/02_chaining_cogs/README.md
+- dsl/tutorial/02_chaining_cogs/code_review.rb
+- dsl/tutorial/02_chaining_cogs/session_resumption.rb
+- dsl/tutorial/02_chaining_cogs/simple_chain.rb
+- dsl/tutorial/03_targets_and_params/README.md
+- dsl/tutorial/03_targets_and_params/multiple_targets.rb
+- dsl/tutorial/03_targets_and_params/single_target.rb
+- dsl/tutorial/04_configuration_options/README.md
+- dsl/tutorial/04_configuration_options/control_display_and_temperature.rb
+- dsl/tutorial/04_configuration_options/simple_config.rb
+- dsl/tutorial/05_control_flow/README.md
+- dsl/tutorial/05_control_flow/conditional_execution.rb
+- dsl/tutorial/05_control_flow/handling_failures.rb
+- dsl/tutorial/06_reusable_scopes/README.md
+- dsl/tutorial/06_reusable_scopes/accessing_scope_outputs.rb
+- dsl/tutorial/06_reusable_scopes/basic_scope.rb
+- dsl/tutorial/06_reusable_scopes/parameterized_scope.rb
+- dsl/tutorial/07_processing_collections/README.md
+- dsl/tutorial/07_processing_collections/basic_map.rb
+- dsl/tutorial/07_processing_collections/parallel_map.rb
+- dsl/tutorial/08_iterative_workflows/README.md
+- dsl/tutorial/08_iterative_workflows/basic_repeat.rb
+- dsl/tutorial/08_iterative_workflows/conditional_break.rb
+- dsl/tutorial/09_async_cogs/README.md
+- dsl/tutorial/09_async_cogs/basic_async.rb
+- dsl/tutorial/README.md
+- dsl/working_directory.rb
 - examples/README.md
 - examples/available_tools_demo/README.md
 - examples/available_tools_demo/analyze_files/prompt.md
@@ -256,6 +351,11 @@ files:
 - exe/roast
 - gemfiles/activesupport7.gemfile
 - gemfiles/activesupport8.gemfile
+- internal/documentation/architectural-notes.md
+- internal/documentation/doc-comments-external.md
+- internal/documentation/doc-comments-internal.md
+- internal/documentation/doc-comments.md
+- lib/roast-ai.rb
 - lib/roast.rb
 - lib/roast/dsl.rb
 - lib/roast/dsl/cog.rb
@@ -267,15 +367,48 @@ files:
 - lib/roast/dsl/cog/store.rb
 - lib/roast/dsl/cog_input_context.rb
 - lib/roast/dsl/cog_input_manager.rb
+- lib/roast/dsl/cogs/agent.rb
+- lib/roast/dsl/cogs/agent/config.rb
+- lib/roast/dsl/cogs/agent/input.rb
+- lib/roast/dsl/cogs/agent/output.rb
+- lib/roast/dsl/cogs/agent/provider.rb
+- lib/roast/dsl/cogs/agent/providers/claude.rb
+- lib/roast/dsl/cogs/agent/providers/claude/claude_invocation.rb
+- lib/roast/dsl/cogs/agent/providers/claude/message.rb
+- lib/roast/dsl/cogs/agent/providers/claude/messages/assistant_message.rb
+- lib/roast/dsl/cogs/agent/providers/claude/messages/result_message.rb
+- lib/roast/dsl/cogs/agent/providers/claude/messages/system_message.rb
+- lib/roast/dsl/cogs/agent/providers/claude/messages/text_message.rb
+- lib/roast/dsl/cogs/agent/providers/claude/messages/tool_result_message.rb
+- lib/roast/dsl/cogs/agent/providers/claude/messages/tool_use_message.rb
+- lib/roast/dsl/cogs/agent/providers/claude/messages/unknown_message.rb
+- lib/roast/dsl/cogs/agent/providers/claude/messages/user_message.rb
+- lib/roast/dsl/cogs/agent/providers/claude/tool_result.rb
+- lib/roast/dsl/cogs/agent/providers/claude/tool_use.rb
+- lib/roast/dsl/cogs/agent/stats.rb
+- lib/roast/dsl/cogs/agent/usage.rb
 - lib/roast/dsl/cogs/chat.rb
+- lib/roast/dsl/cogs/chat/config.rb
+- lib/roast/dsl/cogs/chat/input.rb
+- lib/roast/dsl/cogs/chat/output.rb
+- lib/roast/dsl/cogs/chat/session.rb
 - lib/roast/dsl/cogs/cmd.rb
-- lib/roast/dsl/cogs/execute.rb
-- lib/roast/dsl/cogs/graph.rb
+- lib/roast/dsl/cogs/ruby.rb
+- lib/roast/dsl/command_runner.rb
 - lib/roast/dsl/config_context.rb
 - lib/roast/dsl/config_manager.rb
+- lib/roast/dsl/control_flow.rb
 - lib/roast/dsl/execution_context.rb
 - lib/roast/dsl/execution_manager.rb
+- lib/roast/dsl/nil_assertions.rb
+- lib/roast/dsl/system_cog.rb
+- lib/roast/dsl/system_cog/params.rb
+- lib/roast/dsl/system_cogs/call.rb
+- lib/roast/dsl/system_cogs/map.rb
+- lib/roast/dsl/system_cogs/repeat.rb
 - lib/roast/dsl/workflow.rb
+- lib/roast/dsl/workflow_context.rb
+- lib/roast/dsl/workflow_params.rb
 - lib/roast/error.rb
 - lib/roast/errors.rb
 - lib/roast/factories/api_provider_factory.rb
@@ -301,6 +434,7 @@ files:
 - lib/roast/resources/url_resource.rb
 - lib/roast/services/context_threshold_checker.rb
 - lib/roast/services/token_counting_service.rb
+- lib/roast/sorbet_runtime_stub.rb
 - lib/roast/tools.rb
 - lib/roast/tools/apply_diff.rb
 - lib/roast/tools/ask_user.rb
@@ -390,7 +524,7 @@ files:
 - lib/roast/workflow/workflow_initializer.rb
 - lib/roast/workflow/workflow_runner.rb
 - lib/roast/workflow_diagram_generator.rb
-- roast.gemspec
+- roast-ai.gemspec
 - rubocop/cop/roast.rb
 - rubocop/cop/roast/use_cmd_runner.rb
 - schema/workflow.json
@@ -409,42 +543,38 @@ files:
 - sorbet/rbi/gems/activesupport@8.0.2.rbi
 - sorbet/rbi/gems/addressable@2.8.7.rbi
 - sorbet/rbi/gems/ast@2.4.3.rbi
+- sorbet/rbi/gems/async@2.34.0.rbi
 - sorbet/rbi/gems/base64@0.3.0.rbi
 - sorbet/rbi/gems/benchmark@0.4.1.rbi
 - sorbet/rbi/gems/bigdecimal@3.2.2.rbi
-- sorbet/rbi/gems/cgi@0.5.0.rbi
-- sorbet/rbi/gems/claude_swarm@0.1.19.rbi
-- sorbet/rbi/gems/cli-kit@5.0.1.rbi
-- sorbet/rbi/gems/cli-ui@2.3.0.rbi
+- sorbet/rbi/gems/cli-kit@5.2.0.rbi
+- sorbet/rbi/gems/cli-ui@2.7.0-6bdefd1d06305e5d6ae312ac76f9c88f88658dda.rbi
 - sorbet/rbi/gems/coderay@1.1.3.rbi
 - sorbet/rbi/gems/concurrent-ruby@1.3.5.rbi
 - sorbet/rbi/gems/connection_pool@2.5.3.rbi
+- sorbet/rbi/gems/console@1.34.2.rbi
 - sorbet/rbi/gems/crack@1.0.0.rbi
 - sorbet/rbi/gems/diff-lcs@1.6.2.rbi
 - sorbet/rbi/gems/docile@1.4.1.rbi
 - sorbet/rbi/gems/dotenv@3.1.8.rbi
 - sorbet/rbi/gems/drb@2.2.3.rbi
-- sorbet/rbi/gems/dry-configurable@1.3.0.rbi
-- sorbet/rbi/gems/dry-core@1.1.0.rbi
-- sorbet/rbi/gems/dry-inflector@1.2.0.rbi
-- sorbet/rbi/gems/dry-initializer@3.2.0.rbi
-- sorbet/rbi/gems/dry-logic@1.6.0.rbi
-- sorbet/rbi/gems/dry-schema@1.14.1.rbi
-- sorbet/rbi/gems/dry-types@1.8.3.rbi
 - sorbet/rbi/gems/erubi@1.13.1.rbi
 - sorbet/rbi/gems/event_stream_parser@1.0.0.rbi
 - sorbet/rbi/gems/faraday-multipart@1.1.1.rbi
 - sorbet/rbi/gems/faraday-net_http@3.4.1.rbi
 - sorbet/rbi/gems/faraday-retry@2.3.2.rbi
 - sorbet/rbi/gems/faraday@2.13.1.rbi
-- sorbet/rbi/gems/fast-mcp-annotations@1.5.3.rbi
 - sorbet/rbi/gems/ffi@1.17.2.rbi
+- sorbet/rbi/gems/fiber-annotation@0.2.0.rbi
+- sorbet/rbi/gems/fiber-local@1.1.0.rbi
+- sorbet/rbi/gems/fiber-storage@1.0.1.rbi
 - sorbet/rbi/gems/formatador@1.1.0.rbi
 - sorbet/rbi/gems/guard-compat@1.2.1.rbi
 - sorbet/rbi/gems/guard-minitest@2.4.6.rbi
 - sorbet/rbi/gems/guard@2.19.1.rbi
 - sorbet/rbi/gems/hashdiff@1.2.0.rbi
 - sorbet/rbi/gems/i18n@1.14.7.rbi
+- sorbet/rbi/gems/io-event@1.14.0.rbi
 - sorbet/rbi/gems/json-schema@5.1.1.rbi
 - sorbet/rbi/gems/json@2.12.2.rbi
 - sorbet/rbi/gems/language_server-protocol@3.17.0.5.rbi
@@ -454,8 +584,7 @@ files:
 - sorbet/rbi/gems/lumberjack@1.2.10.rbi
 - sorbet/rbi/gems/marcel@1.1.0.rbi
 - sorbet/rbi/gems/method_source@1.1.0.rbi
-- sorbet/rbi/gems/mime-types-data@3.2025.0617.rbi
-- sorbet/rbi/gems/mime-types@3.7.0.rbi
+- sorbet/rbi/gems/metrics@0.15.0.rbi
 - sorbet/rbi/gems/minitest-rg@5.3.0.rbi
 - sorbet/rbi/gems/minitest@5.25.5.rbi
 - sorbet/rbi/gems/mocha@2.7.1.rbi
@@ -472,7 +601,6 @@ files:
 - sorbet/rbi/gems/pry@0.15.2.rbi
 - sorbet/rbi/gems/public_suffix@6.0.2.rbi
 - sorbet/rbi/gems/racc@1.8.1.rbi
-- sorbet/rbi/gems/rack@2.2.19.rbi
 - sorbet/rbi/gems/rainbow@3.1.1.rbi
 - sorbet/rbi/gems/raix@1.0.2.rbi
 - sorbet/rbi/gems/rake@13.3.0.rbi
@@ -500,14 +628,13 @@ files:
 - sorbet/rbi/gems/sqlite3@2.7.0.rbi
 - sorbet/rbi/gems/tapioca@0.16.11.rbi
 - sorbet/rbi/gems/thor@1.4.0.rbi
+- sorbet/rbi/gems/traces@0.18.2.rbi
 - sorbet/rbi/gems/tzinfo@2.0.6.rbi
 - sorbet/rbi/gems/unicode-display_width@3.1.4.rbi
 - sorbet/rbi/gems/unicode-emoji@4.0.4.rbi
 - sorbet/rbi/gems/uri@1.0.3.rbi
 - sorbet/rbi/gems/vcr@6.3.1.rbi
 - sorbet/rbi/gems/webmock@3.25.1.rbi
-- sorbet/rbi/gems/yard-sorbet@0.9.0.rbi
-- sorbet/rbi/gems/yard@0.9.37.rbi
 - sorbet/rbi/gems/zeitwerk@2.7.3.rbi
 - sorbet/rbi/shims/lib/roast/dsl/cog_input_context.rbi
 - sorbet/rbi/shims/lib/roast/dsl/config_context.rbi

data/dsl/less_simple.rb

@@ -1,112 +0,0 @@
-# typed: false
-# frozen_string_literal: true
-
-#### cmd
-
-# Passing just the command to execute will run it and return the output
-cmd <<~SHELLSTEP
-  echo "raw run without storing, should see me once""
-SHELLSTEP
-
-# Passing a name finds or creates an object and returns that
-cmd_cog = cmd(:hello)
-puts "This is our new cmd_cog named ':hello': #{cmd_cog}"
-
-# We can set a command to run for later
-cmd(:set_and_run).set("echo 'set_and_run, should see me once'")
-cmd(:set_and_run).run
-
-# Similarly, we can run immediately and then re-run later
-cmd(:run_and_rerun).run("echo 'run_and_rerun, should see me twice'")
-cmd(:run_and_rerun).run
-
-#### graph
-
-# We can open and re-open a graph, and then execute it
-graph(:updatable) do |graph|
-  graph.node(:open_cmd) do |state|
-    state[:open] = cmd("echo 'From a node added in first open, should see me once'")
-  end
-end
-
-graph(:updatable) do |graph|
-  graph.node(:reopen_cmd) do |state|
-    state[:reopen] = cmd("echo 'From a node added in reopen, should see me once'")
-  end
-end
-
-graph(:yea).execute
-
-# We can also just populate and execute a graph in one go by calling graph.execute in the block.
-graph(:define_and_exec) do |graph|
-  graph.node(:hi) do |state|
-    state[:hi_msg] = cmd("echo 'hi msg'")
-  end
-
-  graph.execute
-end
-
-# We can have subgraphs, because why not
-graph(:outer) do |graph|
-  graph.subgraph(:inner) do |subgraph|
-    subgraph.node(:inner_node) do |inner_state|
-      inner_state[:foo] = cmd("echo 'inner_state foo'")
-    end
-  end
-
-  graph.node(:outer) do |outer_state|
-    outer_state[:bar] = cmd("echo 'outer_state bar'")
-  end
-
-  graph.execute
-end
-
-# We can specify our own edges
-graph(:edges) do |graph|
-  graph.node(:thing1) do |state|
-    state[:thing1] = cmd("echo 'thing1'")
-  end
-
-  graph.node(:thing2) do |state|
-    state[:thing2] = cmd("echo 'thing2'")
-  end
-
-  graph.edge(from: :START, to: :thing1)
-  graph.edge(from: :thing1, to: :thing2)
-  graph.edge(from: :thing2, to: :DONE)
-
-  graph.execute
-end
-
-# We can have parallel execution
-graph(:parallel) do |graph|
-  graph.node(:thing1) do |state|
-    state[:thing1] = cmd("sleep 0.5 && echo 'parallel thing1'")
-  end
-
-  graph.node(:thing2) do |state|
-    state[:thing2] = cmd("sleep 0.5 && echo 'parallel thing2'")
-  end
-
-  graph.edge(from: :START, to: [:thing1, :thing2])
-  graph.edge(from: [:thing1, :thing2], to: :DONE)
-
-  graph.execute
-end
-
-# We can have edges that are defined with a block
-graph(:quantum) do |graph|
-  graph.node(:thing1) do |state|
-    state[:thing1] = cmd("echo 'quantum thing1'")
-  end
-
-  graph.edge(from: :START) do |_state|
-    :thing1
-  end
-
-  graph.edge(from: :thing1) do |_state|
-    :DONE
-  end
-
-  graph.execute
-end

data/dsl/scoped_executors.rb

@@ -1,28 +0,0 @@
-# typed: true
-# frozen_string_literal: true
-
-#: self as Roast::DSL::Workflow
-
-config do
-  cmd do
-    print_all!
-  end
-end
-
-execute(:capitalize_a_random_word) do
-  cmd(:word) { "shuf /usr/share/dict/words -n 1" }
-  cmd(:capitalize) do |my|
-    word = cmd(:word).out.strip
-    my.command = "sh"
-    my.args << "-c"
-    my.args << "echo '#{word}' | tr '[:lower:]' '[:upper:]'"
-  end
-end
-
-execute do
-  cmd(:before) { "echo '--> before'" }
-  execute { :capitalize_a_random_word }
-  execute { :capitalize_a_random_word }
-  execute { :capitalize_a_random_word }
-  cmd(:after) { "echo '--> after'" }
-end

data/dsl/simple.rb

@@ -1,8 +0,0 @@
-# typed: false
-# frozen_string_literal: true
-
-# This is a dead simple workflow that calls two commands
-cmd <<~CMDSTEP
-  echo "I have no idea what's going on"
-CMDSTEP
-cmd "pwd"

data/lib/roast/dsl/cogs/execute.rb

@@ -1,46 +0,0 @@
-# typed: true
-# frozen_string_literal: true
-
-module Roast
-  module DSL
-    module Cogs
-      class Execute < Cog
-        class Input < Cog::Input
-          #: Symbol?
-          attr_accessor :scope
-
-          #: () -> void
-          def initialize
-            super
-            @scope = nil
-          end
-
-          #: () -> void
-          def validate!
-            raise Cog::Input::InvalidInputError, "'scope' is required" unless scope.present?
-          end
-
-          #: (Symbol) -> void
-          def coerce(input_return_value)
-            self.scope = input_return_value
-          end
-        end
-
-        #: (Symbol, ^(Input) -> untyped, ^(Input) -> void) -> void
-        def initialize(name, cog_input_proc, trigger)
-          # NOTE: Sorbet expects the proc passed to super to be declared as taking a Cog::Input explicitly,
-          # not a subclass of Cog::Input.
-          cog_input_proc = cog_input_proc #: as ^(Cog::Input) -> untyped
-          super(name, cog_input_proc)
-          @trigger = trigger
-        end
-
-        #: (Input) -> Cog::Output
-        def execute(input)
-          @trigger.call(input)
-          Cog::Output.new
-        end
-      end
-    end
-  end
-end

data/lib/roast/dsl/cogs/graph.rb

@@ -1,53 +0,0 @@
-# typed: true
-# frozen_string_literal: true
-
-module Roast
-  module DSL
-    module Cogs
-      class Graph < Roast::DSL::Cog
-        #: Proc
-        attr_reader :block
-
-        #: (Symbol) { (Cog::Input) -> untyped } -> void
-        def initialize(name, &block)
-          @name = name
-          @block = block
-          @graph = Roast::Graph.new
-          super(name, block)
-        end
-
-        #: () -> void
-        def on_invoke
-          populate!(@graph)
-        end
-
-        #: () -> Symbol
-        def store_id
-          @name.to_sym
-        end
-
-        #: (Roast::DSL::Cog) -> void
-        def update(other)
-          return unless other.is_a?(Roast::DSL::Cogs::Graph)
-
-          return if other.block.nil?
-
-          other.populate!(@graph)
-        end
-
-        # Populates the provided graph in-place, with the definition of how to populate in the block
-        #: (Cog::Input) -> void
-        def populate!(graph)
-          return if @block.nil?
-
-          @block.call(graph)
-        end
-
-        #: () -> void
-        def execute
-          @graph.execute
-        end
-      end
-    end
-  end
-end