layered-assistant-rails 0.3.0 → 0.3.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1e367d72d8f95ede81ac50a520755aa2afbf1fef6d9d8bf719b5ca8620ec26f3
-  data.tar.gz: 6525df2eb9d245791ebb5cb761bff293778b1b17cda0a7b4682ea566376f8664
+  metadata.gz: d8d828826c0b73a9efaa2324f15d1e7d684c2b3c00c760421d6d18bbf3f88d39
+  data.tar.gz: 11f5f52acb971db3b8bee92f6c5739e8cb89c7f5cbbd9411db8570fd53c2be87
 SHA512:
-  metadata.gz: cfa9d6034e3a92e14b386406b186f6ff5eadce1a053afcde74d816108ab5ebe680eb120aa103cb2027d75a30979876579f7c8e7cb15583e9afda5b2f36c8e599
-  data.tar.gz: b6d3ff236bf5c748ebd629a9d3e445bc9f67a7216d56290398e29628772183f0f243a4b85dbd0cd82115a48531ce410f2c264b1c9bf90dc4f19e442d07cd5f9e
+  metadata.gz: d0e8c773d9b788562089ca773c615c1871e7440f453f18f8822074b83ea69db544cd747e8c540a21c10d53fb7babe3c37fe70245ce6bfc31a64fe496dff5a2ae
+  data.tar.gz: 3d3ee90a358372e72cdadccf200fff09e56adadfefc01c8a010991febc54281466b447d8730b6e00969a29225a56e38e5349187cd23b119274463e610f792fa1

data/AGENTS.md

@@ -39,6 +39,10 @@ You can run the tests with: `bundle exec rake test`
 - Tables prefixed `layered_assistant_`
 - Models inherit from `Layered::Assistant::ApplicationRecord`
 
+### Ownership and scoping
+
+Ownership is enforced at the controller layer via `scoped()`, not with model validations. When a controller action accepts a foreign key for a scoped model (e.g. `persona_id`, `assistant_id`), look up the record through `scoped(Model).find(params[:id])` so that out-of-scope IDs return 404. Do not add model-level validations that duplicate this scoping logic.
+
 ### Generators
 
 Verify dependencies before modifying host app files. Use `inject_into_file` for safe insertion. Check for existing imports to ensure idempotency.

data/README.md

@@ -106,13 +106,7 @@ The `l_assistant_accessible?` helper evaluates the authorize block without side
 
 By default, all records are visible to any authorised user. If your application is multi-tenant or you need to restrict which records a user can see, configure a `scope` block in the initialiser.
 
-The block receives the model class, runs in controller context, and must return an `ActiveRecord::Relation`. The following models are passed through the scope block:
-
-| Model | Description |
-|---|---|
-| `Layered::Assistant::Conversation` | User conversations (has polymorphic `owner`) |
-| `Layered::Assistant::Assistant` | Assistant configurations (has polymorphic `owner`) |
-| `Layered::Assistant::Provider` | API provider credentials (has polymorphic `owner`) |
+The block receives the model class, runs in controller context, and must return an `ActiveRecord::Relation`. All engine models with a polymorphic `owner` association are passed through the scope block.
 
 ### Scope all owned resources to the current user
 

data/app/controllers/layered/assistant/assistants_controller.rb

@@ -3,10 +3,12 @@ module Layered
     class AssistantsController < ApplicationController
       before_action :set_assistant, only: [:edit, :update, :destroy]
       before_action :set_models, only: [:new, :create, :edit, :update]
+      before_action :set_personas, only: [:new, :create, :edit, :update]
+      before_action :set_skills, only: [:new, :create, :edit, :update]
 
       def index
         @page_title = "Assistants"
-        @pagy, @assistants = pagy(scoped(Assistant).by_name)
+        @pagy, @assistants = pagy(scoped(Assistant).includes(:persona).by_name)
       end
 
       def new
@@ -15,10 +17,12 @@ module Layered
       end
 
       def create
-        @assistant = Assistant.new(assistant_params)
+        @assistant = Assistant.new(assistant_params.except(:persona_id, :skill_ids))
         @assistant.owner = l_ui_current_user
