llm_meta_client 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: c97f3a183b70b928d55677581100d6774fbf6400140ff9604f883136f4c92c7e
+  data.tar.gz: 5d6078eabeb97d52b07980cb452cdbbf64ce65599d494c662e875249cd6e6f39
+SHA512:
+  metadata.gz: 268562c7e43e59fd50e3cf38dc06d0164e461f98b3e650df580443de556681573dccdb5db5d82963237d230e150bd238ad20a3d03d21d58337f95c2a00247cd1
+  data.tar.gz: 6c7baa9d2c77789861727acbd5f1d40ea391a3045df9b3422a780fbe7978d60473db22d6a2d69bc81b7cb48b207e2a664ba2d31f05b6d4372d802c985860e879

data/CHANGELOG.md

@@ -0,0 +1,29 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.1.0] - 2026-02-27
+
+### Added
+
+- Rails Engine with core modules:
+  - `ServerQuery` for making HTTP requests to LLM services
+  - `ServerResource` for fetching available LLM options (OpenAI, Anthropic, Google, Ollama)
+  - `Helpers` module integrating PromptNavigator and ChatManager helpers
+  - `ChatManageable` and `HistoryManageable` concerns
+  - Custom exceptions (`OllamaUnavailableError`, `ServerError`, `InvalidResponseError`, `EmptyResponseError`)
+- Scaffold generator (`rails generate llm_meta_client:scaffold`):
+  - Chat and Message models with migrations
+  - ChatsController and PromptsController
+  - Chat views with Turbo Stream support
+  - Stimulus JavaScript controllers (llm_selector, chats_form, chat_title_edit)
+  - LLM service initializer with configurable environment variables
+  - Routes and importmap configuration
+- Authentication generator (`rails generate llm_meta_client:authentication`):
+  - User model with Devise and OmniAuth integration
+  - Google OAuth2 sign-in support
+  - OmniAuth callbacks and sessions controllers
+  - Devise initializer and locale files

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 DBCLS
+
+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,88 @@
+# llm_meta_client
+
+A Rails Engine for integrating multiple LLM providers into your application. Provides scaffold and authentication generators to quickly build LLM-powered chat applications with support for OpenAI, Anthropic, Google, and Ollama.
+
+## Features
+
+- **Scaffold generator** — Generates models, controllers, views, and JavaScript controllers for a full chat UI with Turbo Stream support
+- **Authentication generator** — Sets up Devise with Google OAuth2 for user authentication
+- **Core modules** — `ServerQuery`, `ServerResource`, `Helpers`, `ChatManageable`, `HistoryManageable`, and custom exception classes
+
+## Requirements
+
+- Ruby >= 3.4
+- Rails >= 8.1.1
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem "llm_meta_client"
+```
+
+And then execute:
+
+```bash
+$ bundle install
+```
+
+## Usage
+
+### Scaffold Generator
+
+Generates a complete chat interface with LLM integration:
+
+```bash
+$ rails generate llm_meta_client:scaffold
+```
+
+This creates:
+
+- **Models:** `Chat`, `Message`
+- **Controllers:** `ChatsController`, `PromptsController`
+- **Views:** Chat views (`new`, `edit`, Turbo Stream responses), message partials, shared form fields (`_family_field`, `_api_key_field`, `_model_field`), layout with header and sidebar
+- **JavaScript:** Stimulus controllers (`llm_selector`, `chats_form`, `chat_title_edit`), popover
+- **Initializer:** `config/initializers/llm_service.rb`
+- **Migrations:** `create_chats`, `create_messages`
+- **Routes:** Chats resource with `clear`, `start_new`, `download_all_csv`, `download_csv`, `update_title` actions
+
+### Authentication Generator
+
+Sets up user authentication with Devise and Google OAuth2:
+
+```bash
+$ rails generate llm_meta_client:authentication
+```
+
+This creates:
+
+- **Model:** `User`
+- **Controllers:** `Users::OmniauthCallbacksController`, `Users::SessionsController`
+- **Initializers:** `config/initializers/devise.rb`, `config/initializers/omniauth.rb`
+- **Locale:** `config/locales/devise.en.yml`
+- **Migration:** `create_users`
+- **Routes:** Devise routes with OmniAuth callbacks
+
+## Configuration
+
+The following environment variables are used:
+
+| Variable | Description | Default |
+|---|---|---|
+| `LLM_SERVICE_BASE_URL` | Base URL for the external LLM service | `http://localhost:3000` |
+| `SUMMARIZE_CONVERSATION_COUNT` | Number of messages to include in conversation context | `10` |
+| `GOOGLE_CLIENT_ID` | Google OAuth2 client ID (authentication generator) | — |
+| `GOOGLE_CLIENT_SECRET` | Google OAuth2 client secret (authentication generator) | — |
+
+## Contributing
+
+1. Fork the repository
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create a Pull Request
+
+## 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/llm_meta_client/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/controllers/llm_meta_client/application_controller.rb

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

data/app/helpers/llm_meta_client/application_helper.rb

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

data/app/jobs/llm_meta_client/application_job.rb

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

data/app/mailers/llm_meta_client/application_mailer.rb

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

data/app/models/llm_meta_client/application_record.rb

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

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

