meta_workflows 0.9.18 → 0.9.20

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f70452cae76da68d70cc4e7b0f5c311ca8d287aac2526983fcee42e5cdb6555a
-  data.tar.gz: 47d7637b8ec224c160b62ac55f363b07515d1e6d6a43350dc4127afb0839f32e
+  metadata.gz: 3b91afe608b3c5260eebee5a4cc1211621c85171cf2ddc3740f5c695bc6df73f
+  data.tar.gz: cbafaa30a15e992936bdbe66ec444fb15740bbac999c2137e11f67d26870eea0
 SHA512:
-  metadata.gz: 3b4bce3cecda4fa622ecc808fd5293f47e321c29bcd6ba1afb4b06f0aad1766307459275bb5bfaa89a03f0fd47f0dcc15cd55acbef3f33cfc8d42c7aa0690694
-  data.tar.gz: a1881bb94b04d89dba925e60d1915a16db2b32f0fd28a60bb1fa1517743e52be625bbbb7a32e69c7c264e95235b3b4848cf151dccf27aa7c0a8ac5e1f3574f76
+  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/concerns/error_handling.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module MetaWorkflows
+  module Concerns
+    module ErrorHandling
+      extend ActiveSupport::Concern
+
+      private
+
+      def handle_llm_error(error, workflow_step, workflow_execution, conversation)
+        log_error(error)
+        store_error_in_workflow_step(error, workflow_step, conversation)
+        broadcast_error_response(workflow_execution)
+      end
+
+      def log_error(error)
+        Rails.logger.error("LLM Error in MetaJob: #{error.message}")
+        Rails.logger.error(error.backtrace.join("\n"))
+      end
+
+      def store_error_in_workflow_step(error, workflow_step, conversation)
+        workflow_step&.record_error(error, additional_details: {
+                                      job_class: self.class.name,
+                                      chat_id: chat&.id,
+                                      conversation_id: conversation&.id,
+                                      full_response_length: full_response&.length || 0
+                                    })
+      end
+    end
+  end
+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

@@ -2,9 +2,11 @@
 
 module MetaWorkflows
   class MetaJob < MetaWorkflows::ApplicationJob
+    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
 
@@ -14,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)
@@ -27,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
 
@@ -44,7 +46,6 @@ module MetaWorkflows
     end
 
     def process_and_broadcast(conversation)
-      workflow_execution = active_workflow_execution
       workflow_step = current_workflow_step(workflow_execution)
 
       begin
@@ -70,27 +71,18 @@ module MetaWorkflows
 
     def finalize_conversation(conversation)
       chat.update!(conversation_id: conversation.id) if chat.conversation_id.blank?
-      broadcast_form(chat) unless auto_advancing
-    end
-
-    def handle_llm_error(error, workflow_step, workflow_execution, conversation)
-      log_error(error)
-      store_error_in_workflow_step(error, workflow_step, conversation)
-      broadcast_error_response(workflow_execution)
-    end
+      persist_messages_to_history
+      return if auto_advancing
 
-    def log_error(error)
-      Rails.logger.error("LLM Error in MetaJob: #{error.message}")
-      Rails.logger.error(error.backtrace.join("\n"))
+      broadcast_form(chat)
+      broadcast_structured_input(chat)
     end
 
-    def store_error_in_workflow_step(error, workflow_step, conversation)
-      workflow_step&.record_error(error, additional_details: {
-                                    job_class: self.class.name,
-                                    chat_id: chat&.id,
-                                    conversation_id: conversation&.id,
-                                    full_response_length: full_response&.length || 0
-                                  })
+    def persist_messages_to_history
+      MetaWorkflows::MessageHistoryService.new(
+        chat: chat,
+        workflow_execution: workflow_execution
+      ).persist_messages_to_history
     end
 
     def current_workflow_step(workflow_execution)
