meta_workflows 0.9.19 → 0.9.20

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cf7568849f397d177f74890b1036e8a8f6ab845ff7f68b67f53641688637ad8b
-  data.tar.gz: da332e7bd731c441e4a80ffa53b5ba398edca8843d459cc11aa51af81de7caa6
+  metadata.gz: 3b91afe608b3c5260eebee5a4cc1211621c85171cf2ddc3740f5c695bc6df73f
+  data.tar.gz: cbafaa30a15e992936bdbe66ec444fb15740bbac999c2137e11f67d26870eea0
 SHA512:
-  metadata.gz: cfdca5467ebd4caa0872c2bde60cc7b7b800d7caabf78673711fb0480e7f297e583f276527f95598c017d097617aff4648db156226865f82b1791aa9f9c1d123
-  data.tar.gz: b68da4e79a390b42dc74952987f09822093424190d2373d87a0a49067a226ff04e55325db5d1c6f501f3fd8341c16fd7a85a9d4ef70041e8dbcb32aeb58f19bf
+  metadata.gz: '0886296d806086437b57857c1e509ea76a6db6c784df7bee23ff54428220d819e94265083165a0e33a17715f9ab00a9f0efd0a553d365c21b5b68a93b7c56c4e'
+  data.tar.gz: 76b74c3f7508be1ee96547583adaf43a13f41c8af6ba74023fdcd3cafd0cd59c34ff535eeb2490ee4ba0c03c23c75bfb6ed248630d179938e9dedd724fd50add

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

@@ -0,0 +1,18 @@
+import { Controller } from '@hotwired/stimulus';
+
+export default class extends Controller {
+  static targets = ['form', 'radioInput', 'checkboxInput', 'sliderInput'];
+
+  connect() {
+    this.submitted = false;
+  }
+
+  handleSubmit() {
+    if (this.submitted) {
+      return;
+    }
+
+    this.submitted = true;
+    this.formTarget.requestSubmit();
+  }
+} 

data/app/assets/stylesheets/meta_workflows/application.css

@@ -824,3 +824,224 @@
 .lexi-error-content .lexi-loader-ellipses {
   margin-left: 0.375rem;
 }
