ruby_conversations 1.0.7 → 1.0.8

metadata

@@ -1,15 +1,29 @@
 --- !ruby/object:Gem::Specification
 name: ruby_conversations
 version: !ruby/object:Gem::Version
-  version: 1.0.7
+  version: 1.0.8
 platform: ruby
 authors:
 - Paul Shippy
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-04-07 00:00:00.000000000 Z
+date: 2025-04-10 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.0'
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core
   requirement: !ruby/object:Gem::Requirement
@@ -53,21 +67,21 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '2.0'
 - !ruby/object:Gem::Dependency
-  name: rails
+  name: ruby_llm
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '7.0'
+        version: '1.1'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '7.0'
+        version: '1.1'
 - !ruby/object:Gem::Dependency
-  name: ruby_llm
+  name: strongmind-auth
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
@@ -86,14 +100,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.5'
+        version: '2.6'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.5'
+        version: '2.6'
 - !ruby/object:Gem::Dependency
   name: bootsnap
   requirement: !ruby/object:Gem::Requirement
@@ -108,20 +122,6 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.0'
-- !ruby/object:Gem::Dependency
-  name: database_cleaner-active_record
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
 - !ruby/object:Gem::Dependency
   name: dotenv-rails
   requirement: !ruby/object:Gem::Requirement
@@ -137,21 +137,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: factory_bot_rails
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: parallel_tests
+  name: factory_bot
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -165,7 +151,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: pg
+  name: pry-byebug
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -179,7 +165,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: pry-byebug
+  name: rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -248,21 +234,7 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-- !ruby/object:Gem::Dependency
-  name: sqlite3
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-description: 'A Rails engine for managing AI conversations with support for both '
+description: A Ruby client library for managing AI conversations via a remote API.
 email:
 - paul.shippy@strongmind.com
 executables: []
@@ -270,36 +242,26 @@ extensions: []
 extra_rdoc_files: []
 files:
 - README.md
-- Rakefile
-- app/models/concerns/ruby_conversations/messageable.rb
-- app/models/concerns/ruby_conversations/versionable.rb
-- app/models/ruby_conversations/ai_conversation.rb
-- app/models/ruby_conversations/ai_message.rb
-- app/models/ruby_conversations/ai_message_input.rb
-- app/models/ruby_conversations/ai_message_prompt.rb
-- app/models/ruby_conversations/concerns/llm_credentials.rb
-- app/models/ruby_conversations/concerns/message_validation.rb
+- app/models/concerns/ruby_conversations/conversation_chat.rb
+- app/models/concerns/ruby_conversations/conversation_messages.rb
+- app/models/concerns/ruby_conversations/llm_credentials.rb
+- app/models/concerns/ruby_conversations/message_api_attributes.rb
+- app/models/concerns/ruby_conversations/message_attributes.rb
+- app/models/concerns/ruby_conversations/message_processing.rb
+- app/models/concerns/ruby_conversations/message_validation.rb
+- app/models/concerns/ruby_conversations/storable.rb
+- app/models/ruby_conversations/conversation.rb
+- app/models/ruby_conversations/message.rb
 - app/models/ruby_conversations/message_builder.rb
+- app/models/ruby_conversations/message_input.rb
+- app/models/ruby_conversations/message_prompt.rb
 - app/models/ruby_conversations/prompt.rb
-- app/models/ruby_conversations/prompt_version.rb
-- lib/generators/ruby_conversations/install/install_generator.rb
-- lib/generators/ruby_conversations/install/templates/README.md
-- lib/generators/ruby_conversations/install/templates/initializer.rb.erb
-- lib/generators/ruby_conversations/install/templates/migrations/create_ai_conversations.rb.erb
-- lib/generators/ruby_conversations/install/templates/migrations/create_ai_message_inputs.rb.erb
-- lib/generators/ruby_conversations/install/templates/migrations/create_ai_message_prompts.rb.erb
-- lib/generators/ruby_conversations/install/templates/migrations/create_ai_messages.rb.erb
-- lib/generators/ruby_conversations/install/templates/migrations/create_ai_tool_calls.rb.erb
-- lib/generators/ruby_conversations/install/templates/migrations/create_prompt_versions.rb.erb
-- lib/generators/ruby_conversations/install/templates/migrations/create_prompts.rb.erb
 - lib/ruby_conversations.rb
 - lib/ruby_conversations/aws_credential_provider.rb
