meta_workflows 0.7.1 → 0.8.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bd9461e41652231e6ddcbd6aff71c4ced97fdb79a1a349a2cd789a0803379d67
-  data.tar.gz: 778d893c99b094d987021a41b6a80966044abae432a5a3644ec629339756daee
+  metadata.gz: 431a4051a349e98758ed8b86e331191c4cab06e76fb6baeb873e35993b8d7ac3
+  data.tar.gz: ced2c7a5b62d0f6c12b9a369dd750e9027bb93fd68f702ae6fb7191eaf0e9fc0
 SHA512:
-  metadata.gz: 6473b7dbcaab6cbb688846dbba1bc403081f6b63d0833da4033a57fb45b8b316d104ab4273a260d2b23f06750b8770d914dd3f89749a1822f11a0b82d3b7ea7c
-  data.tar.gz: 05e7e92d737f5d2dc6a3f8b39e4be6aa0e456d07738f4d91e9e9f1f2bb0f2f990d74e9dd307d40fb3b44ea5ee4f1909933a18e8c19c7d57217a234f9dbb3fd2d
+  metadata.gz: c309e7acdaab0f25f4451a688cda47c19fa2367d394e1e0392ef596c7ab78d3a44fc08259ae2c6871fa51d95ab35a1c853f442824a8290a0afabe7963fde5738
+  data.tar.gz: 6270d2f04ebfc06e624cb5881578b46490550256558e22e3c8599af384e5de4fe5b0616317acf585a094e9ce34df02197cf9fd58811b5f62ba8324f34006582d

data/README.md

@@ -524,3 +524,72 @@ For detailed information about the MetaWorkflows system:
 ## License
 
 The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+
+## Tray System (Sidebar, Bottom, and Main Content Trays)
+
+MetaWorkflows provides a flexible tray system for building modern, multi-pane layouts. The tray system supports left (Beta), right (Gamma), and bottom (Delta) trays, as well as a main content area (Alpha). Each tray can be shown, hidden, or made collapsible on a per-controller or per-page basis.
+
+### Tray Placement Overview
+
+| Tray  | Placement      | Description                                 |
+|:-----:|:--------------|:--------------------------------------------|
+| Beta  | Left sidebar   | Optional collapsible sidebar on the left    |
+| Alpha | Center/main    | Main content area (always visible)          |
+| Gamma | Right sidebar  | Optional collapsible sidebar on the right   |
+| Delta | Bottom tray    | Optional collapsible tray at the bottom     |
+
+### How It Works
+- The tray system is controlled by a `TrayConfigurable` concern included in your controllers.
+- By default, all trays are hidden. You must explicitly set `visible: true` for any tray you want to show.
+- The engine's layout will automatically respect your tray configuration.
+
+### Enabling and Configuring Trays
+
+1. **Include the Concern in Your ApplicationController:**
+
+   ```ruby
+   class ApplicationController < ActionController::Base
+     include TrayConfigurable
+     before_action :configure_trays
+   end
+   ```
+
+2. **Override Tray Settings in Any Controller:**
+
+   ```ruby
+   class PostsController < ApplicationController
+     def configure_trays
+       super
+       tray_config[:beta][:visible] = true      # Show Beta (left) tray
+       tray_config[:gamma][:visible] = false    # Hide Gamma (right) tray
+       tray_config[:delta][:collapsible] = false # Make Delta (bottom) tray not collapsible
+     end
+   end
+   ```
+
+3. **Default Behavior:**
+   - All trays are hidden unless set to `visible: true`.
+   - Trays are collapsible by default; set `collapsible: false` to disable collapsing.
+
+4. **Layout:**
+   - The engine's layout (`app/views/layouts/meta_workflows/application.html.erb`) will automatically render trays based on your configuration.
+
+### Example: Show Only the Left Tray
+
+```ruby
+class DashboardController < ApplicationController
+  def configure_trays
+    super
+    tray_config[:beta][:visible] = true
+    tray_config[:gamma][:visible] = false
+    tray_config[:delta][:visible] = false
+  end
+end
+```
+
+### Notes
+- The tray system is available in both the engine and the dummy app for development/testing.
+- You can override tray configuration per controller or per action as needed.
+- The main content area (Alpha tray) is always visible and holds your page content.
+
+For more advanced usage or to contribute improvements, see the tray logic in `TrayConfigurable` and the engine layout file.

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

