meta_workflows 0.9.23 → 0.9.25

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 726c1853fd74d44442e6948f4ecad0f15b0f4bc8c0ca178f5d74339478b4c5f1
-  data.tar.gz: 4831f59cb31e16def136625e45fbaf5260e6dd5d1eaa26caf0514a9959d4beaf
+  metadata.gz: 45d13fedf05d6e20b7070f2615acbc0b90e2e34a68b573213ef71e4383c7b6cb
+  data.tar.gz: 86344d2db4c7ad7b33549f030e3b3c6017d668e24597655b6b369b97456cbb54
 SHA512:
-  metadata.gz: d4f4f00a82d6f151797509c0caf49fc1c65b967c459815c77d70e06cbba1afdf2a1a118a5525743feeb3d8097d64d2d59278fae989b946b11435b6ab66e4fda1
-  data.tar.gz: 1d04504d3da419f77e23be6bb244c8e759e98904bcbf21d680c4cfe7875321c45ca5fb381a25f967b81c1e64b904d0cd4eff295feb34305377c3c30d06e848e9
+  metadata.gz: 182ebf3da42adc40c4e7808da4a2a030af63500b97fc1b3dabb350c6eb165706fcdf208135773053fce14facd398e2515d4457113f54c853fd7c80e3141fe5aa
+  data.tar.gz: e1d867b821e2d42c6a215e0c6bd7a810604c490efa51a1791f6e2a0449192cd4bc628b2a30ff6eaf7710288f702c9cc336fb3e4b09346a5492cbe6c5af12fd0a

data/README.md

@@ -67,6 +67,17 @@ MetaWorkflows supports several action types for different workflow needs:
 - Requires `prompt_id` for context presentation
 - Collects user feedback through forms
 - Workflow pauses until human input is provided
+- Supports `advanceable: true` to show "Next" button for manual step advancement
+- **Note**: When `repetitions` is configured, advance/skip buttons are hidden and repetition logic takes precedence
+
+### `structured_human`
+- Presents structured input UI (radio buttons, checkboxes, sliders) for user interaction
+- Requires `prompt_id` for context presentation
+- Collects structured user input through form elements
+- Automatically advances to next step upon form submission
+- Supports `skippable: true` to show "Skip" button for bypassing the step
+- When `skippable` is present and clicked, a default user message will be sent 'Not mentioned' to notify the llm that the user did not answer whatever was being prompted
+- **Note**: When `repetitions` is configured, skip buttons are hidden and repetition logic takes precedence
 
 ### `collection_create`
 - Creates collections of related records atomically
@@ -85,6 +96,68 @@ MetaWorkflows supports several action types for different workflow needs:
 - Marks workflow as complete
 - Requires `redirect_path` or `redirect_method` configuration
 
+## Workflow Step Behavior and Restrictions
+
+### Step Advancement Controls
+
+MetaWorkflows provides fine-grained control over how users can advance through workflow steps:
+
+#### `advanceable` (Human Steps Only)
+- **Purpose**: Adds a "Next" button to `human` action steps for manual advancement
+- **Usage**: Add `advanceable: true` to a `human` step configuration
+- **Behavior**: Users can click "Next" to advance without providing input
+- **Restriction**: **Not available when `repetitions` is configured** - repetition logic takes precedence
+
+#### `skippable` (Structured Human Steps Only)  
+- **Purpose**: Adds a "Skip" button to `structured_human` action steps
+- **Usage**: Add `skippable: true` to a `structured_human` step configuration
+- **Behavior**: Users can skip the structured input and advance to the next step
+- **Restriction**: **Not available when `repetitions` is configured** - repetition logic takes precedence
+
+#### `repetitions` 
+- **Purpose**: Allows a step to repeat a specified number of times before advancing
+- **Usage**: Add `repetitions: <number>` to any step configuration
+- **Behavior**: Step will repeat until the specified count is reached, then auto-advance
+- **Priority**: **Takes precedence over `advanceable` and `skippable`** - advance/skip buttons are hidden
+
+### Configuration Examples
+
+```yaml
+# Human step with advance button (when no repetitions)
+- name: "review_content"
+  action: "human"
+  prompt_id: "content_review"
+  advanceable: true
+
+# Structured human step with skip button (when no repetitions)  
+- name: "optional_survey"
+  action: "structured_human"
+  prompt_id: "user_survey"
+  skippable: true
+  structured_input:
+    type: single_choice
+    options:
+      - label: "Option A"
+        value: "a"
+
+# Step with repetitions (advance/skip buttons hidden)
+- name: "retry_process"
+  action: "agent"
+  prompt_id: "processing_task"
+  repetitions: 3  # Will repeat 3 times before advancing
+```
+
+### Behavioral Rules
+
+1. **Repetitions Take Precedence**: When `repetitions` is configured on a step, advance and skip buttons are automatically hidden regardless of `advanceable` or `skippable` settings
+2. **Action Type Restrictions**: 
+   - `advanceable` only applies to `human` action steps
+   - `skippable` only applies to `structured_human` action steps
+3. **Automatic vs Manual Advancement**:
+   - Steps with `repetitions` advance automatically after reaching the repeat count
+   - Steps with `advanceable`/`skippable` require user interaction to advance
+   - All other steps advance based on their action type's default behavior
+
 ## 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.

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

