htm 0.0.31 → 0.0.32

data/examples/12_rails_app/app/views/memories/show.html.erb

@@ -1,3 +1,5 @@
+<% content_for :body_attributes do %>data-no-auto-refresh<% end %>
+
 <div class="space-y-6">
   <!-- Back link -->
   <div>
@@ -41,7 +43,7 @@
               </svg>
               Restore
             <% end %>
-            <%= button_to memory_path(@memory.id, permanent: true), method: :delete, class: 'inline-flex items-center gap-2 rounded-md bg-red-600 px-3 py-2 text-sm font-medium text-white hover:bg-red-500 transition-colors', data: { turbo_confirm: 'Permanently delete this memory? This cannot be undone!' } do %>
+            <%= button_to memory_path(@memory.id, permanent: true), method: :delete, data: { confirm: 'Permanently delete this memory? This cannot be undone!' }, class: 'inline-flex items-center gap-2 rounded-md bg-red-600 px-3 py-2 text-sm font-medium text-white hover:bg-red-500 transition-colors' do %>
               <svg class="h-4 w-4" fill="none" viewBox="0 0 24 24" stroke="currentColor">
                 <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M19 7l-.867 12.142A2 2 0 0116.138 21H7.862a2 2 0 01-1.995-1.858L5 7m5 4v6m4-6v6m1-10V4a1 1 0 00-1-1h-4a1 1 0 00-1 1v3M4 7h16" />
               </svg>
@@ -54,7 +56,7 @@
               </svg>
               Edit
             <% end %>
-            <%= button_to memory_path(@memory.id), method: :delete, class: 'inline-flex items-center gap-2 rounded-md bg-red-600/80 px-3 py-2 text-sm font-medium text-white hover:bg-red-600 transition-colors', data: { turbo_confirm: 'Move this memory to trash?' } do %>
+            <%= button_to memory_path(@memory.id), method: :delete, data: { confirm: 'Move this memory to trash?' }, class: 'inline-flex items-center gap-2 rounded-md bg-red-600/80 px-3 py-2 text-sm font-medium text-white hover:bg-red-600 transition-colors' do %>
               <svg class="h-4 w-4" fill="none" viewBox="0 0 24 24" stroke="currentColor">
                 <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M19 7l-.867 12.142A2 2 0 0116.138 21H7.862a2 2 0 01-1.995-1.858L5 7m5 4v6m4-6v6m1-10V4a1 1 0 00-1-1h-4a1 1 0 00-1 1v3M4 7h16" />
               </svg>

data/examples/12_rails_app/app/views/messages/_message.html.erb

@@ -0,0 +1,20 @@
+<% is_user = message.role == 'user' %>
+
+<div class="flex <%= is_user ? 'justify-end' : 'justify-start' %>">
+  <div class="max-w-[80%] <%= is_user ? 'order-2' : 'order-1' %>">
+    <div class="rounded-lg px-4 py-3 <%= is_user ? 'bg-indigo-600 text-white' : 'bg-gray-800 border border-gray-700 text-gray-100' %>">
+      <div class="prose prose-sm <%= is_user ? 'prose-invert' : 'prose-gray' %> max-w-none">
+        <p class="whitespace-pre-wrap break-words"><%= message.content %></p>
+      </div>
+    </div>
+    <div class="flex items-center gap-2 mt-1 <%= is_user ? 'justify-end' : 'justify-start' %>">
+      <span class="text-xs text-gray-500">
+        <%= message.role.capitalize %>
+      </span>
+      <span class="text-xs text-gray-600">&bull;</span>
+      <time class="text-xs text-gray-500 local-time" datetime="<%= message.created_at.utc.iso8601 %>">
+        <%= message.created_at.strftime('%H:%M') %>
+      </time>
+    </div>
+  </div>
+</div>

data/examples/12_rails_app/app/views/robots/index.html.erb

@@ -1,3 +1,5 @@
+<% content_for :body_attributes do %>data-no-auto-refresh<% end %>
+
 <div class="space-y-6">
   <!-- Header -->
   <div class="flex items-center justify-between">

data/examples/12_rails_app/app/views/robots/new.html.erb

