RubyGems - activeagent - Versions diffs - 1.1.0 → 1.2.0 - Mend

activeagent 1.1.0 → 1.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (41) hide show

data/lib/active_agent/dashboard/app/views/layouts/active_agent/dashboard/application.html.erb DELETED Viewed

@@ -1,94 +0,0 @@
-<!DOCTYPE html>
-<html lang="en" class="h-full">
-<head>
-  <meta charset="UTF-8">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  <title>ActiveAgent Dashboard</title>
-  <script src="https://cdn.tailwindcss.com"></script>
-  <script src="https://unpkg.com/@hotwired/turbo@7.3.0/dist/turbo.es2017-esm.js" type="module"></script>
-  <script src="https://unpkg.com/@hotwired/stimulus@3.2.2/dist/stimulus.umd.js"></script>
-  <style>
-    [data-turbo-preview] { opacity: 0.5; }
-    .span-bar { transition: all 0.2s ease; }
-    .span-bar:hover { transform: scaleY(1.1); }
-  </style>
-  <script>
-    // Initialize Stimulus
-    const application = Stimulus.Application.start();
-    // Traces controller for expandable rows
-    application.register("traces", class extends Stimulus.Controller {
-      static targets = ["row", "detail"]
-      toggle(event) {
-        const traceId = event.currentTarget.dataset.traceId;
-        const detail = document.getElementById(`detail-${traceId}`);
-        if (detail) {
-          detail.classList.toggle("hidden");
-        }
-      }
-    });
-    // Auto-refresh controller
-    application.register("refresh", class extends Stimulus.Controller {
-      static values = { interval: Number }
-      connect() {
-        if (this.intervalValue > 0) {
-          this.startRefresh();
-        }
-      }
-      disconnect() {
-        this.stopRefresh();
-      }
-      startRefresh() {
-        this.timer = setInterval(() => {
-          Turbo.visit(window.location.href, { action: "replace" });
-        }, this.intervalValue);
-      }
-      stopRefresh() {
-        if (this.timer) clearInterval(this.timer);
-      }
-    });
-  </script>
-</head>
-<body class="h-full bg-gray-50 dark:bg-gray-900">
-  <div class="min-h-full">
-    <!-- Header -->
-    <nav class="bg-white dark:bg-gray-800 border-b border-gray-200 dark:border-gray-700">
-      <div class="mx-auto max-w-7xl px-4 sm:px-6 lg:px-8">
-        <div class="flex h-16 items-center justify-between">
-          <div class="flex items-center">
-            <div class="flex-shrink-0">
-              <span class="text-xl font-bold text-indigo-600 dark:text-indigo-400">
-                ActiveAgent
-              </span>
-            </div>
-            <div class="ml-10 flex items-baseline space-x-4">
-              <%= link_to "Traces",
-                  traces_path,
-                  class: "px-3 py-2 rounded-md text-sm font-medium #{request.path == traces_path ? 'bg-indigo-100 text-indigo-700 dark:bg-indigo-900 dark:text-indigo-200' : 'text-gray-600 hover:bg-gray-100 dark:text-gray-300 dark:hover:bg-gray-700'}" %>
-              <%= link_to "Metrics",
-                  metrics_traces_path,
-                  class: "px-3 py-2 rounded-md text-sm font-medium #{request.path == metrics_traces_path ? 'bg-indigo-100 text-indigo-700 dark:bg-indigo-900 dark:text-indigo-200' : 'text-gray-600 hover:bg-gray-100 dark:text-gray-300 dark:hover:bg-gray-700'}" %>
-            </div>
-          </div>
-          <div class="text-sm text-gray-500 dark:text-gray-400">
-            Local Telemetry
-          </div>
-        </div>
-      </div>
-    </nav>
-    <!-- Main content -->
-    <main>
-      <div class="mx-auto max-w-7xl py-6 px-4 sm:px-6 lg:px-8">
-        <%= yield %>
-      </div>
-    </main>
-  </div>
-</body>
-</html>

