botiasloop 0.0.1 → 0.0.7

data/lib/botiasloop/commands/context.rb

@@ -3,13 +3,13 @@
 module Botiasloop
   module Commands
     # Context object passed to command executions
-    # Provides access to conversation, config, channel, and user info
+    # Provides access to conversation, chat, config, channel, and user info
     class Context
       # @return [Conversation] The current conversation
       attr_accessor :conversation
 
-      # @return [Config] The bot configuration
-      attr_reader :config
+      # @return [Chat] The chat this conversation belongs to
+      attr_reader :chat
 
       # @return [Channels::Base, nil] The channel instance (nil in CLI)
       attr_reader :channel
@@ -20,12 +20,12 @@ module Botiasloop
       # Initialize context
       #
       # @param conversation [Conversation] The current conversation
-      # @param config [Config] The bot configuration
+      # @param chat [Chat] The chat this conversation belongs to
       # @param channel [Channels::Base, nil] The channel instance (nil in CLI)
       # @param user_id [String, nil] The user/source identifier
-      def initialize(conversation:, config:, channel: nil, user_id: nil)
+      def initialize(conversation:, chat:, channel: nil, user_id: nil)
         @conversation = conversation
-        @config = config
+        @chat = chat
         @channel = channel
         @user_id = user_id
       end

data/lib/botiasloop/commands/conversations.rb

@@ -16,10 +16,15 @@ module Botiasloop
       # @return [String] Formatted list of conversations
       def execute(context, args = nil)
         show_archived = args.to_s.strip.downcase == "archived"
-        conversations = ConversationManager.list_by_user(context.user_id, archived: show_archived)
-        current_uuid = ConversationManager.current_uuid_for(context.user_id)
+        current_conversation = context.conversation
 
-        lines = show_archived ? ["**Archived Conversations**"] : ["**Conversations**"]
+        if show_archived
+          conversations = context.chat.archived_conversations
+          lines = ["**Archived Conversations**"]
+        else
+          conversations = context.chat.active_conversations
+          lines = ["**Conversations**"]
+        end
 
         if conversations.empty?
           lines << (show_archived ? "No archived conversations found." : "No conversations found.")
@@ -27,10 +32,10 @@ module Botiasloop
         end
 
         conversations.each do |conv|
-          prefix = (conv[:uuid] == current_uuid) ? "[current] " : ""
-          label = conv[:label]
+          prefix = (conv.id == current_conversation.id) ? "[current] " : ""
+          label = conv.label
           suffix = label ? " (#{label})" : ""
-          lines << "#{prefix}#{conv[:uuid]}#{suffix}"
+          lines << "#{prefix}#{conv.id}#{suffix}"
         end
 
         lines.join("\n")

data/lib/botiasloop/commands/label.rb

@@ -14,7 +14,6 @@ module Botiasloop
       # @return [String] Command response
       def execute(context, args = nil)
         conversation = context.conversation
-        user_id = context.user_id
 
         if args.nil? || args.strip.empty?
           # Show current label
@@ -23,7 +22,7 @@ module Botiasloop
 
         # Set label
         label_value = args.strip
-        set_label(conversation, user_id, label_value)
+        set_label(conversation, label_value)
       end
 
       private
@@ -36,28 +35,27 @@ module Botiasloop
         end
       end
 
-      def set_label(conversation, user_id, label_value)
+      def set_label(conversation, label_value)
         # Validate label format
         unless label_value.match?(/\A[a-zA-Z0-9_-]+\z/)
           return "Invalid label format. Use only letters, numbers, dashes, and underscores."
         end
 
-        # Check uniqueness per user
-        if label_in_use?(user_id, label_value, conversation.uuid)
+        # Check uniqueness globally
+        if label_in_use?(label_value, conversation.id)
           return "Label '#{label_value}' already in use by another conversation."
         end
 