@@ -1,3 +1,5 @@
+<% content_for :body_attributes do %>data-no-auto-refresh<% end %>
+
 <div class="space-y-6">
   <!-- Back link -->
   <div>

data/examples/12_rails_app/app/views/robots/show.html.erb

@@ -1,3 +1,5 @@
+<% content_for :body_attributes do %>data-no-auto-refresh<% end %>
+
 <div class="space-y-6">
   <!-- Back link -->
   <div>

data/examples/12_rails_app/app/views/search/index.html.erb

@@ -1,3 +1,6 @@
+<%# Disable auto-refresh on search page - searches take time %>
+<% content_for :body_attributes do %>data-no-auto-refresh<% end %>
+
 <div class="space-y-6">
   <!-- Header -->
   <div>
@@ -7,7 +10,7 @@
 
   <!-- Search Form -->
   <div class="rounded-lg bg-gray-800 border border-gray-700 p-6">
-    <%= form_with url: search_path, method: :get, class: 'space-y-4', data: { turbo: false } do %>
+    <%= form_with url: search_path, method: :get, class: 'space-y-4', html: { id: 'search-form' } do %>
       <div>
         <label for="query" class="block text-sm font-medium text-gray-300 mb-2">Search Query</label>
         <div class="flex gap-4">
@@ -19,7 +22,13 @@
             placeholder="Enter your search query..."
             class="flex-1 rounded-md bg-gray-700 border-gray-600 text-white placeholder-gray-400 focus:ring-indigo-500 focus:border-indigo-500"
           />
-          <%= submit_tag 'Search', class: 'rounded-md bg-indigo-600 px-6 py-2 text-sm font-medium text-white hover:bg-indigo-500 cursor-pointer transition-colors' %>
+          <button type="submit" id="search-btn" class="rounded-md bg-indigo-600 px-6 py-2 text-sm font-medium text-white hover:bg-indigo-500 cursor-pointer transition-colors inline-flex items-center gap-2">
+            <svg id="search-spinner" class="hidden animate-spin h-4 w-4 text-white" xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24">
+              <circle class="opacity-25" cx="12" cy="12" r="10" stroke="currentColor" stroke-width="4"></circle>
+              <path class="opacity-75" fill="currentColor" d="M4 12a8 8 0 018-8V0C5.373 0 0 5.373 0 12h4zm2 5.291A7.962 7.962 0 014 12H0c0 3.042 1.135 5.824 3 7.938l3-2.647z"></path>
+            </svg>
+            <span id="search-btn-text">Search</span>
+          </button>
         </div>
       </div>
 
@@ -114,10 +123,23 @@
                   <ul class="space-y-3">
                     <% results.each_with_index do |memory, i| %>
                       <li class="text-sm">
-                        <span class="text-gray-500 font-mono text-xs"><%= i + 1 %>.</span>
-                        <%= link_to memory_path(memory['id']), class: 'text-gray-300 hover:text-white line-clamp-2' do %>
-                          <%= truncate(memory['content'], length: 80) %>
-                        <% end %>
+                        <div class="flex items-start gap-2">
+                          <span class="text-gray-500 font-mono text-xs flex-shrink-0"><%= i + 1 %>.</span>
+                          <div class="min-w-0">
+                            <%= link_to memory_path(memory['id']), class: 'text-gray-300 hover:text-white line-clamp-2 block' do %>
+                              <%= truncate(memory['content'], length: 80) %>
+                            <% end %>
+                            <div class="mt-1 text-xs">
+                              <% if strategy == :hybrid && memory['rrf_score'] %>
+                                <span class="text-purple-400"><%= (memory['rrf_score'].to_f * 100).round(1) %>%</span>
+                              <% elsif strategy == :vector && memory['similarity'] %>
+                                <span class="text-blue-400"><%= (memory['similarity'].to_f * 100).round(1) %>%</span>
+                              <% elsif strategy == :fulltext && memory['rank'] %>
+                                <span class="text-green-400"><%= memory['rank'].to_f.round(2) %></span>
+                              <% end %>
+                            </div>
+                          </div>
+                        </div>
                       </li>
                     <% end %>
                   </ul>
