meta_workflows 0.9.15 → 0.9.17

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a869293f98a7a997feb4c8c20173c25c85101ed225713e0a7080b40b45048771
-  data.tar.gz: 7edc0a1e0bde4bbe02c60b6e0244253e055047684a9a793235ba858886451706
+  metadata.gz: 628e1aa6509bd6913af6ecd6c2fb8b9097d5699598624543c30e0e759a835e39
+  data.tar.gz: f4388abaaa5e93aeec97c9b00156c87dc93c21348710812f0b068098c90bc9a8
 SHA512:
-  metadata.gz: 2b2768f55196fec5a94c8f83810563d7ac46625af7a9953e6aeb6f0fd1c6478bfe402c577f3f9076e93be1bbfc26a38834c27c94a39d937de56dd52b938ee332
-  data.tar.gz: 6b1f0065875d24435071cbaa15fcda4f3683c1d2e719415949c3001aa6aa33f6c9d841ba870835ae083d2c5df145082f4b70077141690eb8588eb09b793b50b3
+  metadata.gz: 4e495070ef645745e8387d21e92dfb4792cdc7dfa8a8cd5680518f1e01454d394772d5a05eeff87e343ec922923b7eea85b4845db866a1ca91017c40b3d81cb1
+  data.tar.gz: b8e34fe5aa9a31d19f05f597432859087bb5d5bd2c9de8a2afc4822a29dbbedfb5a7cd2b236d8d805f32bc04b10edd2ed66027e3dfe5964f9fa2a37f8a6dfd5b

data/README.md

@@ -233,10 +233,7 @@ steps:
     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..."
-      - "Refining results..."
+    step_progress: ["Analyzing input parameters", "Generating initial content", "Refining results"]
     input:
       title:
         type: "string"
@@ -250,8 +247,7 @@ steps:
   - name: "human_review"
     action: "human"
     prompt_id: "review_prompt"
-    step_progress:
-      - "Preparing content for review..."
+    step_progress: ["Preparing content for review"]
     input:
       generated_content:
         type: "string"
@@ -267,9 +263,7 @@ steps:
     attributes_to_update:
       - "title"
       - "topic"
-    step_progress:
-      - "Updating record..."
-      - "Saving changes..."
+    step_progress: ["Updating record", "Saving changes"]
     workflow_params:
       - name: "title"
         type: string
@@ -307,27 +301,87 @@ end
 
 ### Using Meta Workflow UI Components
 
-Instead of creating custom views from scratch, use the provided Meta Workflow partials:
+Instead of creating custom views from scratch, use the provided Meta Workflow partials. The system now uses in-chat messaging for loader states and error handling, providing a seamless conversational experience:
+
+#### Chat-Based UI Components
+
+The workflow UI now consists of three main components:
+
+1. **Chat Messages (`meta_response`)**: Displays conversation history and responses
+2. **Loader Messages (`meta_loader_message`)**: Shows loading states as chat messages
+3. **Error Messages (`meta_error_message`)**: Displays errors as friendly chat messages
+4. **Response Form (`meta_response_form`)**: Handles user input during human interaction steps
 
 #### Complete View Example
 
 ```erb
 <%= turbo_stream_from turbo_stream_name(@record) %>
 <div class="max-w-3xl m-auto flex flex-col p-10 gap-6">
-  <!-- Workflow progress and chat messages area -->
-  <%= render partial: 'meta_workflows/loader', locals: {
+  <!-- Chat messages area with existing conversation -->
+  <%= render partial: 'meta_workflows/response_lexi', locals: {
     record: @record,
-    step_progress: ["Generating draft content...", "Processing with AI..."]
+    chat: @active_chat,
+    messages: @active_chat&.messages&.order(:created_at) || [],
+    user_messages: @active_chat&.messages&.where(role: 'user')&.order(:created_at) || [],
+    last_message: @active_chat&.messages&.last,
+    full_response: nil,
+    is_streaming: false
   } %>
   
   <!-- User input area for human interaction steps -->
   <%= render partial: 'meta_workflows/response_form', locals: {
     record: @record,
-    response_enabled: false
+    response_enabled: true,
+    workflow_execution_id: @workflow_execution&.id,
+    chat_id: @active_chat&.id,
+    step_has_repetitions: true
   } %>
 </div>
 ```
 
