activeagent 1.0.3 → 1.2.0

data/lib/generators/active_agent/dashboard/install/install_generator.rb

@@ -1,96 +0,0 @@
-# frozen_string_literal: true
-
-require "rails/generators"
-require "rails/generators/active_record"
-
-module ActiveAgent
-  module Dashboard
-    module Generators
-      # Generator for installing the ActiveAgent Dashboard engine.
-      #
-      # Usage:
-      #   rails generate active_agent:dashboard:install
-      #
-      # This will:
-      # - Copy migration files for all dashboard models
-      # - Create an initializer for configuration
-      # - Add the engine mount to routes.rb
-      # - Seed default agent templates
-      #
-      class InstallGenerator < Rails::Generators::Base
-        include ActiveRecord::Generators::Migration
-
-        source_root File.expand_path("templates", __dir__)
-
-        class_option :multi_tenant, type: :boolean, default: false,
-          desc: "Configure for multi-tenant mode with account association"
-
-        class_option :skip_migrations, type: :boolean, default: false,
-          desc: "Skip copying migration files"
-
-        class_option :skip_routes, type: :boolean, default: false,
-          desc: "Skip adding route mount"
-
-        def copy_migrations
-          return if options[:skip_migrations]
-
-          migration_template "migrations/create_active_agent_agents.rb",
-            "db/migrate/create_active_agent_agents.rb"
-
-          migration_template "migrations/create_active_agent_agent_versions.rb",
-            "db/migrate/create_active_agent_agent_versions.rb"
-
-          migration_template "migrations/create_active_agent_agent_runs.rb",
-            "db/migrate/create_active_agent_agent_runs.rb"
-
-          migration_template "migrations/create_active_agent_agent_templates.rb",
-            "db/migrate/create_active_agent_agent_templates.rb"
-
-          migration_template "migrations/create_active_agent_sandbox_sessions.rb",
-            "db/migrate/create_active_agent_sandbox_sessions.rb"
-
-          migration_template "migrations/create_active_agent_sandbox_runs.rb",
-            "db/migrate/create_active_agent_sandbox_runs.rb"
-
-          migration_template "migrations/create_active_agent_session_recordings.rb",
-            "db/migrate/create_active_agent_session_recordings.rb"
-
-          migration_template "migrations/create_active_agent_telemetry_traces.rb",
-            "db/migrate/create_active_agent_telemetry_traces.rb"
-        end
-
-        def create_initializer
-          template "initializer.rb", "config/initializers/active_agent_dashboard.rb"
-        end
-
-        def mount_engine
-          return if options[:skip_routes]
-
-          route 'mount ActiveAgent::Dashboard::Engine => "/active_agent"'
-        end
-
-        def show_post_install
-          say ""
-          say "ActiveAgent Dashboard installed!", :green
-          say ""
-          say "Next steps:"
-          say "  1. Run migrations: rails db:migrate"
-          say "  2. Seed templates:  rails active_agent:dashboard:seed"
-          say "  3. Configure authentication in config/initializers/active_agent_dashboard.rb"
-          say "  4. Visit /active_agent to access the dashboard"
-          say ""
-        end
-
-        private
-
-        def migration_version
-          "[#{ActiveRecord::Migration.current_version}]"
-        end
-
-        def multi_tenant?
-          options[:multi_tenant]
-        end
-      end
-    end
-  end
-end

data/lib/generators/active_agent/dashboard/install/templates/initializer.rb

