raif 1.0.0

data/app/models/raif/model_completion.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+class Raif::ModelCompletion < Raif::ApplicationRecord
+  include Raif::Concerns::LlmResponseParsing
+  include Raif::Concerns::HasAvailableModelTools
+
+  belongs_to :source, polymorphic: true, optional: true
+
+  validates :llm_model_key, presence: true, inclusion: { in: ->{ Raif.available_llm_keys.map(&:to_s) } }
+  validates :model_api_name, presence: true
+
+  delegate :json_response_schema, to: :source, allow_nil: true
+
+  before_save :set_total_tokens
+
+  after_initialize -> { self.messages ||= [] }
+  after_initialize -> { self.available_model_tools ||= [] }
+
+  def json_response_schema
+    source.json_response_schema if source&.respond_to?(:json_response_schema)
+  end
+
+protected
+
+  def set_total_tokens
+    self.total_tokens ||= completion_tokens.present? && prompt_tokens.present? ? completion_tokens + prompt_tokens : nil
+  end
+end

data/app/models/raif/model_tool.rb

@@ -0,0 +1,69 @@
+# frozen_string_literal: true
+
+class Raif::ModelTool
+
+  delegate :tool_name, :tool_description, :tool_arguments_schema, to: :class
+
+  # The description of the tool that will be provided to the model
+  # when giving it a list of available tools.
+  def self.description_for_llm
+    <<~DESCRIPTION
+      Name: #{tool_name}
+      Description: #{tool_description}
+      Arguments Schema:
+      #{JSON.pretty_generate(tool_arguments_schema)}
+      Example Usage:
+      #{JSON.pretty_generate(example_model_invocation)}
+    DESCRIPTION
+  end
+
+  # The name of the tool as it will be provided to the model & used in the model invocation.
+  # Default for something like Raif::ModelTools::WikipediaSearch would be "wikipedia_search"
+  def self.tool_name
+    name.split("::").last.underscore
+  end
+
+  def self.tool_description
+    raise NotImplementedError, "#{self.class.name}#tool_description is not implemented"
+  end
+
+  def self.example_model_invocation
+    raise NotImplementedError, "#{self.class.name}#example_model_invocation is not implemented"
+  end
+
+  def self.process_invocation(invocation)
+    raise NotImplementedError, "#{self.class.name}#process_invocation is not implemented"
+  end
+
+  def self.invocation_partial_name
+    name.gsub("Raif::ModelTools::", "").underscore
+  end
+
+  def self.tool_arguments_schema
+    raise NotImplementedError, "#{self.class.name}#tool_arguments_schema is not implemented"
+  end
+
+  def self.renderable?
+    true
+  end
+
+  def self.invoke_tool(tool_arguments:, source:)
+    tool_invocation = Raif::ModelToolInvocation.new(
+      source: source,
+      tool_type: name,
+      tool_arguments: tool_arguments
+    )
+
+    ActiveRecord::Base.transaction do
+      tool_invocation.save!
+      process_invocation(tool_invocation)
+      tool_invocation.completed!
+    end
+
+    tool_invocation
+  rescue StandardError => e
+    tool_invocation.failed!
+    raise e
+  end
+
+end

data/app/models/raif/model_tool_invocation.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+require "json-schema"
+
+class Raif::ModelToolInvocation < Raif::ApplicationRecord
+  belongs_to :source, polymorphic: true
+
+  after_initialize -> { self.tool_arguments ||= {} }
+  after_initialize -> { self.result ||= {} }
+
+  validates :tool_type, presence: true
+  validate :ensure_valid_tool_argument_schema, if: -> { tool_type.present? && tool_arguments_schema.present? }
+
+  delegate :tool_arguments_schema, :renderable?, :tool_name, to: :tool
+
+  boolean_timestamp :completed_at
+  boolean_timestamp :failed_at
+
+  def tool
+    @tool ||= tool_type.constantize
+  end
+
+  def as_llm_message
+    "Invoking tool: #{tool_name} with arguments: #{tool_arguments.to_json}"
+  end
+
+  def result_llm_message
+    if result.present?
+      "Result from #{tool_name}: #{result.to_json}"
+    end
+  end
+
+  def to_partial_path
+    "raif/model_tool_invocations/#{tool.invocation_partial_name}"
+  end
+
+  def ensure_valid_tool_argument_schema
+    unless JSON::Validator.validate(tool_arguments_schema, tool_arguments)
+      errors.add(:tool_arguments, "does not match schema")
+    end
+  end
+
+end