+
+/* Structured Input Styles */
+.structured-input-container {
+  padding: 1rem;
+  background-color: rgba(255, 255, 255, 0.9);
+  border-radius: 0.75rem;
+  border: 1px solid var(--gray-300);
+  margin-bottom: 1rem;
+}
+
+.structured-input-options {
+  display: flex;
+  flex-direction: column;
+  gap: 0.75rem;
+}
+
+/* Radio Button Styles */
+.structured-radio-option {
+  display: flex;
+  align-items: center;
+  gap: 0.75rem;
+  padding: 0.75rem 1rem;
+  border: 1px solid var(--gray-300);
+  border-radius: 0.5rem;
+  background-color: white;
+  cursor: pointer;
+  transition: all 0.2s ease;
+}
+
+.structured-radio-option:hover {
+  background-color: var(--gray-50);
+  border-color: var(--purple-300);
+}
+
+.structured-radio-option:has(.structured-radio-input:checked) {
+  background-color: var(--purple-50);
+  border-color: var(--purple-500);
+}
+
+.structured-radio-input {
+  width: 1.25rem;
+  height: 1.25rem;
+  accent-color: var(--purple-600);
+  cursor: pointer;
+}
+
+.structured-radio-label {
+  font-size: 1rem;
+  font-weight: 500;
+  color: var(--gray-800);
+  cursor: pointer;
+  flex: 1;
+}
+
+/* Checkbox Styles */
+.structured-checkbox-option {
+  display: flex;
+  align-items: center;
+  gap: 0.75rem;
+  padding: 0.75rem 1rem;
+  border: 1px solid var(--gray-300);
+  border-radius: 0.5rem;
+  background-color: white;
+  cursor: pointer;
+  transition: all 0.2s ease;
+}
+
+.structured-checkbox-option:hover {
+  background-color: var(--gray-50);
+  border-color: var(--purple-300);
+}
+
+.structured-checkbox-option:has(.structured-checkbox-input:checked) {
+  background-color: var(--purple-50);
+  border-color: var(--purple-500);
+}
+
+.structured-checkbox-input {
+  width: 1.25rem;
+  height: 1.25rem;
+  accent-color: var(--purple-600);
+  cursor: pointer;
+}
+
+.structured-checkbox-label {
+  font-size: 1rem;
+  font-weight: 500;
+  color: var(--gray-800);
+  cursor: pointer;
+  flex: 1;
+}
+
+/* Slider Styles */
+.structured-slider-container {
+  padding: 1rem;
+}
+
+.structured-slider-labels {
+  display: flex;
+  justify-content: space-between;
+  margin-bottom: 1rem;
+  font-size: 0.875rem;
+  color: var(--gray-600);
+  font-weight: 500;
+}
+
+.structured-slider-wrapper {
+  display: flex;
+  flex-direction: column;
+  gap: 0.5rem;
+}
+
+.structured-slider-input {
+  width: 100%;
+  height: 0.5rem;
+  border-radius: 0.25rem;
+  background: var(--gray-200);
+  outline: none;
+  -webkit-appearance: none;
+  appearance: none;
+  cursor: pointer;
+}
+
+.structured-slider-input::-webkit-slider-thumb {
+  -webkit-appearance: none;
+  appearance: none;
+  width: 1.5rem;
+  height: 1.5rem;
+  border-radius: 50%;
+  background: var(--purple-600);
+  cursor: pointer;
+  border: 2px solid white;
+  box-shadow: 0 2px 4px rgba(0, 0, 0, 0.2);
+  transition: all 0.2s ease;
+}
+
+.structured-slider-input::-webkit-slider-thumb:hover {
+  background: var(--purple-700);
+  transform: scale(1.1);
+}
+
+.structured-slider-input::-moz-range-thumb {
+  width: 1.5rem;
+  height: 1.5rem;
+  border-radius: 50%;
+  background: var(--purple-600);
+  cursor: pointer;
+  border: 2px solid white;
+  box-shadow: 0 2px 4px rgba(0, 0, 0, 0.2);
+  transition: all 0.2s ease;
+}
+
+.structured-slider-input::-moz-range-thumb:hover {
+  background: var(--purple-700);
+  transform: scale(1.1);
+}
+
+.structured-slider-value {
+  text-align: center;
+  font-size: 1.125rem;
+  font-weight: 600;
+  color: var(--purple-700);
+  padding: 0.5rem;
+  background-color: var(--purple-50);
+  border-radius: 0.375rem;
+  border: 1px solid var(--purple-200);
+}
+
+/* Structured Input Submit Button */
+.structured-submit-button {
+  width: 3rem;
+  height: 3rem;
+  border-radius: 50%;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  background-color: var(--purple-600);
+  color: white;
+  transition: all 0.2s;
+  border: none;
+  cursor: pointer;
+  margin-top: 1rem;
+  align-self: flex-end;
+}
+
+.structured-submit-button:hover {
+  background-color: var(--purple-700);
+  transform: scale(1.05);
+}
+
+.structured-submit-button:disabled {
+  background-color: var(--gray-400);
+  cursor: not-allowed;
+  transform: none;
+}
+
+/* Structured Input Validation Styles */
+.structured-input-container[data-invalid="true"] {
+  border-color: var(--red-500);
+  background-color: var(--red-50);
+}
+
+.structured-input-error {
+  color: var(--red-600);
+  font-size: 0.875rem;
+  margin-top: 0.5rem;
+  font-weight: 500;
+}
+
+/* Screen reader only class for accessibility */
+.sr-only {
+  position: absolute;
+  width: 1px;
+  height: 1px;
+  padding: 0;
+  margin: -1px;
+  overflow: hidden;
+  clip: rect(0, 0, 0, 0);
+  white-space: nowrap;
+  border: 0;
+}

data/app/controllers/meta_workflows/humans_controller.rb

@@ -9,10 +9,10 @@ module MetaWorkflows
     def update
       auto_advancing = should_auto_advance?
 
-      if params[:advance].present? || auto_advancing
+      if params[:manual_advance].present? || auto_advancing
         @workflow_execution.increment_step
         render_loader_stream