+#### Built-in Chat Tray Components
+
+For a complete chat experience, use the pre-built chat tray components:
+
+**Right Tray (Gamma) - Sidebar Chat:**
+```erb
+<%= render partial: 'meta_workflows/lexi_chat_right_tray', locals: {
+  record: @record
+} %>
+```
+
+**Alpha Tray (Main) - Full-Screen Chat:**
+```erb
+<%= render partial: 'meta_workflows/lexi_chat_alpha_tray', locals: {
+  record: @record
+} %>
+```
+
+#### Individual Component Usage
+
+**Loader Message (appears as chat message):**
+```erb
+<%= render partial: 'meta_workflows/loader_message', locals: {
+  record: @record,
+  step_progress: ["Generating content", "Processing with AI", "Finalizing results"]
+} %>
+```
+
+**Error Message (appears as chat message):**
+```erb
+<%= render partial: 'meta_workflows/error_message', locals: {
+  record: @record
+} %>
+```
+
+#### Key Features
+
+- **In-Chat Loading**: Loader messages appear as animated chat bubbles from the assistant
+- **Friendly Error Messages**: Errors display as conversational messages with friendly styling
+- **Seamless Integration**: Chat history persists while new interactions are processed
+- **Responsive Design**: Components adapt to different tray layouts (sidebar, main, bottom)
+- **Turbo Stream Updates**: Real-time updates without page refreshes using dedicated frame targeting
+
 ## File Structure Overview
 
 The MetaWorkflows gem follows a structured organization:
@@ -478,7 +532,7 @@ To add a new action type:
 ### Workflow Design
 - Keep steps focused and single-purpose
 - Design clear input/output schemas
-- Provide meaningful progress messages
+- Provide meaningful progress messages without ellipsis (the loader UI handles animated dots automatically)
 - Handle error cases gracefully
 - Use `record_update` steps to persist intermediate workflow results
 - Choose appropriate AI models for each step based on task complexity and cost considerations

data/app/assets/javascripts/meta_workflows/controllers/loading_phrases_controller.js