+- lib/ruby_conversations/client.rb
 - lib/ruby_conversations/configuration.rb
 - lib/ruby_conversations/engine.rb
-- lib/ruby_conversations/jwt_client.rb
-- lib/ruby_conversations/storage/base.rb
-- lib/ruby_conversations/storage/local.rb
-- lib/ruby_conversations/storage/remote.rb
+- lib/ruby_conversations/errors.rb
 - lib/ruby_conversations/version.rb
 homepage: https://github.com/StrongMind/ruby-conversations
 licenses:
@@ -327,5 +289,5 @@ requirements: []
 rubygems_version: 3.4.10
 signing_key:
 specification_version: 4
-summary: Rails engine for managing AI conversations with local or remote storage
+summary: Client library for interacting with the AI Conversation Service
 test_files: []

data/Rakefile

@@ -1,12 +0,0 @@
-# frozen_string_literal: true
-
-require 'bundler/gem_tasks'
-require 'rspec/core/rake_task'
-
-RSpec::Core::RakeTask.new(:spec)
-
-require 'rubocop/rake_task'
-
-RuboCop::RakeTask.new
-
-task default: %i[spec rubocop]

data/app/models/concerns/ruby_conversations/messageable.rb

@@ -1,13 +0,0 @@
-# frozen_string_literal: true
-
-module RubyConversations
-  # Provides message-related functionalities for conversations.
-  module Messageable
-    extend ActiveSupport::Concern
-
-    included do
-      has_many :ai_conversations, as: :conversationable, dependent: :destroy
-      has_many :ai_messages, through: :ai_conversations
-    end
-  end
-end

data/app/models/concerns/ruby_conversations/versionable.rb

@@ -1,20 +0,0 @@
-# frozen_string_literal: true
-
-module RubyConversations
-  # Provides versioning functionalities for models.
-  module Versionable
-    extend ActiveSupport::Concern
-
-    included do
-      has_many :versions, class_name: 'PromptVersion', dependent: :destroy
-      has_one :latest_version, -> { order(version: :desc) }, class_name: 'PromptVersion'
-
-      delegate :content, :metadata, to: :latest_version, allow_nil: true
-    end
-
-    def create_version!(content:, metadata: {})
-      next_version = versions.maximum(:version).to_i + 1
-      versions.create!(content: content, metadata: metadata, version: next_version)
-    end
-  end
-end

data/app/models/ruby_conversations/ai_conversation.rb

@@ -1,91 +0,0 @@
-# frozen_string_literal: true
-
-require_relative 'concerns/message_validation'
-require_relative 'concerns/llm_credentials'
-
-module RubyConversations
-  # An AI conversation is a conversation between an AI and a user.
-  class AiConversation < ActiveRecord::Base
-    include RubyConversations::MessageValidation
-    include RubyConversations::LlmCredentials
-
-    # Associations
-    belongs_to :conversationable, polymorphic: true, optional: true, touch: true
-    has_many :ai_messages, class_name: RubyConversations.configuration.message_class, dependent: :destroy
-
-    # Validations
-    validates :ai_messages, presence: { message: 'At least one message is required' }, on: :update
-    validate :validate_messages
-
-    # Scopes
-    scope :recent, -> { order(updated_at: :desc) }
-    scope :with_messages, -> { includes(:ai_messages) }
-
-    # Attributes
-    attr_accessor :model_identifier, :provider, :tool
-
-    def initialize(attributes = nil)
-      attributes ||= {}
-      super
-      @model_identifier ||= attributes[:model_identifier] || RubyConversations.configuration.default_llm_model
-      @provider ||= attributes[:provider] || RubyConversations.configuration.default_llm_provider
-    end
-
-    # Instance Methods
-    def ask_multiple(prompt_inputs, description: nil)
-      MessageBuilder.new(self).build_from_multiple_prompts(prompt_inputs, description: description)
-      self
-    end
-
-    def ask(name, description: nil, inputs: {})
-      MessageBuilder.new(self).build_from_single_prompt(name, description: description, inputs: inputs)
-      self
-    end
-
-    def execute(system_message: nil)
-      save!
-      message = ai_messages.last
-      raise ArgumentError, 'Conversation must have at least one message to execute' unless message
-
-      chat = setup_llm_chat(system_message: system_message)
-      response = chat.ask(message.request)
-      update_last_message_response(message, response)
-      response
-    end
-
-    def latest_message
-      ai_messages.order(created_at: :desc).first
-    end
-
-    def message_count
-      ai_messages.count
-    end
-
-    def llm
-      case model_identifier
-      when 'claude-3-7-sonnet'
-        'us.anthropic.claude-3-7-sonnet-20250219-v1:0'
-      else
-        model_identifier
-      end
-    end
-
-    private
-
-    def setup_llm_chat(system_message: nil)
-      configure_llm_credentials
-      build_chat(system_message)
-    end
-
-    def update_last_message_response(message, response)
-      message.update!(response: response.to_h.to_json)
-    end
-
-    def build_chat(system_message)
-      chat = RubyLLM.chat(model: llm, provider: provider).with_temperature(0.0)
-      chat.with_tool(tool) if tool.present?
-      chat.add_message(role: :system, content: system_message) if system_message.present?
-      chat
-    end
-  end
-end