@@ -103,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/models/meta_workflows/execution_chat_history.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module MetaWorkflows
+  class ExecutionChatHistory < ApplicationRecord
+    belongs_to :workflow_execution, class_name: 'MetaWorkflows::WorkflowExecution'
+
+    def append_message(message_data)
+      update!(history: history + [message_data])
+    end
+
+    def clear_history
+      update!(history: [])
+    end
+
+    def message_count
+      history.length
+    end
+
+    def last_message
+      history.last
+    end
+  end
+end

data/app/models/meta_workflows/workflow_execution.rb

@@ -7,6 +7,7 @@ module MetaWorkflows
     belongs_to :workflow, class_name: 'MetaWorkflows::Workflow'
     belongs_to :record, polymorphic: true
     has_many :workflow_steps, dependent: :destroy, class_name: 'MetaWorkflows::WorkflowStep'
+    has_one :execution_chat_history, dependent: :destroy, class_name: 'MetaWorkflows::ExecutionChatHistory'
 
     # Default values for fields
     attribute :current_step, :integer, default: 0

data/app/services/meta_workflows/message_history_service.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+module MetaWorkflows
+  class MessageHistoryService < MetaWorkflows::ApplicationService
+    def initialize(chat:, workflow_execution:)
+      super()
+      @chat = chat
+      @workflow_execution = workflow_execution
+    end
+
+    def persist_messages_to_history
+      # Ensure ExecutionChatHistory exists
+      chat_history = workflow_execution.execution_chat_history ||
+                     workflow_execution.create_execution_chat_history!
+
+      # Get all messages from the current chat (minus the first message since that is the system message)
+      messages = chat.messages.order(:created_at)[1..]
+
+      # Convert messages to a format suitable for persistence
+      messages.each do |message|
+        message_data = {
+          role: message.role,
+          content: message.content,
+          model_id: message.model_id,
+          input_tokens: message.input_tokens,
+          output_tokens: message.output_tokens,
+          created_at: message.created_at.iso8601,
+          step: workflow_execution.current_step
+        }
+
+        # Only append if not already in history (to avoid duplicates)
+        unless chat_history.history.any? { |h| h['content'] == message.content && h['role'] == message.role }
+          chat_history.append_message(message_data)
+        end
+      end
+    end
+
+    private
+
+    attr_reader :chat, :workflow_execution
+  end
+end

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

@@ -0,0 +1,9 @@
+<!-- Lexi message bubble (left-aligned, white background) -->
+<div class="lexi-message-assistant">
+  <!-- Message Bubble -->
+  <div class="lexi-message-bubble-assistant">
+    <div class="lexi-message-content-assistant">
+      <%= markdown(content) %>
+    </div>
+  </div>
+</div> 

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

@@ -1,6 +1,7 @@
 <%# Lexi Chat Alpha Tray (Center Display) %>
 <% 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-alpha-tray">
   <%# Header with Lexi logo left and close button right %>
@@ -34,13 +35,18 @@
           user_messages: active_chat&.messages&.where(role: 'user')&.order(:created_at) || [],
           last_message: active_chat&.messages&.last,
           full_response: nil,
-          is_streaming: false
+          is_streaming: false,
+          chat_history: chat_history
         } %>
       </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/_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,46 +1,37 @@
 <%= turbo_frame_tag target_frame_id(record) do %>
 <div id="response-content-container" class="lexi-response-container" data-controller="response-scroll">
-  <% if chat.present? && chat.messages.any? %>
-    
-    <!-- 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 %>
+  
+  <!-- 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 message.role == 'user' %>
-        <!-- User message bubble (right-aligned, purple background) -->
-        <div class="lexi-message-user">
-          <div class="lexi-message-bubble-user">
-            <div class="lexi-message-content-user">
-              <%= simple_format(message.content) %>
-            </div>
-          </div>
-        </div>
-        
-      <% elsif message.role == 'assistant' %>
-        <!-- Lexi message bubble (left-aligned, white background) -->
-        <div class="lexi-message-assistant">
-          <!-- Message Bubble -->
-          <div class="lexi-message-bubble-assistant">
-            <div class="lexi-message-content-assistant">
-              <%= markdown(message.content) %>
-            </div>
-          </div>
-        </div>
+      <% 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 %>
+
+  <% if chat.present? && chat.messages.any? %>
     <!-- Show streaming response -->
     <% if is_streaming %>