data/lib/active_agent/dashboard/config/routes.rb DELETED Viewed

@@ -1,19 +0,0 @@
-# frozen_string_literal: true
-ActiveAgent::Dashboard::Engine.routes.draw do
-  # The functional dashboard surface: traces + metrics.
-  root to: "traces#index"
-  get "dashboard", to: "dashboard#index"
-  resources :traces, only: [ :index, :show ] do
-    collection do
-      get :metrics
-    end
-  end
-  # Telemetry ingestion, relative to wherever the engine is mounted:
-  # <mount>/api/traces (e.g. /activeagents/api/traces at the default mount).
-  namespace :api do
-    resources :traces, only: [ :create ]
-  end
-end

data/lib/active_agent/dashboard/engine.rb DELETED Viewed

@@ -1,43 +0,0 @@
-# frozen_string_literal: true
-module ActiveAgent
-  module Dashboard
-    # Rails Engine for the ActiveAgent Dashboard.
-    #
-    # Provides the free self-hosted dashboard: telemetry traces, metrics,
-    # and the local trace ingestion API.
-    #
-    # Mount in your routes:
-    #   mount ActiveAgent::Dashboard::Engine => "/activeagents"
-    #
-    class Engine < ::Rails::Engine
-      # The engine lives at lib/active_agent/dashboard rather than the gem
-      # root. Rails derives an engine's load paths (app/models,
-      # app/controllers, app/jobs, app/views, config/routes.rb) from
-      # find_root when +config+ is first materialized — which
-      # isolate_namespace below triggers via +routes+ — so this override
-      # must be defined before anything touches config. Overriding only
-      # +root+ leaves the engine's classes off host applications' autoload
-      # paths entirely.
-      def self.find_root(_from)
-        root
-      end
-      def self.root
-        @root ||= Pathname.new(File.expand_path("..", __FILE__))
-      end
-      isolate_namespace ActiveAgent::Dashboard
-      # Use a unique engine name to avoid conflicts
-      engine_name "active_agent"
-      # Alias for consistency with existing code
-      def self.dashboard_root
-        root
-      end
-      config.active_agent_dashboard = ActiveSupport::OrderedOptions.new
-    end
-  end
-end

data/lib/active_agent/dashboard.rb DELETED Viewed

