meta_workflows 0.9.15 → 0.9.16

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a869293f98a7a997feb4c8c20173c25c85101ed225713e0a7080b40b45048771
-  data.tar.gz: 7edc0a1e0bde4bbe02c60b6e0244253e055047684a9a793235ba858886451706
+  metadata.gz: bf87bca0ce45dc8b835c415c61203e0678cdb8a66e8668cb9997e12b76a9a164
+  data.tar.gz: 19c97c95dfecc3260c7869983c7281a498f623eac0e0636f50ada1e0a25eec70
 SHA512:
-  metadata.gz: 2b2768f55196fec5a94c8f83810563d7ac46625af7a9953e6aeb6f0fd1c6478bfe402c577f3f9076e93be1bbfc26a38834c27c94a39d937de56dd52b938ee332
-  data.tar.gz: 6b1f0065875d24435071cbaa15fcda4f3683c1d2e719415949c3001aa6aa33f6c9d841ba870835ae083d2c5df145082f4b70077141690eb8588eb09b793b50b3
+  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/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 = 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.15
+  version: 0.9.16
 platform: ruby
 authors:
 - Leonid Medovyy