activeagent 1.1.0 → 1.2.0

data/lib/active_agent/dashboard/app/models/active_agent/dashboard/agent.rb

@@ -1,256 +0,0 @@
-# frozen_string_literal: true
-
-module ActiveAgent
-  module Dashboard
-    # Represents an AI agent configuration.
-    #
-    # Agents are the core entity in the dashboard, storing all configuration
-    # needed to execute AI interactions including provider settings, instructions,
-    # tools, and appearance.
-    #
-    # Supports both local (single-user) and multi-tenant (account-scoped) modes.
-    #
-    # @example Creating an agent
-    #   agent = ActiveAgent::Dashboard::Agent.create!(
-    #     name: "Code Assistant",
-    #     provider: "openai",
-    #     model: "gpt-4o"
-    #   )
-    #
-    # @example Executing an agent
-    #   run = agent.execute("Explain this code", code: "def foo; end")
-    #
-    class Agent < ApplicationRecord
-      # Associations - owner is optional to support both modes
-      belongs_to :user, class_name: ActiveAgent::Dashboard.user_class, optional: true if ActiveAgent::Dashboard.user_class
-      belongs_to :account, class_name: ActiveAgent::Dashboard.account_class, optional: true if ActiveAgent::Dashboard.multi_tenant?
-
-      has_many :agent_versions, class_name: "ActiveAgent::Dashboard::AgentVersion", dependent: :destroy
-      has_many :agent_runs, class_name: "ActiveAgent::Dashboard::AgentRun", dependent: :destroy
-
-      # Validations
-      validates :name, presence: true, length: { minimum: 2, maximum: 100 }
-      validates :slug, presence: true, format: { with: /\A[a-z0-9\-_]+\z/ }
-      validates :provider, presence: true
-      validates :model, presence: true
-
-      # Ensure slug uniqueness within scope
-      if ActiveAgent::Dashboard.multi_tenant?
-        validates :slug, uniqueness: { scope: :account_id }
-      else
-        validates :slug, uniqueness: { scope: :user_id }
-      end
-
-      # Status enum
-      enum :status, { draft: 0, active: 1, archived: 2 }
-
-      # Callbacks
-      before_validation :generate_slug, on: :create
-      after_create :create_initial_version
-      after_update :create_version_on_config_change, if: :configuration_changed?
-
-      # Scopes
-      scope :active_agents, -> { where(status: :active) }
-      scope :by_provider, ->(provider) { where(provider: provider) }
-      scope :with_tool, ->(tool) { where("tools @> ?", [ tool ].to_json) }
-
-      # Available presets matching AgentAvatar component
-      PRESET_TYPES = %w[
-        terminal webDeveloper documentAnalysis writing translation
-        playwright research imageAnalysis computerUse productDesign
-      ].freeze
-
-      # Available instruction sets
-      INSTRUCTION_SETS = %w[
-        github ruby rails aws gcp python typescript docker kubernetes
-      ].freeze
-
-      # Available tools/MCPs
-      AVAILABLE_TOOLS = %w[
-        terminal playwright filesystem code database slack fetch search edit translate memory
-      ].freeze
-
-      # Available providers
-      PROVIDERS = %w[openai anthropic ollama openrouter requesty].freeze
-
-      # Returns the configuration as a hash for versioning
-      def configuration_snapshot
-        {
-          name: name,
-          description: description,
-          provider: provider,
-          model: model,
-          instructions: instructions,
-          preset_type: preset_type,
-          appearance: appearance,
-          instruction_sets: instruction_sets,
-          tools: tools,
-          mcp_servers: mcp_servers,
-          model_config: model_config,
-          response_format: response_format
-        }
-      end
-
-      # Restore from a version
-      def restore_from_version!(version)
-        config = version.configuration_snapshot
-        update!(
-          instructions: config["instructions"],
-          preset_type: config["preset_type"],
-          appearance: config["appearance"],
-          instruction_sets: config["instruction_sets"],
-          tools: config["tools"],
-          mcp_servers: config["mcp_servers"],
-          model_config: config["model_config"],
-          response_format: config["response_format"]
-        )
-      end
-
-      # Get the latest version
-      def latest_version
-        agent_versions.order(version_number: :desc).first
-      end
-
-      # Get version count
-      def version_count
-        agent_versions.count
-      end
-
-      # Generate Ruby agent class code
-      def to_agent_class_code
-        <<~RUBY
-          class #{agent_class_name || name.camelize}Agent < ApplicationAgent
-            generate_with :#{provider}, model: "#{model}"#{model_config_code}
-
-            def perform
-              prompt#{instructions_code}
-            end
-          end
-        RUBY
-      end
-
-      # Execute a run with this agent
-      def execute(input_prompt, **params)
-        run = agent_runs.create!(
-          input_prompt: input_prompt,
-          input_params: params,
-          status: :pending,
-          trace_id: SecureRandom.uuid
-        )
-
-        # Queue the execution job
-        ActiveAgent::Dashboard::AgentExecutionJob.perform_later(run.id)
-
-        run
-      end
-
-      # Quick test execution (synchronous)
-      def test_execute(input_prompt, **params)
-        run = agent_runs.create!(
-          input_prompt: input_prompt,
-          input_params: params,
-          status: :running,
-          trace_id: SecureRandom.uuid,
-          started_at: Time.current
-        )
-
-        begin
-          result = build_and_execute_agent(input_prompt, **params)
-
-          run.update!(
-            output: result[:output],
-            output_metadata: result[:metadata],
-            status: :complete,
-            completed_at: Time.current,
-            duration_ms: ((Time.current - run.started_at) * 1000).to_i,
-            input_tokens: result.dig(:usage, :input_tokens),
-            output_tokens: result.dig(:usage, :output_tokens),
-            total_tokens: result.dig(:usage, :total_tokens)
-          )
-        rescue => e
-          run.update!(
-            status: :failed,
-            completed_at: Time.current,
-            error_message: e.message,
-            error_backtrace: e.backtrace&.first(10)&.join("\n")
-          )
-        end
-
-        run
-      end
-
-      private
-
-      def generate_slug
-        return if slug.present?
-
-        base_slug = name.to_s.parameterize
-        self.slug = base_slug
-
-        # Ensure uniqueness within scope
-        counter = 1
-        scope = self.class.where(slug: slug)
-        scope = scope.where(account_id: account_id) if respond_to?(:account_id) && account_id
-        scope = scope.where(user_id: user_id) if respond_to?(:user_id) && user_id
-
-        while scope.exists?
-          self.slug = "#{base_slug}-#{counter}"
-          scope = self.class.where(slug: slug)
-          scope = scope.where(account_id: account_id) if respond_to?(:account_id) && account_id
-          scope = scope.where(user_id: user_id) if respond_to?(:user_id) && user_id
-          counter += 1
-        end
-      end
-
-      def create_initial_version
-        agent_versions.create!(
-          version_number: 1,
-          change_summary: "Initial creation",
-          configuration_snapshot: configuration_snapshot
-        )
-      end
-
-      def configuration_changed?
-        saved_changes.keys.any? do |key|
-          %w[instructions preset_type appearance instruction_sets tools mcp_servers model_config response_format].include?(key)
-        end
-      end
-
-      def create_version_on_config_change
-        next_version = (latest_version&.version_number || 0) + 1
-        changed_fields = saved_changes.keys.select do |key|
-          %w[instructions preset_type appearance instruction_sets tools mcp_servers model_config response_format].include?(key)
-        end
-
-        agent_versions.create!(
-          version_number: next_version,
-          change_summary: "Updated: #{changed_fields.join(', ')}",
-          configuration_snapshot: configuration_snapshot
-        )
-      end
-
-      def model_config_code
-        return "" if model_config.blank?
-
-        configs = model_config.map { |k, v| "#{k}: #{v.inspect}" }.join(", ")
-        ", #{configs}"
-      end
-
-      def instructions_code
-        return "" if instructions.blank?
-
-        "\n    prompt instructions: <<~INSTRUCTIONS\n      #{instructions.gsub("\n", "\n      ")}\n    INSTRUCTIONS"
-      end
-
-      def build_and_execute_agent(input_prompt, **params)
-        # TODO: Implement actual ActiveAgent execution
-        # This will create a dynamic agent class and execute it
-        {
-          output: "Mock response for: #{input_prompt}",
-          metadata: { provider: provider, model: model },
-          usage: { input_tokens: 10, output_tokens: 20, total_tokens: 30 }
-        }
-      end
-    end
-  end
-end