@@ -1,161 +0,0 @@
-# frozen_string_literal: true
-require "active_agent/dashboard/engine"
-module ActiveAgent
-  # Dashboard engine for visualizing telemetry data and managing agents.
-  #
-  # Mount the engine in your routes to access the full dashboard:
-  #
-  #   # config/routes.rb
-  #   mount ActiveAgent::Dashboard::Engine => "/activeagents"
-  #
-  # The dashboard provides:
-  # - Agent management: Create, edit, version, and execute agents
-  # - Traces view: See all agent invocations with spans, timing, and token usage
-  # - Metrics view: Aggregate statistics and charts
-  # - Sandbox execution: Run agents in isolated environments
-  # - Session recordings: Capture and replay browser sessions
-  #
-  # = Configuration Modes
-  #
-  # == Local Mode (default)
-  # For self-hosted, single-tenant deployments:
-  #
-  #   ActiveAgent::Dashboard.configure do |config|
-  #     config.authentication_method = ->(controller) { controller.authenticate_admin! }
-  #     config.sandbox_service = :local  # Docker/Incus
-  #   end
-  #
-  # == Multi-tenant Mode
-  # For SaaS platforms with multiple accounts:
-  #
-  #   ActiveAgent::Dashboard.configure do |config|
-  #     config.multi_tenant = true
-  #     config.account_class = "Account"
-  #     config.user_class = "User"
-  #     config.current_account_method = :current_account
-  #     config.current_user_method = :current_user
-  #     config.authentication_method = ->(controller) { controller.authenticate_user! }
-  #     config.sandbox_service = :cloud_run  # Managed
-  #     config.use_inertia = true
-  #   end
-  #
-  module Dashboard
-    class << self
-      # Authentication method to call on controllers
-      # @return [Proc, nil] A proc that receives the controller instance
-      attr_accessor :authentication_method
-      # Enable multi-tenant mode (requires account association)
-      # @return [Boolean]
-      attr_accessor :multi_tenant
-      # Class name for the Account model (multi-tenant mode)
-      # @return [String, nil]
-      attr_accessor :account_class
-      # Class name for the User model
-      # @return [String, nil]
-      attr_accessor :user_class
-      # Method to call on controller to get current account (multi-tenant mode)
-      # @return [Symbol, nil]
-      attr_accessor :current_account_method
-      # Method to call on controller to get current user
-      # @return [Symbol, nil]
-      attr_accessor :current_user_method
-      # Custom trace model class (for host app overrides)
-      # @return [String, nil]
-      attr_accessor :trace_model_class
-      # Enable React/Inertia frontend instead of ERB
-      # @return [Boolean]
-      attr_accessor :use_inertia
-      # Custom layout for the dashboard
-      # @return [String, nil]
-      attr_accessor :layout
-      # Sandbox service type (:local, :cloud_run, :kubernetes)
-      # @return [Symbol]
-      attr_accessor :sandbox_service
-      # Custom sandbox limits (overrides defaults)
-      # @return [Hash, nil]
-      attr_accessor :sandbox_limits
-      # Storage service for screenshots/snapshots
-      # @return [Object, nil] Object responding to #signed_url_for and #fetch_snapshot
-      attr_accessor :storage_service
-      # Bearer token required by the ingest API in single-tenant mode. When
-      # unset the local ingest endpoint accepts unauthenticated posts, so set
-      # it whenever the mount is reachable beyond your own machine.
-      # (Multi-tenant mode authenticates per-account keys instead.)
-      # @return [String, nil]
-      attr_accessor :ingest_api_key
-      # @deprecated Never consumed — dashboard controllers inherit
-      #   ActionController::Base. Retained as a no-op so existing
-      #   initializers that set it keep booting; remove in the next major.
-      # @return [String]
-      attr_accessor :base_controller_class
-      # Returns whether multi-tenant mode is enabled.
-      #
-      # @return [Boolean]
-      def multi_tenant?
-        @multi_tenant == true
-      end
-      # Returns the trace model class to use.
-      #
-      # @return [Class] The trace model class
-      def trace_model
-        if trace_model_class
-          trace_model_class.constantize
-        else
-          ActiveAgent::TelemetryTrace
-        end
-      end
-      # Returns the agent model class to use.
-      #
-      # @return [Class] The agent model class
-      def agent_model
-        ActiveAgent::Dashboard::Agent
-      end
-      # Configures the dashboard.
-      #
-      # @yield [config] Configuration block
-      def configure
-        yield self
-      end
-      # Reset configuration to defaults
-      def reset!
-        @authentication_method = nil
-        @multi_tenant = false
-        @account_class = nil
-        @user_class = nil
-        @current_account_method = nil
-        @current_user_method = nil
-        @trace_model_class = nil
-        @use_inertia = false
-        @layout = nil
-        @sandbox_service = :local
-        @sandbox_limits = nil
-        @storage_service = nil
-        @ingest_api_key = nil
-        @base_controller_class = "ActionController::Base" # deprecated no-op
-      end
-    end
-    # Set defaults
-    reset!
-  end
-end

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

