meta_workflows 0.9.14 → 0.9.16

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 87c0ac3e466398e6e54347b2449fa4c6fd04ff1c212f47c236df34d2bccd3ffe
-  data.tar.gz: '08d0adfaa0e80315f52e3063dacb23735d805987a3e992357a4959aba50a853c'
+  metadata.gz: bf87bca0ce45dc8b835c415c61203e0678cdb8a66e8668cb9997e12b76a9a164
+  data.tar.gz: 19c97c95dfecc3260c7869983c7281a498f623eac0e0636f50ada1e0a25eec70
 SHA512:
-  metadata.gz: 4a230b0d2dbd5896346f74b36436fb451f271dececd239321d891dd5681db1b9666a007fb878fdb3ecddc71acaed0b0972fe6b96e3ff6626b8f0e5b8a5febeb5
-  data.tar.gz: 8a7c331f06aebb0c53b7061acc088c10acbec3fbac9ad9a4a5e45e559dc8bd06cec2db7873cf1d5e5f69a1e4b263490ae3da1321cfcc5be059ae265d0a51ef97
+  metadata.gz: e4009226f5d3cd1bafb0d676a29ba21fcd4e181208e20801fab0a892cf50bae9bdb9df895c8d9b3cb919170193dae295d482bb9c67c357efda1d2c8f8f2ef430
+  data.tar.gz: 7af79ba6d4d8469e36e9be797abaafe8c1f0262e8fc90457ef1cd862a146a846ad455ef56cf3b442f195ddb6db98240af1dcbd1e6e8ed8f53444b48b1edc1f69

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/stylesheets/meta_workflows/application.css

@@ -736,7 +736,7 @@
   flex-direction: column;
   background-color: white;
   padding: 1rem 1rem 0 1rem;
-  height: 100%;
+  height: 95vh;
 }
 
 .lexi-chat-alpha-header {

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

@@ -2,7 +2,7 @@
 <% active_execution = local_assigns[:record]&.workflow_executions&.order(created_at: :desc)&.first %>
 <% active_chat = active_execution&.workflow_steps&.last&.chat %>
 
-<div class="lexi-chat-alpha-tray lexi-chat-container">
+<div class="lexi-chat-alpha-tray">
   <%# Header with Lexi logo left and close button right %>
   <div class="lexi-chat-alpha-header">
     <div class="lexi-chat-alpha-header-left">

data/lib/meta_workflows/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: meta_workflows
 version: !ruby/object:Gem::Version
-  version: 0.9.14
+  version: 0.9.16
 platform: ruby
 authors:
 - Leonid Medovyy