-        process_human_input(auto_advancing:, manual_advancing: params[:advance].present?)
+        process_human_input(auto_advancing:, manual_advancing: params[:manual_advance].present?)
       else
         render_response_form_stream
         process_human_input
@@ -23,6 +23,7 @@ module MetaWorkflows
 
     def should_auto_advance?
       step_repetitions = current_step_repetitions
+      return true if params[:auto_advance].present?
       return false unless step_repetitions
 
       new_repetition = @workflow_step.increment_repetition!

data/app/controllers/meta_workflows/structured_humans_controller.rb

@@ -0,0 +1,74 @@
+# frozen_string_literal: true
+
+module MetaWorkflows
+  class StructuredHumansController < MetaController
+    include MetaWorkflows::MetaWorkflowsHelper
+    include MetaWorkflows::Streamable
+    before_action :set_workflow_data, only: [:update]
+
+    def update
+      render_loader_stream
+      process_structured_human_input
+      @workflow_execution.increment_step
+    end
+
+    private
+
+    def process_structured_human_input
+      MetaWorkflows::HumanInputJob.perform_later(
+        user_id: current_user.id,
+        record: @record,
+        auto_advancing: true,
+        manual_advancing: false,
+        params: {
+          inputs: extract_structured_inputs,
+          chat_id: params[:chat_id],
+          prompt_id: @prompt_id
+        }
+      )
+    end
+
+    def extract_structured_inputs
+      step_data = @workflow_execution.step_data(@workflow_execution.current_step)
+      structured_input_config = step_data&.dig('structured_input')
+      return params[:message] unless structured_input_config
+
+      case structured_input_config['type']
+      when 'single_choice'
+        params[:single_choice_selection]
+      when 'multiple_choice'
+        params[:multiple_choice_selections]
+      when 'range'
+        params[:range_value]
+      else
+        params[:message]
+      end
+    end
+
+    def render_loader_stream
+      respond_to do |format|
+        format.turbo_stream do
+          render turbo_stream: [
+            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
+    end
+
+    def render_response_form_stream
+      respond_to do |format|
+        format.turbo_stream do
+          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
+  end
+end

data/app/helpers/meta_workflows/meta_workflows_helper.rb

@@ -2,11 +2,12 @@
 
 module MetaWorkflows
   module MetaWorkflowsHelper
-    def target_frame_id(record, form: nil, loader: nil)
+    def target_frame_id(record, form: nil, loader: nil, structured_input: nil)
       base_id = "#{record.class.name.downcase}_#{record.id}"
 
       return "#{base_id}_loader" if loader
       return "#{base_id}_form" if form
+      return "#{base_id}_structured_input" if structured_input
 
       base_id
     end
@@ -27,6 +28,10 @@ module MetaWorkflows
       'meta_workflows/response_form_lexi'
     end
 
+    def meta_structured_input
+      'meta_workflows/structured_input'
+    end
+
     def meta_response
       'meta_workflows/response_lexi'
     end

data/app/jobs/meta_workflows/human_input_job.rb

@@ -5,8 +5,11 @@ module MetaWorkflows
     include MetaWorkflows::MetaWorkflowsHelper
     queue_as :default
 
+    attr_accessor :current_step_data, :structured_input_config, :is_structured_input
+
     def perform(user_id:, record:, params:, auto_advancing: false, manual_advancing: false)
       setup(user_id, record, auto_advancing, manual_advancing)
+      set_workflow_step_variables
       conversation = initialize_conversation(params)
       process_and_broadcast(conversation) unless manual_advancing
       advance_workflow(params) if advancing?
@@ -14,6 +17,12 @@ module MetaWorkflows
 
     private
 
+    def set_workflow_step_variables
+      @current_step_data = workflow_execution&.step_data(workflow_execution.current_step)
+      @structured_input_config = current_step_data&.dig('structured_input')
+      @is_structured_input = structured_input_config.present? && current_step_data&.dig('action') == 'structured_human'
+    end
+
     def broadcast_response(chat, full_response)
       user_messages = chat.messages.where(role: 'user').order(:created_at)
       messages = chat.messages.order(:created_at)
@@ -42,7 +51,6 @@ module MetaWorkflows
     end
 
     def broadcast_form(chat)
-      workflow_execution = active_workflow_execution
       Turbo::StreamsChannel.broadcast_replace_to(
         turbo_stream_name(record),
         target: target_frame_id(record, form: true),
@@ -51,7 +59,22 @@ module MetaWorkflows
                   workflow_execution_id: workflow_execution&.id,
                   response_enabled: true,
                   chat_id: chat.id,
-                  step_has_repetitions: current_step_has_repetitions?(workflow_execution) }
+                  step_has_repetitions: current_step_has_repetitions?(workflow_execution),
+                  is_structured_input: is_structured_input }
+      )
+    end
+
+    def broadcast_structured_input(chat)
+      Turbo::StreamsChannel.broadcast_replace_to(
+        turbo_stream_name(record),
+        target: target_frame_id(record, structured_input: true),
+        partial: meta_structured_input,
+        locals: {
+          record: record,
+          chat_id: chat.id,
+          structured_input_config: structured_input_config,
+          is_structured_input: is_structured_input
+        }
       )
     end
 