@@ -1,89 +0,0 @@
-# frozen_string_literal: true
-
-# ActiveAgent Dashboard Configuration
-#
-# This initializer configures the ActiveAgent Dashboard engine.
-# See https://docs.activeagents.ai/dashboard for full documentation.
-
-ActiveAgent::Dashboard.configure do |config|
-  # ==========================================================================
-  # Authentication
-  # ==========================================================================
-
-  # Set an authentication method that will be called on all dashboard controllers.
-  # This should authenticate the user and redirect/raise if unauthorized.
-  #
-  # Examples:
-  #   config.authentication_method = ->(controller) { controller.authenticate_admin! }
-  #   config.authentication_method = ->(controller) { controller.authenticate_user! }
-  #
-  # config.authentication_method = nil
-
-<% if multi_tenant? -%>
-  # ==========================================================================
-  # Multi-tenant Mode
-  # ==========================================================================
-
-  # Enable multi-tenant mode for SaaS deployments with multiple accounts.
-  config.multi_tenant = true
-
-  # The Account model class name
-  config.account_class = "Account"
-
-  # The User model class name
-  config.user_class = "User"
-
-  # Method to call on controllers to get the current account
-  config.current_account_method = :current_account
-
-  # Method to call on controllers to get the current user
-  config.current_user_method = :current_user
-
-<% else -%>
-  # ==========================================================================
-  # Local Mode (default)
-  # ==========================================================================
-
-  # Multi-tenant mode is disabled by default.
-  # Set to true if you're building a SaaS platform with multiple accounts.
-  # config.multi_tenant = false
-
-  # Optional: Associate agents with users
-  # config.user_class = "User"
-  # config.current_user_method = :current_user
-
-<% end -%>
-  # ==========================================================================
-  # Sandbox Configuration
-  # ==========================================================================
-
-  # Sandbox service type for agent execution environments.
-  # Options: :local (Docker/Incus), :cloud_run, :kubernetes
-  config.sandbox_service = :local
-
-  # Custom sandbox limits (optional)
-  # config.sandbox_limits = {
-  #   max_runs: 10,
-  #   timeout_seconds: 300,
-  #   max_tokens: 50_000,
-  #   session_duration_minutes: 15
-  # }
-
-  # ==========================================================================
-  # UI Configuration
-  # ==========================================================================
-
-  # Use Inertia.js with React for the frontend (requires additional setup)
-  # config.use_inertia = false
-
-  # Custom layout for dashboard views
-  # config.layout = "application"
-
-  # ==========================================================================
-  # Storage Configuration
-  # ==========================================================================
-
-  # Storage service for screenshots and snapshots.
-  # Must respond to #signed_url_for(key, expires_in:) and #fetch_snapshot(key)
-  # config.storage_service = MyStorageService.new
-end

data/lib/generators/active_agent/dashboard/install/templates/migrations/create_active_agent_agent_runs.rb

@@ -1,42 +0,0 @@
-# frozen_string_literal: true
-
-class CreateActiveAgentAgentRuns < ActiveRecord::Migration<%= migration_version %>
-  def change
-    create_table :active_agent_agent_runs do |t|
-      t.references :agent, null: false, foreign_key: { to_table: :active_agent_agents }
-
-      # Input
-      t.text :input_prompt
-      t.jsonb :input_params, default: {}
-
-      # Output
-      t.text :output
-      t.jsonb :output_metadata, default: {}
-
-      # Execution details
-      t.integer :status, default: 0, null: false
-      t.integer :duration_ms
-      t.datetime :started_at
-      t.datetime :completed_at
-
-      # Token usage
-      t.integer :input_tokens
-      t.integer :output_tokens
-      t.integer :total_tokens
-
-      # Error tracking
-      t.text :error_message
-      t.text :error_backtrace
-
-      # Trace for debugging
-      t.string :trace_id
-      t.jsonb :logs, default: []
-
-      t.timestamps
-    end
-
-    add_index :active_agent_agent_runs, :status
-    add_index :active_agent_agent_runs, :trace_id
-    add_index :active_agent_agent_runs, :created_at
-  end
-end

data/lib/generators/active_agent/dashboard/install/templates/migrations/create_active_agent_agent_templates.rb

@@ -1,38 +0,0 @@
-# frozen_string_literal: true
-
-class CreateActiveAgentAgentTemplates < ActiveRecord::Migration<%= migration_version %>
-  def change
-    create_table :active_agent_agent_templates do |t|
-      t.string :name, null: false
-      t.string :slug, null: false
-      t.text :description
-      t.string :category
-
-      # Template configuration (same as agents)
-      t.string :provider, default: "openai"
-      t.string :model, default: "gpt-4o-mini"
-      t.text :instructions
-      t.string :preset_type
-      t.jsonb :appearance, default: {}
-      t.jsonb :instruction_sets, default: []
-      t.jsonb :tools, default: []
-      t.jsonb :mcp_servers, default: {}
-      t.jsonb :model_config, default: {}
-
-      # Metadata
-      t.string :icon
-      t.integer :usage_count, default: 0
-      t.boolean :featured, default: false
-      t.boolean :public, default: true
-      t.boolean :free_tier, default: true
-
-      t.timestamps
-    end
-
-    add_index :active_agent_agent_templates, :slug, unique: true
-    add_index :active_agent_agent_templates, :category
-    add_index :active_agent_agent_templates, :featured
-    add_index :active_agent_agent_templates, :usage_count
-    add_index :active_agent_agent_templates, :free_tier
-  end
-end