@@ -160,8 +182,17 @@
                     <div class="mt-2 flex items-center gap-4 text-xs text-gray-500">
                       <span class="font-mono text-gray-600">#<%= memory['id'] %></span>
                       <span><%= time_ago_in_words(memory['created_at'].is_a?(Time) ? memory['created_at'] : Time.parse(memory['created_at'].to_s)) %> ago</span>
-                      <% if memory['rank'] %>
-                        <span>Rank: <%= memory['rank'].to_f.round(4) %></span>
+                      <%# Display score based on search strategy %>
+                      <% case @selected_strategy %>
+                      <% when :hybrid %>
+                        <span class="text-purple-400">RRF: <%= (memory['rrf_score'].to_f * 100).round(2) %>%</span>
+                        <% if memory['sources'].is_a?(Array) && memory['sources'].any? %>
+                          <span class="text-gray-600">via <%= memory['sources'].join(', ') %></span>
+                        <% end %>
+                      <% when :vector %>
+                        <span class="text-blue-400">Similarity: <%= (memory['similarity'].to_f * 100).round(2) %>%</span>
+                      <% when :fulltext %>
+                        <span class="text-green-400">Score: <%= memory['rank'].to_f.round(4) %></span>
                       <% end %>
                     </div>
                   </div>
@@ -182,3 +213,23 @@
     <% end %>
   <% end %>
 </div>
+
+<script>
+  document.addEventListener('DOMContentLoaded', () => {
+    const form = document.getElementById('search-form');
+    const btn = document.getElementById('search-btn');
+    const spinner = document.getElementById('search-spinner');
+    const btnText = document.getElementById('search-btn-text');
+
+    if (form && btn) {
+      form.addEventListener('submit', () => {
+        // Show spinner and disable button
+        spinner.classList.remove('hidden');
+        btnText.textContent = 'Searching...';
+        btn.disabled = true;
+        btn.classList.add('opacity-75', 'cursor-wait');
+        btn.classList.remove('hover:bg-indigo-500');
+      });
+    }
+  });
+</script>

data/examples/12_rails_app/app/views/shared/_navbar.html.erb

@@ -1,3 +1,9 @@
+<%
+  # Determine current section
+  in_chat_section = controller_name.in?(['chats', 'messages'])
+  in_htm_section = controller_name.in?(['dashboard', 'memories', 'tags', 'robots', 'search', 'files'])
+%>
+
 <nav class="bg-gray-800 border-b border-gray-700">
   <div class="mx-auto max-w-7xl px-4 sm:px-6 lg:px-8">
     <div class="flex h-16 items-center justify-between">
@@ -7,46 +13,86 @@
             <svg class="h-8 w-8 text-indigo-500" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
               <path d="M12 2L2 7l10 5 10-5-10-5zM2 17l10 5 10-5M2 12l10 5 10-5"/>
             </svg>
-            <span class="text-xl font-bold text-white">HTM Explorer</span>
+            <span class="text-xl font-bold text-white">HTM Demo</span>
           <% end %>
         </div>
