ruby_llm-agents 1.3.4 → 2.1.0

data/lib/generators/ruby_llm_agents/api_configuration_generator.rb

@@ -1,100 +0,0 @@
-# frozen_string_literal: true
-
-require "rails/generators"
-require "rails/generators/active_record"
-
-module RubyLlmAgents
-  # API Configuration generator for ruby_llm-agents
-  #
-  # Usage:
-  #   rails generate ruby_llm_agents:api_configuration
-  #
-  # This will create migrations for:
-  #   - ruby_llm_agents_api_configurations table for storing API keys and settings
-  #
-  # API keys are encrypted at rest using Rails encrypted attributes.
-  # Supports both global configuration and per-tenant overrides.
-  #
-  class ApiConfigurationGenerator < ::Rails::Generators::Base
-    include ::ActiveRecord::Generators::Migration
-
-    source_root File.expand_path("templates", __dir__)
-
-    desc "Adds database-backed API configuration support to RubyLLM::Agents"
-
-    def create_api_configurations_migration
-      if table_exists?(:ruby_llm_agents_api_configurations)
-        say_status :skip, "ruby_llm_agents_api_configurations table already exists", :yellow
-        return
-      end
-
-      migration_template(
-        "create_api_configurations_migration.rb.tt",
-        File.join(db_migrate_path, "create_ruby_llm_agents_api_configurations.rb")
-      )
-    end
-
-    def show_post_install_message
-      say ""
-      say "API Configuration migration created!", :green
-      say ""
-      say "Next steps:"
-      say "  1. Ensure Rails encryption is configured (if not already):"
-      say ""
-      say "     bin/rails db:encryption:init"
-      say ""
-      say "     Then add the generated keys to your credentials or environment."
-      say ""
-      say "  2. Run the migration:"
-      say ""
-      say "     rails db:migrate"
-      say ""
-      say "  3. Access the API Configuration UI:"
-      say ""
-      say "     Navigate to /agents/api_configuration in your browser"
-      say ""
-      say "  4. (Optional) Configure API keys programmatically:"
-      say ""
-      say "     # Set global configuration"
-      say "     config = RubyLLM::Agents::ApiConfiguration.global"
-      say "     config.update!("
-      say "       openai_api_key: 'sk-...',"
-      say "       anthropic_api_key: 'sk-ant-...'"
-      say "     )"
-      say ""
-      say "     # Set tenant-specific configuration"
-      say "     tenant_config = RubyLLM::Agents::ApiConfiguration.for_tenant!('acme_corp')"
-      say "     tenant_config.update!("
-      say "       openai_api_key: 'sk-tenant-specific-key',"
-      say "       inherit_global_defaults: true"
-      say "     )"
-      say ""
-      say "Configuration Resolution Priority:"
-      say "  1. Per-tenant database configuration (if multi-tenancy enabled)"
-      say "  2. Global database configuration"
-      say "  3. RubyLLM.configure block settings"
-      say ""
-      say "Security Notes:"
-      say "  - API keys are encrypted at rest using Rails encrypted attributes"
-      say "  - Keys are masked in the UI (e.g., sk-ab****wxyz)"
-      say "  - Dashboard authentication inherits from your authenticate_dashboard! method"
-      say ""
-    end
-
-    private
-
-    def migration_version
-      "[#{::ActiveRecord::VERSION::STRING.to_f}]"
-    end
-
-    def db_migrate_path
-      "db/migrate"
-    end
-
-    def table_exists?(table)
-      ActiveRecord::Base.connection.table_exists?(table)
-    rescue StandardError
-      false
-    end
-  end
-end

data/lib/generators/ruby_llm_agents/templates/add_workflow_migration.rb.tt

@@ -1,38 +0,0 @@
-# frozen_string_literal: true
-
-# Migration to add workflow orchestration columns to executions
-#
-# This migration adds columns for tracking workflow executions (Pipeline,
-# Parallel, Router patterns) and linking child executions to their
-# parent workflow.
-#
-# Workflow patterns supported:
-# - Pipeline: Sequential execution with data flowing between steps
-# - Parallel: Concurrent execution with result aggregation
-# - Router: Conditional dispatch based on classification
-#
-# Run with: rails db:migrate
-class AddWorkflowToRubyLLMAgentsExecutions < ActiveRecord::Migration<%= migration_version %>
-  def change
-    # Unique identifier for the workflow execution
-    # All steps/branches share the same workflow_id
-    add_column :ruby_llm_agents_executions, :workflow_id, :string
-
-    # Type of workflow: "pipeline", "parallel", "router", or nil for regular agents
-    add_column :ruby_llm_agents_executions, :workflow_type, :string
-
-    # Name of the step/branch within the workflow
-    add_column :ruby_llm_agents_executions, :workflow_step, :string
-
-    # For routers: the route that was selected
-    add_column :ruby_llm_agents_executions, :routed_to, :string
-
-    # For routers: classification details (route, method, time)
-    add_column :ruby_llm_agents_executions, :classification_result, :json
-
-    # Add indexes for efficient querying
-    add_index :ruby_llm_agents_executions, :workflow_id
-    add_index :ruby_llm_agents_executions, :workflow_type
-    add_index :ruby_llm_agents_executions, [:workflow_id, :workflow_step]
-  end
-end