+        @assistant.persona = scoped(Persona).find(assistant_params[:persona_id]) if assistant_params[:persona_id].present?
 
         if @assistant.save
+          assign_skills
           redirect_to layered_assistant.assistants_path, notice: "Assistant was successfully created."
         else
           render :new, status: :unprocessable_entity
@@ -30,7 +34,12 @@ module Layered
       end
 
       def update
-        if @assistant.update(assistant_params)
+        if assistant_params.key?(:persona_id)
+          @assistant.persona = assistant_params[:persona_id].present? ? scoped(Persona).find(assistant_params[:persona_id]) : nil
+        end
+
+        if @assistant.update(assistant_params.except(:persona_id, :skill_ids))
+          assign_skills
           redirect_to layered_assistant.assistants_path, notice: "Assistant was successfully updated."
         else
           render :edit, status: :unprocessable_entity
@@ -52,8 +61,23 @@ module Layered
         @models = Model.available
       end
 
+      def set_personas
+        @personas = scoped(Persona).by_name
+      end
+
+      def set_skills
+        @skills = scoped(Skill).by_name
+      end
+
+      def assign_skills
+        if assistant_params.key?(:skill_ids)
+          skill_ids = Array(assistant_params[:skill_ids]).compact_blank
+          @assistant.skills = scoped(Skill).where(id: skill_ids)
+        end
+      end
+
       def assistant_params
-        params.require(:assistant).permit(:name, :description, :instructions, :default_model_id, :public)
+        params.require(:assistant).permit(:name, :description, :instructions, :default_model_id, :persona_id, :public, skill_ids: [])
       end
     end
   end

data/app/controllers/layered/assistant/personas_controller.rb

@@ -0,0 +1,60 @@
+module Layered
+  module Assistant
+    class PersonasController < ApplicationController
+      before_action :set_persona, only: [:edit, :update, :destroy]
+
+      def index
+        @page_title = "Personas"
+        @pagy, @personas = pagy(scoped(Persona).by_name)
+      end
+
+      def new
+        @page_title = "New persona"
+        @persona = Persona.new
+      end
+
+      def create
+        @persona = Persona.new(persona_params)
+        @persona.owner = l_ui_current_user
+
+        if @persona.save
+          redirect_to layered_assistant.personas_path, notice: "Persona was successfully created."
+        else
+          render :new, status: :unprocessable_entity
+        end
+      end
+
+      def edit
+        @page_title = "Edit persona"
+      end
+
+      def update
+        if @persona.update(persona_params)
+          redirect_to layered_assistant.personas_path, notice: "Persona was successfully updated."
+        else
+          render :edit, status: :unprocessable_entity
+        end
+      end
+
+      def destroy
+        if @persona.destroy
+          redirect_to layered_assistant.personas_path, notice: "Persona was successfully deleted."
+        else
+          redirect_to layered_assistant.personas_path, alert: "Persona could not be deleted: #{@persona.errors.full_messages.to_sentence}."
+        end
+      rescue ActiveRecord::InvalidForeignKey
+        redirect_to layered_assistant.personas_path, alert: "Persona could not be deleted because it is assigned to assistants."
+      end
+
+      private
+
+      def set_persona
+        @persona = scoped(Persona).find(params[:id])
+      end
+
+      def persona_params
+        params.require(:persona).permit(:name, :description, :instructions)
+      end
+    end
+  end
+end

data/app/controllers/layered/assistant/skills_controller.rb