-        <div class="hidden md:block">
-          <div class="ml-10 flex items-baseline space-x-4">
-            <%= link_to 'Dashboard', root_path,
-                class: "rounded-md px-3 py-2 text-sm font-medium #{current_page?(root_path) ? 'bg-gray-900 text-white' : 'text-gray-300 hover:bg-gray-700 hover:text-white'}" %>
-            <%= link_to 'Memories', memories_path,
-                class: "rounded-md px-3 py-2 text-sm font-medium #{controller_name == 'memories' ? 'bg-gray-900 text-white' : 'text-gray-300 hover:bg-gray-700 hover:text-white'}" %>
-            <%= link_to 'Tags', tags_path,
-                class: "rounded-md px-3 py-2 text-sm font-medium #{controller_name == 'tags' ? 'bg-gray-900 text-white' : 'text-gray-300 hover:bg-gray-700 hover:text-white'}" %>
-            <%= link_to 'Robots', robots_path,
-                class: "rounded-md px-3 py-2 text-sm font-medium #{controller_name == 'robots' ? 'bg-gray-900 text-white' : 'text-gray-300 hover:bg-gray-700 hover:text-white'}" %>
-            <%= link_to 'Search', search_path,
-                class: "rounded-md px-3 py-2 text-sm font-medium #{controller_name == 'search' ? 'bg-gray-900 text-white' : 'text-gray-300 hover:bg-gray-700 hover:text-white'}" %>
-            <%= link_to 'Files', files_path,
-                class: "rounded-md px-3 py-2 text-sm font-medium #{controller_name == 'files' ? 'bg-gray-900 text-white' : 'text-gray-300 hover:bg-gray-700 hover:text-white'}" %>
+
+        <% if in_chat_section %>
+          <!-- Chat section navigation -->
+          <div class="hidden md:block">
+            <div class="ml-10 flex items-baseline space-x-4">
+              <span class="rounded-full bg-indigo-900/50 border border-indigo-500/30 px-3 py-1 text-xs font-medium text-indigo-400">Chat</span>
+              <%= link_to 'All Chats', app_root_path,
+                  class: "rounded-md px-3 py-2 text-sm font-medium #{controller_name == 'chats' && action_name == 'index' ? 'bg-gray-900 text-white' : 'text-gray-300 hover:bg-gray-700 hover:text-white'}" %>
+              <%= link_to 'HTM Management', htm_root_path,
+                  class: "rounded-md px-3 py-2 text-sm font-medium text-gray-400 hover:bg-gray-700 hover:text-white" %>
+            </div>
           </div>
-        </div>
+        <% elsif in_htm_section %>
+          <!-- HTM section navigation -->
+          <div class="hidden md:block">
+            <div class="ml-10 flex items-baseline space-x-4">
+              <span class="rounded-full bg-purple-900/50 border border-purple-500/30 px-3 py-1 text-xs font-medium text-purple-400">HTM</span>
+              <%= link_to 'Dashboard', htm_root_path,
+                  class: "rounded-md px-3 py-2 text-sm font-medium #{controller_name == 'dashboard' ? 'bg-gray-900 text-white' : 'text-gray-300 hover:bg-gray-700 hover:text-white'}" %>
+              <%= link_to 'Memories', memories_path,
+                  class: "rounded-md px-3 py-2 text-sm font-medium #{controller_name == 'memories' ? 'bg-gray-900 text-white' : 'text-gray-300 hover:bg-gray-700 hover:text-white'}" %>
+              <%= link_to 'Tags', tags_path,
+                  class: "rounded-md px-3 py-2 text-sm font-medium #{controller_name == 'tags' ? 'bg-gray-900 text-white' : 'text-gray-300 hover:bg-gray-700 hover:text-white'}" %>
+              <%= link_to 'Robots', robots_path,
+                  class: "rounded-md px-3 py-2 text-sm font-medium #{controller_name == 'robots' ? 'bg-gray-900 text-white' : 'text-gray-300 hover:bg-gray-700 hover:text-white'}" %>
+              <%= link_to 'Search', search_path,
+                  class: "rounded-md px-3 py-2 text-sm font-medium #{controller_name == 'search' ? 'bg-gray-900 text-white' : 'text-gray-300 hover:bg-gray-700 hover:text-white'}" %>
+              <%= link_to 'Files', files_path,
+                  class: "rounded-md px-3 py-2 text-sm font-medium #{controller_name == 'files' ? 'bg-gray-900 text-white' : 'text-gray-300 hover:bg-gray-700 hover:text-white'}" %>
+              <%= link_to 'Chat', app_root_path,
+                  class: "rounded-md px-3 py-2 text-sm font-medium text-gray-400 hover:bg-gray-700 hover:text-white" %>
+            </div>
+          </div>
+        <% else %>
+          <!-- Home page - show both section links -->
+          <div class="hidden md:block">
+            <div class="ml-10 flex items-baseline space-x-4">
+              <%= link_to 'Chat', app_root_path,
+                  class: "rounded-md px-3 py-2 text-sm font-medium text-gray-300 hover:bg-gray-700 hover:text-white" %>
+              <%= link_to 'HTM Management', htm_root_path,
+                  class: "rounded-md px-3 py-2 text-sm font-medium text-gray-300 hover:bg-gray-700 hover:text-white" %>
+            </div>
+          </div>
+        <% end %>
       </div>