data/app/jobs/meta_workflows/meta_job.rb

@@ -5,7 +5,8 @@ module MetaWorkflows
     include MetaWorkflows::Concerns::ErrorHandling
     include MetaWorkflows::Streamable
 
-    attr_accessor :chat, :inputs, :full_response, :user_id, :record, :auto_advancing, :manual_advancing
+    attr_accessor :chat, :inputs, :full_response, :user_id, :record, :auto_advancing, :manual_advancing,
+                  :workflow_execution
 
     private
 
@@ -15,6 +16,7 @@ module MetaWorkflows
       @full_response = +''
       @auto_advancing = auto_advancing
       @manual_advancing = manual_advancing
+      @workflow_execution = active_workflow_execution
     end
 
     def initialize_conversation(params)
@@ -28,7 +30,6 @@ module MetaWorkflows
     def initialize_new_conversation(params)
       inputs = params.symbolize_keys[:inputs]
 
-      workflow_execution = active_workflow_execution
       current_step = workflow_execution.workflow_steps&.find_by(step: workflow_execution.current_step)
       @chat = current_step&.chat
 
@@ -45,7 +46,6 @@ module MetaWorkflows
     end
 
     def process_and_broadcast(conversation)
-      workflow_execution = active_workflow_execution
       workflow_step = current_workflow_step(workflow_execution)
 
       begin
@@ -72,13 +72,16 @@ module MetaWorkflows
     def finalize_conversation(conversation)
       chat.update!(conversation_id: conversation.id) if chat.conversation_id.blank?
       persist_messages_to_history
-      broadcast_form(chat) unless auto_advancing
+      return if auto_advancing
+
+      broadcast_form(chat)
+      broadcast_structured_input(chat)
     end
 
     def persist_messages_to_history
       MetaWorkflows::MessageHistoryService.new(
         chat: chat,
-        workflow_execution: active_workflow_execution
+        workflow_execution: workflow_execution
       ).persist_messages_to_history
     end
 
@@ -92,6 +95,10 @@ module MetaWorkflows
       raise NotImplementedError
     end
 
+    def broadcast_structured_input(chat)
+      raise NotImplementedError
+    end
+
     def broadcast_response(chat, full_response)
       raise NotImplementedError
     end

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

@@ -0,0 +1,24 @@
+<div class="structured-input-container" 
+     role="group" 
+     aria-labelledby="structured-checkbox-legend">
+  <legend id="structured-checkbox-legend" class="sr-only">Select one or more options</legend>
+  <div class="structured-input-options">
+    <% options.each_with_index do |option, index| %>
+      <div class="structured-checkbox-option">
+        <input 
+          type="checkbox" 
+          id="multiple_choice_<%= index %>" 
+          name="multiple_choice_selections[]" 
+          value="<%= option['value'] %>" 
+          class="structured-checkbox-input"
+          data-action="change->meta-workflows--structured-form-submit#handleSubmit"
+          aria-describedby="structured-checkbox-help"
+        >
+        <label for="multiple_choice_<%= index %>" class="structured-checkbox-label">
+          <%= option['label'] %>
+        </label>
+      </div>
+    <% end %>
+  </div>
+  <div id="structured-checkbox-help" class="sr-only">Use space to select/deselect options</div>
+</div> 

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