data/lib/generators/active_agent/dashboard/install/templates/migrations/create_active_agent_agent_versions.rb

@@ -1,22 +0,0 @@
-# frozen_string_literal: true
-
-class CreateActiveAgentAgentVersions < ActiveRecord::Migration<%= migration_version %>
-  def change
-    create_table :active_agent_agent_versions do |t|
-      t.references :agent, null: false, foreign_key: { to_table: :active_agent_agents }
-
-      t.integer :version_number, null: false, default: 1
-      t.string :change_summary
-
-      # Snapshot of agent configuration at this version
-      t.jsonb :configuration_snapshot, null: false, default: {}
-
-      # Who made the change
-      t.string :created_by
-
-      t.timestamps
-    end
-
-    add_index :active_agent_agent_versions, [:agent_id, :version_number], unique: true
-  end
-end

data/lib/generators/active_agent/dashboard/install/templates/migrations/create_active_agent_agents.rb

@@ -1,53 +0,0 @@
-# frozen_string_literal: true
-
-class CreateActiveAgentAgents < ActiveRecord::Migration<%= migration_version %>
-  def change
-    create_table :active_agent_agents do |t|
-      t.string :name, null: false
-      t.text :description
-      t.string :slug, null: false
-
-      # Agent class configuration
-      t.string :agent_class_name
-      t.string :provider, default: "openai"
-      t.string :model, default: "gpt-4o-mini"
-
-      # Instructions and system prompt
-      t.text :instructions
-
-      # Avatar/appearance configuration
-      t.string :preset_type
-      t.jsonb :appearance, default: {}
-
-      # Capabilities
-      t.jsonb :instruction_sets, default: []
-      t.jsonb :tools, default: []
-      t.jsonb :mcp_servers, default: []
-
-      # Model configuration
-      t.jsonb :model_config, default: {}
-
-      # Response format
-      t.jsonb :response_format, default: {}
-
-      # Status
-      t.integer :status, default: 0, null: false
-
-      # Owner associations (optional)
-      t.references :user, foreign_key: true, null: true
-<% if multi_tenant? -%>
-      t.references :account, foreign_key: true, null: true
-<% end -%>
-
-      t.timestamps
-    end
-
-<% if multi_tenant? -%>
-    add_index :active_agent_agents, [:account_id, :slug], unique: true
-<% else -%>
-    add_index :active_agent_agents, [:user_id, :slug], unique: true
-<% end -%>
-    add_index :active_agent_agents, :status
-    add_index :active_agent_agents, :provider
-  end
-end

data/lib/generators/active_agent/dashboard/install/templates/migrations/create_active_agent_sandbox_runs.rb

@@ -1,28 +0,0 @@
-# frozen_string_literal: true
-
-class CreateActiveAgentSandboxRuns < ActiveRecord::Migration<%= migration_version %>
-  def change
-    create_table :active_agent_sandbox_runs do |t|
-      t.references :sandbox_session, foreign_key: { to_table: :active_agent_sandbox_sessions }, null: true
-
-      t.text :task, null: false
-      t.integer :status, default: 0, null: false
-
-      # Execution details
-      t.text :result
-      t.text :error
-      t.integer :duration_ms
-      t.integer :tokens_used
-      t.datetime :started_at
-      t.datetime :completed_at
-
-      # Screenshots
-      t.jsonb :screenshots, default: []
-
-      t.timestamps
-    end
-
-    add_index :active_agent_sandbox_runs, :status
-    add_index :active_agent_sandbox_runs, :created_at
-  end
-end

data/lib/generators/active_agent/dashboard/install/templates/migrations/create_active_agent_sandbox_sessions.rb

@@ -1,43 +0,0 @@
-# frozen_string_literal: true
-
-class CreateActiveAgentSandboxSessions < ActiveRecord::Migration<%= migration_version %>
-  def change
-    create_table :active_agent_sandbox_sessions do |t|
-      t.string :session_id, null: false
-      t.references :user, foreign_key: true, null: true
-<% if multi_tenant? -%>
-      t.references :account, foreign_key: true, null: true
-<% end -%>
-      t.references :agent_template, foreign_key: { to_table: :active_agent_agent_templates }, null: true
-
-      # Session metadata
-      t.string :sandbox_type, default: "playwright_mcp"
-      t.integer :status, default: 0
-      t.string :cloud_run_job_id
-      t.string :cloud_run_url
-
-      # Execution tracking
-      t.integer :runs_count, default: 0
-      t.integer :max_runs, default: 10
-      t.integer :timeout_seconds, default: 300
-      t.datetime :expires_at
-      t.datetime :last_activity_at
-
-      # Resource usage
-      t.integer :total_tokens, default: 0
-      t.integer :total_duration_ms, default: 0
-
-      # Results
-      t.jsonb :runs, default: []
-      t.text :error_message
-
-      t.timestamps
-    end
-
-    add_index :active_agent_sandbox_sessions, :session_id, unique: true
-    add_index :active_agent_sandbox_sessions, :status
-    add_index :active_agent_sandbox_sessions, :sandbox_type
-    add_index :active_agent_sandbox_sessions, :expires_at
-    add_index :active_agent_sandbox_sessions, :cloud_run_job_id
-  end
-end

