protege 0.1.0.alpha.2 → 0.1.0.alpha.7

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: protege
 version: !ruby/object:Gem::Version
-  version: 0.1.0.alpha.2
+  version: 0.1.0.alpha.7
 platform: ruby
 authors:
 - Sebastian Scholl
@@ -205,14 +205,17 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '3.0'
-description: Protege is an email-native AI agent toolkit focused on simplicity, interoperability,
-  and self-sovereignty.
+description: 'Protege gives your Rails app AI teammates: inbound mail via Action Mailbox,
+  replies over SMTP, tools that act on your own models, cron-scheduled responsibilities
+  dispatched through Active Job, and a built-in dashboard to manage and observe it
+  all — in process, no separate service.'
 email:
 - sebscholl@gmail.com
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- MIT-LICENSE
 - README.md
 - Rakefile
 - app/assets/builds/protege.css
@@ -224,22 +227,28 @@ files:
 - app/assets/javascripts/protege/theme.js
 - app/assets/stylesheets/protege/application.css
 - app/assets/tailwind/application.css
-- app/controllers/concerns/protege/persona_scoped.rb
+- app/controllers/concerns/protege/agent_scoped.rb
+- app/controllers/concerns/protege/agent_toolkit_scoped.rb
 - app/controllers/concerns/protege/thread_scoped.rb
 - app/controllers/protege/access_rules_controller.rb
+- app/controllers/protege/agent_toolkit_rules_controller.rb
+- app/controllers/protege/agent_toolkits_controller.rb
+- app/controllers/protege/agents/agent_toolkits_controller.rb
+- app/controllers/protege/agents_controller.rb
 - app/controllers/protege/application_controller.rb
 - app/controllers/protege/archives_controller.rb
 - app/controllers/protege/email_domains_controller.rb
 - app/controllers/protege/home_controller.rb
 - app/controllers/protege/messages_controller.rb
 - app/controllers/protege/mta_domains_syncs_controller.rb
-- app/controllers/protege/personas_controller.rb
 - app/controllers/protege/replies_controller.rb
 - app/controllers/protege/responsibilities_controller.rb
 - app/controllers/protege/responsibility_runs_controller.rb
 - app/controllers/protege/threads_controller.rb
+- app/controllers/protege/toolkits_controller.rb
 - app/controllers/protege/traces/searches_controller.rb
 - app/controllers/protege/traces_controller.rb
+- app/helpers/protege/agents_helper.rb
 - app/helpers/protege/application_helper.rb
 - app/helpers/protege/components/badges_helper.rb
 - app/helpers/protege/components/buttons_helper.rb
@@ -258,9 +267,9 @@ files:
 - app/helpers/protege/components/typography_helper.rb
 - app/helpers/protege/email_domains_helper.rb
 - app/helpers/protege/messages_helper.rb
-- app/helpers/protege/personas_helper.rb
 - app/helpers/protege/responsibilities_helper.rb
 - app/helpers/protege/threads_helper.rb
+- app/helpers/protege/toolkits_helper.rb
 - app/helpers/protege/trace_helper.rb
 - app/hooks/protege/event_logger_hook.rb
 - app/jobs/protege/application_job.rb
@@ -270,23 +279,28 @@ files:
 - app/jobs/protege/responsibility_job.rb
 - app/jobs/protege/responsibility_tick_job.rb
 - app/mailboxes/protege/agent_mailbox.rb
+- app/mailers/protege/alert_mailer.rb
 - app/mailers/protege/application_mailer.rb
+- app/models/concerns/protege/broadcastable_agent.rb
 - app/models/concerns/protege/broadcastable_email_domain.rb
 - app/models/concerns/protege/broadcastable_message.rb
-- app/models/concerns/protege/broadcastable_persona.rb
 - app/models/concerns/protege/broadcastable_responsibility.rb
 - app/models/concerns/protege/broadcastable_thread.rb
-- app/models/concerns/protege/tool_scoped.rb
+- app/models/concerns/protege/broadcastable_toolkit.rb
+- app/models/concerns/protege/toolable.rb
 - app/models/protege/access_rule.rb