@@ -43,6 +43,10 @@
       <%# Input area (fixed at bottom) %>
       <div class="lexi-chat-alpha-input-area">
         <div class="lexi-chat-alpha-input-container">
+          <!-- Structured Input (always rendered, conditionally displays content) -->
+          <%= 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 } %>
         </div>
       </div>

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

@@ -0,0 +1,26 @@
+<div class="structured-input-container" 
+     role="radiogroup" 
+     aria-labelledby="structured-radio-legend"
+     aria-required="true">
+  <legend id="structured-radio-legend" class="sr-only">Select one option</legend>
+  <div class="structured-input-options">
+    <% options.each_with_index do |option, index| %>
+      <div class="structured-radio-option">
+        <input 
+          type="radio" 
+          id="single_choice_<%= index %>" 
+          name="single_choice_selection" 
+          value="<%= option['value'] %>" 
+          class="structured-radio-input"
+          data-action="change->meta-workflows--structured-form-submit#handleSubmit"
+          aria-describedby="structured-radio-help"
+          required
+        >
+        <label for="single_choice_<%= index %>" class="structured-radio-label">
+          <%= option['label'] %>
+        </label>
+      </div>
+    <% end %>
+  </div>
+  <div id="structured-radio-help" class="sr-only">Use arrow keys to navigate between options</div>
+</div> 

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

@@ -1,44 +1,47 @@
 <%= turbo_frame_tag target_frame_id(record, form: true) do %>
     <div>
-      <%= form_with url: (workflow_execution_id.present? ? meta_workflows.human_path(workflow_execution_id) : "#"),
+      <%= 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: { controller: "meta-workflows--lexi-form-submit", "meta-workflows--lexi-form-submit-target": "form" } 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">
-                 <!-- Input area with icons -->
-                <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" } %>
-                </div>
+              <!-- 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" } %>
+              </div>
 
-               <div class="lexi-input-controls">
-               <div class="lexi-input-icons">
-                   <button type="button" class="lexi-icon-button" disabled>
-                     <i class="fa-solid fa-microphone text-lg"></i>
-                   </button>
-                   <button type="button" class="lexi-icon-button" disabled>
-                     <i class="fa-solid fa-headphones text-lg"></i>
-                   </button>
-                   <button type="button" class="lexi-icon-button" disabled>
-                     <i class="fa-solid fa-waveform-lines text-lg"></i>
-                   </button>
-                 </div>
-                 <div>
-                 <!-- Send button -->
-                 <% if local_assigns[:responding] %>
-                   <button type="button" class="lexi-send-button responding" disabled>
-                     <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 %>
-                     <i class="fa-solid fa-arrow-up text-lg"></i>
-                   <% end %>
-                <% end %>
-                 </div>
-               </div>
+              <div class="lexi-input-controls">
+                <div class="lexi-input-icons">
+                  <button type="button" class="lexi-icon-button" disabled>
+                    <i class="fa-solid fa-microphone text-lg"></i>
+                  </button>
+                  <button type="button" class="lexi-icon-button" disabled>
+                    <i class="fa-solid fa-headphones text-lg"></i>
+                  </button>
+                  <button type="button" class="lexi-icon-button" disabled>
+                    <i class="fa-solid fa-waveform-lines text-lg"></i>
+                  </button>
+                </div>
+                <div>
+                  <!-- Send button -->
+                  <% if local_assigns[:responding] %>
+                    <button type="button" class="lexi-send-button responding" disabled>
+                      <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 %>
+                      <i class="fa-solid fa-arrow-up text-lg"></i>
+                    <% end %>
+                  <% end %>
+                </div>
+              </div>
             </div>
 
             <p class="lexi-recording-notice">This chat is being recorded.</p>