data/app/models/raif/model_tools/agent_final_answer.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+class Raif::ModelTools::AgentFinalAnswer < Raif::ModelTool
+
+  def self.example_model_invocation
+    {
+      "name" => tool_name,
+      "arguments" => { "final_answer": "The answer to the user's question or task" }
+    }
+  end
+
+  def self.tool_arguments_schema
+    {
+      type: "object",
+      additionalProperties: false,
+      required: ["final_answer"],
+      properties: {
+        final_answer: {
+          type: "string",
+          description: "Your complete and final answer to the user's question or task"
+        }
+      }
+    }
+  end
+
+  def self.tool_description
+    "Provide your final answer to the user's question or task"
+  end
+
+  def self.observation_for_invocation(tool_invocation)
+    return "No answer provided" unless tool_invocation.result.present?
+
+    tool_invocation.result["final_answer"]
+  end
+
+  def self.process_invocation(tool_invocation)
+    tool_invocation.update!(
+      result: {
+        final_answer: tool_invocation.tool_arguments["final_answer"]
+      }
+    )
+
+    tool_invocation.result
+  end
+
+end

data/app/models/raif/model_tools/fetch_url.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+class Raif::ModelTools::FetchUrl < Raif::ModelTool
+
+  def self.example_model_invocation
+    {
+      "name": tool_name,
+      "arguments": { "url": "https://en.wikipedia.org/wiki/NASA" }
+    }
+  end
+
+  def self.tool_arguments_schema
+    {
+      type: "object",
+      additionalProperties: false,
+      required: ["url"],
+      properties: {
+        url: {
+          type: "string",
+          description: "The URL to fetch content from"
+        }
+      }
+    }
+  end
+
+  def self.tool_description
+    "Fetch a URL and return the page content as markdown"
+  end
+
+  def self.observation_for_invocation(tool_invocation)
+    return "No results found" unless tool_invocation.result.present?
+
+    <<~OBSERVATION
+      Result Status: #{tool_invocation.result["status"]}
+      Result Content:
+      #{tool_invocation.result["content"]}
+    OBSERVATION
+  end
+
+  def self.process_invocation(tool_invocation)
+    url = tool_invocation.tool_arguments["url"]
+    response = Faraday.get(url)
+
+    readable_content = Raif::Utils::ReadableContentExtractor.new(response.body).extract_readable_content
+    markdown_content = Raif::Utils::HtmlToMarkdownConverter.convert(readable_content)
+
+    tool_invocation.update!(
+      result: {
+        status: response.status,
+        content: markdown_content
+      }
+    )
+
+    tool_invocation.result
+  end
+
+end

data/app/models/raif/model_tools/wikipedia_search.rb

@@ -0,0 +1,78 @@
+# frozen_string_literal: true
+
+class Raif::ModelTools::WikipediaSearch < Raif::ModelTool
+
+  def self.example_model_invocation
+    {
+      "name" => tool_name,
+      "arguments" => { "query": "Jimmy Buffett" }
+    }
+  end
+
+  def self.tool_arguments_schema
+    {
+      type: "object",
+      additionalProperties: false,
+      required: ["query"],
+      properties: {
+        query: {
+          type: "string",
+          description: "The query to search Wikipedia for"
+        }
+      }
+    }
+  end
+
+  def self.tool_description
+    "Search Wikipedia for information"
+  end
+
+  def self.observation_for_invocation(tool_invocation)
+    return "No results found" unless tool_invocation.result.present?
+
+    JSON.pretty_generate(tool_invocation.result)
+  end
+
+  def self.process_invocation(tool_invocation)
+    query = tool_invocation.tool_arguments["query"]
+
+    conn = Faraday.new(url: "https://en.wikipedia.org/w/api.php")
+
+    response = conn.get do |req|
+      req.params["action"] = "query"
+      req.params["format"] = "json"
+      req.params["list"] = "search"
+      req.params["srsearch"] = query
+      req.params["srlimit"] = 5 # Limit to 5 results
+      req.params["srprop"] = "snippet"
+    end
+
+    if response.success?
+      results = JSON.parse(response.body)
+      search_results = results.dig("query", "search") || []
+
+      # Store the results in the tool_invocation
+      tool_invocation.update!(
+        result: {
+          results: search_results.map do |result|
+            {
+              title: result["title"],
+              snippet: result["snippet"],
+              page_id: result["pageid"],
+              url: "https://en.wikipedia.org/wiki/#{result["title"].gsub(" ", "_")}"
+            }
+          end
+        }
+      )
+    else
+      tool_invocation.update!(
+        result: {
+          error: "Failed to fetch results from Wikipedia API: #{response.status} #{response.reason_phrase}"
+        }
+      )
+    end
+
+    tool_invocation.result
+  end
+
+end