+- app/models/protege/agent.rb
+- app/models/protege/agent_toolkit.rb
+- app/models/protege/agent_toolkit_rule.rb
 - app/models/protege/application_record.rb
 - app/models/protege/current.rb
 - app/models/protege/email_domain.rb
 - app/models/protege/email_thread.rb
 - app/models/protege/message.rb
-- app/models/protege/persona.rb
 - app/models/protege/responsibility.rb
 - app/models/protege/responsibility_run.rb
 - app/models/protege/tool_use.rb
+- app/models/protege/toolkit.rb
 - app/models/protege/trace.rb
 - app/providers/protege/open_router_provider.rb
 - app/resolvers/README.md
@@ -296,6 +310,7 @@ files:
 - app/resolvers/protege/thread_history_resolver.rb
 - app/services/protege/introspection_tool_call_presentation.rb
 - app/services/protege/message_search.rb
+- app/services/protege/system_toolkits.rb
 - app/services/protege/trace_search.rb
 - app/subscribers/protege/introspection_broadcaster.rb
 - app/tools/protege/create_file_tool.rb
@@ -304,8 +319,30 @@ files:
 - app/tools/protege/send_email_tool.rb
 - app/tools/protege/web_fetch_tool.rb
 - app/tools/protege/web_search_tool.rb
+- app/views/layouts/mailer.text.erb
 - app/views/layouts/protege/application.html.slim
 - app/views/protege/access_rules/create.turbo_stream.slim
+- app/views/protege/agent_toolkit_rules/create.turbo_stream.slim
+- app/views/protege/agent_toolkits/_gate_rule.html.slim
+- app/views/protege/agent_toolkits/_gate_rule_form.html.slim
+- app/views/protege/agent_toolkits/_gate_rules.html.slim
+- app/views/protege/agent_toolkits/show.html.slim
+- app/views/protege/agents/_access_rule.html.slim
+- app/views/protege/agents/_access_rule_form.html.slim
+- app/views/protege/agents/_access_rules.html.slim
+- app/views/protege/agents/_actions.html.slim
+- app/views/protege/agents/_agent_sidebar_item.html.slim
+- app/views/protege/agents/_agent_toolkit.html.slim
+- app/views/protege/agents/_agent_toolkit_form.html.slim
+- app/views/protege/agents/_form.html.slim
+- app/views/protege/agents/_sidebar.html.slim
+- app/views/protege/agents/_toolkits.html.slim
+- app/views/protege/agents/agent_toolkits/create.turbo_stream.slim
+- app/views/protege/agents/edit.html.slim
+- app/views/protege/agents/index.html.slim
+- app/views/protege/agents/new.html.slim
+- app/views/protege/agents/show.html.slim
+- app/views/protege/alert_mailer/inference_failed.text.erb
 - app/views/protege/email_domains/_email_domain_sidebar_item.html.slim
 - app/views/protege/email_domains/_form.html.slim
 - app/views/protege/email_domains/_sidebar.html.slim
@@ -316,17 +353,6 @@ files:
 - app/views/protege/messages/_message.html.slim
 - app/views/protege/messages/_sidebar.html.slim
 - app/views/protege/messages/index.html.slim
-- app/views/protege/personas/_access_rule.html.slim
-- app/views/protege/personas/_access_rule_form.html.slim
-- app/views/protege/personas/_access_rules.html.slim
-- app/views/protege/personas/_actions.html.slim
-- app/views/protege/personas/_form.html.slim
-- app/views/protege/personas/_persona_sidebar_item.html.slim
-- app/views/protege/personas/_sidebar.html.slim
-- app/views/protege/personas/edit.html.slim
-- app/views/protege/personas/index.html.slim
-- app/views/protege/personas/new.html.slim
-- app/views/protege/personas/show.html.slim
 - app/views/protege/responsibilities/_form.html.slim
 - app/views/protege/responsibilities/_responsibility_sidebar_item.html.slim
 - app/views/protege/responsibilities/_sidebar.html.slim
@@ -349,6 +375,13 @@ files:
 - app/views/protege/threads/index.html.slim
 - app/views/protege/threads/new.html.slim
 - app/views/protege/threads/show.html.slim
