activeagent 1.0.1 → 1.0.2

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

@@ -0,0 +1,208 @@
+# 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

@@ -0,0 +1,60 @@
+# 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

@@ -0,0 +1,46 @@
+# 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

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

@@ -0,0 +1,125 @@
+# frozen_string_literal: true
+
+module ActiveAgent
+  module Dashboard
+    # Represents a single browser action within a session recording.
+    #
+    # Actions capture user and agent interactions like clicks, typing,
+    # navigation, and form submissions.
+    #
+    class RecordingAction < ApplicationRecord
+      belongs_to :session_recording, class_name: "ActiveAgent::Dashboard::SessionRecording"
+      has_one :snapshot, class_name: "ActiveAgent::Dashboard::RecordingSnapshot", dependent: :nullify
+
+      ACTION_TYPES = %w[
+        navigate
+        click
+        type
+        scroll
+        snapshot
+        select
+        hover
+        drag
+        file_upload
+        dialog
+        evaluate
+        wait
+        form_fill
+        key_press
+        focus
+        submit
+        handoff
+        user_action
+        completion
+      ].freeze
+
+      validates :action_type, presence: true, inclusion: { in: ACTION_TYPES }
+      validates :sequence, presence: true, uniqueness: { scope: :session_recording_id }
+      validates :timestamp_ms, presence: true
+
+      scope :ordered, -> { order(:sequence) }
+      scope :with_screenshots, -> { where.not(screenshot_key: nil) }
+
+      # Get the screenshot URL (signed URL from storage)
+      def screenshot_url(expires_in: 15.minutes)
+        return nil unless screenshot_key.present?
+
+        ActiveAgent::Dashboard.storage_service&.signed_url_for(screenshot_key, expires_in: expires_in)
+      end
+
+      # Get the DOM snapshot content
+      def dom_snapshot_content
+        return nil unless dom_snapshot_key.present?
+
+        ActiveAgent::Dashboard.storage_service&.fetch_snapshot(dom_snapshot_key)
+      end
+
+      # Format for API response
+      def as_json_for_api
+        {
+          id: id,
+          action_type: action_type,
+          sequence: sequence,
+          timestamp_ms: timestamp_ms,
+          selector: selector,
+          value: redacted_value,
+          screenshot_url: screenshot_url,
+          has_dom_snapshot: dom_snapshot_key.present?,
+          metadata: safe_metadata,
+          created_at: created_at.iso8601
+        }
+      end
+
+      # Get browser state at this action (for handoff)
+      def browser_state
+        {
+          url: extract_url,
+          form_values: metadata["form_values"],
+          scroll_position: metadata["scroll_position"],
+          active_element: selector,
+          action_type: action_type
+        }
+      end
+
+      private
+
+      def redacted_value
+        return value unless should_redact?
+
+        "[REDACTED]"
+      end
+
+      def should_redact?
+        return false unless value.present?
+
+        sensitive_patterns = [
+          /password/i,
+          /credit.?card/i,
+          /cvv/i,
+          /ssn/i,
+          /social.?security/i,
+          /\b\d{16}\b/,
+          /\b\d{3}-\d{2}-\d{4}\b/
+        ]
+
+        selector_is_sensitive = sensitive_patterns.any? { |p| selector&.match?(p) }
+        value_is_sensitive = sensitive_patterns.any? { |p| value.match?(p) }
+
+        selector_is_sensitive || value_is_sensitive
+      end
+
+      def safe_metadata
+        metadata.except("password", "credit_card", "cvv", "ssn")
+      end
+
+      def extract_url
+        case action_type
+        when "navigate"
+          value
+        else
+          metadata["url"] || metadata["page_url"]
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,83 @@
+# frozen_string_literal: true
+
+module ActiveAgent
+  module Dashboard
+    # Stores screenshots and DOM snapshots from session recordings.
+    #
+    # Supports Active Storage for file attachment and provides
+    # signed URLs for secure access.
+    #
+    class RecordingSnapshot < ApplicationRecord
+      belongs_to :session_recording, class_name: "ActiveAgent::Dashboard::SessionRecording"
+      belongs_to :recording_action, class_name: "ActiveAgent::Dashboard::RecordingAction", optional: true
+
+      has_one_attached :file if defined?(ActiveStorage)
+
+      SNAPSHOT_TYPES = %w[screenshot dom full_page].freeze
+
+      validates :storage_key, presence: true, uniqueness: true
+      validates :snapshot_type, presence: true, inclusion: { in: SNAPSHOT_TYPES }
+
+      scope :screenshots, -> { where(snapshot_type: "screenshot") }
+      scope :dom_snapshots, -> { where(snapshot_type: "dom") }
+      scope :ordered, -> { order(:created_at) }
+
+      # Get a signed URL for the file
+      def signed_url(expires_in: 15.minutes)
+        return nil unless respond_to?(:file) && file.attached?
+
+        file.url(expires_in: expires_in)
+      rescue StandardError
+        nil
+      end
+
+      # Store file data
+      def store!(data, filename: nil, content_type: nil)
+        return unless respond_to?(:file)
+
+        content_type ||= infer_content_type
+        filename ||= generate_filename
+
+        file.attach(
+          io: StringIO.new(data),
+          filename: filename,
+          content_type: content_type
+        )
+
+        update!(file_size_bytes: data.bytesize)
+      end
+
+      # For API response
+      def as_json_for_api
+        {
+          id: id,
+          storage_key: storage_key,
+          snapshot_type: snapshot_type,
+          width: width,
+          height: height,
+          file_size_bytes: file_size_bytes,
+          url: signed_url,
+          created_at: created_at.iso8601
+        }
+      end
+
+      private
+
+      def infer_content_type
+        case snapshot_type
+        when "screenshot", "full_page"
+          "image/png"
+        when "dom"
+          "text/html"
+        else
+          "application/octet-stream"
+        end
+      end
+
+      def generate_filename
+        ext = snapshot_type == "dom" ? "html" : "png"
+        "#{storage_key.tr('/', '_')}.#{ext}"
+      end
+    end
+  end
+end

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

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+module ActiveAgent
+  module Dashboard
+    # Tracks individual task executions within a sandbox session.
+    #
+    # Each sandbox run represents a single agent task execution,
+    # capturing input, output, timing, and any errors.
+    #
+    class SandboxRun < ApplicationRecord
+      belongs_to :sandbox_session, class_name: "ActiveAgent::Dashboard::SandboxSession", optional: true
+
+      enum :status, {
+        pending: 0,
+        running: 1,
+        completed: 2,
+        failed: 3,
+        cancelled: 4
+      }
+
+      validates :task, presence: true
+      validates :status, presence: true
+
+      scope :recent, -> { order(created_at: :desc) }
+      scope :completed_runs, -> { where(status: [ :completed, :failed ]) }
+
+      # Summary for API responses
+      def summary
+        {
+          id: id,
+          task: task.truncate(100),
+          status: status,
+          duration_ms: duration_ms,
+          tokens_used: tokens_used,
+          created_at: created_at&.iso8601,
+          completed_at: completed_at&.iso8601
+        }
+      end
+
+      # Detailed info including full result
+      def details
+        summary.merge(
+          task: task,
+          result: result,
+          error: error,
+          screenshots: screenshots || [],
+          started_at: started_at&.iso8601
+        )
+      end
+    end
+  end
+end