data/app/models/raif/task.rb

@@ -0,0 +1,137 @@
+# frozen_string_literal: true
+
+module Raif
+  class Task < Raif::ApplicationRecord
+    include Raif::Concerns::HasLlm
+    include Raif::Concerns::HasRequestedLanguage
+    include Raif::Concerns::HasAvailableModelTools
+    include Raif::Concerns::InvokesModelTools
+    include Raif::Concerns::LlmResponseParsing
+
+    belongs_to :creator, polymorphic: true
+
+    has_one :raif_model_completion, as: :source, dependent: :destroy, class_name: "Raif::ModelCompletion"
+
+    boolean_timestamp :started_at
+    boolean_timestamp :completed_at
+    boolean_timestamp :failed_at
+
+    normalizes :prompt, :system_prompt, with: ->(text){ text&.strip }
+
+    delegate :json_response_schema, to: :class
+
+    after_initialize -> { self.available_model_tools ||= [] }
+
+    def self.llm_response_format(format)
+      raise ArgumentError, "response_format must be one of: #{response_formats.keys.join(", ")}" unless response_formats.keys.include?(format.to_s)
+
+      after_initialize -> { self.response_format = format }, if: :new_record?
+    end
+
+    # The primary interface for running a task. It will hit the LLM with the task's prompt and system prompt and return a Raif::Task object.
+    # It will also create a new Raif::ModelCompletion record.
+    #
+    # @param creator [Object] The creator of the task (polymorphic association)
+    # @param available_model_tools [Array<Class>] Optional array of model tool classes that will be provided to the LLM for it to invoke.
+    # @param llm_model_key [Symbol, String] Optional key for the LLM model to use. If blank, Raif.config.default_llm_model_key will be used.
+    # @param args [Hash] Additional arguments to pass to the instance of the task that is created.
+    # @return [Raif::Task, nil] The task instance that was created and run.
+    def self.run(creator:, available_model_tools: [], llm_model_key: nil, **args)
+      task = new(creator:, llm_model_key:, available_model_tools:, started_at: Time.current, **args)
+      task.save!
+      task.run
+      task
+    rescue StandardError => e
+      task&.failed!
+
+      logger.error e.message
+      logger.error e.backtrace.join("\n")
+
+      if defined?(Airbrake)
+        notice = Airbrake.build_notice(e)
+        notice[:context][:component] = "raif_task"
+        notice[:context][:action] = name
+
+        Airbrake.notify(notice)
+      end
+
+      task
+    end
+
+    def run
+      update_columns(started_at: Time.current) if started_at.nil?
+
+      populate_prompts
+      messages = [{ "role" => "user", "content" => prompt }]
+      mc = llm.chat(
+        messages: messages,
+        source: self,
+        system_prompt: system_prompt,
+        response_format: response_format.to_sym,
+        available_model_tools: available_model_tools
+      )
+
+      self.raif_model_completion = mc.becomes(Raif::ModelCompletion)
+
+      update(raw_response: raif_model_completion.raw_response)
+
+      process_model_tool_invocations
+      completed!
+      self
+    end
+
+    # Returns the LLM prompt for the task.
+    #
+    # @param creator [Object] The creator of the task (polymorphic association)
+    # @param args [Hash] Additional arguments to pass to the instance of the task that is created.
+    # @return [String] The LLM prompt for the task.
+    def self.prompt(creator:, **args)
+      new(creator:, **args).prompt
+    end
+
+    # Returns the LLM system prompt for the task.
+    #
+    # @param creator [Object] The creator of the task (polymorphic association)
+    # @param args [Hash] Additional arguments to pass to the instance of the task that is created.
+    # @return [String] The LLM system prompt for the task.
+    def self.system_prompt(creator:, **args)
+      new(creator:, **args).system_prompt
+    end
+
+    def self.json_response_schema
+      nil
+    end
+
+  private
+
+    def build_prompt
+      raise NotImplementedError, "Raif::Task subclasses must implement #build_prompt"
+    end
+
+    def build_system_prompt
+      sp = Raif.config.task_system_prompt_intro
+      sp += system_prompt_language_preference if requested_language_key.present?
+      sp
+    end
+
+    def populate_prompts
+      self.requested_language_key ||= creator.preferred_language_key if creator.respond_to?(:preferred_language_key)
+      self.prompt = build_prompt
+      self.system_prompt = build_system_prompt
+    end
+
+    def process_model_tool_invocations
+      return unless response_format_json?
+      return unless parsed_response.is_a?(Hash)
+      return unless parsed_response["tools"].present? && parsed_response["tools"].is_a?(Array)
+
+      parsed_response["tools"].each do |t|
+        tool_klass = available_model_tools_map[t["name"]]
+        next unless tool_klass
+
+        tool_klass.invoke_tool(tool_arguments: t["arguments"], source: self)
+      end
+    end
+
+  end
+end