+- app/views/protege/toolkits/_form.html.slim
+- app/views/protege/toolkits/_sidebar.html.slim
+- app/views/protege/toolkits/_toolkit_sidebar_item.html.slim
+- app/views/protege/toolkits/edit.html.slim
+- app/views/protege/toolkits/index.html.slim
+- app/views/protege/toolkits/new.html.slim
+- app/views/protege/toolkits/show.html.slim
 - app/views/protege/traces/_sidebar.html.slim
 - app/views/protege/traces/index.html.slim
 - app/views/protege/traces/searches/_sidebar.html.slim
@@ -359,13 +392,18 @@ files:
 - db/migrate/20260706120130_create_protege_traces.rb
 - db/migrate/20260707120000_replace_persona_active_with_archived_at.rb
 - db/migrate/20260708120000_add_disabled_tool_ids_to_personas.rb
+- db/migrate/20260728140000_scope_message_and_thread_uniqueness_per_persona.rb
+- db/migrate/20260812000001_create_protege_toolkits.rb
+- db/migrate/20260815000001_remove_disabled_tool_ids_from_personas.rb
+- db/migrate/20260815000002_add_key_to_protege_toolkits.rb
+- db/migrate/20260815100000_rename_personas_to_agents.rb
+- lib/generators/protege/agent/agent_generator.rb
+- lib/generators/protege/agent/templates/agent.rb.tt
 - lib/generators/protege/extension_naming.rb
 - lib/generators/protege/hook/hook_generator.rb
 - lib/generators/protege/hook/templates/hook.rb.tt
 - lib/generators/protege/install/install_generator.rb
 - lib/generators/protege/install/templates/initializer.rb.tt
-- lib/generators/protege/persona/persona_generator.rb
-- lib/generators/protege/persona/templates/persona.rb.tt
 - lib/generators/protege/postfix/postfix_generator.rb
 - lib/generators/protege/postfix/templates/deploy/mail/Dockerfile
 - lib/generators/protege/postfix/templates/deploy/mail/KeyTable
@@ -425,6 +463,8 @@ files:
 - lib/protege/events/tool_calls_received_event.rb
 - lib/protege/extensions/hook.rb
 - lib/protege/extensions/hook_mixin.rb
+- lib/protege/extensions/manifest.rb
+- lib/protege/extensions/manifested.rb
 - lib/protege/extensions/provider.rb
 - lib/protege/extensions/provider_mixin.rb
 - lib/protege/extensions/resolver.rb
@@ -455,6 +495,7 @@ files:
 - lib/protege/orchestrator/resolver_chain.rb
 - lib/protege/orchestrator/responsibility_context.rb
 - lib/protege/orchestrator/responsibility_harness.rb
+- lib/protege/subscribers/alerter.rb
 - lib/protege/subscribers/hook_dispatcher.rb
 - lib/protege/subscribers/tracing.rb
 - lib/protege/types/document_part.rb
@@ -473,6 +514,8 @@ metadata:
   homepage_uri: https://github.com/sebscholl/protege
   source_code_uri: https://github.com/sebscholl/protege
   bug_tracker_uri: https://github.com/sebscholl/protege/issues
+  documentation_uri: https://docs.protege.bot
+  changelog_uri: https://github.com/sebscholl/protege/blob/main/CHANGELOG.md
   rubygems_mfa_required: 'true'
 rdoc_options: []
 require_paths:
@@ -490,5 +533,5 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 rubygems_version: 3.6.9
 specification_version: 4
-summary: Email-native AI agent toolkit.
+summary: Rails engine for email-native AI agents.
 test_files: []

data/app/controllers/concerns/protege/persona_scoped.rb

@@ -1,22 +0,0 @@
-# frozen_string_literal: true
-
-module Protege
-  # Shared concern for controllers nested under a persona.
-  # Sets +@persona+ from +params[:persona_id]+.
-  module PersonaScoped
-    extend ActiveSupport::Concern
-
-    included do
-      before_action :set_persona
-    end
-
-    private
-
-    # Load the +Persona+ named by +params[:persona_id]+ into +@persona+.
-    #
-    # @return [Protege::Persona] the loaded persona
-    def set_persona
-      @persona = Persona.find(params[:persona_id])
-    end
-  end
-end

data/app/controllers/protege/personas_controller.rb