-        conversation.update(label: label_value)
+        conversation.label = label_value
+        conversation.save
         "Label set to: #{label_value}"
       rescue Botiasloop::Error => e
         "Error setting label: #{e.message}"
       end
 
-      def label_in_use?(user_id, label, current_uuid)
-        return false if user_id.nil?
-
-        existing_uuid = ConversationManager.find_by_label(user_id, label)
-        existing_uuid && existing_uuid != current_uuid
+      def label_in_use?(label, current_id)
+        other = Conversation.find(label: label)
+        other && other.id != current_id
       end
     end
   end

data/lib/botiasloop/commands/new.rb

@@ -10,10 +10,10 @@ module Botiasloop
       description "Start a new conversation"
 
       def execute(context, _args = nil)
-        new_conversation = ConversationManager.create_new(context.user_id)
+        new_conversation = context.chat.create_new_conversation
         context.conversation = new_conversation
 
-        "**New conversation started (UUID: #{new_conversation.uuid}).**\n" \
+        "**New conversation started (ID: #{new_conversation.uuid}).**\n" \
         "Use `/switch #{new_conversation.uuid}` to return later."
       end
     end

data/lib/botiasloop/commands/status.rb

@@ -9,10 +9,10 @@ module Botiasloop
 
       def execute(context, _args = nil)
         conversation = context.conversation
-        config = context.config
+        config = Config.instance
 
         lines = ["**Conversation Status**"]
-        lines << "UUID: #{conversation.uuid}"
+        lines << "ID: #{conversation.uuid}"
         lines << "Label: #{format_label(conversation)}"
         lines << "Model: #{config.providers["openrouter"]["model"]}"
         lines << "Max iterations: #{config.max_iterations}"

data/lib/botiasloop/commands/switch.rb

@@ -2,10 +2,10 @@
 
 module Botiasloop
   module Commands
-    # Switch command - switches to a different conversation by label or UUID
+    # Switch command - switches to a different conversation by label or ID
     class Switch < Base
       command :switch
-      description "Switch to a different conversation by label or UUID"
+      description "Switch to a different conversation by label or ID"
 
       # Execute the switch command
       #
@@ -15,11 +15,9 @@ module Botiasloop
       def execute(context, args = nil)
         identifier = args.to_s.strip
 
-        if identifier.empty?
-          return "Usage: /switch <label-or-uuid>"
-        end
+        return "Usage: /switch <label-or-id>" if identifier.empty?
 
-        new_conversation = ConversationManager.switch(context.user_id, identifier)
+        new_conversation = context.chat.switch_conversation(identifier)
         context.conversation = new_conversation
 
         format_switch_response(new_conversation)
@@ -31,7 +29,7 @@ module Botiasloop
 
       def format_switch_response(conversation)
         lines = ["**Conversation switched**"]
-        lines << "- UUID: #{conversation.uuid}"
+        lines << "- ID: #{conversation.uuid}"
 
         lines << if conversation.label?
           "- Label: #{conversation.label}"

data/lib/botiasloop/commands/verbose.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module Botiasloop
+  module Commands
+    # Verbose command - controls verbose mode for tool call output
+    class Verbose < Base
+      command :verbose
+      description "Toggle verbose mode (shows reasoning and tool calls). Usage: /verbose [on|off]"
+
+      def execute(context, args = nil)
+        conversation = context.conversation
+
+        case args&.downcase&.strip
+        when "on"
+          conversation.update(verbose: true)
+          "Verbose mode enabled. Tool calls will be shown."
+        when "off"
+          conversation.update(verbose: false)
+          "Verbose mode disabled. Tool calls will be hidden."
+        when nil, ""
+          status = conversation.verbose ? "on" : "off"
+          "Verbose mode is currently #{status}. Usage: /verbose [on|off]"
+        else
+          "Unknown argument: #{args}. Usage: /verbose [on|off]"
+        end
+      end
+    end
+  end
+end