@@ -0,0 +1,109 @@
+import { Controller } from "@hotwired/stimulus"
+
+function getCookie(name) {
+  const value = `; ${document.cookie}`;
+  const parts = value.split(`; ${name}=`);
+  if (parts.length !== 2) return null;
+  return parts.pop().split(';').shift();
+}
+
+function setCookie(name, value) {
+  document.cookie = `${name}=${value}; path=/; max-age=31536000`;
+}
+
+function chevronDirection(tray, expanded) {
+  if (tray === "beta") return expanded ? "fa-chevron-left" : "fa-chevron-right";
+  if (tray === "gamma") return expanded ? "fa-chevron-right" : "fa-chevron-left";
+  if (tray === "delta") return expanded ? "fa-chevron-down" : "fa-chevron-up";
+  return "";
+}
+
+export default class extends Controller {
+  static values = { name: String }
+  static targets = ["content", "chevron"]
+
+  connect() {
+    // Load state from cookies
+    const savedState = getCookie(`tray_${this.nameValue}`);
+    if (savedState === "collapsed") {
+      this.expanded = false;
+    } else {
+      this.expanded = true;
+    }
+    this.updateTray();
+    // Set chevron direction from cookie if present
+    const chevron = this.hasChevronTarget ? this.chevronTarget : null;
+    if (chevron) {
+      const chevronCookie = getCookie(`chevron_${this.nameValue}`);
+      if (chevronCookie) {
+        chevron.classList.remove("fa-chevron-left", "fa-chevron-right", "fa-chevron-up", "fa-chevron-down");
+        chevron.classList.add(chevronCookie);
+      }
+    }
+  }
+
+  toggle() {
+    this.expanded = !this.expanded;
+    // Save state to cookies
+    setCookie(`tray_${this.nameValue}`, this.expanded ? "expanded" : "collapsed");
+    // Save chevron direction to cookies
+    setCookie(`chevron_${this.nameValue}`, chevronDirection(this.nameValue, this.expanded));
+    this.updateTray();
+  }
+
+  updateTray() {
+    // Only update chevron if it exists (tray is collapsible)
+    const hasChevron = this.hasChevronTarget;
+    if (this.nameValue === "delta") {
+      if (this.expanded) {
+        this.element.classList.remove("collapsed");
+        this.element.classList.add("h-[200px]");
+        if (hasChevron) {
+          this.chevronTarget.classList.remove("fa-chevron-up");
+          this.chevronTarget.classList.add("fa-chevron-down");
+        }
+      } else {
+        this.element.classList.remove("h-[200px]");
+        this.element.classList.add("collapsed");
+        if (hasChevron) {
+          this.chevronTarget.classList.remove("fa-chevron-down");
+          this.chevronTarget.classList.add("fa-chevron-up");
+        }
+      }
+    } else if (this.nameValue === "beta") {
+      // Beta: open=left, collapsed=right
+      if (this.expanded) {
+        this.element.classList.remove("collapsed");
+        this.element.classList.add("w-[300px]");
+        if (hasChevron) {
+          this.chevronTarget.classList.remove("fa-chevron-right");
+          this.chevronTarget.classList.add("fa-chevron-left");
+        }
+      } else {
+        this.element.classList.remove("w-[300px]");
+        this.element.classList.add("collapsed");
+        if (hasChevron) {
+          this.chevronTarget.classList.remove("fa-chevron-left");
+          this.chevronTarget.classList.add("fa-chevron-right");
+        }
+      }
+    } else if (this.nameValue === "gamma") {
+      // Gamma: open=right, collapsed=left
+      if (this.expanded) {
+        this.element.classList.remove("collapsed");
+        this.element.classList.add("w-[300px]");
+        if (hasChevron) {
+          this.chevronTarget.classList.remove("fa-chevron-left");
+          this.chevronTarget.classList.add("fa-chevron-right");
+        }
+      } else {
+        this.element.classList.remove("w-[300px]");
+        this.element.classList.add("collapsed");
+        if (hasChevron) {
+          this.chevronTarget.classList.remove("fa-chevron-right");
+          this.chevronTarget.classList.add("fa-chevron-left");
+        }
+      }
+    }
+  }
+} 

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