@@ -1,118 +0,0 @@
-# frozen_string_literal: true
-
-module Protege
-  # Manages persona records — listing, creating, viewing, editing, and permanent deletion.
-  #
-  # A persona is the identity behind an inbox; the controller surfaces the full CRUD the dashboard
-  # needs. +destroy+ is the hard, irreversible removal (cascading all the persona's data); the
-  # reversible, history-preserving alternative is archiving — see +ArchivesController+.
-  class PersonasController < ApplicationController
-    before_action :set_persona, only: %i[show edit update destroy]
-
-    # List every persona. Serves +GET /personas+.
-    #
-    # @return [void]
-    def index
-      @personas = Persona.all
-    end
-
-    # Show a single persona. Serves +GET /personas/:id+.
-    #
-    # @return [void]
-    def show; end
-
-    # Render the form for creating a persona. Serves +GET /personas/new+.
-    #
-    # @return [void]
-    def new
-      @persona = Persona.new
-    end
-
-    # Render the form for editing a persona. Serves +GET /personas/:id/edit+.
-    #
-    # @return [void]
-    def edit; end
-
-    # Create a persona from the form's split email fields. Serves +POST /personas+.
-    #
-    # On failure, re-render the form with validation errors.
-    #
-    # @return [void]
-    def create
-      @persona = Persona.new(create_params)
-
-      if @persona.save
-        redirect_to persona_path(@persona), notice: 'Persona created.'
-      else
-        render :new, status: :unprocessable_entity
-      end
-    end
-
-    # Update an existing persona. Serves +PATCH /personas/:id+.
-    #
-    # On failure, re-render the edit form with validation errors.
-    #
-    # @return [void]
-    def update
-      if @persona.update(update_params)
-        redirect_to persona_path(@persona), notice: 'Persona updated.'
-      else
-        render :edit, status: :unprocessable_entity
-      end
-    end
-
-    # Permanently delete a persona and everything it owns. Serves +DELETE /personas/:id+.
-    #
-    # This is the hard, irreversible removal (the reversible path is Archive — see +ArchivesController+):
-    # the model cascades the persona's threads, messages, responsibilities, access rules, and tool-use
-    # history. +BroadcastablePersona+ removes its sidebar row.
-    #
-    # @return [void]
-    def destroy
-      @persona.destroy!
-
-      redirect_to personas_path, notice: 'Persona deleted.'
-    end
-
-    private
-
-    # Load the +Persona+ named by +params[:id]+ into +@persona+.
-    #
-    # @return [Protege::Persona] the loaded persona
-    def set_persona
-      @persona = Persona.find(params[:id])
-    end
-
-    # Permit creation attributes and fold the split email fields into a single address.
-    #
-    # @return [ActionController::Parameters] the permitted attributes plus +:email_address+
-    def create_params
-      params.require(:persona)
-            .permit(:type, :name, :instructions)
-            .merge(email_address: compose_email_address)
-    end
-
-    # Permit the editable attributes and recompose the address from the split email fields. Changing the
-    # address is allowed — only mail to the *old* address stops routing here; all history keys off
-    # +persona_id+, not the address. +disabled_tool_ids+ is the tool checklist submitted straight from
-    # the form (the model strips the hidden blank); a PATCH without that field leaves the scope untouched.
-    #
-    # @return [ActionController::Parameters] the permitted attributes plus +:email_address+
-    def update_params
-      params.require(:persona)
-            .permit(:name, :instructions, disabled_tool_ids: [])
-            .merge(email_address: compose_email_address)
-    end
-
-    # Combine the split prefix + domain fields from the form into a single
-    # email address.
-    #
-    # @return [String] the +prefix@domain+ address with surrounding whitespace stripped
-    def compose_email_address
-      params[:persona].values_at(:email_prefix, :email_domain)
-                      .map(&:to_s)
-                      .map(&:strip)
-                      .join('@')
-    end
-  end
-end

data/app/helpers/protege/personas_helper.rb