data/lib/active_agent/dashboard/app/models/active_agent/dashboard/agent_run.rb

@@ -1,113 +0,0 @@
-# frozen_string_literal: true
-
-module ActiveAgent
-  module Dashboard
-    # Tracks individual agent execution runs.
-    #
-    # Each run captures input, output, timing, token usage, and any errors
-    # that occurred during execution.
-    #
-    # @example Creating a run
-    #   run = agent.execute("Analyze this code", code: code)
-    #   run.status # => "pending"
-    #
-    # @example Monitoring a run
-    #   run.in_progress? # => true
-    #   run.finished?    # => false
-    #
-    class AgentRun < ApplicationRecord
-      belongs_to :agent, class_name: "ActiveAgent::Dashboard::Agent"
-      has_one :session_recording, class_name: "ActiveAgent::Dashboard::SessionRecording", dependent: :nullify
-
-      # Status enum
-      enum :status, { pending: 0, running: 1, complete: 2, failed: 3, cancelled: 4 }
-
-      # Validations
-      validates :trace_id, presence: true
-
-      # Scopes
-      scope :recent, -> { order(created_at: :desc) }
-      scope :successful, -> { where(status: :complete) }
-      scope :failed_runs, -> { where(status: :failed) }
-      scope :today, -> { where("created_at >= ?", Time.current.beginning_of_day) }
-
-      # Callbacks
-      before_validation :set_trace_id, on: :create
-      after_update_commit :broadcast_update, if: :saved_change_to_status?
-
-      # Add a log entry
-      def add_log(message, level: :info)
-        new_logs = logs || []
-        new_logs << {
-          timestamp: Time.current.iso8601,
-          level: level.to_s,
-          message: message
-        }
-        update!(logs: new_logs)
-      end
-
-      # Calculate duration if not set
-      def calculated_duration_ms
-        return duration_ms if duration_ms.present?
-        return nil unless started_at && completed_at
-
-        ((completed_at - started_at) * 1000).to_i
-      end
-
-      # Check if run is still in progress
-      def in_progress?
-        pending? || running?
-      end
-
-      # Check if run is finished
-      def finished?
-        complete? || failed? || cancelled?
-      end
-
-      # Get a summary for display
-      def summary
-        {
-          id: id,
-          status: status,
-          input_preview: input_prompt&.truncate(100),
-          output_preview: output&.truncate(200),
-          duration_ms: calculated_duration_ms,
-          tokens: total_tokens,
-          created_at: created_at,
-          error: error_message
-        }
-      end
-
-      # Stream output updates via ActionCable
-      def broadcast_update
-        return unless defined?(ActionCable)
-
-        ActionCable.server.broadcast(
-          "agent_run_#{id}",
-          {
-            type: "update",
-            run: summary
-          }
-        )
-      end
-
-      # Cancel a running execution
-      def cancel!
-        return unless in_progress?
-
-        update!(
-          status: :cancelled,
-          completed_at: Time.current,
-          error_message: "Cancelled by user"
-        )
-        broadcast_update
-      end
-
-      private
-
-      def set_trace_id
-        self.trace_id ||= SecureRandom.uuid
-      end
-    end
-  end
-end

