meta_workflows 0.9.19 → 0.9.21

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cf7568849f397d177f74890b1036e8a8f6ab845ff7f68b67f53641688637ad8b
-  data.tar.gz: da332e7bd731c441e4a80ffa53b5ba398edca8843d459cc11aa51af81de7caa6
+  metadata.gz: 5ece4bc1842d69733d2b951c9406fda3e83f070ca2f6603e97a826d8fd0cd87d
+  data.tar.gz: 8208fa70b0e19259a21eaad10aa915d111b4cdc4135c16d9bc7e7929186fa7c6
 SHA512:
-  metadata.gz: cfdca5467ebd4caa0872c2bde60cc7b7b800d7caabf78673711fb0480e7f297e583f276527f95598c017d097617aff4648db156226865f82b1791aa9f9c1d123
-  data.tar.gz: b68da4e79a390b42dc74952987f09822093424190d2373d87a0a49067a226ff04e55325db5d1c6f501f3fd8341c16fd7a85a9d4ef70041e8dbcb32aeb58f19bf
+  metadata.gz: be5e764d6188da7ea34398d3ab7649ee0c8bf3964deab167ee1c778b21ea2b3e8f4f86018bfdf2a3a6aea549f44187549ddc6803c76516c886c7f06184ba16d8
+  data.tar.gz: '028a513a4c38ea854f5f15798f3c6d8546653b94edf5bb41a14938f3dddf1c1ba6e40421956fd9f0a8c4e9982fea17879f53557911caefd1928012c72c36b97c'

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/concerns/meta_workflows/streamable.rb

@@ -17,9 +17,14 @@ module MetaWorkflows
 
       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 }
+        target: target_frame_id(record, streaming: true),
+        partial: meta_streaming_response,
+        locals: {
+          record: record,
+          show_loader: true,
+          step_progress: step_progress,
+          full_response: nil
+        }
       )
     end
 
@@ -27,22 +32,11 @@ module MetaWorkflows
     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 }
+      broadcast_streaming_response(
+        record: record,
+        full_response: nil,
+        show_loader: false,
+        show_error: true
       )
     end
 
@@ -66,5 +60,51 @@ module MetaWorkflows
         step_has_repetitions: current_step_has_repetitions?(workflow_execution)
       }
     end
+
+    # Builds chat history stream for instant user message display
+    def build_chat_history_stream(record:, workflow_execution:)
+      chat_history = workflow_execution.execution_chat_history
+
+      turbo_stream.replace(
+        target_frame_id(record, chat_history: true),
+        partial: meta_chat_history,
+        locals: {
+          record: record,
+          chat_history: chat_history,
+          current_user_messages: []
+        }
+      )
+    end
+
+    # Builds streaming response stream for loader display
+    def build_streaming_response_stream(record:, show_loader: false, step_progress: nil)
+      turbo_stream.replace(
+        target_frame_id(record, streaming: true),
+        partial: meta_streaming_response,
+        locals: {
+          record: record,
+          show_loader: show_loader,
+          step_progress: step_progress || default_step_progress,
+          full_response: nil
+        }
+      )
+    end
+
+    # Broadcasts streaming response to the streaming frame
+    def broadcast_streaming_response(record:, full_response: nil, show_loader: false,
+                                     show_error: false, error_message: nil)
+      Turbo::StreamsChannel.broadcast_replace_to(
+        turbo_stream_name(record),
+        target: target_frame_id(record, streaming: true),
+        partial: meta_streaming_response,
+        locals: {
+          record: record,
+          full_response: full_response,
+          show_loader: show_loader,
+          show_error: show_error,
+          error_message: error_message
+        }
+      )
+    end
   end
 end

data/app/controllers/meta_workflows/humans_controller.rb

@@ -2,19 +2,19 @@
 
 module MetaWorkflows
   class HumansController < MetaController
-    include MetaWorkflows::MetaWorkflowsHelper
-    include MetaWorkflows::Streamable
     before_action :set_workflow_data, only: [:update]
 
     def update
+      append_user_message_to_history(params[:message]) if params[:message].present?
+
       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?)