data/app/models/raif/user_tool_invocation.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+class Raif::UserToolInvocation < Raif::ApplicationRecord
+  belongs_to :raif_conversation_entry, class_name: "Raif::ConversationEntry"
+
+  after_initialize -> { self.tool_settings ||= {} }
+
+  delegate :tool_name, :tool_key, to: :class
+
+  def message_input_placeholder
+    I18n.t("#{self.class.name.underscore.gsub("/", ".")}.message_input_placeholder", default: nil)
+  end
+
+  def as_user_message
+    # implement in subclasses
+  end
+
+  def self.tool_name
+    I18n.t("#{name.underscore.gsub("/", ".")}.name")
+  end
+
+  def self.tool_key
+    model_name.element
+  end
+
+  def self.tool_params
+    []
+  end
+end

data/app/views/layouts/raif/admin.html.erb

@@ -0,0 +1,98 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <title><%= t("raif.admin.layouts.admin.title") %></title>
+  <meta name="viewport" content="width=device-width,initial-scale=1">
+  <%= csrf_meta_tags %>
+  <%= csp_meta_tag %>
+
+  <link href="https://cdn.jsdelivr.net/npm/bootstrap@5.3.2/dist/css/bootstrap.min.css" rel="stylesheet" integrity="sha384-T3c6CoIi6uLrA9TneNEoa7RxnatzjcDSCmG1MXxSR1GAsXEV/Dwwykc2MPK8M2HN" crossorigin="anonymous">
+  <script src="https://cdn.jsdelivr.net/npm/bootstrap@5.3.2/dist/js/bootstrap.bundle.min.js" integrity="sha384-C6RzsynM9kWDrMNeT87bh95OGNyZPhcTNXj1NW7RuBCsyN/o0jlpcV8Qyq46cDfL" crossorigin="anonymous" nonce="<%= request.content_security_policy_nonce %>"></script>
+
+  <%= stylesheet_link_tag "raif_admin" %>
+</head>
+
+<body class="raif-admin">
+  <nav class="navbar navbar-expand-md navbar-dark bg-dark">
+    <div class="container-fluid">
+      <a class="navbar-brand fw-bold" href="<%= raif.admin_tasks_path %>"><%= t("raif.admin.layouts.admin.title") %></a>
+      <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbarCollapse" aria-controls="navbarCollapse" aria-expanded="false" aria-label="Toggle navigation">
+        <span class="navbar-toggler-icon"></span>
+      </button>
+      <div class="collapse navbar-collapse" id="navbarCollapse">
+        <ul class="navbar-nav ms-auto mb-2 mb-md-0">
+        </ul>
+      </div>
+    </div>
+  </nav>
+
+  <div class="container-fluid">
+    <div class="row">
+      <!-- Left sidebar navigation -->
+      <div class="col-md-3 col-lg-2 d-md-block bg-light sidebar">
+        <div class="position-sticky pt-3">
+          <ul class="nav flex-column">
+            <li class="nav-item">
+              <a class="nav-link <%= current_page?(raif.admin_tasks_path) ? "active" : "" %>" href="<%= raif.admin_tasks_path %>">
+                <span class="d-inline-block me-2">
+                  <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="currentColor" class="bi bi-list-check" viewBox="0 0 16 16">
+                    <path fill-rule="evenodd" d="M5 11.5a.5.5 0 0 1 .5-.5h9a.5.5 0 0 1 0 1h-9a.5.5 0 0 1-.5-.5zm0-4a.5.5 0 0 1 .5-.5h9a.5.5 0 0 1 0 1h-9a.5.5 0 0 1-.5-.5zm0-4a.5.5 0 0 1 .5-.5h9a.5.5 0 0 1 0 1h-9a.5.5 0 0 1-.5-.5zM3.854 2.146a.5.5 0 0 1 0 .708l-1.5 1.5a.5.5 0 0 1-.708 0l-.5-.5a.5.5 0 1 1 .708-.708L2 3.293l1.146-1.147a.5.5 0 0 1 .708 0zm0 4a.5.5 0 0 1 0 .708l-1.5 1.5a.5.5 0 0 1-.708 0l-.5-.5a.5.5 0 1 1 .708-.708L2 7.293l1.146-1.147a.5.5 0 0 1 .708 0zm0 4a.5.5 0 0 1 0 .708l-1.5 1.5a.5.5 0 0 1-.708 0l-.5-.5a.5.5 0 0 1 .708-.708l.146.147 1.146-1.147a.5.5 0 0 1 .708 0z" />
+                  </svg>
+                </span>
+                <%= t("raif.admin.common.tasks") %>
+              </a>
+            </li>
+            <li class="nav-item">
+              <a class="nav-link <%= current_page?(raif.admin_conversations_path) ? "active" : "" %>" href="<%= raif.admin_conversations_path %>">
+                <span class="d-inline-block me-2">
+                  <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="currentColor" class="bi bi-chat-dots" viewBox="0 0 16 16">
+                    <path d="M5 8a1 1 0 1 1-2 0 1 1 0 0 1 2 0zm4 0a1 1 0 1 1-2 0 1 1 0 0 1 2 0zm3 1a1 1 0 1 0 0-2 1 1 0 0 0 0 2z" />
+                    <path d="m2.165 15.803.02-.004c1.83-.363 2.948-.842 3.468-1.105A9.06 9.06 0 0 0 8 15c4.418 0 8-3.134 8-7s-3.582-7-8-7-8 3.134-8 7c0 1.76.743 3.37 1.97 4.6a10.437 10.437 0 0 1-.524 2.318l-.003.011a10.722 10.722 0 0 1-.244.637c-.079.186.074.394.273.362a21.673 21.673 0 0 0 .693-.125zm.8-3.108a1 1 0 0 0-.287-.801C1.618 10.83 1 9.468 1 8c0-3.192 3.004-6 7-6s7 2.808 7 6c0 3.193-3.004 6-7 6a8.06 8.06 0 0 1-2.088-.272 1 1 0 0 0-.711.074c-.387.196-1.24.57-2.634.893a10.97 10.97 0 0 0 .398-2z" />
+                  </svg>
+                </span>
+                <%= t("raif.admin.common.conversations") %>
+              </a>
+            </li>
+            <li class="nav-item">
+              <a class="nav-link <%= current_page?(raif.admin_model_completions_path) ? "active" : "" %>" href="<%= raif.admin_model_completions_path %>">
+                <span class="d-inline-block me-2">
+                  <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="currentColor" class="bi bi-robot" viewBox="0 0 16 16">
+                    <path d="M6 12.5a.5.5 0 0 1 .5-.5h3a.5.5 0 0 1 0 1h-3a.5.5 0 0 1-.5-.5ZM3 8.062C3 6.76 4.235 5.765 5.53 5.886a26.58 26.58 0 0 0 4.94 0C11.765 5.765 13 6.76 13 8.062v1.157a.933.933 0 0 1-.765.935c-.845.147-2.34.346-4.235.346-1.895 0-3.39-.2-4.235-.346A.933.933 0 0 1 3 9.219V8.062Zm4.542-.827a.25.25 0 0 0-.217.068l-.92.9a24.767 24.767 0 0 1-1.871-.183.25.25 0 0 0-.068.495c.55.076 1.232.149 2.02.193a.25.25 0 0 0 .189-.071l.754-.736.847 1.71a.25.25 0 0 0 .404.062l.932-.97a25.286 25.286 0 0 0 1.922-.188.25.25 0 0 0-.068-.495c-.538.074-1.207.145-1.98.189a.25.25 0 0 0-.166.076l-.754.785-.842-1.7a.25.25 0 0 0-.182-.135Z" />
+                    <path d="M8.5 1.866a1 1 0 1 0-1 0V3h-2A4.5 4.5 0 0 0 1 7.5V8a1 1 0 0 0-1 1v2a1 1 0 0 0 1 1v1a2 2 0 0 0 2 2h10a2 2 0 0 0 2-2v-1a1 1 0 0 0 1-1V9a1 1 0 0 0-1-1v-.5A4.5 4.5 0 0 0 10.5 3h-2V1.866ZM14 7.5V13a1 1 0 0 1-1 1H3a1 1 0 0 1-1-1V7.5A3.5 3.5 0 0 1 5.5 4h5A3.5 3.5 0 0 1 14 7.5Z" />
+                  </svg>
+                </span>
+                <%= t("raif.admin.common.model_completions") %>
+              </a>
+            </li>
+            <li class="nav-item">
+              <a class="nav-link <%= current_page?(raif.admin_model_tool_invocations_path) ? "active" : "" %>" href="<%= raif.admin_model_tool_invocations_path %>">
+                <span class="d-inline-block me-2">
+                  <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="currentColor" class="bi bi-tools" viewBox="0 0 16 16">
+                    <path d="M1 0 0 1l2.2 3.081a1 1 0 0 0 .815.419h.07a1 1 0 0 1 .708.293l2.675 2.675-2.617 2.654A3.003 3.003 0 0 0 0 13a3 3 0 1 0 5.878-.851l2.654-2.617.968.968-.305.914a1 1 0 0 0 .242 1.023l3.27 3.27a.997.997 0 0 0 1.414 0l1.586-1.586a.997.997 0 0 0 0-1.414l-3.27-3.27a1 1 0 0 0-1.023-.242L10.5 9.5l-.96-.96 2.68-2.643A3.005 3.005 0 0 0 16 3c0-.269-.035-.53-.102-.777l-2.14 2.141L12 4l-.364-1.757L13.777.102a3 3 0 0 0-3.675 3.68L7.462 6.46 4.793 3.793a1 1 0 0 1-.293-.707v-.071a1 1 0 0 0-.419-.814L1 0Zm9.646 10.646a.5.5 0 0 1 .708 0l2.914 2.915a.5.5 0 0 1-.707.707l-2.915-2.914a.5.5 0 0 1 0-.708ZM3 11l.471.242.529.026.287.445.445.287.026.529L5 13l-.242.471-.026.529-.445.287-.287.445-.529.026L3 15l-.471-.242L2 14.732l-.287-.445L1.268 14l-.026-.529L1 13l.242-.471.026-.529.445-.287.287-.445.529-.026L3 11Z" />
+                  </svg>
+                </span>
+                <%= t("raif.admin.common.model_tool_invocations") %>
+              </a>
+            </li>
+            <li class="nav-item">
+              <a class="nav-link <%= current_page?(raif.admin_agents_path) ? "active" : "" %>" href="<%= raif.admin_agents_path %>">
+                <span class="d-inline-block me-2">
+                  <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="currentColor" class="bi bi-cpu" viewBox="0 0 16 16">
+                    <path d="M5 0a.5.5 0 0 1 .5.5V2h1V.5a.5.5 0 0 1 1 0V2h1V.5a.5.5 0 0 1 1 0V2h1V.5a.5.5 0 0 1 1 0V2A2.5 2.5 0 0 1 14 4.5h1.5a.5.5 0 0 1 0 1H14v1h1.5a.5.5 0 0 1 0 1H14v1h1.5a.5.5 0 0 1 0 1H14v1h1.5a.5.5 0 0 1 0 1H14a2.5 2.5 0 0 1-2.5 2.5v1.5a.5.5 0 0 1-1 0V14h-1v1.5a.5.5 0 0 1-1 0V14h-1v1.5a.5.5 0 0 1-1 0V14h-1v1.5a.5.5 0 0 1-1 0V14A2.5 2.5 0 0 1 2 11.5H.5a.5.5 0 0 1 0-1H2v-1H.5a.5.5 0 0 1 0-1H2v-1H.5a.5.5 0 0 1 0-1H2v-1H.5a.5.5 0 0 1 0-1H2A2.5 2.5 0 0 1 4.5 2V.5A.5.5 0 0 1 5 0zm-.5 3A1.5 1.5 0 0 0 3 4.5v7A1.5 1.5 0 0 0 4.5 13h7a1.5 1.5 0 0 0 1.5-1.5v-7A1.5 1.5 0 0 0 11.5 3h-7zM5 6.5A1.5 1.5 0 0 1 6.5 5h3A1.5 1.5 0 0 1 11 6.5v3A1.5 1.5 0 0 1 9.5 11h-3A1.5 1.5 0 0 1 5 9.5v-3zM6.5 6a.5.5 0 0 0-.5.5v3a.5.5 0 0 0 .5.5h3a.5.5 0 0 0 .5-.5v-3a.5.5 0 0 0-.5-.5h-3z" />
+                  </svg>
+                </span>
+                <%= t("raif.admin.common.agents") %>
+              </a>
+            </li>
+          </ul>
+        </div>
+      </div>
+
+      <!-- Main content area -->
+      <main class="col-md-9 ms-sm-auto col-lg-10 px-md-4">
+        <%= yield %>
+      </main>
+    </div>
+  </div>
+</body>
+</html>