data/app/models/ruby_conversations/ai_message.rb

@@ -1,28 +0,0 @@
-# frozen_string_literal: true
-
-module RubyConversations
-  # An AI message is a message in an AI conversation.
-  class AiMessage < ActiveRecord::Base
-    # Associations
-    belongs_to :ai_conversation, class_name: RubyConversations.configuration.conversation_class
-    has_many :ai_message_prompts, class_name: RubyConversations.configuration.message_prompt_class, dependent: :destroy
-    has_many :prompts, through: :ai_message_prompts, class_name: RubyConversations.configuration.prompt_class
-
-    # Validations
-    validates :llm, presence: true
-    validates :request, presence: true
-
-    # Scopes
-    scope :ordered, -> { order(created_at: :desc) }
-    scope :with_tool, ->(tool) { where(tool: tool) }
-    scope :with_prompts, -> { includes(:ai_message_prompts) }
-
-    def prompt_inputs
-      ai_message_prompts.includes(:ai_message_inputs).flat_map(&:ai_message_inputs)
-    end
-
-    def tool?
-      tool.present?
-    end
-  end
-end

data/app/models/ruby_conversations/ai_message_input.rb

@@ -1,22 +0,0 @@
-# frozen_string_literal: true
-
-module RubyConversations
-  # Represents an input provided for a specific prompt placeholder within an AI message.
-  class AiMessageInput < ActiveRecord::Base
-    # Associations
-    belongs_to :ai_message_prompt
-
-    # Validations
-    validates :placeholder_name, presence: true
-    validate :value_not_nil
-
-    # Scopes
-    scope :ordered, -> { order(:placeholder_name) }
-
-    private
-
-    def value_not_nil
-      errors.add(:value, "can't be blank") if value.nil?
-    end
-  end
-end

data/app/models/ruby_conversations/ai_message_prompt.rb

@@ -1,28 +0,0 @@
-# frozen_string_literal: true
-
-module RubyConversations
-  # Represents the association between an AI message and a specific version of a Prompt.
-  class AiMessagePrompt < ActiveRecord::Base
-    # Associations
-    belongs_to :ai_message
-    belongs_to :prompt, optional: true
-    belongs_to :prompt_version, optional: true
-    has_many :ai_message_inputs, class_name: RubyConversations.configuration.message_input_class, dependent: :destroy
-
-    # Validations
-    validate :prompt_or_inline_data_present
-
-    # Scopes
-    scope :with_inputs, -> { includes(:ai_message_inputs) }
-    scope :for_prompt, ->(prompt) { where(prompt: prompt) }
-
-    private
-
-    def prompt_or_inline_data_present
-      return if prompt_id.present? || prompt_version_id.present?
-      return if name.present? && role.present? && draft.present?
-
-      errors.add(:base, 'Must have either a prompt/version reference or inline prompt data (name, role, draft)')
-    end
-  end
-end