data/lib/generators/ruby_llm_agents/templates/application_workflow.rb.tt

@@ -1,48 +0,0 @@
-# frozen_string_literal: true
-
-# ApplicationWorkflow - Base class for all workflows in this application
-#
-# All workflows inherit from this class. Configure shared settings here
-# that apply to all workflows, or override them per-workflow as needed.
-#
-# Workflows compose multiple agents into pipelines, parallel executions,
-# or conditional routing flows.
-#
-# Example:
-#   class ContentPipelineWorkflow < ApplicationWorkflow
-#     description "Process and publish content"
-#
-#     step :moderate, agent: Moderators::ContentModerator
-#     step :generate_image, agent: Images::ProductGenerator
-#     step :embed, agent: Embedders::SemanticEmbedder
-#   end
-#
-# Usage:
-#   ContentPipelineWorkflow.call(content: "...")
-#
-class ApplicationWorkflow < RubyLLM::Agents::Workflow::Orchestrator
-  # ============================================
-  # Shared Workflow Configuration
-  # ============================================
-
-  # Default timeout for entire workflow
-  # total_timeout 120
-
-  # Budget tracking
-  # budget_limit 1.0  # Maximum spend in dollars
-
-  # ============================================
-  # Shared Helper Methods
-  # ============================================
-
-  # Example: Common error handling
-  # def on_step_error(step_name, error)
-  #   Rails.logger.error "Workflow step #{step_name} failed: #{error.message}"
-  #   # Optionally notify monitoring
-  # end
-
-  # Example: Common success callback
-  # def on_complete(result)
-  #   Rails.logger.info "Workflow completed successfully"
-  # end
-end

data/lib/generators/ruby_llm_agents/templates/create_api_configurations_migration.rb.tt

@@ -1,90 +0,0 @@
-# frozen_string_literal: true
-
-# Migration to create the api_configurations table
-#
-# This table stores API key configurations that can be managed via the dashboard.
-# Supports both global settings and per-tenant overrides.
-#
-# Resolution priority: per-tenant DB > global DB > config file (RubyLLM.configure)
-#
-# Features:
-# - Encrypted storage for all API keys (using Rails encrypted attributes)
-# - Support for all major LLM providers
-# - Custom endpoint configuration
-# - Connection settings
-# - Default model configuration
-#
-# Run with: rails db:migrate
-class CreateRubyLLMAgentsApiConfigurations < ActiveRecord::Migration<%= migration_version %>
-  def change
-    create_table :ruby_llm_agents_api_configurations do |t|
-      # Scope type: 'global' or 'tenant'
-      t.string :scope_type, null: false, default: 'global'
-      # Tenant ID when scope_type='tenant'
-      t.string :scope_id
-
-      # === Encrypted API Keys ===
-      # Rails encrypts stores encrypted data in the same-named column
-      # Primary providers
-      t.text :openai_api_key
-      t.text :anthropic_api_key
-      t.text :gemini_api_key
-
-      # Additional providers
-      t.text :deepseek_api_key
-      t.text :mistral_api_key
-      t.text :perplexity_api_key
-      t.text :openrouter_api_key
-      t.text :gpustack_api_key
-      t.text :xai_api_key
-      t.text :ollama_api_key
-
-      # AWS Bedrock
-      t.text :bedrock_api_key
-      t.text :bedrock_secret_key
-      t.text :bedrock_session_token
-      t.string :bedrock_region
-
-      # Google Vertex AI
-      t.text :vertexai_credentials
-      t.string :vertexai_project_id
-      t.string :vertexai_location
-
-      # === Custom Endpoints ===
-      t.string :openai_api_base
-      t.string :gemini_api_base
-      t.string :ollama_api_base
-      t.string :gpustack_api_base
-      t.string :xai_api_base
-
-      # === OpenAI Options ===
-      t.string :openai_organization_id
-      t.string :openai_project_id
-
-      # === Default Models ===
-      t.string :default_model
-      t.string :default_embedding_model
-      t.string :default_image_model
-      t.string :default_moderation_model
-
-      # === Connection Settings ===
-      t.integer :request_timeout
-      t.integer :max_retries
-      t.decimal :retry_interval, precision: 5, scale: 2
-      t.decimal :retry_backoff_factor, precision: 5, scale: 2
-      t.decimal :retry_interval_randomness, precision: 5, scale: 2
-      t.string :http_proxy
-
-      # Whether to inherit from global config for unset values
-      t.boolean :inherit_global_defaults, default: true
-
-      t.timestamps
-    end
-
-    # Ensure unique scope_type + scope_id combinations
-    add_index :ruby_llm_agents_api_configurations, [:scope_type, :scope_id], unique: true, name: 'idx_api_configs_scope'
-
-    # Index for faster tenant lookups
-    add_index :ruby_llm_agents_api_configurations, :scope_id, name: 'idx_api_configs_scope_id'
-  end
-end