chat_manager 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 657c0a813d68c57d94d7a4583a690bca52696bb46057504e63516b1b84e7c05d
+  data.tar.gz: 1a1b07a2d9e997c0fa4b8e6748639bb2325d35bbcf6d74691f29758e5306cc09
+SHA512:
+  metadata.gz: e3b1677ea4441b6c23edac0730dd9fc31dbdd91e46fd0d293704d1f7210aabb086bdd190ce8376b1cc1ca4f7296ba6511286198fa9c120aaa18ee40b14d52023
+  data.tar.gz: b7cb2b4b5c9dda1c5dce2e9479dca145adedfc6c0b202a730b1ffeb58433d6f7f4764d027e424a553e8e03f6da466b4f05078d37da4a40edfdfc6f1540bbeaf3

data/CHANGELOG.md

@@ -0,0 +1,20 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/),
+and this project adheres to [Semantic Versioning](https://semver.org/).
+
+## [0.1.0] - 2026-02-26
+
+### Added
+
+- Chat management module (`ChatManageable`) for controller integration with duplicate and nil prevention
+- Automatic chat title generation from initial prompts (`TitleGeneratable`)
+- CSV export for individual and bulk chat downloads (`CsvDownloadable`)
+- Chat list and chat card UI components with Stimulus-powered inline title editing
+- View helper (`chat_list`) for rendering chat lists with customizable paths
+- Database migration generator (`chat_manager:modeling`)
+- CSS styling for chat interface with active state highlighting and hover effects
+- Turbolinks/Turbo safety on CSV download links
+- Rails 8.1+ support with `csv` gem dependency for Ruby 3.4+ compatibility

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright dhq_boiler
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,28 @@
+# ChatManager
+Short description and motivation.
+
+## Usage
+How to use my plugin.
+
+## Installation
+Add this line to your application's Gemfile:
+
+```ruby
+gem "chat_manager"
+```
+
+And then execute:
+```bash
+$ bundle
+```
+
+Or install it yourself as:
+```bash
+$ gem install chat_manager
+```
+
+## Contributing
+Contribution directions go here.
+
+## License
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/setup"
+
+APP_RAKEFILE = File.expand_path("test/dummy/Rakefile", __dir__)
+load "rails/tasks/engine.rake"
+
+require "bundler/gem_tasks"

data/app/assets/stylesheets/chat_manager/application.css

@@ -0,0 +1,15 @@
+/*
+ * This is a manifest file that'll be compiled into application.css, which will include all the files
+ * listed below.
+ *
+ * Any CSS and SCSS file within this directory, lib/assets/stylesheets, vendor/assets/stylesheets,
+ * or any plugin's vendor/assets/stylesheets directory can be referenced here using a relative path.
+ *
+ * You're free to add application-wide styles to this file and they'll appear at the bottom of the
+ * compiled file so the styles you add here take precedence over styles defined in any other CSS/SCSS
+ * files in this directory. Styles in this file should be added after the last require_* statement.
+ * It is generally better to create a new file per style scope.
+ *
+ *= require_tree .
+ *= require_self
+ */

data/app/assets/stylesheets/chat_manager/chat.css

@@ -0,0 +1,131 @@
+.chat-stack {
+    position: relative;
+    display: flex;
+    flex-direction: column;
+    gap: 8px;
+    padding-left: 32px; /* space for arrows */
+}
+
+.chat-card {
+    background: #fff;
+    border: 1px solid #ddd;
+    border-radius: 8px;
+    padding: 8px 10px;
+    box-shadow: 0 1px 2px rgba(0, 0, 0, 0.06);
+    position: relative;
+    z-index: 1;
+    transition:
+            box-shadow 0.15s ease,
+            transform 0.15s ease;
+
+    &.is-active {
+        border-color: #007bff;
+        box-shadow: 0 0 0 2px rgba(0, 123, 255, 0.25);
+    }
+
+    &:hover {
+        box-shadow: 0 4px 12px rgba(0, 0, 0, 0.12);
+        transform: translateY(-2px);
+    }
+}
+
+.chat-card-link {
+    display: grid;
+    grid-template-columns: auto 1fr auto;
+    grid-gap: 8px;
+    text-decoration: none;
+    color: #333;
+    align-items: center;
+}
+
+.chat-card-number {
+    font-size: 12px;
+    font-weight: 600;
+    color: #555;
+}
+
+.chat-card-prompt {
+    font-size: 12px;
+    line-height: 1.3;
+    overflow: hidden;
+    display: -webkit-box;
+    -webkit-line-clamp: 2;
+    -webkit-box-orient: vertical;
+}
+
+.chat-card-row {
+    display: flex;
+    align-items: center;
+    gap: 4px;
+}
+
+.chat-card-row .chat-card-link {
+    flex: 1;
+    min-width: 0;
+}
+
+.chat-card-download {
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    width: 24px;
+    height: 24px;
+    border-radius: 4px;
+    color: #888;
+    text-decoration: none;
+    flex-shrink: 0;
+    transition: color 0.15s ease, background-color 0.15s ease;
+
+    &:hover {
+        color: #007bff;
+        background-color: rgba(0, 123, 255, 0.1);
+    }
+
+    i {
+        font-size: 12px;
+    }
+}
+
+.chat-download-all {
+    margin-top: 12px;
+    padding-left: 32px;
+}
+
+.chat-download-all-link {
+    display: inline-flex;
+    align-items: center;
+    gap: 6px;
+    font-size: 12px;
+    color: #555;
+    text-decoration: none;
+    padding: 6px 10px;
+    border: 1px solid #ddd;
+    border-radius: 6px;
+    transition: color 0.15s ease, border-color 0.15s ease, background-color 0.15s ease;
+
+    &:hover {
+        color: #007bff;
+        border-color: #007bff;
+        background-color: rgba(0, 123, 255, 0.05);
+    }
+
+    i {
+        font-size: 12px;
+    }
+}
+
+.chat-card-title-input {
+    font-size: 12px;
+    line-height: 1.3;
+    width: 100%;
+    padding: 2px 4px;
+    border: 1px solid #ccc;
+    border-radius: 4px;
+    box-sizing: border-box;
+    outline: none;
+
+    &:focus {
+        border-color: #007bff;
+        box-shadow: 0 0 0 2px rgba(0, 123, 255, 0.25);
+    }
+}

data/app/controllers/chat_manager/application_controller.rb

@@ -0,0 +1,4 @@
+module ChatManager
+  class ApplicationController < ActionController::Base
+  end
+end

data/app/helpers/chat_manager/application_helper.rb

@@ -0,0 +1,4 @@
+module ChatManager
+  module ApplicationHelper
+  end
+end

data/app/jobs/chat_manager/application_job.rb

@@ -0,0 +1,4 @@
+module ChatManager
+  class ApplicationJob < ActiveJob::Base
+  end
+end

data/app/mailers/chat_manager/application_mailer.rb

@@ -0,0 +1,6 @@
+module ChatManager
+  class ApplicationMailer < ActionMailer::Base
+    default from: "from@example.com"
+    layout "mailer"
+  end
+end

data/app/models/chat_manager/application_record.rb

@@ -0,0 +1,5 @@
+module ChatManager
+  class ApplicationRecord < ActiveRecord::Base
+    self.abstract_class = true
+  end
+end

data/app/views/chat_manager/_chat_card.html.erb

@@ -0,0 +1,29 @@
+<%
+  ann = locals[:ann]
+  is_active = locals[:is_active]
+  card_path = locals[:card_path]
+  download_csv_path = locals[:download_csv_path]
+%>
+
+<div class="chat-card<%= ' is-active' if is_active %>"
+     data-chat-target="cards"
+     data-uuid="<%= ann.uuid %>"
+     data-controller="chat-title-edit"
+     data-chat-title-edit-uuid-value="<%= ann.uuid %>"
+     data-chat-title-edit-full-title-value="<%= ann.title.to_s %>"
+     data-chat-title-edit-update-url-value="<%= main_app.update_title_chat_path(ann.uuid) %>">
+  <div class="chat-card-row">
+    <%= link_to card_path.call(ann.uuid), class: "chat-card-link", data: { "chat-title-edit-target": "link" } do %>
+      <div class="chat-card-prompt" data-chat-title-edit-target="display"><%= truncate(ann.title.to_s, length: 30) %></div>
+    <% end %>
+    <% if download_csv_path %>
+      <%= link_to download_csv_path.call(ann.uuid), class: "chat-card-download", title: "Download CSV", data: { turbo: false } do %>
+        <i class="bi bi-download"></i>
+      <% end %>
+    <% end %>
+  </div>
+  <input type="text" class="chat-card-title-input"
+         data-chat-title-edit-target="input"
+         data-action="keydown->chat-title-edit#handleKeydown blur->chat-title-edit#save"
+         style="display: none;" />
+</div>

data/app/views/chat_manager/_chat_list.html.erb

@@ -0,0 +1,25 @@
+<%
+  active_uuid = locals[:active_uuid]
+  card_path = locals[:card_path]
+  download_csv_path = locals[:download_csv_path]
+  download_all_csv_path = locals[:download_all_csv_path]
+  titled_chats = @chats.select { |c| c.title.present? }
+%>
+
+<h2>chat</h2>
+<% if titled_chats.present? %>
+  <div class="chat-stack" data-controller="chat">
+    <% titled_chats.each_with_index do |ann, idx| %>
+      <%= render 'chat_manager/chat_card', locals: { ann: ann, next_ann: titled_chats[idx + 1], is_active: ann.id == active_uuid, card_path: card_path, download_csv_path: download_csv_path } %>
+    <% end %>
+  </div>
+  <% if download_all_csv_path %>
+    <div class="chat-download-all">
+      <%= link_to download_all_csv_path, class: "chat-download-all-link", data: { turbo: false } do %>
+        <i class="bi bi-download"></i> Download All Chats CSV
+      <% end %>
+    </div>
+  <% end %>
+<% else %>
+  <p class="chat-empty">No chat yet</p>
+<% end %>

data/app/views/layouts/chat_manager/application.html.erb

@@ -0,0 +1,17 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <title>Chat manager</title>
+  <%= csrf_meta_tags %>
+  <%= csp_meta_tag %>
+
+  <%= yield :head %>
+
+  <%= stylesheet_link_tag    "chat_manager/application", media: "all" %>
+</head>
+<body>
+
+<%= yield %>
+
+</body>
+</html>

data/config/routes.rb

@@ -0,0 +1,2 @@
+ChatManager::Engine.routes.draw do
+end

data/lib/chat_manager/chat_manageable.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module ChatManager
+  module ChatManageable
+    extend ActiveSupport::Concern
+
+    def initialize_chat(chats)
+      @chats = chats.to_a
+    end
+
+    def set_active_chat_uuid(uuid)
+      @active_chat_uuid = uuid
+    end
+
+    def add_chat(chat)
+      return if chat.nil? || @chats.include?(chat)
+      @chats << chat
+    end
+  end
+end

data/lib/chat_manager/csv_downloadable.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+require "csv"
+
+module ChatManager
+  module CsvDownloadable
+    extend ActiveSupport::Concern
+
+    CSV_HEADERS = [ "Chat Title", "Role", "Message Content", "Sent At", "Model" ].freeze
+
+    def download_csv
+      chat = current_user.chats.includes(messages: :prompt_manager_prompt_execution).find_by!(uuid: params[:id])
+
+      csv_data = generate_csv_for_chats([ chat ])
+
+      filename = "chat_#{chat.title.to_s.parameterize.presence || chat.uuid}_#{Date.today}.csv"
+      send_data csv_data, filename: filename, type: "text/csv"
+    end
+
+    def download_all_csv
+      chats = current_user.chats.includes(messages: :prompt_manager_prompt_execution)
+
+      csv_data = generate_csv_for_chats(chats)
+
+      send_data csv_data, filename: "all_chats_#{Date.today}.csv", type: "text/csv"
+    end
+
+    private
+
+    def generate_csv_for_chats(chats)
+      CSV.generate do |csv|
+        csv << CSV_HEADERS
+        chats.each do |chat|
+          chat.ordered_messages.each do |msg|
+            pe = msg.prompt_manager_prompt_execution
+            content = msg.role == "user" ? pe&.prompt : pe&.response
+            csv << [ chat.title, msg.role, content, msg.created_at, chat.model ]
+          end
+        end
+      end
+    end
+  end
+end

data/lib/chat_manager/engine.rb

@@ -0,0 +1,33 @@
+module ChatManager
+  class Engine < ::Rails::Engine
+    isolate_namespace ChatManager
+
+    initializer "chat_manager.helpers" do
+      ActiveSupport.on_load(:action_view) do
+        include ChatManager::Helpers
+      end
+    end
+
+    initializer "chat_manager.controllers" do
+      ActiveSupport.on_load(:action_controller) do
+        include ChatManager::ChatManageable
+      end
+    end
+
+    # Configure asset paths for the engine
+    # This ensures that JavaScript and CSS files are properly loaded
+    initializer "chat_manager.assets", before: "sprockets.environment" do |app|
+      # Add asset paths
+      app.config.assets.paths << root.join("app/assets/stylesheets").to_s
+      app.config.assets.paths << root.join("app/javascript").to_s
+
+      # Precompile assets
+      if app.config.respond_to?(:assets)
+        app.config.assets.precompile += %w[
+          chat_manager/chat.css
+          chat_manager/application.css
+        ]
+      end
+    end
+  end
+end

data/lib/chat_manager/helpers.rb

@@ -0,0 +1,7 @@
+module ChatManager
+  module Helpers
+    def chat_list(card_path, active_uuid: nil, download_csv_path: nil, download_all_csv_path: nil)
+      render "chat_manager/chat_list", locals: { card_path: card_path, active_uuid: active_uuid, download_csv_path: download_csv_path, download_all_csv_path: download_all_csv_path }
+    end
+  end
+end

data/lib/chat_manager/title_generatable.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module ChatManager
+  module TitleGeneratable
+    extend ActiveSupport::Concern
+
+    # Generate a title for the chat by summarizing the user's prompt.
+    # Delegates the actual summarization to `summarize_for_title`,
+    # which must be implemented by the including model.
+    def generate_title(prompt_text, jwt_token)
+      return if title.present?
+
+      summary = summarize_for_title(prompt_text, jwt_token)
+      update!(title: summary.truncate(255)) if summary.present?
+    rescue StandardError => e
+      Rails.logger.error "Failed to generate chat title: #{e.class} - #{e.message}"
+    end
+
+    private
+
+    # Override this method in your model to provide the actual summarization logic.
+    # Should return a short title string.
+    def summarize_for_title(_prompt_text, _jwt_token)
+      raise NotImplementedError, "#{self.class} must implement #summarize_for_title"
+    end
+  end
+end

data/lib/chat_manager/version.rb

@@ -0,0 +1,3 @@
+module ChatManager
+  VERSION = "0.1.0"
+end

data/lib/chat_manager.rb

@@ -0,0 +1,10 @@
+require "chat_manager/version"
+require "chat_manager/engine"
+require "chat_manager/helpers"
+require "chat_manager/chat_manageable"
+require "chat_manager/csv_downloadable"
+require "chat_manager/title_generatable"
+
+module ChatManager
+  # Your code goes here...
+end

data/lib/generators/chat_manager/modeling/modeling_generator.rb

@@ -0,0 +1,19 @@
+
+module ChatManager
+  module Generators
+    class ModelingGenerator < Rails::Generators::Base
+      include Rails::Generators::Migration
+
+      source_root File.expand_path("templates", __dir__)
+
+      def self.next_migration_number(dirname)
+        next_migration_number = current_migration_number(dirname) + 1
+        ActiveRecord::Migration.next_migration_number(next_migration_number)
+      end
+
+      def add_migrations
+        migration_template "db/migrate/create_chat_manager_chat.rb", "db/migrate/create_chat_manager_chat.rb"
+      end
+    end
+  end
+end

data/lib/generators/chat_manager/modeling/templates/db/migrate/create_chat_manager_chat.rb

@@ -0,0 +1,12 @@
+class CreateChatManagerChat < ActiveRecord::Migration[8.1]
+  def change
+    create_table :chat_manager_chats do |t|
+      t.string :uuid, null: false
+      t.string :title
+      t.string :llm_uuid
+      t.string :model
+
+      t.timestamps
+    end
+  end
+end

data/lib/tasks/chat_manager_tasks.rake

@@ -0,0 +1,4 @@
+# desc "Explaining what the task does"
+# task :chat_manager do
+#   # Task goes here
+# end

metadata

@@ -0,0 +1,100 @@
+--- !ruby/object:Gem::Specification
+name: chat_manager
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- dhq_boiler
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 8.1.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 8.1.2
+- !ruby/object:Gem::Dependency
+  name: csv
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: ChatManager is a Rails engine that provides chat management, automatic
+  title generation from initial prompts, and CSV export for individual or bulk chat
+  downloads. It includes UI components with Stimulus-powered inline title editing
+  and a database migration generator.
+email:
+- dhq_boiler@live.jp
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- MIT-LICENSE
+- README.md
+- Rakefile
+- app/assets/stylesheets/chat_manager/application.css
+- app/assets/stylesheets/chat_manager/chat.css
+- app/controllers/chat_manager/application_controller.rb
+- app/helpers/chat_manager/application_helper.rb
+- app/jobs/chat_manager/application_job.rb
+- app/mailers/chat_manager/application_mailer.rb
+- app/models/chat_manager/application_record.rb
+- app/views/chat_manager/_chat_card.html.erb
+- app/views/chat_manager/_chat_list.html.erb
+- app/views/layouts/chat_manager/application.html.erb
+- config/routes.rb
+- lib/chat_manager.rb
+- lib/chat_manager/chat_manageable.rb
+- lib/chat_manager/csv_downloadable.rb
+- lib/chat_manager/engine.rb
+- lib/chat_manager/helpers.rb
+- lib/chat_manager/title_generatable.rb
+- lib/chat_manager/version.rb
+- lib/generators/chat_manager/modeling/modeling_generator.rb
+- lib/generators/chat_manager/modeling/templates/db/migrate/create_chat_manager_chat.rb
+- lib/tasks/chat_manager_tasks.rake
+homepage: https://github.com/jdkim/chat_manager
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+  homepage_uri: https://github.com/jdkim/chat_manager
+  source_code_uri: https://github.com/jdkim/chat_manager
+  changelog_uri: https://github.com/jdkim/chat_manager/blob/main/CHANGELOG.md
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.9
+specification_version: 4
+summary: A Rails engine for managing LLM chat conversations with CSV export and auto-titling.
+test_files: []