@@ -0,0 +1,60 @@
+module Layered
+  module Assistant
+    class SkillsController < ApplicationController
+      before_action :set_skill, only: [:edit, :update, :destroy]
+
+      def index
+        @page_title = "Skills"
+        @pagy, @skills = pagy(scoped(Skill).by_name)
+      end
+
+      def new
+        @page_title = "New skill"
+        @skill = Skill.new
+      end
+
+      def create
+        @skill = Skill.new(skill_params)
+        @skill.owner = l_ui_current_user
+
+        if @skill.save
+          redirect_to layered_assistant.skills_path, notice: "Skill was successfully created."
+        else
+          render :new, status: :unprocessable_entity
+        end
+      end
+
+      def edit
+        @page_title = "Edit skill"
+      end
+
+      def update
+        if @skill.update(skill_params)
+          redirect_to layered_assistant.skills_path, notice: "Skill was successfully updated."
+        else
+          render :edit, status: :unprocessable_entity
+        end
+      end
+
+      def destroy
+        if @skill.destroy
+          redirect_to layered_assistant.skills_path, notice: "Skill was successfully deleted."
+        else
+          redirect_to layered_assistant.skills_path, alert: "Skill could not be deleted: #{@skill.errors.full_messages.to_sentence}."
+        end
+      rescue ActiveRecord::InvalidForeignKey
+        redirect_to layered_assistant.skills_path, alert: "Skill could not be deleted because it is assigned to assistants."
+      end
+
+      private
+
+      def set_skill
+        @skill = scoped(Skill).find(params[:id])
+      end
+
+      def skill_params
+        params.require(:skill).permit(:name, :description, :instructions)
+      end
+    end
+  end
+end

data/app/models/layered/assistant/assistant.rb

@@ -7,6 +7,9 @@ module Layered
       # Associations
       belongs_to :owner, polymorphic: true, optional: true
       belongs_to :default_model, class_name: "Layered::Assistant::Model", optional: true, counter_cache: :assistants_count
+      belongs_to :persona, optional: true, counter_cache: :assistants_count
+      has_many :assistant_skills, dependent: :destroy
+      has_many :skills, through: :assistant_skills
       has_many :conversations, dependent: :destroy
 
       # Validations

data/app/models/layered/assistant/assistant_skill.rb

@@ -0,0 +1,12 @@
+module Layered
+  module Assistant
+    class AssistantSkill < ApplicationRecord
+      # Associations
+      belongs_to :assistant, counter_cache: :assistant_skills_count
+      belongs_to :skill, counter_cache: :assistants_count
+
+      # Validations
+      validates :skill_id, uniqueness: { scope: :assistant_id }
+    end
+  end
+end

data/app/models/layered/assistant/conversation.rb

@@ -77,9 +77,10 @@ module Layered
       private
 
       def create_system_message
-        return if assistant.instructions.blank?
+        prompt = SystemPromptService.new.call(assistant: assistant)
+        return if prompt.blank?
 
-        messages.create!(role: :system, content: assistant.instructions)
+        messages.create!(role: :system, content: prompt)
       end
 
       def broadcast_name_updated(old_name)

data/app/models/layered/assistant/persona.rb

@@ -0,0 +1,20 @@
+module Layered
+  module Assistant
+    class Persona < ApplicationRecord
+      # UID
+      has_secure_token :uid
+
+      # Associations
+      belongs_to :owner, polymorphic: true, optional: true
+      has_many :assistants, dependent: :restrict_with_error
+
+      # Validations
+      validates :name, presence: true
+      validates :instructions, presence: true
+
+      # Scopes
+      scope :by_name, -> { order(name: :asc, created_at: :desc) }
+      scope :by_created_at, -> { order(created_at: :desc) }
+    end
+  end
+end

data/app/models/layered/assistant/skill.rb

@@ -0,0 +1,20 @@
+module Layered
+  module Assistant
+    class Skill < ApplicationRecord
+      # UID
+      has_secure_token :uid
+
+      # Associations
+      belongs_to :owner, polymorphic: true, optional: true
+      has_many :assistant_skills, dependent: :restrict_with_error
+      has_many :assistants, through: :assistant_skills
+
+      # Validations
+      validates :name, presence: true
+
+      # Scopes
+      scope :by_name, -> { order(name: :asc, created_at: :desc) }
+      scope :by_created_at, -> { order(created_at: :desc) }
+    end
+  end
+end

data/app/services/layered/assistant/system_prompt_service.rb