@@ -1,90 +0,0 @@
-# frozen_string_literal: true
-
-module Protege
-  # View helpers for persona pages — selectors, labels, status, and resolver display.
-  module PersonasHelper
-    # List the loaded +Persona+ subclasses for the new-persona type selector.
-    #
-    # @return [Array<Class>] the +Persona+ descendant classes
-    def available_persona_types
-      Persona.descendants
-    end
-
-    # List active email domains for the persona form's domain selector.
-    #
-    # @return [ActiveRecord::Relation<Protege::EmailDomain>] domains eligible for selection
-    def available_email_domains
-      EmailDomain.all
-    end
-
-    # Fetch every +Persona+ ordered by name for sidebar listing.
-    #
-    # @return [ActiveRecord::Relation<Protege::Persona>] personas ordered alphabetically
-    def all_personas
-      Persona.order(:name)
-    end
-
-    # Format a persona's name together with its type for display.
-    #
-    #   persona_label(persona) # => "Bob <Agent>"
-    #
-    # @param persona [Protege::Persona] the persona to label
-    # @return [String] the +"name <Type>"+ label
-    def persona_label(persona)
-      "#{persona.name} <#{persona.class.display_name}>"
-    end
-
-    # Render a status dot reflecting whether a persona is available.
-    #
-    # @param persona [Protege::Persona] the persona whose availability to show
-    # @return [ActiveSupport::SafeBuffer] a green dot when active, red otherwise
-    def persona_status(persona)
-      if persona.active?
-        status_dot('Available', :green)
-      else
-        status_dot('Unavailable', :red)
-      end
-    end
-
-    # Format a persona's resolver chain as a hash suitable for +info_card+ (rendered full-width, since
-    # the resolver class names are long). Each entry maps the resolver's short class name to a summary
-    # of its positional args, keyword args, and whether it was given a block.
-    #
-    # @param persona [Protege::Persona] the persona whose reply (+message_resolvers+) chain to format
-    # @return [Hash{String => String}] resolver-name => configuration summary
-    def resolver_pairs(persona)
-      pairs = persona.message_resolvers.entries.each_with_object({}) do |(klass, args, kwargs, block), accumulator|
-        accumulator[klass.name.demodulize] = resolver_config(args, kwargs, block)
-      end
-
-      pairs.any? ? pairs : { 'Resolvers' => 'None configured' }
-    end
-
-    # The tool classes a persona's operator may toggle — the checkbox universe on the persona form.
-    #
-    # This is the persona's *grant* (its code-declared ceiling), or every registered tool when no grant
-    # was declared. It is deliberately the grant rather than the effective set: the operator toggles
-    # within what the code allows, so a tool disabled in the DB still appears (unchecked) and can be
-    # switched back on, while a tool outside the grant is never offered.
-    #
-    # @param persona [Protege::Persona] the persona being edited
-    # @return [Array<Class>] the toggleable tool classes
-    def persona_tool_options(persona)
-      grant = persona.class.tool_grant
-
-      grant ? ToolMixin.registered.select { grant.include?(_1.id) } : ToolMixin.registered
-    end
-
-    private
-
-    # Summarize a resolver entry's positional args, keyword args, and whether it was given a block.
-    #
-    # @return [String] a comma-joined summary, or "" when the resolver takes no configuration
-    def resolver_config(args, kwargs, block)
-      parts  = args.map(&:inspect)
-      parts += kwargs.map { |key, value| "#{key}: #{value.inspect}" }
-      parts << '{ … }' if block
-      parts.join(', ')
-    end
-  end
-end

data/app/models/concerns/protege/broadcastable_persona.rb

@@ -1,50 +0,0 @@
-# frozen_string_literal: true
-
-module Protege
-  # Drives real-time Turbo Stream broadcasting for +Persona+ records — keeping the Personas sidebar
-  # live: the row is appended on create, replaced on update, and removed on destroy. First-page viewers
-  # subscribe via +turbo_stream_from "protege:personas"+ (see +SidebarHelper#sidebar_stream+).
-  module BroadcastablePersona
-    extend ActiveSupport::Concern
-
-    # Turbo Stream channel for all +Persona+ records.
-    # @return [String]
-    STREAM = 'protege:personas'
-
-    included do
-      after_create_commit  :broadcast_persona_created
-      after_update_commit  :broadcast_persona_updated
-      after_destroy_commit :broadcast_persona_removed
-    end
-
-    private
-
-    # Append this persona's row to the Personas sidebar on creation.
-    #
-    # @return [void]
-    def broadcast_persona_created
-      broadcast_append_to STREAM,
-                          target:  'personas_list',
-                          partial: 'protege/personas/persona_sidebar_item',
-                          locals:  { persona: self }
-    end
-
-    # Replace this persona's sidebar row in place when its attributes change.
-    #
-    # @return [void]
-    def broadcast_persona_updated
-      broadcast_replace_to STREAM,
-                           target:  ActionView::RecordIdentifier.dom_id(self),
-                           partial: 'protege/personas/persona_sidebar_item',
-                           locals:  { persona: self }
-    end
-
-    # Remove this persona's sidebar row on destruction.
-    #
-    # @return [void]
-    def broadcast_persona_removed
-      broadcast_remove_to STREAM,
-                          target: ActionView::RecordIdentifier.dom_id(self)
-    end
-  end
-end