data/app/models/ruby_conversations/prompt_version.rb

@@ -1,16 +0,0 @@
-# frozen_string_literal: true
-
-module RubyConversations
-  # Represents a specific version of a Prompt template.
-  class PromptVersion < ActiveRecord::Base
-    # Associations
-    belongs_to :prompt
-
-    # Validations
-    validates :message, presence: true
-    validates :temperature, numericality: { greater_than_or_equal_to: 0.0 }, allow_nil: true
-
-    # Scopes
-    scope :ordered, -> { order(created_at: :desc) }
-  end
-end

data/lib/generators/ruby_conversations/install/install_generator.rb

@@ -1,60 +0,0 @@
-# frozen_string_literal: true
-
-require 'rails/generators'
-require 'rails/generators/migration'
-
-module RubyConversations
-  module Generators
-    # Generates the necessary files for installing the ruby_conversations engine.
-    class InstallGenerator < Rails::Generators::Base
-      include Rails::Generators::Migration
-
-      source_root File.expand_path('templates', __dir__)
-
-      def self.next_migration_number(path)
-        next_migration_number = current_migration_number(path) + 1
-        ActiveRecord::Migration.next_migration_number(next_migration_number)
-      end
-
-      def copy_migrations
-        migration_template_details.each do |file, description|
-          migration_template(
-            "migrations/#{file}",
-            "db/migrate/#{file.sub('.erb', '')}",
-            migration_version: migration_version,
-            migration_description: description
-          )
-        end
-      end
-
-      def create_initializer
-        template 'initializer.rb.erb', 'config/initializers/ruby_conversations.rb'
-      end
-
-      def mount_engine
-        route "mount RubyConversations::Engine => '/ai', as: 'ruby_conversations'"
-      end
-
-      def display_post_install_message
-        readme 'README.md'
-      end
-
-      private
-
-      def migration_version
-        "[#{Rails::VERSION::MAJOR}.#{Rails::VERSION::MINOR}]"
-      end
-
-      def migration_template_details
-        {
-          'create_prompts.rb.erb' => 'Create prompts table',
-          'create_prompt_versions.rb.erb' => 'Create prompt versions table',
-          'create_ai_conversations.rb.erb' => 'Create conversations table',
-          'create_ai_messages.rb.erb' => 'Create messages table',
-          'create_ai_message_prompts.rb.erb' => 'Create message prompts table',
-          'create_ai_message_inputs.rb.erb' => 'Create message inputs table'
-        }
-      end
-    end
-  end
-end

data/lib/generators/ruby_conversations/install/templates/README.md

@@ -1,42 +0,0 @@
-# RubyConversations Installation
-
-The gem has been installed! Here are the next steps:
-
-1. Run the migrations:
-   ```bash
-   bin/rails db:migrate
-   ```
-
-2. Configure the gem in `config/initializers/ruby_conversations.rb`
-   - Set your storage mode (:local or :remote)
-   - If using remote mode, set your API URL and JWT secret
-   - Customize model names if needed
-
-3. For remote mode, ensure your API endpoint is accessible and JWT authentication is configured.
-
-4. Start using conversations in your models:
-   ```ruby
-   class MyModel < ApplicationRecord
-     has_one :conversation, as: :conversationable, class_name: 'AiConversation'
-   end
-
-   # Create a conversation
-   conversation = my_model.create_conversation!
-   
-   # Ask a question using a prompt
-   conversation.ask("explain_code", inputs: { code: "def hello; end" })
-   ```
-
-5. The engine is mounted at `/ai`. You can change this in `config/routes.rb` if needed.
-
-## What's Next?
-
-- Check out the documentation at https://github.com/yourusername/ruby_conversations
-- Review the example app at https://github.com/yourusername/ruby_conversations_example
-- Join our Discord community at https://discord.gg/ruby_conversations
-
-## Need Help?
-
-- Open an issue on GitHub
-- Check our FAQ at https://github.com/yourusername/ruby_conversations/wiki/FAQ
-- Email support at support@example.com 

data/lib/generators/ruby_conversations/install/templates/initializer.rb.erb