@@ -0,0 +1,24 @@
+module Layered
+  module Assistant
+    class SystemPromptService
+      def call(assistant:)
+        parts = []
+
+        if assistant.persona&.instructions.present?
+          parts << "## Persona\n\n#{assistant.persona.instructions}"
+        end
+
+        skill_sections = assistant.skills.filter_map do |s|
+          "### #{s.name}\n\n#{s.instructions}" if s.instructions.present?
+        end
+        if skill_sections.any?
+          parts << "## Skills\n\n#{skill_sections.join("\n\n---\n\n")}"
+        end
+
+        parts << assistant.instructions if assistant.instructions.present?
+
+        parts.join("\n\n").presence
+      end
+    end
+  end
+end

data/app/views/layered/assistant/assistants/_form.html.erb

@@ -13,6 +13,12 @@
     <%= render "layered_ui/shared/field_error", object: assistant, field: :description %>
   </div>
 
+  <div class="l-ui-form__group">
+    <%= render "layered_ui/shared/label", form: f, field: :default_model_id, name: "Default model", required: false %>
+    <%= f.select :default_model_id, @models.map { |m| ["#{m.provider.name} - #{m.name}", m.id] }, { include_blank: "None" }, class: "l-ui-select" %>
+    <%= render "layered_ui/shared/field_error", object: assistant, field: :default_model_id %>
+  </div>
+
   <div class="l-ui-form__group">
     <%= render "layered_ui/shared/label", form: f, field: :instructions, required: false %>
     <%= f.text_area :instructions, class: "l-ui-form__field", rows: 5 %>
@@ -20,11 +26,24 @@
   </div>
 
   <div class="l-ui-form__group">
-    <%= render "layered_ui/shared/label", form: f, field: :default_model_id, name: "Default model", required: false %>
-    <%= f.select :default_model_id, @models.map { |m| ["#{m.provider.name} - #{m.name}", m.id] }, { include_blank: "None" }, class: "l-ui-select" %>
-    <%= render "layered_ui/shared/field_error", object: assistant, field: :default_model_id %>
+    <%= render "layered_ui/shared/label", form: f, field: :persona_id, name: "Persona", required: false %>
+    <%= f.select :persona_id, @personas.map { |p| [p.name, p.id] }, { include_blank: "None" }, class: "l-ui-select" %>
+    <%= render "layered_ui/shared/field_error", object: assistant, field: :persona_id %>
   </div>
 
+  <% if @skills.any? %>
+    <fieldset class="l-ui-form__group">
+      <legend class="l-ui-label">Skills</legend>
+      <%= hidden_field_tag "assistant[skill_ids][]", "" %>
+      <% @skills.each do |skill| %>
+        <div class="l-ui-container--checkbox">
+          <%= f.check_box :skill_ids, { multiple: true, checked: assistant.skill_ids.include?(skill.id), id: "assistant_skill_ids_#{skill.id}" }, skill.id, nil %>
+          <label for="assistant_skill_ids_<%= skill.id %>" class="l-ui-label--checkbox"><%= skill.name %></label>
+        </div>
+      <% end %>
+    </fieldset>
+  <% end %>
+
   <label class="l-ui-switch l-ui-utility--mt-xl">
     <%= f.check_box :public, class: "l-ui-switch__input", role: "switch" %>
     <span class="l-ui-switch__track"></span>

data/app/views/layered/assistant/assistants/index.html.erb

@@ -11,6 +11,8 @@
         <th scope="col" class="l-ui-table__header-cell">Name</th>
         <th scope="col" class="l-ui-table__header-cell">Description</th>
         <th scope="col" class="l-ui-table__header-cell">Default model</th>
+        <th scope="col" class="l-ui-table__header-cell">Persona</th>
+        <th scope="col" class="l-ui-table__header-cell">Skills</th>
         <th scope="col" class="l-ui-table__header-cell">Conversations</th>
         <th scope="col" class="l-ui-table__header-cell--action">Actions</th>
       </tr>
@@ -28,6 +30,12 @@
           <td class="l-ui-table__cell">
             <%= assistant.default_model&.name %>
           </td>
+          <td class="l-ui-table__cell">
+            <%= assistant.persona&.name || "None" %>
+          </td>
+          <td class="l-ui-table__cell">
+            <%= assistant.assistant_skills_count %>
+          </td>
           <td class="l-ui-table__cell">
             <%= link_to assistant.conversations_count, layered_assistant.assistant_conversations_path(assistant) %>
           </td>