data/app/models/concerns/protege/tool_scoped.rb

@@ -1,88 +0,0 @@
-# frozen_string_literal: true
-
-module Protege
-  # Per-persona tool scoping — mixed into +Persona+ to bound which tools an agent may use.
-  #
-  # A persona's effective tools are the code-declared *grant* (the ceiling, set by the {ClassMethods#tools}
-  # macro) minus the operator's +disabled_tool_ids+ override, and never wider than the grant. Two layers,
-  # deliberately different in reach:
-  #
-  # * The grant lives on a +class_attribute+ so it survives Active Record's schema-loading reloads (the
-  #   same reason +Persona._display_name+ is one). Unlike the resolver chains — per-subclass +@ivar+s that
-  #   never inherit — the grant *inherits* down the STI tree, so a base persona narrows a whole family's
-  #   ceiling unless a subclass declares its own. A nil grant means "every registered tool", so an
-  #   unconfigured persona keeps the full catalogue (the pre-scoping behaviour).
-  # * +disabled_tool_ids+ is a dashboard-editable JSON array on the row (text column; SQLite has no native
-  #   JSON type), normalised to a clean string array so it is never nil. It can only *subtract* from the
-  #   grant, never add to it.
-  #
-  # {#available_tools} resolves both layers against the live registry, so a stale grant or disabled id —
-  # naming a tool since deleted from the code — is simply skipped rather than conjuring or breaking a tool.
-  module ToolScoped
-    extend ActiveSupport::Concern
-
-    included do
-      serialize :disabled_tool_ids, coder: JSON
-      before_validation :normalize_disabled_tool_ids
-
-      # Backing store for the code-declared grant (tool ids, or nil for "all tools"). Inherits down STI.
-      class_attribute :_tool_grant, instance_accessor: false
-    end
-
-    # Class-level DSL for declaring the grant.
-    class_methods do
-      # Declare the tools this persona subclass may use — the code-side ceiling of its tool scope.
-      #
-      # A DSL macro (positional by convention, like +message_resolver+): given tool ids it records them as
-      # symbols. Omitting it leaves the grant nil ("every registered tool"). The operator can only narrow
-      # this grant at runtime via +disabled_tool_ids+, never widen it.
-      #
-      # @param ids [Array<Symbol, String>] the tool ids the persona is allowed to use
-      # @return [Array<Symbol>] the recorded grant
-      def tools(*ids)
-        self._tool_grant = ids.map(&:to_sym)
-      end
-
-      # Return this subclass's declared tool grant, or nil when none was declared ("all tools").
-      #
-      # @return [Array<Symbol>, nil] the granted tool ids, or nil for the full catalogue
-      def tool_grant
-        _tool_grant
-      end
-    end
-
-    # Return the tool classes this persona may currently use — its effective, scoped catalogue.
-    #
-    # Computed as one filter over the live registry (+ToolMixin.registered+): drop anything the operator
-    # has switched off in +disabled_tool_ids+, then keep only what the subclass's grant permits (or
-    # everything, when the grant is nil). Iterating the registry rather than the grant means a grant id
-    # with no matching registered tool is simply skipped — a stale scope can never conjure or break a tool.
-    #
-    # @return [Array<Class>] the tool classes offered to the model for this persona
-    def available_tools
-      disabled = disabled_tool_ids.map(&:to_sym)
-      grant    = self.class.tool_grant
-
-      ToolMixin.registered
-               .reject { |tool| disabled.include?(tool.id) }
-               .select { |tool| grant.nil? || grant.include?(tool.id) }
-    end
-
-    # The ids of this persona's effective tools — a convenience over {#available_tools} for UI and tests.
-    #
-    # @return [Array<Symbol>] the effective tool ids
-    def available_tool_ids
-      available_tools.map(&:id)
-    end
-
-    private
-
-    # Coerce +disabled_tool_ids+ to a deduped, blank-stripped array of strings so the JSON column stays
-    # clean regardless of how it was assigned (symbols, blanks, nils, duplicates) and is never nil.
-    #
-    # @return [void]
-    def normalize_disabled_tool_ids
-      self.disabled_tool_ids = Array(disabled_tool_ids).map(&:to_s).reject(&:blank?).uniq
-    end
-  end
-end