@@ -1,7 +1,7 @@
 import { Controller } from '@hotwired/stimulus';
 
 export default class extends Controller {
-  static targets = ['textarea', 'form', 'structuredInputForm'];
+  static targets = ['textarea', 'form', 'structuredInputForm', 'hiddenMessage'];
 
   connect() {
     this.submitted = false;
@@ -19,7 +19,7 @@ export default class extends Controller {
     }
   }
 
-  handleSubmit() {
+  handleSubmit(event) {
     if (this.submitted) {
       return;
     }
@@ -29,6 +29,28 @@ export default class extends Controller {
     }
 
     this.submitted = true;
+    
+    if (this.hasHiddenMessageTarget) {
+      this.hiddenMessageTarget.disabled = true;
+    }
+    
+    this.hideStructuredInputForm();
+    this.formTarget.requestSubmit();
+  }
+
+  handleSkip(event) {
+    event.preventDefault();
+    
+    if (this.submitted) {
+      return;
+    }
+
+    this.submitted = true;
+    
+    if (this.hasTextareaTarget) {
+      this.textareaTarget.disabled = true;
+    }
+    
     this.hideStructuredInputForm();
     this.formTarget.requestSubmit();
   }
@@ -36,6 +58,14 @@ export default class extends Controller {
   hideStructuredInputForm() {
     if (this.hasStructuredInputFormTarget) {
       this.structuredInputFormTarget.style.display = 'none';
+      return;
+    }
+
+    const structuredForm = document.querySelector('[data-meta-workflows--lexi-form-submit-target="structuredInputForm"]');
+    if (structuredForm) {
+      structuredForm.style.display = 'none';
+      return;
     }
   }
 }
+

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

@@ -57,7 +57,9 @@ module MetaWorkflows
         chat_id: chat_id,
         response_enabled: response_enabled,
         responding: responding,
-        step_has_repetitions: current_step_has_repetitions?(workflow_execution)
+        step_has_repetitions: current_step_has_repetitions?(workflow_execution),
+        show_next_button: show_next_button?(workflow_execution),
+        show_skip_button: show_skip_button?(workflow_execution)
       }
     end
 

data/app/controllers/meta_workflows/meta_controller.rb

@@ -49,7 +49,7 @@ module MetaWorkflows
             build_chat_history_stream(record: @record, workflow_execution: @workflow_execution),
             build_streaming_response_stream(record: @record, show_loader: true),
             build_response_form_stream(record: @record, workflow_execution: @workflow_execution,
-                                       response_enabled: false, responding: false, chat_id: params[:chat_id])
+                                       response_enabled: false, responding: true, chat_id: params[:chat_id])
           ]
         end
       end

data/app/helpers/meta_workflows/meta_workflows_helper.rb

@@ -91,6 +91,18 @@ module MetaWorkflows
       workflow_execution.step_repetitions(workflow_execution.current_step).present?
     end
 