data/lib/active_agent/dashboard/app/models/active_agent/dashboard/agent_template.rb

@@ -1,208 +0,0 @@
-# frozen_string_literal: true
-
-module ActiveAgent
-  module Dashboard
-    # Pre-built agent templates for quick agent creation.
-    #
-    # Templates provide starting configurations for common use cases like
-    # code assistance, research, writing, and browser automation.
-    #
-    # @example Creating an agent from a template
-    #   template = ActiveAgent::Dashboard::AgentTemplate.find_by(slug: "code-assistant")
-    #   agent = template.create_agent_for(user)
-    #
-    class AgentTemplate < ApplicationRecord
-      # Validations
-      validates :name, presence: true
-      validates :slug, presence: true, uniqueness: true
-      validates :category, presence: true
-
-      # Scopes
-      scope :featured, -> { where(featured: true) }
-      scope :by_category, ->(cat) { where(category: cat) }
-      scope :popular, -> { order(usage_count: :desc) }
-      scope :public_templates, -> { where(public: true) }
-      scope :free_tier, -> { where(free_tier: true) }
-
-      # Categories
-      CATEGORIES = %w[
-        productivity
-        development
-        research
-        creative
-        data
-        automation
-      ].freeze
-
-      # Create an agent from this template for a user/account
-      def create_agent_for(owner, name: nil)
-        agent_class = ActiveAgent::Dashboard::Agent
-
-        agent = agent_class.new(
-          name: name || self.name,
-          description: description,
-          provider: provider,
-          model: model,
-          instructions: instructions,
-          preset_type: preset_type,
-          appearance: appearance,
-          instruction_sets: instruction_sets,
-          tools: tools,
-          mcp_servers: mcp_servers,
-          model_config: model_config,
-          status: :draft
-        )
-
-        # Set owner based on mode
-        if ActiveAgent::Dashboard.multi_tenant? && owner.respond_to?(:id)
-          agent.account = owner
-        elsif owner.respond_to?(:id)
-          agent.user = owner if agent.respond_to?(:user=)
-        end
-
-        if agent.save
-          increment!(:usage_count)
-        end
-
-        agent
-      end
-
-      # Seed default templates
-      def self.seed_defaults!
-        templates = [
-          {
-            name: "Code Assistant",
-            slug: "code-assistant",
-            description: "A helpful coding assistant that can explain code, suggest improvements, and help debug issues.",
-            category: "development",
-            provider: "openai",
-            model: "gpt-4o",
-            preset_type: "terminal",
-            appearance: { hat: "fedora", heldItem: "terminal" },
-            instruction_sets: %w[github ruby rails typescript],
-            tools: %w[terminal code filesystem],
-            model_config: { temperature: 0.3 },
-            instructions: "You are a senior software engineer with expertise in multiple programming languages. Help users with:\n- Code explanations and reviews\n- Debugging issues\n- Suggesting best practices\n- Writing tests\n\nAlways explain your reasoning and provide examples when helpful.",
-            icon: "💻",
-            featured: true,
-            free_tier: true
-          },
-          {
-            name: "Research Assistant",
-            slug: "research-assistant",
-            description: "Helps research topics, summarize information, and organize findings.",
-            category: "research",
-            provider: "anthropic",
-            model: "claude-sonnet-4-20250514",
-            preset_type: "research",
-            appearance: { hat: "safari", heldItem: "magnifyingGlass" },
-            instruction_sets: %w[github python],
-            tools: %w[fetch search memory],
-            model_config: { temperature: 0.5 },
-            instructions: "You are a thorough research assistant. Help users by:\n- Searching for relevant information\n- Summarizing complex topics\n- Organizing findings into clear reports\n- Identifying key insights and patterns\n\nAlways cite sources when available and distinguish between facts and opinions.",
-            icon: "🔍",
-            featured: true,
-            free_tier: true
-          },
-          {
-            name: "Writing Assistant",
-            slug: "writing-assistant",
-            description: "Helps with writing, editing, and improving text content.",
-            category: "creative",
-            provider: "openai",
-            model: "gpt-4o",
-            preset_type: "writing",
-            appearance: { hat: "fedora", hatAccessory: "feather", heldItem: "scroll" },
-            instruction_sets: [],
-            tools: %w[edit translate],
-            model_config: { temperature: 0.7 },
-            instructions: "You are a skilled writer and editor. Help users with:\n- Writing and editing content\n- Improving clarity and flow\n- Adjusting tone for different audiences\n- Grammar and style corrections\n\nMaintain the author's voice while suggesting improvements.",
-            icon: "✍️",
-            featured: true,
-            free_tier: true
-          },
-          {
-            name: "Browser Automation",
-            slug: "browser-automation",
-            description: "Automates web browsing tasks like form filling, data extraction, and testing.",
-            category: "automation",
-            provider: "anthropic",
-            model: "claude-sonnet-4-20250514",
-            preset_type: "playwright",
-            appearance: { hat: "fedora", hatAccessory: "theaterMasks", heldItem: "browser" },
-            instruction_sets: %w[typescript],
-            tools: %w[playwright filesystem],
-            model_config: { temperature: 0.2 },
-            instructions: "You are a browser automation specialist. Help users by:\n- Navigating web pages\n- Filling out forms\n- Extracting data from websites\n- Testing web applications\n\nAlways wait for page loads and handle errors gracefully.",
-            icon: "🎭",
-            featured: false,
-            free_tier: true
-          },
-          {
-            name: "Data Analyst",
-            slug: "data-analyst",
-            description: "Analyzes data, creates visualizations, and provides insights.",
-            category: "data",
-            provider: "openai",
-            model: "gpt-4o",
-            preset_type: "documentAnalysis",
-            appearance: { hat: "fedora", heldItem: "document" },
-            instruction_sets: %w[python],
-            tools: %w[code database filesystem],
-            model_config: { temperature: 0.3 },
-            instructions: "You are a data analyst. Help users by:\n- Analyzing datasets\n- Creating visualizations\n- Finding patterns and insights\n- Generating reports\n\nExplain your methodology and provide clear interpretations of results.",
-            icon: "📊",
-            featured: true,
-            free_tier: true
-          },
-          {
-            name: "DevOps Assistant",
-            slug: "devops-assistant",
-            description: "Helps with infrastructure, deployments, and system administration.",
-            category: "development",
-            provider: "openai",
-            model: "gpt-4o",
-            preset_type: "terminal",
-            appearance: { hat: "fedora", heldItem: "terminal" },
-            instruction_sets: %w[docker kubernetes aws gcp],
-            tools: %w[terminal filesystem code],
-            model_config: { temperature: 0.2 },
-            instructions: "You are a DevOps engineer. Help users with:\n- Infrastructure setup and management\n- CI/CD pipeline configuration\n- Container orchestration\n- Cloud resource management\n\nAlways prioritize security and follow best practices.",
-            icon: "🚀",
-            featured: false,
-            free_tier: true
-          },
-          {
-            name: "PlaywrightMCP Demo",
-            slug: "playwright-mcp-demo",
-            description: "Free browser automation demo using Playwright MCP. Navigate sites, take screenshots, and extract content.",
-            category: "automation",
-            provider: "anthropic",
-            model: "claude-sonnet-4-20250514",
-            preset_type: "playwright",
-            appearance: { hat: "fedora", hatAccessory: "theaterMasks", heldItem: "browser" },
-            instruction_sets: [],
-            tools: %w[playwright],
-            mcp_servers: {
-              playwright: {
-                command: "npx",
-                args: [ "-y", "@anthropic/mcp-server-playwright" ]
-              }
-            },
-            model_config: { temperature: 0.2, max_tokens: 4096 },
-            instructions: "You are a browser automation assistant using Playwright MCP.\n\nAvailable actions:\n- browser_navigate: Go to a URL\n- browser_snapshot: Get the accessibility tree\n- browser_click: Click on an element\n- browser_type: Type text into an input\n- browser_take_screenshot: Capture the page\n- browser_wait_for: Wait for text or element\n\nGuidelines:\n1. Always take a snapshot first to understand the page\n2. Use element refs from snapshots for interactions\n3. Wait for page loads before taking actions\n4. Handle errors gracefully\n5. Limit yourself to 10 steps maximum\n\nAlways describe what you see and what actions you're taking.",
-            icon: "🎭",
-            featured: true,
-            free_tier: true
-          }
-        ]
-
-        templates.each do |template_attrs|
-          find_or_create_by!(slug: template_attrs[:slug]) do |t|
-            t.assign_attributes(template_attrs)
-          end
-        end
-      end
-    end
-  end
-end