data/app/views/protege/personas/_actions.html.slim

@@ -1,15 +0,0 @@
-/ The persona show page's action bar — Edit, Archive/Unarchive, and permanent Delete — plus an "Archived"
-/ badge when soft-removed. Wrapped in a dom_id so Archive/Unarchive can replace it in place over Turbo
-/ (see ArchivesController). The Delete button opens the confirm dialog rendered by the show template.
-div id=dom_id(persona, :actions) class="flex items-center gap-3"
-  - if persona.archived?
-    = badge("Archived")
-
-  = ui_link("Edit", edit_persona_path(persona))
-
-  - if persona.archived?
-    = action_button("Unarchive", persona_archive_path(persona), method: :delete)
-  - else
-    = action_button("Archive", persona_archive_path(persona), method: :post, variant: :secondary)
-
-  = button("Delete", type: "button", variant: :danger, onclick: show_dialog("delete-persona"))

data/app/views/protege/personas/_form.html.slim

@@ -1,29 +0,0 @@
-- url = persona.new_record? ? personas_path : persona_path(persona)
-- method = persona.new_record? ? :post : :patch
-
-= form_with url:, method:, scope: :persona, class: "space-y-5" do |f|
-  = form_errors(persona)
-
-  = form_field(f, :name, placeholder: "e.g. alice")
-
-  = form_email_address(persona, available_email_domains)
-
-  - unless persona.new_record?
-    = hint("Changing the address only affects new mail — messages to the old address will no longer reach this persona. Existing threads and history are unaffected.")
-
-  - if persona.new_record?
-    = form_select(f, :type, available_persona_types.map { |k| [k.display_name, k.name] }, label: "Type")
-
-  = form_text_area(f, :instructions, \
-                      label: "Instructions", \
-                      rows: 10, \
-                      hint: "The agent's system prompt — who it is and how it behaves. Only sent to the model when a resolver (such as LoadText) includes it in the agent's context.")
-
-  - unless persona.new_record?
-    - tool_id = ->(tool) { tool.id.to_s }
-    = form_checklist(f, :disabled_tool_ids, persona_tool_options(persona), label: "Blocked Tools", value: tool_id, text: tool_id, hint: "Disabled tools aren't offered to the agent; everything else stays available.")
-
-  .flex.items-center.gap-3.pt-2
-    = button(persona.new_record? ? "Create persona" : "Save changes", type: :submit)
-
-    = ui_link("Cancel", persona.new_record? ? personas_path : persona_path(persona))

data/app/views/protege/personas/_persona_sidebar_item.html.slim

@@ -1,5 +0,0 @@
-= sidebar_item(persona_label(persona), persona_path(persona),
-    detail: persona_status(persona),
-    subtitle: persona.email_address,
-    active: local_assigns[:active],
-    id: dom_id(persona))

data/app/views/protege/personas/_sidebar.html.slim

@@ -1,11 +0,0 @@
-- pagy, personas = paginate(all_personas)
-
-= sidebar_content do
-  = sidebar_header("Personas (#{pagy.count})", new_path: new_persona_path)
-
-  = sidebar_stream("protege:personas", pagy: pagy)
-
-  = sidebar_body(personas, empty: "No personas yet", id: "personas_list") do |persona|
-    = render "persona_sidebar_item", persona: persona, active: local_assigns[:current] == persona
-
-  = sidebar_pagination(pagy)

data/app/views/protege/personas/edit.html.slim

@@ -1,7 +0,0 @@
-- content_for :sidebar do
-  = render "sidebar", current: @persona
-
-= page_container do
-  = page_header("Edit #{@persona.name}")
-
-  = card { render "form", persona: @persona }