data/app/views/layered/assistant/personas/_form.html.erb

@@ -0,0 +1,31 @@
+<%= form_with(model: persona, url: url, html: { class: "l-ui-form" }) do |f| %>
+  <%= render "layered_ui/shared/form_errors", item: persona %>
+
+  <div class="l-ui-form__group">
+    <%= render "layered_ui/shared/label", form: f, field: :name, required: true %>
+    <%= f.text_field :name, class: "l-ui-form__field" %>
+    <%= render "layered_ui/shared/field_error", object: persona, field: :name %>
+  </div>
+
+  <div class="l-ui-form__group">
+    <%= render "layered_ui/shared/label", form: f, field: :description, required: false %>
+    <%= f.text_area :description, class: "l-ui-form__field", rows: 3 %>
+    <%= render "layered_ui/shared/field_error", object: persona, field: :description %>
+  </div>
+
+  <div class="l-ui-form__group">
+    <%= render "layered_ui/shared/label", form: f, field: :instructions, required: true %>
+    <%= f.text_area :instructions, class: "l-ui-form__field", rows: 5 %>
+    <p class="l-ui-form__hint">Shape the personality and tone of conversations, used alongside the assistant's own instructions. e.g. "Reply in British English with a formal tone"</p>
+    <%= render "layered_ui/shared/field_error", object: persona, field: :instructions %>
+  </div>
+
+  <div class="l-ui-container--spread l-ui-utility--mt-2xl">
+    <% if persona.persisted? %>
+      <%= link_to "Delete", layered_assistant.persona_path(persona), class: "l-ui-button--outline-danger", data: { turbo_method: :delete, turbo_confirm: "Are you sure?" } %>
+    <% else %>
+      <span></span>
+    <% end %>
+    <%= f.submit persona.new_record? ? "Create" : "Update", class: "l-ui-button--primary" %>
+  </div>
+<% end %>

data/app/views/layered/assistant/personas/edit.html.erb

@@ -0,0 +1,2 @@
+<h1>Edit persona</h1>
+<%= render "form", persona: @persona, url: layered_assistant.persona_path(@persona) %>

data/app/views/layered/assistant/personas/index.html.erb

@@ -0,0 +1,41 @@
+<div class="l-ui-container--spread">
+  <h1>Personas</h1>
+  <%= link_to "New", layered_assistant.new_persona_path, class: "l-ui-button--primary" %>
+</div>
+
+<div class="l-ui-container--table l-ui-utility--mt-lg">
+  <table class="l-ui-table">
+    <caption class="l-ui-sr-only">Personas</caption>
+    <thead class="l-ui-table__header">
+      <tr>
+        <th scope="col" class="l-ui-table__header-cell">Name</th>
+        <th scope="col" class="l-ui-table__header-cell">Description</th>
+        <th scope="col" class="l-ui-table__header-cell">Assistants</th>
+        <th scope="col" class="l-ui-table__header-cell--action">Actions</th>
+      </tr>
+    </thead>
+
+    <tbody class="l-ui-table__body">
+      <% @personas.each do |persona| %>
+        <tr>
+          <th scope="row" class="l-ui-table__cell--primary">
+            <%= persona.name %>
+          </th>
+          <td class="l-ui-table__cell">
+            <%= truncate(persona.description, length: 60) %>
+          </td>
+          <td class="l-ui-table__cell">
+            <%= persona.assistants_count %>
+          </td>
+          <td class="l-ui-table__cell--action">
+            <%= link_to "Edit", layered_assistant.edit_persona_path(persona) %>
+          </td>
+        </tr>
+      <% end %>
+    </tbody>
+  </table>
+
+  <div class="l-ui-utility--mt-lg">
+    <%= l_ui_pagy(@pagy) %>
+  </div>
+</div>

data/app/views/layered/assistant/personas/new.html.erb

@@ -0,0 +1,2 @@
+<h1>New persona</h1>
+<%= render "form", persona: @persona, url: layered_assistant.personas_path %>

data/app/views/layered/assistant/skills/_form.html.erb