-      <div class="flex items-center gap-4">
-        <div class="flex items-center gap-2 text-sm text-gray-400">
-          <svg class="h-4 w-4" fill="none" viewBox="0 0 24 24" stroke="currentColor">
-            <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9 3v2m6-2v2M9 19v2m6-2v2M5 9H3m2 6H3m18-6h-2m2 6h-2M7 19h10a2 2 0 002-2V7a2 2 0 00-2-2H7a2 2 0 00-2 2v10a2 2 0 002 2zM9 9h6v6H9V9z" />
-          </svg>
-          <span>Robot: <strong class="text-indigo-400"><%= current_robot_name %></strong></span>
+
+      <% if in_htm_section %>
+        <div class="flex items-center gap-4">
+          <div class="flex items-center gap-2 text-sm text-gray-400">
+            <svg class="h-4 w-4" fill="none" viewBox="0 0 24 24" stroke="currentColor">
+              <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9 3v2m6-2v2M9 19v2m6-2v2M5 9H3m2 6H3m18-6h-2m2 6h-2M7 19h10a2 2 0 002-2V7a2 2 0 00-2-2H7a2 2 0 00-2 2v10a2 2 0 002 2zM9 9h6v6H9V9z" />
+            </svg>
+            <span>Robot: <strong class="text-indigo-400"><%= current_robot_name %></strong></span>
+          </div>
         </div>
-      </div>
+      <% end %>
     </div>
   </div>
 
   <!-- Mobile menu -->
   <div class="md:hidden" data-controller="mobile-menu">
     <div class="space-y-1 px-2 pb-3 pt-2 sm:px-3">
-      <%= link_to 'Dashboard', root_path, class: "block rounded-md px-3 py-2 text-base font-medium text-gray-300 hover:bg-gray-700 hover:text-white" %>
-      <%= link_to 'Memories', memories_path, class: "block rounded-md px-3 py-2 text-base font-medium text-gray-300 hover:bg-gray-700 hover:text-white" %>
-      <%= link_to 'Tags', tags_path, class: "block rounded-md px-3 py-2 text-base font-medium text-gray-300 hover:bg-gray-700 hover:text-white" %>
-      <%= link_to 'Robots', robots_path, class: "block rounded-md px-3 py-2 text-base font-medium text-gray-300 hover:bg-gray-700 hover:text-white" %>
-      <%= link_to 'Search', search_path, class: "block rounded-md px-3 py-2 text-base font-medium text-gray-300 hover:bg-gray-700 hover:text-white" %>
-      <%= link_to 'Files', files_path, class: "block rounded-md px-3 py-2 text-base font-medium text-gray-300 hover:bg-gray-700 hover:text-white" %>
+      <% if in_chat_section %>
+        <%= link_to 'All Chats', app_root_path, class: "block rounded-md px-3 py-2 text-base font-medium text-gray-300 hover:bg-gray-700 hover:text-white" %>
+        <%= link_to 'HTM Management', htm_root_path, class: "block rounded-md px-3 py-2 text-base font-medium text-gray-400 hover:bg-gray-700 hover:text-white" %>
+      <% elsif in_htm_section %>
+        <%= link_to 'Dashboard', htm_root_path, class: "block rounded-md px-3 py-2 text-base font-medium text-gray-300 hover:bg-gray-700 hover:text-white" %>
+        <%= link_to 'Memories', memories_path, class: "block rounded-md px-3 py-2 text-base font-medium text-gray-300 hover:bg-gray-700 hover:text-white" %>
+        <%= link_to 'Tags', tags_path, class: "block rounded-md px-3 py-2 text-base font-medium text-gray-300 hover:bg-gray-700 hover:text-white" %>
+        <%= link_to 'Robots', robots_path, class: "block rounded-md px-3 py-2 text-base font-medium text-gray-300 hover:bg-gray-700 hover:text-white" %>
+        <%= link_to 'Search', search_path, class: "block rounded-md px-3 py-2 text-base font-medium text-gray-300 hover:bg-gray-700 hover:text-white" %>
+        <%= link_to 'Files', files_path, class: "block rounded-md px-3 py-2 text-base font-medium text-gray-300 hover:bg-gray-700 hover:text-white" %>
+        <%= link_to 'Chat', app_root_path, class: "block rounded-md px-3 py-2 text-base font-medium text-gray-400 hover:bg-gray-700 hover:text-white" %>
+      <% else %>
+        <%= link_to 'Chat', app_root_path, class: "block rounded-md px-3 py-2 text-base font-medium text-gray-300 hover:bg-gray-700 hover:text-white" %>
+        <%= link_to 'HTM Management', htm_root_path, class: "block rounded-md px-3 py-2 text-base font-medium text-gray-300 hover:bg-gray-700 hover:text-white" %>
+      <% end %>
     </div>
   </div>
 </nav>