@@ -48,7 +51,7 @@
                 <!-- Empty placeholder to prevent layout jank -->
                 <div aria-hidden="true"></div>
               <% else %>
-                <%= form.button type: "submit", name: "advance", value: "true", class: "lexi-advance-button #{'opacity-50 cursor-not-allowed' if local_assigns[:responding]}", disabled: local_assigns[:responding] do %>
+                <%= 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 %>
                   <i class="fa-light fa-arrow-right"></i> Next
                 <% end %>
               <% end %>

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

@@ -0,0 +1,60 @@
+<div class="structured-input-container" 
+     role="group" 
+     aria-labelledby="structured-slider-legend">
+  <legend id="structured-slider-legend" class="sr-only">Select a value using the slider</legend>
+  <div class="structured-slider-container">
+    <div class="structured-slider-labels">
+      <span class="structured-slider-label-min"><%= options['min']['label'] %></span>
+      <span class="structured-slider-label-max"><%= options['max']['label'] %></span>
+    </div>
+    
+    <div class="structured-slider-wrapper">
+      <input 
+        type="range" 
+        id="range_value" 
+        name="range_value" 
+        min="<%= options['min']['value'] %>" 
+        max="<%= options['max']['value'] %>" 
+        step="<%= options['increment'] %>" 
+        value="<%= options['min']['value'] %>"
+        class="structured-slider-input"
+        data-action="change->meta-workflows--structured-form-submit#handleSubmit"
+        aria-describedby="structured-slider-help structured-slider-value-display"
+        aria-valuemin="<%= options['min']['value'] %>"
+        aria-valuemax="<%= options['max']['value'] %>"
+        aria-valuenow="<%= options['min']['value'] %>"
+        aria-valuetext="<%= options['min']['value'] %>"
+        required
+      >
+    </div>
+    
+    <div class="structured-slider-value">
+      <span class="structured-slider-current-value" 
+            id="structured-slider-value-display"
+            data-range-display="<%= options['min']['value'] %>"
+            aria-live="polite">
+        <%= options['min']['value'] %>
+      </span>
+    </div>
+    <div id="structured-slider-help" class="sr-only">Use arrow keys to adjust the value</div>
+  </div>
+</div>
+
+<script>
+  // Update the displayed value when slider changes
+  document.addEventListener('DOMContentLoaded', function() {
+    const slider = document.getElementById('range_value');
+    const valueDisplay = document.querySelector('.structured-slider-current-value');
+    
+    if (slider && valueDisplay) {
+      slider.addEventListener('input', function() {
+        valueDisplay.textContent = this.value;
+        valueDisplay.setAttribute('data-range-display', this.value);
+        
+        // Update ARIA attributes for accessibility
+        slider.setAttribute('aria-valuenow', this.value);
+        slider.setAttribute('aria-valuetext', this.value);
+      });
+    }
+  });
+</script> 

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

@@ -0,0 +1,28 @@
+<%= turbo_frame_tag target_frame_id(record, structured_input: true) do %>
+  <% if local_assigns[:is_structured_input] && structured_input_config.present? %>
+    <%
+      # Get workflow execution for form submission
+      workflow_execution = record.workflow_executions.order(created_at: :desc).first
+      form_url = workflow_execution ? meta_workflows.structured_human_path(workflow_execution.id) : "#"
+      chat_id = local_assigns[:chat_id] || workflow_execution&.workflow_steps&.last&.chat&.id
+    %>
+    
+    <%= form_with url: form_url,
+                  method: :patch,
+                  id: "#{target_frame_id(record, structured_input: true)}_form",
+                  data: { controller: "meta-workflows--structured-form-submit", "meta-workflows--structured-form-submit-target": "form" } do |form| %>
+      <%= form.hidden_field :chat_id, value: chat_id %>
+      
+      <div class="structured-input-wrapper">
+        <% case structured_input_config['type'] %>
+        <% when 'single_choice' %>
+          <%= render 'meta_workflows/radio_input', options: structured_input_config['options'] %>
+        <% when 'multiple_choice' %>
+          <%= render 'meta_workflows/checkbox_input', options: structured_input_config['options'] %>
+        <% when 'range' %>
+          <%= render 'meta_workflows/slider_input', options: structured_input_config['options'] %>
+        <% end %>
+      </div>
+    <% end %>
+  <% end %>
+<% end %> 