@@ -0,0 +1,17 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <title>Llm mcp meta client</title>
+  <%= csrf_meta_tags %>
+  <%= csp_meta_tag %>
+
+  <%= yield :head %>
+
+  <%= stylesheet_link_tag    "llm_meta_client/application", media: "all" %>
+</head>
+<body>
+
+<%= yield %>
+
+</body>
+</html>

data/config/routes.rb

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

data/lib/generators/llm_meta_client/authentication/authentication_generator.rb

@@ -0,0 +1,74 @@
+# frozen_string_literal: true
+
+module LlmMetaClient
+  module Generators
+    class AuthenticationGenerator < 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 enable_devise
+        enable_gem "devise"
+      end
+
+      def enable_omniauth
+        enable_gem "omniauth"
+      end
+
+      def enable_omniauth_google_oauth2
+        enable_gem "omniauth-google-oauth2"
+      end
+
+      def enable_omniauth_rails_csrf_protection
+        enable_gem "omniauth-rails_csrf_protection"
+      end
+
+
+      def create_authentication_file
+        template "app/models/user.rb"
+
+        template "app/controllers/users/omniauth_callbacks_controller.rb"
+        template "app/controllers/users/sessions_controller.rb"
+
+        template "config/initializers/devise.rb"
+        template "config/initializers/omniauth.rb"
+        template "config/locales/devise.en.yml"
+      end
+
+      def configure_authentication_routes
+        route <<-RUBY
+          devise_for :users, controllers: {
+            omniauth_callbacks: "users/omniauth_callbacks",
+            sessions: "users/sessions"
+          }
+
+          devise_scope :user do
+            delete "/logout", to: "users/sessions#destroy", as: :user_logout
+            post "/logout", to: "users/sessions#destroy"
+          end
+        RUBY
+      end
+
+      def add_migrations
+        migration_template "db/migrate/create_users.rb", "db/migrate/create_users.rb"
+      end
+
+      private
+
+      def enable_gem(gem_name)
+        if File.read("Gemfile").include?("gem \"#{gem_name}\"")
+          uncomment_lines "Gemfile", /gem "#{gem_name}"/
+        else
+          gem gem_name
+        end
+        run "bundle install --quiet"
+      end
+    end
+  end
+end

data/lib/generators/llm_meta_client/authentication/templates/app/controllers/users/omniauth_callbacks_controller.rb

@@ -0,0 +1,26 @@
+class Users::OmniauthCallbacksController < Devise::OmniauthCallbacksController
+  def google_oauth2
+    @user = User.from_omniauth(request.env["omniauth.auth"])
+
+    # Check if the user was successfully saved to the database
+    if @user.persisted?
+      # Authentication successful: Set flash message and sign in with redirect
+      flash[:notice] = I18n.t "devise.omniauth_callbacks.success", kind: "Google"
+      sign_in_and_redirect @user, event: :authentication
+    else
+      # Authentication failed: User creation/validation errors occurred
+      # This happens when:
+      # - Email validation fails
+      # - Required fields are missing
+      # - Database constraints are violated
+      # - User model validations fail
+
+      # Redirect to home with error messages
+      redirect_to root_path, alert: @user.errors.full_messages.join("\n")
+    end
+  end
+
+  def failure
+    redirect_to root_path, alert: "Failed to authentication. Please try again."
+  end
+end

data/lib/generators/llm_meta_client/authentication/templates/app/controllers/users/sessions_controller.rb

@@ -0,0 +1,13 @@
+class Users::SessionsController < Devise::SessionsController
+  # Delete web application session and redirect to sign out action
+  def destroy
+    # Delete session
+    if current_user
+      sign_out current_user
+      reset_session
+    end
+
+    flash[:notice] = "You have successfully signed out."
+    redirect_to root_path
+  end
+end

data/lib/generators/llm_meta_client/authentication/templates/app/models/user.rb

@@ -0,0 +1,50 @@
+class User < ApplicationRecord
+  devise :omniauthable, omniauth_providers: %i[google_oauth2]
+
+  has_many :chats, dependent: :destroy
+
+  validates :email, presence: true, uniqueness: true
+  validates :google_id, presence: true, uniqueness: true
+  validates :id_token, presence: true
+
+  def self.from_omniauth(auth)
+    user = where(email: auth.info.email).first_or_initialize(
+      google_id: auth.uid
+    )
+
+    token = auth.extra&.id_token
+    if token.blank?
+      user.errors.add(:id_token, "is missing from provider response")
+      return user
+    end
+
+    user.id_token = token
+    user.save
+    user
+  end
+
+  # Return Google ID token (OpenID Connect)
+  # Validate expiration timestamp when using the token
+  def jwt_token
+    id_token if id_token.present? && token_valid?
+  end
+
+  private
+
+  # Check whether the ID token is valid
+  def token_valid?
+    return false if id_token.blank?
+
+    begin
+      # Attempt to decode JWT (no signature verification; only checks expiration)
+      decoded_token = JWT.decode(id_token, nil, false)
+      payload = decoded_token.first
+      exp = payload["exp"] if payload
+
+      # Valid if current time is before expiration
+      exp && Time.now.to_i < exp
+    rescue JWT::DecodeError, JWT::ExpiredSignature
+      false
+    end
+  end
+end