data/lib/active_agent/dashboard/app/models/active_agent/dashboard/agent_version.rb

@@ -1,60 +0,0 @@
-# frozen_string_literal: true
-
-module ActiveAgent
-  module Dashboard
-    # Tracks version history for agent configurations.
-    #
-    # Each time an agent's configuration changes, a new version is created
-    # with a snapshot of the configuration at that point in time.
-    #
-    # @example Comparing versions
-    #   v1 = agent.agent_versions.find_by(version_number: 1)
-    #   v2 = agent.agent_versions.find_by(version_number: 2)
-    #   changes = v2.diff(v1)
-    #
-    class AgentVersion < ApplicationRecord
-      belongs_to :agent, class_name: "ActiveAgent::Dashboard::Agent"
-
-      validates :version_number, presence: true, uniqueness: { scope: :agent_id }
-      validates :configuration_snapshot, presence: true
-
-      # Scopes
-      scope :recent, -> { order(version_number: :desc) }
-      scope :by_version, ->(num) { where(version_number: num) }
-
-      # Compare two versions
-      def diff(other_version)
-        return {} unless other_version
-
-        changes = {}
-        configuration_snapshot.each do |key, value|
-          other_value = other_version.configuration_snapshot[key]
-          if value != other_value
-            changes[key] = { from: other_value, to: value }
-          end
-        end
-        changes
-      end
-
-      # Get previous version
-      def previous
-        agent.agent_versions.where("version_number < ?", version_number).order(version_number: :desc).first
-      end
-
-      # Get next version
-      def next_version
-        agent.agent_versions.where("version_number > ?", version_number).order(version_number: :asc).first
-      end
-
-      # Check if this is the latest version
-      def latest?
-        agent.latest_version&.id == id
-      end
-
-      # Check if this is the initial version
-      def initial?
-        version_number == 1
-      end
-    end
-  end
-end