data/config/routes.rb

@@ -2,6 +2,7 @@
 
 MetaWorkflows::Engine.routes.draw do
   resources :humans, only: [:update]
+  resources :structured_humans, only: [:update]
 
   # Workflow imports - RESTful routes
   resources :workflow_imports, only: %i[new create], path: 'workflow_imports' do

data/lib/meta_workflows/version.rb

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

@@ -45,6 +45,8 @@ module Services
           process_agent_action(conversation, workflow_execution, workflow)
         when 'human'
           process_human_action(execution_step, workflow_execution)
+        when 'structured_human'
+          process_structured_human_action(execution_step, workflow_execution)
         when 'record_redirect'
           process_record_redirect_action(workflow_execution)
         when 'collection_create'
@@ -133,6 +135,18 @@ module Services
         # the step advancement is handled in the human input job
       end
 
+      def process_structured_human_action(execution_step, workflow_execution)
+        ::MetaWorkflows::HumanInputJob.perform_later(
+          user_id: user&.id,
+          record: workflow_execution.record,
+          params: {
+            inputs: inputs,
+            prompt_id: execution_step['prompt_id']
+          }
+        )
+        # the step advancement is handled in the human input job
+      end
+
       def process_record_redirect_action(workflow_execution)
         ::MetaWorkflows::RecordRedirectJob.perform_later(workflow_execution: workflow_execution)
         workflow_execution.increment_step

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: meta_workflows
 version: !ruby/object:Gem::Version
-  version: 0.9.19
+  version: 0.9.20
 platform: ruby
 authors:
 - Leonid Medovyy
@@ -9,7 +9,7 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-07-14 00:00:00.000000000 Z
+date: 2025-07-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -125,6 +125,7 @@ files:
 - app/assets/javascripts/meta_workflows/controllers/onboarding_controller.js
 - app/assets/javascripts/meta_workflows/controllers/redirect_controller.js
 - app/assets/javascripts/meta_workflows/controllers/response_scroll_controller.js
+- app/assets/javascripts/meta_workflows/controllers/structured_form_submit_controller.js
 - app/assets/javascripts/meta_workflows/controllers/tray_controller.js
 - app/assets/javascripts/meta_workflows_manifest.js
 - app/assets/stylesheets/meta_workflows/application.css
@@ -135,6 +136,7 @@ files:
 - app/controllers/meta_workflows/debug_controller.rb
 - app/controllers/meta_workflows/humans_controller.rb
 - app/controllers/meta_workflows/meta_controller.rb
+- app/controllers/meta_workflows/structured_humans_controller.rb
 - app/controllers/meta_workflows/workflow_imports_controller.rb
 - app/helpers/meta_workflows/application_helper.rb
 - app/helpers/meta_workflows/debug_helper.rb
@@ -166,13 +168,17 @@ files:
 - app/sidekiq/meta_workflows/tools/meta_workflow_tool.rb
 - app/views/layouts/meta_workflows/application.html.erb
 - app/views/meta_workflows/_assistant_message_bubble.html.erb
+- app/views/meta_workflows/_checkbox_input.html.erb
 - app/views/meta_workflows/_error_message.html.erb
 - app/views/meta_workflows/_lexi_chat_alpha_tray.html.erb
 - app/views/meta_workflows/_lexi_chat_right_tray.html.erb
 - app/views/meta_workflows/_loader_message.html.erb
+- app/views/meta_workflows/_radio_input.html.erb
 - app/views/meta_workflows/_redirect.html.erb
 - app/views/meta_workflows/_response_form_lexi.html.erb
 - app/views/meta_workflows/_response_lexi.html.erb
+- app/views/meta_workflows/_slider_input.html.erb
+- app/views/meta_workflows/_structured_input.html.erb
 - app/views/meta_workflows/_user_message_bubble.html.erb
 - app/views/meta_workflows/debug/executions.html.erb
 - app/views/meta_workflows/debug/show_execution.html.erb