cc4d314bcc
Players can hold natural-language conversations with NPCs that have a persona, backed by the Anthropic Messages API (default model claude-haiku-4-5, disabled by default). - Personas come from hand-authored templates in Data/ai-personas.json (matched by exact NPC name or class name walking the inheritance chain) or from per-NPC personas set in game with [SetPersona and persisted through world saves via a GenericPersistence module. - A greeting near a persona NPC, or speaking its name, starts a conversation; farewells, walking away, or two minutes of silence end it. Speech is observed passively through EventSink.Speech, so bank, guard, vendor and pet keywords are unaffected. - Requests are dispatched with async/await: HTTP I/O runs off-thread and continuations marshal back to the game loop through the EventLoopContext, so the game thread never blocks on the network. Replies are dropped if the session ended, the NPC was deleted, or the player disconnected while the request was in flight. - Cost controls: per-player cooldown and per-minute caps, a server-wide concurrent request cap, bounded history and input/output lengths - all configurable under aiConversation.* settings. - Replies are sanitized and split into ~120-char chunks spoken at ~900ms intervals; failures retry once on 429/5xx/timeout, then fall back to a canned in-character line. - Staff commands: [SetPersona, [RemovePersona, [PersonaInfo (GM) and [AIChat status|on|off|reload|end (Admin) with token usage stats. - The API key is only read from an environment variable (ANTHROPIC_API_KEY by default); ships with persona examples, a feature README and unit tests for the pure logic. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01GPKWo5V4JXt22nQtFnat41
65 lines
1.8 KiB
C#
65 lines
1.8 KiB
C#
using Server.Engines.AIConversation;
|
|
using Xunit;
|
|
|
|
namespace Server.Tests.Engines.AIConversation;
|
|
|
|
public class ConversationHistoryTests
|
|
{
|
|
[Fact]
|
|
public void Add_KeepsTurnsInOrder()
|
|
{
|
|
var history = new ConversationHistory(20);
|
|
|
|
history.Add(ChatRole.User, "hello");
|
|
history.Add(ChatRole.Assistant, "well met");
|
|
|
|
Assert.Equal(2, history.Count);
|
|
Assert.Equal(new ChatTurn(ChatRole.User, "hello"), history.Turns[0]);
|
|
Assert.Equal(new ChatTurn(ChatRole.Assistant, "well met"), history.Turns[1]);
|
|
}
|
|
|
|
[Fact]
|
|
public void Add_DropsOldestTurnsBeyondLimit()
|
|
{
|
|
var history = new ConversationHistory(4);
|
|
|
|
for (var i = 0; i < 10; i++)
|
|
{
|
|
history.Add(ChatRole.User, $"question {i}");
|
|
history.Add(ChatRole.Assistant, $"answer {i}");
|
|
}
|
|
|
|
Assert.Equal(4, history.Count);
|
|
Assert.Equal("question 8", history.Turns[0].Text);
|
|
Assert.Equal("answer 9", history.Turns[^1].Text);
|
|
}
|
|
|
|
[Fact]
|
|
public void Trim_EnsuresFirstTurnIsUser()
|
|
{
|
|
var history = new ConversationHistory(3);
|
|
|
|
history.Add(ChatRole.User, "q1");
|
|
history.Add(ChatRole.Assistant, "a1");
|
|
history.Add(ChatRole.User, "q2");
|
|
history.Add(ChatRole.Assistant, "a2");
|
|
|
|
// Capacity 3 would leave [a1, q2, a2]; the head realigns to q2.
|
|
Assert.Equal(2, history.Count);
|
|
Assert.Equal(ChatRole.User, history.Turns[0].Role);
|
|
Assert.Equal("q2", history.Turns[0].Text);
|
|
}
|
|
|
|
[Fact]
|
|
public void ToArray_ReturnsIndependentSnapshot()
|
|
{
|
|
var history = new ConversationHistory(10);
|
|
history.Add(ChatRole.User, "hello");
|
|
|
|
var snapshot = history.ToArray();
|
|
history.Add(ChatRole.Assistant, "well met");
|
|
|
|
Assert.Single(snapshot);
|
|
Assert.Equal(2, history.Count);
|
|
}
|
|
}
|