+    def show_next_button?(workflow_execution)
+      return false if current_step_has_repetitions?(workflow_execution)
+
+      workflow_execution.step_advanceable?(workflow_execution.current_step)
+    end
+
+    def show_skip_button?(workflow_execution)
+      return false if current_step_has_repetitions?(workflow_execution)
+
+      workflow_execution.step_skippable?(workflow_execution.current_step)
+    end
+
     def default_step_progress
       ['Thinking']
     end

data/app/jobs/meta_workflows/human_input_job.rb

@@ -43,6 +43,8 @@ module MetaWorkflows
                   response_enabled: true,
                   chat_id: chat.id,
                   step_has_repetitions: current_step_has_repetitions?(workflow_execution),
+                  show_next_button: show_next_button?(workflow_execution),
+                  show_skip_button: show_skip_button?(workflow_execution),
                   is_structured_input: is_structured_input }
       )
     end

data/app/models/concerns/recipe_accessible.rb

@@ -23,6 +23,14 @@ module RecipeAccessible
     recipe&.dig('steps', step, 'repetitions')
   end
 
+  def step_advanceable?(step)
+    recipe&.dig('steps', step, 'advanceable') || false
+  end
+
+  def step_skippable?(step)
+    recipe&.dig('steps', step, 'skippable') || false
+  end
+
   def total_steps
     recipe&.dig('steps')&.size || 0
   end

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

@@ -51,7 +51,9 @@
           <%= render meta_structured_input, record: local_assigns[:record], structured_input_config: false, is_structured_input: false %>
           
           <!-- Regular Form Input (always present) -->
-          <%= render partial: meta_response_form, locals: {record: local_assigns[:record], response_enabled: true, workflow_execution_id: active_execution&.id, chat_id: active_execution&.workflow_steps&.last&.chat&.id, step_has_repetitions: true, is_structured_input: is_structured_input } %>
+          <%= render partial: meta_response_form, locals: {record: local_assigns[:record], response_enabled: true,
+          workflow_execution_id: active_execution&.id, chat_id: active_execution&.workflow_steps&.last&.chat&.id,
+           workflow_execution: active_execution, is_structured_input: is_structured_input, show_skip_button: false, show_next_button: false } %>
         </div>
       </div>
     </div>

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

@@ -42,7 +42,8 @@
     <div class="lexi-input-wrapper" data-controller="meta-workflows--lexi-form-submit">
       <%= render meta_structured_input, record: local_assigns[:record], structured_input_config: false, is_structured_input: false %>
       
-      <%= render partial: meta_response_form, locals: {record: local_assigns[:record], response_enabled: true, workflow_execution_id: active_execution&.id, chat_id: active_execution&.workflow_steps&.last&.chat&.id, step_has_repetitions: true, is_structured_input: is_structured_input } %>
+      <%= render partial: meta_response_form, locals: {record: local_assigns[:record], response_enabled: true, workflow_execution_id: active_execution&.id, 
+      chat_id: active_execution&.workflow_steps&.last&.chat&.id, workflow_execution: active_execution, is_structured_input: is_structured_input } %>
     </div>
   </div>
 </div> 

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

@@ -3,18 +3,17 @@
       <%= form_with url: workflow_execution_id.present? ? meta_workflows.human_path(workflow_execution_id) : "#",
                     method: :patch,
                     id: "#{target_frame_id(record, form: true)}_lexi",
-                    data: { "meta-workflows--lexi-form-submit-target": "form" } do |form| %>
+                    data: { controller: "meta-workflows--lexi-form-submit", "meta-workflows--lexi-form-submit-target": "form", action: "submit->meta-workflows--lexi-form-submit#handleSubmit" } do |form| %>
         <%= form.hidden_field :chat_id, value: chat_id %>
         <% if local_assigns[:is_structured_input] %>
           <%= form.hidden_field :auto_advance, value: true %>
         <% end %>
-                <fieldset>
           <div class="lexi-form-container">
             <!-- Input Container -->
             <div class="lexi-input-container lexi-input-max-height">
               <!-- Text Input -->
               <div class="lexi-textarea-wrapper">