@@ -158,4 +158,61 @@
     em {
       font-style: italic;
     }
-  }
+  }
+
+/* Tray Animations */
+.tray-container {
+  transition: all 500ms ease-in-out;
+}
+
+/* Beta Tray (Left) */
+.beta-tray {
+  transition: width 500ms ease-in-out;
+}
+
+.beta-tray.collapsed {
+  width: 70px;
+}
+
+.beta-tray.collapsed .tray-content {
+  opacity: 0;
+  transform: translateX(1rem);
+  pointer-events: none;
+}
+
+/* Gamma Tray (Right) */
+.gamma-tray {
+  transition: width 500ms ease-in-out;
+}
+
+.gamma-tray.collapsed {
+  width: 70px;
+}
+
+.gamma-tray.collapsed .tray-content {
+  opacity: 0;
+  transform: translateX(-1rem);
+  pointer-events: none;
+}
+
+/* Delta Tray (Bottom) */
+.delta-tray {
+  transition: height 500ms ease-in-out;
+}
+
+.delta-tray.collapsed {
+  height: 50px;
+}
+
+.delta-tray.collapsed .tray-content {
+  opacity: 0;
+  transform: translateY(1rem);
+  pointer-events: none;
+}
+
+/* Common content transitions */
+.tray-content {
+  transition: opacity 500ms ease-in-out, transform 500ms ease-in-out;
+  opacity: 1;
+  transform: translate(0);
+}

data/app/controllers/concerns/tray_configurable.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module TrayConfigurable
+  extend ActiveSupport::Concern
+
+  included do
+    helper_method :tray_config
+  end
+
+  def tray_config
+    @tray_config ||= {
+      beta: {
+        visible: false,
+        collapsible: true
+      },
+      gamma: {
+        visible: false,
+        collapsible: true
+      },
+      delta: {
+        visible: false,
+        collapsible: true
+      }
+    }
+  end
+
+  # Override in controllers to customize tray configuration
+  def configure_trays
+    # Example:
+    # tray_config[:beta][:visible] = true
+    # tray_config[:gamma][:collapsible] = false
+  end
+end

data/app/controllers/meta_workflows/application_controller.rb

@@ -4,6 +4,15 @@ module MetaWorkflows
   class ApplicationController < ActionController::Base
     protect_from_forgery with: :exception
 
+    include TrayConfigurable
+    before_action :configure_trays
+
+    def configure_trays
+      super
+      tray_config[:beta][:visible] = false
+      tray_config[:gamma][:visible] = false
+      tray_config[:delta][:visible] = false
+    end
     # Add any MetaWorkflows-specific controller functionality here
     # This ensures proper engine isolation
   end

data/app/helpers/meta_workflows/meta_workflows_helper.rb

@@ -37,5 +37,23 @@ module MetaWorkflows
         'Happy with this, or want changes?'
       ].sample
     end
+
+    def tray_state(tray)
+      (cookies['tray_'] && cookies['tray_'][tray.to_s]) || cookies["tray_#{tray}"] || 'expanded'
+    end
+
+    def chevron_direction(tray)
+      state = tray_state(tray)
+      case tray.to_s
+      when 'beta'
+        state == 'collapsed' ? 'fa-chevron-right' : 'fa-chevron-left'
+      when 'gamma'
+        state == 'collapsed' ? 'fa-chevron-left' : 'fa-chevron-right'
+      when 'delta'
+        state == 'collapsed' ? 'fa-chevron-up' : 'fa-chevron-down'
+      else
+        ''
+      end
+    end
   end
 end

data/app/jobs/meta_workflows/record_redirect_job.rb

@@ -14,8 +14,8 @@ module MetaWorkflows
     private
 
     def broadcast_redirect(params)
-      record_id = params['record_id']
-      record_class = params['record_class']
+      record_id = params['redirect_id']
+      record_class = params['redirect_class']
       redirect_method = params['redirect_method']
 
       record_class_constant = record_class.to_s.safe_constantize

data/app/models/meta_workflows/workflow_execution.rb

@@ -8,12 +8,10 @@ module MetaWorkflows
 
     # Default values for fields
     attribute :current_step, :integer, default: 0
-    attribute :repetition, :integer, default: 0
     attribute :completed, :boolean, default: false
     attribute :workflow_params, :json, default: -> { {} }
 
     validates :current_step, presence: true, numericality: { only_integer: true, greater_than_or_equal_to: 0 }
-    validates :repetition, presence: true, numericality: { only_integer: true, greater_than_or_equal_to: 0 }
     validates :completed, inclusion: { in: [true, false] }
 
     def increment_step

data/app/views/layouts/meta_workflows/application.html.erb

@@ -1,17 +1,16 @@
 <!DOCTYPE html>
 <html>
-<head>
-  <title>Meta workflows</title>
-  <%= csrf_meta_tags %>
-  <%= csp_meta_tag %>
+  <head>
+    <title>Meta Workflows</title>
+    <%= csrf_meta_tags %>
+    <%= csp_meta_tag %>
 
-  <%= yield :head %>
+    <%= stylesheet_link_tag    "meta_workflows/application", media: "all" %>
+    <%= javascript_include_tag "meta_workflows/application" %>
+  </head>
 
-  <%= stylesheet_link_tag    "meta_workflows/application", media: "all" %>
-</head>
-<body>
-
-<%= yield %>
-
-</body>
+  <body>
+    <%= render 'layouts/meta_workflows/flash' %>
+    <%= yield %>
+  </body>
 </html>

data/db/migrate/20250617192849_remove_repetition_from_meta_workflows_workflow_executions.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+class RemoveRepetitionFromMetaWorkflowsWorkflowExecutions < ActiveRecord::Migration[7.2]
+  def change
+    remove_column :meta_workflows_workflow_executions, :repetition, :integer
+  end
+end

data/db/migrate/20250618175439_add_call_id_and_status_to_meta_workflows_tool_calls.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+class AddCallIdAndStatusToMetaWorkflowsToolCalls < ActiveRecord::Migration[7.2]
+  def change
+    add_column :meta_workflows_tool_calls, :call_id, :string
+    add_column :meta_workflows_tool_calls, :status, :string
+  end
+end

data/lib/meta_workflows/engine.rb

@@ -9,7 +9,6 @@ module MetaWorkflows
       #{root}/app/controllers/concerns
       #{root}/app/models/concerns
       #{root}/app/services
-      #{root}/app/components
       #{root}/app/jobs
       #{root}/app/sidekiq
       #{root}/lib
@@ -29,14 +28,6 @@ module MetaWorkflows
         # Configure Sidekiq for MetaWorkflows jobs
         app.config.active_job.queue_adapter = :sidekiq
       end
-
-      # Configure ViewComponent if available
-      if defined?(ViewComponent)
-        existing_paths = [*ViewComponent::Base.view_component_path]
-        engine_component_path = root.join('app', 'components').to_s
-
-        app.config.view_component.view_component_path = (existing_paths + [engine_component_path]).uniq
-      end
     end
 
     # Configure routes

data/lib/meta_workflows/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module MetaWorkflows
-  VERSION = '0.7.1'
+  VERSION = '0.8.2'
 end

data/lib/services/meta_workflows/meta_workflow_service.rb

@@ -169,10 +169,8 @@ module Services
 
         raise ArgumentError, "Invalid collection creator class: #{service_class_name}" unless service_class
 
-        parent_record = find_parent_record(workflow_execution)
-
         service_class.new(
-          parent_record: parent_record,
+          workflow_execution: workflow_execution,
           collection: inputs[:collection]
         )
       end
@@ -189,6 +187,8 @@ module Services
         service_class.new(target_record, attributes_to_update, workflow_execution.workflow_params)
       end
 
+      # TODO: We should refactor this along with the build_record_update_service method
+      # to only use workflow_params and use better naming (instead of record_id and record_class)
       def find_parent_record(workflow_execution)
         record_class = workflow_execution.record.class.name.constantize
         record_class.find(workflow_execution.workflow_params['record_id'])

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: meta_workflows
 version: !ruby/object:Gem::Version
-  version: 0.7.1
+  version: 0.8.2
 platform: ruby
 authors:
 - Leonid Medovyy
@@ -9,28 +9,22 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-06-17 00:00:00.000000000 Z
+date: 2025-06-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
         version: 7.2.0
-    - - "<"
-      - !ruby/object:Gem::Version
-        version: '8.1'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
         version: 7.2.0
-    - - "<"
-      - !ruby/object:Gem::Version
-        version: '8.1'
 - !ruby/object:Gem::Dependency
   name: sidekiq
   requirement: !ruby/object:Gem::Requirement
@@ -73,20 +67,6 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-- !ruby/object:Gem::Dependency
-  name: view_component
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '3.0'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '3.0'
 - !ruby/object:Gem::Dependency
   name: stimulus-rails
   requirement: !ruby/object:Gem::Requirement
@@ -131,8 +111,10 @@ files:
 - app/assets/javascripts/meta_workflows/controllers/loading_phrases_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/tray_controller.js
 - app/assets/javascripts/meta_workflows_manifest.js
 - app/assets/stylesheets/meta_workflows/application.css
+- app/controllers/concerns/tray_configurable.rb
 - app/controllers/meta_workflows/application_controller.rb
 - app/controllers/meta_workflows/debug_controller.rb
 - app/controllers/meta_workflows/humans_controller.rb
@@ -177,6 +159,8 @@ files:
 - db/migrate/20250530220737_create_meta_workflows_tool_calls.rb
 - db/migrate/20250530220750_create_meta_workflows_workflow_steps.rb
 - db/migrate/20250613213159_add_error_fields_to_workflow_steps.rb
+- db/migrate/20250617192849_remove_repetition_from_meta_workflows_workflow_executions.rb
+- db/migrate/20250618175439_add_call_id_and_status_to_meta_workflows_tool_calls.rb
 - lib/meta_workflows.rb
 - lib/meta_workflows/asset_installer.rb
 - lib/meta_workflows/configuration.rb
@@ -188,15 +172,15 @@ files:
 - lib/services/meta_workflows/updaters/meta_service.rb
 - lib/tasks/git_hooks.rake
 - lib/tasks/meta_workflows_tasks.rake
-homepage: https://github.com/strongmind/meta_workflows
+homepage: https://github.com/strongmind/meta-workflows
 licenses:
 - None
 metadata:
   allowed_push_host: https://rubygems.org
-  homepage_uri: https://github.com/strongmind/meta_workflows
-  source_code_uri: https://github.com/strongmind/meta_workflows
-  changelog_uri: https://github.com/strongmind/meta_workflows/blob/main/CHANGELOG.md
-  documentation_uri: https://github.com/strongmind/meta_workflows/blob/main/README.md
+  homepage_uri: https://github.com/strongmind/meta-workflows
+  source_code_uri: https://github.com/strongmind/meta-workflows
+  changelog_uri: https://github.com/strongmind/meta-workflows/blob/main/CHANGELOG.md
+  documentation_uri: https://github.com/strongmind/meta-workflows/blob/main/README.md
   rubygems_mfa_required: 'true'
 post_install_message:
 rdoc_options: []