@@ -1,18 +0,0 @@
-# frozen_string_literal: true
-
-RubyConversations.configure do |config|
-  # Storage mode: :local or :remote
-  config.storage_mode = :local
-  
-  # Remote API settings (only needed for remote mode)
-  # config.api_url = ENV['RUBY_CONVERSATIONS_API_URL']
-  # config.jwt_secret = ENV['RUBY_CONVERSATIONS_JWT_SECRET']
-  
-  # Default LLM settings
-  config.default_llm_model = 'gpt-4'
-  
-  # Customize model behaviors
-  config.conversation_class = 'AiConversation'
-  config.message_class = 'AiMessage'
-  config.prompt_class = 'Prompt'
-end 

data/lib/generators/ruby_conversations/install/templates/migrations/create_ai_conversations.rb.erb

@@ -1,13 +0,0 @@
-class CreateAiConversations < ActiveRecord::Migration[7.0]
-  def change
-    create_table :ai_conversations do |t|
-      t.string :conversationable_type
-      t.bigint :conversationable_id
-
-      t.timestamps
-    end
-
-    add_index :ai_conversations, [:conversationable_type, :conversationable_id], 
-              name: 'index_ai_conversations_on_conversationable'
-  end
-end 

data/lib/generators/ruby_conversations/install/templates/migrations/create_ai_message_inputs.rb.erb

@@ -1,13 +0,0 @@
-class CreateAiMessageInputs < ActiveRecord::Migration[7.0]
-  def change
-    create_table :ai_message_inputs do |t|
-      t.string :placeholder_name
-      t.text :value
-      t.bigint :ai_message_prompt_id, null: false
-
-      t.timestamps
-    end
-
-    add_index :ai_message_inputs, :ai_message_prompt_id
-  end
-end 

data/lib/generators/ruby_conversations/install/templates/migrations/create_ai_message_prompts.rb.erb

@@ -1,18 +0,0 @@
-class CreateAiMessagePrompts < ActiveRecord::Migration[7.0]
-  def change
-    create_table :ai_message_prompts do |t|
-      t.bigint :ai_message_id, null: false
-      t.bigint :prompt_id
-      t.text :draft
-      t.bigint :prompt_version_id
-      t.string :name
-      t.string :role
-
-      t.timestamps
-    end
-
-    add_index :ai_message_prompts, :ai_message_id
-    add_index :ai_message_prompts, :prompt_id
-    add_index :ai_message_prompts, :prompt_version_id
-  end
-end 

data/lib/generators/ruby_conversations/install/templates/migrations/create_ai_messages.rb.erb

@@ -1,18 +0,0 @@
-class CreateAiMessages < ActiveRecord::Migration[7.0]
-  def change
-    create_table :ai_messages do |t|
-      t.bigint :ai_conversation_id, null: false
-      t.jsonb :request
-      t.text :response
-      t.string :model_identifier
-      t.string :tool
-      t.text :change_description
-      t.string :llm, default: 'us.anthropic.claude-3-7-sonnet-20250219-v1:0', null: false
-
-      t.timestamps
-    end
-
-    add_index :ai_messages, :ai_conversation_id
-    add_index :ai_messages, :llm
-  end
-end 

data/lib/generators/ruby_conversations/install/templates/migrations/create_ai_tool_calls.rb.erb

@@ -1,15 +0,0 @@
-class CreateAiToolCalls < ActiveRecord::Migration[7.0]
-  def change
-    create_table :ai_tool_calls do |t|
-      t.references :ai_message, null: false, foreign_key: true
-      t.string :name, null: false
-      t.jsonb :arguments, null: false, default: {}
-      t.text :result
-      t.text :error
-      
-      t.timestamps
-    end
-    
-    add_index :ai_tool_calls, :name
-  end
-end 

data/lib/generators/ruby_conversations/install/templates/migrations/create_prompt_versions.rb.erb

@@ -1,14 +0,0 @@
-class CreatePromptVersions < ActiveRecord::Migration[7.0]
-  def change
-    create_table :prompt_versions do |t|
-      t.bigint :prompt_id, null: false
-      t.text :message
-      t.float :temperature
-      t.text :change_description
-
-      t.timestamps
-    end
-
-    add_index :prompt_versions, :prompt_id
-  end
-end