meta_workflows 0.9.13 → 0.9.14

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7f4d3efc62028f81a371bad517bc54f92527ac1b734b2ba2591e29b3ad9c2964
-  data.tar.gz: 7c24d71b9471737fa4fae693c1336229d0dbde16a95bd16fea5127ce847d2c7a
+  metadata.gz: 87c0ac3e466398e6e54347b2449fa4c6fd04ff1c212f47c236df34d2bccd3ffe
+  data.tar.gz: '08d0adfaa0e80315f52e3063dacb23735d805987a3e992357a4959aba50a853c'
 SHA512:
-  metadata.gz: b4a3cfeda85bc79adaf82267bbf952c9ff8c5fc0bd9398ae4279efb916b405e6a3a2f1e3baedb7e45203222a233361a831f660dc471a1dfa9cc08d5c5def17f3
-  data.tar.gz: 0b1065fa9f22c1f74b301f4196e9b2a250eeac081ffe243a2b97348041434579b28cd1150dc31b393a83665641b44f28ecc1985dedbb9c489fc9c5d2e63ca153
+  metadata.gz: 4a230b0d2dbd5896346f74b36436fb451f271dececd239321d891dd5681db1b9666a007fb878fdb3ecddc71acaed0b0972fe6b96e3ff6626b8f0e5b8a5febeb5
+  data.tar.gz: 8a7c331f06aebb0c53b7061acc088c10acbec3fbac9ad9a4a5e45e559dc8bd06cec2db7873cf1d5e5f69a1e4b263490ae3da1321cfcc5be059ae265d0a51ef97

data/CHANGELOG.md

@@ -16,6 +16,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - ViewComponent support for UI components
 - Turbo and Stimulus integration for frontend interactivity
 - PostgreSQL database support following host application patterns
+- Per-step model configuration in workflow YAML files for optimized AI model selection (NXT-6891)
 
 ### Changed
 - Extracted from course-builder monolith into standalone engine

data/README.md

@@ -60,6 +60,7 @@ MetaWorkflows supports several action types for different workflow needs:
 - Requires `prompt_id` configuration
 - Supports tool calling and complex reasoning tasks
 - Output is extracted and stored for subsequent steps
+- Supports optional `model` parameter for step-specific AI model configuration
 
 ### `human`
 - Presents UI for human interaction and input collection
@@ -84,6 +85,38 @@ MetaWorkflows supports several action types for different workflow needs:
 - Marks workflow as complete
 - Requires `redirect_path` or `redirect_method` configuration
 