data/lib/active_agent/dashboard/app/models/active_agent/dashboard/application_record.rb

@@ -1,46 +0,0 @@
-# frozen_string_literal: true
-
-module ActiveAgent
-  module Dashboard
-    # Base class for all Dashboard engine models.
-    #
-    # Provides multi-tenant support when configured, allowing the same models
-    # to work in both local (single-tenant) and platform (multi-tenant) modes.
-    class ApplicationRecord < ::ActiveRecord::Base
-      self.abstract_class = true
-
-      # Override table name calculation to use active_agent_ prefix
-      # without the "dashboard_" from the module namespace
-      def self.table_name
-        @table_name ||= "active_agent_#{name.demodulize.underscore.pluralize}"
-      end
-
-      class << self
-        # Returns the owner association name based on configuration.
-        # In multi-tenant mode, this returns :account.
-        # In local mode, this returns :user (optional).
-        def owner_association
-          if ActiveAgent::Dashboard.multi_tenant?
-            :account
-          else
-            :user
-          end
-        end
-
-        # Scopes records to the current owner (account or user).
-        # No-op in local mode without owner configuration.
-        def for_owner(owner)
-          return all if owner.nil?
-
-          if ActiveAgent::Dashboard.multi_tenant?
-            where(account: owner)
-          elsif column_names.include?("user_id")
-            where(user: owner)
-          else
-            all
-          end
-        end
-      end
-    end
-  end
-end