@@ -0,0 +1,30 @@
+<%= form_with(model: skill, url: url, html: { class: "l-ui-form" }) do |f| %>
+  <%= render "layered_ui/shared/form_errors", item: skill %>
+
+  <div class="l-ui-form__group">
+    <%= render "layered_ui/shared/label", form: f, field: :name, required: true %>
+    <%= f.text_field :name, class: "l-ui-form__field" %>
+    <%= render "layered_ui/shared/field_error", object: skill, field: :name %>
+  </div>
+
+  <div class="l-ui-form__group">
+    <%= render "layered_ui/shared/label", form: f, field: :description, required: false %>
+    <%= f.text_area :description, class: "l-ui-form__field", rows: 3 %>
+    <%= render "layered_ui/shared/field_error", object: skill, field: :description %>
+  </div>
+
+  <div class="l-ui-form__group">
+    <%= render "layered_ui/shared/label", form: f, field: :instructions, required: false %>
+    <%= f.text_area :instructions, class: "l-ui-form__field", rows: 5 %>
+    <%= render "layered_ui/shared/field_error", object: skill, field: :instructions %>
+  </div>
+
+  <div class="l-ui-container--spread l-ui-utility--mt-2xl">
+    <% if skill.persisted? %>
+      <%= link_to "Delete", layered_assistant.skill_path(skill), class: "l-ui-button--outline-danger", data: { turbo_method: :delete, turbo_confirm: "Are you sure?" } %>
+    <% else %>
+      <span></span>
+    <% end %>
+    <%= f.submit skill.new_record? ? "Create" : "Update", class: "l-ui-button--primary" %>
+  </div>
+<% end %>

data/app/views/layered/assistant/skills/edit.html.erb

@@ -0,0 +1,2 @@
+<h1>Edit skill</h1>
+<%= render "form", skill: @skill, url: layered_assistant.skill_path(@skill) %>

data/app/views/layered/assistant/skills/index.html.erb

@@ -0,0 +1,41 @@
+<div class="l-ui-container--spread">
+  <h1>Skills</h1>
+  <%= link_to "New", layered_assistant.new_skill_path, class: "l-ui-button--primary" %>
+</div>
+
+<div class="l-ui-container--table l-ui-utility--mt-lg">
+  <table class="l-ui-table">
+    <caption class="l-ui-sr-only">Skills</caption>
+    <thead class="l-ui-table__header">
+      <tr>
+        <th scope="col" class="l-ui-table__header-cell">Name</th>
+        <th scope="col" class="l-ui-table__header-cell">Description</th>
+        <th scope="col" class="l-ui-table__header-cell">Assistants</th>
+        <th scope="col" class="l-ui-table__header-cell--action">Actions</th>
+      </tr>
+    </thead>
+
+    <tbody class="l-ui-table__body">
+      <% @skills.each do |skill| %>
+        <tr>
+          <th scope="row" class="l-ui-table__cell--primary">
+            <%= skill.name %>
+          </th>
+          <td class="l-ui-table__cell">
+            <%= truncate(skill.description, length: 60) %>
+          </td>
+          <td class="l-ui-table__cell">
+            <%= skill.assistants_count %>
+          </td>
+          <td class="l-ui-table__cell--action">
+            <%= link_to "Edit", layered_assistant.edit_skill_path(skill) %>
+          </td>
+        </tr>
+      <% end %>
+    </tbody>
+  </table>
+
+  <div class="l-ui-utility--mt-lg">
+    <%= l_ui_pagy(@pagy) %>
+  </div>
+</div>

data/app/views/layered/assistant/skills/new.html.erb

@@ -0,0 +1,2 @@
+<h1>New skill</h1>
+<%= render "form", skill: @skill, url: layered_assistant.skills_path %>

data/app/views/layouts/layered/assistant/application.html.erb

@@ -9,6 +9,8 @@
   <% if l_assistant_accessible? %>
     <%= l_ui_navigation_item "Setup", layered_assistant.root_path %>
     <%= l_ui_navigation_item "Providers", layered_assistant.providers_path %>