data/examples/12_rails_app/app/views/tags/index.html.erb

@@ -1,3 +1,5 @@
+<% content_for :body_attributes do %>data-no-auto-refresh<% end %>
+
 <div class="space-y-6">
   <!-- Header -->
   <div class="flex items-center justify-between">

data/examples/12_rails_app/app/views/tags/show.html.erb

@@ -1,3 +1,5 @@
+<% content_for :body_attributes do %>data-no-auto-refresh<% end %>
+
 <div class="space-y-6">
   <!-- Back link -->
   <div>
@@ -34,7 +36,7 @@
             <% prefix = parts[0..i].join(':') %>
             <% matching_tag = HTM::Models::Tag.first(name: prefix) %>
             <% if matching_tag %>
-              <%= link_to part, tag_path(matching_tag), class: "#{i == parts.length - 1 ? 'text-indigo-400' : 'text-gray-400 hover:text-white'}" %>
+              <%= link_to part, tag_path(matching_tag.id), class: "#{i == parts.length - 1 ? 'text-indigo-400' : 'text-gray-400 hover:text-white'}" %>
             <% else %>
               <span class="text-gray-500"><%= part %></span>
             <% end %>

data/examples/12_rails_app/config/application.rb

@@ -14,7 +14,7 @@ require 'htm'
 
 module HtmRailsExample
   class Application < Rails::Application
-    config.load_defaults 7.1
+    config.load_defaults 8.0
 
     # Full-stack Rails app (not API-only)
     config.api_only = false

data/examples/12_rails_app/config/database.yml

@@ -1,15 +1,19 @@
-# Rails app database (not used - HTM uses its own database)
-# This is required for Rails to boot but can be sqlite/memory
+# Rails app database for RubyLLM chat persistence
+# HTM uses its own database (htm_examples)
 
 default: &default
   adapter: postgresql
   encoding: unicode
-  pool: 5
+  pool: <%= ENV.fetch("RAILS_MAX_THREADS") { 5 } %>
 
 development:
   <<: *default
-  database: htm_rails_example_dev
+  database: chatbot_development
 
 test:
   <<: *default
-  database: htm_rails_example_test
+  database: chatbot_test
+
+examples:
+  <<: *default
+  database: chatbot_examples

data/examples/12_rails_app/config/importmap.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 pin "application"
-pin "@hotwired/turbo-rails", to: "turbo.min.js"
+# Turbo removed - causes issues with CDN-based setup, using vanilla JS instead
 pin "@hotwired/stimulus", to: "stimulus.min.js"
 pin "@hotwired/stimulus-loading", to: "stimulus-loading.js"
 pin_all_from "app/javascript/controllers", under: "controllers"

data/examples/12_rails_app/config/initializers/htm.rb

@@ -1,7 +1,14 @@
 # frozen_string_literal: true
 
-# Override the examples_helper.rb :inline setting for the Rails app
-# Use fiber-based async jobs for better responsiveness
+# Configure HTM for the Rails chatbot app
 HTM.configure do |config|
+  # Use the examples database which contains the knowledge base
+  # This overrides HTM_ENV=development to use the populated database
+  config.database.url = ENV.fetch('HTM_CHATBOT_DATABASE_URL', 'postgresql://localhost:5432/htm_examples')
+
+  # Use fiber-based async jobs for better responsiveness
   config.job.backend = :fiber
 end
