activeagent 1.0.2 → 1.1.0

data/lib/active_agent/telemetry.rb

@@ -1,8 +1,7 @@
 # frozen_string_literal: true
 
-require "net/http"
-require "json"
 require "securerandom"
+require "activeagents/telemetry"
 
 module ActiveAgent
   # Telemetry module for collecting and reporting agent traces.

data/lib/active_agent/version.rb

@@ -1,3 +1,3 @@
 module ActiveAgent
-  VERSION = "1.0.2"
+  VERSION = "1.1.0"
 end

data/lib/active_agent.rb

@@ -16,6 +16,10 @@ require "active_support/lazy_load_hooks"
 # Module Level Extensions
 require "active_agent/configuration"
 require "active_agent/railtie" if defined?(Rails)
+# The dashboard is a Rails engine; engines must be defined when the gem is
+# required (before the host app collects railtie initializers), so it
+# cannot be left to the Dashboard autoload above.
+require "active_agent/dashboard" if defined?(Rails)
 
 # ActiveAgent is a framework for building AI agents with Rails-like conventions.
 #
@@ -101,6 +105,7 @@ module ActiveAgent
   autoload :Preview, "active_agent/concerns/preview"
   autoload :Previews, "active_agent/concerns/preview"
   autoload :GenerationJob
+  autoload :ModelCapabilities
   autoload :Observers, "active_agent/concerns/observers"
   autoload :Provider, "active_agent/concerns/provider"
   autoload :Rescue, "active_agent/concerns/rescue"

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

@@ -22,7 +22,18 @@ module ActiveAgent
 
       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"
@@ -30,7 +41,19 @@ module ActiveAgent
       end
 
       def add_route
-        route 'mount ActiveAgent::Dashboard::Engine => "/active_agent"'
+        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
@@ -50,7 +73,7 @@ module ActiveAgent
         say "     telemetry:"
         say "       enabled: true"
         say "       local_storage: true"
-        say "  3. Visit /active_agent to view the dashboard"
+        say "  3. Visit /activeagents to view the dashboard"
         say "\n"
       end
 
@@ -59,6 +82,11 @@ module ActiveAgent
       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

@@ -3,13 +3,17 @@
 # ActiveAgent Dashboard Configuration
 #
 # This file configures the ActiveAgent telemetry dashboard.
-# The dashboard is mounted at /active_agent by default.
+# The dashboard is mounted at /activeagents by default (see config/routes.rb).
 
 ActiveAgent::Dashboard.configure do |config|
-  # Authentication method - provide a lambda that receives the controller
-  # and performs authentication. Return false or raise to deny access.
+  # ==========================================================================
+  # Authentication (required in production)
+  # ==========================================================================
   #
-  # Examples:
+  # 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) {
@@ -27,4 +31,37 @@ ActiveAgent::Dashboard.configure do |config|
   #   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

@@ -3,13 +3,21 @@
 class CreateActiveAgentTelemetryTraces < ActiveRecord::Migration<%= migration_version %>
   def change
     create_table :active_agent_telemetry_traces do |t|
-      t.string :trace_id, null: false, index: true
+<% 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.jsonb :spans, default: []
-      t.jsonb :resource_attributes, default: {}
-      t.jsonb :sdk_info, default: {}
+      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
@@ -22,6 +30,14 @@ class CreateActiveAgentTelemetryTraces < ActiveRecord::Migration<%= migration_ve
       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]

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: activeagent
 version: !ruby/object:Gem::Version
-  version: 1.0.2
+  version: 1.1.0
 platform: ruby
 authors:
 - Justin Bowen
@@ -109,6 +109,20 @@ dependencies:
     - - "<="
       - !ruby/object:Gem::Version
         version: '9.0'
+- !ruby/object:Gem::Dependency
+  name: activeagents-telemetry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
 - !ruby/object:Gem::Dependency
   name: jbuilder
   requirement: !ruby/object:Gem::Requirement
@@ -269,16 +283,30 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '6.4'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '6.4'
 - !ruby/object:Gem::Dependency
   name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '3.26'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '3.26'
+- !ruby/object:Gem::Dependency
+  name: cgi
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -297,14 +325,14 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '3.2'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '3.2'
 - !ruby/object:Gem::Dependency
   name: pry
   requirement: !ruby/object:Gem::Requirement
@@ -404,6 +432,7 @@ files:
 - lib/active_agent/generation.rb
 - lib/active_agent/generation_job.rb
 - lib/active_agent/inline_preview_interceptor.rb
+- lib/active_agent/model_capabilities.rb
 - lib/active_agent/providers/_base_provider.rb
 - lib/active_agent/providers/anthropic/_types.rb
 - lib/active_agent/providers/anthropic/options.rb
@@ -439,6 +468,7 @@ files:
 - lib/active_agent/providers/concerns/instrumentation.rb
 - lib/active_agent/providers/concerns/previewable.rb
 - lib/active_agent/providers/concerns/tool_choice_clearing.rb
+- lib/active_agent/providers/errors.rb
 - lib/active_agent/providers/gemini/_types.rb
 - lib/active_agent/providers/gemini/options.rb
 - lib/active_agent/providers/gemini_provider.rb
@@ -497,6 +527,9 @@ files:
 - lib/active_agent/providers/open_router_provider.rb
 - lib/active_agent/providers/openai_provider.rb
 - lib/active_agent/providers/openrouter_provider.rb
+- lib/active_agent/providers/requesty/_types.rb
+- lib/active_agent/providers/requesty/options.rb
+- lib/active_agent/providers/requesty_provider.rb
 - lib/active_agent/providers/ruby_llm/_types.rb
 - lib/active_agent/providers/ruby_llm/embedding_request.rb
 - lib/active_agent/providers/ruby_llm/messages/_types.rb
@@ -523,16 +556,6 @@ files:
 - lib/activeagent.rb
 - lib/generators/active_agent/agent/USAGE
 - lib/generators/active_agent/agent/agent_generator.rb
-- lib/generators/active_agent/dashboard/install/install_generator.rb
-- lib/generators/active_agent/dashboard/install/templates/initializer.rb
-- lib/generators/active_agent/dashboard/install/templates/migrations/create_active_agent_agent_runs.rb
-- lib/generators/active_agent/dashboard/install/templates/migrations/create_active_agent_agent_templates.rb
-- lib/generators/active_agent/dashboard/install/templates/migrations/create_active_agent_agent_versions.rb
-- lib/generators/active_agent/dashboard/install/templates/migrations/create_active_agent_agents.rb
-- lib/generators/active_agent/dashboard/install/templates/migrations/create_active_agent_sandbox_runs.rb
-- lib/generators/active_agent/dashboard/install/templates/migrations/create_active_agent_sandbox_sessions.rb
-- lib/generators/active_agent/dashboard/install/templates/migrations/create_active_agent_session_recordings.rb
-- lib/generators/active_agent/dashboard/install/templates/migrations/create_active_agent_telemetry_traces.rb
 - lib/generators/active_agent/dashboard/install_generator.rb
 - lib/generators/active_agent/dashboard/templates/active_agent_dashboard.rb.erb
 - lib/generators/active_agent/dashboard/templates/create_active_agent_telemetry_traces.rb.erb
@@ -576,7 +599,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.9
+rubygems_version: 4.0.6
 specification_version: 4
 summary: Rails AI Agents Framework
 test_files: []

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