+## Model Configuration
+
+MetaWorkflows supports configuring different AI models for different workflow steps, allowing you to optimize performance and cost by using the most appropriate model for each task.
+
+### Per-Step Model Configuration
+
+You can specify a different AI model for any llm action by adding a `model` parameter to the step configuration:
+
+```yaml
+steps:
+  - name: "simple_task"
+    action: "agent"
+    prompt_id: "simple_prompt"
+    model: "your-preferred-model-id"  # Use appropriate model from RubyLLM documentation
+    
+  - name: "complex_analysis"
+    action: "agent"
+    prompt_id: "analysis_prompt"
+    model: "your-preferred-model-id"  # Use appropriate model from RubyLLM documentation
+```
+
+### Supported Models
+
+The system supports any model identifier that is compatible with your `ruby_conversations` configuration. For the complete list of available models, refer to the [RubyLLM Available Models documentation](https://rubyllm.com/guides/available-models).
+
+
+Use the exact model ID from the documentation when configuring your workflow steps. For AWS Bedrock models, look for model IDs like `anthropic.claude-3-5-sonnet-20241022-v2:0` or `anthropic.claude-3-haiku-20240307-v1:0` in the Bedrock section.
+
+### Fallback Behavior
+
+- If no `model` is specified for a step, the system uses `RubyConversations.configuration.default_llm_model`
+
 ## Requirements
 
 - **Rails 7.2+**: Compatible with modern Rails applications
@@ -185,17 +218,6 @@ Rails.application.routes.draw do
 end
 ```
 
-### 5. Configure Sidekiq
-
-Ensure Sidekiq is configured in your application for background job processing:
-
-```ruby
-# config/application.rb or config/initializers/sidekiq.rb
-require 'sidekiq'
-
-# Configure Redis connection and other Sidekiq settings
-```
-
 ## Usage
 
 ### Creating Workflow Definitions
@@ -210,6 +232,7 @@ steps:
   - name: "initial_generation"
     action: "agent"
     prompt_id: "generation_prompt"
+    model: "your-preferred-model-id"  # Use appropriate model from RubyLLM documentation
     step_progress:
       - "Analyzing input parameters..."
       - "Generating initial content..."
@@ -282,20 +305,6 @@ class YourController < ApplicationController
 end
 ```
 
-#### Direct Job Execution
-
-```ruby
-# Start a workflow
-MetaWorkflows::MetaWorkflowJob.perform_later(
-  'example_workflow', 
-  context: { 
-    user_id: 1,
-    record_id: 123,
-    record_type: 'YourModel'
-  }
-)
-```
-
 ### Using Meta Workflow UI Components
 
 Instead of creating custom views from scratch, use the provided Meta Workflow partials:
@@ -384,8 +393,7 @@ The dummy app demonstrates MetaWorkflows integration with:
 - User authentication (Devise)
 - Post and Comment models with associations
 - Complete CRUD operations
-- MetaWorkflows engine mounted at `/meta_workflows`
-- StrongMind Identity SSO integration
+- MetaWorkflows engine mounted at `/meta_workflows_engine`
 
 ## Extending the System
 
@@ -473,19 +481,7 @@ To add a new action type:
 - Provide meaningful progress messages
 - Handle error cases gracefully
 - Use `record_update` steps to persist intermediate workflow results
-
-### Performance
-- Use background jobs for long-running processes
-- Implement appropriate caching strategies
-- Monitor workflow execution times
-- Set reasonable timeouts for LLM interactions
-- Use bulk operations in collection creators when possible
-
-### UI/UX Considerations
-- Use the provided meta partials for consistent UI
-- Provide meaningful step progress messages in workflow definitions
-- Ensure proper Turbo Stream configuration for real-time updates
-- Handle edge cases and error states appropriately
+- Choose appropriate AI models for each step based on task complexity and cost considerations
 
 ## Architecture Details
 
@@ -496,32 +492,6 @@ To add a new action type:
 - Models use engine-specific associations and validations
 - Services organized under `Services::MetaWorkflows::` namespace
 
-### Database Compatibility
-- Migration files include `table_exists?` checks to prevent conflicts
-- Exact schema compatibility maintained with existing applications
-- Proper foreign key references and indexes included
-- Migration timestamps ordered correctly for dependency resolution
-
-## Contributing
-
-Bug reports and pull requests are welcome on GitHub at https://github.com/strongmind/meta_workflows.
-
-For development contributions:
-1. Fork the repository
-2. Create a feature branch
-3. Add comprehensive tests
-4. Follow the established code patterns and namespacing
-5. Update documentation as needed
-6. Submit a pull request
-
-## Documentation
-
-For detailed information about the MetaWorkflows system:
-- [Setup Guide](https://strongmind.atlassian.net/wiki/spaces/MW/pages/3929833507) - Configuration and workflow setup
-
-## License
-
-The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
 
 ## Styling Setup
 
@@ -631,3 +601,8 @@ end
 - The main content area (Alpha tray) is always visible and holds your page content.
 
 For more advanced usage or to contribute improvements, see the tray logic in `TrayConfigurable` and the engine layout file.
+
+## Confluence Documentation
+
+For detailed information about the MetaWorkflows system:
+- [Setup Guide](https://strongmind.atlassian.net/wiki/spaces/MW/pages/3929833507) - Configuration and workflow setup

data/app/models/concerns/recipe_accessible.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module RecipeAccessible
+  extend ActiveSupport::Concern
+
+  def step_progress(step)
+    recipe&.dig('steps', step, 'step_progress')
+  end
+
+  def prompt_id(step)
+    recipe&.dig('steps', step, 'prompt_id')
+  end
+
+  def step_data(step)
+    recipe&.dig('steps', step)
+  end
+
+  def step_output(step)
+    recipe&.dig('steps', step, 'output')
+  end
+
+  def step_repetitions(step)
+    recipe&.dig('steps', step, 'repetitions')
+  end
+
+  def total_steps
+    recipe&.dig('steps')&.size || 0
+  end
+end

data/app/models/meta_workflows/workflow.rb

@@ -2,6 +2,8 @@
 
 module MetaWorkflows
   class Workflow < ApplicationRecord
+    include RecipeAccessible
+
     validates :name, presence: true, uniqueness: true
     validates :recipe, presence: true
 

data/app/models/meta_workflows/workflow_execution.rb

@@ -2,6 +2,8 @@
 
 module MetaWorkflows
   class WorkflowExecution < ApplicationRecord
+    include RecipeAccessible
+
     belongs_to :workflow, class_name: 'MetaWorkflows::Workflow'
     belongs_to :record, polymorphic: true
     has_many :workflow_steps, dependent: :destroy, class_name: 'MetaWorkflows::WorkflowStep'
@@ -18,29 +20,5 @@ module MetaWorkflows
     def increment_step
       update(current_step: current_step + 1)
     end
-
-    def step_progress(step)
-      recipe&.dig('steps', step, 'step_progress')
-    end
-
-    def prompt_id(step)
-      recipe&.dig('steps', step, 'prompt_id')
-    end
-
-    def step_data(step)
-      recipe&.dig('steps', step)
-    end
-
-    def step_output(step)
-      recipe&.dig('steps', step, 'output')
-    end
-
-    def step_repetitions(step)
-      recipe&.dig('steps', step, 'repetitions')
-    end
-
-    def total_steps
-      recipe&.dig('steps')&.size || 0
-    end
   end
 end

data/lib/meta_workflows/version.rb

@@ -3,7 +3,7 @@
 module MetaWorkflows
   MAJOR = 0
   MINOR = 9
-  PATCH = 13 # this is automatically incremented by the build process
+  PATCH = 14 # this is automatically incremented by the build process
 
   VERSION = "#{MetaWorkflows::MAJOR}.#{MetaWorkflows::MINOR}.#{MetaWorkflows::PATCH}".freeze
 end

data/lib/services/meta_workflows/meta_workflow_service.rb

@@ -26,7 +26,7 @@ module Services
         if ACTIONS_WITHOUT_CONVERSATION.include?(execution_step['action'])
           process_action(execution_step, nil, workflow_execution, workflow)
         else
-          chat = create_and_configure_chat(workflow_step)
+          chat = create_and_configure_chat(workflow_step, execution_step)
           conversation = create_and_configure_conversation(chat, workflow_execution, execution_output, execution_step)
           process_action(execution_step, conversation, workflow_execution, workflow)
         end
@@ -222,9 +222,13 @@ module Services
         conversation
       end
 
-      def create_and_configure_chat(workflow_step)
-        workflow_step.chat = ::MetaWorkflows::Chat.new(model_id: RubyConversations.configuration.default_llm_model,
-                                                       provider: RubyConversations.configuration.default_llm_provider)
+      def create_and_configure_chat(workflow_step, execution_step)
+        model_id = execution_step['model'] || RubyConversations.configuration.default_llm_model
+
+        workflow_step.chat = ::MetaWorkflows::Chat.new(
+          model_id: model_id,
+          provider: RubyConversations.configuration.default_llm_provider
+        )
         chat = workflow_step.chat
         chat.user = @user
         chat.save!

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: meta_workflows
 version: !ruby/object:Gem::Version
-  version: 0.9.13
+  version: 0.9.14
 platform: ruby
 authors:
 - Leonid Medovyy
@@ -147,6 +147,7 @@ files:
 - app/jobs/meta_workflows/meta_workflow_job.rb
 - app/jobs/meta_workflows/record_redirect_job.rb
 - app/mailers/meta_workflows/application_mailer.rb
+- app/models/concerns/recipe_accessible.rb
 - app/models/meta_workflows.rb
 - app/models/meta_workflows/application_record.rb
 - app/models/meta_workflows/chat.rb