data/lib/generators/active_agent/dashboard/install/templates/migrations/create_active_agent_session_recordings.rb

@@ -1,44 +0,0 @@
-# frozen_string_literal: true
-
-class CreateActiveAgentSessionRecordings < ActiveRecord::Migration<%= migration_version %>
-  def change
-    create_table :active_agent_session_recordings do |t|
-      t.references :agent_run, null: true, foreign_key: { to_table: :active_agent_agent_runs }
-      t.references :sandbox_session, null: true, foreign_key: { to_table: :active_agent_sandbox_sessions }
-      t.string :name
-      t.integer :status, default: 0, null: false
-      t.integer :duration_ms
-      t.integer :action_count, default: 0
-      t.jsonb :metadata, default: {}
-      t.timestamps
-    end
-
-    create_table :active_agent_recording_actions do |t|
-      t.references :session_recording, null: false, foreign_key: { to_table: :active_agent_session_recordings }
-      t.string :action_type, null: false
-      t.integer :sequence, null: false
-      t.integer :timestamp_ms, null: false
-      t.string :selector
-      t.text :value
-      t.string :screenshot_key
-      t.string :dom_snapshot_key
-      t.jsonb :metadata, default: {}
-      t.timestamps
-    end
-
-    add_index :active_agent_recording_actions, [:session_recording_id, :sequence], unique: true, name: "idx_recording_actions_on_recording_and_sequence"
-
-    create_table :active_agent_recording_snapshots do |t|
-      t.references :session_recording, null: false, foreign_key: { to_table: :active_agent_session_recordings }
-      t.references :recording_action, null: true, foreign_key: { to_table: :active_agent_recording_actions }
-      t.string :storage_key, null: false
-      t.string :snapshot_type, null: false
-      t.integer :width
-      t.integer :height
-      t.integer :file_size_bytes
-      t.timestamps
-    end
-
-    add_index :active_agent_recording_snapshots, :storage_key, unique: true
-  end
-end

data/lib/generators/active_agent/dashboard/install/templates/migrations/create_active_agent_telemetry_traces.rb

@@ -1,56 +0,0 @@
-# frozen_string_literal: true
-
-class CreateActiveAgentTelemetryTraces < ActiveRecord::Migration<%= migration_version %>
-  def change
-    create_table :active_agent_telemetry_traces do |t|
-<% if multi_tenant? -%>
-      t.references :account, foreign_key: true, null: true
-<% end -%>
-
-      # Trace identification
-      t.string :trace_id, null: false
-      t.string :service_name
-      t.string :environment
-
-      # Timing
-      t.datetime :timestamp, null: false
-
-      # Span data (JSON array of spans)
-      t.jsonb :spans, default: []
-
-      # Resource attributes
-      t.jsonb :resource_attributes, default: {}
-
-      # SDK info
-      t.jsonb :sdk_info, default: {}
-
-      # Aggregated metrics (for quick queries)
-      t.integer :total_duration_ms
-      t.integer :total_input_tokens, default: 0
-      t.integer :total_output_tokens, default: 0
-      t.integer :total_thinking_tokens, default: 0
-
-      # Status
-      t.string :status, default: "UNSET"
-
-      # Agent info (denormalized for queries)
-      t.string :agent_class
-      t.string :agent_action
-
-      # Error info
-      t.text :error_message
-
-      t.timestamps
-    end
-
-    add_index :active_agent_telemetry_traces, :trace_id, unique: true
-    add_index :active_agent_telemetry_traces, :timestamp
-    add_index :active_agent_telemetry_traces, :service_name
-    add_index :active_agent_telemetry_traces, :environment
-    add_index :active_agent_telemetry_traces, :agent_class
-    add_index :active_agent_telemetry_traces, :status
-<% if multi_tenant? -%>
-    add_index :active_agent_telemetry_traces, [:account_id, :timestamp]
-<% end -%>
-  end
-end