-                 <%= form.text_area :message, rows: 1, placeholder: random_chat_placeholder, disabled: local_assigns[:responding] || !local_assigns[:response_enabled], class: "lexi-textarea lexi-textarea-min-height", data: { action: "keypress.enter->meta-workflows--lexi-form-submit#handleKeyDown submit->meta-workflows--lexi-form-submit#handleSubmit", "meta-workflows--lexi-form-submit-target": "textarea" } %>
+                 <%= form.text_area :message, rows: 1, placeholder: random_chat_placeholder, disabled: local_assigns[:responding] || !local_assigns[:response_enabled], class: "lexi-textarea lexi-textarea-min-height", data: { action: "keypress.enter->meta-workflows--lexi-form-submit#handleKeyDown", "meta-workflows--lexi-form-submit-target": "textarea" } %>
               </div>
 
               <div class="lexi-input-controls">
@@ -36,7 +35,7 @@
                       <i class="fa-solid fa-arrow-up text-lg"></i>
                     </button>
                   <% else %>
-                    <%= form.button type: "submit", class: "lexi-send-button sm-btn sm-btn-primary" do %>
+                    <%= form.button type: "button", class: "lexi-send-button sm-btn sm-btn-primary", data: { "meta-workflows--lexi-form-submit-target": "submitButton", action: "click->meta-workflows--lexi-form-submit#handleSubmit" } do %>
                       <i class="fa-solid fa-arrow-up text-lg"></i>
                     <% end %>
                   <% end %>
@@ -47,13 +46,24 @@
             <p class="lexi-recording-notice">This chat is being recorded.</p>
 
             <div>
-              <% if local_assigns[:step_has_repetitions] %>
-                <!-- Empty placeholder to prevent layout jank -->
-                <div aria-hidden="true"></div>
-              <% else %>
-                <%= form.button type: "submit", name: "manual_advance", value: "true", class: "lexi-advance-button #{'opacity-50 cursor-not-allowed' if local_assigns[:responding]}", disabled: local_assigns[:responding] do %>
+              <% workflow_execution = local_assigns[:workflow_execution] %>
+              <% if workflow_execution && show_next_button?(workflow_execution) || local_assigns[:show_next_button] %>
+                <!-- Next button for advanceable steps -->
+                <%= form.button type: "submit", name: "manual_advance", value: "true", class: "lexi-advance-button #{'opacity-50 cursor-not-allowed' if local_assigns[:responding]}", disabled: local_assigns[:responding], data: { "meta-workflows--lexi-form-submit-target": "submitButton", action: "click->meta-workflows--lexi-form-submit#handleSubmit" } do %>
                   <i class="fa-light fa-arrow-right"></i> Next
                 <% end %>
+              <% elsif workflow_execution && show_skip_button?(workflow_execution) || local_assigns[:show_skip_button] %>
+                <!-- Skip button for skippable steps -->
+                <%= form.button type: "submit", name: "auto_advance", value: true, class: "lexi-advance-button #{'opacity-50 cursor-not-allowed' if local_assigns[:responding]}", disabled: local_assigns[:responding], data: { action: "click->meta-workflows--lexi-form-submit#handleSkip" } do %>
+                  <i class="fa-light fa-forward-step"></i> Skip
+                <% end %>
+                <%= form.hidden_field :message, value: "Not Mentioned", data: { "meta-workflows--lexi-form-submit-target": "hiddenMessage" } %>
+              <% elsif local_assigns[:step_has_repetitions] %>
+                <!-- Empty placeholder to prevent layout jank for repetitions -->
+                <div aria-hidden="true"></div>
+              <% else %>
+                <!-- Empty placeholder for steps with no buttons -->
+                <div aria-hidden="true"></div>
               <% end %>
             </div>
           </div>

data/lib/meta_workflows/version.rb

@@ -3,7 +3,7 @@
 module MetaWorkflows
   MAJOR = 0
   MINOR = 9
-  PATCH = 23 # this is automatically incremented by the build process
+  PATCH = 25 # 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.23
+  version: 0.9.25
 platform: ruby
 authors:
 - Leonid Medovyy
@@ -9,7 +9,7 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-07-18 00:00:00.000000000 Z
+date: 2025-07-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails