ruby_llm-agents 1.0.0 → 1.1.0

data/lib/ruby_llm/agents/workflow/wait_result.rb

@@ -0,0 +1,213 @@
+# frozen_string_literal: true
+
+module RubyLLM
+  module Agents
+    class Workflow
+      # Result object for wait step execution
+      #
+      # Encapsulates the outcome of a wait operation including success/failure status,
+      # duration waited, and any metadata like approval details.
+      #
+      # @example Success result
+      #   WaitResult.success(:delay, 5.0)
+      #
+      # @example Timeout result
+      #   WaitResult.timeout(:until, 60.0, :fail)
+      #
+      # @example Approval result
+      #   WaitResult.approved("approval-123", "user@example.com", 3600.0)
+      #
+      # @api private
+      class WaitResult
+        STATUSES = %i[success timeout approved rejected skipped].freeze
+
+        attr_reader :type, :status, :waited_duration, :metadata
+
+        # @param type [Symbol] Wait type (:delay, :until, :schedule, :approval)
+        # @param status [Symbol] Result status (:success, :timeout, :approved, :rejected, :skipped)
+        # @param waited_duration [Float, nil] Duration waited in seconds
+        # @param metadata [Hash] Additional result metadata
+        def initialize(type:, status:, waited_duration: nil, metadata: {})
+          @type = type
+          @status = status
+          @waited_duration = waited_duration
+          @metadata = metadata
+        end
+
+        # Creates a success result
+        #
+        # @param type [Symbol] Wait type
+        # @param waited_duration [Float] Duration waited
+        # @param metadata [Hash] Additional metadata
+        # @return [WaitResult]
+        def self.success(type, waited_duration, **metadata)
+          new(
+            type: type,
+            status: :success,
+            waited_duration: waited_duration,
+            metadata: metadata
+          )
+        end
+
+        # Creates a timeout result
+        #
+        # @param type [Symbol] Wait type
+        # @param waited_duration [Float] Duration waited before timeout
+        # @param action_taken [Symbol] Action taken on timeout (:fail, :continue, :skip_next)
+        # @param metadata [Hash] Additional metadata
+        # @return [WaitResult]
+        def self.timeout(type, waited_duration, action_taken, **metadata)
+          new(
+            type: type,
+            status: :timeout,
+            waited_duration: waited_duration,
+            metadata: metadata.merge(action_taken: action_taken)
+          )
+        end
+
+        # Creates a skipped result (when condition not met)
+        #
+        # @param type [Symbol] Wait type
+        # @param reason [String, nil] Reason for skipping
+        # @return [WaitResult]
+        def self.skipped(type, reason: nil)
+          new(
+            type: type,
+            status: :skipped,
+            waited_duration: 0,
+            metadata: { reason: reason }.compact
+          )
+        end
+
+        # Creates an approved result for approval waits
+        #
+        # @param approval_id [String] Approval identifier
+        # @param approved_by [String] User who approved
+        # @param waited_duration [Float] Duration waited for approval
+        # @param metadata [Hash] Additional metadata
+        # @return [WaitResult]
+        def self.approved(approval_id, approved_by, waited_duration, **metadata)
+          new(
+            type: :approval,
+            status: :approved,
+            waited_duration: waited_duration,
+            metadata: metadata.merge(
+              approval_id: approval_id,
+              approved_by: approved_by
+            )
+          )
+        end
+
+        # Creates a rejected result for approval waits
+        #
+        # @param approval_id [String] Approval identifier
+        # @param rejected_by [String] User who rejected
+        # @param waited_duration [Float] Duration waited before rejection
+        # @param reason [String, nil] Rejection reason
+        # @param metadata [Hash] Additional metadata
+        # @return [WaitResult]
+        def self.rejected(approval_id, rejected_by, waited_duration, reason: nil, **metadata)
+          new(
+            type: :approval,
+            status: :rejected,
+            waited_duration: waited_duration,
+            metadata: metadata.merge(
+              approval_id: approval_id,
+              rejected_by: rejected_by,
+              reason: reason
+            ).compact
+          )
+        end
+
+        # Returns whether the wait completed successfully
+        #
+        # @return [Boolean]
+        def success?
+          status == :success || status == :approved
+        end
+
+        # Returns whether the wait timed out
+        #
+        # @return [Boolean]
+        def timeout?
+          status == :timeout
+        end
+
+        # Returns whether the wait was skipped
+        #
+        # @return [Boolean]
+        def skipped?
+          status == :skipped
+        end
+
+        # Returns whether an approval was granted
+        #
+        # @return [Boolean]
+        def approved?
+          status == :approved
+        end
+
+        # Returns whether an approval was rejected
+        #
+        # @return [Boolean]
+        def rejected?
+          status == :rejected
+        end
+
+        # Returns whether the workflow should continue after this wait
+        #
+        # @return [Boolean]
+        def should_continue?
+          success? || skipped? || (timeout? && metadata[:action_taken] == :continue)
+        end
+
+        # Returns whether the next step should be skipped
+        #
+        # @return [Boolean]
+        def should_skip_next?
+          timeout? && metadata[:action_taken] == :skip_next
+        end
+
+        # Returns the action taken on timeout
+        #
+        # @return [Symbol, nil]
+        def timeout_action
+          metadata[:action_taken]
+        end
+
+        # Returns the approval ID for approval waits
+        #
+        # @return [String, nil]
+        def approval_id
+          metadata[:approval_id]
+        end
+
+        # Returns who approved/rejected for approval waits
+        #
+        # @return [String, nil]
+        def actor
+          metadata[:approved_by] || metadata[:rejected_by]
+        end
+
+        # Returns the rejection reason
+        #
+        # @return [String, nil]
+        def rejection_reason
+          metadata[:reason]
+        end
+
+        # Converts to hash for serialization
+        #
+        # @return [Hash]
+        def to_h
+          {
+            type: type,
+            status: status,
+            waited_duration: waited_duration,
+            metadata: metadata
+          }
+        end
+      end
+    end
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ruby_llm-agents
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.1.0
 platform: ruby
 authors:
 - adham90
@@ -78,6 +78,7 @@ files:
 - README.md
 - app/controllers/concerns/ruby_llm/agents/filterable.rb
 - app/controllers/concerns/ruby_llm/agents/paginatable.rb
+- app/controllers/concerns/ruby_llm/agents/sortable.rb
 - app/controllers/ruby_llm/agents/agents_controller.rb
 - app/controllers/ruby_llm/agents/api_configurations_controller.rb
 - app/controllers/ruby_llm/agents/dashboard_controller.rb
@@ -86,6 +87,8 @@ files:
 - app/controllers/ruby_llm/agents/tenants_controller.rb
 - app/controllers/ruby_llm/agents/workflows_controller.rb
 - app/helpers/ruby_llm/agents/application_helper.rb
+- app/mailers/ruby_llm/agents/alert_mailer.rb
+- app/mailers/ruby_llm/agents/application_mailer.rb
 - app/models/ruby_llm/agents/api_configuration.rb
 - app/models/ruby_llm/agents/execution.rb
 - app/models/ruby_llm/agents/execution/analytics.rb
@@ -103,10 +106,13 @@ files:
 - app/views/ruby_llm/agents/agents/_config_speaker.html.erb
 - app/views/ruby_llm/agents/agents/_config_transcriber.html.erb
 - app/views/ruby_llm/agents/agents/_empty_state.html.erb
+- app/views/ruby_llm/agents/agents/_sortable_header.html.erb
 - app/views/ruby_llm/agents/agents/_version_comparison.html.erb
 - app/views/ruby_llm/agents/agents/_workflow.html.erb
 - app/views/ruby_llm/agents/agents/index.html.erb
 - app/views/ruby_llm/agents/agents/show.html.erb
+- app/views/ruby_llm/agents/alert_mailer/alert_notification.html.erb
+- app/views/ruby_llm/agents/alert_mailer/alert_notification.text.erb
 - app/views/ruby_llm/agents/api_configurations/_api_key_field.html.erb
 - app/views/ruby_llm/agents/api_configurations/_form.html.erb
 - app/views/ruby_llm/agents/api_configurations/edit.html.erb
@@ -118,7 +124,8 @@ files:
 - app/views/ruby_llm/agents/dashboard/_alerts_feed.html.erb
 - app/views/ruby_llm/agents/dashboard/_breaker_strip.html.erb
 - app/views/ruby_llm/agents/dashboard/_budgets_bar.html.erb
-- app/views/ruby_llm/agents/dashboard/_execution_item.html.erb
+- app/views/ruby_llm/agents/dashboard/_model_comparison.html.erb
+- app/views/ruby_llm/agents/dashboard/_model_cost_breakdown.html.erb
 - app/views/ruby_llm/agents/dashboard/_now_strip.html.erb
 - app/views/ruby_llm/agents/dashboard/_tenant_budget.html.erb
 - app/views/ruby_llm/agents/dashboard/_top_errors.html.erb
@@ -132,10 +139,12 @@ files:
 - app/views/ruby_llm/agents/executions/show.html.erb
 - app/views/ruby_llm/agents/shared/_agent_type_badge.html.erb
 - app/views/ruby_llm/agents/shared/_breadcrumbs.html.erb
+- app/views/ruby_llm/agents/shared/_doc_link.html.erb
 - app/views/ruby_llm/agents/shared/_executions_table.html.erb
 - app/views/ruby_llm/agents/shared/_filter_dropdown.html.erb
 - app/views/ruby_llm/agents/shared/_nav_link.html.erb
 - app/views/ruby_llm/agents/shared/_select_dropdown.html.erb
+- app/views/ruby_llm/agents/shared/_sortable_header.html.erb
 - app/views/ruby_llm/agents/shared/_stat_card.html.erb
 - app/views/ruby_llm/agents/shared/_status_badge.html.erb
 - app/views/ruby_llm/agents/shared/_status_dot.html.erb
@@ -147,9 +156,12 @@ files:
 - app/views/ruby_llm/agents/tenants/index.html.erb
 - app/views/ruby_llm/agents/tenants/show.html.erb
 - app/views/ruby_llm/agents/workflows/_step_performance.html.erb
+- app/views/ruby_llm/agents/workflows/_structure_dsl.html.erb
 - app/views/ruby_llm/agents/workflows/_structure_parallel.html.erb
 - app/views/ruby_llm/agents/workflows/_structure_pipeline.html.erb
 - app/views/ruby_llm/agents/workflows/_structure_router.html.erb
+- app/views/ruby_llm/agents/workflows/_workflow_diagram.html.erb
+- app/views/ruby_llm/agents/workflows/index.html.erb
 - app/views/ruby_llm/agents/workflows/show.html.erb
 - config/routes.rb
 - lib/generators/ruby_llm_agents/agent_generator.rb
@@ -164,6 +176,7 @@ files:
 - lib/generators/ruby_llm_agents/image_upscaler_generator.rb
 - lib/generators/ruby_llm_agents/image_variator_generator.rb
 - lib/generators/ruby_llm_agents/install_generator.rb
+- lib/generators/ruby_llm_agents/migrate_structure_generator.rb
 - lib/generators/ruby_llm_agents/multi_tenancy_generator.rb
 - lib/generators/ruby_llm_agents/restructure_generator.rb
 - lib/generators/ruby_llm_agents/speaker_generator.rb
@@ -191,6 +204,7 @@ files:
 - lib/generators/ruby_llm_agents/templates/application_image_variator.rb.tt
 - lib/generators/ruby_llm_agents/templates/application_speaker.rb.tt
 - lib/generators/ruby_llm_agents/templates/application_transcriber.rb.tt
+- lib/generators/ruby_llm_agents/templates/application_workflow.rb.tt
 - lib/generators/ruby_llm_agents/templates/background_remover.rb.tt
 - lib/generators/ruby_llm_agents/templates/create_api_configurations_migration.rb.tt
 - lib/generators/ruby_llm_agents/templates/create_tenant_budgets_migration.rb.tt
@@ -313,15 +327,32 @@ files:
 - lib/ruby_llm/agents/results/transcription_result.rb
 - lib/ruby_llm/agents/text/embedder.rb
 - lib/ruby_llm/agents/text/moderator.rb
+- lib/ruby_llm/agents/workflow/approval.rb
+- lib/ruby_llm/agents/workflow/approval_store.rb
 - lib/ruby_llm/agents/workflow/async.rb
 - lib/ruby_llm/agents/workflow/async_executor.rb
+- lib/ruby_llm/agents/workflow/dsl.rb
+- lib/ruby_llm/agents/workflow/dsl/executor.rb
+- lib/ruby_llm/agents/workflow/dsl/input_schema.rb
+- lib/ruby_llm/agents/workflow/dsl/iteration_executor.rb
+- lib/ruby_llm/agents/workflow/dsl/parallel_group.rb
+- lib/ruby_llm/agents/workflow/dsl/route_builder.rb
+- lib/ruby_llm/agents/workflow/dsl/schedule_helpers.rb
+- lib/ruby_llm/agents/workflow/dsl/step_config.rb
+- lib/ruby_llm/agents/workflow/dsl/step_executor.rb
+- lib/ruby_llm/agents/workflow/dsl/wait_config.rb
+- lib/ruby_llm/agents/workflow/dsl/wait_executor.rb
 - lib/ruby_llm/agents/workflow/instrumentation.rb
+- lib/ruby_llm/agents/workflow/notifiers.rb
+- lib/ruby_llm/agents/workflow/notifiers/base.rb
+- lib/ruby_llm/agents/workflow/notifiers/email.rb
+- lib/ruby_llm/agents/workflow/notifiers/slack.rb
+- lib/ruby_llm/agents/workflow/notifiers/webhook.rb
 - lib/ruby_llm/agents/workflow/orchestrator.rb
-- lib/ruby_llm/agents/workflow/parallel.rb
-- lib/ruby_llm/agents/workflow/pipeline.rb
 - lib/ruby_llm/agents/workflow/result.rb
-- lib/ruby_llm/agents/workflow/router.rb
 - lib/ruby_llm/agents/workflow/thread_pool.rb
+- lib/ruby_llm/agents/workflow/throttle_manager.rb
+- lib/ruby_llm/agents/workflow/wait_result.rb
 homepage: https://github.com/adham90/ruby_llm-agents
 licenses:
 - MIT
@@ -343,7 +374,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.3
+rubygems_version: 3.6.9
 specification_version: 4
 summary: Agent framework for building LLM-powered agents with RubyLLM
 test_files: []

data/app/views/ruby_llm/agents/dashboard/_execution_item.html.erb

@@ -1,66 +0,0 @@
-<div id="execution-<%= execution.id %>" class="py-2.5 hover:bg-gray-50 dark:hover:bg-gray-700/50 -mx-2 px-2 rounded-lg transition-colors">
-  <%= link_to ruby_llm_agents.execution_path(execution), class: "block" do %>
-    <!-- Row 1: Status dot + Agent + Badges + Timestamp -->
-    <div class="flex items-center justify-between gap-2">
-      <div class="flex items-center gap-2 min-w-0">
-        <%= render "ruby_llm/agents/shared/status_dot", status: execution.status %>
-        <% if execution.respond_to?(:workflow_type) && execution.workflow_type.present? %>
-          <%= render "ruby_llm/agents/shared/workflow_type_badge", workflow_type: execution.workflow_type, size: :xs, show_label: false %>
-        <% end %>
-        <span class="font-medium text-sm text-gray-900 dark:text-gray-100 truncate">
-          <%= execution.agent_type.gsub(/Agent$|Workflow$|Pipeline$|Parallel$|Router$/, '') %>
-        </span>
-        <span class="hidden sm:inline text-xs text-gray-400 dark:text-gray-500">v<%= execution.agent_version %></span>
-        <% unless execution.status_running? %>
-          <div class="hidden sm:flex items-center gap-1">
-            <% if execution.streaming? %>
-              <span class="badge badge-cyan text-[10px] px-1.5 py-0.5">Stream</span>
-            <% end %>
-            <% if execution.cache_hit? %>
-              <span class="badge badge-purple text-[10px] px-1.5 py-0.5">Cached</span>
-            <% end %>
-            <% if execution.rate_limited? %>
-              <span class="badge badge-orange text-[10px] px-1.5 py-0.5">Limited</span>
-            <% end %>
-          </div>
-        <% end %>
-      </div>
-      <span class="text-xs text-gray-400 dark:text-gray-500 whitespace-nowrap flex-shrink-0">
-        <%= time_ago_in_words(execution.created_at) %> ago
-      </span>
-    </div>
-
-    <!-- Row 2: Model + Metrics -->
-    <div class="mt-1 text-xs text-gray-500 dark:text-gray-400">
-      <% if execution.status_running? %>
-        <span class="text-blue-500 dark:text-blue-400 animate-pulse">Processing...</span>
-      <% else %>
-        <!-- Mobile: compact -->
-        <span class="sm:hidden">
-          <%= number_to_human_short(execution.total_tokens || 0) %> tokens · $<%= number_with_precision(execution.total_cost || 0, precision: 2) %>
-        </span>
-        <!-- Desktop: full -->
-        <span class="hidden sm:inline">
-          <span class="font-mono text-gray-400 dark:text-gray-500"><%= execution.model_id %></span>
-          <span class="mx-1.5 text-gray-300 dark:text-gray-600">·</span>
-          <%= number_to_human_short(execution.total_tokens || 0) %> tokens
-          <span class="mx-1.5 text-gray-300 dark:text-gray-600">·</span>
-          $<%= number_with_precision(execution.total_cost || 0, precision: 4) %>
-          <span class="mx-1.5 text-gray-300 dark:text-gray-600">·</span>
-          <%= number_to_human_short(execution.duration_ms || 0) %>ms
-          <% if execution.respond_to?(:attempts_count) && execution.attempts_count && execution.attempts_count > 1 %>
-            <span class="mx-1.5 text-gray-300 dark:text-gray-600">·</span>
-            <span class="text-amber-600 dark:text-amber-400"><%= execution.attempts_count %> retries</span>
-          <% end %>
-        </span>
-      <% end %>
-    </div>
-
-    <!-- Error display -->
-    <% if execution.status_error? && execution.error_message.present? %>
-      <p class="mt-1.5 text-xs text-red-600 dark:text-red-400 bg-red-50 dark:bg-red-900/30 rounded px-2 py-1">
-        <%= execution.error_class %>: <%= truncate(execution.error_message, length: 80) %>
-      </p>
-    <% end %>
-  <% end %>
-</div>