+
+Rails.logger.info "HTM initialized for Rails application"
+Rails.logger.info "HTM database: #{HTM.configuration.database_url}"

data/examples/12_rails_app/config/initializers/ruby_llm.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+require 'ruby_llm'
+
+RubyLLM.configure do |config|
+  # Logging - use INFO level in production, DEBUG for troubleshooting
+  config.logger = Rails.logger
+  config.log_level = Rails.env.development? ? Logger::INFO : Logger::WARN
+
+  # Enable new acts_as API (required for acts_as_chat)
+  config.use_new_acts_as = true
+
+  # Model registry class for database storage
+  config.model_registry_class = 'Model'
+
+  # Default chat model
+  config.default_model = ENV.fetch('CHAT_MODEL', 'gemma3:latest')
+
+  # Cloud provider API keys
+  config.openai_api_key = ENV['OPENAI_API_KEY']
+  config.anthropic_api_key = ENV['ANTHROPIC_API_KEY']
+  config.xai_api_key = ENV['XAI_API_KEY']
+
+  # Ollama (local provider) - requires /v1 suffix for OpenAI-compatible API
+  ollama_base = ENV.fetch('OLLAMA_URL', 'http://localhost:11434')
+  config.ollama_api_base = ollama_base.end_with?('/v1') ? ollama_base : "#{ollama_base}/v1"
+end
+
+# Include ActiveRecord support directly since railtie hook doesn't always fire correctly
+Rails.application.config.to_prepare do
+  require 'ruby_llm/active_record/acts_as'
+  ActiveRecord::Base.include RubyLLM::ActiveRecord::ActsAs unless ActiveRecord::Base.respond_to?(:acts_as_chat)
+end

data/examples/12_rails_app/config/routes.rb

@@ -1,38 +1,54 @@
 # frozen_string_literal: true
 
 Rails.application.routes.draw do
-  root 'dashboard#index'
+  # Landing page
+  root 'home#index'
 
-  resources :memories do
-    collection do
-      get :deleted
-    end
-    member do
-      post :restore
+  # Chatbot section
+  scope '/app' do
+    get '/', to: 'chats#index', as: :app_root
+    resources :chats, only: [:index, :show, :create, :update, :destroy] do
+      member do
+        patch :update_htm_settings
+      end
+      resources :messages, only: [:create]
     end
+    get '/models', to: 'chats#models', as: :provider_models
   end
 
-  resources :tags, only: [:index, :show]
+  # HTM Management section (existing functionality)
+  scope '/htm' do
+    get '/', to: 'dashboard#index', as: :htm_root
 
-  resources :robots, only: [:index, :show, :new, :create] do
-    member do
-      post :switch
+    resources :memories do
+      collection do
+        get :deleted
+      end
+      member do
+        post :restore
+      end
     end
-  end
 
-  resource :search, only: [:index], controller: 'search' do
-    get '/', action: :index
-  end
+    resources :tags, only: [:index, :show]
 
-  resources :files, only: [:index, :show, :new, :create, :destroy] do
-    collection do
-      post :load_directory
-      post :upload
-      post :upload_directory
-      post :sync_all
+    resources :robots, only: [:index, :show, :new, :create] do
+      member do
+        post :switch
+      end
     end
-    member do
-      post :sync
+
+    get '/search', to: 'search#index', as: :search
+
+    resources :files, only: [:index, :show, :new, :create, :destroy] do
+      collection do
+        post :load_directory
+        post :upload
+        post :upload_directory
+        post :sync_all
+      end
+      member do
+        post :sync
+      end
     end
   end
 end

data/examples/12_rails_app/db/migrate/20250124000001_create_ruby_llm_tables.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+class CreateRubyLlmTables < ActiveRecord::Migration[8.0]
+  def change
+    create_table :chats do |t|
+      t.string :model_id
+      t.text :instructions
+
+      t.timestamps
+    end
+
+    create_table :messages do |t|
+      t.references :chat, null: false, foreign_key: true
+      t.string :role, null: false
+      t.text :content
+      t.string :model_id
+      t.integer :input_tokens
+      t.integer :output_tokens
+
+      t.timestamps
+    end
+
+    create_table :tool_calls do |t|
+      t.references :message, null: false, foreign_key: true
+      t.string :tool_call_id, null: false
+      t.string :name, null: false
+      t.jsonb :arguments, default: {}
+
+      t.timestamps
+    end
+
+    add_index :tool_calls, :tool_call_id
+  end
+end