-      <div class="lexi-message-assistant">
-        <!-- Streaming Message Bubble -->
-        <div class="lexi-message-bubble-assistant">
-          <div class="lexi-message-content-assistant">
-            <%= markdown(full_response) %>
-          </div>
-        </div>
-      </div>
+
+      <!-- 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 %>
 

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/app/views/meta_workflows/_user_message_bubble.html.erb

@@ -0,0 +1,8 @@
+<!-- User message bubble (right-aligned, purple background) -->
+<div class="lexi-message-user">
+  <div class="lexi-message-bubble-user">
+    <div class="lexi-message-content-user">
+      <%= simple_format(content) %>
+    </div>
+  </div>
+</div> 

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/db/migrate/20250714192853_create_meta_workflows_execution_chat_histories.rb

@@ -0,0 +1,12 @@
+class CreateMetaWorkflowsExecutionChatHistories < ActiveRecord::Migration[7.2]
+  def change
+    create_table :meta_workflows_execution_chat_histories do |t|
+      t.references :workflow_execution, null: false, foreign_key: { to_table: :meta_workflows_workflow_executions }
+      t.jsonb :history, null: false, default: []
+
+      t.timestamps
+    end
+    
+    add_index :meta_workflows_execution_chat_histories, :workflow_execution_id, unique: true, name: 'index_execution_chat_histories_on_workflow_execution_id'
+  end
+end

data/lib/meta_workflows/version.rb

@@ -3,7 +3,7 @@
 module MetaWorkflows
   MAJOR = 0
   MINOR = 9
-  PATCH = 18 # 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.18
+  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
@@ -143,6 +145,7 @@ files:
 - app/helpers/meta_workflows/meta_workflows_helper.rb
 - app/helpers/meta_workflows/status_badge_helper.rb
 - app/jobs/meta_workflows/application_job.rb
+- app/jobs/meta_workflows/concerns/error_handling.rb
 - app/jobs/meta_workflows/human_input_job.rb
 - app/jobs/meta_workflows/meta_job.rb
 - app/jobs/meta_workflows/meta_workflow_job.rb
@@ -152,6 +155,7 @@ files:
 - app/models/meta_workflows.rb
 - app/models/meta_workflows/application_record.rb
 - app/models/meta_workflows/chat.rb
+- app/models/meta_workflows/execution_chat_history.rb
 - app/models/meta_workflows/message.rb
 - app/models/meta_workflows/tool_call.rb
 - app/models/meta_workflows/workflow.rb
@@ -159,16 +163,23 @@ files:
 - app/models/meta_workflows/workflow_step.rb
 - app/services/meta_workflows/application_service.rb
 - app/services/meta_workflows/execution_filter_service.rb
+- app/services/meta_workflows/message_history_service.rb
 - app/services/meta_workflows/workflow_import_service.rb
 - 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
 - app/views/meta_workflows/debug/show_workflow.html.erb
@@ -186,6 +197,7 @@ files:
 - db/migrate/20250618175439_add_call_id_and_status_to_meta_workflows_tool_calls.rb
 - db/migrate/20250626211926_add_repetition_to_meta_workflows_workflow_steps.rb
 - db/migrate/20250709153017_add_recipe_to_meta_workflows_workflow_executions.rb
+- db/migrate/20250714192853_create_meta_workflows_execution_chat_histories.rb
 - lib/meta_workflows.rb
 - lib/meta_workflows/asset_installer.rb
 - lib/meta_workflows/configuration.rb