mirror of
https://github.com/DarkflameUniverse/DarkflameServer.git
synced 2026-10-02 10:53:44 +00:00
e213a7aeff
The NexusDashboard-parity dashboard (dDashboardServer) and everything built on it on the experimental branch: accounts, characters, properties and moderation tools, permissions shared with in-game slash commands, economy reports, World 3D and property 3D views with client scenery, scheduled events (features, vanity changes, live events, announcements, restarts), vanity files and events, the CDClient browser, the message inspector with saved captures, chat filter tools, community challenges, live ops, the AI moderator helper, and the server-side changes they need. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
74 lines
2.4 KiB
C++
74 lines
2.4 KiB
C++
#ifndef __IAISUGGESTIONS__H__
|
|
#define __IAISUGGESTIONS__H__
|
|
|
|
#include <cstdint>
|
|
#include <optional>
|
|
#include <string>
|
|
#include <vector>
|
|
|
|
#include "dCommonVars.h"
|
|
|
|
/**
|
|
* The dashboard's staff-side AI moderator helper: every suggestion it asked for (who asked, about what, the model,
|
|
* tokens used and the validated answer or the error), kept with the item so the same case isn't sent twice.
|
|
* Suggestions are drafts for staff; nothing here is ever shown to players.
|
|
*/
|
|
class IAiSuggestions {
|
|
public:
|
|
enum class eAiStatus : uint8_t {
|
|
OK = 0, // a validated suggestion
|
|
REJECTED = 1, // the model answered, but the answer failed validation
|
|
FAILED = 2 // no usable answer (API error, network, ...)
|
|
};
|
|
|
|
struct AiSuggestion {
|
|
uint64_t id{};
|
|
std::string kind; // player_report, chat_message, player_chat, name, pet_name, economy_flag
|
|
int64_t itemId{}; // the report, message, character, pet or flag
|
|
std::string fingerprint; // hash of what was sent (case, rules, model, prompt version)
|
|
uint32_t requestedById{};
|
|
std::string requestedBy;
|
|
int64_t createdAt{};
|
|
std::string model;
|
|
uint32_t inputTokens{};
|
|
uint32_t outputTokens{};
|
|
eAiStatus status{ eAiStatus::OK };
|
|
std::string suggestion; // the validated answer as JSON, empty unless OK
|
|
std::string error;
|
|
std::string context; // the case file that was sent, as JSON (for review)
|
|
};
|
|
|
|
virtual uint64_t InsertAiSuggestion(const AiSuggestion& suggestion) = 0;
|
|
// Newest first
|
|
virtual std::vector<AiSuggestion> GetAiSuggestions(const std::string& kind, int64_t itemId, uint32_t limit) = 0;
|
|
// The newest OK suggestion made from exactly this input
|
|
virtual std::optional<AiSuggestion> FindAiSuggestion(const std::string& kind, int64_t itemId, const std::string& fingerprint) = 0;
|
|
|
|
struct AiUsage {
|
|
uint32_t requests{};
|
|
uint64_t inputTokens{};
|
|
uint64_t outputTokens{};
|
|
};
|
|
// Requests (of any status) made at or after `since`, and their tokens
|
|
virtual AiUsage GetAiUsageSince(int64_t since) = 0;
|
|
|
|
// One economy flag's row, for sending it to the helper; nullopt when there is none
|
|
struct EconomyFlagRow {
|
|
uint64_t id{};
|
|
int64_t createdAt{};
|
|
uint32_t day{};
|
|
uint8_t kind{};
|
|
LWOOBJID characterId{};
|
|
int32_t lot{};
|
|
LWOOBJID itemId{};
|
|
int64_t value{};
|
|
int64_t baseline{};
|
|
std::string details;
|
|
uint8_t status{};
|
|
std::string note;
|
|
};
|
|
virtual std::optional<EconomyFlagRow> GetEconomyFlagRow(uint64_t id) = 0;
|
|
};
|
|
|
|
#endif //!__IAISUGGESTIONS__H__
|