data/app/views/raif/admin/agents/_agent.html.erb

@@ -0,0 +1,18 @@
+<tr id="<%= dom_id(agent) %>" class="raif-agent">
+  <td><%= link_to "##{agent.id}", raif.admin_agent_path(agent) %></td>
+  <td><small class="text-muted"><%= agent.created_at.rfc822 %></small></td>
+  <td><small class="text-muted"><%= truncate(agent.task, length: 100) %></small></td>
+  <td>
+    <% if agent.completed_at? %>
+      <span class="badge bg-success"><%= t("raif.admin.common.completed") %></span>
+    <% elsif agent.failed_at? %>
+      <span class="badge bg-danger"><%= t("raif.admin.common.failed") %></span>
+    <% elsif agent.started_at? %>
+      <span class="badge bg-warning"><%= t("raif.admin.common.running") %></span>
+    <% else %>
+      <span class="badge bg-secondary"><%= t("raif.admin.common.pending") %></span>
+    <% end %>
+  </td>
+  <td><%= agent.iteration_count %> / <%= agent.max_iterations %></td>
+  <td><small class="text-muted"><%= truncate(agent.final_answer, length: 100) if agent.final_answer %></small></td>
+</tr>

data/app/views/raif/admin/agents/_conversation_message.html.erb