+        render_processing_state_stream
+        process_human_input(auto_advancing:, manual_advancing: params[:manual_advance].present?)
       else
-        render_response_form_stream
+        render_processing_state_stream
         process_human_input
       end
     end
@@ -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!
@@ -43,31 +44,5 @@ module MetaWorkflows
         }
       )
     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/controllers/meta_workflows/meta_controller.rb

@@ -3,6 +3,7 @@
 module MetaWorkflows
   class MetaController < MetaWorkflows::ApplicationController
     include MetaWorkflows::MetaWorkflowsHelper
+    include MetaWorkflows::Streamable
 
     def set_workflow_data
       @workflow_execution = MetaWorkflows::WorkflowExecution.includes(:record, :workflow,
@@ -21,5 +22,37 @@ module MetaWorkflows
     def current_step_repetitions
       @workflow_execution.step_repetitions(@workflow_execution.current_step)
     end
+
+    def append_user_message_to_history(user_message)
+      message_data = {
+        role: 'user',
+        content: user_message,
+        model_id: nil,
+        input_tokens: nil,
+        output_tokens: nil,
+        created_at: Time.current.iso8601,
+        step: @workflow_execution.current_step
+      }
+
+      # Ensure ExecutionChatHistory exists
+      chat_history = @workflow_execution.execution_chat_history ||
+                     @workflow_execution.create_execution_chat_history!
+
+      # Append the user message to the history
+      chat_history.append_message(message_data)
+    end
+
+    def render_processing_state_stream
+      respond_to do |format|
+        format.turbo_stream do
+          render turbo_stream: [
+            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])
+          ]
+        end
+      end
+    end
   end
 end

data/app/controllers/meta_workflows/structured_humans_controller.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+module MetaWorkflows
+  class StructuredHumansController < MetaController
+    before_action :set_workflow_data, only: [:update]
+
+    def update
+      formatted_input = extract_and_format_structured_input
+
+      append_user_message_to_history(formatted_input) if formatted_input.present?
+      render_processing_state_stream
+      process_structured_human_input(formatted_input)
+      @workflow_execution.increment_step
+    end
+
+    private
+
+    def process_structured_human_input(formatted_input)
+      MetaWorkflows::HumanInputJob.perform_later(
+        user_id: current_user.id,
+        record: @record,
+        auto_advancing: true,
+        manual_advancing: false,
+        params: {
+          inputs: formatted_input,
+          chat_id: params[:chat_id],
+          prompt_id: @prompt_id
+        }
+      )
+    end
+
+    def extract_and_format_structured_input
+      step_data = @workflow_execution.step_data(@workflow_execution.current_step)
+      structured_input_config = step_data&.dig('structured_input')
+
+      return params[:message].to_s unless structured_input_config
+
+      case structured_input_config['type']
+      when 'single_choice'
+        params[:single_choice_selection].to_s
+      when 'multiple_choice'
+        Array(params[:multiple_choice_selections]).join(', ')
+      when 'range'
+        params[:range_value].to_s
+      else
+        params[:message].to_s
+      end
+    end
+  end
+end

data/app/helpers/meta_workflows/application_helper.rb

@@ -3,5 +3,6 @@
 module MetaWorkflows
   module ApplicationHelper
     include MetaWorkflows::MetaWorkflowsHelper
+    include ::ApplicationHelper
   end
 end

data/app/helpers/meta_workflows/meta_workflows_helper.rb

@@ -2,11 +2,14 @@
 
 module MetaWorkflows
   module MetaWorkflowsHelper
-    def target_frame_id(record, form: nil, loader: nil)
+    def target_frame_id(record, **options)
       base_id = "#{record.class.name.downcase}_#{record.id}"
 
-      return "#{base_id}_loader" if loader
-      return "#{base_id}_form" if form
+      return "#{base_id}_loader" if options[:loader]
+      return "#{base_id}_form" if options[:form]
+      return "#{base_id}_structured_input" if options[:structured_input]
+      return "#{base_id}_chat_history" if options[:chat_history]
+      return "#{base_id}_streaming" if options[:streaming]
 
       base_id
     end
@@ -27,10 +30,22 @@ 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
 