+    <%= l_ui_navigation_item "Personas", layered_assistant.personas_path %>
+    <%= l_ui_navigation_item "Skills", layered_assistant.skills_path %>
     <%= l_ui_navigation_item "Assistants", layered_assistant.assistants_path %>
     <%= l_ui_navigation_item "Conversations", layered_assistant.conversations_path %>
   <% else %>

data/config/routes.rb

@@ -1,5 +1,7 @@
 Layered::Assistant::Engine.routes.draw do
   root "setup#index"
+  resources :personas, except: [:show]
+  resources :skills, except: [:show]
   resources :assistants, except: [:show] do
     resources :conversations, only: [:index]
   end

data/db/migrate/20260403000000_create_layered_assistant_personas.rb

@@ -0,0 +1,13 @@
+class CreateLayeredAssistantPersonas < ActiveRecord::Migration[8.0]
+  def change
+    create_table :layered_assistant_personas, if_not_exists: true do |t|
+      t.string :uid, null: false, index: { unique: true }
+      t.references :owner, polymorphic: true
+      t.string :name, null: false
+      t.text :description
+      t.text :instructions
+      t.bigint :assistants_count, default: 0, null: false
+      t.timestamps
+    end
+  end
+end

data/db/migrate/20260403000001_add_persona_to_layered_assistant_assistants.rb

@@ -0,0 +1,5 @@
+class AddPersonaToLayeredAssistantAssistants < ActiveRecord::Migration[8.0]
+  def change
+    add_reference :layered_assistant_assistants, :persona, foreign_key: { to_table: :layered_assistant_personas }
+  end
+end

data/db/migrate/20260406000001_create_layered_assistant_skills.rb

@@ -0,0 +1,13 @@
+class CreateLayeredAssistantSkills < ActiveRecord::Migration[8.0]
+  def change
+    create_table :layered_assistant_skills, if_not_exists: true do |t|
+      t.string :uid, null: false, index: { unique: true }
+      t.references :owner, polymorphic: true
+      t.string :name, null: false
+      t.text :description
+      t.text :instructions
+      t.bigint :assistants_count, default: 0, null: false
+      t.timestamps
+    end
+  end
+end

data/db/migrate/20260406000002_create_layered_assistant_assistant_skills.rb

@@ -0,0 +1,13 @@
+class CreateLayeredAssistantAssistantSkills < ActiveRecord::Migration[8.0]
+  def change
+    create_table :layered_assistant_assistant_skills, if_not_exists: true do |t|
+      t.references :assistant, null: false, foreign_key: { to_table: :layered_assistant_assistants }
+      t.references :skill, null: false, foreign_key: { to_table: :layered_assistant_skills }
+      t.timestamps
+    end
+
+    add_index :layered_assistant_assistant_skills, [:assistant_id, :skill_id], unique: true, name: "idx_assistant_skills_on_assistant_and_skill"
+
+    add_column :layered_assistant_assistants, :assistant_skills_count, :bigint, default: 0, null: false
+  end
+end

data/lib/generators/layered/assistant/templates/initializer.rb

@@ -33,10 +33,8 @@
 # have access to current_user and other helpers. Return an ActiveRecord
 # relation (e.g. model_class.where(...) or model_class.all).
 #
-# Models passed through the scope block:
-#   - Layered::Assistant::Conversation (has polymorphic owner)
-#   - Layered::Assistant::Assistant    (has polymorphic owner)
-#   - Layered::Assistant::Provider     (has polymorphic owner)
+# All engine models with a polymorphic owner association are passed through
+# the scope block.
 #
 # Scope all owned resources to the current user:
 #

data/lib/layered/assistant/version.rb

@@ -1,5 +1,5 @@
 module Layered
   module Assistant
-    VERSION = "0.3.0"
+    VERSION = "0.3.2"
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: layered-assistant-rails
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.3.2
 platform: ruby
 authors:
 - layered.ai
@@ -313,6 +313,7 @@ files:
 - app/controllers/layered/assistant/models_controller.rb
 - app/controllers/layered/assistant/panel/conversations_controller.rb
 - app/controllers/layered/assistant/panel/messages_controller.rb