data/examples/12_rails_app/db/migrate/20250124000002_create_models_table.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+class CreateModelsTable < ActiveRecord::Migration[8.0]
+  def change
+    create_table :models do |t|
+      t.string :model_id, null: false
+      t.string :name, null: false
+      t.string :provider, null: false
+      t.string :family
+      t.datetime :model_created_at
+      t.integer :context_window
+      t.integer :max_output_tokens
+      t.date :knowledge_cutoff
+      t.jsonb :modalities, default: {}
+      t.jsonb :capabilities, default: []
+      t.jsonb :pricing, default: {}
+      t.jsonb :metadata, default: {}
+
+      t.timestamps
+    end
+
+    add_index :models, [:provider, :model_id], unique: true
+    add_index :models, :provider
+    add_index :models, :family
+    add_index :models, :capabilities, using: :gin
+    add_index :models, :modalities, using: :gin
+  end
+end

data/examples/12_rails_app/db/schema.rb

@@ -0,0 +1,67 @@
+# This file is auto-generated from the current state of the database. Instead
+# of editing this file, please use the migrations feature of Active Record to
+# incrementally modify your database, and then regenerate this schema definition.
+#
+# This file is the source Rails uses to define your schema when running `bin/rails
+# db:schema:load`. When creating a new database, `bin/rails db:schema:load` tends to
+# be faster and is potentially less error prone than running all of your
+# migrations from scratch. Old migrations may fail to apply correctly if those
+# migrations use external dependencies or application code.
+#
+# It's strongly recommended that you check this file into your version control system.
+
+ActiveRecord::Schema[8.1].define(version: 2025_01_24_000002) do
+  # These are extensions that must be enabled in order to support this database
+  enable_extension "pg_catalog.plpgsql"
+
+  create_table "chats", force: :cascade do |t|
+    t.datetime "created_at", null: false
+    t.text "instructions"
+    t.string "model_id"
+    t.datetime "updated_at", null: false
+  end
+
+  create_table "messages", force: :cascade do |t|
+    t.bigint "chat_id", null: false
+    t.text "content"
+    t.datetime "created_at", null: false
+    t.integer "input_tokens"
+    t.string "model_id"
+    t.integer "output_tokens"
+    t.string "role", null: false
+    t.datetime "updated_at", null: false
+    t.index ["chat_id"], name: "index_messages_on_chat_id"
+  end
+
+  create_table "models", force: :cascade do |t|
+    t.integer "context_window"
+    t.datetime "created_at", null: false
+    t.string "family"
+    t.decimal "input_price_per_million", precision: 10, scale: 4
+    t.integer "max_tokens"
+    t.jsonb "metadata", default: {}
+    t.string "model_id", null: false
+    t.string "name"
+    t.decimal "output_price_per_million", precision: 10, scale: 4
+    t.string "provider"
+    t.boolean "supports_functions", default: false
+    t.boolean "supports_vision", default: false
+    t.datetime "updated_at", null: false
+    t.index ["model_id"], name: "index_models_on_model_id", unique: true
+    t.index ["provider"], name: "index_models_on_provider"
+  end
+
+  create_table "tool_calls", force: :cascade do |t|
+    t.jsonb "arguments", default: {}
+    t.datetime "created_at", null: false
+    t.bigint "message_id", null: false
+    t.string "name", null: false
+    t.string "tool_call_id", null: false
+    t.datetime "updated_at", null: false
+    t.index ["message_id"], name: "index_tool_calls_on_message_id"
+    t.index ["tool_call_id"], name: "index_tool_calls_on_tool_call_id"
+  end
+
+  add_foreign_key "messages", "chats"
+  add_foreign_key "tool_calls", "messages"
+end