@@ -9,7 +9,7 @@ export default class extends Controller {
   
   connect() {
     if (!this.hasPhrasesValue || this.phrasesValue.length === 0) {
-      this.phrasesValue = ["Talking to the LLM..."]
+      this.phrasesValue = ["Thinking"]
     }
     
     this.currentIndex = 0

data/app/controllers/concerns/meta_workflows/streamable.rb

@@ -0,0 +1,70 @@
+# frozen_string_literal: true
+
+module MetaWorkflows
+  module Streamable
+    extend ActiveSupport::Concern
+
+    included do
+      include MetaWorkflows::MetaWorkflowsHelper
+    end
+
+    private
+
+    # Broadcasts loader message with step progress
+    def broadcast_loader_stream(workflow_execution)
+      step_progress = workflow_execution.step_progress(workflow_execution.current_step) || default_step_progress
+      record = workflow_execution.record
+
+      Turbo::StreamsChannel.broadcast_replace_to(
+        turbo_stream_name(record),
+        target: target_frame_id(record, loader: true),
+        partial: meta_loader_message,
+        locals: { record: record, step_progress: step_progress }
+      )
+    end
+
+    # Broadcasts error response when workflow fails
+    def broadcast_error_response(workflow_execution)
+      record = workflow_execution.record
+
+      Turbo::StreamsChannel.broadcast_replace_to(
+        turbo_stream_name(record),
+        target: target_frame_id(record, loader: true),
+        partial: meta_error_message,
+        locals: { record: record }
+      )
+    end
+
+    # Builds loader stream for direct response
+    def build_loader_stream(record:, workflow_execution:)
+      step_progress = workflow_execution.step_progress(workflow_execution.current_step) || default_step_progress
+
+      turbo_stream.replace(
+        target_frame_id(record, loader: true),
+        partial: meta_loader_message,
+        locals: { record: record, step_progress: step_progress }
+      )
+    end
+
+    # Builds response form stream for direct response
+    def build_response_form_stream(record:, workflow_execution:, response_enabled:, responding:, chat_id:)
+      turbo_stream.replace(
+        target_frame_id(record, form: true),
+        partial: meta_response_form,
+        locals: build_response_form_locals(record:, workflow_execution:, response_enabled:, responding:, chat_id:)
+      )
+    end
+
+    # Builds locals hash for response form
+    def build_response_form_locals(record:, workflow_execution:, response_enabled:, responding:, chat_id:)
+      {
+        record: record,
+        workflow_execution_id: workflow_execution.id,
+        chat_id: chat_id,
+        response_enabled: response_enabled,
+        responding: responding,
+        step_has_repetitions: current_step_has_repetitions?(workflow_execution)
+      }
+    end
+  end
+end

data/app/controllers/meta_workflows/humans_controller.rb

@@ -3,10 +3,12 @@
 module MetaWorkflows
   class HumansController < MetaController
     include MetaWorkflows::MetaWorkflowsHelper
+    include MetaWorkflows::Streamable
     before_action :set_workflow_data, only: [:update]
 
     def update
       if params[:advance].present? || should_auto_advance?
+        @workflow_execution.increment_step
         render_loader_stream
         process_human_input(auto_advancing: should_auto_advance?, manual_advancing: params[:advance].present?)
       else
@@ -44,19 +46,9 @@ module MetaWorkflows
       respond_to do |format|
         format.turbo_stream do
           render turbo_stream: [
-            turbo_stream.replace(
-              target_frame_id(@record, loader: true),
-              partial: meta_loader_message,
-              locals: {
-                record: @record,
-                step_progress: fetch_step_progress
-              }
-            ),
-            turbo_stream.replace(
-              target_frame_id(@record, form: true),
-              partial: meta_response_form,
-              locals: response_form_locals(response_enabled: false)
-            )
+            build_loader_stream(record: @record, workflow_execution: @workflow_execution),
+            build_response_form_stream(record: @record, workflow_execution: @workflow_execution,
+                                       response_enabled: false, responding: false, chat_id: params[:chat_id])
           ]
         end
       end
@@ -65,24 +57,15 @@ module MetaWorkflows
     def render_response_form_stream
       respond_to do |format|
         format.turbo_stream do
-          render turbo_stream: turbo_stream.replace(
-            target_frame_id(@record, form: true),
-            partial: meta_response_form,
-            locals: response_form_locals(response_enabled: true, responding: true)
+          render turbo_stream: build_response_form_stream(
+            record: @record,
+            workflow_execution: @workflow_execution,
+            response_enabled: true,
+            responding: true,
+            chat_id: params[:chat_id]
           )
         end
       end
     end
-
-    def response_form_locals(response_enabled: true, responding: false)
-      {
-        record: @record,
-        workflow_execution_id: @workflow_execution.id,
-        chat_id: params[:chat_id],
-        response_enabled: response_enabled,
-        responding: responding,
-        step_has_repetitions: current_step_has_repetitions?(@workflow_execution)
-      }
-    end
   end
 end

data/app/jobs/meta_workflows/human_input_job.rb

@@ -57,8 +57,6 @@ module MetaWorkflows
 
     def advance_workflow(params)
       dialogue = collect_messages_from_chat(params)
-      workflow_execution = active_workflow_execution
-      workflow_execution.increment_step
 
       MetaWorkflows::MetaWorkflowJob.perform_later(
         record_id: @record.id,

data/app/jobs/meta_workflows/meta_job.rb

@@ -2,6 +2,8 @@
 
 module MetaWorkflows
   class MetaJob < MetaWorkflows::ApplicationJob
+    include MetaWorkflows::Streamable
+
     attr_accessor :chat, :inputs, :full_response, :user_id, :record, :auto_advancing, :manual_advancing
 
     private
@@ -42,14 +44,15 @@ module MetaWorkflows
     end
 
     def process_and_broadcast(conversation)
-      workflow_step = current_workflow_step
+      workflow_execution = active_workflow_execution
+      workflow_step = current_workflow_step(workflow_execution)
 
       begin
         clear_previous_errors(workflow_step)
         execute_llm_conversation(conversation)
         finalize_conversation(conversation)
       rescue StandardError => e
-        handle_llm_error(e, workflow_step, conversation)
+        handle_llm_error(e, workflow_step, workflow_execution, conversation)
         raise
       end
     end
@@ -70,10 +73,10 @@ module MetaWorkflows
       broadcast_form(chat) unless auto_advancing
     end
 
-    def handle_llm_error(error, workflow_step, conversation)
+    def handle_llm_error(error, workflow_step, workflow_execution, conversation)
       log_error(error)
       store_error_in_workflow_step(error, workflow_step, conversation)
-      broadcast_error_response
+      broadcast_error_response(workflow_execution)
     end
 
     def log_error(error)
@@ -90,25 +93,12 @@ module MetaWorkflows
                                   })
     end
 
-    def current_workflow_step
-      workflow_execution = active_workflow_execution
+    def current_workflow_step(workflow_execution)
       return nil unless workflow_execution
 
       workflow_execution.workflow_steps.find_by(step: workflow_execution.current_step)
     end
 
-    def broadcast_error_response
-      # Replace loader with error message
-      Turbo::StreamsChannel.broadcast_replace_to(
-        turbo_stream_name(record),
-        target: target_frame_id(record, loader: true),
-        partial: 'meta_workflows/error_message',
-        locals: {
-          record: record
-        }
-      )
-    end
-
     def broadcast_form(chat)
       raise NotImplementedError
     end

data/app/views/meta_workflows/_error_message.html.erb

@@ -1,3 +1,4 @@
+<%= turbo_frame_tag target_frame_id(record, loader: true) do %>
 <div class="lexi-message-assistant">
   <div class="lexi-message-bubble-assistant">
     <div class="lexi-message-content-assistant">
@@ -11,4 +12,5 @@
       </div>
     </div>
   </div>
-</div> 
+</div> 
+<% end %>

data/app/views/meta_workflows/_loader_message.html.erb

@@ -1,3 +1,4 @@
+<%= turbo_frame_tag target_frame_id(record, loader: true) do %>
 <div class="lexi-message-assistant">
   <div class="lexi-loader-bubble">
     <div class="lexi-message-content-assistant" 
@@ -13,4 +14,5 @@
       </span>
     </div>
   </div>
-</div> 
+</div> 
+<% end %>

data/lib/meta_workflows/version.rb

@@ -3,7 +3,7 @@
 module MetaWorkflows
   MAJOR = 0
   MINOR = 9
-  PATCH = 15 # this is automatically incremented by the build process
+  PATCH = 17 # 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

@@ -3,6 +3,9 @@
 module Services
   module MetaWorkflows
     class MetaWorkflowService
+      include ::MetaWorkflows::MetaWorkflowsHelper
+      include ::MetaWorkflows::Streamable
+
       ACTIONS_WITHOUT_CONVERSATION = %w[record_redirect collection_create record_update].freeze
 
       attr_reader :record, :workflow_name, :user, :inputs, :workflow_params
@@ -35,6 +38,8 @@ module Services
       private
 
       def process_action(execution_step, conversation, workflow_execution, workflow)
+        broadcast_loader_stream(workflow_execution)
+
         case execution_step['action']
         when 'agent'
           process_agent_action(conversation, workflow_execution, workflow)
@@ -102,6 +107,7 @@ module Services
         Rails.logger.error(error.backtrace.join("\n"))
 
         record_error_details(error, workflow_step, workflow, workflow_execution) if workflow_step
+        broadcast_error_response(workflow_execution)
       end
 
       def record_error_details(error, workflow_step, workflow, workflow_execution)
@@ -145,6 +151,7 @@ module Services
           continue_workflow(workflow_execution)
         rescue StandardError => e
           Rails.logger.error("Error creating collection: #{e.message}")
+          broadcast_error_response(workflow_execution)
           # The workflow should halt on error per requirements - do not increment step
         end
       end
@@ -158,6 +165,7 @@ module Services
           continue_workflow(workflow_execution)
         rescue StandardError => e
           Rails.logger.error("Error updating record: #{e.message}")
+          broadcast_error_response(workflow_execution)
           # Let Sidekiq handle retry - reraise the error
           raise
         end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: meta_workflows
 version: !ruby/object:Gem::Version
-  version: 0.9.15
+  version: 0.9.17
 platform: ruby
 authors:
 - Leonid Medovyy
@@ -9,7 +9,7 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-07-11 00:00:00.000000000 Z
+date: 2025-07-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -128,6 +128,7 @@ files:
 - app/assets/javascripts/meta_workflows/controllers/tray_controller.js
 - app/assets/javascripts/meta_workflows_manifest.js
 - app/assets/stylesheets/meta_workflows/application.css
+- app/controllers/concerns/meta_workflows/streamable.rb
 - app/controllers/concerns/tray_configurable.rb
 - app/controllers/meta_workflows/application_controller.rb
 - app/controllers/meta_workflows/base_debug_controller.rb