+- app/controllers/layered/assistant/personas_controller.rb
 - app/controllers/layered/assistant/providers_controller.rb
 - app/controllers/layered/assistant/public/application_controller.rb
 - app/controllers/layered/assistant/public/assistants_controller.rb
@@ -321,6 +322,7 @@ files:
 - app/controllers/layered/assistant/public/panel/conversations_controller.rb
 - app/controllers/layered/assistant/public/panel/messages_controller.rb
 - app/controllers/layered/assistant/setup_controller.rb
+- app/controllers/layered/assistant/skills_controller.rb
 - app/helpers/layered/assistant/access_helper.rb
 - app/helpers/layered/assistant/messages_helper.rb
 - app/helpers/layered/assistant/panel_helper.rb
@@ -336,10 +338,13 @@ files:
 - app/jobs/layered/assistant/messages/response_job.rb
 - app/models/layered/assistant/application_record.rb
 - app/models/layered/assistant/assistant.rb
+- app/models/layered/assistant/assistant_skill.rb
 - app/models/layered/assistant/conversation.rb
 - app/models/layered/assistant/message.rb
 - app/models/layered/assistant/model.rb
+- app/models/layered/assistant/persona.rb
 - app/models/layered/assistant/provider.rb
+- app/models/layered/assistant/skill.rb
 - app/services/layered/assistant/chunk_parser.rb
 - app/services/layered/assistant/chunk_service.rb
 - app/services/layered/assistant/client_service.rb
@@ -349,6 +354,7 @@ files:
 - app/services/layered/assistant/messages_service.rb
 - app/services/layered/assistant/models/create_service.rb
 - app/services/layered/assistant/response_timer.rb
+- app/services/layered/assistant/system_prompt_service.rb
 - app/services/layered/assistant/token_estimator.rb
 - app/views/layered/assistant/assistants/_form.html.erb
 - app/views/layered/assistant/assistants/edit.html.erb
@@ -374,6 +380,10 @@ files:
 - app/views/layered/assistant/panel/conversations/show.html.erb
 - app/views/layered/assistant/panel/messages/_composer.html.erb
 - app/views/layered/assistant/panel/messages/create.turbo_stream.erb
+- app/views/layered/assistant/personas/_form.html.erb
+- app/views/layered/assistant/personas/edit.html.erb
+- app/views/layered/assistant/personas/index.html.erb
+- app/views/layered/assistant/personas/new.html.erb
 - app/views/layered/assistant/providers/_form.html.erb
 - app/views/layered/assistant/providers/edit.html.erb
 - app/views/layered/assistant/providers/index.html.erb
@@ -390,6 +400,10 @@ files:
 - app/views/layered/assistant/public/panel/messages/create.turbo_stream.erb
 - app/views/layered/assistant/setup/_setup.html.erb
 - app/views/layered/assistant/setup/index.html.erb
+- app/views/layered/assistant/skills/_form.html.erb
+- app/views/layered/assistant/skills/edit.html.erb
+- app/views/layered/assistant/skills/index.html.erb
+- app/views/layered/assistant/skills/new.html.erb
 - app/views/layouts/layered/assistant/_host_navigation.html.erb
 - app/views/layouts/layered/assistant/application.html.erb
 - config/importmap.rb
@@ -400,7 +414,11 @@ files:
 - db/migrate/20260315000000_add_stopped_to_layered_assistant_messages.rb
 - db/migrate/20260315100000_add_response_timing_to_layered_assistant_messages.rb
 - db/migrate/20260317000000_normalise_provider_protocol_values.rb
+- db/migrate/20260403000000_create_layered_assistant_personas.rb
+- db/migrate/20260403000001_add_persona_to_layered_assistant_assistants.rb
 - db/migrate/20260406000000_rename_system_prompt_to_instructions.rb
+- db/migrate/20260406000001_create_layered_assistant_skills.rb
+- db/migrate/20260406000002_create_layered_assistant_assistant_skills.rb
 - lib/generators/layered/assistant/install_generator.rb
 - lib/generators/layered/assistant/migrations_generator.rb
 - lib/generators/layered/assistant/templates/initializer.rb