@@ -1,92 +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"
-      class_option :multi_tenant, type: :boolean, default: false,
-        desc: "Scope traces to an Account (adds account_id to the migration)"
-      class_option :skip_migrations, type: :boolean, default: false,
-        desc: "Skip copying the telemetry traces migration"
-      class_option :skip_routes, type: :boolean, default: false,
-        desc: "Skip adding the engine mount to routes.rb"
-      def copy_migrations
-        return if options[:skip_migrations]
-        migration_template(
-          "create_active_agent_telemetry_traces.rb.erb",
-          "db/migrate/create_active_agent_telemetry_traces.rb"
-        )
-      end
-      def add_route
-        return if options[:skip_routes]
-        # Rails' `route` action is only idempotent on an exact string match,
-        # so an app installed before the default path changed would get a
-        # second mount — and two unnamed mounts of the same engine raise
-        # "Invalid route name, already in use: 'active_agent'" at boot.
-        routes_file = File.join(destination_root, "config/routes.rb")
-        if File.exist?(routes_file) && File.read(routes_file).include?("ActiveAgent::Dashboard::Engine")
-          say_status :skip, "engine already mounted in config/routes.rb", :yellow
-          return
-        end
-        route 'mount ActiveAgent::Dashboard::Engine => "/activeagents"'
-      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 /activeagents to view the dashboard"
-        say "\n"
-      end
-      private
-      def migration_version
-        "[#{ActiveRecord::Migration.current_version}]"
-      end
-      # Consumed by the migration template.
-      def multi_tenant?
-        options[:multi_tenant]
-      end
-    end
-  end
-end

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

@@ -1,67 +0,0 @@
-# frozen_string_literal: true
-# ActiveAgent Dashboard Configuration
-#
-# This file configures the ActiveAgent telemetry dashboard.
-# The dashboard is mounted at /activeagents by default (see config/routes.rb).
-ActiveAgent::Dashboard.configure do |config|
-  # ==========================================================================
-  # Authentication (required in production)
-  # ==========================================================================
-  #
-  # Provide a lambda that receives the controller and performs
-  # authentication. Return false or raise to deny access. Without one, the
-  # dashboard serves a 403 in production — traces contain prompts, outputs
-  # and error messages.
-  #
-  # 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
-  # ==========================================================================
-  # Ingest API authentication
-  # ==========================================================================
-  #
-  # Bearer token other apps must send when posting traces to the mounted
-  # ingest endpoint (/activeagents/api/traces). Leave unset only when the
-  # mount is not reachable beyond your own machine.
-  #
-  # config.ingest_api_key = Rails.application.credentials.dig(:active_agent, :ingest_api_key)
-  # ==========================================================================
-  # Multi-tenant mode (SaaS platforms only)
-  # ==========================================================================
-  #
-  # Scopes traces per account and authenticates ingest with per-account
-  # keys. Most self-hosted installs should leave this off.
-  #
-  # config.multi_tenant = true
-  # config.account_class = "Account"
-  # config.user_class = "User"
-  # config.current_account_method = :current_account
-  # config.current_user_method = :current_user
-  # ==========================================================================
-  # UI
-  # ==========================================================================
-  #
-  # Custom layout for dashboard views (the default layout loads Tailwind,
-  # Turbo and Stimulus from CDNs — override for CSP-strict or air-gapped
-  # environments).
-  #
-  # config.layout = "application"
-end

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

@@ -1,46 +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? -%>
-      # Multi-tenant mode: every query is scoped through `for_account`, and
-      # ingest authenticates a per-account key. The foreign key requires an
-      # existing `accounts` table — on PostgreSQL/MySQL this migration must
-      # run after the one that creates it (drop `foreign_key: true` if your
-      # tenant table is named differently).
-      t.references :account, null: false, foreign_key: true
-<% end -%>
-      t.string :trace_id, null: false
-      t.string :service_name
-      t.string :environment
-      t.datetime :timestamp, index: true
-      t.json :spans, default: []
-      t.json :resource_attributes, default: {}
-      t.json :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
-<% if multi_tenant? -%>
-    # Ingest dedupes on trace_id (per account when multi-tenant); the unique
-    # index makes that dedupe race-proof rather than check-then-insert.
-    add_index :active_agent_telemetry_traces, [:account_id, :trace_id], unique: true
-    add_index :active_agent_telemetry_traces, [:account_id, :timestamp]
-<% else -%>
-    add_index :active_agent_telemetry_traces, :trace_id, unique: true
-<% 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