@@ -0,0 +1,15 @@
+<div class="message <%= message["role"] %> mb-3">
+  <div class="message-header d-flex justify-content-between align-items-center mb-2 px-2">
+    <strong class="<%= message["role"] == "user" ? "text-primary" : "text-success" %>">
+      <%= message["role"].capitalize %>
+      <% if message[:counter] == 0 && message["role"] == 'user' %>
+        (<%= t("raif.admin.common.initial_task") %>)
+      <% end %>
+    </strong>
+    <span class="badge bg-secondary">#<%= message_count %></span>
+  </div>
+
+  <div class="message-content px-3 py-2">
+    <code><%= message["content"] %></code>
+  </div>
+</div>

data/app/views/raif/admin/agents/index.html.erb

@@ -0,0 +1,33 @@
+<h1 class="my-4"><%= t("raif.admin.common.agents") %></h1>
+
+<div class="row">
+  <div class="col-12">
+    <% if @agents.any? %>
+      <div class="table-responsive">
+        <table class="table table-striped table-hover">
+          <thead class="table-light">
+            <tr>
+              <th><%= t("raif.admin.common.id") %></th>
+              <th><%= t("raif.admin.common.created_at") %></th>
+              <th><%= t("raif.admin.common.task") %></th>
+              <th><%= t("raif.admin.common.status") %></th>
+              <th><%= t("raif.admin.common.iterations") %></th>
+              <th><%= t("raif.admin.common.final_answer") %></th>
+            </tr>
+          </thead>
+          <tbody>
+            <%= render partial: "raif/admin/agents/agent", collection: @agents %>
+          </tbody>
+        </table>
+      </div>
+
+      <div class="mt-4">
+        <%== pagy_bootstrap_nav(@pagy) %>
+      </div>
+    <% else %>
+      <div class="alert alert-info">
+        <%= t("raif.admin.common.no_agents") %>
+      </div>
+    <% end %>
+  </div>
+</div>