data/lib/botiasloop/commands.rb

@@ -5,6 +5,7 @@ require_relative "commands/base"
 require_relative "commands/registry"
 require_relative "commands/help"
 require_relative "commands/status"
+require_relative "commands/verbose"
 require_relative "commands/reset"
 require_relative "commands/new"
 require_relative "commands/compact"

data/lib/botiasloop/config.rb

@@ -6,8 +6,19 @@ Anyway::Settings.default_config_path = ->(_) { File.expand_path("~/.config/botia
 
 module Botiasloop
   class Config < Anyway::Config
+    @instance = nil
+
+    class << self
+      def instance
+        @instance ||= new
+      end
+
+      attr_writer :instance
+    end
+
     attr_config \
       max_iterations: 20,
+      log_level: "info",
       tools: {
         web_search: {}
       },
@@ -23,6 +34,11 @@ module Botiasloop
       },
       commands: {
         summarize: {}
+      },
+      features: {
+        auto_labelling: {
+          enabled: true
+        }
       }
 
     # Validation

data/lib/botiasloop/conversation.rb

@@ -1,12 +1,14 @@
 # frozen_string_literal: true
 
-require "securerandom"
 require "time"
 
 module Botiasloop
   # Conversation model - represents a chat conversation with messages
   # Direct Sequel model with all database and business logic combined
   class Conversation < Sequel::Model(:conversations)
+    # Valid label format: alphanumeric, dashes, and underscores
+    LABEL_REGEX = /\A[a-zA-Z0-9_-]+\z/
+
     # Message model nested within Conversation namespace
     class Message < Sequel::Model(:messages)
       plugin :validation_helpers
@@ -17,7 +19,7 @@ module Botiasloop
       # Validations
       def validate
         super
-        validates_presence [:conversation_id, :role, :content]
+        validates_presence %i[conversation_id role content]
       end
 
       # Convert message to hash for API compatibility
@@ -42,21 +44,21 @@ module Botiasloop
     # Allow setting primary key (id) for UUID
     unrestrict_primary_key
 
-    # Auto-generate UUID before creation if not provided
+    # Auto-generate human-readable ID before creation if not provided
     def before_create
-      self.id ||= SecureRandom.uuid
+      self.id ||= HumanId.generate
       super
     end
 
     # Validations
     def validate
       super
-      validates_presence [:user_id]
 
-      if label && !label.to_s.empty?
-        validates_format ConversationManager::LABEL_REGEX, :label, message: "Invalid label format. Use only letters, numbers, dashes, and underscores."
-        validates_unique [:user_id, :label], message: "Label '#{label}' already in use by another conversation"
-      end
+      return unless label && !label.to_s.empty?
+
+      validates_format LABEL_REGEX, :label,
+        message: "Invalid label format. Use only letters, numbers, dashes, and underscores."
+      validates_unique :label, message: "Label '#{label}' already in use by another conversation"
     end
 
     # Check if this conversation has a label
@@ -66,6 +68,30 @@ module Botiasloop
       !label.nil? && !label.to_s.empty?
     end
 
+    # Check if this conversation is archived
+    #
+    # @return [Boolean] True if archived
+    def archived?
+      archived == true
+    end
+
+    # Set the label for this conversation
+    #
+    # @param value [String] Label value
+    def label=(value)
+      # Allow empty string to be treated as nil (clearing the label)
+      value = nil if value.to_s.empty?
+      super
+    end
+
+    # Archive this conversation
+    #
+    # @return [Conversation] self
+    def archive!
+      update(archived: true)
+      self
+    end
+
     # Get the timestamp of the last activity in the conversation
     #
     # @return [String, nil] ISO8601 timestamp of last message, or nil if no messages
@@ -126,10 +152,10 @@ module Botiasloop
       messages_dataset.order(:timestamp).map(&:to_hash)
     end
 
-    # @return [String] UUID of the conversation
+    # @return [String] Human-readable ID of the conversation
     def uuid
       # Return existing id or generate a new one for unsaved records
-      self.id ||= SecureRandom.uuid
+      self.id ||= HumanId.generate
     end
 
     # Reset conversation - clear all messages and reset token counts
@@ -183,7 +209,70 @@ module Botiasloop
         SKILLS
       end
 
+      prompt += build_operator_section
+      prompt += build_identity_section
+
       prompt
     end
+
+    private
+
+    def build_identity_section
+      path = File.expand_path("~/IDENTITY.md")
+      content = File.exist?(path) ? File.read(path).strip : nil
+
+      section = "\n\nIDENTITY.md\nDefines who you are - your name, personality, and how you behave.\n\n"
+
+      if content && !content.empty?
+        section += "#{content}\n\n"
+        section += "You can update ~/IDENTITY.md when the operator wants you to act differently or call you differently (eg. 'Be more concise from now on')."
+      elsif content && content.empty?
+        section += "CRITICAL: This file is empty. After setting up OPERATOR.md, ask the operator:\n\n"
+        section += "1. What name should I use for myself?\n"
+        section += "2. How formal or casual should I be?\n"
+        section += "3. Should I be concise or detailed in responses?\n"
+        section += "4. Any other personality preferences?\n\n"
+        section += "Then create ~/IDENTITY.md with this information."
+      else
+        section += "CRITICAL: This file does not exist. After setting up OPERATOR.md, ask the operator:\n\n"
+        section += "1. What name should I use for myself?\n"
+        section += "2. How formal or casual should I be?\n"
+        section += "3. Should I be concise or detailed in responses?\n"
+        section += "4. Any other personality preferences?\n\n"
+        section += "Then create ~/IDENTITY.md with: `cat > ~/IDENTITY.md << 'EOF'\n[content here]\nEOF`"
+      end
+
+      section
+    end
+
+    def build_operator_section
+      path = File.expand_path("~/OPERATOR.md")
+      content = File.exist?(path) ? File.read(path).strip : nil
+
+      section = "\n\nOPERATOR.md\nInformation about the operator - their preferences, context, background, and more.\n\n"
+
+      if content && !content.empty?
+        section += "#{content}\n\n"
+        section += "You can update ~/OPERATOR.md when you learn something new about the operator (eg. their name, birthday, what they like, etc.)."
+      elsif content && content.empty?
+        section += "CRITICAL: This file is empty. Before helping with other tasks, you MUST:\n\n"
+        section += "1. Ask the operator their name\n"
+        section += "2. Ask their location and timezone\n"
+        section += "3. Ask their preferred language\n"
+        section += "4. Ask about their interests, hobbies, or work\n"
+        section += "5. Ask any relevant personal context they're comfortable sharing (birthday, family, etc.)\n\n"
+        section += "Then create ~/OPERATOR.md with this information."
+      else
+        section += "CRITICAL: This file does not exist. Before helping with other tasks, you MUST:\n\n"
+        section += "1. Ask the operator their name\n"
+        section += "2. Ask their location and timezone\n"
+        section += "3. Ask their preferred language\n"
+        section += "4. Ask about their interests, hobbies, or work\n"
+        section += "5. Ask any relevant personal context they're comfortable sharing (birthday, family, etc.)\n\n"
+        section += "Then create ~/OPERATOR.md with: `cat > ~/OPERATOR.md << 'EOF'\n[content here]\nEOF`"
+      end
+
+      section
+    end
   end
 end

data/lib/botiasloop/database.rb

@@ -34,6 +34,7 @@ module Botiasloop
         db = connect
         db[:messages].delete if db.table_exists?(:messages)
         db[:conversations].delete if db.table_exists?(:conversations)
+        db[:chats].delete if db.table_exists?(:chats)
       end
 
       # Close database connection
@@ -52,20 +53,31 @@ module Botiasloop
         # Ensure directory exists
         FileUtils.mkdir_p(File.dirname(DEFAULT_PATH))
 
+        # Create chats table
+        db.create_table?(:chats) do
+          primary_key :id
+          String :channel, null: false
+          String :external_id, null: false
+          String :user_identifier
+          String :current_conversation_id
+          DateTime :created_at, default: Sequel::CURRENT_TIMESTAMP
+          DateTime :updated_at, default: Sequel::CURRENT_TIMESTAMP
+
+          index %i[channel external_id], unique: true
+        end
+
         # Create conversations table
         db.create_table?(:conversations) do
           String :id, primary_key: true
-          String :user_id, null: false
           String :label
-          TrueClass :is_current, default: false
           TrueClass :archived, default: false
+          TrueClass :verbose, default: false
           Integer :input_tokens, default: 0
           Integer :output_tokens, default: 0
           DateTime :created_at, default: Sequel::CURRENT_TIMESTAMP
           DateTime :updated_at, default: Sequel::CURRENT_TIMESTAMP
 
-          index [:user_id, :label], unique: true
-          index [:user_id, :archived]
+          index :label, unique: true
         end
 
         # Create messages table

data/lib/botiasloop/human_id.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+require "ffaker"
+
+module Botiasloop
+  # Generates human-readable identifiers for conversations
+  # Format: color-animal-XXX (e.g., blue-dog-123)
+  # All IDs are stored and compared in lowercase for case-insensitivity
+  module HumanId
+    MAX_RETRIES = 10
+
+    # Generate a unique human-readable ID
+    # Checks database for collisions and retries if needed
+    #
+    # @return [String] Unique ID in format color-animal-XXX
+    # @raise [Error] If unable to generate unique ID after max retries
+    def self.generate
+      retries = 0
+
+      loop do
+        id = build_id
+        return id unless exists?(id)
+
+        retries += 1
+        raise Error, "Failed to generate unique ID after #{MAX_RETRIES} attempts" if retries >= MAX_RETRIES
+      end
+    end
+
+    # Normalize an ID to lowercase for storage and comparison
+    #
+    # @param id [String, nil] ID to normalize
+    # @return [String] Normalized lowercase ID
+    def self.normalize(id)
+      id.to_s.downcase.strip
+    end
+
+    # Check if an ID already exists in the database
+    # Case-insensitive comparison
+    #
+    # @param id [String] ID to check
+    # @return [Boolean] True if ID exists
+    def self.exists?(id)
+      normalized = normalize(id)
+      Conversation.where(Sequel.function(:lower, :id) => normalized).count > 0
+    end
+
+    # Build a single ID attempt
+    #
+    # @return [String] ID in format color-animal-XXX
+    def self.build_id
+      color = FFaker::Color.name.downcase.tr(" ", "-")
+      animal = FFaker::AnimalUS.common_name.downcase.tr(" ", "-")
+      number = rand(100..999)
+
+      "#{color}-#{animal}-#{number}"
+    end
+  end
+end

data/lib/botiasloop/logger.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+require "logger"
+
+module Botiasloop
+  module Logger
+    class << self
+      def logger
+        @logger ||= create_logger
+      end
+
+      def debug(msg)
+        logger.debug(msg)
+      end
+
+      def info(msg)
+        logger.info(msg)
+      end
+
+      def warn(msg)
+        logger.warn(msg)
+      end
+
+      def error(msg)
+        logger.error(msg)
+      end
+
+      private
+
+      def create_logger
+        level = begin
+          config = Botiasloop::Config.new
+          ::Logger.const_get(config.log_level.to_s.upcase)
+        rescue
+          ::Logger::INFO
+        end
+
+        log = ::Logger.new($stderr)
+        log.level = level
+        log.formatter = proc { |_severity, _datetime, _progname, msg| "#{msg}\n" }
+        log
+      end
+    end
+  end
+end