+    def meta_chat_history
+      'meta_workflows/chat_history'
+    end
+
+    def meta_streaming_response
+      'meta_workflows/streaming_response'
+    end
+
     def meta_redirect
       'meta_workflows/redirect'
     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,35 +17,23 @@ module MetaWorkflows
 
     private
 
-    def broadcast_response(chat, full_response)
-      user_messages = chat.messages.where(role: 'user').order(:created_at)
-      messages = chat.messages.order(:created_at)
-      last_message = messages.last
-      is_streaming = full_response.present?
+    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
 
-      # Remove loader message
-      Turbo::StreamsChannel.broadcast_remove_to(
-        turbo_stream_name(record),
-        target: target_frame_id(record, loader: true)
+    def broadcast_response(full_response)
+      # Update streaming response frame with LLM content
+      broadcast_streaming_response(
+        record: record,
+        full_response: full_response,
+        show_loader: false,
+        show_error: false
       )
-
-      # Update main chat content
-      Turbo::StreamsChannel.broadcast_replace_to(turbo_stream_name(record),
-                                                 target: target_frame_id(record),
-                                                 locals: {
-                                                   record: record,
-                                                   chat: chat,
-                                                   full_response: full_response,
-                                                   user_messages: user_messages,
-                                                   messages: messages,
-                                                   last_message: last_message,
-                                                   is_streaming: is_streaming
-                                                 },
-                                                 partial: meta_response)
     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 +42,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
@@ -65,20 +65,23 @@ module MetaWorkflows
     def execute_llm_conversation(conversation)
       conversation.call_llm do |chunk|
         @full_response << (chunk.content || '')
-        broadcast_response(chat, full_response) unless auto_advancing
+        broadcast_response(full_response) unless auto_advancing
       end
     end
 
     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,7 +95,11 @@ module MetaWorkflows
       raise NotImplementedError
     end
 
-    def broadcast_response(chat, full_response)
+    def broadcast_structured_input(chat)
+      raise NotImplementedError
+    end
+
+    def broadcast_response(full_response)
       raise NotImplementedError
     end
 

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

@@ -0,0 +1,23 @@
+<%= turbo_frame_tag target_frame_id(record, chat_history: true) do %>
+  <div class="lexi-chat-history">
+    <!-- Show historical messages from ExecutionChatHistory -->
+    <% if local_assigns[:chat_history]&.history&.any? %>
+      <% local_assigns[:chat_history].history.each do |historical_message| %>
+        <% next if historical_message['role'] == 'system' %>
+        
+        <% if historical_message['role'] == 'user' %>
+          <%= render 'meta_workflows/user_message_bubble', content: historical_message['content'] %>
+        <% elsif historical_message['role'] == 'assistant' %>
+          <%= render 'meta_workflows/assistant_message_bubble', content: historical_message['content'] %>
+        <% end %>
+      <% end %>
+    <% end %>
+
+    <!-- Show current user messages (for instant display) -->
+    <% if local_assigns[:current_user_messages]&.any? %>
+      <% local_assigns[:current_user_messages].each do |user_message| %>
+        <%= render 'meta_workflows/user_message_bubble', content: user_message %>
+      <% end %>
+    <% end %>
+  </div>
+<% 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

@@ -30,19 +30,23 @@
       <div id="main-scroll-container" class="lexi-chat-alpha-messages">
         <%= render partial: meta_response, locals: {
           record: local_assigns[:record],
-          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,
+          chat_history: chat_history,
+          current_user_messages: [],
+          show_loader: false,
+          show_error: false,
+          step_progress: nil,
           full_response: nil,
-          is_streaming: false,
-          chat_history: chat_history
+          error_message: nil
         } %>
       </div>
 
       <%# 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/_lexi_chat_right_tray.html.erb

@@ -1,6 +1,7 @@
 <%# Lexi Chat Tray %>
 <% active_execution = local_assigns[:record]&.workflow_executions&.order(created_at: :desc)&.first %>
 <% active_chat = active_execution&.workflow_steps&.last&.chat %>
+<% chat_history = active_execution&.execution_chat_history %>
 
 <div class="lexi-chat-tray lexi-chat-container-full">
   <!-- Header with Lexi logo and action icons -->
@@ -22,12 +23,13 @@
   <div id="main-scroll-container" class="lexi-chat-messages">
     <%= render partial: meta_response, locals: {
       record: local_assigns[:record],
-      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,
+      chat_history: chat_history,
+      current_user_messages: [],
+      show_loader: false,
+      show_error: false,
+      step_progress: nil,
       full_response: nil,
-      is_streaming: false
+      error_message: nil
     } %>
   </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/_response_lexi.html.erb

@@ -1,49 +1,22 @@
 <%= turbo_frame_tag target_frame_id(record) do %>
 <div id="response-content-container" class="lexi-response-container" data-controller="response-scroll">
   
-  <!-- Show historical messages from ExecutionChatHistory -->
-  <% if local_assigns[:chat_history]&.history&.any? %>
-    <% local_assigns[:chat_history].history.each do |historical_message| %>
-      <% next if historical_message['role'] == 'system' %>
-      
-      <% if historical_message['role'] == 'user' %>
-        <%= render 'meta_workflows/user_message_bubble', content: historical_message['content'] %>
-      <% elsif historical_message['role'] == 'assistant' %>
-        <%= render 'meta_workflows/assistant_message_bubble', content: historical_message['content'] %>
-      <% end %>
-    <% end %>
-  <% end %>
+  <!-- Persistent Chat History Frame -->
+  <%= render partial: meta_chat_history, locals: {
+    record: record,
+    chat_history: local_assigns[:chat_history],
+    current_user_messages: local_assigns[:current_user_messages] || []
+  } %>
 
-  <% if chat.present? && chat.messages.any? %>
-    <!-- Show streaming response -->
-    <% if is_streaming %>
+  <!-- Streaming Response Frame -->
+  <%= render partial: meta_streaming_response, locals: {
+    record: record,
+    show_loader: local_assigns[:show_loader] || true,
+    show_error: local_assigns[:show_error] || false,
+    step_progress: local_assigns[:step_progress],
+    full_response: local_assigns[:full_response],
+    error_message: local_assigns[:error_message]
+  } %>
 
-      <!-- Show all saved messages except the first user message -->
-      <% messages.each_with_index do |message, index| %>
-        <% next if message.role == 'system' %>
-        <% next if message.role == 'user' && message == user_messages.first %>
-        <% next if is_streaming && message.role == 'assistant' && message == last_message %>
-        
-        <% if message.role == 'user' %>
-          <%= render 'meta_workflows/user_message_bubble', content: message.content %>
-        <% elsif message.role == 'assistant' %>
-          <%= render 'meta_workflows/assistant_message_bubble', content: message.content %>
-        <% end %>
-      <% end %>
-
-      <%= render 'meta_workflows/assistant_message_bubble', content: full_response %>
-    <% end %>
-  <% end %>
-
-  <div class="lexi-loader-container">
-    <%= turbo_frame_tag target_frame_id(record, loader: true) do %>
-      <% if chat.blank? || chat.messages.empty? %>
-        <%= render partial: meta_loader_message, locals: {
-          record: local_assigns[:record],
-          step_progress: default_step_progress
-        } %>
-      <% end %>
-    <% end %>
-  </div>
 </div>
 <% 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/_streaming_response.html.erb

@@ -0,0 +1,17 @@
+<%= turbo_frame_tag target_frame_id(record, streaming: true) do %>
+  <div class="lexi-streaming-response">
+    <% if local_assigns[:show_loader] %>
+      <!-- Show loader message -->
+      <%= render partial: meta_loader_message, locals: {
+        record: record,
+        step_progress: local_assigns[:step_progress] || default_step_progress
+      } %>
+    <% elsif local_assigns[:show_error] %>
+      <!-- Show error message -->
+      <%= render partial: meta_error_message, locals: { record: record } %>
+    <% elsif local_assigns[:full_response].present? %>
+      <!-- Show streaming LLM response -->
+      <%= render 'meta_workflows/assistant_message_bubble', content: local_assigns[:full_response] %>
+    <% end %>
+  </div>
+<% end %> 

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 = 21 # 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.21
 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-18 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,19 @@ 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/_chat_history.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/_streaming_response.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