data/lib/generators/active_agent/dashboard/install_generator.rb

@@ -1,64 +0,0 @@
-# frozen_string_literal: true
-
-require "rails/generators"
-require "rails/generators/active_record"
-
-module ActiveAgent
-  module Dashboard
-    # Generator for installing the ActiveAgent Dashboard.
-    #
-    # @example Run the generator
-    #   rails generate active_agent:dashboard:install
-    #
-    # This will:
-    # - Create the telemetry_traces table migration
-    # - Add mount directive to routes
-    # - Create initializer for dashboard configuration
-    #
-    class InstallGenerator < Rails::Generators::Base
-      include ActiveRecord::Generators::Migration
-
-      source_root File.expand_path("templates", __dir__)
-
-      desc "Installs the ActiveAgent Dashboard with telemetry storage"
-
-      def copy_migrations
-        migration_template(
-          "create_active_agent_telemetry_traces.rb.erb",
-          "db/migrate/create_active_agent_telemetry_traces.rb"
-        )
-      end
-
-      def add_route
-        route 'mount ActiveAgent::Dashboard::Engine => "/active_agent"'
-      end
-
-      def create_initializer
-        template(
-          "active_agent_dashboard.rb.erb",
-          "config/initializers/active_agent_dashboard.rb"
-        )
-      end
-
-      def show_readme
-        say "\n"
-        say "ActiveAgent Dashboard installed successfully!", :green
-        say "\n"
-        say "Next steps:"
-        say "  1. Run migrations: rails db:migrate"
-        say "  2. Configure telemetry in config/active_agent.yml:"
-        say "     telemetry:"
-        say "       enabled: true"
-        say "       local_storage: true"
-        say "  3. Visit /active_agent to view the dashboard"
-        say "\n"
-      end
-
-      private
-
-      def migration_version
-        "[#{ActiveRecord::Migration.current_version}]"
-      end
-    end
-  end
-end

data/lib/generators/active_agent/dashboard/templates/active_agent_dashboard.rb.erb

@@ -1,30 +0,0 @@
-# frozen_string_literal: true
-
-# ActiveAgent Dashboard Configuration
-#
-# This file configures the ActiveAgent telemetry dashboard.
-# The dashboard is mounted at /active_agent by default.
-
-ActiveAgent::Dashboard.configure do |config|
-  # Authentication method - provide a lambda that receives the controller
-  # and performs authentication. Return false or raise to deny access.
-  #
-  # Examples:
-  #
-  # Basic auth:
-  #   config.authentication_method = ->(controller) {
-  #     controller.authenticate_or_request_with_http_basic do |username, password|
-  #       username == "admin" && password == Rails.application.credentials.dashboard_password
-  #     end
-  #   }
-  #
-  # Devise:
-  #   config.authentication_method = ->(controller) {
-  #     controller.authenticate_admin!
-  #   }
-  #
-  # No authentication (development only!):
-  #   config.authentication_method = nil
-  #
-  config.authentication_method = nil
-end

data/lib/generators/active_agent/dashboard/templates/create_active_agent_telemetry_traces.rb.erb

@@ -1,30 +0,0 @@
-# frozen_string_literal: true
-
-class CreateActiveAgentTelemetryTraces < ActiveRecord::Migration<%= migration_version %>
-  def change
-    create_table :active_agent_telemetry_traces do |t|
-      t.string :trace_id, null: false, index: true
-      t.string :service_name
-      t.string :environment
-      t.datetime :timestamp, index: true
-      t.jsonb :spans, default: []
-      t.jsonb :resource_attributes, default: {}
-      t.jsonb :sdk_info, default: {}
-      t.decimal :total_duration_ms, precision: 12, scale: 3
-      t.integer :total_input_tokens, default: 0
-      t.integer :total_output_tokens, default: 0
-      t.integer :total_thinking_tokens, default: 0
-      t.string :status
-      t.string :agent_class, index: true
-      t.string :agent_action
-      t.text :error_message
-
-      t.timestamps
-    end
-
-    add_index :active_agent_telemetry_traces, :status
-    add_index :active_agent_telemetry_traces, [:agent_class, :agent_action]
-    add_index :active_agent_telemetry_traces, [:service_name, :environment]
-    add_index :active_agent_telemetry_traces, :created_at
-  end
-end