NSR-AI v1.1 - Comprehensive Update

This update introduces significant improvements to configuration management, and a powerful, multi-layered system for handling conversation history, designed for optimal performance and user control.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Configuration Split

For better organization and easier management, the plugin's configuration has been split into two distinct files:

config.yml: This file now contains the core settings for the plugin, such as:
- Admin activation code
- Default AI models (Gemini, Claude, OpenAI)
- Default API provider
- API keys

features.yml: This new file contains all feature-related settings, including:
- Chat colors for the AI and users
- Customizable messages for various events (e.g., API errors, permission denied)
- The system prompt for the AI
- Conversation history length
- Chat prefixes for AI and users
- Code blocker settings

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Advanced Memory & Caching System

This system provides granular control over conversation history, balancing AI context with server performance.

1. Simple Session Caching (/ai cache)

These commands offer quick control over a player's active chat session without involving AI processing. They are ideal for fast resets.

/ai cache clear
- Action: Instantly clears the AI's short-term memory for the specified target.
- Result: The next message will start a completely fresh conversation.
- Usage:
- Player: /ai cache clear (Clears your own session)
- Admin: /ai cache clear <playername> (Clears a specific player's session)
- Admin: /ai cache clear all (Clears all online players' sessions)

/ai cache refresh
- Action: Reloads the most recent conversation from the long-term log files back into the AI's short-term memory for the specified target.
- Result: Allows continuation of a conversation that was previously cleared.
- Usage:
- Player: /ai cache refresh (Reloads your own session)
- Admin: /ai cache refresh <playername> (Reloads a specific player's session)
- Admin: /ai cache refresh all (Reloads all online players' sessions)

2. AI-Powered Memory (/ai memory)

This advanced feature uses AI to summarize and compress long conversations, enabling a nearly infinite memory while optimizing resource usage.

/ai memory clear (Summarize and End Session)
- Action: The AI summarizes the current conversation history, and then the session is ended.
- Process: The generated summary is saved to summarieschat/. If an old summary existed, it's archived into the main chat log. The AI's short-term memory is then cleared.
- Use Case: To "bank" important information from a conversation as a summary before starting a new topic.
- Usage:
- Player: /ai memory clear (Summarizes and ends your own session)
- Admin: /ai memory clear <playername> (Summarizes and ends a specific player's session)
- Admin: /ai memory clear all (Summarizes and ends all online players' sessions)

/ai memory refresh (Summarize and Continue Session)
- Action: The AI summarizes the current conversation history, and then replaces the detailed history with the summary, allowing the conversation to continue.
- Process: The AI's short-term memory is replaced with a single system message containing the new summary.
- Result: This frees up memory while allowing the AI to "remember" the context of the prior conversation in a compressed form, enabling very long and detailed interactions.
- Use Case: To optimize memory during long, complex conversations without losing context.
- Usage:
- Player: /ai memory refresh (Summarizes and continues your own session)
- Admin: /ai memory refresh <playername> (Summarizes and continues a specific player's session)
- Admin: /ai memory refresh all (Summarizes and continues all online players' sessions)

Important Notes on AI-Powered Memory:
- API Usage: These commands will make calls to the AI API for summarization, incurring usage costs.
- Time: Summarization is a complex task and may take a few moments to complete. These operations are asynchronous to prevent server lag.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Persistent Chat Logging

All conversations and generated summaries are automatically saved to disk, ensuring no chat history is lost. This process is asynchronous to maintain high server performance.

Log Locations:
- Regular chats: plugins/NSR-AI/playerchatshistory/
- Admin-mode chats: plugins/NSR-AI/adminchatshistory/
- Latest summaries: plugins/NSR-AI/summarychat/

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Permissions

- Player Commands: Any player can use /ai cache clear/refresh and /ai memory clear/refresh for themselves.
- Admin Commands: Commands targeting other players or all require the user to be in admin mode.

New Features Added to NSR-AI Plugin

This update introduces several enhancements to the NSR-AI plugin, focusing on improved user experience and maintainability:

- Automatic Update Checker: The plugin now includes an integrated update checker that automatically verifies if you are running the latest version upon startup.
- New In-Game Version Command: /ai version (or /ai v) lets players:
- View the current version of the plugin.
- See if their plugin is up-to-date or if a newer version is available.
- Access a list of features included in the latest available version.
- Outdated Version Notifications: Server console displays a notification if outdated; admins get in-game messages with download links.
- Cloudflare Worker Integration: Ensures efficient and reliable version verification.
- Enhanced Plugin Startup Message: Displays plugin name, version, and developer info in a clear format.

Recent Feature Enhancements

- Enhanced Command Set:
- /ai admin <activation_code>: Toggle administrator mode.
- /ai data <query>: Queries local knowledge base.
- /ai add <keyword> <heading> <response>: Add new entries in-game.
- /ai remove <keyword>: Remove entries in-game.
- /ai reload: Reloads plugin configuration.
- API Load Reduction: Prioritize local knowledge base responses for /ai data commands.
- Improved Plugin Lifecycle Messages: More informative onDisable() messages.
- Enhanced /ai add command: AI-generated headings, preview before confirmation.
- Robust /ai data command: Falls back to local knowledge base if AI API fails.
- Configurable Knowledge Base Output Color: chat-colors.knowledge-base in features.yml.

New Features (from latest update)

- Symmetric add/remove commands: Shows removed content when /ai remove <keyword> is used.
- Improved Knowledge Base Search: /ai data <query> searches headings and answers, provides direct matches or prompts.
- Direct Search Results Display: Displays answer if a clear match is found.
- Cleaned-up Heading Display: "Heading (AI-generated):" removed in preview.
- New /ai data all Command: View all knowledge base entries.
- Configurable Knowledge Confirmation: simple-knowledge-yml-approve setting for confirmation process.

Granular Command Toggles

Controls over individual AI commands via features.yml:
- command-toggles.data: /ai data and /ai data all (Default: true)
- command-toggles.admin: /ai admin (Default: true)
- command-toggles.disable: /ai disable (Default: true)
- command-toggles.version: /ai version /ai v (Default: true)
- command-toggles.add: /ai add (Default: true)
- command-toggles.add-confirm: Confirmation step for /ai add (Default: true)
- command-toggles.remove: /ai remove (Default: true)
- command-toggles.remove-confirm: Confirmation step for /ai remove (Default: true)
- command-toggles.memory-clear: /ai memory clear (Default: true)
- command-toggles.memory-refresh: /ai memory refresh (Default: true)
- command-toggles.cache-clear: /ai cache clear (Default: true)
- command-toggles.cache-refresh: /ai cache refresh (Default: true)

Enhanced /ai reload Command

- /ai reload: Reloads main config.yml
- /ai reload c / /ai reload config: Reloads only config.yml
- /ai reload f / /ai reload features: Reloads only features.yml
- /ai reload k / /ai reload knowledge: Reloads only knowledge base
- /ai reload nsr-ai: Reloads entire plugin (configs + knowledge base)

New /ai help Command

- /ai help: Displays concise help message with descriptions for enabled commands.
- Typing /ai without arguments displays the help message.
- Tab Completion: Intelligent suggestions for sub-commands and arguments.

Addon Enhancements

- Backward Compatibility: Supports both NSR-AI v1.1 and lower via reflection.
- Enhanced Privacy Command (/ai privacy):
- Non-Admins: Manage own privacy settings.
- Admins: Manage others’ privacy or own settings.
- Improved Tab Completion: For privacy features and on/off options.
- Player Data Initialization: Ensures proper data creation for new players.
- Detailed AFK Time Display: /ai stats now shows AFK duration.
- Version Update: Addon version updated to 1.0.2.

Advanced Knowledge Base Search

- Relevance-Based Scoring: Prioritizes relevant entries.
- Content and Heading Search: Matches in headings and content.
- Weighted Headings: Higher weight for heading matches.
- Fuzzy Search: Tolerant of irregular syntax.
- Top 5 Results: Returns the 5 most relevant results.